@motion-proto/live-tokens 0.97.0 → 0.99.0

package/src/testing-js/{chunk-GKO27NGN.js → chunk-THWGMSRH.js}

@@ -1,6 +1,6 @@
 import {
   CONTRACTS_MODULE_ENV
-} from "./chunk-SHBYZUPD.js";
+} from "./chunk-RWOT2XDB.js";
 
 // src/testing/vitest.ts
 import path from "path";
@@ -54,4 +54,4 @@ function createVitestConfig(viteConfig, options = {}) {
 export {
   createVitestConfig
 };
-//# sourceMappingURL=chunk-GKO27NGN.js.map
+//# sourceMappingURL=chunk-THWGMSRH.js.map

package/src/testing-js/{chunk-3UKGXCDL.js → chunk-YVVR3GJZ.js}

@@ -45,4 +45,4 @@ export {
   requiresInteraction,
   partLocator
 };
-//# sourceMappingURL=chunk-3UKGXCDL.js.map
+//# sourceMappingURL=chunk-YVVR3GJZ.js.map

package/src/testing-js/chunk-YVVR3GJZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../testing/componentContract.ts"],"sourcesContent":["export type ContractRule =\n  | 'contract-listed'\n  | 'contract-render'\n  | 'contract-alias'\n  | 'contract-persist'\n  | 'contract-theme'\n  | 'contract-states'\n  | 'contract-interaction'\n  | 'contract-behavior'\n  | 'contract-sketch'\n  | 'contract-missing';\n\n/**\n * A failed obligation, carrying the rule id the CLI reports it under. A defect\n * fixture names the rule it expects, and `check-component --tests` maps a\n * reporter error onto a finding.\n */\nexport class ContractViolation extends Error {\n  constructor(\n    readonly rule: ContractRule,\n    readonly component: string,\n    message: string,\n  ) {\n    super(`[${rule}] ${component}: ${message}`);\n    this.name = 'ContractViolation';\n  }\n}\n\nexport interface Inapplicable {\n  applicable: false;\n  reason: string;\n}\n\nexport function isInapplicable(value: unknown): value is Inapplicable {\n  return typeof value === 'object' && value !== null && (value as Inapplicable).applicable === false;\n}\n\nexport interface PartLocator {\n  /** Resolved inside the preview stage unless `portal` is set. */\n  selector: string;\n  /** Read computed style from this pseudo-element of the part, e.g.\n   *  `'::after'`. Chromium's `getComputedStyle` only tolerates the bare form\n   *  (`'after'`) for `::before`/`::after`; use the full `::` syntax so a\n   *  future pseudo-element (`::placeholder`, `::marker`, ...) works the same\n   *  way without a silent fallback to the host element's own style. */\n  pseudo?: string;\n  /** Rendered outside the preview stage. Resolved against the document. */\n  portal?: boolean;\n}\n\nexport type PartDeclaration = string | PartLocator;\n\n/**\n * An editor control the preview is gated behind: a canvas-toolbar checkbox, an\n * optional-content switch. `check` sets a checkbox to a state and is safe to\n * repeat; `value` picks a select option; neither clicks once.\n */\nexport interface ControlStep {\n  kind: 'control';\n  /** Selector inside the visible variant group. */\n  selector: string;\n  check?: boolean;\n  value?: string;\n}\n\nexport type SetupStep = InteractionAction | ControlStep;\n\n/** Which VariantGroup, which state tab, and what has to happen first. */\nexport interface View {\n  /** Variant tab label. Omitted when the editor renders one variant. */\n  variant?: string;\n  /** State tab label. Omitted when the editor renders no state strip. */\n  state?: string;\n  /** Run after the tabs are selected. Portaled and toolbar-gated parts exist\n   *  only once these have run. */\n  setup?: SetupStep[];\n}\n\n/** Part key -> CSS property -> the design token that must drive it. */\nexport type PaintMap = Record<string, Record<string, string>>;\n\nexport interface PropertyExpectation extends View {\n  paints: PaintMap;\n}\n\nexport interface StateExpectation extends View {\n  state: string;\n  /** Class the root part carries while the editor previews this state. */\n  forceClass?: string;\n  /** Part key -> attributes it must carry. A null value requires the absence. */\n  attributes?: Record<string, Record<string, string | null>>;\n  /** What the state repaints, as computed-value equality against its token. */\n  paints?: PaintMap;\n}\n\n/**\n * `token` and `opacity` drive the token selector for `variable`. `gradient`\n * drives the gradient editor for `variable`. `literal` drives `control` and\n * reads `variable` back off the root, which is where an intrinsic lands: the\n * editors write those into the alias bucket. `config` drives `control` and\n * reads `configKey` out of the config bucket, which holds editor metadata that\n * never reaches `:root`.\n */\nexport type PersistenceShape = 'token' | 'literal' | 'opacity' | 'gradient' | 'config';\n\nexport interface PersistenceCase extends View {\n  shape: PersistenceShape;\n  /** The alias the value is read back from. Omitted for `config`. */\n  variable?: string;\n  /** Selector inside the visible variant group, for `literal` and `config`. */\n  control?: string;\n  /** The config-bucket key, for `config`. */\n  configKey?: string;\n  /** Where the persisted value must land once the page has reloaded. */\n  observe: { part: string; css: string };\n}\n\nexport interface PersistenceExpectation {\n  cases: PersistenceCase[];\n  /** The alias Reset must return to the value the server holds for it. It has\n   *  to be one a case above moves, so the saved value and the value the\n   *  component booted with are different and Reset can be seen to choose. */\n  resetVariable: string;\n}\n\nexport interface ThemeExpectation extends View {\n  /** Theme slug shown in the Theme Picker, e.g. `ocean`. */\n  theme: string;\n  /** Variables whose root value the theme must move. */\n  changed: string[];\n  /**\n   * Variables the theme must leave exactly as they were. A theme moves colors,\n   * shadows, font families, and type sizes, and it resolves many color tokens\n   * from its own palette even where two theme files name the same alias, so\n   * compare a candidate's resolved value under both themes before trusting\n   * it. The spacing, radius, and border-width steps (`--space-*`, `--radius-*`,\n   * `--border-width-*`) hold one value in every theme, and a theme assigns\n   * them only to the components it holds a block for, so a new component's\n   * geometry stays put.\n   */\n  unchanged: string[];\n  /** Variables, and the design token each must resolve to under the theme. */\n  aliasedTo: Record<string, string>;\n  /** Where the theme's value must land in the rendered preview. */\n  observe: { part: string; css: string; variable: string };\n}\n\nexport type InteractionAction =\n  /** Without a part the key goes to the element holding focus, such as an\n   *  overlay that took focus as it opened. */\n  | { kind: 'press'; part?: string; key: string }\n  | { kind: 'click'; part: string }\n  | { kind: 'type'; part: string; text: string }\n  | { kind: 'dragTo'; part: string; along: string; fraction: number };\n\nexport type InteractionOutcome =\n  | { kind: 'attribute'; part: string; name: string; value: string }\n  | { kind: 'valueMoves'; part: string; direction: 'up' | 'down' }\n  | { kind: 'valueBecomes'; part: string; value: string }\n  | { kind: 'valueChanges'; part: string }\n  | { kind: 'valueHolds'; part: string }\n  /** Whether the part takes focus. The only outcome a button with no state\n   *  attribute has: a disabled one refuses it and an enabled one takes it. */\n  | { kind: 'focused'; part: string; value: boolean }\n  /** Whether the action fired a click on the part, the event a native button\n   *  sends when Enter or Space activates it. A preview that never feeds a\n   *  controlled component's callback back into its props shows activation\n   *  only this way. */\n  | { kind: 'activated'; part: string }\n  /** Whether the part is in the document, for an overlay a key closes. */\n  | { kind: 'present'; part: string; value: boolean };\n\nexport interface InteractionCase extends View {\n  name: string;\n  action: InteractionAction;\n  expect: InteractionOutcome;\n  /** `a11y-keyboard` records a failure as a keyboard finding at `warn` and\n   *  lets the test pass. Without it a failure is a `contract-interaction`\n   *  error. */\n  rule?: 'a11y-keyboard';\n}\n\nexport interface InteractionExpectation {\n  /** The part carrying the interactive role. */\n  part: string;\n  role: string;\n  cases: InteractionCase[];\n}\n\n/**\n * One mounted case under happy-dom: props in, a DOM event, one assertion. It\n * carries what a browser cannot reach, the callback a controlled component\n * calls instead of moving its own state.\n */\nexport interface BehaviorCase {\n  name: string;\n  /** Props the fixture mounts with. A snippet-valued prop is not\n   *  expressible; a component whose behavior needs one records that case\n   *  as inapplicable with the reason. */\n  props?: Record<string, unknown>;\n  action?: { kind: 'click' | 'keydown' | 'input'; part: string; key?: string; value?: string };\n  expect:\n    | { kind: 'callback'; prop: string; args: unknown[] }\n    | { kind: 'no-callback'; prop: string }\n    | { kind: 'attribute'; part: string; name: string; value: string | null }\n    | { kind: 'text'; part: string; value: string };\n}\n\nexport interface BehaviorExpectation {\n  cases: BehaviorCase[];\n}\n\nexport interface SketchPartExpectation {\n  part: string;\n  /** The design token `--sketch-fill` must resolve to on this part. */\n  fill?: string;\n  /** The design token `--sketch-stroke` must resolve to on this part. */\n  stroke?: string;\n}\n\nexport interface SketchExpectation extends View {\n  /** Sketchstyle id the paint is asserted under. */\n  style: string;\n  parts: SketchPartExpectation[];\n}\n\nexport interface BoundaryExpectation {\n  part: string;\n  label: string;\n  /** A selector the part's element must also match to be measured, such as a\n   *  state class a part shared across states carries in one of them. */\n  when?: string;\n}\n\nexport interface ComponentContract {\n  id: string;\n  origin: 'system' | 'custom';\n  parts: Record<string, PartDeclaration>;\n  /** Part key of the component's own root element in the preview. */\n  root: string;\n  /** The view every obligation opens with. */\n  view?: View;\n  states: StateExpectation[] | Inapplicable;\n  properties: PropertyExpectation[];\n  /**\n   * Aliases no paint map can pin, each with the reason. A token consumed\n   * inside `calc()` or handed to a gradient function never appears verbatim in\n   * a computed style, so the probe cannot read it back — that is the only\n   * class this belongs to. A token a sibling alias merely happens to carry\n   * the same rendered value through (a base padding token behind four\n   * per-side overrides, say) is not in this class: the per-side entries pin\n   * their own aliases, not the base one, and a paint map that drives the base\n   * token directly and observes the per-side CSS property can pin it too. Put\n   * that here and Wave 4's coverage JSON records the base token as covered\n   * when nothing asserts the link between it and what actually painted.\n   */\n  uncovered?: Record<string, string>;\n  persistence: PersistenceExpectation;\n  theme: ThemeExpectation;\n  interaction: InteractionExpectation | Inapplicable;\n  /** The parts whose border, outline or surface draws the control's visible\n   *  edge or marks its selected state. The accessibility suite measures each\n   *  against the backdrop behind it, at 3:1 under WCAG 2.2 SC 1.4.11. `label`\n   *  names the part in a finding. */\n  boundaries?: BoundaryExpectation[];\n  /** What the component does when it is driven, proven under happy-dom. */\n  behavior: BehaviorExpectation | Inapplicable;\n  sketch: SketchExpectation | Inapplicable;\n}\n\n/** Roles whose components must declare interaction cases. */\nconst INTERACTIVE_ROLES = new Set([\n  'button', 'switch', 'checkbox', 'radio', 'slider', 'spinbutton', 'textbox',\n  'combobox', 'listbox', 'menuitem', 'tab', 'link', 'searchbox', 'option',\n]);\n\nexport function requiresInteraction(role: string | null): boolean {\n  return role !== null && INTERACTIVE_ROLES.has(role);\n}\n\nexport function partLocator(contract: ComponentContract, key: string): PartLocator {\n  const declared = contract.parts[key];\n  if (declared === undefined) {\n    throw new ContractViolation('contract-render', contract.id, `no part named \"${key}\" is declared`);\n  }\n  return typeof declared === 'string' ? { selector: declared } : declared;\n}\n"],"mappings":";AAiBO,IAAM,oBAAN,cAAgC,MAAM;AAAA,EAC3C,YACW,MACA,WACT,SACA;AACA,UAAM,IAAI,IAAI,KAAK,SAAS,KAAK,OAAO,EAAE;AAJjC;AACA;AAIT,SAAK,OAAO;AAAA,EACd;AAAA,EANW;AAAA,EACA;AAMb;AAOO,SAAS,eAAe,OAAuC;AACpE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAS,MAAuB,eAAe;AAC/F;AA4OA,IAAM,oBAAoB,oBAAI,IAAI;AAAA,EAChC;AAAA,EAAU;AAAA,EAAU;AAAA,EAAY;AAAA,EAAS;AAAA,EAAU;AAAA,EAAc;AAAA,EACjE;AAAA,EAAY;AAAA,EAAW;AAAA,EAAY;AAAA,EAAO;AAAA,EAAQ;AAAA,EAAa;AACjE,CAAC;AAEM,SAAS,oBAAoB,MAA8B;AAChE,SAAO,SAAS,QAAQ,kBAAkB,IAAI,IAAI;AACpD;AAEO,SAAS,YAAY,UAA6B,KAA0B;AACjF,QAAM,WAAW,SAAS,MAAM,GAAG;AACnC,MAAI,aAAa,QAAW;AAC1B,UAAM,IAAI,kBAAkB,mBAAmB,SAAS,IAAI,kBAAkB,GAAG,eAAe;AAAA,EAClG;AACA,SAAO,OAAO,aAAa,WAAW,EAAE,UAAU,SAAS,IAAI;AACjE;","names":[]}

package/src/testing-js/component-a11y.contract.js

@@ -0,0 +1,313 @@
+import {
+  ContractHarness
+} from "./chunk-7QXUJRSO.js";
+import "./chunk-3WCLMOM7.js";
+import {
+  scanReducedMotion,
+  scanTextSpacing
+} from "./chunk-GZKUYLDW.js";
+import {
+  TRACE_AXES,
+  missingEngine,
+  recordA11y,
+  scanAxe,
+  scanBoundaries,
+  scanFocusIndicators,
+  scanFocusVisible,
+  traceProperties
+} from "./chunk-RTZQLW3F.js";
+import {
+  A11Y_THEMES_ENV,
+  UPDATE_ARIA_ENV
+} from "./chunk-7CM5D7PF.js";
+import {
+  isInapplicable,
+  partLocator
+} from "./chunk-YVVR3GJZ.js";
+import {
+  selectedContracts
+} from "./chunk-RWOT2XDB.js";
+
+// src/testing/component-a11y.contract.ts
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { test } from "@playwright/test";
+test.describe.configure({ mode: "parallel" });
+var PRESETS = ["autumn", "halloween", "midnight-study", "ocean", "royal-velvet", "sketchy", "spring-meadow", "sunset"];
+var STAGE_ATTR = "data-lt-a11y-stage";
+var TREE_ATTR = "data-lt-a11y-tree";
+var SCOPE = `[${STAGE_ATTR}]`;
+var EXCLUDE = [`${SCOPE} .canvas-toolbar`, "[data-preview-demo]"];
+var PRESET_RULES = ["color-contrast"];
+var VIEW_LIMIT = 4;
+var DIFF_LIMIT = 600;
+var ARIA_HELP_URL = "https://playwright.dev/docs/aria-snapshots";
+var STAGE_CSS = `
+.tabs-preview::after { display: none !important; }
+.preview-stage, .preview-stage .shadow-backdrop { background: var(--page-bg) !important; }
+`;
+var here = path.dirname(fileURLToPath(import.meta.url));
+var compiled = path.basename(here) === "testing-js";
+var sourceAria = path.resolve(here, compiled ? "../testing/contracts/__aria__" : "contracts/__aria__");
+var ARIA_DIR = !compiled || fs.existsSync(sourceAria) ? sourceAria : path.join(here, "__aria__");
+var ARIA_WRITABLE = !ARIA_DIR.split(path.sep).includes("node_modules");
+function describeStep(step) {
+  if (step.kind === "control") {
+    if (step.value !== void 0) return step.value;
+    const named = /:has-text\("([^"]+)"\)/.exec(step.selector)?.[1] ?? step.selector;
+    if (step.check !== void 0) return `${named} ${step.check ? "on" : "off"}`;
+    return named;
+  }
+  if (step.kind === "press") return step.part ? `${step.key} on ${step.part}` : step.key;
+  return `${step.kind} ${step.part}`;
+}
+function viewsOf(contract) {
+  const declared = [...contract.properties, ...isInapplicable(contract.states) ? [] : contract.states];
+  const byKey = /* @__PURE__ */ new Map();
+  const labels = /* @__PURE__ */ new Set();
+  for (const view of declared.length > 0 ? declared : [{}]) {
+    const merged = { ...contract.view, ...view };
+    const key = JSON.stringify([merged.variant ?? "", merged.state ?? "", merged.setup ?? []]);
+    if (byKey.has(key)) continue;
+    const own = view.setup?.length ? ` (${view.setup.map(describeStep).join(", ")})` : "";
+    const base = `${[merged.variant, merged.state].filter(Boolean).join(" / ") || "preview"}${own}`;
+    let label = base;
+    for (let n = 2; labels.has(label); n++) label = `${base} #${n}`;
+    labels.add(label);
+    byKey.set(key, { label, view });
+  }
+  return [...byKey.values()];
+}
+function viewGroups(contract) {
+  const views = viewsOf(contract);
+  return {
+    plain: views.filter(({ view }) => !view.setup?.length),
+    setUp: views.filter(({ view }) => view.setup?.length)
+  };
+}
+function portalSelectors(contract) {
+  return Object.keys(contract.parts).map((key) => partLocator(contract, key)).filter((part) => part.portal).map((part) => part.selector);
+}
+var LIFTED_ATTR = "data-lt-a11y-lifted";
+function forcedClass(contract, view) {
+  if (isInapplicable(contract.states)) return void 0;
+  const variant = view.variant ?? contract.view?.variant;
+  return contract.states.find((s) => s.state === view.state && (s.variant ?? contract.view?.variant) === variant)?.forceClass;
+}
+async function withoutForcedState(page, forceClass, fn) {
+  if (!forceClass) return fn();
+  await page.evaluate(({ scope, forceClass: forceClass2, attr }) => {
+    for (const stage of document.querySelectorAll(scope)) {
+      for (const el of [stage, ...stage.querySelectorAll(`.${forceClass2}`)]) {
+        if (!el.classList.contains(forceClass2)) continue;
+        el.classList.remove(forceClass2);
+        el.setAttribute(attr, forceClass2);
+      }
+    }
+  }, { scope: SCOPE, forceClass, attr: LIFTED_ATTR });
+  try {
+    await fn();
+  } finally {
+    await page.evaluate((attr) => {
+      for (const el of document.querySelectorAll(`[${attr}]`)) {
+        el.classList.add(el.getAttribute(attr));
+        el.removeAttribute(attr);
+      }
+    }, LIFTED_ATTR);
+  }
+}
+async function markStage(page, portals) {
+  await page.evaluate(({ stageAttr, treeAttr, portals: portals2 }) => {
+    for (const element of document.querySelectorAll(`[${stageAttr}], [${treeAttr}]`)) {
+      element.removeAttribute(stageAttr);
+      element.removeAttribute(treeAttr);
+    }
+    const group = [...document.querySelectorAll(".variant-group")].find((g) => g.checkVisibility());
+    const stage = group?.querySelector(".preview-stage, .sketch-scope");
+    if (!group || !stage) throw new Error("the visible variant group has no preview stage");
+    stage.setAttribute(stageAttr, "");
+    stage.scrollIntoView({ block: "nearest" });
+    group.querySelector(".sketch-scope")?.setAttribute(treeAttr, "");
+    for (const selector of portals2) {
+      for (const element of document.querySelectorAll(selector)) {
+        if (element.closest(`[${stageAttr}]`)) continue;
+        element.setAttribute(stageAttr, "");
+        element.setAttribute(treeAttr, "");
+      }
+    }
+  }, { stageAttr: STAGE_ATTR, treeAttr: TREE_ATTR, portals });
+}
+async function readTree(page) {
+  const roots = page.locator(`[${TREE_ATTR}]`);
+  const trees = [];
+  for (let i = 0; i < await roots.count(); i++) trees.push(await roots.nth(i).ariaSnapshot());
+  return trees.filter(Boolean).join("\n");
+}
+function serializeTrees(trees) {
+  return [...trees].map(([label, tree]) => tree ? `${JSON.stringify(label)}: |
+${tree.split("\n").map((line) => `  ${line}`).join("\n")}
+` : `${JSON.stringify(label)}: ""
+`).join("");
+}
+function parseTrees(text) {
+  const trees = /* @__PURE__ */ new Map();
+  let label = null;
+  let lines = [];
+  const flush = () => {
+    if (label !== null) trees.set(label, lines.join("\n"));
+  };
+  for (const line of text.split("\n")) {
+    const key = /^(".*"): (?:\||"")$/.exec(line);
+    if (key) {
+      flush();
+      label = JSON.parse(key[1]);
+      lines = [];
+    } else if (line.startsWith("  ")) {
+      lines.push(line.slice(2));
+    }
+  }
+  flush();
+  return trees;
+}
+function lineChanges(before, after) {
+  const added = after.split("\n");
+  const removed = [];
+  for (const line of before.split("\n")) {
+    const index = added.indexOf(line);
+    if (index >= 0) added.splice(index, 1);
+    else removed.push(line);
+  }
+  return { removed, added };
+}
+function describeChange(before, after) {
+  if (before === void 0) return "The view has no recorded accessibility tree";
+  if (after === void 0) return "The recorded accessibility tree names a view the contract no longer declares";
+  const { removed, added } = lineChanges(before, after);
+  const quote = (lines) => lines.length === 0 ? "nothing" : lines.slice(0, 2).map((line) => `\`${line.trim()}\``).join(", ") + (lines.length > 2 ? ` and ${lines.length - 2} more` : "");
+  return `The accessibility tree differs from the recorded one: recorded ${quote(removed)}, now ${quote(added)}`;
+}
+function listViews(views) {
+  return [...views.slice(0, VIEW_LIMIT), ...views.length > VIEW_LIMIT ? [`and ${views.length - VIEW_LIMIT} more`] : []].join("; ");
+}
+function compareTrees(id, trees) {
+  const file = path.join(ARIA_DIR, `${id}.yml`);
+  if (process.env[UPDATE_ARIA_ENV] === "1" || !fs.existsSync(file)) {
+    if (ARIA_WRITABLE) {
+      fs.mkdirSync(ARIA_DIR, { recursive: true });
+      fs.writeFileSync(file, serializeTrees(trees));
+    }
+    return [];
+  }
+  const recorded = parseTrees(fs.readFileSync(file, "utf8"));
+  const changes = /* @__PURE__ */ new Map();
+  for (const label of /* @__PURE__ */ new Set([...recorded.keys(), ...trees.keys()])) {
+    const before = recorded.get(label);
+    const after = trees.get(label);
+    if (before === after) continue;
+    const help = describeChange(before, after);
+    const { removed, added } = lineChanges(before ?? "", after ?? "");
+    let change = changes.get(help);
+    if (!change) {
+      const diff = [...removed.map((line) => `-${line}`), ...added.map((line) => `+${line}`)].join("\n");
+      changes.set(help, change = { diff, views: [] });
+    }
+    change.views.push(label);
+  }
+  return [...changes].map(([help, { diff, views }]) => ({
+    rule: "a11y-component",
+    engineRule: "aria-snapshot",
+    impact: null,
+    target: `__aria__/${id}.yml`,
+    html: diff.slice(0, DIFF_LIMIT),
+    help: `${help}. Rerun with --update-aria once the change is deliberate`,
+    helpUrl: ARIA_HELP_URL,
+    view: listViews(views)
+  }));
+}
+var Occurrences = class {
+  constructor(trace) {
+    this.trace = trace;
+  }
+  trace;
+  entries = /* @__PURE__ */ new Map();
+  async add(view, results) {
+    for (const item of results) {
+      const { result, trace } = "result" in item ? item : { result: item, trace: void 0 };
+      const key = [result.rule, result.engineRule, result.target].join("\n");
+      let entry = this.entries.get(key);
+      if (!entry) {
+        const variables = await this.trace(result, trace);
+        this.entries.set(key, entry = { result: variables.length > 0 ? { ...result, variables } : result, views: [] });
+      }
+      if (!entry.views.includes(view)) entry.views.push(view);
+    }
+  }
+  results() {
+    return [...this.entries.values()].map(({ result, views }) => ({ ...result, view: listViews(views) }));
+  }
+};
+for (const contract of await selectedContracts()) {
+  test(`${contract.id} records its accessibility findings in every variant and state`, async ({ page }) => {
+    test.setTimeout(10 * 6e4);
+    const missing = await missingEngine(["axe", "alfa"]);
+    if (missing) {
+      test.info().annotations.push({ type: "inapplicable", description: missing });
+      return;
+    }
+    const harness = await ContractHarness.open(page, contract);
+    await page.addStyleTag({ content: STAGE_CSS });
+    const { plain, setUp } = viewGroups(contract);
+    const portals = portalSelectors(contract);
+    const presets = process.env[A11Y_THEMES_ENV] === "all" ? PRESETS : [];
+    const known = await harness.propertyVariables();
+    const boundaries = (contract.boundaries ?? []).map(({ part, label, when }) => ({ selector: partLocator(contract, part).selector, label, when }));
+    const root = partLocator(contract, contract.root).selector;
+    const own = [root, ...portals];
+    const found = new Occurrences(async (result, request) => {
+      const axes = TRACE_AXES[result.engineRule];
+      return axes ? traceProperties(page, { selector: result.target, scope: SCOPE, ...request }, axes, known) : [];
+    });
+    const scanFocus = (view, label, withAlfa) => withoutForcedState(page, forcedClass(contract, view), async () => {
+      await found.add(label, await scanFocusIndicators(page, SCOPE, EXCLUDE));
+      if (withAlfa) await found.add(label, await scanFocusVisible(page, SCOPE, EXCLUDE));
+    });
+    const trees = /* @__PURE__ */ new Map();
+    const scan = async ({ label, view }) => {
+      await harness.selectView(view);
+      await markStage(page, portals);
+      await found.add(label, await scanAxe(page, SCOPE, EXCLUDE, "a11y-component"));
+      await scanFocus(view, label, true);
+      await found.add(label, await scanBoundaries(page, SCOPE, EXCLUDE, boundaries, root));
+      trees.set(label, await readTree(page));
+      await found.add(label, await scanTextSpacing(page, SCOPE, EXCLUDE, own));
+      await found.add(label, await scanReducedMotion(page, SCOPE, EXCLUDE, own));
+    };
+    const scanContrast = async ({ label, view }, theme) => {
+      const themed = `${label} under ${theme}`;
+      await markStage(page, portals);
+      await found.add(themed, await scanAxe(page, SCOPE, EXCLUDE, "a11y-component", PRESET_RULES));
+      await scanFocus(view, themed, false);
+      await found.add(themed, await scanBoundaries(page, SCOPE, EXCLUDE, boundaries, root));
+    };
+    for (const scanView of plain) await scan(scanView);
+    for (const theme of presets) {
+      await harness.previewThemeUncovered(theme);
+      for (const scanView of plain) {
+        await harness.selectView(scanView.view);
+        await scanContrast(scanView, theme);
+      }
+      await harness.cancelUncoveredPreview();
+    }
+    for (const scanView of setUp) {
+      await scan(scanView);
+      for (const theme of presets) {
+        await harness.previewThemeUncovered(theme);
+        await scanContrast(scanView, theme);
+        await harness.cancelUncoveredPreview();
+      }
+    }
+    recordA11y([...found.results(), ...compareTrees(contract.id, trees)]);
+  });
+}
+//# sourceMappingURL=component-a11y.contract.js.map

