[Monorepo] Migrate to monorepo (#3482)

## Description

This is base PR that migrates our repository into monorepo structure. It creates following structure:

- `/apps` - here we will put our example apps.
- `/packages` - main directory for Gesture Handler package, along with documentation.
- `/scripts` - scripts that are used by _**GestureHandler**_ (for example formatting scripts)

## Steps

<details>
<summary>Here is the list of PRs that fix issues caused by changing structure of the repository:</summary>

1. #3487
2. #3490
3. #3494
4. #3495
5. #3496
6. #3497
7. #3503
8. #3506
9. #3507
10. #3510
11. #3515
12. #3518
13. #3519
14. #3524
15. #3525
16. #3526
18. #3528

</details>

Note that most of them depends on previous ones, so **_they had to be merged in given order_** (at least up to no. 9).

## Test plan

<details>
<summary>Following subjects were tested in order to make sure that everything works after migration:</summary>

### Example apps

- [x] basic-example
  - [x] Android
  - [x] iOS
- [x] expo-example (fabric)
  - [x] Android
  - [x] iOS
  - [x] web (in that case architecture doesn't matter)
- [x] expo-example (paper)
  - [x] Android
  - [x] iOS
- [x] macos-example

### Scripts

- [x] check-android-dirs
- [x] check-rn-versions
- [x] format-android
- [x] format-apple
- [x] codegen-check-consistency
- [x] codegen-sync-archs
- [x] clangd

### Linters

- [x] prettier
- [x] eslint
- [x] lint-staged

### docs

- [x] check documentation

### Build from generated package

- [x] New app builds correctly

</details>

Author: m-bert

.eslintrc.json

@@ -1,26 +1,27 @@
 {
+  "root": true,
   "extends": [
     "plugin:@typescript-eslint/recommended",
     "plugin:@typescript-eslint/recommended-requiring-type-checking",
     "satya164"
   ],
   "settings": {
-    "react": { "version": "16" },
+    "react": { "version": "19" },
     "import/resolver": {
       "babel-module": {}
     }
   },
   "parser": "@typescript-eslint/parser",
   "parserOptions": {
-    "project": [
-      "./tsconfig.json",
-      "./example/tsconfig.json",
-      "./FabricExample/tsconfig.json"
-    ]
+    "project": ["./tsconfig.json"]
   },
   "env": { "browser": true, "node": true, "jest/globals": true },
-  "plugins": ["jest"],
-  "ignorePatterns": ["lib/**/*"],
+  "plugins": ["react", "jest"],
+  "ignorePatterns": [
+    "packages/react-native-gesture-handler/lib/**/*",
+    "**/*.config.js",
+    "scripts/*.js"
+  ],
   "rules": {
     // removed in new jest-eslint-plugin, referenced in satya config
     "jest/no-truthy-falsy": "off",
@@ -30,19 +31,28 @@
       "warn",
       { "assertFunctionNames": ["expect*", "assert*"] }
     ],
+    "jest/no-conditional-expect": "warn",
+
     // temporary, remove after we type internals better
     "@typescript-eslint/restrict-template-expressions": "warn",
     "@typescript-eslint/no-unsafe-member-access": "warn",
     "@typescript-eslint/no-unsafe-call": "warn",
     "@typescript-eslint/no-unsafe-assignment": "warn",
+    "@typescript-eslint/no-unsafe-argument": "warn",
     "@typescript-eslint/no-unsafe-return": "warn",
+    "@typescript-eslint/no-non-null-assertion": "warn",
     "@typescript-eslint/ban-types": "warn",
 
     // common
     "@typescript-eslint/explicit-module-boundary-types": "off",
     "import/named": "off",
     "react/sort-comp": "off",
     "react/no-unused-prop-types": "warn",
+    "react-hooks/exhaustive-deps": "warn",
+    "@typescript-eslint/no-floating-promises": "warn",
+    "@eslint-react/no-missing-component-display-name": "warn",
+    "@eslint-react/no-nested-components": "warn",
+    "@eslint-react/no-nested-component-definitions": "warn",
     "prefer-const": [
       "error",
       {
@@ -53,6 +63,13 @@
       "error",
       { "argsIgnorePattern": "^_" }
     ],
+    "@typescript-eslint/no-explicit-any": "warn",
+    "@typescript-eslint/no-redundant-type-constituents": "warn",
+    "@typescript-eslint/no-empty-function": "error",
+    "@typescript-eslint/no-misused-promises": "warn",
+    "@eslint-react/no-array-index-key": "warn",
+    "@eslint-react/hooks-extra/no-direct-set-state-in-use-effect": "warn",
+    "@eslint-react/hooks-extra/prefer-use-state-lazy-initialization": "warn",
     "no-redeclare": "off",
     "@typescript-eslint/no-redeclare": "error",
     "no-use-before-define": "off",
@@ -65,6 +82,7 @@
       }
     ],
     "curly": "error",
-    "spaced-comment": "error"
+    "spaced-comment": "error",
+    "no-alert": "warn"
   }
 }

