{"_id":"@a11yst/recommendations","_rev":"3-9aa065e983287128cf03e663b713806a","name":"@a11yst/recommendations","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@a11yst/recommendations","version":"1.0.0","license":"MPL-2.0","_id":"@a11yst/recommendations@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":"b328b3ca1065e2fe98651034af5f58c1b3f48a9d","tarball":"https://registry.npmjs.org/@a11yst/recommendations/-/recommendations-1.0.0.tgz","fileCount":43,"integrity":"sha512-nke/u0Ne4az5XPxM0u1opPmg/L58gVkxI0loOSB6PhDsABqv3IHBzSUYR0bENauFewQP+3LGiIepIUBwYAxk1g==","signatures":[{"sig":"MEYCIQDXKFYH9h3FoDLrr5aad5acu/xqufELZM5V8Br6JyeNOAIhAMuh3ZTzzVIx0xZQxZf8JoyPV912v01qcamu6BdgHXQv","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":114019},"main":"./dist/index.js","type":"module","_from":"file:a11yst-recommendations-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/c2a2846afab62268570bda75127b501e/a11yst-recommendations-1.0.0.tgz","_integrity":"sha512-nke/u0Ne4az5XPxM0u1opPmg/L58gVkxI0loOSB6PhDsABqv3IHBzSUYR0bENauFewQP+3LGiIepIUBwYAxk1g==","repository":{"url":"git+https://github.com/angelabenavente/a11yst.git","type":"git"},"_npmVersion":"10.9.0","description":"Deterministic accessibility recommendation engine for a11yst","directories":{},"_nodeVersion":"22.12.0","dependencies":{"@a11yst/types":"1.0.0","@a11yst/source-mapping":"1.0.0","@a11yst/source-ranking":"1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/recommendations_1.0.0_1787506252107_0.9392975652536257","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@a11yst/recommendations","version":"1.0.1","license":"MPL-2.0","_id":"@a11yst/recommendations@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":"865fcebb98952fef24924a1b35677931711fbf1d","tarball":"https://registry.npmjs.org/@a11yst/recommendations/-/recommendations-1.0.1.tgz","fileCount":43,"integrity":"sha512-R4QYtkDaPEnG9ooChXHso8i9B6b/dtVH7W6uBAXBDYafG4XbOg6/ty6k5cVr5GY9GQ7rffOS1G0gGfH4QDM61Q==","signatures":[{"sig":"MEUCICMiCV3ZBRGxSDB6zGda9gi1KCdO7W+LdU90wAGRughfAiEAi1L+u1CANcWJwhhNu0q++6yrXG4Pdzhpf11K+ZTJDuI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":114019},"main":"./dist/index.js","type":"module","_from":"file:a11yst-recommendations-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/a8f77725961f3f740f2d1dcbc9765100/a11yst-recommendations-1.0.1.tgz","_integrity":"sha512-R4QYtkDaPEnG9ooChXHso8i9B6b/dtVH7W6uBAXBDYafG4XbOg6/ty6k5cVr5GY9GQ7rffOS1G0gGfH4QDM61Q==","repository":{"url":"git+https://github.com/angelabenavente/a11yst.git","type":"git"},"_npmVersion":"10.9.8","description":"Deterministic accessibility recommendation engine for a11yst","directories":{},"_nodeVersion":"22.23.1","dependencies":{"@a11yst/types":"1.0.1","@a11yst/source-mapping":"1.0.1","@a11yst/source-ranking":"1.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/recommendations_1.0.1_1787508680537_0.43374156435967115","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@a11yst/recommendations","version":"1.0.2","description":"Deterministic accessibility recommendation engine 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-mapping":"1.0.2","@a11yst/source-ranking":"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/recommendations@1.0.2","_integrity":"sha512-P0Oqte2ZlwZMGJXlITaQVrc7vQC8XJ2LuGXv5rJNLs+Cq389JVN77UVJ9RLB8Hjvaa3ZOxyYpRJzsDH4tmCMmw==","_resolved":"/private/var/folders/tf/l5jz90dj0yncc_ds04tbfs5c0000gn/T/b55bc691d803afea440ecce599069623/a11yst-recommendations-1.0.2.tgz","_from":"file:a11yst-recommendations-1.0.2.tgz","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-P0Oqte2ZlwZMGJXlITaQVrc7vQC8XJ2LuGXv5rJNLs+Cq389JVN77UVJ9RLB8Hjvaa3ZOxyYpRJzsDH4tmCMmw==","shasum":"2d027b46c6038b4624936354cb020d621a409d29","tarball":"https://registry.npmjs.org/@a11yst/recommendations/-/recommendations-1.0.2.tgz","fileCount":43,"unpackedSize":114371,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCyqOoPRXVVkJuYytMXK9cmp+Jv8SUfRY9pybiNFvVwvAIhAPRIg+pBU2Lg7xTZV7didw8Z+a6H0dCJFqMH0YjnSjYH"}]},"_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/recommendations_1.0.2_1787683119791_0.8817733359896802"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-23T17:30:51.916Z","modified":"2026-08-25T18:38:40.100Z","1.0.0":"2026-08-23T17:30:52.259Z","1.0.1":"2026-08-23T18:11:20.674Z","1.0.2":"2026-08-25T18:38:39.956Z"},"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":"Deterministic accessibility recommendation engine for a11yst","maintainers":[{"name":"angelabenavente","email":"ang.ben.dev@gmail.com"}],"readme":"# @a11yst/recommendations [![NPM version](https://img.shields.io/npm/v/@a11yst/recommendations.svg?style=flat)](https://www.npmjs.com/package/@a11yst/recommendations) [![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/recommendations.svg?style=flat)](https://www.npmjs.com/package/@a11yst/recommendations)\n\nDeterministic accessibility recommendation engine for a11yst findings.\n\n## Purpose\n\nFramework mappers and ranking identify where an issue may live. This package turns a\nnormalized finding plus optional source mapping/ranking into structured guidance:\nactions, verification steps, and generic code examples.\n\nIt does **not** read source files, generate patches, or integrate with audit output yet.\n\n## Recipes\n\nEach supported axe-style rule ID maps to a deterministic recipe with stable action IDs,\nverification steps, and framework-aware generic examples. Unknown rules return\n`unsupported` with limited manual guidance.\n\n## Source confidence vs applicability\n\n- **Source confidence** (from mapping/ranking): how trustworthy the code location is.\n- **Applicability** (on the recommendation): how relevant the recipe is to the finding.\n\nAn exact location does not make the recommendation infallible, and an ambiguous target\ncan still yield a useful rule-specific recommendation without selecting a file.\n\n## Targets\n\n- `source`: a single resolved location\n- `ambiguous`: no selected location; alternatives may be listed\n- `logical`: route/flow/checkpoint context only\n- `unmapped`: no source or logical context\n- `invalid`: unsafe or invalid mapping/ranking input\n\nRanking/mapping conflicts never silently pick a winner.\n\n## Security\n\nNo filesystem, browser, or network access. Inputs are sanitized; secrets and absolute\npaths are redacted. Help URLs must be safe `http`/`https` links and are never fetched.\n\n## Determinism\n\nSame inputs in any order produce identical recommendations, targets, diagnostics, and\nstable serialization. No AI, probabilities, or runtime plugins.\n\n## Future work\n\nPhase 10j will integrate mapping, ranking, and recommendations into audit outputs.\n","readmeFilename":"README.md"}