rcf-lite 0.26.0 → 0.27.0

package/blueprints/application-charts/contributions/requirements/application-charts-req-003.json

@@ -7,9 +7,16 @@
   "domain": "application",
   "priority": "must",
   "rationale": "A chart is a visual encoding of data; a text-alternative table is the only assistive-tech-reachable form of the same data that fits the existing table-navigation vocabulary. Screen-reader users receive the same information; a canvas-only chart with no text-alternative is inaccessible.",
-  "tags": ["blueprint:application-charts", "category:03-text-alternative"],
-  "version": "1.0.0",
+  "tags": [
+    "blueprint:application-charts",
+    "category:03-text-alternative"
+  ],
+  "version": "1.0.1",
   "status": "approved",
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-04T21:00:00Z",
+  "deliveredBy": {
+    "tacId": "TAC-1901-application-charts-render-shell",
+    "field": "responsibilities"
+  }
 }

package/blueprints/application-charts/contributions/requirements/application-charts-req-004.json

@@ -7,9 +7,16 @@
   "domain": "application",
   "priority": "must",
   "rationale": "Keyboard-only users need the same data-point granularity a pointer user has, and the announced string is the assistive-tech-visible surface. Reduced-motion respect is the WCAG 2.3.3 clause the shelf inherits from application-spa's motion tokens; a chart that does not honour it fails the same clause.",
-  "tags": ["blueprint:application-charts", "category:04-keyboard-traversal"],
-  "version": "1.0.0",
+  "tags": [
+    "blueprint:application-charts",
+    "category:04-keyboard-traversal"
+  ],
+  "version": "1.0.1",
   "status": "approved",
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-04T21:00:00Z",
+  "deliveredBy": {
+    "tacId": "TAC-1901-application-charts-render-shell",
+    "field": "responsibilities"
+  }
 }

package/blueprints/application-charts/contributions/tacs/tac-1901-application-charts-render-shell.json

@@ -2,7 +2,7 @@
   "tacId": "TAC-1901-application-charts-render-shell",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "status": "approved",
   "name": "Chart render shell",
   "purpose": "Owns the rendered chart surface: the mount seam every chart on the shipped surface routes through, the accessible-defaults palette hook (ADR-1902), the text-alternative slot (a `<table>` in the same landmark as the chart), and the reduced-motion respect via the application-spa motion tokens (ADR-1903). The shell is the substitutable interface every AC in this blueprint anchors on, and the applying project's chosen chart engine (ADR-1901) mounts against this contract.",
@@ -12,7 +12,8 @@
     "Render a paired `<table>` element in the same landmark as the chart (`role=\"region\"` wrapping both, or the same `<section>`), with a row per x-value or category and a column per series (AC-18103-1), and expose a labelled control that moves focus to the table when the table is visually-hidden (AC-18103-2).",
     "Expose the accessible-defaults palette (light and dark) as the recommended default and accept operator brand tokens as overrides with a fallback to the defaults on missing tokens (AC-18105-1, AC-18105-2).",
     "Honour `prefers-reduced-motion: reduce` by suppressing entry and update transitions on the chart surface (AC-18104-1, ADR-1903).",