package/src/testing-js/component-a11y.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../testing/component-a11y.contract.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { test, type Page } from '@playwright/test';\nimport {\n  isInapplicable,\n  partLocator,\n  type ComponentContract,\n  type SetupStep,\n  type View,\n} from './componentContract';\nimport { A11Y_THEMES_ENV, UPDATE_ARIA_ENV } from './config';\nimport { selectedContracts } from './contracts';\nimport { missingEngine, recordA11y, scanAxe, scanFocusVisible, type A11yResult } from './support/a11y';\nimport { ContractHarness } from './support/contractHarness';\nimport { scanBoundaries, scanFocusIndicators, type CheckedResult, type TraceRequest } from './support/nonTextContrast';\nimport { scanReducedMotion, scanTextSpacing } from './support/textSpacingAndMotion';\nimport { TRACE_AXES, traceProperties } from './support/traceProperties';\n\n// Each test opens its own editor and only reads the preview, so the\n// components scan side by side.\ntest.describe.configure({ mode: 'parallel' });\n\nconst PRESETS = ['autumn', 'halloween', 'midnight-study', 'ocean', 'royal-velvet', 'sketchy', 'spring-meadow', 'sunset'];\n\nconst STAGE_ATTR = 'data-lt-a11y-stage';\nconst TREE_ATTR = 'data-lt-a11y-tree';\nconst SCOPE = `[${STAGE_ATTR}]`;\nconst EXCLUDE = [`${SCOPE} .canvas-toolbar`, '[data-preview-demo]'];\n\n// The Wave 0 probe found every other axe rule, and SIA-R65, reporting the\n// same nodes under all nine themes. The non-text contrast checks measure\n// colour, so they run under each preset too.\nconst PRESET_RULES = ['color-contrast'];\n\nconst VIEW_LIMIT = 4;\nconst DIFF_LIMIT = 600;\nconst ARIA_HELP_URL = 'https://playwright.dev/docs/aria-snapshots';\n\n// axe returns every text node under the sticky band's full-size fade as\n// incomplete, and the default backdrop paints an editor colour no theme moves.\nconst STAGE_CSS = `\n.tabs-preview::after { display: none !important; }\n.preview-stage, .preview-stage .shadow-backdrop { background: var(--page-bg) !important; }\n`;\n\nconst here = path.dirname(fileURLToPath(import.meta.url));\nconst compiled = path.basename(here) === 'testing-js';\nconst sourceAria = path.resolve(here, compiled ? '../testing/contracts/__aria__' : 'contracts/__aria__');\n// A tarball ships the compiled suite alone, with the recorded trees copied\n// beside it; the repository's compiled suite still reads and writes the source.\nconst ARIA_DIR = !compiled || fs.existsSync(sourceAria) ? sourceAria : path.join(here, '__aria__');\nconst ARIA_WRITABLE = !ARIA_DIR.split(path.sep).includes('node_modules');\n\ninterface ScanView {\n  label: string;\n  view: View;\n}\n\nfunction describeStep(step: SetupStep): string {\n  if (step.kind === 'control') {\n    if (step.value !== undefined) return step.value;\n    const named = /:has-text\\(\"([^\"]+)\"\\)/.exec(step.selector)?.[1] ?? step.selector;\n    if (step.check !== undefined) return `${named} ${step.check ? 'on' : 'off'}`;\n    return named;\n  }\n  if (step.kind === 'press') return step.part ? `${step.key} on ${step.part}` : step.key;\n  return `${step.kind} ${step.part}`;\n}\n\n/** Every variant and state pair the contract's properties and states name,\n *  once each, in the order the contract declares them. */\nfunction viewsOf(contract: ComponentContract): ScanView[] {\n  const declared: View[] = [...contract.properties, ...(isInapplicable(contract.states) ? [] : contract.states)];\n  const byKey = new Map<string, ScanView>();\n  const labels = new Set<string>();\n  for (const view of declared.length > 0 ? declared : [{}]) {\n    const merged = { ...contract.view, ...view };\n    const key = JSON.stringify([merged.variant ?? '', merged.state ?? '', merged.setup ?? []]);\n    if (byKey.has(key)) continue;\n    const own = view.setup?.length ? ` (${view.setup.map(describeStep).join(', ')})` : '';\n    const base = `${[merged.variant, merged.state].filter(Boolean).join(' / ') || 'preview'}${own}`;\n    let label = base;\n    for (let n = 2; labels.has(label); n++) label = `${base} #${n}`;\n    labels.add(label);\n    byKey.set(key, { label, view });\n  }\n  return [...byKey.values()];\n}\n\n/** Plain views select their tabs again under each preset. A view with a\n *  setup of its own is selected once and scanned with every preset previewed\n *  over it: a toolbar control the setup sets, such as Button's Small size,\n *  stays set and hides the tabs a second selection would click. */\nfunction viewGroups(contract: ComponentContract): { plain: ScanView[]; setUp: ScanView[] } {\n  const views = viewsOf(contract);\n  return {\n    plain: views.filter(({ view }) => !view.setup?.length),\n    setUp: views.filter(({ view }) => view.setup?.length),\n  };\n}\n\nfunction portalSelectors(contract: ComponentContract): string[] {\n  return Object.keys(contract.parts)\n    .map((key) => partLocator(contract, key))\n    .filter((part) => part.portal)\n    .map((part) => part.selector);\n}\n\nconst LIFTED_ATTR = 'data-lt-a11y-lifted';\n\n/** The class the editor puts on the preview for the view's state. A property\n *  view shares its state tab with the contract's state entry, which names it. */\nfunction forcedClass(contract: ComponentContract, view: View): string | undefined {\n  if (isInapplicable(contract.states)) return undefined;\n  const variant = view.variant ?? contract.view?.variant;\n  return contract.states.find((s) => s.state === view.state && (s.variant ?? contract.view?.variant) === variant)?.forceClass;\n}\n\n/** Runs `fn` with `forceClass` taken off the stage. A state such as Input's\n *  focused one paints its look at rest, which would leave focus nothing to\n *  change. */\nasync function withoutForcedState(page: Page, forceClass: string | undefined, fn: () => Promise<void>): Promise<void> {\n  if (!forceClass) return fn();\n  await page.evaluate(({ scope, forceClass, attr }) => {\n    for (const stage of document.querySelectorAll(scope)) {\n      for (const el of [stage, ...stage.querySelectorAll(`.${forceClass}`)]) {\n        if (!el.classList.contains(forceClass)) continue;\n        el.classList.remove(forceClass);\n        el.setAttribute(attr, forceClass);\n      }\n    }\n  }, { scope: SCOPE, forceClass, attr: LIFTED_ATTR });\n  try {\n    await fn();\n  } finally {\n    await page.evaluate((attr) => {\n      for (const el of document.querySelectorAll(`[${attr}]`)) {\n        el.classList.add(el.getAttribute(attr)!);\n        el.removeAttribute(attr);\n      }\n    }, LIFTED_ATTR);\n  }\n}\n\n/** Marks the visible stage and every portaled part, so both engines scope to\n *  one selector, and the component's own tree for the snapshot. */\nasync function markStage(page: Page, portals: string[]): Promise<void> {\n  await page.evaluate(({ stageAttr, treeAttr, portals }) => {\n    for (const element of document.querySelectorAll(`[${stageAttr}], [${treeAttr}]`)) {\n      element.removeAttribute(stageAttr);\n      element.removeAttribute(treeAttr);\n    }\n    const group = [...document.querySelectorAll<HTMLElement>('.variant-group')].find((g) => g.checkVisibility());\n    const stage = group?.querySelector('.preview-stage, .sketch-scope');\n    if (!group || !stage) throw new Error('the visible variant group has no preview stage');\n    stage.setAttribute(stageAttr, '');\n    stage.scrollIntoView({ block: 'nearest' });\n    group.querySelector('.sketch-scope')?.setAttribute(treeAttr, '');\n    for (const selector of portals) {\n      for (const element of document.querySelectorAll(selector)) {\n        if (element.closest(`[${stageAttr}]`)) continue;\n        element.setAttribute(stageAttr, '');\n        element.setAttribute(treeAttr, '');\n      }\n    }\n  }, { stageAttr: STAGE_ATTR, treeAttr: TREE_ATTR, portals });\n}\n\nasync function readTree(page: Page): Promise<string> {\n  const roots = page.locator(`[${TREE_ATTR}]`);\n  const trees: string[] = [];\n  for (let i = 0; i < await roots.count(); i++) trees.push(await roots.nth(i).ariaSnapshot());\n  return trees.filter(Boolean).join('\\n');\n}\n\nfunction serializeTrees(trees: Map<string, string>): string {\n  return [...trees].map(([label, tree]) => tree\n    ? `${JSON.stringify(label)}: |\\n${tree.split('\\n').map((line) => `  ${line}`).join('\\n')}\\n`\n    : `${JSON.stringify(label)}: \"\"\\n`).join('');\n}\n\nfunction parseTrees(text: string): Map<string, string> {\n  const trees = new Map<string, string>();\n  let label: string | null = null;\n  let lines: string[] = [];\n  const flush = () => {\n    if (label !== null) trees.set(label, lines.join('\\n'));\n  };\n  for (const line of text.split('\\n')) {\n    const key = /^(\".*\"): (?:\\||\"\")$/.exec(line);\n    if (key) {\n      flush();\n      label = JSON.parse(key[1]) as string;\n      lines = [];\n    } else if (line.startsWith('  ')) {\n      lines.push(line.slice(2));\n    }\n  }\n  flush();\n  return trees;\n}\n\nfunction lineChanges(before: string, after: string): { removed: string[]; added: string[] } {\n  const added = after.split('\\n');\n  const removed: string[] = [];\n  for (const line of before.split('\\n')) {\n    const index = added.indexOf(line);\n    if (index >= 0) added.splice(index, 1);\n    else removed.push(line);\n  }\n  return { removed, added };\n}\n\nfunction describeChange(before: string | undefined, after: string | undefined): string {\n  if (before === undefined) return 'The view has no recorded accessibility tree';\n  if (after === undefined) return 'The recorded accessibility tree names a view the contract no longer declares';\n  const { removed, added } = lineChanges(before, after);\n  const quote = (lines: string[]) => lines.length === 0 ? 'nothing' : lines.slice(0, 2).map((line) => `\\`${line.trim()}\\``).join(', ')\n    + (lines.length > 2 ? ` and ${lines.length - 2} more` : '');\n  return `The accessibility tree differs from the recorded one: recorded ${quote(removed)}, now ${quote(added)}`;\n}\n\nfunction listViews(views: string[]): string {\n  return [...views.slice(0, VIEW_LIMIT), ...(views.length > VIEW_LIMIT ? [`and ${views.length - VIEW_LIMIT} more`] : [])]\n    .join('; ');\n}\n\n/** Decision 12: each view's tree beside the one recorded for it, one result\n *  per distinct change. A missing file, or `--update-aria`, records the trees\n *  instead. */\nfunction compareTrees(id: string, trees: Map<string, string>): A11yResult[] {\n  const file = path.join(ARIA_DIR, `${id}.yml`);\n  if (process.env[UPDATE_ARIA_ENV] === '1' || !fs.existsSync(file)) {\n    if (ARIA_WRITABLE) {\n      fs.mkdirSync(ARIA_DIR, { recursive: true });\n      fs.writeFileSync(file, serializeTrees(trees));\n    }\n    return [];\n  }\n  const recorded = parseTrees(fs.readFileSync(file, 'utf8'));\n  const changes = new Map<string, { diff: string; views: string[] }>();\n  for (const label of new Set([...recorded.keys(), ...trees.keys()])) {\n    const before = recorded.get(label);\n    const after = trees.get(label);\n    if (before === after) continue;\n    const help = describeChange(before, after);\n    const { removed, added } = lineChanges(before ?? '', after ?? '');\n    let change = changes.get(help);\n    if (!change) {\n      const diff = [...removed.map((line) => `-${line}`), ...added.map((line) => `+${line}`)].join('\\n');\n      changes.set(help, (change = { diff, views: [] }));\n    }\n    change.views.push(label);\n  }\n  return [...changes].map(([help, { diff, views }]) => ({\n    rule: 'a11y-component',\n    engineRule: 'aria-snapshot',\n    impact: null,\n    target: `__aria__/${id}.yml`,\n    html: diff.slice(0, DIFF_LIMIT),\n    help: `${help}. Rerun with --update-aria once the change is deliberate`,\n    helpUrl: ARIA_HELP_URL,\n    view: listViews(views),\n  }));\n}\n\n/** One result per element and engine rule, naming every view it failed in.\n *  A result traces once, the first time it appears, while its view is on\n *  screen (decision 4). */\nclass Occurrences {\n  private readonly entries = new Map<string, { result: A11yResult; views: string[] }>();\n\n  constructor(private readonly trace: (result: A11yResult, request?: TraceRequest) => Promise<string[]>) {}\n\n  async add(view: string, results: (A11yResult | CheckedResult)[]): Promise<void> {\n    for (const item of results) {\n      const { result, trace } = 'result' in item ? item : { result: item, trace: undefined };\n      const key = [result.rule, result.engineRule, result.target].join('\\n');\n      let entry = this.entries.get(key);\n      if (!entry) {\n        const variables = await this.trace(result, trace);\n        this.entries.set(key, (entry = { result: variables.length > 0 ? { ...result, variables } : result, views: [] }));\n      }\n      if (!entry.views.includes(view)) entry.views.push(view);\n    }\n  }\n\n  results(): A11yResult[] {\n    return [...this.entries.values()].map(({ result, views }) => ({ ...result, view: listViews(views) }));\n  }\n}\n\nfor (const contract of await selectedContracts()) {\n  test(`${contract.id} records its accessibility findings in every variant and state`, async ({ page }) => {\n    test.setTimeout(10 * 60_000);\n    const missing = await missingEngine(['axe', 'alfa']);\n    if (missing) {\n      test.info().annotations.push({ type: 'inapplicable', description: missing });\n      return;\n    }\n\n    const harness = await ContractHarness.open(page, contract);\n    await page.addStyleTag({ content: STAGE_CSS });\n    const { plain, setUp } = viewGroups(contract);\n    const portals = portalSelectors(contract);\n    const presets = process.env[A11Y_THEMES_ENV] === 'all' ? PRESETS : [];\n    const known = await harness.propertyVariables();\n    const boundaries = (contract.boundaries ?? []).map(({ part, label, when }) => ({ selector: partLocator(contract, part).selector, label, when }));\n    const root = partLocator(contract, contract.root).selector;\n    const own = [root, ...portals];\n    const found = new Occurrences(async (result, request) => {\n      const axes = TRACE_AXES[result.engineRule];\n      return axes ? traceProperties(page, { selector: result.target, scope: SCOPE, ...request }, axes, known) : [];\n    });\n    // The focus probe runs before SIA-R65, which reads the marks it leaves on\n    // elements whose ring a sibling draws.\n    const scanFocus = (view: View, label: string, withAlfa: boolean) =>\n      withoutForcedState(page, forcedClass(contract, view), async () => {\n        await found.add(label, await scanFocusIndicators(page, SCOPE, EXCLUDE));\n        if (withAlfa) await found.add(label, await scanFocusVisible(page, SCOPE, EXCLUDE));\n      });\n    const trees = new Map<string, string>();\n\n    const scan = async ({ label, view }: ScanView) => {\n      await harness.selectView(view);\n      await markStage(page, portals);\n      await found.add(label, await scanAxe(page, SCOPE, EXCLUDE, 'a11y-component'));\n      await scanFocus(view, label, true);\n      await found.add(label, await scanBoundaries(page, SCOPE, EXCLUDE, boundaries, root));\n      trees.set(label, await readTree(page));\n      await found.add(label, await scanTextSpacing(page, SCOPE, EXCLUDE, own));\n      await found.add(label, await scanReducedMotion(page, SCOPE, EXCLUDE, own));\n    };\n    const scanContrast = async ({ label, view }: ScanView, theme: string) => {\n      const themed = `${label} under ${theme}`;\n      await markStage(page, portals);\n      await found.add(themed, await scanAxe(page, SCOPE, EXCLUDE, 'a11y-component', PRESET_RULES));\n      await scanFocus(view, themed, false);\n      await found.add(themed, await scanBoundaries(page, SCOPE, EXCLUDE, boundaries, root));\n    };\n\n    for (const scanView of plain) await scan(scanView);\n    for (const theme of presets) {\n      await harness.previewThemeUncovered(theme);\n      for (const scanView of plain) {\n        await harness.selectView(scanView.view);\n        await scanContrast(scanView, theme);\n      }\n      await harness.cancelUncoveredPreview();\n    }\n    for (const scanView of setUp) {\n      await scan(scanView);\n      for (const theme of presets) {\n        await harness.previewThemeUncovered(theme);\n        await scanContrast(scanView, theme);\n        await harness.cancelUncoveredPreview();\n      }\n    }\n\n    recordA11y([...found.results(), ...compareTrees(contract.id, trees)]);\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAC9B,SAAS,YAAuB;AAkBhC,KAAK,SAAS,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,IAAM,UAAU,CAAC,UAAU,aAAa,kBAAkB,SAAS,gBAAgB,WAAW,iBAAiB,QAAQ;AAEvH,IAAM,aAAa;AACnB,IAAM,YAAY;AAClB,IAAM,QAAQ,IAAI,UAAU;AAC5B,IAAM,UAAU,CAAC,GAAG,KAAK,oBAAoB,qBAAqB;AAKlE,IAAM,eAAe,CAAC,gBAAgB;AAEtC,IAAM,aAAa;AACnB,IAAM,aAAa;AACnB,IAAM,gBAAgB;AAItB,IAAM,YAAY;AAAA;AAAA;AAAA;AAKlB,IAAM,OAAO,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AACxD,IAAM,WAAW,KAAK,SAAS,IAAI,MAAM;AACzC,IAAM,aAAa,KAAK,QAAQ,MAAM,WAAW,kCAAkC,oBAAoB;AAGvG,IAAM,WAAW,CAAC,YAAY,GAAG,WAAW,UAAU,IAAI,aAAa,KAAK,KAAK,MAAM,UAAU;AACjG,IAAM,gBAAgB,CAAC,SAAS,MAAM,KAAK,GAAG,EAAE,SAAS,cAAc;AAOvE,SAAS,aAAa,MAAyB;AAC7C,MAAI,KAAK,SAAS,WAAW;AAC3B,QAAI,KAAK,UAAU,OAAW,QAAO,KAAK;AAC1C,UAAM,QAAQ,yBAAyB,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,KAAK;AACxE,QAAI,KAAK,UAAU,OAAW,QAAO,GAAG,KAAK,IAAI,KAAK,QAAQ,OAAO,KAAK;AAC1E,WAAO;AAAA,EACT;AACA,MAAI,KAAK,SAAS,QAAS,QAAO,KAAK,OAAO,GAAG,KAAK,GAAG,OAAO,KAAK,IAAI,KAAK,KAAK;AACnF,SAAO,GAAG,KAAK,IAAI,IAAI,KAAK,IAAI;AAClC;AAIA,SAAS,QAAQ,UAAyC;AACxD,QAAM,WAAmB,CAAC,GAAG,SAAS,YAAY,GAAI,eAAe,SAAS,MAAM,IAAI,CAAC,IAAI,SAAS,MAAO;AAC7G,QAAM,QAAQ,oBAAI,IAAsB;AACxC,QAAM,SAAS,oBAAI,IAAY;AAC/B,aAAW,QAAQ,SAAS,SAAS,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;AACxD,UAAM,SAAS,EAAE,GAAG,SAAS,MAAM,GAAG,KAAK;AAC3C,UAAM,MAAM,KAAK,UAAU,CAAC,OAAO,WAAW,IAAI,OAAO,SAAS,IAAI,OAAO,SAAS,CAAC,CAAC,CAAC;AACzF,QAAI,MAAM,IAAI,GAAG,EAAG;AACpB,UAAM,MAAM,KAAK,OAAO,SAAS,KAAK,KAAK,MAAM,IAAI,YAAY,EAAE,KAAK,IAAI,CAAC,MAAM;AACnF,UAAM,OAAO,GAAG,CAAC,OAAO,SAAS,OAAO,KAAK,EAAE,OAAO,OAAO,EAAE,KAAK,KAAK,KAAK,SAAS,GAAG,GAAG;AAC7F,QAAI,QAAQ;AACZ,aAAS,IAAI,GAAG,OAAO,IAAI,KAAK,GAAG,IAAK,SAAQ,GAAG,IAAI,KAAK,CAAC;AAC7D,WAAO,IAAI,KAAK;AAChB,UAAM,IAAI,KAAK,EAAE,OAAO,KAAK,CAAC;AAAA,EAChC;AACA,SAAO,CAAC,GAAG,MAAM,OAAO,CAAC;AAC3B;AAMA,SAAS,WAAW,UAAuE;AACzF,QAAM,QAAQ,QAAQ,QAAQ;AAC9B,SAAO;AAAA,IACL,OAAO,MAAM,OAAO,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,OAAO,MAAM;AAAA,IACrD,OAAO,MAAM,OAAO,CAAC,EAAE,KAAK,MAAM,KAAK,OAAO,MAAM;AAAA,EACtD;AACF;AAEA,SAAS,gBAAgB,UAAuC;AAC9D,SAAO,OAAO,KAAK,SAAS,KAAK,EAC9B,IAAI,CAAC,QAAQ,YAAY,UAAU,GAAG,CAAC,EACvC,OAAO,CAAC,SAAS,KAAK,MAAM,EAC5B,IAAI,CAAC,SAAS,KAAK,QAAQ;AAChC;AAEA,IAAM,cAAc;AAIpB,SAAS,YAAY,UAA6B,MAAgC;AAChF,MAAI,eAAe,SAAS,MAAM,EAAG,QAAO;AAC5C,QAAM,UAAU,KAAK,WAAW,SAAS,MAAM;AAC/C,SAAO,SAAS,OAAO,KAAK,CAAC,MAAM,EAAE,UAAU,KAAK,UAAU,EAAE,WAAW,SAAS,MAAM,aAAa,OAAO,GAAG;AACnH;AAKA,eAAe,mBAAmB,MAAY,YAAgC,IAAwC;AACpH,MAAI,CAAC,WAAY,QAAO,GAAG;AAC3B,QAAM,KAAK,SAAS,CAAC,EAAE,OAAO,YAAAA,aAAY,KAAK,MAAM;AACnD,eAAW,SAAS,SAAS,iBAAiB,KAAK,GAAG;AACpD,iBAAW,MAAM,CAAC,OAAO,GAAG,MAAM,iBAAiB,IAAIA,WAAU,EAAE,CAAC,GAAG;AACrE,YAAI,CAAC,GAAG,UAAU,SAASA,WAAU,EAAG;AACxC,WAAG,UAAU,OAAOA,WAAU;AAC9B,WAAG,aAAa,MAAMA,WAAU;AAAA,MAClC;AAAA,IACF;AAAA,EACF,GAAG,EAAE,OAAO,OAAO,YAAY,MAAM,YAAY,CAAC;AAClD,MAAI;AACF,UAAM,GAAG;AAAA,EACX,UAAE;AACA,UAAM,KAAK,SAAS,CAAC,SAAS;AAC5B,iBAAW,MAAM,SAAS,iBAAiB,IAAI,IAAI,GAAG,GAAG;AACvD,WAAG,UAAU,IAAI,GAAG,aAAa,IAAI,CAAE;AACvC,WAAG,gBAAgB,IAAI;AAAA,MACzB;AAAA,IACF,GAAG,WAAW;AAAA,EAChB;AACF;AAIA,eAAe,UAAU,MAAY,SAAkC;AACrE,QAAM,KAAK,SAAS,CAAC,EAAE,WAAW,UAAU,SAAAC,SAAQ,MAAM;AACxD,eAAW,WAAW,SAAS,iBAAiB,IAAI,SAAS,OAAO,QAAQ,GAAG,GAAG;AAChF,cAAQ,gBAAgB,SAAS;AACjC,cAAQ,gBAAgB,QAAQ;AAAA,IAClC;AACA,UAAM,QAAQ,CAAC,GAAG,SAAS,iBAA8B,gBAAgB,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB,CAAC;AAC3G,UAAM,QAAQ,OAAO,cAAc,+BAA+B;AAClE,QAAI,CAAC,SAAS,CAAC,MAAO,OAAM,IAAI,MAAM,gDAAgD;AACtF,UAAM,aAAa,WAAW,EAAE;AAChC,UAAM,eAAe,EAAE,OAAO,UAAU,CAAC;AACzC,UAAM,cAAc,eAAe,GAAG,aAAa,UAAU,EAAE;AAC/D,eAAW,YAAYA,UAAS;AAC9B,iBAAW,WAAW,SAAS,iBAAiB,QAAQ,GAAG;AACzD,YAAI,QAAQ,QAAQ,IAAI,SAAS,GAAG,EAAG;AACvC,gBAAQ,aAAa,WAAW,EAAE;AAClC,gBAAQ,aAAa,UAAU,EAAE;AAAA,MACnC;AAAA,IACF;AAAA,EACF,GAAG,EAAE,WAAW,YAAY,UAAU,WAAW,QAAQ,CAAC;AAC5D;AAEA,eAAe,SAAS,MAA6B;AACnD,QAAM,QAAQ,KAAK,QAAQ,IAAI,SAAS,GAAG;AAC3C,QAAM,QAAkB,CAAC;AACzB,WAAS,IAAI,GAAG,IAAI,MAAM,MAAM,MAAM,GAAG,IAAK,OAAM,KAAK,MAAM,MAAM,IAAI,CAAC,EAAE,aAAa,CAAC;AAC1F,SAAO,MAAM,OAAO,OAAO,EAAE,KAAK,IAAI;AACxC;AAEA,SAAS,eAAe,OAAoC;AAC1D,SAAO,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,OACrC,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA,EAAQ,KAAK,MAAM,IAAI,EAAE,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,EAAE,KAAK,IAAI,CAAC;AAAA,IACtF,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA,CAAQ,EAAE,KAAK,EAAE;AAC/C;AAEA,SAAS,WAAW,MAAmC;AACrD,QAAM,QAAQ,oBAAI,IAAoB;AACtC,MAAI,QAAuB;AAC3B,MAAI,QAAkB,CAAC;AACvB,QAAM,QAAQ,MAAM;AAClB,QAAI,UAAU,KAAM,OAAM,IAAI,OAAO,MAAM,KAAK,IAAI,CAAC;AAAA,EACvD;AACA,aAAW,QAAQ,KAAK,MAAM,IAAI,GAAG;AACnC,UAAM,MAAM,sBAAsB,KAAK,IAAI;AAC3C,QAAI,KAAK;AACP,YAAM;AACN,cAAQ,KAAK,MAAM,IAAI,CAAC,CAAC;AACzB,cAAQ,CAAC;AAAA,IACX,WAAW,KAAK,WAAW,IAAI,GAAG;AAChC,YAAM,KAAK,KAAK,MAAM,CAAC,CAAC;AAAA,IAC1B;AAAA,EACF;AACA,QAAM;AACN,SAAO;AACT;AAEA,SAAS,YAAY,QAAgB,OAAuD;AAC1F,QAAM,QAAQ,MAAM,MAAM,IAAI;AAC9B,QAAM,UAAoB,CAAC;AAC3B,aAAW,QAAQ,OAAO,MAAM,IAAI,GAAG;AACrC,UAAM,QAAQ,MAAM,QAAQ,IAAI;AAChC,QAAI,SAAS,EAAG,OAAM,OAAO,OAAO,CAAC;AAAA,QAChC,SAAQ,KAAK,IAAI;AAAA,EACxB;AACA,SAAO,EAAE,SAAS,MAAM;AAC1B;AAEA,SAAS,eAAe,QAA4B,OAAmC;AACrF,MAAI,WAAW,OAAW,QAAO;AACjC,MAAI,UAAU,OAAW,QAAO;AAChC,QAAM,EAAE,SAAS,MAAM,IAAI,YAAY,QAAQ,KAAK;AACpD,QAAM,QAAQ,CAAC,UAAoB,MAAM,WAAW,IAAI,YAAY,MAAM,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,KAC9H,MAAM,SAAS,IAAI,QAAQ,MAAM,SAAS,CAAC,UAAU;AAC1D,SAAO,kEAAkE,MAAM,OAAO,CAAC,SAAS,MAAM,KAAK,CAAC;AAC9G;AAEA,SAAS,UAAU,OAAyB;AAC1C,SAAO,CAAC,GAAG,MAAM,MAAM,GAAG,UAAU,GAAG,GAAI,MAAM,SAAS,aAAa,CAAC,OAAO,MAAM,SAAS,UAAU,OAAO,IAAI,CAAC,CAAE,EACnH,KAAK,IAAI;AACd;AAKA,SAAS,aAAa,IAAY,OAA0C;AAC1E,QAAM,OAAO,KAAK,KAAK,UAAU,GAAG,EAAE,MAAM;AAC5C,MAAI,QAAQ,IAAI,eAAe,MAAM,OAAO,CAAC,GAAG,WAAW,IAAI,GAAG;AAChE,QAAI,eAAe;AACjB,SAAG,UAAU,UAAU,EAAE,WAAW,KAAK,CAAC;AAC1C,SAAG,cAAc,MAAM,eAAe,KAAK,CAAC;AAAA,IAC9C;AACA,WAAO,CAAC;AAAA,EACV;AACA,QAAM,WAAW,WAAW,GAAG,aAAa,MAAM,MAAM,CAAC;AACzD,QAAM,UAAU,oBAAI,IAA+C;AACnE,aAAW,SAAS,oBAAI,IAAI,CAAC,GAAG,SAAS,KAAK,GAAG,GAAG,MAAM,KAAK,CAAC,CAAC,GAAG;AAClE,UAAM,SAAS,SAAS,IAAI,KAAK;AACjC,UAAM,QAAQ,MAAM,IAAI,KAAK;AAC7B,QAAI,WAAW,MAAO;AACtB,UAAM,OAAO,eAAe,QAAQ,KAAK;AACzC,UAAM,EAAE,SAAS,MAAM,IAAI,YAAY,UAAU,IAAI,SAAS,EAAE;AAChE,QAAI,SAAS,QAAQ,IAAI,IAAI;AAC7B,QAAI,CAAC,QAAQ;AACX,YAAM,OAAO,CAAC,GAAG,QAAQ,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI;AACjG,cAAQ,IAAI,MAAO,SAAS,EAAE,MAAM,OAAO,CAAC,EAAE,CAAE;AAAA,IAClD;AACA,WAAO,MAAM,KAAK,KAAK;AAAA,EACzB;AACA,SAAO,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,OAAO;AAAA,IACpD,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,QAAQ,YAAY,EAAE;AAAA,IACtB,MAAM,KAAK,MAAM,GAAG,UAAU;AAAA,IAC9B,MAAM,GAAG,IAAI;AAAA,IACb,SAAS;AAAA,IACT,MAAM,UAAU,KAAK;AAAA,EACvB,EAAE;AACJ;AAKA,IAAM,cAAN,MAAkB;AAAA,EAGhB,YAA6B,OAA0E;AAA1E;AAAA,EAA2E;AAAA,EAA3E;AAAA,EAFZ,UAAU,oBAAI,IAAqD;AAAA,EAIpF,MAAM,IAAI,MAAc,SAAwD;AAC9E,eAAW,QAAQ,SAAS;AAC1B,YAAM,EAAE,QAAQ,MAAM,IAAI,YAAY,OAAO,OAAO,EAAE,QAAQ,MAAM,OAAO,OAAU;AACrF,YAAM,MAAM,CAAC,OAAO,MAAM,OAAO,YAAY,OAAO,MAAM,EAAE,KAAK,IAAI;AACrE,UAAI,QAAQ,KAAK,QAAQ,IAAI,GAAG;AAChC,UAAI,CAAC,OAAO;AACV,cAAM,YAAY,MAAM,KAAK,MAAM,QAAQ,KAAK;AAChD,aAAK,QAAQ,IAAI,KAAM,QAAQ,EAAE,QAAQ,UAAU,SAAS,IAAI,EAAE,GAAG,QAAQ,UAAU,IAAI,QAAQ,OAAO,CAAC,EAAE,CAAE;AAAA,MACjH;AACA,UAAI,CAAC,MAAM,MAAM,SAAS,IAAI,EAAG,OAAM,MAAM,KAAK,IAAI;AAAA,IACxD;AAAA,EACF;AAAA,EAEA,UAAwB;AACtB,WAAO,CAAC,GAAG,KAAK,QAAQ,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,MAAM,OAAO,EAAE,GAAG,QAAQ,MAAM,UAAU,KAAK,EAAE,EAAE;AAAA,EACtG;AACF;AAEA,WAAW,YAAY,MAAM,kBAAkB,GAAG;AAChD,OAAK,GAAG,SAAS,EAAE,kEAAkE,OAAO,EAAE,KAAK,MAAM;AACvG,SAAK,WAAW,KAAK,GAAM;AAC3B,UAAM,UAAU,MAAM,cAAc,CAAC,OAAO,MAAM,CAAC;AACnD,QAAI,SAAS;AACX,WAAK,KAAK,EAAE,YAAY,KAAK,EAAE,MAAM,gBAAgB,aAAa,QAAQ,CAAC;AAC3E;AAAA,IACF;AAEA,UAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,UAAM,KAAK,YAAY,EAAE,SAAS,UAAU,CAAC;AAC7C,UAAM,EAAE,OAAO,MAAM,IAAI,WAAW,QAAQ;AAC5C,UAAM,UAAU,gBAAgB,QAAQ;AACxC,UAAM,UAAU,QAAQ,IAAI,eAAe,MAAM,QAAQ,UAAU,CAAC;AACpE,UAAM,QAAQ,MAAM,QAAQ,kBAAkB;AAC9C,UAAM,cAAc,SAAS,cAAc,CAAC,GAAG,IAAI,CAAC,EAAE,MAAM,OAAO,KAAK,OAAO,EAAE,UAAU,YAAY,UAAU,IAAI,EAAE,UAAU,OAAO,KAAK,EAAE;AAC/I,UAAM,OAAO,YAAY,UAAU,SAAS,IAAI,EAAE;AAClD,UAAM,MAAM,CAAC,MAAM,GAAG,OAAO;AAC7B,UAAM,QAAQ,IAAI,YAAY,OAAO,QAAQ,YAAY;AACvD,YAAM,OAAO,WAAW,OAAO,UAAU;AACzC,aAAO,OAAO,gBAAgB,MAAM,EAAE,UAAU,OAAO,QAAQ,OAAO,OAAO,GAAG,QAAQ,GAAG,MAAM,KAAK,IAAI,CAAC;AAAA,IAC7G,CAAC;AAGD,UAAM,YAAY,CAAC,MAAY,OAAe,aAC5C,mBAAmB,MAAM,YAAY,UAAU,IAAI,GAAG,YAAY;AAChE,YAAM,MAAM,IAAI,OAAO,MAAM,oBAAoB,MAAM,OAAO,OAAO,CAAC;AACtE,UAAI,SAAU,OAAM,MAAM,IAAI,OAAO,MAAM,iBAAiB,MAAM,OAAO,OAAO,CAAC;AAAA,IACnF,CAAC;AACH,UAAM,QAAQ,oBAAI,IAAoB;AAEtC,UAAM,OAAO,OAAO,EAAE,OAAO,KAAK,MAAgB;AAChD,YAAM,QAAQ,WAAW,IAAI;AAC7B,YAAM,UAAU,MAAM,OAAO;AAC7B,YAAM,MAAM,IAAI,OAAO,MAAM,QAAQ,MAAM,OAAO,SAAS,gBAAgB,CAAC;AAC5E,YAAM,UAAU,MAAM,OAAO,IAAI;AACjC,YAAM,MAAM,IAAI,OAAO,MAAM,eAAe,MAAM,OAAO,SAAS,YAAY,IAAI,CAAC;AACnF,YAAM,IAAI,OAAO,MAAM,SAAS,IAAI,CAAC;AACrC,YAAM,MAAM,IAAI,OAAO,MAAM,gBAAgB,MAAM,OAAO,SAAS,GAAG,CAAC;AACvE,YAAM,MAAM,IAAI,OAAO,MAAM,kBAAkB,MAAM,OAAO,SAAS,GAAG,CAAC;AAAA,IAC3E;AACA,UAAM,eAAe,OAAO,EAAE,OAAO,KAAK,GAAa,UAAkB;AACvE,YAAM,SAAS,GAAG,KAAK,UAAU,KAAK;AACtC,YAAM,UAAU,MAAM,OAAO;AAC7B,YAAM,MAAM,IAAI,QAAQ,MAAM,QAAQ,MAAM,OAAO,SAAS,kBAAkB,YAAY,CAAC;AAC3F,YAAM,UAAU,MAAM,QAAQ,KAAK;AACnC,YAAM,MAAM,IAAI,QAAQ,MAAM,eAAe,MAAM,OAAO,SAAS,YAAY,IAAI,CAAC;AAAA,IACtF;AAEA,eAAW,YAAY,MAAO,OAAM,KAAK,QAAQ;AACjD,eAAW,SAAS,SAAS;AAC3B,YAAM,QAAQ,sBAAsB,KAAK;AACzC,iBAAW,YAAY,OAAO;AAC5B,cAAM,QAAQ,WAAW,SAAS,IAAI;AACtC,cAAM,aAAa,UAAU,KAAK;AAAA,MACpC;AACA,YAAM,QAAQ,uBAAuB;AAAA,IACvC;AACA,eAAW,YAAY,OAAO;AAC5B,YAAM,KAAK,QAAQ;AACnB,iBAAW,SAAS,SAAS;AAC3B,cAAM,QAAQ,sBAAsB,KAAK;AACzC,cAAM,aAAa,UAAU,KAAK;AAClC,cAAM,QAAQ,uBAAuB;AAAA,MACvC;AAAA,IACF;AAEA,eAAW,CAAC,GAAG,MAAM,QAAQ,GAAG,GAAG,aAAa,SAAS,IAAI,KAAK,CAAC,CAAC;AAAA,EACtE,CAAC;AACH;","names":["forceClass","portals"]}

