{"_id":"@a11yst/source-mapping-next","_rev":"3-f6ccb9de55095beeaec264255a2b61de","name":"@a11yst/source-mapping-next","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@a11yst/source-mapping-next","version":"1.0.0","license":"MPL-2.0","_id":"@a11yst/source-mapping-next@1.0.0","maintainers":[{"name":"angelabenavente","email":"ang.ben.dev@gmail.com"}],"homepage":"https://github.com/angelabenavente/a11yst#readme","bugs":{"url":"https://github.com/angelabenavente/a11yst/issues"},"dist":{"shasum":"2afa70129c8c2fd3cbb0dfa3097581df9c1fd40a","tarball":"https://registry.npmjs.org/@a11yst/source-mapping-next/-/source-mapping-next-1.0.0.tgz","fileCount":47,"integrity":"sha512-JWOD73X4uT9e19ary0jXn6ipTs2VHEhYVZNKPLyv5nNnOrJATigI4ekgraotA3oTr7oYF3ZEIbw+qtDgeLg7PA==","signatures":[{"sig":"MEUCIQDUCakvcYa/2WrOmT6JmjOdUDUCuE3n6v+SgKOLxt67/gIgZQ1sANEKX/wfhWcNbJ8TKxDdL13lRcwg5S4Cc/Vih2k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":119245},"main":"./dist/index.js","type":"module","_from":"file:a11yst-source-mapping-next-1.0.0.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc -p tsconfig.json","clean":"rm -rf dist *.tsbuildinfo","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"angelabenavente","email":"ang.ben.dev@gmail.com"},"_resolved":"/private/var/folders/tf/l5jz90dj0yncc_ds04tbfs5c0000gn/T/de943b6cdd00ca06fba733a3c53506f0/a11yst-source-mapping-next-1.0.0.tgz","_integrity":"sha512-JWOD73X4uT9e19ary0jXn6ipTs2VHEhYVZNKPLyv5nNnOrJATigI4ekgraotA3oTr7oYF3ZEIbw+qtDgeLg7PA==","repository":{"url":"git+https://github.com/angelabenavente/a11yst.git","type":"git"},"_npmVersion":"10.9.0","description":"Conservative Next.js static route catalog and source mapping for a11yst","directories":{},"_nodeVersion":"22.12.0","dependencies":{"@a11yst/types":"1.0.0","@a11yst/source-index":"1.0.0","@a11yst/source-mapping":"1.0.0","@a11yst/source-mapping-react":"1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/source-mapping-next_1.0.0_1787506263560_0.5357872762600733","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@a11yst/source-mapping-next","version":"1.0.1","license":"MPL-2.0","_id":"@a11yst/source-mapping-next@1.0.1","maintainers":[{"name":"angelabenavente","email":"ang.ben.dev@gmail.com"}],"homepage":"https://github.com/angelabenavente/a11yst#readme","bugs":{"url":"https://github.com/angelabenavente/a11yst/issues"},"dist":{"shasum":"2d6475778a8e9ffe2935b28b0351acff661ae542","tarball":"https://registry.npmjs.org/@a11yst/source-mapping-next/-/source-mapping-next-1.0.1.tgz","fileCount":47,"integrity":"sha512-3353HOsUONoSIDsY0aRG0ivyXkJsih1vBJcizxE+VnF0fiY7hX8eth4qRXtHBwxCQXVWezBXwtARWFq/+Wy9Yw==","signatures":[{"sig":"MEUCIHEks6kdnEWL7qOnSNf8PeBiILAagmokLD9ujTxz7/ryAiEA0AIcaake0SZ8VgL4NeWNx0d3oo57M3OExivnC6ma3lY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":119245},"main":"./dist/index.js","type":"module","_from":"file:a11yst-source-mapping-next-1.0.1.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc -p tsconfig.json","clean":"rm -rf dist *.tsbuildinfo","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"angelabenavente","email":"ang.ben.dev@gmail.com"},"_resolved":"/private/var/folders/tf/l5jz90dj0yncc_ds04tbfs5c0000gn/T/43a3b638d7d21a2c742c229821bf44a7/a11yst-source-mapping-next-1.0.1.tgz","_integrity":"sha512-3353HOsUONoSIDsY0aRG0ivyXkJsih1vBJcizxE+VnF0fiY7hX8eth4qRXtHBwxCQXVWezBXwtARWFq/+Wy9Yw==","repository":{"url":"git+https://github.com/angelabenavente/a11yst.git","type":"git"},"_npmVersion":"10.9.8","description":"Conservative Next.js static route catalog and source mapping for a11yst","directories":{},"_nodeVersion":"22.23.1","dependencies":{"@a11yst/types":"1.0.1","@a11yst/source-index":"1.0.1","@a11yst/source-mapping":"1.0.1","@a11yst/source-mapping-react":"1.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/source-mapping-next_1.0.1_1787508689054_0.10002624735092636","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@a11yst/source-mapping-next","version":"1.0.2","description":"Conservative Next.js static route catalog and source mapping for a11yst","type":"module","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"main":"./dist/index.js","types":"./dist/index.d.ts","dependencies":{"@a11yst/source-index":"1.0.2","@a11yst/source-mapping":"1.0.2","@a11yst/source-mapping-react":"1.0.2","@a11yst/types":"1.0.2"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"license":"MPL-2.0","repository":{"type":"git","url":"git+https://github.com/angelabenavente/a11yst.git"},"homepage":"https://www.a11yst.dev","bugs":{"url":"https://github.com/angelabenavente/a11yst/issues"},"publishConfig":{"access":"public"},"scripts":{"build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit","clean":"rm -rf dist *.tsbuildinfo"},"_id":"@a11yst/source-mapping-next@1.0.2","_integrity":"sha512-/N6vrBmnECrSIhB5uAi9GJOy7IOCYRpRi5rRMNjBA7zfNjyK5NCAKa5Sl3iuCu5ElsplpTVH47rQy3NiqMhBBg==","_resolved":"/private/var/folders/tf/l5jz90dj0yncc_ds04tbfs5c0000gn/T/2d20d3ad251834e4730a7c763aee2dd1/a11yst-source-mapping-next-1.0.2.tgz","_from":"file:a11yst-source-mapping-next-1.0.2.tgz","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-/N6vrBmnECrSIhB5uAi9GJOy7IOCYRpRi5rRMNjBA7zfNjyK5NCAKa5Sl3iuCu5ElsplpTVH47rQy3NiqMhBBg==","shasum":"0cd3cf57cfcf5823c1caac5f91ac052bf871bd9d","tarball":"https://registry.npmjs.org/@a11yst/source-mapping-next/-/source-mapping-next-1.0.2.tgz","fileCount":47,"unpackedSize":119613,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCOdvNCsHR9oswuVDjxbenwtsm3C9F1zyvJo79oESRFLQIhAI3nWgOceZXx+Xni+o63lEArstckKO16NHddZ1z5QW7x"}]},"_npmUser":{"name":"angelabenavente","email":"ang.ben.dev@gmail.com"},"directories":{},"maintainers":[{"name":"angelabenavente","email":"ang.ben.dev@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/source-mapping-next_1.0.2_1787683128591_0.8099659643512258"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-23T17:31:03.372Z","modified":"2026-08-25T18:38:48.964Z","1.0.0":"2026-08-23T17:31:03.706Z","1.0.1":"2026-08-23T18:11:29.340Z","1.0.2":"2026-08-25T18:38:48.766Z"},"bugs":{"url":"https://github.com/angelabenavente/a11yst/issues"},"license":"MPL-2.0","homepage":"https://www.a11yst.dev","repository":{"type":"git","url":"git+https://github.com/angelabenavente/a11yst.git"},"description":"Conservative Next.js static route catalog and source mapping for a11yst","maintainers":[{"name":"angelabenavente","email":"ang.ben.dev@gmail.com"}],"readme":"# @a11yst/source-mapping-next [![NPM version](https://img.shields.io/npm/v/@a11yst/source-mapping-next.svg?style=flat)](https://www.npmjs.com/package/@a11yst/source-mapping-next) [![License: MPL-2.0](https://img.shields.io/badge/License-MPL--2.0-blue.svg)](LICENSE) [![NPM total downloads](https://img.shields.io/npm/dt/@a11yst/source-mapping-next.svg?style=flat)](https://www.npmjs.com/package/@a11yst/source-mapping-next)\n\nConservative static Next.js route catalog and source mapping for a11yst Phase 10e.\n\n## Scope\n\nThis package consumes `@a11yst/source-index` and `@a11yst/source-mapping-react` to:\n\n- Detect App Router roots (`app/`, `src/app/`) and Pages Router roots (`pages/`, `src/pages/`)\n- Build a static route catalog from indexed filenames only\n- Narrow React catalog files by matched route, router, scope, and optional hints\n- Delegate element matching to `mapReactSource()`\n- Enrich candidates with Next.js metadata\n\nSupported:\n\n- Static, dynamic, catch-all, and optional catch-all route patterns\n- App Router route groups, layouts, templates, and state files in the catalog\n- Pages Router `_app`, `_document`, `_error`, and special error pages\n- Client/server module boundary hints for App Router files\n- Conservative ambiguity when multiple files or routers match\n\nNot supported in 10e:\n\n- Reading `.next` build output or manifests\n- Executing Next.js or evaluating runtime navigation\n- Rewrites, redirects, middleware, basePath, or i18n routing\n- Custom `pageExtensions` from `next.config.*`\n- Route handlers and API routes as UI sources\n- Intercepting routes in automatic matching\n- Parallel routes without an explicit slot hint\n- Import resolution, source maps, ranking, recommendations, or audit integration\n\nPhase 10f adds Vue/Nuxt. Phase 10h adds ranking. Phase 10i adds recommendations.\n\n## Route narrowing\n\nRoute evidence reduces the React search space. It never creates a candidate by itself and never upgrades confidence to `exact`.\n\nUnique selector matches inside the narrowed file set keep React confidence rules (`high` for unique selectors, never `exact` except existing source locations).\n\nWhen the same selector appears in both a layout and a page, the result is `ambiguous` with no selected candidate.\n\n## Security\n\nThe catalog and mapping never store source code, AST nodes, concrete route parameter values, query strings, hash fragments, absolute paths, or secrets.\n\n## Public API\n\n- `createNextRouteCatalog()`\n- `mapNextSource()`\n- `normalizeNextRoutePath()`\n- `resolveRoutesForPath()`\n- `stableSerializeNextCatalog()`\n","readmeFilename":"README.md"}