-    "Route text-alternative refusals: a chart engine that renders canvas-only with no text-alternative path is refused at mount (AC-18106-1) and the shell writes a warning to the render log."
+    "Route text-alternative refusals: a chart engine that renders canvas-only with no text-alternative path is refused at mount (AC-18106-1) and the shell writes one warning entry to the render log per refused chart declaration, keyed to the chart declaration's accessible-name and naming the engine and the missing text-alternative surface; a compliant re-mount clears the surface without duplicating the warning (AC-18106-3, AC-18106-4).",
+    "Attach a `data-chart-engine` attribute on the rendered chart mount whose value equals the elicited engine token from `blueprint.json:elicits[chart-engine]` (AC-18106-2)."
   ],
   "internalStructure": "One shell module that mounts the surface, plus small internal helpers per chart form (form binders that translate the chart declaration into engine-specific mount calls). Every form binder writes to the same DOM landmark shape and reads from the same palette API. The framework is not prescribed; the shell interfaces are what the project realises against Recharts, ECharts, Chart.js, D3 primitives or a hand-authored SVG.",
   "interfaces": [

package/blueprints/application-charts/contributions/tacs/tac-1902-application-charts-keyboard-traversal.json

@@ -2,7 +2,7 @@
   "tacId": "TAC-1902-application-charts-keyboard-traversal",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "approved",
   "name": "Chart keyboard traversal contract",
   "purpose": "Owns the keyboard traversal contract for interactive charts: each data point receives focus in reading order, the announced string carries the series name, x-value, y-value and unit, and the traversal path composes cleanly with the shell's text-alternative table so a keyboard-only user reaches every value through either surface.",

package/blueprints/application-charts/contributions/user-stories/application-charts-us-18101.json

@@ -2,7 +2,7 @@
   "usId": "application-charts-US-18101",
   "prdId": "PRD-001",
   "reqId": "application-charts-REQ-001",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "status": "approved",
   "title": "Every chart on the shipped surface names one of the six committed forms and honours the render-shell contract",
   "asA": "product owner responsible for the shipped surface's data affordances",
@@ -16,7 +16,8 @@
       "when": "the surface is reviewed against the shelf",
       "then": "the chart's declared form is one of the six committed forms or a documented project deviation",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-18101-2",
@@ -25,11 +26,54 @@
       "when": "the mount seam is inspected",
       "then": "the chart is mounted through TAC-1901's render shell",
       "testable": true,
-      "scope": "library"
+      "scope": "library",
+      "disposition": "fixed"
+    },
+    {
+      "id": "AC-18101-3",
+      "description": "Given a rendered chart, when the chart's declared form matches one of the six committed forms (bar, line, area, pie, donut, single-value, sparkline, heatmap), the shell exposes a per-form binder resolving the values to the form's DOM primitives (rects for bar, path for line and area, arcs for pie or donut, one text node for single-value, mini-path for sparkline, grid cells for heatmap); a form whose binder is absent fails the pack check.",
+      "given": "a rendered chart of one of the six committed forms",
+      "when": "the pack inspects the shell's form binder",
+      "then": "the shell exposes the per-form binder resolving values to the form's DOM primitives; a missing binder fails the check",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[0]"
+      }
+    },
+    {
+      "id": "AC-18101-4",
+      "description": "Given a specialised form the applying project needs (a candlestick, a Sankey), the project's README carries a CALLS MADE entry naming the deviation and the project supersedes REQ-001 with a project-authored REQ that names the deviating form; a specialised form without a documented CALLS MADE + superseding REQ fails project-side review. Applying agent sets: the specialised chart form the project needs (a candlestick, a Sankey), the CALLS MADE entry text (the deviation from the six-form set quoted verbatim and the project's reason), and the project-authored superseding REQ id that names the deviating form.",
+      "given": "an applying project shipping a form outside the six committed",
+      "when": "review inspects the project's CALLS MADE and REQ set",
+      "then": "the deviation is documented with a project-authored superseding REQ; an undocumented deviation fails review",
+      "testable": true,
+      "scope": "unclassified",
+      "disposition": "template"
+    },
+    {
+      "id": "AC-18101-5",
+      "description": "Given a rendered chart whose form is declared correctly but whose data set is empty (no series values), the shell renders a labelled empty-state block (`role=\"region\"` with an accessible name naming the empty condition) inside the same landmark as the chart; a shell that renders a blank chart canvas with no announcement fails the pack check.",
+      "given": "a rendered chart with an empty data set",
+      "when": "the pack inspects the shell's render",
+      "then": "the shell renders a labelled empty-state block with an accessible name inside the chart's landmark; a silent blank chart fails",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[0]"
+      }
     }
   ],
-  "tacIds": ["TAC-1901-application-charts-render-shell"],
-  "tags": ["blueprint:application-charts"],
+  "tacIds": [
+    "TAC-1901-application-charts-render-shell"
+  ],
+  "tags": [
+    "blueprint:application-charts"
+  ],
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-09T00:00:00Z"
 }