package/src/testing-js/component-alias.contract.js

@@ -1,7 +1,7 @@
 import {
   openComponentsEditor
-} from "./chunk-WIZ6W7UT.js";
-import "./chunk-NB3NZRBM.js";
+} from "./chunk-3WCLMOM7.js";
+import "./chunk-7CM5D7PF.js";
 
 // src/testing/component-alias.contract.ts
 import fs from "fs";

package/src/testing-js/component-behavior.contract.js

@@ -2,10 +2,10 @@ import {
   ContractViolation,
   isInapplicable,
   partLocator
-} from "./chunk-3UKGXCDL.js";
+} from "./chunk-YVVR3GJZ.js";
 import {
   selectedContracts
-} from "./chunk-SHBYZUPD.js";
+} from "./chunk-RWOT2XDB.js";
 
 // src/testing/component-behavior.contract.ts
 import { existsSync } from "fs";

package/src/testing-js/component-editor.contract.js

@@ -1,16 +1,17 @@
 import {
   ContractHarness
-} from "./chunk-X6KHEVIG.js";
-import "./chunk-WIZ6W7UT.js";
+} from "./chunk-7QXUJRSO.js";
+import "./chunk-3WCLMOM7.js";
+import "./chunk-RTZQLW3F.js";
+import "./chunk-7CM5D7PF.js";
 import {
   ContractViolation,
   isInapplicable
-} from "./chunk-3UKGXCDL.js";
-import "./chunk-NB3NZRBM.js";
+} from "./chunk-YVVR3GJZ.js";
 import {
   allContracts,
   selectedContracts
-} from "./chunk-SHBYZUPD.js";
+} from "./chunk-RWOT2XDB.js";
 
 // src/testing/component-editor.contract.ts
 import { test } from "@playwright/test";

