Merge branch 'main' of github.com:callstack/react-native-paper into adamTrz/migrate-docs-rspress-ck-theme

# Conflicts:
#	docs/package.json
#	scripts/generate-component-docs.ts
#	yarn.lock

Author: satya164

.agents/README.md

@@ -0,0 +1,8 @@
+# Agent Instructions
+
+For code review behavior, use:
+
+- `.github/copilot-instructions.md`
+- `.github/instructions/*.instructions.md`
+
+These files are the source of truth because they are also consumed by GitHub Copilot code review.

.eslintignore

@@ -0,0 +1,17 @@
+# General Code Review Standards
+
+## Review Priorities
+
+- Prioritize correctness, regressions, missing tests, and API design issues.
+- Check that the behavior scope matches the stated intent.
+- Verify claims about external standards, platform conventions, accessibility, and design systems against the implementation.
+- Avoid asking for unrelated refactors, stylistic churn, or backwards compatibility unless required by the change.
+
+## Public APIs
+
+- Review new or modified public APIs for visibility, naming, defaults, customizability, and extensibility.
+- Ensure public APIs and exported types do not leak implementation details.
+
+## Tests
+
+- Call out missing tests when the changed behavior is risky.

.eslintrc

@@ -0,0 +1,40 @@
+---
+applyTo: "**/*.{ts,tsx,js,jsx}"
+---
+
+# TypeScript And React Review Instructions
+
+## Code Quality
+
+- Flag unnecessary abstractions, one-off helpers, excessive indirection, and defensive code without a real use case.
+- Flag comments that restate obvious code instead of explaining non-obvious intent.
+- Check that changes follow existing project style, structure, naming, and local patterns.
+
+## TypeScript
+
+- Flag uses of `any`, unsafe `as` assertions, and non-null assertions (`!`) unless clearly justified.
+- Avoid broad types such as `object`, `Function`, `{}`, and `Record<string, unknown>` unless the broadness is intentional.
+- Do not accept `@ts-ignore`.
+- Only accept `@ts-expect-error` when it has a comment explaining why the error is expected and cannot be resolved.
+- Prefer simple types over complex conditional types, overloads, or type logic when simpler approaches work.
+- Prefer `type` aliases over `interface` unless there is a specific reason to use `interface`.
+
+## React
+
+- Check that hooks follow the Rules of Hooks.
+- Check dependency arrays for unstable values.
+- Ensure components do not perform side effects during rendering.
+- Avoid storing values in state when they can be derived from props or existing state.
+- Avoid multiple sources of truth for the same state.
+- Avoid `React.Children`, `cloneElement`, and reading React elements directly unless there is a strong justification.
+- Treat memoization as something that needs a reason: expensive calculation, stable identity requirement, or measured performance need.
+- Check async effects for cancellation or race conditions when relevant.
+- Check accessibility: labels, roles, focus order, keyboard interactions, disabled states, and loading states.
+
+## Animations And Layout
+
+- Check for unnecessary layout shifts.
+- Prefer animating only `transform` and `opacity` unless another property is required.
+- For layout transitions, verify the approach handles rapid state changes, gestures, interruption, and cancellation.
+- Check that duration and easing feel appropriate for the platform and interaction.
+- Verify text and UI elements do not overlap or overflow at supported screen sizes.

.github/copilot-instructions.md

@@ -0,0 +1,12 @@
+---
+applyTo: "**/*.{md,mdx}"
+---
+
+# Documentation Review Instructions
+
+- Verify examples match the actual API.
+- Check changed heading hierarchy for consistency.
+- Check changed internal links and anchors for consistency.
+- Check that documentation explains public behavior, not implementation details.
+- Check that examples are self-contained and demonstrate only the relevant behavior instead of mixing multiple behaviors.
+- Check that migration guide examples show diff or before/after code snippets when relevant.

.github/instructions/code.instructions.md

@@ -0,0 +1,10 @@
+---
+applyTo: "**/*.{test,spec}.{ts,tsx,js,jsx}"
+---
+
+# Test Review Instructions
+
+- Check that tests verify public behavior, not implementation details.
+- Check that test titles describe user-facing behavior.
+- Check coverage of happy paths, edge cases, and error states.
+- Flag unnecessary mocking.

.github/instructions/docs.instructions.md

@@ -13,4 +13,4 @@
 
 <!-- Describe the **steps to test this change**, so that a reviewer can verify it. Provide screenshots or videos if the change affects UI. -->
 
-<!-- Keep in mind that PR changes must pass lint, typescript and tests. -->
+<!-- Keep in mind that PR changes must pass lint, typecheck and tests. -->

.github/instructions/tests.instructions.md

@@ -18,10 +18,10 @@ jobs:
         uses: ./.github/actions/setup
 
       - name: Lint
-        run: yarn lint-no-fix
+        run: yarn lint
 
-  typescript:
-    name: TypeScript
+  typecheck:
+    name: Typecheck
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -31,7 +31,7 @@ jobs:
         uses: ./.github/actions/setup
 
       - name: Check types
-        run: yarn typescript
+        run: yarn typecheck
 
   unit-tests:
     name: Unit tests
@@ -73,7 +73,20 @@ jobs:
       - name: Build package
         run: |
           yarn prepack
-          node ./scripts/typescript-output-lint
+          node ./scripts/typescript-output-lint.ts
+
+  build-example:
+    name: Build example
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Setup
+        uses: ./.github/actions/setup
+
+      - name: Build example
+        run: yarn example expo export --platform all
 
   build-docs:
     name: Build docs

.github/pull_request_template.md

@@ -0,0 +1,51 @@
+name: Contributor Label
+
+on:
+  pull_request_target:
+    types: [opened, reopened]
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  label:
+    name: Add contributor label
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+
+            let permission = 'none';
+
+            try {
+              const { data } = await github.rest.repos.getCollaboratorPermissionLevel({
+                owner,
+                repo,
+                username: context.payload.pull_request.user.login,
+              });
+
+              permission = data.permission;
+            } catch (error) {
+              if (error.status !== 404) {
+                throw error;
+              }
+            }
+
+            if (
+              !['MEMBER', 'OWNER'].includes(context.payload.pull_request.author_association) &&
+              !['admin', 'maintain', 'write'].includes(permission)
+            ) {
+              return;
+            }
+
+            await github.rest.issues.addLabels({
+              owner,
+              repo,
+              issue_number: context.issue.number,
+              labels: ['Contributor: Internal'],
+            });