package/blueprints/application-charts/contributions/user-stories/application-charts-us-18102.json

@@ -2,7 +2,7 @@
   "usId": "application-charts-US-18102",
   "prdId": "PRD-001",
   "reqId": "application-charts-REQ-002",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "status": "approved",
   "title": "Series distinction combines colour, pattern and direct label so a colour-blind reader reads the same distinction",
   "asA": "reader with a colour-vision deficiency using the shipped surface",
@@ -16,7 +16,8 @@
       "when": "the DOM is inspected",
       "then": "every series carries colour plus a non-colour pattern attribute plus a direct label",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-18102-2",
@@ -25,11 +26,62 @@
       "when": "the pack runs",
       "then": "the AC-18102-1 rule does not apply and the pack records applicable false",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed",
+      "vendorCitation": {
+        "url": "https://www.w3.org/WAI/WCAG22/Understanding/use-of-color.html",
+        "verifiedOn": "2026-09-09"
+      }
+    },
+    {
+      "id": "AC-18102-3",
+      "description": "Given a rendered multi-series chart whose series distinction relies on the shipped accessible palette AND a distinguishing pattern, when the deuteranopia simulation is applied to a screenshot of the surface, the series remain visually distinct (a pattern still parses through the simulation); a chart whose only distinction is a colour indistinguishable under the simulation fails the pack check.",
+      "given": "a rendered multi-series chart under a deuteranopia simulation",
+      "when": "the pack inspects the simulated screenshot",
+      "then": "the series remain visually distinct through the pattern and label; a colour-only distinction fails",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[1]"
+      }
+    },
+    {
+      "id": "AC-18102-4",
+      "description": "Given a rendered multi-series chart whose legend is present but no series carries a direct label at the series, the pack fails the check per REQ-002 (a legend entry alone does not satisfy the AC); a passing chart carries a direct label at each series either inside the plot area or immediately adjacent to the series line, bar or slice.",
+      "given": "a rendered multi-series chart with a legend but no direct series labels",
+      "when": "the pack inspects the DOM",
+      "then": "the check fails; a passing chart carries a direct series label at each series (not only in the legend)",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[1]"
+      }
+    },
+    {
+      "id": "AC-18102-5",
+      "description": "Given a rendered multi-series chart with more series than the shipped palette provides colours for (a 20-series chart against an 8-colour palette), the shell cycles the palette AND changes the pattern so the pattern-plus-index combination stays unique across series; two series that share both colour AND pattern fail the pack check.",
+      "given": "a rendered chart with more series than the palette carries colours",
+      "when": "the pack inspects series colour and pattern combinations",
+      "then": "each series has a unique (colour, pattern) combination; two series sharing both fail the check",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[1]"
+      }
     }
   ],
-  "tacIds": ["TAC-1901-application-charts-render-shell"],
-  "tags": ["blueprint:application-charts"],
+  "tacIds": [
+    "TAC-1901-application-charts-render-shell"
+  ],
+  "tags": [
+    "blueprint:application-charts"
+  ],
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-10T07:07:28Z"
 }

package/blueprints/application-charts/contributions/user-stories/application-charts-us-18103.json

@@ -2,7 +2,7 @@
   "usId": "application-charts-US-18103",
   "prdId": "PRD-001",
   "reqId": "application-charts-REQ-003",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "status": "approved",
   "title": "Every chart ships a paired text-alternative table with the same data, focus-reachable in the same landmark",
   "asA": "screen-reader user using the shipped surface",
@@ -16,7 +16,8 @@
       "when": "the accessibility tree is read",
       "then": "a `<table>` in the same landmark carries the same values cell-by-cell and is focus-reachable",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-18103-2",
@@ -25,11 +26,58 @@
       "when": "the operator tabs into the chart's landmark",
       "then": "a labelled control appears before the chart's data-point controls and moves focus to the table on activation",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
