@verndale/accessibility-standards 1.0.0

package/OPERATING.md

@@ -0,0 +1,5 @@
+# Operating contract
+
+Source records under `src/` are normative. Patterns reference semantic IDs; they do not restate semantic rules. `dist/` and consumer projections are generated and are never edited manually.
+
+Changes must pass schema, dependency, applicability, projection, deterministic rendering, and wiki checks. A package upgrade is explicit; sync hooks only use the exact installed lockfile version and never contact a registry.

package/README.md

@@ -0,0 +1,22 @@
+# Accessibility Standards
+
+`@verndale/accessibility-standards` is Verndale's canonical, versioned authority for accessibility semantics, interaction patterns, applicability decisions, and evidence routing.
+
+The package projects the same source records into two purpose-specific profiles:
+
+- `conductor` — Functional Specification and Acceptance Criteria contracts.
+- `ai-orchestration` — implementation, testing, and review Build Pack contracts.
+
+Consumers pin an exact package version and commit a config, route map, and generated provenance. Generated outputs are deterministic and carry a do-not-edit marker plus source/config/route digests.
+
+## Commands
+
+```sh
+pnpm verify:ci
+pnpm build
+pnpm exec accessibility-standards sync --config accessibility-standards.config.json
+pnpm exec accessibility-standards sync --if-needed --config accessibility-standards.config.json
+pnpm exec accessibility-standards check --config accessibility-standards.config.json
+```
+
+See [authoring](docs/authoring.md), the [projection contract](docs/projection-contract.md), and [versioning](docs/versioning.md).

package/bin/accessibility-standards.mjs

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { buildDistribution } from '../lib/build.mjs';
+import { loadStandards } from '../lib/load.mjs';
+import { projection } from '../lib/sync.mjs';
+import { validateStandards } from '../lib/validate.mjs';
+
+const [command, ...args] = process.argv.slice(2);
+const flag = (name) => args.includes(name);
+const value = (name) => {
+  const index = args.indexOf(name);
+  return index >= 0 ? args[index + 1] : undefined;
+};
+
+try {
+  if (command === 'validate') {
+    const result = validateStandards(await loadStandards());
+    console.log(`PASS standards validation: ${result.semantics} semantics, ${result.patterns} patterns, ${result.applicability} applicability rows`);
+  } else if (command === 'build') {
+    const result = await buildDistribution();
+    console.log(`PASS distribution build: ${result.records} records, ${result.profiles} profiles`);
+  } else if (command === 'sync' || command === 'check') {
+    const configPath = value('--config');
+    if (!configPath) throw new Error(`${command} requires --config <path>`);
+    const result = await projection({ configPath, check: command === 'check', ifNeeded: flag('--if-needed') });
+    console.log(`PASS ${command}: ${result.files} outputs${result.changed ? ' updated' : ' current'}`);
+  } else {
+    throw new Error('Usage: accessibility-standards <build|validate|sync|check> [--if-needed] [--config path]');
+  }
+} catch (error) {
+  console.error(`FAIL ${command ?? 'command'}: ${error.message}`);
+  process.exitCode = 1;
+}

package/dist/manifest.json

