@ecoma-io/loom 0.5.0 → 0.6.0

package/dist/composition/split/src/Split.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Split.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../../packages/composition/split/src/Split.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * Split — two-panel layout with intrinsic collapse.\n *\n * A flex row that places a side panel and a content area side by side, and\n * stacks them vertically once the container is too narrow for both. The side\n * panel gets a fixed minimum width; the content area grows to fill the\n * remaining space.\n *\n * This is the Every Layout \"Sidebar\" pattern, simplified for the common\n * two-panel case. The intrinsic collapse — panels stack when the container is\n * too narrow — avoids a breakpoint per viewport, and works identically inside\n * a sidebar-narrowed workspace and full-bleed on an ultra-wide monitor.\n *\n * A Split is a component, not a hand-rolled flex row with a media query,\n * because the wrap-and-floor technique is non-obvious and easy to get wrong,\n * and the stacking order (side above or below) is an intent the `side` prop\n * expresses.\n */\nexport type SplitSide = \"left\" | \"right\";\n\nexport type SplitGap = \"sm\" | \"md\" | \"lg\" | \"none\";\n\nconst gapClass: Record<Exclude<SplitGap, \"none\">, string> = {\n  sm: \"gap-2 sm:gap-3\",\n  md: \"gap-3 sm:gap-4\",\n  lg: \"gap-4 sm:gap-6\",\n} as const;\n\nexport { gapClass };\n</script>\n\n<script setup lang=\"ts\">\nimport { cn } from \"@ecoma-io/loom-core\";\n\nwithDefaults(\n  defineProps<{\n    /** The side the panel sits on. Controls stacking order when collapsed: \"left\" stacks the panel above, \"right\" stacks it below. */\n    side?: SplitSide;\n    /** Minimum width for the side panel (e.g. \"16rem\"). The content area takes the rest. */\n    minSideWidth?: string;\n    /** Gap between the two panels. Tightens one notch below `sm` (except \"none\"). */\n    gap?: SplitGap;\n  }>(),\n  { side: \"left\", minSideWidth: \"16rem\", gap: \"md\" },\n);\n</script>\n\n<template>\n  <!--\n    `flex-wrap` is the intrinsic collapse mechanism: when the combined\n    `min-width` of both panels exceeds the container, the second panel wraps\n    to a new line. Where that happens is decided by the panels' own minimum\n    widths — there is no breakpoint prop to set it with.\n  -->\n  <div\n    :class=\"cn('flex flex-row', gap !== 'none' ? gapClass[gap] : undefined)\"\n    :style=\"{\n      flexWrap: 'wrap',\n    }\"\n  >\n    <!--\n      Document order follows `side`, so the wrapped stack never contradicts\n      the side-by-side row and screen-reader order matches the visual one:\n      content first when `side=\"right\"`, side first when `side=\"left\"`.\n      flex-row (never reverse) plus this ordering is what makes the wrap\n      produce content-above-panel for `side=\"right\"`.\n    -->\n    <template v-if=\"side === 'right'\">\n      <!-- Content area: fills remaining space, but demands at least 50% of\n           the container before wrapping. Wrapped onto a line of its own it\n           takes that whole line: flex-basis 0 starts from nothing and\n           flex-grow 999 absorbs every free pixel on the line. -->\n      <div\n        :style=\"{\n          flexBasis: 0,\n          flexGrow: 999,\n          flexShrink: 1,\n          minWidth: '50%',\n        }\"\n      >\n        <slot />\n      </div>\n      <!-- Side panel: fixed minimum width, does not grow. Wrapped onto a\n           line of its own it keeps exactly that declared width — flex-grow 0\n           with an explicit basis never widens, so the full-line stretch is\n           the content side's alone. -->\n      <div\n        :style=\"{\n          flexBasis: minSideWidth,\n          flexGrow: 0,\n          flexShrink: 0,\n          minWidth: minSideWidth,\n        }\"\n      >\n        <slot name=\"side\" />\n      </div>\n    </template>\n    <template v-else>\n      <!-- Side panel: fixed minimum width, does not grow. Wrapped onto a\n           line of its own it keeps exactly that declared width — flex-grow 0\n           with an explicit basis never widens, so the full-line stretch is\n           the content side's alone. -->\n      <div\n        :style=\"{\n          flexBasis: minSideWidth,\n          flexGrow: 0,\n          flexShrink: 0,\n          minWidth: minSideWidth,\n        }\"\n      >\n        <slot name=\"side\" />\n      </div>\n      <!-- Content area: fills remaining space, but demands at least 50% of\n           the container before wrapping. Wrapped onto a line of its own it\n           takes that whole line: flex-basis 0 starts from nothing and\n           flex-grow 999 absorbs every free pixel on the line. -->\n      <div\n        :style=\"{\n          flexBasis: 0,\n          flexGrow: 999,\n          flexShrink: 1,\n          minWidth: '50%',\n        }\"\n      >\n        <slot />\n      </div>\n    </template>\n  </div>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;AAuBA,IAAM,WAAsD;CAC1D,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;;;;;;;;;;GA4BE,OAAA,UAAA,GAAA,mBAyEM,OAAA;IAxEH,OAAK,eAAE,MAAA,EAAA,CAAE,CAAA,iBAAkB,QAAA,QAAG,SAAc,SAAS,QAAA,OAAO,KAAA,CAAS,CAAA;IACrE,OAAO,EAAA,UAAA,OAEP;GASe,GAAA,CAAA,QAAA,SAAI,WAApB,UAAA,GAAA,mBA6BW,UAAA,EAAA,KAAA,EAAA,GAAA,CAxBT,mBASM,OATN,YASM,CADJ,WAAQ,KAAA,QAAA,SAAA,CAAA,CAAA,GAMV,mBASM,OAAA,EARH,OAAK,eAAA;IAAyB,WAAA,QAAA;;;IAAkF,UAAA,QAAA;GAOjH,CAAA,EAAA,GAAA,CAAA,WAAoB,KAAA,QAAA,MAAA,CAAA,GAAA,CAAA,CAAA,GAAA,EAAA,MAGxB,UAAA,GAAA,mBA6BW,UAAA,EAAA,KAAA,EAAA,GAAA,CAxBT,mBASM,OAAA,EARH,OAAK,eAAA;IAAyB,WAAA,QAAA;;;IAAkF,UAAA,QAAA;GAOjH,CAAA,EAAA,GAAA,CAAA,WAAoB,KAAA,QAAA,MAAA,CAAA,GAAA,CAAA,GAMtB,mBASM,OATN,YASM,CADJ,WAAQ,KAAA,QAAA,SAAA,CAAA,CAAA,CAAA,GAAA,EAAA,EAAA,GAAA,CAAA"}