package/src/testing-js/component-editor.contract.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../testing/component-editor.contract.ts"],"sourcesContent":["import { test } from '@playwright/test';\nimport { ContractViolation, isInapplicable } from './componentContract';\nimport { allContracts, selectedContracts } from './contracts';\nimport { ContractHarness } from './support/contractHarness';\n\nconst selected = await selectedContracts();\nconst requested = process.env.LIVE_TOKENS_COMPONENT;\n\n// A failing test rather than a throw from the config: the JSON report then\n// carries the rule, and the runner maps it like any other violation instead\n// of reading a stderr tail.\nif (requested && selected.length === 0) {\n  const declared = (await allContracts()).map((contract) => contract.id).sort();\n  test.describe.serial(requested, () => {\n    test(`${requested} has a component contract`, () => {\n      throw new ContractViolation(\n        'contract-missing',\n        requested,\n        'no component contract is declared for it. Export one from the module '\n        + `\\`contractsModule\\` names in live-tokens.testing.ts. Declared: ${declared.join(', ')}`,\n      );\n    });\n  });\n}\n\nfor (const contract of selected) {\n  // Serial, so a component that is not registered reports that and stops rather\n  // than reporting six preview failures caused by the missing entry.\n  test.describe.serial(contract.id, () => {\n    test(`${contract.id} is listed in its registry group`, async ({ page }) => {\n      const harness = await ContractHarness.attach(page, contract);\n      await harness.assertListed();\n    });\n\n    test(`${contract.id} declares every part and every shipped alias`, async ({ page }) => {\n      const harness = await ContractHarness.open(page, contract);\n      await harness.assertInventory();\n    });\n\n    test(`${contract.id} resolves every alias it paints with`, async ({ page }) => {\n      const harness = await ContractHarness.open(page, contract);\n      await harness.assertAliasesResolve();\n    });\n\n    test(`${contract.id} previews the state being edited`, async ({ page }) => {\n      const harness = await ContractHarness.open(page, contract);\n      if (isInapplicable(contract.states)) {\n        test.info().annotations.push({ type: 'inapplicable', description: contract.states.reason });\n      }\n      await harness.assertStates();\n    });\n\n    test(`${contract.id} answers the pointer and the keyboard`, async ({ page }) => {\n      const harness = await ContractHarness.open(page, contract);\n      if (isInapplicable(contract.interaction)) {\n        test.info().annotations.push({ type: 'inapplicable', description: contract.interaction.reason });\n      }\n      await harness.assertInteraction();\n    });\n\n    test(`${contract.id} persists an edit and resets to the saved config`, async ({ page }) => {\n      test.setTimeout(180_000);\n      const harness = await ContractHarness.open(page, contract);\n      await harness.assertPersistence();\n    });\n\n    test(`${contract.id} takes the theme's values and gives them back`, async ({ page }) => {\n      const harness = await ContractHarness.open(page, contract);\n      await harness.assertThemeProjection(contract.theme);\n    });\n\n    test(`${contract.id} draws every painted part in Sketch mode`, async ({ page }) => {\n      const harness = await ContractHarness.open(page, contract);\n      const sketch = contract.sketch;\n      if (isInapplicable(sketch)) {\n        test.info().annotations.push({ type: 'inapplicable', description: sketch.reason });\n        await harness.assertNoSketchPaint('pencil');\n        return;\n      }\n      await harness.assertSketchPaint(sketch);\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;AAAA,SAAS,YAAY;AAKrB,IAAM,WAAW,MAAM,kBAAkB;AACzC,IAAM,YAAY,QAAQ,IAAI;AAK9B,IAAI,aAAa,SAAS,WAAW,GAAG;AACtC,QAAM,YAAY,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,SAAS,EAAE,EAAE,KAAK;AAC5E,OAAK,SAAS,OAAO,WAAW,MAAM;AACpC,SAAK,GAAG,SAAS,6BAA6B,MAAM;AAClD,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA,uIACoE,SAAS,KAAK,IAAI,CAAC;AAAA,MACzF;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH;AAEA,WAAW,YAAY,UAAU;AAG/B,OAAK,SAAS,OAAO,SAAS,IAAI,MAAM;AACtC,SAAK,GAAG,SAAS,EAAE,oCAAoC,OAAO,EAAE,KAAK,MAAM;AACzE,YAAM,UAAU,MAAM,gBAAgB,OAAO,MAAM,QAAQ;AAC3D,YAAM,QAAQ,aAAa;AAAA,IAC7B,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,gDAAgD,OAAO,EAAE,KAAK,MAAM;AACrF,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,YAAM,QAAQ,gBAAgB;AAAA,IAChC,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,wCAAwC,OAAO,EAAE,KAAK,MAAM;AAC7E,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,YAAM,QAAQ,qBAAqB;AAAA,IACrC,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,oCAAoC,OAAO,EAAE,KAAK,MAAM;AACzE,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,UAAI,eAAe,SAAS,MAAM,GAAG;AACnC,aAAK,KAAK,EAAE,YAAY,KAAK,EAAE,MAAM,gBAAgB,aAAa,SAAS,OAAO,OAAO,CAAC;AAAA,MAC5F;AACA,YAAM,QAAQ,aAAa;AAAA,IAC7B,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,yCAAyC,OAAO,EAAE,KAAK,MAAM;AAC9E,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,UAAI,eAAe,SAAS,WAAW,GAAG;AACxC,aAAK,KAAK,EAAE,YAAY,KAAK,EAAE,MAAM,gBAAgB,aAAa,SAAS,YAAY,OAAO,CAAC;AAAA,MACjG;AACA,YAAM,QAAQ,kBAAkB;AAAA,IAClC,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,oDAAoD,OAAO,EAAE,KAAK,MAAM;AACzF,WAAK,WAAW,IAAO;AACvB,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,YAAM,QAAQ,kBAAkB;AAAA,IAClC,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,iDAAiD,OAAO,EAAE,KAAK,MAAM;AACtF,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,YAAM,QAAQ,sBAAsB,SAAS,KAAK;AAAA,IACpD,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,4CAA4C,OAAO,EAAE,KAAK,MAAM;AACjF,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,YAAM,SAAS,SAAS;AACxB,UAAI,eAAe,MAAM,GAAG;AAC1B,aAAK,KAAK,EAAE,YAAY,KAAK,EAAE,MAAM,gBAAgB,aAAa,OAAO,OAAO,CAAC;AACjF,cAAM,QAAQ,oBAAoB,QAAQ;AAC1C;AAAA,MACF;AACA,YAAM,QAAQ,kBAAkB,MAAM;AAAA,IACxC,CAAC;AAAA,EACH,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../testing/component-editor.contract.ts"],"sourcesContent":["import { test } from '@playwright/test';\nimport { ContractViolation, isInapplicable } from './componentContract';\nimport { allContracts, selectedContracts } from './contracts';\nimport { ContractHarness } from './support/contractHarness';\n\nconst selected = await selectedContracts();\nconst requested = process.env.LIVE_TOKENS_COMPONENT;\n\n// A failing test rather than a throw from the config: the JSON report then\n// carries the rule, and the runner maps it like any other violation instead\n// of reading a stderr tail.\nif (requested && selected.length === 0) {\n  const declared = (await allContracts()).map((contract) => contract.id).sort();\n  test.describe.serial(requested, () => {\n    test(`${requested} has a component contract`, () => {\n      throw new ContractViolation(\n        'contract-missing',\n        requested,\n        'no component contract is declared for it. Export one from the module '\n        + `\\`contractsModule\\` names in live-tokens.testing.ts. Declared: ${declared.join(', ')}`,\n      );\n    });\n  });\n}\n\nfor (const contract of selected) {\n  // Serial, so a component that is not registered reports that and stops rather\n  // than reporting six preview failures caused by the missing entry.\n  test.describe.serial(contract.id, () => {\n    test(`${contract.id} is listed in its registry group`, async ({ page }) => {\n      const harness = await ContractHarness.attach(page, contract);\n      await harness.assertListed();\n    });\n\n    test(`${contract.id} declares every part and every shipped alias`, async ({ page }) => {\n      const harness = await ContractHarness.open(page, contract);\n      await harness.assertInventory();\n    });\n\n    test(`${contract.id} resolves every alias it paints with`, async ({ page }) => {\n      const harness = await ContractHarness.open(page, contract);\n      await harness.assertAliasesResolve();\n    });\n\n    test(`${contract.id} previews the state being edited`, async ({ page }) => {\n      const harness = await ContractHarness.open(page, contract);\n      if (isInapplicable(contract.states)) {\n        test.info().annotations.push({ type: 'inapplicable', description: contract.states.reason });\n      }\n      await harness.assertStates();\n    });\n\n    test(`${contract.id} answers the pointer and the keyboard`, async ({ page }) => {\n      const harness = await ContractHarness.open(page, contract);\n      if (isInapplicable(contract.interaction)) {\n        test.info().annotations.push({ type: 'inapplicable', description: contract.interaction.reason });\n      }\n      await harness.assertInteraction();\n    });\n\n    test(`${contract.id} persists an edit and resets to the saved config`, async ({ page }) => {\n      test.setTimeout(180_000);\n      const harness = await ContractHarness.open(page, contract);\n      await harness.assertPersistence();\n    });\n\n    test(`${contract.id} takes the theme's values and gives them back`, async ({ page }) => {\n      const harness = await ContractHarness.open(page, contract);\n      await harness.assertThemeProjection(contract.theme);\n    });\n\n    test(`${contract.id} draws every painted part in Sketch mode`, async ({ page }) => {\n      const harness = await ContractHarness.open(page, contract);\n      const sketch = contract.sketch;\n      if (isInapplicable(sketch)) {\n        test.info().annotations.push({ type: 'inapplicable', description: sketch.reason });\n        await harness.assertNoSketchPaint('pencil');\n        return;\n      }\n      await harness.assertSketchPaint(sketch);\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA,SAAS,YAAY;AAKrB,IAAM,WAAW,MAAM,kBAAkB;AACzC,IAAM,YAAY,QAAQ,IAAI;AAK9B,IAAI,aAAa,SAAS,WAAW,GAAG;AACtC,QAAM,YAAY,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,SAAS,EAAE,EAAE,KAAK;AAC5E,OAAK,SAAS,OAAO,WAAW,MAAM;AACpC,SAAK,GAAG,SAAS,6BAA6B,MAAM;AAClD,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA,uIACoE,SAAS,KAAK,IAAI,CAAC;AAAA,MACzF;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH;AAEA,WAAW,YAAY,UAAU;AAG/B,OAAK,SAAS,OAAO,SAAS,IAAI,MAAM;AACtC,SAAK,GAAG,SAAS,EAAE,oCAAoC,OAAO,EAAE,KAAK,MAAM;AACzE,YAAM,UAAU,MAAM,gBAAgB,OAAO,MAAM,QAAQ;AAC3D,YAAM,QAAQ,aAAa;AAAA,IAC7B,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,gDAAgD,OAAO,EAAE,KAAK,MAAM;AACrF,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,YAAM,QAAQ,gBAAgB;AAAA,IAChC,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,wCAAwC,OAAO,EAAE,KAAK,MAAM;AAC7E,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,YAAM,QAAQ,qBAAqB;AAAA,IACrC,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,oCAAoC,OAAO,EAAE,KAAK,MAAM;AACzE,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,UAAI,eAAe,SAAS,MAAM,GAAG;AACnC,aAAK,KAAK,EAAE,YAAY,KAAK,EAAE,MAAM,gBAAgB,aAAa,SAAS,OAAO,OAAO,CAAC;AAAA,MAC5F;AACA,YAAM,QAAQ,aAAa;AAAA,IAC7B,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,yCAAyC,OAAO,EAAE,KAAK,MAAM;AAC9E,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,UAAI,eAAe,SAAS,WAAW,GAAG;AACxC,aAAK,KAAK,EAAE,YAAY,KAAK,EAAE,MAAM,gBAAgB,aAAa,SAAS,YAAY,OAAO,CAAC;AAAA,MACjG;AACA,YAAM,QAAQ,kBAAkB;AAAA,IAClC,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,oDAAoD,OAAO,EAAE,KAAK,MAAM;AACzF,WAAK,WAAW,IAAO;AACvB,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,YAAM,QAAQ,kBAAkB;AAAA,IAClC,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,iDAAiD,OAAO,EAAE,KAAK,MAAM;AACtF,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,YAAM,QAAQ,sBAAsB,SAAS,KAAK;AAAA,IACpD,CAAC;AAED,SAAK,GAAG,SAAS,EAAE,4CAA4C,OAAO,EAAE,KAAK,MAAM;AACjF,YAAM,UAAU,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AACzD,YAAM,SAAS,SAAS;AACxB,UAAI,eAAe,MAAM,GAAG;AAC1B,aAAK,KAAK,EAAE,YAAY,KAAK,EAAE,MAAM,gBAAgB,aAAa,OAAO,OAAO,CAAC;AACjF,cAAM,QAAQ,oBAAoB,QAAQ;AAC1C;AAAA,MACF;AACA,YAAM,QAAQ,kBAAkB,MAAM;AAAA,IACxC,CAAC;AAAA,EACH,CAAC;AACH;","names":[]}

