@github/accessibility-scanner-alt-text-plugin 0.0.1 → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,259 @@
-# @github/accessibility-scanner-alt-text-plugin (stub)
+# Alt-Text Plugin for the Accessibility Scanner
 
-Stub package published to reserve the name.
+The Alt-Text Plugin is a [plugin](https://github.com/github/accessibility-scanner/blob/main/PLUGINS.md) for the [AI-powered Accessibility Scanner](https://github.com/github/accessibility-scanner) that flags low-quality `alt` text on images. It complements axe-core's built-in `image-alt` rule, helping teams ship images with descriptive, screen-reader-friendly alternative text.
+
+The plugin helps teams:
+
+- 🖼️ Catch vague, generic, or filler `alt` text (`"image"`, `"photo"`, `"icon"`)
+- 📛 Catch raw filenames used as `alt` text (`"IMG_1234.png"`)
+- 🔁 Catch runs of adjacent images that share the same `alt` text
+- 🚧 Catch boilerplate placeholder `alt` text (`"todo"`, `"tbd"`, `"fixme"`)
+- ♿ Catch images missing an `alt` attribute entirely (without flagging intentional decorative `alt=""`)
+
+> ⚠️ **Note:** This plugin is in active development alongside the a11y scanner's public preview. New rules are still being added and end-to-end integration with the scanner's issue-filing workflow is still maturing. Always review filed issues before acting on them.
+
+---
+
+## [Frequently-Asked Questions (FAQ)](https://github.com/github/accessibility-scanner/blob/main/FAQ.md)
+
+The plugin inherits the a11y scanner's general FAQ — see the link above for questions about scanning, caching, GitHub Enterprise, and more. Plugin-specific questions are answered inline below.
+
+---
+
+## Background
+
+This plugin catches low-quality `alt` text that axe-core's built-in [`image-alt`](https://dequeuniversity.com/rules/axe/4.10/image-alt) rule cannot — vague single-word `alt`, raw filenames, runs of duplicate `alt`, and never-filled-in placeholders. The scope is intentionally narrow: deterministic, heuristic checks on `<img>` elements only. Non-`<img>` `role="img"` elements, decorative `alt=""`, and hidden subtrees are filtered out before any rule runs.
+
+The project is under active development alongside the scanner's public preview. Roadmap and open work live in this repo's [Issues](https://github.com/github/accessibility-scanner-alt-text-plugin/issues). See [CONTRIBUTING.md](./CONTRIBUTING.md) for how to contribute, including local setup, expected checks, and PR conventions.
+
+---
+
+## Requirements
+
+To use the Alt-Text Plugin, you'll need:
+
+- **The [AI-powered Accessibility Scanner](https://github.com/github/accessibility-scanner)** (v3 or later) wired into a GitHub Actions workflow in your repository
+- **Everything required to run the scanner itself** (Actions enabled, Issues enabled, a `GH_TOKEN` PAT — see the [scanner README](https://github.com/github/accessibility-scanner#requirements) for the full list)
+
+The plugin is published to npm as [`@github/accessibility-scanner-alt-text-plugin`](https://www.npmjs.com/package/@github/accessibility-scanner-alt-text-plugin). The scanner installs it for you when running the `Find` sub-action — you don't need to copy any source into your repository or run `npm install` yourself.
+
+To develop the plugin locally, you'll also need:
+
+- **Node.js** matching the `engines` field in [`package.json`](./package.json) — currently `^22.13.0 || ^24 || ^26`
+- **npm** (ships with Node)
+
+---
+
+## Getting started
+
+### 1. Enable the plugin in your workflow
+
+The plugin is loaded from its npm package — there's nothing to copy into your repo. Add it to the scanner action's `scans` input as an **object** with `name`, `package`, and (recommended) a pinned `version`. Keep `"axe"` in the list too, since the scanner only runs Axe by default:
+
+```yaml
+name: Accessibility Scanner
+on: workflow_dispatch
+
+jobs:
+  accessibility_scanner:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: github/accessibility-scanner@v3
+        with:
+          urls: |
+            https://example.com
+          repository: REPLACE_THIS/REPLACE_THIS
+          token: ${{ secrets.GH_TOKEN }}
+          cache_key: REPLACE_THIS
+          scans: |
+            ["axe", {"name": "alt-text-scan", "package": "@github/accessibility-scanner-alt-text-plugin", "version": "1.0.0"}]
+```
+
+> 👉 Update all `REPLACE_THIS` placeholders with your actual values. See the [scanner's Action inputs](https://github.com/github/accessibility-scanner#action-inputs) for the full list, and the scanner's [PLUGINS.md](https://github.com/github/accessibility-scanner/blob/main/PLUGINS.md) for how NPM plugins are loaded.
+
+📚 Learn more
+
+- [Plugin docs in the scanner repository](https://github.com/github/accessibility-scanner/blob/main/PLUGINS.md)
+- [Scanner getting-started guide](https://github.com/github/accessibility-scanner#getting-started)
+- [Writing workflows](https://docs.github.com/en/actions/how-tos/write-workflows)
+
+---
+
+### 2. Run your first scan
+
+Trigger your scanner workflow manually or on its configured schedule. The plugin runs on every URL the scanner visits, extracts each image exposed to assistive technology, and emits a finding for every rule violation. The scanner then turns those findings into GitHub issues.
+
+📚 Learn more
+
+- [View workflow run history](https://docs.github.com/en/actions/how-tos/monitor-workflows/view-workflow-run-history)
+- [Running a workflow manually](https://docs.github.com/en/actions/how-tos/manage-workflow-runs/manually-run-a-workflow#running-a-workflow)
+
+---
+
+## Rules
+
+The plugin runs every extracted image through an append-only registry of rules. Each rule returns a finding when an image fails its criteria, and the scanner turns each finding into an issue.
+
+| Rule                | ID                     | Fires when                                                                                                                                                                                                                                                                                                          | Example (flagged)                                                        |
+| ------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| **Missing alt**     | `missing-alt-text`     | The `alt` attribute is absent (`null`) or whitespace-only (`"   "`). `alt=""` is treated as intentional decorative use and is **not** flagged.                                                                                                                                                                      | `<img src="cat.png">`<br>`<img src="cat.png" alt="   ">`                 |
+| **Vague alt**       | `vague-alt-text`       | The alt text is one of a curated set of generic single words (`image`, `photo`, `icon`, `logo`, `screenshot`, `chart`, `untitled`, etc.) or short filler phrases (`an image of`, `a photo of`). Normalization is applied before matching: case-insensitive, whitespace-collapsed, surrounding punctuation stripped. | `<img alt="image">`<br>`<img alt="An image of">`<br>`<img alt="PHOTO.">` |
+| **Filename as alt** | `filename-alt-text`    | The alt text ends in a common image file extension (`.png`, `.jpg`, `.jpeg`, `.gif`, `.svg`, `.webp`, `.bmp`, `.ico`).                                                                                                                                                                                              | `<img alt="IMG_1234.png">`<br>`<img alt="Screenshot 2024-04-28.jpg">`    |
+| **Repeated alt**    | `repeated-alt-text`    | Two or more adjacent images on the rendered page share the same normalized alt text. Useful for patterns like five star icons all labeled `"3/5 stars"`.                                                                                                                                                            | Five consecutive `<img alt="3/5 stars">` elements                        |
+| **Placeholder alt** | `placeholder-alt-text` | The alt text matches a known boilerplate string that signals it was never written (`todo`, `tbd`, `fixme`, `placeholder`, `alt text`, `insert alt text`, `image alt`). Normalization is applied before matching.                                                                                                    | `<img alt="TODO">`<br>`<img alt="insert alt text">`                      |
+
+### Image extraction
+
+Before rules run, the plugin extracts images from the page through Playwright's accessibility tree (`page.getByRole('img')`) and narrows the result to actual `<img>` elements. The following are filtered out automatically and never reach the rules:
+
+- Non-`<img>` elements with `role="img"` (e.g. `<svg role="img">`, `<div role="img">`) — this plugin's rules only apply to HTML `<img>` tags
+- Images inside `aria-hidden="true"` subtrees
+- Images inside `display: none` or `visibility: hidden` subtrees
+- Decorative images with `alt=""` (implicit `role="presentation"`)
+
+### Overlap with Axe
+
+The scanner's built-in Axe scan includes a rule called [`image-alt`](https://dequeuniversity.com/rules/axe/4.10/image-alt) that catches missing and whitespace-only `alt` attributes. If you have both `"axe"` and `"alt-text-scan"` enabled, the same image may be flagged by both. The other four rules in this plugin (`vague-alt-text`, `filename-alt-text`, `repeated-alt-text`, `placeholder-alt-text`) are unique to the plugin and don't overlap with Axe.
+
+---
+
+## Output
+
+When a rule fires, the plugin emits a finding with the following shape (matching the scanner's [`Finding` type](https://github.com/github/accessibility-scanner/blob/main/.github/actions/find/src/types.d.ts)):
+
+- `scannerType` — always `'alt-text-scan'`; identifies which plugin produced the finding
+- `ruleId` — the ID of the rule that fired (e.g. `'vague-alt-text'`)
+- `url` — the page URL where the image was found
+- `html` — the offending `<img>` element's outer HTML
+- `problemShort` — one-sentence description of what's wrong, including the offending alt text where applicable
+- `problemUrl` — link to the relevant WCAG technique or W3C tutorial
+- `solutionShort` — one-sentence description of how to fix it
+- `solutionLong` — optional longer explanation when one sentence isn't enough
+
+The scanner uses these fields to file or update a GitHub issue.
+
+---
+
+## Configuration
+
+To override the default enabled state of one or more rules, add a `config.json` file in your scanner repository at `.github/scanner-plugins/alt-text-scan/config.json`:
+
+```text
+.github/scanner-plugins/alt-text-scan/
+└── config.json   ← optional
+```
+
+```json
+{
+  "rules": {
+    "repeated-alt-text": false,
+    "placeholder-alt-text": false
+  }
+}
+```
+
+- Each key under `rules` is a rule ID from the [Rules](#rules) table above; the value is `true` (run the rule) or `false` (skip it).
+- Rules you don't list keep their default behavior. Today every rule defaults to enabled.
+- Unknown rule IDs and non-boolean values are logged as warnings and ignored (typo guard).
+- A missing or malformed `config.json` causes the plugin to run with all defaults.
+- The plugin reads the config once at startup, not per URL.
+
+A JSON Schema is published at [`schema/config.schema.json`](./schema/config.schema.json). Add a `$schema` line at the top of your `config.json` to get autocomplete, hover docs, and inline validation in editors that support JSON Schema (VS Code, JetBrains IDEs, etc.):
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/github/accessibility-scanner-alt-text-plugin/main/schema/config.schema.json",
+  "rules": {
+    "repeated-alt-text": false
+  }
+}
+```
+
+The `$schema` line is optional and is ignored by the plugin at runtime.
+
+---
+
+## Development
+
+### Local setup
+
+```sh
+git clone https://github.com/github/accessibility-scanner-alt-text-plugin.git
+cd accessibility-scanner-alt-text-plugin
+npm ci
+```
+
+### Common scripts
+
+| Script                 | What it does                                  |
+| ---------------------- | --------------------------------------------- |
+| `npm run test`         | Runs the Vitest unit suite once               |
+| `npm run test:watch`   | Runs Vitest in watch mode                     |
+| `npm run typecheck`    | Runs `tsc --noEmit` against the whole project |
+| `npm run lint`         | Runs ESLint                                   |
+| `npm run format`       | Rewrites files with Prettier                  |
+| `npm run format:check` | Reports formatting violations without writing |
+
+Pull requests trigger two CI workflows: [`lint.yml`](./.github/workflows/lint.yml) runs `lint` and `format:check` on Node 24, and [`test.yml`](./.github/workflows/test.yml) runs `typecheck` and `test` across Node 22, 24, and 26.
+
+### Project layout
+
+```text
+index.ts                    # Plugin entry point: exports `name` and the default scan function
+src/
+  config.ts                 # Loads & validates .github/scanner-plugins/alt-text-scan/config.json
+  extract.ts                # Pulls visible <img> records from a Playwright page
+  findings.ts               # Translates each RuleResult into the scanner's Finding shape
+  rules/
+    index.ts                # Append-only rule registry
+    missing-alt-text.ts
+    vague-alt-text.ts
+    filename-alt-text.ts
+    placeholder-alt-text.ts
+    repeated-alt-text.ts
+  utils/
+    normalize-alt-text.ts   # Lowercase, trim, collapse whitespace, strip punctuation
+  types.ts                  # Rule, RuleContext, RuleResult, ImageRecord, Finding
+tests/
+  extract.test.ts           # Playwright-driven tests for the image extractor
+  example-site.test.ts      # Runs the plugin against the example/site-with-errors fixture
+  fixtures/                 # Static HTML fixtures used by the extractor tests
+  unit/
+    *.test.ts               # One file per rule, plus config.test.ts for the loader
+  utils/
+    helpers.ts              # makeImage() and evaluateAlts() — shared across rule tests
+```
+
+### Adding a new rule
+
+1. Create `src/rules/<rule-name>.ts` exporting a `Rule` (see [`src/types.ts`](./src/types.ts) for the shape — `id`, `problemUrl`, and `evaluate(context)`). Filenames under `src/` and `tests/` must be kebab-case; ESLint's `check-file/filename-naming-convention` rule enforces this.
+2. Import the rule in [`src/rules/index.ts`](./src/rules/index.ts) and append it to `allRules`. The registry is append-only — don't reorder existing rules.
+3. Add a `tests/unit/<rule-name>.test.ts` file. Use `evaluateAlts(alts, rule)` and `makeImage(overrides)` from [`tests/utils/helpers.ts`](./tests/utils/helpers.ts) for the common cases; construct an explicit `RuleContext` only when you need control over `src` or other per-image fields.
+4. Run `npm run test && npm run typecheck && npm run lint` locally before opening a PR. CI re-runs them.
+
+> [!IMPORTANT]
+> Image extraction happens once per page, before any rule runs, so every rule sees the same filtered list regardless of which rules are enabled. Don't reach into the DOM from a rule — work from the `ImageRecord[]` the rule's context provides.
+
+---
+
+## Feedback
+
+💬 We welcome your feedback! To submit feedback or report issues, please open an issue in this repository. For broader feedback on the a11y scanner itself, file it in the [scanner repository](https://github.com/github/accessibility-scanner/issues).
+
+---
+
+## License
+
+📄 This project is licensed under the terms of the MIT open source license. See the [LICENSE](./LICENSE) file for the full terms.
+
+## Maintainers
+
+🔧 Maintained alongside the [AI-powered Accessibility Scanner](https://github.com/github/accessibility-scanner). See [CODEOWNERS](./.github/CODEOWNERS) for the responsible team.
+
+## Support
+
+❓ For support, please open an issue in this repository. See [SUPPORT.md](./SUPPORT.md) for support expectations, or the scanner's [SUPPORT](https://github.com/github/accessibility-scanner/blob/main/SUPPORT.md) document for guidance that applies across the project.
+
+## Acknowledgement
+
+✨ Built on top of [Playwright](https://playwright.dev/), [Vitest](https://vitest.dev/), and the broader open-source accessibility tooling ecosystem. Thank you to everyone contributing rules, tests, and review.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { PluginArgs } from './src/types.js';
+export declare const name = "alt-text-scan";
+export default function altTextScan({ page, addFinding }: PluginArgs): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,gBAAgB,CAAA;AAE9C,eAAO,MAAM,IAAI,kBAAkB,CAAA;AAOnC,wBAA8B,WAAW,CAAC,EAAC,IAAI,EAAE,UAAU,EAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BvF"}

package/dist/index.js

@@ -0,0 +1,40 @@
+import { join } from 'node:path';
+import { extractImages } from './src/extract.js';
+import { allRules } from './src/rules/index.js';
+import { emitFindings } from './src/findings.js';
+import { loadConfig } from './src/config.js';
+export const name = 'alt-text-scan';
+// Config lives in the consumer's repo at `.github/scanner-plugins/<name>/config.json`.
+const configPath = join(process.cwd(), '.github', 'scanner-plugins', name, 'config.json');
+const knownRuleIds = new Set(allRules.map(r => r.id));
+const configPromise = loadConfig(configPath, knownRuleIds);
+export default async function altTextScan({ page, addFinding }) {
+    const url = page.url();
+    const { ruleOverrides } = await configPromise;
+    const enabledRules = allRules.filter(rule => ruleOverrides.get(rule.id) ?? rule.defaultEnabled ?? true);
+    // Extract images from the page.
+    let images;
+    try {
+        images = await extractImages(page);
+    }
+    catch (err) {
+        console.error(`[alt-text-scan] failed to extract images from ${url}:`, err);
+        return;
+    }
+    if (images.length === 0)
+        return;
+    const ctx = { url, images };
+    // Enforce checks on each image against each rule.
+    for (const rule of enabledRules) {
+        let results;
+        try {
+            results = rule.evaluate(ctx);
+        }
+        catch (err) {
+            console.error(`[alt-text-scan] rule "${rule.id}" threw on ${url}:`, err);
+            continue;
+        }
+        await emitFindings(rule, results, url, addFinding);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAA;AAC9B,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAA;AAC7C,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAA;AAG1C,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAA;AAEnC,uFAAuF;AACvF,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,aAAa,CAAC,CAAA;AACzF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AACrD,MAAM,aAAa,GAAG,UAAU,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;AAE1D,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,WAAW,CAAC,EAAC,IAAI,EAAE,UAAU,EAAa;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAEtB,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,aAAa,CAAA;IAC3C,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,CAAA;IAEvG,gCAAgC;IAChC,IAAI,MAAM,CAAA;IACV,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,iDAAiD,GAAG,GAAG,EAAE,GAAG,CAAC,CAAA;QAC3E,OAAM;IACR,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAE/B,MAAM,GAAG,GAAG,EAAC,GAAG,EAAE,MAAM,EAAC,CAAA;IAEzB,kDAAkD;IAClD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,OAAO,CAAA;QACX,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,yBAAyB,IAAI,CAAC,EAAE,cAAc,GAAG,GAAG,EAAE,GAAG,CAAC,CAAA;YACxE,SAAQ;QACV,CAAC;QACD,MAAM,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;IACpD,CAAC;AACH,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,5 @@
+export type PluginConfig = {
+    ruleOverrides: ReadonlyMap<string, boolean>;
+};
+export declare function loadConfig(configPath: string, knownRuleIds: ReadonlySet<string>): Promise<PluginConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC5C,CAAA;AAID,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAqB7G"}

package/dist/src/config.js

@@ -0,0 +1,45 @@
+import { readFile } from 'node:fs/promises';
+const emptyConfig = () => ({ ruleOverrides: new Map() });
+export async function loadConfig(configPath, knownRuleIds) {
+    let raw;
+    try {
+        raw = await readFile(configPath, 'utf8');
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return emptyConfig();
+        }
+        console.warn(`[alt-text-scan] failed to read ${configPath}; running with default rule settings:`, err);
+        return emptyConfig();
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        console.error(`[alt-text-scan] failed to parse ${configPath}; running with default rule settings:`, err);
+        return emptyConfig();
+    }
+    return { ruleOverrides: collectRuleOverrides(parsed, knownRuleIds) };
+}
+function collectRuleOverrides(parsed, knownRuleIds) {
+    const result = new Map();
+    if (!parsed || typeof parsed !== 'object')
+        return result;
+    const rules = parsed.rules;
+    if (!rules || typeof rules !== 'object' || Array.isArray(rules))
+        return result;
+    for (const [id, value] of Object.entries(rules)) {
+        if (!knownRuleIds.has(id)) {
+            console.warn(`[alt-text-scan] unknown rule id "${id}" in config; ignoring. Known ids: ${[...knownRuleIds].join(', ')}`);
+            continue;
+        }
+        if (typeof value !== 'boolean') {
+            console.warn(`[alt-text-scan] non-boolean value for rule "${id}" in config (got ${typeof value}); ignoring.`);
+            continue;
+        }
+        result.set(id, value);
+    }
+    return result;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAA;AAMzC,MAAM,WAAW,GAAG,GAAiB,EAAE,CAAC,CAAC,EAAC,aAAa,EAAE,IAAI,GAAG,EAAE,EAAC,CAAC,CAAA;AAEpE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB,EAAE,YAAiC;IACpF,IAAI,GAAW,CAAA;IACf,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnE,OAAO,WAAW,EAAE,CAAA;QACtB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,kCAAkC,UAAU,uCAAuC,EAAE,GAAG,CAAC,CAAA;QACtG,OAAO,WAAW,EAAE,CAAA;IACtB,CAAC;IAED,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,mCAAmC,UAAU,uCAAuC,EAAE,GAAG,CAAC,CAAA;QACxG,OAAO,WAAW,EAAE,CAAA;IACtB,CAAC;IAED,OAAO,EAAC,aAAa,EAAE,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,EAAC,CAAA;AACpE,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAe,EAAE,YAAiC;IAC9E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAA;IACzC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAA;IAExD,MAAM,KAAK,GAAI,MAA4B,CAAC,KAAK,CAAA;IACjD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAA;IAE9E,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QAC3E,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CACV,oCAAoC,EAAE,qCAAqC,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1G,CAAA;YACD,SAAQ;QACV,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,+CAA+C,EAAE,oBAAoB,OAAO,KAAK,cAAc,CAAC,CAAA;YAC7G,SAAQ;QACV,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;IACvB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/src/extract.d.ts

@@ -0,0 +1,4 @@
+import type { Page } from 'playwright';
+import type { ImageRecord } from './types.js';
+export declare function extractImages(page: Page): Promise<ImageRecord[]>;
+//# sourceMappingURL=extract.d.ts.map

package/dist/src/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/extract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,YAAY,CAAA;AACpC,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,YAAY,CAAA;AAI3C,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAqBtE"}

package/dist/src/extract.js

@@ -0,0 +1,22 @@
+// Returns one ImageRecord per HTML <img> element that is exposed in the accessibility tree.
+// Using getByRole('img') filters out elements that assistive tech cannot perceive.
+export async function extractImages(page) {
+    return page.getByRole('img').evaluateAll(els => els
+        // getByRole('img') also matches SVG/div with role="img", so filter those out.
+        .filter(el => el.tagName === 'IMG')
+        .map(el => {
+        const rect = el.getBoundingClientRect();
+        const boundingBox = rect.width === 0 && rect.height === 0 ? null : { x: rect.x, y: rect.y, width: rect.width, height: rect.height };
+        return {
+            src: el.getAttribute('src'),
+            alt: el.getAttribute('alt'),
+            role: el.getAttribute('role'),
+            ariaHidden: el.getAttribute('aria-hidden') === 'true',
+            ariaLabel: el.getAttribute('aria-label'),
+            ariaLabelledBy: el.getAttribute('aria-labelledby'),
+            outerHTML: el.outerHTML,
+            boundingBox,
+        };
+    }));
+}
+//# sourceMappingURL=extract.js.map

package/dist/src/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/extract.ts"],"names":[],"mappings":"AAGA,4FAA4F;AAC5F,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAU;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAC7C,GAAG;QACD,8EAA8E;SAC7E,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC;SAClC,GAAG,CAAC,EAAE,CAAC,EAAE;QACR,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAA;QACvC,MAAM,WAAW,GACf,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAC,CAAA;QAC/G,OAAO;YACL,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC;YAC3B,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC;YAC3B,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;YAC7B,UAAU,EAAE,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,MAAM;YACrD,SAAS,EAAE,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC;YACxC,cAAc,EAAE,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC;YAClD,SAAS,EAAE,EAAE,CAAC,SAAS;YACvB,WAAW;SACZ,CAAA;IACH,CAAC,CAAC,CACL,CAAA;AACH,CAAC"}

package/dist/src/findings.d.ts

@@ -0,0 +1,3 @@
+import type { Finding, Rule, RuleResult } from './types.js';
+export declare function emitFindings(rule: Rule, results: RuleResult[], url: string, addFinding: (finding: Finding) => Promise<void>): Promise<void>;
+//# sourceMappingURL=findings.d.ts.map

package/dist/src/findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../../src/findings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAC,MAAM,YAAY,CAAA;AAGzD,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,UAAU,EAAE,EACrB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/src/findings.js

@@ -0,0 +1,16 @@
+// Translates each RuleResult into the scanner's Finding shape and records it.
+export async function emitFindings(rule, results, url, addFinding) {
+    for (const result of results) {
+        await addFinding({
+            scannerType: 'alt-text-scan',
+            ruleId: rule.id,
+            url,
+            html: result.image.outerHTML,
+            problemShort: result.problemShort,
+            problemUrl: rule.problemUrl,
+            solutionShort: result.solutionShort,
+            solutionLong: result.solutionLong,
+        });
+    }
+}
+//# sourceMappingURL=findings.js.map

package/dist/src/findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.js","sourceRoot":"","sources":["../../src/findings.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAU,EACV,OAAqB,EACrB,GAAW,EACX,UAA+C;IAE/C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,UAAU,CAAC;YACf,WAAW,EAAE,eAAe;YAC5B,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,GAAG;YACH,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;YAC5B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}

package/dist/src/rules/filename-alt-text.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types.js';
+export declare const filenameAltText: Rule;
+//# sourceMappingURL=filename-alt-text.d.ts.map

package/dist/src/rules/filename-alt-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename-alt-text.d.ts","sourceRoot":"","sources":["../../../src/rules/filename-alt-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAA0B,MAAM,aAAa,CAAA;AAI9D,eAAO,MAAM,eAAe,EAAE,IAmB7B,CAAA"}

package/dist/src/rules/filename-alt-text.js

@@ -0,0 +1,21 @@
+const FILENAME_PATTERN = /\.(png|jpg|jpeg|gif|svg|webp|bmp|ico)$/i;
+export const filenameAltText = {
+    id: 'filename-alt-text',
+    problemUrl: 'https://www.w3.org/WAI/tutorials/images/decision-tree/',
+    evaluate(context) {
+        const results = [];
+        for (const image of context.images) {
+            if (image.alt === null || image.alt === '')
+                continue;
+            if (!FILENAME_PATTERN.test(image.alt.trim()))
+                continue;
+            results.push({
+                image,
+                problemShort: `Image alt text appears to be a filename: "${image.alt}"`,
+                solutionShort: 'Replace the filename with a meaningful description of the image content.',
+            });
+        }
+        return results;
+    },
+};
+//# sourceMappingURL=filename-alt-text.js.map

package/dist/src/rules/filename-alt-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename-alt-text.js","sourceRoot":"","sources":["../../../src/rules/filename-alt-text.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG,yCAAyC,CAAA;AAElE,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,mBAAmB;IACvB,UAAU,EAAE,wDAAwD;IACpE,QAAQ,CAAC,OAAoB;QAC3B,MAAM,OAAO,GAAiB,EAAE,CAAA;QAEhC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,KAAK,EAAE;gBAAE,SAAQ;YACpD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBAAE,SAAQ;YAEtD,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK;gBACL,YAAY,EAAE,6CAA6C,KAAK,CAAC,GAAG,GAAG;gBACvE,aAAa,EAAE,0EAA0E;aAC1F,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;CACF,CAAA"}

package/dist/src/rules/index.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types.js';
+export declare const allRules: Rule[];
+//# sourceMappingURL=index.d.ts.map

package/dist/src/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rules/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAQrC,eAAO,MAAM,QAAQ,EAAE,IAAI,EAAyF,CAAA"}

package/dist/src/rules/index.js

@@ -0,0 +1,8 @@
+import { filenameAltText } from './filename-alt-text.js';
+import { vagueAltText } from './vague-alt-text.js';
+import { missingAltText } from './missing-alt-text.js';
+import { placeholderAltText } from './placeholder-alt-text.js';
+import { repeatedAltText } from './repeated-alt-text.js';
+// Append-only registry. Add a rule by importing it here and pushing it onto the array.
+export const allRules = [filenameAltText, vagueAltText, missingAltText, placeholderAltText, repeatedAltText];
+//# sourceMappingURL=index.js.map

package/dist/src/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rules/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,eAAe,EAAC,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAC,kBAAkB,EAAC,MAAM,2BAA2B,CAAA;AAC5D,OAAO,EAAC,eAAe,EAAC,MAAM,wBAAwB,CAAA;AAEtD,uFAAuF;AACvF,MAAM,CAAC,MAAM,QAAQ,GAAW,CAAC,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAA"}

package/dist/src/rules/missing-alt-text.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types.js';
+export declare const missingAltText: Rule;
+//# sourceMappingURL=missing-alt-text.d.ts.map

package/dist/src/rules/missing-alt-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-alt-text.d.ts","sourceRoot":"","sources":["../../../src/rules/missing-alt-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAA0B,MAAM,aAAa,CAAA;AAE9D,eAAO,MAAM,cAAc,EAAE,IAqB5B,CAAA"}

package/dist/src/rules/missing-alt-text.js

@@ -0,0 +1,22 @@
+export const missingAltText = {
+    id: 'missing-alt-text',
+    problemUrl: 'https://www.w3.org/WAI/WCAG21/Understanding/non-text-content.html',
+    evaluate(context) {
+        const results = [];
+        for (const image of context.images) {
+            // alt === '' is intentional to mark an image as decorative
+            if (image.alt === '')
+                continue;
+            // alt text has real content, so skip
+            if (image.alt !== null && image.alt.trim() !== '')
+                continue;
+            results.push({
+                image,
+                problemShort: 'Image has no usable alt text (attribute is missing or whitespace-only).',
+                solutionShort: 'Add an alt attribute describing the image, or alt="" if it is purely decorative.',
+            });
+        }
+        return results;
+    },
+};
+//# sourceMappingURL=missing-alt-text.js.map

package/dist/src/rules/missing-alt-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-alt-text.js","sourceRoot":"","sources":["../../../src/rules/missing-alt-text.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,EAAE,EAAE,kBAAkB;IACtB,UAAU,EAAE,mEAAmE;IAC/E,QAAQ,CAAC,OAAoB;QAC3B,MAAM,OAAO,GAAiB,EAAE,CAAA;QAEhC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,2DAA2D;YAC3D,IAAI,KAAK,CAAC,GAAG,KAAK,EAAE;gBAAE,SAAQ;YAC9B,qCAAqC;YACrC,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,SAAQ;YAE3D,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK;gBACL,YAAY,EAAE,yEAAyE;gBACvF,aAAa,EAAE,kFAAkF;aAClG,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;CACF,CAAA"}

package/dist/src/rules/placeholder-alt-text.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types.js';
+export declare const placeholderAltText: Rule;
+//# sourceMappingURL=placeholder-alt-text.d.ts.map

package/dist/src/rules/placeholder-alt-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-alt-text.d.ts","sourceRoot":"","sources":["../../../src/rules/placeholder-alt-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAA0B,MAAM,aAAa,CAAA;AAc9D,eAAO,MAAM,kBAAkB,EAAE,IAmBhC,CAAA"}

package/dist/src/rules/placeholder-alt-text.js

@@ -0,0 +1,31 @@
+import { normalizeAltText } from '../utils/normalize-alt-text.js';
+// Known placeholder/boilerplate strings that signal the alt text was never written.
+const PLACEHOLDER_ALT_TEXT = new Set([
+    'todo',
+    'tbd',
+    'placeholder',
+    'alt text',
+    'insert alt text',
+    'image alt',
+    'fixme',
+]);
+export const placeholderAltText = {
+    id: 'placeholder-alt-text',
+    problemUrl: 'https://www.w3.org/WAI/tutorials/images/decision-tree/',
+    evaluate(context) {
+        const results = [];
+        for (const image of context.images) {
+            if (image.alt === null || image.alt === '')
+                continue;
+            if (!PLACEHOLDER_ALT_TEXT.has(normalizeAltText(image.alt)))
+                continue;
+            results.push({
+                image,
+                problemShort: `Image alt text is placeholder text: "${image.alt}"`,
+                solutionShort: 'Replace the placeholder with a meaningful description of the image content.',
+            });
+        }
+        return results;
+    },
+};
+//# sourceMappingURL=placeholder-alt-text.js.map

package/dist/src/rules/placeholder-alt-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-alt-text.js","sourceRoot":"","sources":["../../../src/rules/placeholder-alt-text.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAC,MAAM,gCAAgC,CAAA;AAE/D,oFAAoF;AACpF,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,MAAM;IACN,KAAK;IACL,aAAa;IACb,UAAU;IACV,iBAAiB;IACjB,WAAW;IACX,OAAO;CACR,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,EAAE,EAAE,sBAAsB;IAC1B,UAAU,EAAE,wDAAwD;IACpE,QAAQ,CAAC,OAAoB;QAC3B,MAAM,OAAO,GAAiB,EAAE,CAAA;QAEhC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,KAAK,EAAE;gBAAE,SAAQ;YACpD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAAE,SAAQ;YAEpE,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK;gBACL,YAAY,EAAE,wCAAwC,KAAK,CAAC,GAAG,GAAG;gBAClE,aAAa,EAAE,6EAA6E;aAC7F,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;CACF,CAAA"}

package/dist/src/rules/repeated-alt-text.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types.js';
+export declare const repeatedAltText: Rule;
+//# sourceMappingURL=repeated-alt-text.d.ts.map

package/dist/src/rules/repeated-alt-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeated-alt-text.d.ts","sourceRoot":"","sources":["../../../src/rules/repeated-alt-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,IAAI,EAAa,MAAM,aAAa,CAAA;AA+B9D,eAAO,MAAM,eAAe,EAAE,IA4C7B,CAAA"}

package/dist/src/rules/repeated-alt-text.js

@@ -0,0 +1,67 @@
+import { normalizeAltText } from '../utils/normalize-alt-text.js';
+// Minimum number of consecutive images sharing the same alt before the run is flagged.
+const MIN_RUN_LENGTH = 2;
+// Two adjacent images extend a "run" only if the gap between their bounding boxes is at
+// most this multiple of the larger box's longest dimension.
+const GAP_MULTIPLIER = 3;
+// Returns true when two images are far enough apart on screen that a user
+// would not perceive them as part of the same repeating group. Fails open
+// when either image lacks a measurable layout box: with no spatial data we
+// fall back to the pre-spatial behavior rather than silently dropping a run.
+function tooFarApart(a, b) {
+    if (!a.boundingBox || !b.boundingBox)
+        return false;
+    const aRight = a.boundingBox.x + a.boundingBox.width;
+    const aBottom = a.boundingBox.y + a.boundingBox.height;
+    const bRight = b.boundingBox.x + b.boundingBox.width;
+    const bBottom = b.boundingBox.y + b.boundingBox.height;
+    const horizontalGap = Math.max(0, Math.max(a.boundingBox.x, b.boundingBox.x) - Math.min(aRight, bRight));
+    const verticalGap = Math.max(0, Math.max(a.boundingBox.y, b.boundingBox.y) - Math.min(aBottom, bBottom));
+    const gap = Math.max(horizontalGap, verticalGap);
+    const largerDim = Math.max(a.boundingBox.width, a.boundingBox.height, b.boundingBox.width, b.boundingBox.height);
+    return gap > GAP_MULTIPLIER * largerDim;
+}
+export const repeatedAltText = {
+    id: 'repeated-alt-text',
+    problemUrl: 'https://www.w3.org/WAI/tutorials/images/groups/',
+    evaluate(context) {
+        const findings = [];
+        const { images } = context;
+        let i = 0;
+        while (i < images.length) {
+            // Normalize once and don't consider empty alt texts in run length
+            const start = images[i].alt;
+            const currAlt = start === null ? '' : normalizeAltText(start);
+            if (currAlt === '') {
+                i++;
+                continue;
+            }
+            // Detect length of consecutive alt texts
+            let j = i + 1;
+            while (j < images.length) {
+                const next = images[j].alt;
+                const nextAlt = next === null ? '' : normalizeAltText(next);
+                if (nextAlt !== currAlt)
+                    break;
+                if (tooFarApart(images[j - 1], images[j]))
+                    break;
+                j++;
+            }
+            const runLength = j - i;
+            if (runLength >= MIN_RUN_LENGTH) {
+                // Flag every image in the run except the first
+                for (let k = i + 1; k < j; k++) {
+                    const img = images[k];
+                    findings.push({
+                        image: img,
+                        problemShort: `Alt text is repeated across ${runLength} consecutive images:\n"${img.alt}"`,
+                        solutionShort: 'If these images form one visual group, describe the group once and mark repeated/decorative images with `alt=""`. Otherwise, give each image unique alt text.',
+                    });
+                }
+            }
+            i = j;
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=repeated-alt-text.js.map

package/dist/src/rules/repeated-alt-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeated-alt-text.js","sourceRoot":"","sources":["../../../src/rules/repeated-alt-text.ts"],"names":[],"mappings":"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"}

package/dist/src/rules/vague-alt-text.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types.js';
+export declare const vagueAltText: Rule;
+//# sourceMappingURL=vague-alt-text.d.ts.map

package/dist/src/rules/vague-alt-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vague-alt-text.d.ts","sourceRoot":"","sources":["../../../src/rules/vague-alt-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAa,MAAM,aAAa,CAAA;AA0HjD,eAAO,MAAM,YAAY,EAAE,IAsB1B,CAAA"}

package/dist/src/rules/vague-alt-text.js

@@ -0,0 +1,133 @@
+import { normalizeAltText } from '../utils/normalize-alt-text.js';
+// Set of words that by themselves, are too vague to be useful alt text
+const VAGUE_WORDS = new Set([
+    // Generic media terms
+    'image',
+    'images',
+    'img',
+    'photo',
+    'photos',
+    'photograph',
+    'photographs',
+    'picture',
+    'pictures',
+    'pic',
+    'pics',
+    'graphic',
+    'graphics',
+    'visual',
+    'visuals',
+    'media',
+    'clipart',
+    'gif',
+    'gifs',
+    // Common UI/image labels
+    'icon',
+    'icons',
+    'illustration',
+    'illustrations',
+    'banner',
+    'banners',
+    'thumbnail',
+    'thumbnails',
+    'logo',
+    'logos',
+    'avatar',
+    'avatars',
+    // Very generic descriptors
+    'art',
+    'artwork',
+    'drawing',
+    'drawings',
+    'diagram',
+    'diagrams',
+    'chart',
+    'charts',
+    'graph',
+    'graphs',
+    'screenshot',
+    'screenshots',
+    'figure',
+    'figures',
+    'painting',
+    'paintings',
+    'map',
+    'maps',
+    // Placeholders
+    // Note: todo, tbd, fixme, and placeholder live in placeholder-alt-text.ts.
+    'sample',
+    'example',
+    'test',
+    'demo',
+    'default',
+    'untitled',
+    'null',
+    'undefined',
+    'none',
+    // File format / extension names
+    'jpg',
+    'jpeg',
+    'png',
+    'svg',
+    'webp',
+    // Contextless terms
+    'this',
+    'that',
+    'here',
+    'there',
+    'above',
+    'below',
+    // Weak file/asset labels
+    'asset',
+    'assets',
+    'file',
+    'attachment',
+    'upload',
+    'uploaded',
+]);
+// Set of multi-word phrases that by themselves, are too vague to be useful alt text
+const VAGUE_PHRASES = new Set([
+    'an image',
+    'an image of',
+    'a photo',
+    'a photo of',
+    'a picture',
+    'a picture of',
+    'an icon',
+    'an illustration',
+    'a graphic',
+    'a screenshot',
+    'image of',
+    'photo of',
+    'picture of',
+    'graphic of',
+    'screenshot of',
+    'image goes here',
+    'photo goes here',
+    'picture goes here',
+    'your image here',
+    'your photo here',
+    'insert image',
+    'insert photo',
+]);
+export const vagueAltText = {
+    id: 'vague-alt-text',
+    problemUrl: 'https://www.w3.org/WAI/WCAG21/Understanding/non-text-content.html',
+    evaluate(context) {
+        return (context.images
+            // Find images whose alt text is too vague.
+            .filter(img => {
+            if (img.alt === null || img.alt === '')
+                return false;
+            const normalizedAltText = normalizeAltText(img.alt);
+            return VAGUE_WORDS.has(normalizedAltText) || VAGUE_PHRASES.has(normalizedAltText);
+        })
+            // Report each one with offending alt text.
+            .map(image => ({
+            image,
+            problemShort: `Alt text is too vague to describe the image:\n"${image.alt}"`,
+            solutionShort: 'replace with descriptive alt text, or use `alt=""` if the image is decorative',
+        })));
+    },
+};
+//# sourceMappingURL=vague-alt-text.js.map

package/dist/src/rules/vague-alt-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vague-alt-text.js","sourceRoot":"","sources":["../../../src/rules/vague-alt-text.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAC,MAAM,gCAAgC,CAAA;AAE/D,uEAAuE;AACvE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,sBAAsB;IACtB,OAAO;IACP,QAAQ;IACR,KAAK;IACL,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,aAAa;IACb,SAAS;IACT,UAAU;IACV,KAAK;IACL,MAAM;IACN,SAAS;IACT,UAAU;IACV,QAAQ;IACR,SAAS;IACT,OAAO;IACP,SAAS;IACT,KAAK;IACL,MAAM;IAEN,yBAAyB;IACzB,MAAM;IACN,OAAO;IACP,cAAc;IACd,eAAe;IACf,QAAQ;IACR,SAAS;IACT,WAAW;IACX,YAAY;IACZ,MAAM;IACN,OAAO;IACP,QAAQ;IACR,SAAS;IAET,2BAA2B;IAC3B,KAAK;IACL,SAAS;IACT,SAAS;IACT,UAAU;IACV,SAAS;IACT,UAAU;IACV,OAAO;IACP,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,aAAa;IACb,QAAQ;IACR,SAAS;IACT,UAAU;IACV,WAAW;IACX,KAAK;IACL,MAAM;IAEN,eAAe;IACf,2EAA2E;IAC3E,QAAQ;IACR,SAAS;IACT,MAAM;IACN,MAAM;IACN,SAAS;IACT,UAAU;IACV,MAAM;IACN,WAAW;IACX,MAAM;IAEN,gCAAgC;IAChC,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IAEN,oBAAoB;IACpB,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IAEP,yBAAyB;IACzB,OAAO;IACP,QAAQ;IACR,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,UAAU;CACX,CAAC,CAAA;AAEF,oFAAoF;AACpF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,UAAU;IACV,aAAa;IACb,SAAS;IACT,YAAY;IACZ,WAAW;IACX,cAAc;IACd,SAAS;IACT,iBAAiB;IACjB,WAAW;IACX,cAAc;IACd,UAAU;IACV,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,iBAAiB;IACjB,iBAAiB;IACjB,cAAc;IACd,cAAc;CACf,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,EAAE,EAAE,gBAAgB;IACpB,UAAU,EAAE,mEAAmE;IAC/E,QAAQ,CAAC,OAAO;QACd,OAAO,CACL,OAAO,CAAC,MAAM;YAEZ,2CAA2C;aAC1C,MAAM,CAAC,GAAG,CAAC,EAAE;YACZ,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,GAAG,KAAK,EAAE;gBAAE,OAAO,KAAK,CAAA;YACpD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACnD,OAAO,WAAW,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;QACnF,CAAC,CAAC;YAEF,2CAA2C;aAC1C,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACb,KAAK;YACL,YAAY,EAAE,kDAAkD,KAAK,CAAC,GAAG,GAAG;YAC5E,aAAa,EAAE,+EAA+E;SAC/F,CAAC,CAAC,CACN,CAAA;IACH,CAAC;CACF,CAAA"}

package/dist/src/types.d.ts

@@ -0,0 +1,49 @@
+import type { Page } from 'playwright';
+export type Finding = {
+    scannerType: string;
+    ruleId?: string;
+    url: string;
+    html?: string;
+    problemShort: string;
+    problemUrl: string;
+    solutionShort: string;
+    solutionLong?: string;
+    screenshotId?: string;
+};
+export type PluginArgs = {
+    page: Page;
+    addFinding: (finding: Finding) => Promise<void>;
+};
+export type ImageRecord = {
+    src: string | null;
+    alt: string | null;
+    role: string | null;
+    ariaHidden: boolean;
+    ariaLabel: string | null;
+    ariaLabelledBy: string | null;
+    outerHTML: string;
+    boundingBox: BoundingBox | null;
+};
+export type BoundingBox = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type RuleContext = {
+    url: string;
+    images: ImageRecord[];
+};
+export type RuleResult = {
+    image: ImageRecord;
+    problemShort: string;
+    solutionShort: string;
+    solutionLong?: string;
+};
+export type Rule = {
+    id: string;
+    problemUrl: string;
+    defaultEnabled?: boolean;
+    evaluate(ctx: RuleContext): RuleResult[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,YAAY,CAAA;AAIpC,MAAM,MAAM,OAAO,GAAG;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAGD,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,IAAI,CAAA;IACV,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD,CAAA;AAGD,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;CAChC,CAAA;AAGD,MAAM,MAAM,WAAW,GAAG;IACxB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAGD,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,WAAW,EAAE,CAAA;CACtB,CAAA;AAGD,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,WAAW,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAGD,MAAM,MAAM,IAAI,GAAG;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAGlB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,UAAU,EAAE,CAAA;CACzC,CAAA"}

package/dist/src/types.js

@@ -0,0 +1,3 @@
+// Shared contract for the alt-text-scan plugin.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,gDAAgD"}

package/dist/src/utils/normalize-alt-text.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Normalizes alt text for comparison by trimming, lowercasing, collapsing internal
+ * whitespace, and stripping leading and trailing punctuation. Used by rules that
+ * need to compare alt text against a set.
+ */
+export declare function normalizeAltText(alt: string): string;
+//# sourceMappingURL=normalize-alt-text.d.ts.map

package/dist/src/utils/normalize-alt-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-alt-text.d.ts","sourceRoot":"","sources":["../../../src/utils/normalize-alt-text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQpD"}

package/dist/src/utils/normalize-alt-text.js

@@ -0,0 +1,15 @@
+/**
+ * Normalizes alt text for comparison by trimming, lowercasing, collapsing internal
+ * whitespace, and stripping leading and trailing punctuation. Used by rules that
+ * need to compare alt text against a set.
+ */
+export function normalizeAltText(alt) {
+    return alt
+        .trim()
+        .toLowerCase()
+        .replace(/\s+/g, ' ')
+        .replace(/^[.,!?;:()[\]{}'"“”‘’]+/, '')
+        .replace(/[.,!?;:()[\]{}'"“”‘’]+$/, '')
+        .trim();
+}
+//# sourceMappingURL=normalize-alt-text.js.map

package/dist/src/utils/normalize-alt-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-alt-text.js","sourceRoot":"","sources":["../../../src/utils/normalize-alt-text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG;SACP,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC;SACtC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC;SACtC,IAAI,EAAE,CAAA;AACX,CAAC"}

package/package.json

@@ -1,12 +1,51 @@
 {
   "name": "@github/accessibility-scanner-alt-text-plugin",
-  "version": "0.0.1",
-  "description": "Stub package for @github/accessibility-scanner-alt-text-plugin",
-  "keywords": [],
-  "author": "",
+  "version": "1.0.0",
+  "description": "Alt-text validation plugin for github/accessibility-scanner",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/github/accessibility-scanner-alt-text-plugin.git"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  },
+  "prettier": "@github/prettier-config",
+  "engines": {
+    "node": "^22.13.0 || ^24 || ^26"
+  },
+  "devDependencies": {
+    "@github/prettier-config": "^0.0.6",
+    "@types/node": "^26.1.0",
+    "eslint": "^10.6.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-check-file": "^3.3.1",
+    "playwright": "^1.61.1",
+    "prettier": "^3.9.4",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.62.1",
+    "vitest": "^4.1.9"
   }
 }