+    },
+    {
+      "id": "AC-18103-3",
+      "description": "Given a rendered chart, when the pack inspects each cell of the paired text-alternative `<table>`, every cell's text value matches the chart's rendered value for the same (x, series) coordinate to the same precision the chart renders; a mismatched or missing cell fails the pack check.",
+      "given": "a rendered chart and its paired text-alternative table",
+      "when": "the pack walks each cell",
+      "then": "every cell's text value matches the chart's rendered value for the same (x, series) coordinate; mismatch or missing cell fails",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[2]"
+      }
+    },
+    {
+      "id": "AC-18103-4",
+      "description": "Given a rendered chart whose paired `<table>` is missing from the same landmark (the `<table>` renders in an unrelated section, or under a different `role=\"region\"`), the pack fails the check per REQ-003; a passing chart has both the chart and the table under the same landmark element (a shared `role=\"region\"` or the same `<section>`).",
+      "given": "a rendered chart whose paired table is outside the chart's landmark",
+      "when": "the pack inspects the landmark boundaries",
+      "then": "the check fails; a passing chart has both chart and table inside the same landmark",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[2]"
+      }
+    },
+    {
+      "id": "AC-18103-5",
+      "description": "Given a rendered chart whose text-alternative table is visually-hidden with `display: none` (making it inert for assistive tech), the pack fails the check; a passing visually-hidden table uses a technique that keeps the table in the accessibility tree (`clip-path` or the `sr-only` pattern with `position: absolute; width: 1px; height: 1px; overflow: hidden`) so screen readers can reach the cells.",
+      "given": "a rendered chart whose text-alternative table is hidden with display:none",
+      "when": "the pack inspects the accessibility tree",
+      "then": "the check fails; a passing hidden table uses a technique that keeps the cells in the accessibility tree",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[2]"
+      }
     }
   ],
-  "tacIds": ["TAC-1901-application-charts-render-shell"],
-  "tags": ["blueprint:application-charts"],
+  "tacIds": [
+    "TAC-1901-application-charts-render-shell"
+  ],
+  "tags": [
+    "blueprint:application-charts"
+  ],
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-09T00:00:00Z"
 }

package/blueprints/application-charts/contributions/user-stories/application-charts-us-18104.json

@@ -2,7 +2,7 @@
   "usId": "application-charts-US-18104",
   "prdId": "PRD-001",
   "reqId": "application-charts-REQ-004",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "status": "approved",
   "title": "Interactive charts expose a keyboard traversal path with a stable announced-string contract",
   "asA": "keyboard-only user reading an interactive chart",
@@ -16,7 +16,8 @@
       "when": "the operator tabs through the chart with prefers-reduced-motion set",
       "then": "each data point receives focus in reading order, the announced string matches the format, and transitions are suppressed",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-18104-2",
@@ -25,11 +26,59 @@
       "when": "the pack runs",
       "then": "the AC-18104-1 keyboard-traversal rule does not apply and the pack records applicable false",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
+    },
+    {
+      "id": "AC-18104-3",
+      "description": "Given an interactive chart, when the keyboard focus reaches a data point, the announced string contract reads `<series name>, <x value>, <y value> <unit>` in that order (comma or space separated); a chart whose announcement omits the series name on a multi-series chart or omits the unit fails the pack check.",
+      "given": "keyboard focus on a data point in an interactive multi-series chart",
+      "when": "the pack captures the announced string",
+      "then": "the string reads `<series name>, <x value>, <y value> <unit>`; an omitted series or unit fails",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1902-application-charts-keyboard-traversal",
+        "field": "responsibilities[0]"
+      }
+    },
+    {
+      "id": "AC-18104-4",
+      "description": "Given an interactive multi-series chart, the keyboard traversal moves series-by-series (all points on series 1 in x order, then all points on series 2 in x order, and so on); a chart whose traversal moves in x-first order across all series (a zig-zag pattern) fails the pack check per REQ-004's series-by-series reading order.",
+      "given": "keyboard traversal on an interactive multi-series chart",
+      "when": "the pack captures the focus order",
+      "then": "traversal is series-by-series in x order; an x-first zig-zag fails",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1902-application-charts-keyboard-traversal",
+        "field": "responsibilities[0]"
+      }
+    },
+    {
+      "id": "AC-18104-5",
+      "description": "Given an interactive chart under `prefers-reduced-motion: reduce`, the entry and update transitions of the chart honour zero-duration (no animated tween, no easing curve); a chart whose entry animation still fires under reduced-motion fails the pack check per REQ-004 and ADR-1903.",
+      "given": "an interactive chart under prefers-reduced-motion: reduce",
+      "when": "the pack inspects entry and update transitions",
+      "then": "transitions honour zero duration; an animated entry under reduced-motion fails",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "adrId": "ADR-1903-application-charts-motion",
+        "field": "decision"
+      }
     }
   ],