package/dist/composition/stack/src/Stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stack.js","names":[],"sources":["../../../../packages/composition/stack/src/Stack.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * Stack — vertical flow with consistent, responsive gap.\n *\n * A flex column that tightens its gutter one step below the `sm` breakpoint,\n * where stacked items have no room to waste on air. The gap steps mirror\n * DashboardGrid's: the value each step names applies from `sm` up, and drops\n * one notch below it.\n *\n * A Stack is a component, not `flex flex-col gap-4`, for three reasons: the\n * responsive gap is the component's job (not every call site's), the\n * `separator` slot avoids a repeated `v-for` + `v-if` pattern, and the\n * `align` prop maps cross-axis intent to a Tailwind class without the caller\n * remembering which flex utility is which.\n */\nexport type StackGap = \"sm\" | \"md\" | \"lg\";\n\nexport type StackAlign = \"start\" | \"center\" | \"end\" | \"stretch\";\n\nconst gapClass: Record<StackGap, string> = {\n  sm: \"gap-2 sm:gap-3\",\n  md: \"gap-3 sm:gap-4\",\n  lg: \"gap-4 sm:gap-6\",\n} as const;\n\nconst alignClass: Record<StackAlign, string> = {\n  start: \"items-start\",\n  center: \"items-center\",\n  end: \"items-end\",\n  stretch: \"items-stretch\",\n} as const;\n\nexport { gapClass, alignClass };\n</script>\n\n<script setup lang=\"ts\">\nimport { cn } from \"@ecoma-io/loom-core\";\n\nwithDefaults(\n  defineProps<{\n    /** Vertical gap step — mirrors DashboardGrid's scale. Tightens one notch below `sm`. */\n    gap?: StackGap;\n    /** Cross-axis alignment of children. */\n    align?: StackAlign;\n  }>(),\n  { gap: \"md\", align: \"stretch\" },\n);\n</script>\n\n<template>\n  <div :class=\"cn('flex flex-col', gapClass[gap], alignClass[align])\">\n    <!-- Each direct child is a stack item. The separator slot, if filled,\n         is rendered between every pair of children — a <Separator /> or a\n         thin <div class=\"border-t border-border\">, for example. -->\n    <slot />\n  </div>\n</template>\n"],"mappings":""}

package/dist/composition/stack/src/Stack.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stack.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../../packages/composition/stack/src/Stack.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * Stack — vertical flow with consistent, responsive gap.\n *\n * A flex column that tightens its gutter one step below the `sm` breakpoint,\n * where stacked items have no room to waste on air. The gap steps mirror\n * DashboardGrid's: the value each step names applies from `sm` up, and drops\n * one notch below it.\n *\n * A Stack is a component, not `flex flex-col gap-4`, for three reasons: the\n * responsive gap is the component's job (not every call site's), the\n * `separator` slot avoids a repeated `v-for` + `v-if` pattern, and the\n * `align` prop maps cross-axis intent to a Tailwind class without the caller\n * remembering which flex utility is which.\n */\nexport type StackGap = \"sm\" | \"md\" | \"lg\";\n\nexport type StackAlign = \"start\" | \"center\" | \"end\" | \"stretch\";\n\nconst gapClass: Record<StackGap, string> = {\n  sm: \"gap-2 sm:gap-3\",\n  md: \"gap-3 sm:gap-4\",\n  lg: \"gap-4 sm:gap-6\",\n} as const;\n\nconst alignClass: Record<StackAlign, string> = {\n  start: \"items-start\",\n  center: \"items-center\",\n  end: \"items-end\",\n  stretch: \"items-stretch\",\n} as const;\n\nexport { gapClass, alignClass };\n</script>\n\n<script setup lang=\"ts\">\nimport { cn } from \"@ecoma-io/loom-core\";\n\nwithDefaults(\n  defineProps<{\n    /** Vertical gap step — mirrors DashboardGrid's scale. Tightens one notch below `sm`. */\n    gap?: StackGap;\n    /** Cross-axis alignment of children. */\n    align?: StackAlign;\n  }>(),\n  { gap: \"md\", align: \"stretch\" },\n);\n</script>\n\n<template>\n  <div :class=\"cn('flex flex-col', gapClass[gap], alignClass[align])\">\n    <!-- Each direct child is a stack item. The separator slot, if filled,\n         is rendered between every pair of children — a <Separator /> or a\n         thin <div class=\"border-t border-border\">, for example. -->\n    <slot />\n  </div>\n</template>\n"],"mappings":";;;;AAmBA,IAAM,WAAqC;CACzC,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;AAEA,IAAM,aAAyC;CAC7C,OAAO;CACP,QAAQ;CACR,KAAK;CACL,SAAS;AACX;;;;;;;;;GAoBE,OAAA,UAAA,GAAA,mBAKM,OAAA,EALA,OAAK,eAAE,MAAA,EAAA,CAAE,CAAA,iBAAkB,SAAS,QAAA,MAAM,WAAW,QAAA,MAAK,CAAA,EAAA,GAAA,CAI9D,WAAQ,KAAA,QAAA,SAAA,CAAA,GAAA,CAAA"}

package/dist/core/src/a11y-contract.js

