Refactor react-docgen toward a parser-neutral core and adapters

.changeset/ast-proptypes-imports.md

@@ -0,0 +1,7 @@
+---
+'@react-docgen/core': patch
+---
+
+Recognize PropTypes imports from the parsed AST instead of scanning source text
+with a potentially slow regular expression. Comments and string literals no
+longer count as module imports.

.changeset/calm-types-travel.md

@@ -3,3 +3,6 @@
 ---
 
 Preserve function types wrapped in parentheses when parsing TypeScript unions.
+
+Thanks [@sean0407](https://github.com/sean0407) for
+[#1142](https://github.com/reactjs/react-docgen/pull/1142).

.changeset/giant-worlds-swim.md

@@ -3,6 +3,10 @@
 'react-docgen': major
 ---
 
-Drop support for Node.js 20, 21 and 23
+Drop support for Node.js 20, 21, 23, 25 and pre-LTS Node.js 26 releases.
 
-Minimum Supported Node.js version is now 22.13.0
+Supported Node.js versions are now:
+
+- Node.js 22.13.0 or newer 22.x releases
+- Node.js 24.11.0 or newer 24.x releases
+- Node.js 26.13.0 (the first Node.js 26 LTS release) or newer stable releases

.changeset/mixin-class-props.md

@@ -0,0 +1,14 @@
+---
+'react-docgen': patch
+'@react-docgen/typescript': patch
+---
+
+Extract TypeScript props from React class components extending mixin calls,
+including aliased component bases and wrapped props. Preserve declared props
+when a mixin receives unrelated generic arguments.
+
+Ported from [#1145](https://github.com/reactjs/react-docgen/pull/1145) by
+[@mfazekas](https://github.com/mfazekas), merged with follow-up fixes in
+[#1157](https://github.com/reactjs/react-docgen/pull/1157). Shared regression
+fixtures cover the legacy parser, TypeScript adapter, and TypeScript handlers
+composed with the normalized Babel adapter.

.changeset/neutral-imperative-callbacks.md

@@ -0,0 +1,10 @@
+---
+'@react-docgen/core': patch
+---
+
+Document methods wrapped in React `useCallback` and exposed through
+`useImperativeHandle`, preserving their parameters, return types, descriptions,
+and async/generator modifiers across parser adapters.
+
+Ported from [#1139](https://github.com/reactjs/react-docgen/pull/1139) by
+[@askalf](https://github.com/askalf).

.changeset/pre.json

@@ -0,0 +1,4 @@
+{
+  "mode": "pre",
+  "tag": "alpha"
+}

.gitattributes

@@ -0,0 +1,2 @@
+# Portable fixtures have one canonical source representation on every platform.
+packages/integration-tests/cases/** text eol=lf

.github/workflows/build.yml

@@ -10,19 +10,20 @@ on:
 permissions: {}
 
 env:
-  NODE_VERSION: 24
+  NODE_VERSION: 24.11.0
 
 jobs:
   tests:
     strategy:
+      fail-fast: false
       matrix:
-        node: ["22.13.0", "24", "25", "26"]
+        node: ["22.13.0", "24.11.0", "26.13.0", "^27.0.0-0"]
         os: ["ubuntu"]
         include:
           - os: macos
-            node: "24"
+            node: "24.11.0"
           - os: windows
-            node: "24"
+            node: "24.11.0"
 
     name: Tests (Node.js v${{ matrix.node }}, ${{ matrix.os }})
     runs-on: ${{ matrix.os }}-latest
@@ -38,16 +39,17 @@ jobs:
         uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7
         with:
           node-version: ${{ matrix.node }}
+          check-latest: ${{ startsWith(matrix.node, '^') }}
           cache: "pnpm"
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Unit tests with coverage
+      - name: Tests with coverage
         if: "${{ matrix.node == env.NODE_VERSION }}"
-        run: pnpm test -- --coverage
+        run: pnpm test:coverage
 
-      - name: Unit tests
+      - name: Tests
         if: "${{ matrix.node != env.NODE_VERSION }}"
         run: pnpm test
 
@@ -57,6 +59,7 @@ jobs:
         uses: coverallsapp/github-action@8d6379e14d29928660c4ba802d8e85393440b329 # v2
         with:
           parallel: true
+          file: coverage/lcov.info
           flag-name: test-${{ matrix.os }}
 
   finish:

CONTRIBUTING.md

@@ -14,6 +14,14 @@ We actively welcome your pull requests.
 4. Ensure the test suite passes.
 5. Make sure your code lints and typechecks.
 
+## Tests and coverage
+
+Run `pnpm test` for the package suites. Run `pnpm test:coverage` for the CI
+coverage report at `coverage/lcov.info`. Coverage runs all package projects in
+one Vitest process and resolves parser packages to their sources, so shared core
+code exercised by adapter tests is included. The legacy coverage thresholds
+remain enforced.
+
 ## Issues
 We use GitHub issues to track public bugs. Please ensure your description is
 clear and has sufficient instructions to be able to reproduce the issue.