-  "tacIds": ["TAC-1901-application-charts-render-shell", "TAC-1902-application-charts-keyboard-traversal"],
-  "tags": ["blueprint:application-charts"],
+  "tacIds": [
+    "TAC-1901-application-charts-render-shell",
+    "TAC-1902-application-charts-keyboard-traversal"
+  ],
+  "tags": [
+    "blueprint:application-charts"
+  ],
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-09T00:00:00Z"
 }

package/blueprints/application-charts/contributions/user-stories/application-charts-us-18105.json

@@ -2,7 +2,7 @@
   "usId": "application-charts-US-18105",
   "prdId": "PRD-001",
   "reqId": "application-charts-REQ-002",
-  "version": "1.0.0",
+  "version": "1.0.4",
   "status": "approved",
   "title": "The shell exposes the accessible-defaults palette hook (light and dark) and accepts elicited operator overrides",
   "asA": "operator applying the blueprint",
@@ -11,25 +11,81 @@
   "acceptanceCriteria": [
     {
       "id": "AC-18105-1",
-      "description": "Given a rendered chart on a light background, every series colour and every axis text carries a contrast ratio of at least 4.5:1 against its background (WCAG 1.4.3 for text; the 3:1 non-text contrast under WCAG 1.4.11 for series marks). The shell ships light and dark palettes matched against these ratios; the shell's palette accessor returns the applied palette by name and version. This AC is a build-scan surface (palette values readable from the applied blueprint's palette module); the pack has no dedicated check for it and the README names the gap under known mechanism-reach gaps as a build-scan opportunity for a v1.1 minor bump.",
+      "description": "Given a rendered chart on a light background, every series colour and every axis text carries a contrast ratio of at least 4.5:1 against its background (WCAG 1.4.3 for text; the 3:1 non-text contrast under WCAG 1.4.11 for series marks). The shell ships light and dark palettes matched against these ratios. This AC is a build-scan surface (palette values readable from the applied blueprint's palette module); the pack has no dedicated check for it and the README names the gap under known mechanism-reach gaps as a build-scan opportunity for a v1.1 minor bump. Applying agent sets: the applied light and dark backgrounds the contrast check runs against, and any operator brand-token overrides supplied on `blueprint.json:elicits[palette-overrides]`. The palette accessor shape (`palette.get(seriesIndex, { role? })` returning `{ colour, pattern, marker }`) is fixed on TAC-1901-application-charts-render-shell.interfaces[1].",
       "given": "a rendered chart under either the light or dark palette",
       "when": "the palette is inspected",
       "then": "series colours meet WCAG 1.4.11 (3:1 non-text contrast) and axis text meets WCAG 1.4.3 (4.5:1) against the applied background",
       "testable": true,
-      "scope": "library"
+      "scope": "library",
+      "disposition": "template"
     },
     {
       "id": "AC-18105-2",
-      "description": "Given the shell's palette API, an operator supplies brand tokens (a palette override object keyed by series index or role) and the shell renders the operator palette; when the operator palette misses a token the shell falls back to the accessible-defaults palette at the same index and records a warning on the render log. The API surface (`renderShell({ palette, chart })`) is a project-side contract; the fallback behaviour is exercised by the applying project's own tests, not this blueprint's pack.",
+      "description": "Given the shell's palette API, an operator supplies brand tokens through the `blueprint.json:elicits[palette-overrides]` string elicit and the shell renders the operator palette; when the operator palette misses a token the shell falls back to the accessible-defaults palette at the same index and records a warning on the render log. The API surface (`renderChart({ palette, ... })` from TAC-1901.interfaces[0]) is a project-side contract; the fallback behaviour is exercised by the applying project's own tests, not this blueprint's pack. Applying agent sets: the value supplied on `blueprint.json:elicits[palette-overrides]` (a string per the manifest, carrying the operator's palette-override encoding the shell reads). The fallback expectation (accessible-defaults palette at the same index and a render-log warning) is fixed on ADR-1902-application-charts-accessible-palette.decision.",
       "given": "an operator palette with missing tokens",
       "when": "the shell renders",
       "then": "missing tokens fall back to the accessible-defaults palette and a warning is recorded",
       "testable": true,
-      "scope": "library"
+      "scope": "library",
+      "disposition": "template",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "interfaces[0].name"
+      }
+    },
+    {
+      "id": "AC-18105-3",
+      "description": "Given a rendered chart on a dark background, when the pack captures every series colour on the chart, each series colour meets the WCAG 1.4.11 3:1 non-text contrast ratio against the dark background; the check runs the colour-contrast calculation against the applied theme's background and fails on any series colour under the threshold.",
+      "given": "a rendered chart on a dark background",
+      "when": "the pack computes series colour contrast ratios",
+      "then": "every series colour meets WCAG 1.4.11 (3:1 non-text contrast) against the dark background; a failure fails the pack",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "adrId": "ADR-1902-application-charts-accessible-palette",
+        "field": "decision"
+      },
+      "vendorCitation": {
+        "url": "https://www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html",
+        "verifiedOn": "2026-09-09"
+      }
+    },
+    {
+      "id": "AC-18105-4",
+      "description": "Given an operator-elicited `blueprint.json:elicits[].palette-overrides` value that names N brand tokens for N series but leaves M > N series unpaletted, the shell falls back to the accessible-defaults palette for the unpaletted series at the same index and the render log records exactly one warning per unpaletted series naming the missing token; a shell that silently substitutes without a log entry fails the pack check per ADR-1902.",
+      "given": "an operator palette override that undersupplies for the series count",
+      "when": "the shell renders the chart",
+      "then": "the unpaletted series fall back to the accessible-defaults palette at the same index and one render-log warning per unpaletted series names the missing token",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "adrId": "ADR-1902-application-charts-accessible-palette",
+        "field": "decision"
+      }
+    },
+    {
+      "id": "AC-18105-5",
+      "description": "Given a rendered chart whose applied theme background differs between light and dark modes, when the theme flips at runtime (a user toggles the theme), the palette applied to the chart re-resolves from light-defaults to dark-defaults automatically and the render log records the palette flip; a chart whose palette does not re-resolve on theme flip fails the pack check.",
+      "given": "a rendered chart under a runtime theme flip from light to dark",
+      "when": "the pack inspects the re-rendered chart",
+      "then": "the palette re-resolves to the dark-defaults automatically and the render log records the flip",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "adrId": "ADR-1902-application-charts-accessible-palette",
+        "field": "decision"
+      }
     }
   ],