@@ -0,0 +1,202 @@
+{
+  "package": "@verndale/accessibility-standards@1.0.0",
+  "schema_version": 1,
+  "records": [
+    {
+      "id": "foundation.conformance-boundary",
+      "digest": "ee9e98c41419692bb3ea850488c4432f4b11e7c21fc4eec1d971f84f1bdd7d38"
+    },
+    {
+      "id": "foundation.standards-hierarchy",
+      "digest": "d8321ed3672f9268a204c5f2acaf4af10a5a2a29f4ceca9bb87b89ad82d72db2"
+    },
+    {
+      "id": "foundation.wcag-2.2",
+      "digest": "fb9629434fd412f167b572cac52ece8bac12113108381c69b9351ebed29af4f8"
+    },
+    {
+      "id": "pattern.accordion",
+      "digest": "f723e05158f0cd7444ab64f30944ddb27eeeaf79b0cb98f559c080855991dddd"
+    },
+    {
+      "id": "pattern.alert",
+      "digest": "341ea6c32b412a435890c88db938aa1a74bbb5b5c1ef6c3ff56ce274c40896c9"
+    },
+    {
+      "id": "pattern.carousel",
+      "digest": "b3e227b40eaf9cac0c860723f9c6b0e82da91c0da4a66fdc027b4781c3246aed"
+    },
+    {
+      "id": "pattern.combobox",
+      "digest": "ef6509c2a34fb3f7acb0c6c286f00300c6712c10d363aa41864d6e430699c14c"
+    },
+    {
+      "id": "pattern.consequential-submission",
+      "digest": "b272f3689210fe291f04b2cd173a90284693191a2cb4425190a9f5f51d827bf9"
+    },
+    {
+      "id": "pattern.dialog",
+      "digest": "d15111ab6dcbca62fc48ca357cab29481f7bac387c36e23ecafdd3aef643bb55"
+    },
+    {
+      "id": "pattern.disclosure",
+      "digest": "2490e322684c827eafadb2de83aaf0a7a7834ca29c58ae321c3fdd9da7f8e6f0"
+    },
+    {
+      "id": "pattern.dynamic-status",
+      "digest": "1d5abfdd8e0ed4c33a4ac887185432a4606e57648e427c88d5dec49124a18b38"
+    },
+    {
+      "id": "pattern.field",
+      "digest": "b6af8f2eeba9c0c89031b498e2240054f346f3eb7b8ffb426027fc8a85d0fbde"
+    },
+    {
+      "id": "pattern.image",
+      "digest": "9681f6d1de7e1f5cf73894e060ba75c7c816b88cee1b67016868775f5a65ea92"
+    },
+    {
+      "id": "pattern.listbox",
+      "digest": "b1e02cd1282556d96b87ff3ff231f0476da76634d7de6d58e565e93f861d945c"
+    },
+    {
+      "id": "pattern.media-player",
+      "digest": "fbec9ca56d5122eae52a759ac23d7c67017b0cf9afdbb20c969e000701c376fc"
+    },
+    {
+      "id": "pattern.menu-button",
+      "digest": "30188cc0e698e37a7e091f5732461f5b9d770ca4b01b82f1c08909847b755f7b"
+    },
+    {
+      "id": "pattern.pagination",
+      "digest": "f2a170950724c9d61ad8d0d8cfd7e14d059d56bde491249242e44ebf2bf7cd7b"
+    },
+    {
+      "id": "pattern.popover",
+      "digest": "c7cb16b9aef61a6f9f70ad3435fd1b48a3b7720a8dcb7da93962d9413a4c90ea"
+    },
+    {
+      "id": "pattern.progress",
+      "digest": "4cb24645c360456652731d5ebb0035336128ffdc50dc735d7855d4bb4e09299a"
+    },
+    {
+      "id": "pattern.tabs",
+      "digest": "817ed1bc20ca4f1051b34d0bedcdf2e2a1e670820a8c5f762b626552623dad31"
+    },
+    {
+      "id": "pattern.tooltip",
+      "digest": "4000f4d9ec2cc0218062d4ce5892c167ce98cee2636c1e27550d0f1d691fd1cf"
+    },
+    {
+      "id": "pattern.validation",
+      "digest": "e947031b4d62dc097d7674d372d726d84220afb23d6889a55c3434ef7b592ecf"
+    },
+    {
+      "id": "policy.enhanced-quality",
+      "digest": "7e1c8c320ebdc36922964271d53cf48900e025489fda90b11c894036974727f9"
+    },
+    {
+      "id": "policy.target-size",
+      "digest": "52344723debd55678352eede8704327199e109835ffac8c1a360ffc3da669cc4"
+    },
+    {
+      "id": "semantics.accessible-name",
+      "digest": "72bbac127f708e788b2d1f48d9940d223a4421e2df596c485b233195a5f8e763"
+    },
+    {
+      "id": "semantics.alert",
+      "digest": "8dc09b4717dc44f725f604d466fe28da047bdd0a2a5b13348880424c54ab8f64"
+    },
+    {
+      "id": "semantics.consequential-action",
+      "digest": "012b797e483164adf03a2c9c8bc2ca0311c7ee3600714e0c32606eaad9382d86"
+    },
+    {
+      "id": "semantics.data-table",
+      "digest": "acc77013a69ae21aeab8853a9519da2ea6d76cf0659df77039fcfde55551880c"
+    },
+    {
+      "id": "semantics.expanded-state",
+      "digest": "8e06334efb2fc48bf3f07f44c8971d1b66290de89280d38328f6cbd81ae66e39"
+    },
+    {
+      "id": "semantics.focus.initial",
+      "digest": "b03db3ffdd13676c5875c3f9c6ffa1ad83be6bfd1af0b95bf24323b6560757c2"
+    },
+    {
+      "id": "semantics.focus.return",
+      "digest": "0651a18b711a52f775bd0ea5fec9332a42c9d84de2db7a897f84aebdd2b0af21"
+    },
+    {
+      "id": "semantics.focus.visible",
+      "digest": "4290cce3da8ab2e19187486296b2bd5c8812c5f85c8368b8c77459273864f52c"
+    },
+    {
+      "id": "semantics.form-error",
+      "digest": "0644be9b1fa04cd3da2691e71552b69ee53f0e1bdc949e1324a9e2eafcb21536"
+    },
+    {
+      "id": "semantics.form-label",
+      "digest": "5e0db51ea318aa15ebb20403a5a9a2e0e1930672cf94d776e547881b0bce8613"
+    },
+    {
+      "id": "semantics.form-required",
+      "digest": "99a811afdcf07724df641d60fbdc8debcf86f79b3deab92450e9dc1da06b3ae4"
+    },
+    {
+      "id": "semantics.headings",
+      "digest": "5e3744acdc7eb70d907e61441155f6e6141c99f360fa2edfec5048be5465bbad"
+    },
+    {
+      "id": "semantics.keyboard",
+      "digest": "ea339526abc5cae463ff56fcc302b131e621d1a81e8d67987b4fd95f2baef5a9"
+    },
+    {
+      "id": "semantics.keyboard.escape",
+      "digest": "49660048cd503c0800b731c93f4183c9d2b6600f417b723cf6b2fef851dfa04b"
+    },
+    {
+      "id": "semantics.landmarks",
+      "digest": "3c458e43d33148f3bc751122260478a8a6baadfd0a66d473653c118c590d596d"
+    },
+    {
+      "id": "semantics.live-status",
+      "digest": "38a8fd097aab3934acb70debd0db9590575eef1c9d6bd57aa737e0dd5022732d"
+    },
+    {
+      "id": "semantics.media-alternatives",
+      "digest": "c130ee8609807d7ae423596d425467be867567f45b270ae6a80aec4b5ae89fd8"
+    },
+    {
+      "id": "semantics.motion-control",
+      "digest": "3db27053a0240652d2d9e38d3d4639f92bac0d19788bfc77573e81c64f05e7e3"
+    },
+    {
+      "id": "semantics.name-role-value",
+      "digest": "aea65aeace7ee47e6ce447b5faac14a4fb62600fbe518eec4c4a6c2241f23b08"
+    },
+    {
+      "id": "semantics.native-dialog",
+      "digest": "aae312f7e9c72002a332184198836e445605b33a49ab19f20376cef95e39e043"
+    },
+    {
+      "id": "semantics.native-elements",
+      "digest": "9df6e8dbe7b34010d7ebc7615b2c40d5fa990c5c550be865138b680659604852"
+    },
+    {
+      "id": "semantics.non-text-alternative",
+      "digest": "eb46b0837130acd1a34e80ace5f2e8c90b11f5a6aead6cc17921d0e9c2c42a3a"
+    },
+    {
+      "id": "semantics.roles-states-properties",
+      "digest": "2f43c3cee11445abe5e783afb3a13ab32dd70b73371146f3b71b8b6511c7e6fc"
+    },
+    {
+      "id": "semantics.selected-state",
+      "digest": "43df69e9cfea1b9fa6fdb8fb672911e28e871d3072d31ff2291281a92d24c1db"
+    },
+    {
+      "id": "semantics.target-size",
+      "digest": "4fe5e9fde8e0276d252ab9b4381bfaaa1d4b899d0385a5c68ed049877636909d"
+    }
+  ]
+}