package/src/testing-js/component-render.contract.js

@@ -1,14 +1,15 @@
 import {
   ContractHarness
-} from "./chunk-X6KHEVIG.js";
+} from "./chunk-7QXUJRSO.js";
 import {
   openComponentsEditor
-} from "./chunk-WIZ6W7UT.js";
-import "./chunk-3UKGXCDL.js";
-import "./chunk-NB3NZRBM.js";
+} from "./chunk-3WCLMOM7.js";
+import "./chunk-RTZQLW3F.js";
+import "./chunk-7CM5D7PF.js";
+import "./chunk-YVVR3GJZ.js";
 import {
   selectedContracts
-} from "./chunk-SHBYZUPD.js";
+} from "./chunk-RWOT2XDB.js";
 
 // src/testing/component-render.contract.ts
 import fs from "fs";
@@ -154,6 +155,7 @@ async function exerciseVisibleGradientControls(page, componentAliases, exercised
     const variable = await editor.getAttribute("data-token-variable");
     if (!variable || !componentAliases.includes(variable) || exercised.has(variable)) continue;
     const before = await page.evaluate((name) => document.documentElement.style.getPropertyValue(name).trim(), variable);
+    await editor.evaluate((el) => el.scrollIntoView({ block: "center" }));
     const solid = editor.getByRole("radio", { name: "Solid" });
     if (await solid.count() && !await solid.isChecked()) await solid.check({ force: true });
     const picker = editor.locator(".picker-slot .ui-token-selector").first();
@@ -476,7 +478,9 @@ for (const [component, aliases] of aliasesByComponent) {
           await unchecked.nth(index).click({ force: true });
         }
       }
-      const dialogAction = page.locator('[role="dialog"] button:not(:disabled)').first();
+      const dialogAction = page.locator(
+        '[role="dialog"]:not(.tabs-preview [role="dialog"]) button:not(:disabled)'
+      ).first();
       if (await dialogAction.count()) await dialogAction.hover({ force: true });
       await exerciseVisibleTokenControls(page, componentAliases, controlExercised, proof);
       const gates = await exerciseVisibleCompositeControls(page, componentAliases, controlExercised);