-  "tacIds": ["TAC-1901-application-charts-render-shell"],
-  "tags": ["blueprint:application-charts"],
+  "tacIds": [
+    "TAC-1901-application-charts-render-shell"
+  ],
+  "tags": [
+    "blueprint:application-charts"
+  ],
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-10T07:07:28Z"
 }

package/blueprints/application-charts/contributions/user-stories/application-charts-us-18106.json

@@ -2,7 +2,7 @@
   "usId": "application-charts-US-18106",
   "prdId": "PRD-001",
   "reqId": "application-charts-REQ-004",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "status": "approved",
   "title": "A chart engine that refuses text-alternative access is refused on the applying project",
   "asA": "shelf reviewer gating an applying project's chart engine choice",
@@ -11,25 +11,63 @@
   "acceptanceCriteria": [
     {
       "id": "AC-18106-1",
-      "description": "Given ADR-1901's engine choice (Recharts, ECharts, Chart.js, D3 primitives or another operator-elicited engine), the applying project's manifest records the engine and the text-alternative reach: the engine's rendered chart is paired with a `<table>` element the pack asserts (AC-18103-1). An engine that renders exclusively to a `<canvas>` and does not offer a text-alternative surface is refused at project-side review; the refusal is documented in the blueprint's README under the engine-refusal rule.",
+      "description": "Given ADR-1901's engine choice, one of the canonical tokens `recharts`, `echarts`, `chart-js`, `d3-primitives` or `hand-authored-svg` on `blueprint.json:elicits[].chart-engine.options` (the manifest owns the token set; every other layer references these tokens verbatim), the applying project's manifest records the engine and the text-alternative reach: the engine's rendered chart is paired with a `<table>` element the pack asserts (AC-18103-1). An engine that renders exclusively to a `<canvas>` and does not offer a text-alternative surface is refused at project-side review; the refusal is documented in the blueprint's README under the engine-refusal rule. Applying agent sets: the `blueprint.json:elicits[].chart-engine.options` token (one of `recharts`, `echarts`, `chart-js`, `d3-primitives`, `hand-authored-svg`) recorded on the manifest, and the paired `<table>` mount the pack asserts under AC-18103-1.",
       "given": "an ADR-1901 engine choice",
       "when": "the applying project's chart mount is reviewed",
       "then": "the engine is refused if it renders canvas-only surfaces with no text-alternative path",
       "testable": true,
-      "scope": "library"
+      "scope": "library",
+      "disposition": "template"
     },
     {
       "id": "AC-18106-2",
-      "description": "Given a compliant engine choice, the applying project's rendered chart carries a `data-chart-engine` attribute or an equivalent DOM marker naming the engine (Recharts, ECharts, Chart.js, D3 or the elicited name). This is a project-side observation, not a pack check; the README names it under known mechanism-reach gaps as a documentation contract on the applying project.",
+      "description": "Given a compliant engine choice, the applying project's rendered chart carries the `data-chart-engine` attribute whose value equals the canonical engine token elicited on `blueprint.json:elicits[chart-engine]` (`recharts`, `echarts`, `chart-js`, `d3-primitives` or `hand-authored-svg`). This is a project-side observation, not a pack check; the README names it under known mechanism-reach gaps as a documentation contract on the applying project. Applying agent sets: the value elicited on `blueprint.json:elicits[chart-engine]` (one of the five canonical tokens). The `data-chart-engine` attribute name is fixed on TAC-1901-application-charts-render-shell.responsibilities[6].",
       "given": "a compliant chart engine on the applying project",
       "when": "the rendered chart is inspected",
       "then": "the engine name is discoverable on the rendered DOM through a stable attribute",
       "testable": true,
-      "scope": "library"
+      "scope": "library",
+      "disposition": "template",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[6]"
+      }
+    },
+    {
+      "id": "AC-18106-3",
+      "description": "Given the applying project mounts a chart whose engine renders exclusively to a `<canvas>` and offers no text-alternative surface, when the shell factory attempts to mount, then the mount is refused before any DOM is produced and no `<canvas>` element attaches to the target root. Applying agent sets: the applying project's engine choice that fails the text-alternative check (a canvas-only engine with no text-alternative surface). The refusal-record shape written on refusal is fixed on TAC-1901-application-charts-render-shell.responsibilities[5].",
+      "given": "an engine choice whose runtime provides no text-alternative surface",
+      "when": "the shell attempts to mount a chart on the applying project's surface",
+      "then": "the mount is refused before DOM attachment and no chart element renders",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "template",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[5]"
+      }
+    },
+    {
+      "id": "AC-18106-4",
+      "description": "Given a refused mount as observed in AC-18106-3, the render log matches the refusal-record shape fixed on TAC-1901-application-charts-render-shell.responsibilities[5]: exactly one warning entry per refused chart declaration is present and a re-mount with a compliant engine attaches DOM without re-warning.",
+      "given": "a text-alternative refusal has fired once for a given chart declaration",
+      "when": "the render log is inspected",
+      "then": "the render log matches the refusal-record shape fixed on TAC-1901.responsibilities[5] and re-mount with a compliant engine attaches DOM without re-warning",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[5]"
+      }
     }
   ],