package/dist/profiles/ai-orchestration/coverage-manifest.json

@@ -0,0 +1,202 @@
+{
+  "_generated": "GENERATED by @verndale/accessibility-standards; DO NOT EDIT",
+  "schema_version": 1,
+  "projected_ids": [
+    "applicability.authentication-captcha",
+    "applicability.character-shortcuts",
+    "applicability.complex-pointer",
+    "applicability.consequential-submission",
+    "applicability.consistent-help",
+    "applicability.data-table-grid",
+    "applicability.dynamic-status",
+    "applicability.focus-obstruction",
+    "applicability.forms",
+    "applicability.locale-bidi",
+    "applicability.media",
+    "applicability.motion-timing",
+    "applicability.non-text-content",
+    "applicability.orientation-sensory",
+    "applicability.overlays",
+    "applicability.page-context",
+    "applicability.redundant-entry",
+    "applicability.target-size",
+    "pattern.accordion",
+    "pattern.alert",
+    "pattern.carousel",
+    "pattern.combobox",
+    "pattern.consequential-submission",
+    "pattern.dialog",
+    "pattern.disclosure",
+    "pattern.dynamic-status",
+    "pattern.field",
+    "pattern.image",
+    "pattern.listbox",
+    "pattern.media-player",
+    "pattern.menu-button",
+    "pattern.pagination",
+    "pattern.popover",
+    "pattern.progress",
+    "pattern.tabs",
+    "pattern.tooltip",
+    "pattern.validation",
+    "semantics.accessible-name",
+    "semantics.alert",
+    "semantics.consequential-action",
+    "semantics.data-table",
+    "semantics.expanded-state",
+    "semantics.focus.initial",
+    "semantics.focus.return",
+    "semantics.focus.visible",
+    "semantics.form-error",
+    "semantics.form-label",
+    "semantics.form-required",
+    "semantics.headings",
+    "semantics.keyboard",
+    "semantics.keyboard.escape",
+    "semantics.landmarks",
+    "semantics.live-status",
+    "semantics.media-alternatives",
+    "semantics.motion-control",
+    "semantics.name-role-value",
+    "semantics.native-dialog",
+    "semantics.native-elements",
+    "semantics.non-text-alternative",
+    "semantics.roles-states-properties",
+    "semantics.selected-state",
+    "semantics.target-size"
+  ],
+  "lane_coverage": {
+    "axe": [
+      "pattern.accordion",
+      "pattern.carousel",
+      "pattern.combobox",
+      "pattern.dialog",
+      "pattern.disclosure",
+      "pattern.field",
+      "pattern.image",
+      "pattern.listbox",
+      "pattern.media-player",
+      "pattern.pagination",
+      "pattern.progress",
+      "pattern.tabs",
+      "pattern.validation",
+      "semantics.accessible-name",
+      "semantics.data-table",
+      "semantics.expanded-state",
+      "semantics.form-error",
+      "semantics.form-label",
+      "semantics.form-required",
+      "semantics.headings",
+      "semantics.landmarks",
+      "semantics.name-role-value",
+      "semantics.native-dialog",
+      "semantics.native-elements",
+      "semantics.non-text-alternative",
+      "semantics.roles-states-properties"
+    ],
+    "e2e": [
+      "pattern.accordion",
+      "pattern.carousel",
+      "pattern.combobox",
+      "pattern.consequential-submission",
+      "pattern.dialog",
+      "pattern.disclosure",
+      "pattern.dynamic-status",
+      "pattern.field",
+      "pattern.listbox",
+      "pattern.media-player",
+      "pattern.menu-button",
+      "pattern.popover",
+      "pattern.tabs",
+      "pattern.tooltip",
+      "pattern.validation",
+      "semantics.consequential-action",
+      "semantics.data-table",
+      "semantics.expanded-state",
+      "semantics.focus.initial",
+      "semantics.focus.return",
+      "semantics.focus.visible",
+      "semantics.form-error",
+      "semantics.form-label",
+      "semantics.keyboard",
+      "semantics.keyboard.escape",
+      "semantics.live-status",
+      "semantics.motion-control",
+      "semantics.native-dialog",
+      "semantics.roles-states-properties",
+      "semantics.selected-state",
+      "semantics.target-size"
+    ],
+    "human": [
+      "pattern.accordion",
+      "pattern.alert",
+      "pattern.carousel",
+      "pattern.combobox",
+      "pattern.consequential-submission",
+      "pattern.dialog",
+      "pattern.dynamic-status",
+      "pattern.field",
+      "pattern.image",
+      "pattern.listbox",
+      "pattern.media-player",
+      "pattern.menu-button",
+      "pattern.pagination",
+      "pattern.popover",
+      "pattern.progress",
+      "pattern.tabs",
+      "pattern.tooltip",
+      "pattern.validation",
+      "semantics.accessible-name",
+      "semantics.alert",
+      "semantics.consequential-action",
+      "semantics.data-table",
+      "semantics.focus.visible",
+      "semantics.form-error",
+      "semantics.form-label",
+      "semantics.headings",
+      "semantics.keyboard",
+      "semantics.landmarks",
+      "semantics.live-status",
+      "semantics.media-alternatives",
+      "semantics.motion-control",
+      "semantics.name-role-value",
+      "semantics.native-dialog",
+      "semantics.native-elements",
+      "semantics.non-text-alternative",
+      "semantics.target-size"
+    ],
+    "unit": [
+      "pattern.accordion",
+      "pattern.alert",
+      "pattern.carousel",
+      "pattern.combobox",
+      "pattern.dialog",
+      "pattern.disclosure",
+      "pattern.dynamic-status",
+      "pattern.field",
+      "pattern.listbox",
+      "pattern.menu-button",
+      "pattern.pagination",
+      "pattern.popover",
+      "pattern.progress",
+      "pattern.tabs",
+      "pattern.tooltip",
+      "pattern.validation",
+      "semantics.accessible-name",
+      "semantics.alert",
+      "semantics.expanded-state",
+      "semantics.focus.initial",
+      "semantics.focus.return",
+      "semantics.form-error",
+      "semantics.form-label",
+      "semantics.form-required",
+      "semantics.keyboard",
+      "semantics.keyboard.escape",
+      "semantics.live-status",
+      "semantics.name-role-value",
+      "semantics.native-elements",
+      "semantics.roles-states-properties",
+      "semantics.selected-state"
+    ]
+  }
+}