@@ -0,0 +1,558 @@
+//#region packages/core/src/a11y-contract.ts
+/**
+* The role-aware accessibility evidence contract: what a component OWES, not
+* what the library asserts.
+*
+* `a11y-scope.ts` partitions the 70 WCAG-tagged rules into the tiers that can
+* judge them. That partition is library-wide — it says nothing about any one
+* component, and a purely visual span ends up with exactly the evidence
+* obligation of a focusable, labelled control. This file is the per-component
+* half: a closed role vocabulary, the evidence tiers a role must answer, and
+* the matrix binding each role to the requirements its claim has to satisfy.
+*
+* Three readers, one source:
+*
+* - `tools/check-a11y-evidence.ts` and `tools/check-interaction-evidence.ts`,
+*   the gates for the two axes, read this file AS DATA — parsed, never
+*   imported. The tooling layer's boundary row (layer-tooling) forbids
+*   importing the library it checks, and a checker that executed its subject
+*   could not report on a tree that will not load. Each parse is fail-closed:
+*   a contract a gate cannot read is a lint failure, not an empty verdict.
+* - `packages/loom/src/a11y.ts` re-exports the role vocabulary and the type,
+*   so a consumer or a docs page reads the same law the gate enforces. The
+*   interaction vocabulary is not re-exported from the public surface yet —
+*   its readers today are the gate, the pin test and the docs build, and an
+*   export nobody consumes is a public promise with no reader.
+* - `packages/core/tests/a11y-contract.test.ts` pins the law's internal
+*   consistency on both axes: no matrix row for a role or class outside its
+*   vocabulary, no requirement id without a definition, no requirement in an
+*   unknown tier.
+*
+* The component's own declaration lives beside it, in
+* `packages/<tier>/<name>/a11y.json` — one sidecar per component, the sixth
+* artifact `tools/check-a11y-evidence.ts` asserts. THE CLAIM IS DECLARED, NOT
+* DERIVED: Reka injects ARIA roles at runtime, so no reader can derive a
+* component's role from its source with confidence. The sidecar declares it,
+* cites the rendered evidence for the claim (`basis`), declares the evidence
+* files that exist today, and records an `exceptions` entry — requirement id
+* plus reason — for every matrix requirement nothing answers yet. The gate
+* counts and names those exceptions instead of failing the repository, so the
+* contract lands truthfully and the exception list shrinks as evidence grows.
+*
+* The sidecar now carries a SECOND axis beside the role claim: the
+* interaction class. Phase 3D reserved room here for exactly this — the same
+* sidecar, a second axis, not a second file — which is why `role` was held
+* orthogonal to evidence and exceptions rather than folded into them. The
+* interaction half is defined at the bottom of this file, and
+* `tools/check-interaction-evidence.ts` is its validator.
+*
+* Every collection below is a flat `as const` array of records — the shape the
+* gates' parsers and the pin test all rely on. Keep new fields string- or
+* array-valued and entry objects brace-free.
+*/
+/**
+* The three evidence tiers, using `a11y-scope.ts`'s own vocabulary for the
+* same three runtimes: the browserless jsdom demo sweep, the component
+* harness's browser specs, and the root sweep over the built site.
+*/
+var A11Y_EVIDENCE_TIERS = [
+	"browserless",
+	"harness",
+	"sweep"
+];
+/**
+* The closed ARIA role vocabulary a component may claim. Every member is a
+* real ARIA role — the one whose AT contract the component's own markup
+* asserts, native or injected: a native `<button>`, Reka's `role="dialog"`
+* content, an explicit `role="list"` wrapper. Composite widgets claim the
+* container role (tabs → tablist, select → combobox, tree-view → tree); the
+* `basis` field of each sidecar names the parts that make the claim true.
+*/
+var ARIA_ROLES = [
+	"alert",
+	"alertdialog",
+	"button",
+	"checkbox",
+	"combobox",
+	"dialog",
+	"grid",
+	"group",
+	"img",
+	"link",
+	"list",
+	"menu",
+	"menubar",
+	"meter",
+	"navigation",
+	"progressbar",
+	"radiogroup",
+	"region",
+	"searchbox",
+	"separator",
+	"slider",
+	"spinbutton",
+	"status",
+	"switch",
+	"tablist",
+	"table",
+	"textbox",
+	"toolbar",
+	"tooltip",
+	"tree"
+];
+/**
+* The two non-role members. `none` — the component asserts no ARIA role of
+* its own: its semantics are native landmarks, flow content or slotted
+* children. `visual-only` — presentational by design, removed from the
+* accessibility tree or carrying nothing a reader should hear; its only
+* obligation is to not assert broken ARIA while hiding.
+*/
+var NON_ROLE_MEMBERS = ["none", "visual-only"];
+/** The role vocabulary the sidecar's `role` field is held to. */
+var A11Y_ROLES = [...ARIA_ROLES, ...NON_ROLE_MEMBERS];
+/**
+* The evidence requirements — one row per family of WCAG-tagged rules, named
+* for the obligation rather than the implementation so the matrix reads as
+* law. `tier` is where the claim must be ANSWERED; `answers` names the axe
+* rules of `a11y-scope.ts` the family covers, or the bespoke suite where axe
+* ships no rule for the criterion (2.4.11 has none, which is why
+* `e2e/focus-not-obscured.e2e.ts` exists at all).
+*
+* The families deliberately do not cover the whole partition — 27 of the 68
+* runtime-tier rules are named by no family, and the absence is recorded
+* rather than hidden, the way TAGGED_BUT_DISABLED_RULES records its own two:
+*
+* - host-document facts a consumer's page answers, not a component:
+*   `aria-hidden-body`, `bypass`, `document-title`, `html-has-lang`,
+*   `html-lang-valid`, `html-xml-lang-mismatch`, `meta-refresh`,
+*   `meta-viewport`, `valid-lang`;
+* - elements no Loom component ships: `blink`, `frame-focusable-content`,
+*   `frame-title`, `frame-title-unique`, `input-button-name`, `marquee`,
+*   `no-autoplay-audio`, `object-alt`, `server-side-image-map`,
+*   `summary-name`, `video-caption`;
+* - attributes whose truth belongs to the host, not the component:
+*   `aria-braille-equivalent` (no Loom component emits a braille equivalent
+*   today) and `autocomplete-valid` (the token is forwarded unchanged by
+*   combobox, editable, tags-input, text-field and command — the rule judges
+*   whether the host chose the right token for its field, which no component
+*   can answer for);
+* - consumer styling, not component markup: `avoid-inline-spacing`;
+* - conservative-partial table geometry, run by the sweep site-wide but owed
+*   by no role's row per-component: `table-fake-caption`, `td-has-header`,
+*   `td-headers-attr`, `th-has-data-cells`.
+*
+* The sweep runs all 68 site-wide regardless, so an uncovered rule is still
+* exercised on every page — what no role owes is per-component accountability.
+* The coverage set is pinned by packages/core/tests/a11y-contract.test.ts: a
+* rule that moves into or out of a family must edit that pin and this list
+* together.
+*/
+var A11Y_EVIDENCE_REQUIREMENTS = [
+	{
+		id: "semantic-aria",
+		tier: "browserless",
+		answers: [
+			"aria-roles",
+			"aria-required-attr",
+			"aria-valid-attr",
+			"aria-valid-attr-value",
+			"aria-allowed-attr",
+			"aria-conditional-attr",
+			"aria-prohibited-attr",
+			"aria-deprecated-role",
+			"aria-roledescription",
+			"aria-required-children",
+			"aria-required-parent",
+			"duplicate-id-aria",
+			"nested-interactive"
+		]
+	},
+	{
+		id: "name",
+		tier: "browserless",
+		answers: [
+			"button-name",
+			"link-name",
+			"label",
+			"form-field-multiple-labels",
+			"aria-input-field-name",
+			"aria-command-name",
+			"aria-toggle-field-name",
+			"aria-meter-name",
+			"aria-progressbar-name",
+			"aria-tab-name",
+			"aria-tooltip-name",
+			"select-name",
+			"image-alt",
+			"svg-img-alt",
+			"role-img-alt",
+			"input-image-alt",
+			"area-alt"
+		]
+	},
+	{
+		id: "structure",
+		tier: "browserless",
+		answers: [
+			"list",
+			"listitem",
+			"definition-list",
+			"dlitem"
+		]
+	},
+	{
+		id: "keyboard",
+		tier: "harness",
+		answers: ["aria-hidden-focus", "scrollable-region-focusable"]
+	},
+	{
+		id: "contrast",
+		tier: "sweep",
+		answers: [
+			"color-contrast",
+			"link-in-text-block",
+			"p-as-heading",
+			"label-content-name-mismatch"
+		]
+	},
+	{
+		id: "target-size",
+		tier: "sweep",
+		answers: ["target-size"]
+	},
+	{
+		id: "focus-not-obscured",
+		tier: "sweep",
+		answers: ["e2e/focus-not-obscured.e2e.ts (WCAG 2.4.11 — axe-core ships no rule for it)"]
+	}
+];
+/**
+* The matrix: the role's row is the claim it must satisfy. Shared shapes are
+* spelled out once per role rather than DRYed into inheritance — the matrix is
+* law, and a law a reader cannot read whole is a law a reader cannot argue
+* with. `semantic-aria` is the universal floor: every role owes it, including
+* visual-only, because an aria-hidden skeleton asserting a broken role is
+* still a defect.
+*/
+var A11Y_EVIDENCE_MATRIX = [
+	{
+		role: "visual-only",
+		requirements: ["semantic-aria"]
+	},
+	{
+		role: "none",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast"
+		]
+	},
+	{
+		role: "img",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast"
+		]
+	},
+	{
+		role: "separator",
+		requirements: ["semantic-aria", "contrast"]
+	},
+	{
+		role: "alert",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast"
+		]
+	},
+	{
+		role: "status",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast"
+		]
+	},
+	{
+		role: "meter",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast"
+		]
+	},
+	{
+		role: "progressbar",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast"
+		]
+	},
+	{
+		role: "tooltip",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast"
+		]
+	},
+	{
+		role: "list",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"structure",
+			"contrast"
+		]
+	},
+	{
+		role: "tree",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"structure",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "table",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"structure",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "grid",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"structure",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "region",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "navigation",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "button",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "link",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "checkbox",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "switch",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "radiogroup",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "slider",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "spinbutton",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "textbox",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "combobox",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "searchbox",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "menu",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "menubar",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "toolbar",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "tablist",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "dialog",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "alertdialog",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	},
+	{
+		role: "group",
+		requirements: [
+			"semantic-aria",
+			"name",
+			"contrast",
+			"keyboard",
+			"target-size",
+			"focus-not-obscured"
+		]
+	}
+];
+//#endregion
+export { A11Y_EVIDENCE_MATRIX, A11Y_EVIDENCE_REQUIREMENTS, A11Y_EVIDENCE_TIERS, A11Y_ROLES, ARIA_ROLES, NON_ROLE_MEMBERS };
+
+//# sourceMappingURL=a11y-contract.js.map