-  "tacIds": ["TAC-1901-application-charts-render-shell"],
-  "tags": ["blueprint:application-charts"],
+  "tacIds": [
+    "TAC-1901-application-charts-render-shell"
+  ],
+  "tags": [
+    "blueprint:application-charts"
+  ],
   "createdAt": "2026-09-04T21:00:00Z",
   "updatedAt": "2026-09-04T21:00:00Z"
 }

package/blueprints/application-charts/docs/topics.md

@@ -2,7 +2,7 @@
 
 ## Global topics
 
-The blueprint claims no new global topics at v1.0.0. The chart-component contract is a general accessibility-first practice; every ADR (engine choice, accessible palette, reduced motion) is non-global. When a second chart-shaped blueprint composes on the shelf (a Sankey blueprint, a mapping blueprint), THAT blueprint may claim a `chartEngine` topic; today, the single consumer (application-dashboard T-3) reads the shell contract directly.
+The blueprint claims no new global topics at v1.0.0. The chart-component contract is a general accessibility-first practice; every ADR (engine choice, accessible palette, reduced motion) is non-global. When a second chart-shaped blueprint composes on the shelf (a Sankey blueprint, a mapping blueprint), THAT blueprint may claim a `chartEngine` topic; today, the single consumer (application-dashboard ) reads the shell contract directly.
 
 ## Deliberately unclaimed topics
 