.github/workflows/android-build-paper.yml

@@ -0,0 +1,46 @@
+name: Test Android build (Paper)
+
+on:
+  pull_request:
+    paths:
+      - .github/workflows/android-build-paper.yml
+      - packages/react-native-gesture-handler/android/**
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  build:
+    if: github.repository == 'software-mansion/react-native-gesture-handler'
+
+    runs-on: ubuntu-latest
+    env:
+      WORKING_DIRECTORY: apps/expo-example
+    concurrency:
+      group: android-paper-${{ github.ref }}
+      cancel-in-progress: true
+
+    steps:
+      - name: checkout
+        uses: actions/checkout@v4
+
+      - name: Use Java 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: oracle
+          java-version: 17
+
+      - name: Use Node.js 18
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18
+          cache: yarn
+
+      - name: Install node dependencies
+        working-directory: ${{ env.WORKING_DIRECTORY }}
+        run: PAPER_ENABLED=1 yarn install --immutable
+
+      - name: Build app
+        working-directory: ${{ env.WORKING_DIRECTORY }}/android
+        run: ./gradlew assembleDebug --console=plain -PreactNativeArchitectures=arm64-v8a

.github/workflows/android-build.yml

@@ -1,42 +1,48 @@
 name: Test Android build
+
 on:
   pull_request:
     paths:
-      - '.github/workflows/android-build.yml'
-      - 'android/**'
-      - 'Common/**'
-      - 'example/android/**'
-      - 'FabricExample/android/**'
+      - .github/workflows/android-build.yml
+      - packages/react-native-gesture-handler/android/**
+      - apps/basic-example/android/**
   push:
     branches:
       - main
   workflow_dispatch:
+
 jobs:
   build:
     if: github.repository == 'software-mansion/react-native-gesture-handler'
+
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        working-directory: [example, FabricExample]
+        working-directory: [apps/basic-example, apps/expo-example]
     concurrency:
       group: android-${{ matrix.working-directory }}-${{ github.ref }}
       cancel-in-progress: true
+
     steps:
       - name: checkout
         uses: actions/checkout@v4
+
       - name: Use Java 17
         uses: actions/setup-java@v4
         with:
-          distribution: 'oracle'
-          java-version: '17'
+          distribution: oracle
+          java-version: 17
+
       - name: Use Node.js 18
         uses: actions/setup-node@v4
         with:
           node-version: 18
-          cache: 'yarn'
+          cache: yarn
+
       - name: Install node dependencies
         working-directory: ${{ matrix.working-directory }}
-        run: yarn
+        run: yarn install --immutable
+
       - name: Build app
         working-directory: ${{ matrix.working-directory }}/android
         run: ./gradlew assembleDebug --console=plain -PreactNativeArchitectures=arm64-v8a

.github/workflows/check-archs-consistency.yml

@@ -1,33 +1,40 @@
 name: Test consistency between Paper & Fabric
-on: 
+
+on:
   pull_request:
     branches:
       - main
-    paths: 
-      - src/specs/**
-      - package.json
-      - FabricExample/package.json
+    paths:
       - .github/workflows/check-archs-consistency.yml
+      - packages/react-native-gesture-handler/src/specs/**
+      - packages/react-native-gesture-handler/package.json
+      - apps/basic-example/package.json
   push:
     branches:
       - main
   workflow_dispatch:
 
 jobs:
+  if: github.repository == 'software-mansion/react-native-gesture-handler'
+
   check:
     runs-on: ubuntu-latest
     concurrency:
       group: check-archs-consistency-${{ github.ref }}
       cancel-in-progress: true
+
     steps:
       - name: checkout
         uses: actions/checkout@v4
+
       - name: Use Node.js 18
         uses: actions/setup-node@v4
         with:
           node-version: 18
-          cache: 'yarn'
+          cache: yarn
+
       - name: Install node dependencies
         run: yarn
+
       - name: Check Android Paper & Fabric generated interfaces consistency
-        run: yarn architectures-consistency-check
+        run: yarn workspace react-native-gesture-handler architectures-consistency-check

.github/workflows/close-when-stale.yml

@@ -1,4 +1,5 @@
 name: Check for stale issues
+
 on:
   schedule:
     - cron: '37 21 * * *' # at 21:37 every day
@@ -12,11 +13,12 @@ jobs:
   main:
     if: github.repository == 'software-mansion/react-native-gesture-handler'
     runs-on: ubuntu-latest
+
     steps:
       - name: Checkout Actions
         uses: actions/checkout@v4
         with:
-          repository: 'software-mansion-labs/swmansion-bot'
+          repository: software-mansion-labs/swmansion-bot
           ref: stable
 
       - uses: actions/cache@v4
@@ -30,5 +32,5 @@ jobs:
       - name: Close when stale
         uses: ./close-when-stale
         with:
-          close-when-stale-label: 'Close when stale'
+          close-when-stale-label: Close when stale
           days-to-close: 20

.github/workflows/docs-check.yml

@@ -3,29 +3,34 @@ name: Check documentation
 on:
   pull_request:
     paths:
-      - 'docs/**'
+      - packages/docs-gesture-handler/**
   workflow_dispatch:
 
 jobs:
   check:
     if: github.repository == 'software-mansion/react-native-gesture-handler'
+
     runs-on: ubuntu-latest
+    env:
+      WORKING_DIRECTORY: packages/docs-gesture-handler
     concurrency:
       group: docs-check-${{ github.ref }}
       cancel-in-progress: true
-    env:
-      WORKING_DIRECTORY: docs
+
     steps:
       - name: checkout
         uses: actions/checkout@v4
+
       - name: Use Node.js 18
         uses: actions/setup-node@v4
         with:
           node-version: 18
-          cache: 'yarn'
+          cache: yarn
+
       - name: Install node dependencies
         working-directory: ${{ env.WORKING_DIRECTORY }}
         run: yarn
+
       - name: Generate docs
         working-directory: ${{ env.WORKING_DIRECTORY }}
         run: yarn build

.github/workflows/ios-build-paper.yml

@@ -0,0 +1,46 @@
+name: Test iOS build (paper)
+
+on:
+  pull_request:
+    paths:
+      - .github/workflows/ios-build-paper.yml
+      - packages/react-native-gesture-handler/RNGestureHandler.podspec
+      - packages/react-native-gesture-handler/apple/**
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  build:
+    if: github.repository == 'software-mansion/react-native-gesture-handler'
+
+    runs-on: macos-14
+    env:
+      WORKING_DIRECTORY: apps/expo-example
+    concurrency:
+      group: ios-paper-${{ matrix.working-directory }}-${{ github.ref }}
+      cancel-in-progress: true
+
+    steps:
+      - name: checkout
+        uses: actions/checkout@v4
+
+      - name: Use latest stable Xcode
+        uses: maxim-lobanov/setup-xcode@v1
+        with:
+          xcode-version: '16.1'
+
+      - name: Use Node.js 18
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18
+          cache: yarn
+
+      - name: Install node dependencies
+        working-directory: ${{ env.WORKING_DIRECTORY }}
+        run: PAPER_ENABLED=1 yarn install --immutable
+
+      - name: Build app
+        working-directory: ${{ env.WORKING_DIRECTORY }}
+        run: npx react-native run-ios