package/dist/core/src/a11y-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-contract.js","names":[],"sources":["../../../packages/core/src/a11y-contract.ts"],"sourcesContent":["/**\n * The role-aware accessibility evidence contract: what a component OWES, not\n * what the library asserts.\n *\n * `a11y-scope.ts` partitions the 70 WCAG-tagged rules into the tiers that can\n * judge them. That partition is library-wide — it says nothing about any one\n * component, and a purely visual span ends up with exactly the evidence\n * obligation of a focusable, labelled control. This file is the per-component\n * half: a closed role vocabulary, the evidence tiers a role must answer, and\n * the matrix binding each role to the requirements its claim has to satisfy.\n *\n * Three readers, one source:\n *\n * - `tools/check-a11y-evidence.ts` and `tools/check-interaction-evidence.ts`,\n *   the gates for the two axes, read this file AS DATA — parsed, never\n *   imported. The tooling layer's boundary row (layer-tooling) forbids\n *   importing the library it checks, and a checker that executed its subject\n *   could not report on a tree that will not load. Each parse is fail-closed:\n *   a contract a gate cannot read is a lint failure, not an empty verdict.\n * - `packages/loom/src/a11y.ts` re-exports the role vocabulary and the type,\n *   so a consumer or a docs page reads the same law the gate enforces. The\n *   interaction vocabulary is not re-exported from the public surface yet —\n *   its readers today are the gate, the pin test and the docs build, and an\n *   export nobody consumes is a public promise with no reader.\n * - `packages/core/tests/a11y-contract.test.ts` pins the law's internal\n *   consistency on both axes: no matrix row for a role or class outside its\n *   vocabulary, no requirement id without a definition, no requirement in an\n *   unknown tier.\n *\n * The component's own declaration lives beside it, in\n * `packages/<tier>/<name>/a11y.json` — one sidecar per component, the sixth\n * artifact `tools/check-a11y-evidence.ts` asserts. THE CLAIM IS DECLARED, NOT\n * DERIVED: Reka injects ARIA roles at runtime, so no reader can derive a\n * component's role from its source with confidence. The sidecar declares it,\n * cites the rendered evidence for the claim (`basis`), declares the evidence\n * files that exist today, and records an `exceptions` entry — requirement id\n * plus reason — for every matrix requirement nothing answers yet. The gate\n * counts and names those exceptions instead of failing the repository, so the\n * contract lands truthfully and the exception list shrinks as evidence grows.\n *\n * The sidecar now carries a SECOND axis beside the role claim: the\n * interaction class. Phase 3D reserved room here for exactly this — the same\n * sidecar, a second axis, not a second file — which is why `role` was held\n * orthogonal to evidence and exceptions rather than folded into them. The\n * interaction half is defined at the bottom of this file, and\n * `tools/check-interaction-evidence.ts` is its validator.\n *\n * Every collection below is a flat `as const` array of records — the shape the\n * gates' parsers and the pin test all rely on. Keep new fields string- or\n * array-valued and entry objects brace-free.\n */\n\n/**\n * The three evidence tiers, using `a11y-scope.ts`'s own vocabulary for the\n * same three runtimes: the browserless jsdom demo sweep, the component\n * harness's browser specs, and the root sweep over the built site.\n */\nexport const A11Y_EVIDENCE_TIERS = [\"browserless\", \"harness\", \"sweep\"] as const;\n\n/**\n * The closed ARIA role vocabulary a component may claim. Every member is a\n * real ARIA role — the one whose AT contract the component's own markup\n * asserts, native or injected: a native `<button>`, Reka's `role=\"dialog\"`\n * content, an explicit `role=\"list\"` wrapper. Composite widgets claim the\n * container role (tabs → tablist, select → combobox, tree-view → tree); the\n * `basis` field of each sidecar names the parts that make the claim true.\n */\nexport const ARIA_ROLES = [\n  \"alert\",\n  \"alertdialog\",\n  \"button\",\n  \"checkbox\",\n  \"combobox\",\n  \"dialog\",\n  \"grid\",\n  \"group\",\n  \"img\",\n  \"link\",\n  \"list\",\n  \"menu\",\n  \"menubar\",\n  \"meter\",\n  \"navigation\",\n  \"progressbar\",\n  \"radiogroup\",\n  \"region\",\n  \"searchbox\",\n  \"separator\",\n  \"slider\",\n  \"spinbutton\",\n  \"status\",\n  \"switch\",\n  \"tablist\",\n  \"table\",\n  \"textbox\",\n  \"toolbar\",\n  \"tooltip\",\n  \"tree\",\n] as const;\n\n/**\n * The two non-role members. `none` — the component asserts no ARIA role of\n * its own: its semantics are native landmarks, flow content or slotted\n * children. `visual-only` — presentational by design, removed from the\n * accessibility tree or carrying nothing a reader should hear; its only\n * obligation is to not assert broken ARIA while hiding.\n */\nexport const NON_ROLE_MEMBERS = [\"none\", \"visual-only\"] as const;\n\n/** The role vocabulary the sidecar's `role` field is held to. */\nexport const A11Y_ROLES = [...ARIA_ROLES, ...NON_ROLE_MEMBERS] as const;\n\n/**\n * The evidence requirements — one row per family of WCAG-tagged rules, named\n * for the obligation rather than the implementation so the matrix reads as\n * law. `tier` is where the claim must be ANSWERED; `answers` names the axe\n * rules of `a11y-scope.ts` the family covers, or the bespoke suite where axe\n * ships no rule for the criterion (2.4.11 has none, which is why\n * `e2e/focus-not-obscured.e2e.ts` exists at all).\n *\n * The families deliberately do not cover the whole partition — 27 of the 68\n * runtime-tier rules are named by no family, and the absence is recorded\n * rather than hidden, the way TAGGED_BUT_DISABLED_RULES records its own two:\n *\n * - host-document facts a consumer's page answers, not a component:\n *   `aria-hidden-body`, `bypass`, `document-title`, `html-has-lang`,\n *   `html-lang-valid`, `html-xml-lang-mismatch`, `meta-refresh`,\n *   `meta-viewport`, `valid-lang`;\n * - elements no Loom component ships: `blink`, `frame-focusable-content`,\n *   `frame-title`, `frame-title-unique`, `input-button-name`, `marquee`,\n *   `no-autoplay-audio`, `object-alt`, `server-side-image-map`,\n *   `summary-name`, `video-caption`;\n * - attributes whose truth belongs to the host, not the component:\n *   `aria-braille-equivalent` (no Loom component emits a braille equivalent\n *   today) and `autocomplete-valid` (the token is forwarded unchanged by\n *   combobox, editable, tags-input, text-field and command — the rule judges\n *   whether the host chose the right token for its field, which no component\n *   can answer for);\n * - consumer styling, not component markup: `avoid-inline-spacing`;\n * - conservative-partial table geometry, run by the sweep site-wide but owed\n *   by no role's row per-component: `table-fake-caption`, `td-has-header`,\n *   `td-headers-attr`, `th-has-data-cells`.\n *\n * The sweep runs all 68 site-wide regardless, so an uncovered rule is still\n * exercised on every page — what no role owes is per-component accountability.\n * The coverage set is pinned by packages/core/tests/a11y-contract.test.ts: a\n * rule that moves into or out of a family must edit that pin and this list\n * together.\n */\nexport const A11Y_EVIDENCE_REQUIREMENTS = [\n  {\n    id: \"semantic-aria\",\n    tier: \"browserless\",\n    answers: [\n      \"aria-roles\",\n      \"aria-required-attr\",\n      \"aria-valid-attr\",\n      \"aria-valid-attr-value\",\n      \"aria-allowed-attr\",\n      \"aria-conditional-attr\",\n      \"aria-prohibited-attr\",\n      \"aria-deprecated-role\",\n      \"aria-roledescription\",\n      \"aria-required-children\",\n      \"aria-required-parent\",\n      \"duplicate-id-aria\",\n      \"nested-interactive\",\n    ],\n  },\n  {\n    id: \"name\",\n    tier: \"browserless\",\n    answers: [\n      \"button-name\",\n      \"link-name\",\n      \"label\",\n      \"form-field-multiple-labels\",\n      \"aria-input-field-name\",\n      \"aria-command-name\",\n      \"aria-toggle-field-name\",\n      \"aria-meter-name\",\n      \"aria-progressbar-name\",\n      \"aria-tab-name\",\n      \"aria-tooltip-name\",\n      \"select-name\",\n      \"image-alt\",\n      \"svg-img-alt\",\n      \"role-img-alt\",\n      \"input-image-alt\",\n      \"area-alt\",\n    ],\n  },\n  {\n    id: \"structure\",\n    tier: \"browserless\",\n    answers: [\"list\", \"listitem\", \"definition-list\", \"dlitem\"],\n  },\n  {\n    id: \"keyboard\",\n    tier: \"harness\",\n    answers: [\"aria-hidden-focus\", \"scrollable-region-focusable\"],\n  },\n  {\n    id: \"contrast\",\n    tier: \"sweep\",\n    answers: [\n      \"color-contrast\",\n      \"link-in-text-block\",\n      \"p-as-heading\",\n      \"label-content-name-mismatch\",\n    ],\n  },\n  {\n    id: \"target-size\",\n    tier: \"sweep\",\n    answers: [\"target-size\"],\n  },\n  {\n    id: \"focus-not-obscured\",\n    tier: \"sweep\",\n    answers: [\"e2e/focus-not-obscured.e2e.ts (WCAG 2.4.11 — axe-core ships no rule for it)\"],\n  },\n] as const;\n\n/**\n * The matrix: the role's row is the claim it must satisfy. Shared shapes are\n * spelled out once per role rather than DRYed into inheritance — the matrix is\n * law, and a law a reader cannot read whole is a law a reader cannot argue\n * with. `semantic-aria` is the universal floor: every role owes it, including\n * visual-only, because an aria-hidden skeleton asserting a broken role is\n * still a defect.\n */\nexport const A11Y_EVIDENCE_MATRIX = [\n  // The universal floor, alone: nothing announced, nothing to name, nothing\n  // to aim at.\n  { role: \"visual-only\", requirements: [\"semantic-aria\"] },\n  // Flow content, landmarks and slots: no role of its own, but its rendered\n  // text and any controls it ships are judged like any other content.\n  { role: \"none\", requirements: [\"semantic-aria\", \"name\", \"contrast\"] },\n  { role: \"img\", requirements: [\"semantic-aria\", \"name\", \"contrast\"] },\n  { role: \"separator\", requirements: [\"semantic-aria\", \"contrast\"] },\n  // Announced-but-not-aimed-at: live and read-out roles.\n  { role: \"alert\", requirements: [\"semantic-aria\", \"name\", \"contrast\"] },\n  { role: \"status\", requirements: [\"semantic-aria\", \"name\", \"contrast\"] },\n  { role: \"meter\", requirements: [\"semantic-aria\", \"name\", \"contrast\"] },\n  { role: \"progressbar\", requirements: [\"semantic-aria\", \"name\", \"contrast\"] },\n  { role: \"tooltip\", requirements: [\"semantic-aria\", \"name\", \"contrast\"] },\n  // Structured content: the list/tree/table family owes its children's\n  // semantics. The table rules whose `matches` reads border geometry are\n  // browser-tier rules in a11y-scope.ts — the sweep answers them, so the row\n  // asks for the family here and the sweep provides it.\n  { role: \"list\", requirements: [\"semantic-aria\", \"name\", \"structure\", \"contrast\"] },\n  {\n    role: \"tree\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"structure\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"table\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"structure\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"grid\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"structure\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  // Named regions and navigation: labelled, aimed-at, traversable content.\n  {\n    role: \"region\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"navigation\",\n    requirements: [\"semantic-aria\", \"name\", \"contrast\", \"target-size\", \"focus-not-obscured\"],\n  },\n  // Controls and composites: the full obligation. The keyboard contract lives\n  // in the harness tier because that is where a keypress can be witnessed at\n  // all; target-size and focus-not-obscured live in the sweep because they are\n  // page facts about rendered geometry.\n  {\n    role: \"button\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  // A link is traversal-passive: a native anchor neither roves nor contains\n  // focus and creates no scroll region, so it cannot be the component that\n  // fails the keyboard family's two rules — the failures happen around it,\n  // created by the overlays that hide or scroll it, and those components'\n  // rows (dialog, drawer, popover) carry the obligation themselves.\n  {\n    role: \"link\",\n    requirements: [\"semantic-aria\", \"name\", \"contrast\", \"target-size\", \"focus-not-obscured\"],\n  },\n  {\n    role: \"checkbox\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"switch\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"radiogroup\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"slider\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"spinbutton\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"textbox\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"combobox\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"searchbox\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"menu\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"menubar\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"toolbar\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"tablist\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"dialog\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  {\n    role: \"alertdialog\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n  // Labelled groups of controls: the group's own contract is its label and\n  // its children's traversal, which is why keyboard sits in the row.\n  {\n    role: \"group\",\n    requirements: [\n      \"semantic-aria\",\n      \"name\",\n      \"contrast\",\n      \"keyboard\",\n      \"target-size\",\n      \"focus-not-obscured\",\n    ],\n  },\n] as const;\n\n/** A member of the closed role vocabulary. */\nexport type A11yRole = (typeof A11Y_ROLES)[number];\n\n/** A pure ARIA role, as distinct from the non-role members. */\nexport type AriaRole = (typeof ARIA_ROLES)[number];\n\n/** One evidence runtime: browserless jsdom, component harness, or the root sweep. */\nexport type A11yEvidenceTier = (typeof A11Y_EVIDENCE_TIERS)[number];\n\n/** A requirement the matrix can demand. */\nexport type A11yRequirementId = (typeof A11Y_EVIDENCE_REQUIREMENTS)[number][\"id\"];\n\n/**\n * One declared piece of evidence. A plain string is a repository-root-relative\n * path the gate verifies exists; an object is the same path plus the `because`\n * a tier the role's row does not demand must carry.\n */\nexport type A11yEvidenceEntry = string | { path: string; because?: string };\n\n/**\n * The sidecar — the declared claim `packages/<tier>/<name>/a11y.json` must\n * satisfy. `basis` is the reviewer's handle on the role claim: the rendered\n * element or injected role that makes it true. `evidence` is keyed by tier,\n * because the tiers are what the sweep, harness and jsdom run over — a\n * requirement is answered by its tier's evidence, not by a per-rule file\n * list. `exceptions` carries the matrix requirements nothing answers yet,\n * each with the reason it is missing.\n */\nexport interface A11yContract {\n  /** The claimed role, from {@link A11Y_ROLES}. */\n  role: A11yRole;\n  /** The rendered fact the role claim rests on — what a reviewer checks. */\n  basis: string;\n  /** Evidence that exists today, by tier. Paths are repository-root-relative. */\n  evidence: Partial<Record<A11yEvidenceTier, readonly A11yEvidenceEntry[]>>;\n  /** Matrix requirements this component does not answer yet, each with its reason. */\n  exceptions?: readonly { requirement: A11yRequirementId; because: string }[];\n}\n\n/**\n * The closed interaction-class vocabulary — the second axis of the same\n * sidecar, kept in this file so the two claims cannot drift apart. Each word\n * names the interaction contract the component OWNS, which is a smaller thing\n * than the interaction it makes possible: a layout slots buttons into itself,\n * but it owns none of their contract.\n *\n * - `interactive` — ONE operable target of the component's own: activate,\n *   adjust, type into. A button, a checkbox, a text field, a link.\n * - `composite` — SEVERAL operable parts the component manages as one: the\n *   traversal among them, the focus routing, the open/close state. A\n *   combobox, a tablist, a menu, a dialog, a tree.\n * - `container` — operates nothing itself; its own contract is the surface it\n *   puts around operable content. Keyboard passage through it must not trap,\n *   and its own scroll, collapse or resize behaviour must answer the keyboard\n *   too. A card, a scroll area, an app shell, a fieldset.\n * - `visual-only` — presents and wraps; nothing in it operates, takes focus\n *   or reports an interactive state of its own, by design. A skeleton, a\n *   badge, a meter, a flex wrapper.\n *\n * Two revealed surfaces that look like twins land in different classes on\n * purpose: a hover-card is `container` and a tooltip is `visual-only`. The\n * hover-card keeps a real, focusable, dismissible surface around content a\n * reader operates into; the tooltip is an announcement with nothing inside\n * it to operate. A component that could sit in either row takes the class\n * that demands more — the conservative direction costs a duty, the lenient\n * one forgives one.\n *\n * The class is declared, not derived, for the reason the role claim is: the\n * class is a fact about the contract the component's source owns, and no\n * reader can reconstruct it with confidence. Each sidecar's interaction claim\n * carries a `basis` naming the fact that puts the component in its class —\n * the reviewer's handle, the same one the role claim keeps.\n */\nexport const INTERACTION_CLASSES = [\n  \"interactive\",\n  \"composite\",\n  \"container\",\n  \"visual-only\",\n] as const;\n\n/**\n * The two runtimes that can witness an interaction duty. Same tiers, same\n * vocabulary, as {@link A11Y_EVIDENCE_TIERS} — a keypress is a browser fact\n * and a rendered state is a jsdom fact, exactly as the role axis has it. The\n * sweep tier is absent on purpose: no duty below is a page-geometry fact, so\n * a sweep citation would be evidence by adjacency, which is the fabricated\n * kind.\n */\nexport const INTERACTION_EVIDENCE_TIERS = [\"browserless\", \"harness\"] as const;\n\n/**\n * The interaction duties — one row per family of interaction obligations,\n * named for the obligation rather than the implementation. `tier` is where\n * the duty must be ANSWERED; `answers` is prose rather than a rule list,\n * because no axe rule judges an interaction contract — these duties are what\n * the component's own specs exist to witness.\n *\n * Three duties, and no reduced-motion row — a deliberate absence, recorded\n * rather than hidden. Animation is a per-component fact none of the four\n * class words carries, and the root reduced-motion suite reaches four pages\n * today (dialog, drawer, toast, skeleton), so a class row demanding it would\n * be a duty nothing in the vocabulary could answer honestly. A per-component\n * motion duty — a declared `animates` fact answered through that suite's\n * growing population — is the tranche work this axis opens; it lands as a row\n * edit plus suite growth in one PR, the way every other row change must.\n */\nexport const INTERACTION_REQUIREMENTS = [\n  {\n    id: \"keyboard-operate\",\n    tier: \"harness\",\n    answers: [\n      \"the component's keyboard contract — its own keys, or keyboard passage through its surface — witnessed as gestures in a browser by its own harness spec (WCAG 2.1.1)\",\n    ],\n  },\n  {\n    id: \"state-report\",\n    tier: \"browserless\",\n    answers: [\n      \"the states a component renders — disabled, readonly, busy, expanded, selected — reaching the DOM where the unit tier can pin them (WCAG 4.1.2)\",\n    ],\n  },\n  {\n    id: \"keyboard-inert\",\n    tier: \"browserless\",\n    answers: [\n      \"the absence of an interaction surface: nothing in a visual-only component takes focus or a key (WCAG 2.1.1 vacuously, 2.4.3 actually) — a pin of absence, worthless asserted in prose\",\n    ],\n  },\n] as const;\n\n/**\n * The interaction matrix: the class's row is the claim it must satisfy, the\n * role matrix's discipline on the second axis. `keyboard-inert` is\n * visual-only's whole row because \"nothing operates here\" is itself a\n * contract — the one an aria-hidden placeholder that steals a tab stop breaks\n * — and an absence nobody pins is an absence nobody would notice breaking.\n */\nexport const INTERACTION_MATRIX = [\n  { class: \"interactive\", requirements: [\"keyboard-operate\", \"state-report\"] },\n  { class: \"composite\", requirements: [\"keyboard-operate\", \"state-report\"] },\n  { class: \"container\", requirements: [\"keyboard-operate\"] },\n  { class: \"visual-only\", requirements: [\"keyboard-inert\"] },\n] as const;\n\n/** A member of the closed interaction-class vocabulary. */\nexport type InteractionClass = (typeof INTERACTION_CLASSES)[number];\n\n/** A runtime that can witness an interaction duty. */\nexport type InteractionEvidenceTier = (typeof INTERACTION_EVIDENCE_TIERS)[number];\n\n/** A duty the interaction matrix can demand. */\nexport type InteractionRequirementId = (typeof INTERACTION_REQUIREMENTS)[number][\"id\"];\n\n/**\n * One declared piece of interaction evidence. A plain string is a\n * repository-root-relative path the gate verifies exists; an object is the\n * same path plus the `because` that narrows what the file witnesses — and a\n * qualified entry answers no duty.\n */\nexport type InteractionEvidenceEntry = string | { path: string; because?: string };\n\n/**\n * The `interaction` claim `packages/<tier>/<name>/a11y.json` carries beside\n * its `role` claim — the second axis in the same sidecar, not a second file,\n * the reservation at the top of this file kept. Same doctrine as the role\n * claim: declared, cited where the evidence exists, and excepted with a\n * reason where it does not, so the contract lands truthfully and shrinks as\n * the harness-spec tranche lands.\n */\nexport interface InteractionContract {\n  /** The claimed interaction class, from {@link INTERACTION_CLASSES}. */\n  class: InteractionClass;\n  /** The fact the class claim rests on — what a reviewer checks. */\n  basis: string;\n  /** Evidence that exists today, by tier. Paths are repository-root-relative. */\n  evidence: Partial<Record<InteractionEvidenceTier, readonly InteractionEvidenceEntry[]>>;\n  /** Matrix duties this component does not answer yet, each with its reason. */\n  exceptions?: readonly { requirement: InteractionRequirementId; because: string }[];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,IAAa,sBAAsB;CAAC;CAAe;CAAW;AAAO;;;;;;;;;AAUrE,IAAa,aAAa;CACxB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;;AASA,IAAa,mBAAmB,CAAC,QAAQ,aAAa;;AAGtD,IAAa,aAAa,CAAC,GAAG,YAAY,GAAG,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuC7D,IAAa,6BAA6B;CACxC;EACE,IAAI;EACJ,MAAM;EACN,SAAS;GACP;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,IAAI;EACJ,MAAM;EACN,SAAS;GACP;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,IAAI;EACJ,MAAM;EACN,SAAS;GAAC;GAAQ;GAAY;GAAmB;EAAQ;CAC3D;CACA;EACE,IAAI;EACJ,MAAM;EACN,SAAS,CAAC,qBAAqB,6BAA6B;CAC9D;CACA;EACE,IAAI;EACJ,MAAM;EACN,SAAS;GACP;GACA;GACA;GACA;EACF;CACF;CACA;EACE,IAAI;EACJ,MAAM;EACN,SAAS,CAAC,aAAa;CACzB;CACA;EACE,IAAI;EACJ,MAAM;EACN,SAAS,CAAC,6EAA6E;CACzF;AACF;;;;;;;;;AAUA,IAAa,uBAAuB;CAGlC;EAAE,MAAM;EAAe,cAAc,CAAC,eAAe;CAAE;CAGvD;EAAE,MAAM;EAAQ,cAAc;GAAC;GAAiB;GAAQ;EAAU;CAAE;CACpE;EAAE,MAAM;EAAO,cAAc;GAAC;GAAiB;GAAQ;EAAU;CAAE;CACnE;EAAE,MAAM;EAAa,cAAc,CAAC,iBAAiB,UAAU;CAAE;CAEjE;EAAE,MAAM;EAAS,cAAc;GAAC;GAAiB;GAAQ;EAAU;CAAE;CACrE;EAAE,MAAM;EAAU,cAAc;GAAC;GAAiB;GAAQ;EAAU;CAAE;CACtE;EAAE,MAAM;EAAS,cAAc;GAAC;GAAiB;GAAQ;EAAU;CAAE;CACrE;EAAE,MAAM;EAAe,cAAc;GAAC;GAAiB;GAAQ;EAAU;CAAE;CAC3E;EAAE,MAAM;EAAW,cAAc;GAAC;GAAiB;GAAQ;EAAU;CAAE;CAKvE;EAAE,MAAM;EAAQ,cAAc;GAAC;GAAiB;GAAQ;GAAa;EAAU;CAAE;CACjF;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CAEA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GAAC;GAAiB;GAAQ;GAAY;GAAe;EAAoB;CACzF;CAKA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CAMA;EACE,MAAM;EACN,cAAc;GAAC;GAAiB;GAAQ;GAAY;GAAe;EAAoB;CACzF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CACA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;CAGA;EACE,MAAM;EACN,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;EACF;CACF;AACF"}