@@ -52,4 +52,4 @@ Every check carries a `description` field per spec section 9. `appliesTo` binds
 
 ## Consumers
 
-- `application-dashboard` (visual round T-3): the leaf blueprint the dashboard shell consumes. The dashboard's chart region delegates chart rendering to this blueprint's render shell; the dashboard pack does not duplicate the chart-accessibility ACs, it references them.
+- `application-dashboard` (visual round): the leaf blueprint the dashboard shell consumes. The dashboard's chart region delegates chart rendering to this blueprint's render shell; the dashboard pack does not duplicate the chart-accessibility ACs, it references them.

package/blueprints/application-charts/guide/application-charts.md

@@ -14,7 +14,7 @@ A shipped, vendor-neutral chart-component contract for a rcf-lite application. O
 
 - Any shipped surface that renders bar, line, area, pie, donut, single-value with sparkline, or heatmap charts. Analytics dashboards, admin overview surfaces, per-record trend views, monitoring UIs.
 - Projects that want the ARIA-first, palette-safe, keyboard-reachable discipline enforced at ship without hand-authoring per chart.
-- Any project where the T-3 application-dashboard is applied (charts is the leaf application-dashboard consumes).
+- Any project where the application-dashboard is applied (charts is the leaf application-dashboard consumes).
 
 ## When it does not fit
 
@@ -39,6 +39,6 @@ Every rendered chart on the surface mounts through the render shell; every multi
 - `prefers-reduced-motion` is a real user preference. Do not gate it behind a feature flag or a build variable; the shell handles it via CSS media query on every chart on the surface.
 - A blueprint pack fires on any FBS whose surface matches the `appliesTo` predicate. A page with no chart declares no chart route and the pack records `applicable: false`; no need to disable the pack.
 
-## Ratified spec reference
+## Spec provenance
 
-`projects/blueprint-library/specs/visual-round-spec-2026-09-04.md` section 5.2 in the operator repo names the contract this blueprint realises. Every content decision in the shipped v1.0.0 comes from the spec verbatim; where the shell contract carries a documented deviation from the spec, the blueprint README names it under CALLS MADE.
+The shipped v1.0.0 realises the ratified visual specification for chart components verbatim; where the shell contract carries a documented deviation, the blueprint README names it under the engine-refusal or mechanism-reach sections.