merge

Author: coado

.eslintrc.json

@@ -16,7 +16,7 @@
     "project": ["./tsconfig.json"]
   },
   "env": { "browser": true, "node": true, "jest/globals": true },
-  "plugins": ["react", "jest"],
+  "plugins": ["react", "jest", "simple-import-sort"],
   "ignorePatterns": [
     "packages/react-native-gesture-handler/lib/**/*",
     "**/*.config.js",
@@ -43,6 +43,8 @@
     "@typescript-eslint/no-unsafe-return": "warn",
     "@typescript-eslint/no-non-null-assertion": "warn",
     "@typescript-eslint/ban-types": "warn",
+    "@typescript-eslint/consistent-type-imports": "error",
+    "@typescript-eslint/consistent-type-exports": "error",
 
     // common
     "@typescript-eslint/explicit-module-boundary-types": "off",
@@ -85,6 +87,8 @@
     ],
     "curly": "error",
     "spaced-comment": "error",
-    "no-alert": "warn"
+    "no-alert": "warn",
+    "simple-import-sort/imports": "error",
+    "simple-import-sort/exports": "error"
   }
 }

AGENTS.md

@@ -0,0 +1,39 @@
+# react-native-gesture-handler library
+
+## Project structure
+
+- This project has monorepo structure.
+- It contains both, library (`/packages/react-native-gesture-handler`) and documentation (/packages/docs-gesture-handler).
+- It is multiplatform. Library supports android, iOS, web and macos.
+- Android codebase is located in `/packages/react-native-gesture-handler/android` directory. iOS and macos in `/packages/react-native-gesture-handler/apple`. Web can be found in `/packages/react-native-gesture-handler/src/web`.
+- Some files are platform specific. Those have platform in the file extension, e.g. `RNGestureHandlerModule.web.ts`
+
+### Example apps
+
+- Example apps are located in `/apps` directory
+- `basic-example` is mostly used to check that android and iOS build correctly.
+- `expo-example` is used to test more advanced examples. Sources are located in `apps/common-app`.
+- `macos-example` is used to check if library works on macos. Sources are located in `apps/common-app`.
+
+### Packages
+
+- `/packages` contains documentation and main library package
+- This project contains 3 versions of API. The newest is located in `packages/react-native-gesture-handler/src/v3` directory. Most of the logic is shared, but make sure that your changes do not break older APIs.
+- When writing code, you can use `usesNativeOrVirtualDetector` function to either include only, or exclude new API v3. It is available on all platforms.
+
+## Build checks
+
+- To check Android build go to `apps/basic-example` and run `yarn android` command.
+- To check iOS build, go to `apps/basic-example` and run `yarn ios`.
+- To check macos build, go to `apps/macos-example` and run `yarn macos`.
+- After any build on macOS/Linux stop the Metro server with `for pid in $(lsof -ti :8081); do kill "$pid"; done` (this no-ops cleanly when nothing is listening on port 8081; `pkill -f "metro"` is not sufficient)
+
+## JavaScript checks
+
+- To run TypeScript checks use `yarn ts-check` command. You can run it directly in `packages/react-native-gesture-handler` if working on package, or from root of the repository.
+- To run Jest tests, use `yarn test` command in `packages/react-native-gesture-handler`. You can also pass filename to run tests from specific file.
+- To run eslint check, use `yarn lint:js`
+
+## Formatting
+
+- To format code use use `yarn format:{apple | android | js}`. `apple` works for both, iOS and macos.

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

apps/basic-example/Gemfile

@@ -14,3 +14,4 @@ gem 'bigdecimal'
 gem 'logger'
 gem 'benchmark'
 gem 'mutex_m'
+gem 'nkf'

apps/basic-example/Gemfile.lock

@@ -5,21 +5,20 @@ GEM
       base64
       nkf
       rexml
-    activesupport (7.1.5.1)
+    activesupport (7.2.3.1)
       base64
       benchmark (>= 0.3)
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
       logger (>= 1.4.2)
-      minitest (>= 5.1)
-      mutex_m
+      minitest (>= 5.1, < 6)
       securerandom (>= 0.3)
-      tzinfo (~> 2.0)
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
+      tzinfo (~> 2.0, >= 2.0.5)
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
     algoliasearch (1.27.5)
       httpclient (~> 2.8, >= 2.8.3)
       json (>= 1.5.1)
@@ -67,7 +66,7 @@ GEM
     cocoapods-try (1.2.0)
     colored2 (3.1.2)
     concurrent-ruby (1.3.3)
-    connection_pool (2.5.3)
+    connection_pool (3.0.2)
     drb (2.2.3)
     escape (0.0.4)
     ethon (0.16.0)
@@ -78,21 +77,21 @@ GEM
     gh_inspector (1.1.3)
     httpclient (2.9.0)
       mutex_m
-    i18n (1.14.7)
+    i18n (1.14.8)
       concurrent-ruby (~> 1.0)
     json (2.12.2)
     logger (1.7.0)
-    minitest (5.25.5)
+    minitest (5.27.0)
     molinillo (0.8.0)
     mutex_m (0.3.0)
     nanaimo (0.3.0)
     nap (1.1.0)
     netrc (0.11.0)
     nkf (0.2.0)
     public_suffix (4.0.7)
-    rexml (3.4.1)
+    rexml (3.4.2)
     ruby-macho (2.5.1)
-    securerandom (0.3.2)
+    securerandom (0.4.1)
     typhoeus (1.4.1)
       ethon (>= 0.9.0)
     tzinfo (2.0.6)
@@ -116,6 +115,7 @@ DEPENDENCIES
   concurrent-ruby (< 1.3.4)
   logger
   mutex_m
+  nkf
   xcodeproj (< 1.26.0)
 
 RUBY VERSION

apps/basic-example/android/gradle/wrapper/gradle-wrapper.jar

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.0.0-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.3.1-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

apps/basic-example/android/gradle/wrapper/gradle-wrapper.properties

@@ -3,7 +3,8 @@
  */
 
 import { AppRegistry } from 'react-native';
-import App from './src/App';
+
 import { name as appName } from './app.json';
+import App from './src/App';
 
 AppRegistry.registerComponent(appName, () => App);