@weasel-js/forge 1.5.0 → 1.5.1

package/dist/chunk-TLO6UHF2.js

@@ -0,0 +1,103 @@
+import { stableStringify } from './chunk-FTFR2YPM.js';
+import { createContext } from 'react';
+
+var coverOf = (value) => stableStringify(value) ?? " undefined";
+var appliedLocal = (local, config) => Object.fromEntries(
+  Object.entries(local).filter(([key, entry]) => coverOf(config[key]) === entry.over).map(([key, entry]) => [key, entry.value])
+);
+var ArgsContext = createContext(null);
+
+// src/csf/portSafe.ts
+var g = globalThis;
+var CLONED_WHOLE = new Set(
+  [
+    "Date",
+    "RegExp",
+    "ArrayBuffer",
+    "DataView",
+    "Int8Array",
+    "Uint8Array",
+    "Uint8ClampedArray",
+    "Int16Array",
+    "Uint16Array",
+    "Int32Array",
+    "Uint32Array",
+    "Float16Array",
+    "Float32Array",
+    "Float64Array",
+    "BigInt64Array",
+    "BigUint64Array"
+  ].map((name) => g[name]?.prototype).filter(Boolean)
+);
+var hasOnlyClonedKeys = (v) => Reflect.ownKeys(v).every(
+  (key) => typeof key === "string" && (Object.prototype.propertyIsEnumerable.call(v, key) || Array.isArray(v) && key === "length")
+);
+function isPortSafe(value) {
+  const seen = /* @__PURE__ */ new Set();
+  const safe = (v) => {
+    if (v === null) return true;
+    if (typeof v !== "object") return typeof v !== "function" && typeof v !== "symbol";
+    if (seen.has(v)) return true;
+    seen.add(v);
+    const proto = Object.getPrototypeOf(v);
+    if (CLONED_WHOLE.has(proto)) return true;
+    if (proto === Map.prototype)
+      return hasOnlyClonedKeys(v) && [...v].every(([key, member]) => safe(key) && safe(member));
+    if (proto === Set.prototype) return hasOnlyClonedKeys(v) && [...v].every(safe);
+    if (proto !== Array.prototype && proto !== Object.prototype && proto !== null) return false;
+    return hasOnlyClonedKeys(v) && Object.values(v).every(safe);
+  };
+  try {
+    return safe(value);
+  } catch {
+    return false;
+  }
+}
+var isPlainOrNull = (v) => {
+  if (!v || typeof v !== "object") return false;
+  const proto = Object.getPrototypeOf(v);
+  return proto === Object.prototype || proto === null;
+};
+var splittable = (v) => (Array.isArray(v) ? Object.getPrototypeOf(v) === Array.prototype : isPlainOrNull(v) && !("$$typeof" in v)) && hasOnlyClonedKeys(v);
+function portSafePart(value) {
+  const walking = /* @__PURE__ */ new Set();
+  const part = (v) => {
+    if (isPortSafe(v)) return { value: v };
+    if (!splittable(v) || walking.has(v)) return null;
+    walking.add(v);
+    try {
+      if (Array.isArray(v)) return { value: v.map((member) => part(member)?.value ?? null) };
+      const out = {};
+      for (const [key, member] of Object.entries(v)) {
+        const kept = part(member);
+        if (kept) out[key] = kept.value;
+      }
+      return { value: out };
+    } finally {
+      walking.delete(v);
+    }
+  };
+  try {
+    return part(value);
+  } catch {
+    return null;
+  }
+}
+function withUnsent(sent, original) {
+  if (isPortSafe(original)) return sent;
+  if (sent === null && portSafePart(original) === null) return original;
+  if (Array.isArray(original) && Array.isArray(sent))
+    return sent.map((member, i) => i < original.length ? withUnsent(member, original[i]) : member);
+  if (!splittable(original) || Array.isArray(original) || !isPlainOrNull(sent)) return sent;
+  const out = {};
+  for (const [key, member] of Object.entries(original)) {
+    if (key in sent) out[key] = withUnsent(sent[key], member);
+    else if (portSafePart(member) === null) out[key] = member;
+  }
+  for (const [key, member] of Object.entries(sent)) if (!(key in original)) out[key] = member;
+  return out;
+}
+
+export { ArgsContext, appliedLocal, coverOf, isPortSafe, portSafePart, withUnsent };
+//# sourceMappingURL=chunk-TLO6UHF2.js.map
+//# sourceMappingURL=chunk-TLO6UHF2.js.map

package/dist/chunk-TLO6UHF2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/csf/argsContext.ts","../src/csf/portSafe.ts"],"names":[],"mappings":"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","file":"chunk-TLO6UHF2.js","sourcesContent":["import { type Context, createContext, type Dispatch, type SetStateAction } from 'react';\nimport { stableStringify } from '../protocol/messages';\n\ntype Args = Record<string, unknown>;\n\n/** A frame-local arg, and the config value it was set over: it applies only while config still holds that. */\nexport interface LocalArg {\n  value: unknown;\n  over: string;\n}\n\nexport type LocalArgs = Record<string, LocalArg>;\n\n/** A config value in the form `LocalArg.over` records. */\nexport const coverOf = (value: unknown): string => stableStringify(value) ?? ' undefined';\n\n/** The frame-local values that still apply over `config`. */\nexport const appliedLocal = (local: LocalArgs, config: Args): Args =>\n  Object.fromEntries(\n    Object.entries(local)\n      .filter(([key, entry]) => coverOf(config[key]) === entry.over)\n      .map(([key, entry]) => [key, entry.value]),\n  );\n\nexport interface ArgsScope {\n  /** The args the story renders with: its own, then config, then the frame-local ones that still apply. */\n  args: Args;\n  /** The trial's config as it stands. An `undefined` key means the story's own arg. */\n  config: Args;\n  defaults: Args;\n  /** The story's own args, before config and the frame-local ones. */\n  original: Args;\n  setConfig: (path: string, value: unknown) => void;\n  /** Args a MessagePort would not deliver intact, kept in the frame because config crosses one. */\n  setLocal: Dispatch<SetStateAction<LocalArgs>>;\n}\n\nexport const ArgsContext: Context<ArgsScope | null> = createContext<ArgsScope | null>(null);\n","const g = globalThis as Record<string, unknown>;\nconst CLONED_WHOLE = new Set<unknown>(\n  [\n    'Date',\n    'RegExp',\n    'ArrayBuffer',\n    'DataView',\n    'Int8Array',\n    'Uint8Array',\n    'Uint8ClampedArray',\n    'Int16Array',\n    'Uint16Array',\n    'Int32Array',\n    'Uint32Array',\n    'Float16Array',\n    'Float32Array',\n    'Float64Array',\n    'BigInt64Array',\n    'BigUint64Array',\n  ]\n    .map((name) => (g[name] as { prototype?: object } | undefined)?.prototype)\n    .filter(Boolean),\n);\n\n/** Own keys a clone keeps: enumerable string keys, plus an array's `length`. */\nconst hasOnlyClonedKeys = (v: object): boolean =>\n  Reflect.ownKeys(v).every(\n    (key) =>\n      typeof key === 'string' &&\n      (Object.prototype.propertyIsEnumerable.call(v, key) || (Array.isArray(v) && key === 'length')),\n  );\n\n/**\n * Whether a MessagePort delivers `value` as the same thing it was. `structuredClone` succeeding is\n * not enough: it copies a class instance's fields onto a plain object and drops its methods.\n */\nexport function isPortSafe(value: unknown): boolean {\n  const seen = new Set<object>();\n  const safe = (v: unknown): boolean => {\n    if (v === null) return true;\n    if (typeof v !== 'object') return typeof v !== 'function' && typeof v !== 'symbol';\n    if (seen.has(v)) return true;\n    seen.add(v);\n    const proto = Object.getPrototypeOf(v);\n    if (CLONED_WHOLE.has(proto)) return true;\n    if (proto === Map.prototype)\n      return hasOnlyClonedKeys(v) && [...(v as Map<unknown, unknown>)].every(([key, member]) => safe(key) && safe(member));\n    if (proto === Set.prototype) return hasOnlyClonedKeys(v) && [...(v as Set<unknown>)].every(safe);\n    if (proto !== Array.prototype && proto !== Object.prototype && proto !== null) return false;\n    return hasOnlyClonedKeys(v) && Object.values(v).every(safe);\n  };\n  try {\n    return safe(value);\n  } catch {\n    return false;\n  }\n}\n\nconst isPlainOrNull = (v: unknown): v is Record<string, unknown> => {\n  if (!v || typeof v !== 'object') return false;\n  const proto = Object.getPrototypeOf(v);\n  return proto === Object.prototype || proto === null;\n};\n\n/** A plain object or array whose members can be split: React elements are plain objects, but whole. */\nconst splittable = (v: unknown): v is Record<string, unknown> | unknown[] =>\n  (Array.isArray(v) ? Object.getPrototypeOf(v) === Array.prototype : isPlainOrNull(v) && !('$$typeof' in v)) &&\n  hasOnlyClonedKeys(v as object);\n\n/**\n * The part of `value` a port delivers intact, or null when none of it can cross. A plain object\n * keeps its port-safe fields; an array holds null where a member has no part.\n */\nexport function portSafePart(value: unknown): { value: unknown } | null {\n  const walking = new Set<object>();\n  const part = (v: unknown): { value: unknown } | null => {\n    if (isPortSafe(v)) return { value: v };\n    if (!splittable(v) || walking.has(v)) return null;\n    walking.add(v);\n    try {\n      if (Array.isArray(v)) return { value: v.map((member) => part(member)?.value ?? null) };\n      const out: Record<string, unknown> = {};\n      for (const [key, member] of Object.entries(v)) {\n        const kept = part(member);\n        if (kept) out[key] = kept.value;\n      }\n      return { value: out };\n    } finally {\n      walking.delete(v);\n    }\n  };\n  try {\n    return part(value);\n  } catch {\n    return null;\n  }\n}\n\n/** `sent`, a value that crossed the port as `portSafePart(original)` or an edit of it, with what the part left behind put back. */\nexport function withUnsent(sent: unknown, original: unknown): unknown {\n  if (isPortSafe(original)) return sent;\n  if (sent === null && portSafePart(original) === null) return original;\n  if (Array.isArray(original) && Array.isArray(sent))\n    return sent.map((member, i) => (i < original.length ? withUnsent(member, original[i]) : member));\n  if (!splittable(original) || Array.isArray(original) || !isPlainOrNull(sent)) return sent;\n  const out: Record<string, unknown> = {};\n  for (const [key, member] of Object.entries(original)) {\n    if (key in sent) out[key] = withUnsent(sent[key], member);\n    else if (portSafePart(member) === null) out[key] = member;\n  }\n  for (const [key, member] of Object.entries(sent)) if (!(key in original)) out[key] = member;\n  return out;\n}\n"]}

package/dist/{config-DdumOfyd.d.ts → config-CrLpfSq9.d.ts}

@@ -1,6 +1,6 @@
-import { LabContribution } from '@weasel-js/labkit';
+import { LabContribution, LabPage } from '@weasel-js/labkit';
 import { ControlRenderer } from '@weasel-js/labkit/config';
-import { F as FrameSetup } from './FrameController-Ba3LaWfq.js';
+import { F as FrameSetup } from './FrameController-BPfCt4PJ.js';
 
 /** One global the workshop's toolbar sets for every story, and a trial may pin for its own. */
 interface GlobalDeclaration {
@@ -19,6 +19,10 @@ interface ShellConfig {
     controls?: Record<string, ControlRenderer>;
     /** Globals the lab's header sets for every story, each pinnable per trial. Frames apply them with `applyGlobals`. */
     globals?: GlobalDeclarations;
+    /** The project's other labs, offered in the workshop's title menu. */
+    pages?: readonly LabPage[];
+    /** Which of `pages` the workshop is, when the URL alone cannot say, as across dev servers on different ports. */
+    path?: string;
 }
 /** A frame config module's default export. Only frame documents import it, so its CSS stays out of the workshop. */
 declare function defineFrameConfig(config: FrameSetup): FrameSetup;

package/dist/csf/preview-api.js

@@ -1,5 +1,5 @@
-import { ArgsContext, coverOf, isPortSafe } from '../chunk-KKVTFMWV.js';
-import '../chunk-IOBG7GZQ.js';
+import { ArgsContext, coverOf, isPortSafe } from '../chunk-TLO6UHF2.js';
+import '../chunk-FTFR2YPM.js';
 import { useContext } from 'react';
 
 var sendable = (value) => {

package/dist/frame/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FrameSetup, L as LoadedStory } from '../FrameController-Ba3LaWfq.js';
-export { b as StartFrameOptions, r as reportImportFault, s as startFrame } from '../FrameController-Ba3LaWfq.js';
+import { F as FrameSetup, L as LoadedStory } from '../FrameController-BPfCt4PJ.js';
+export { d as StartFrameOptions, r as reportImportFault, s as startFrame } from '../FrameController-BPfCt4PJ.js';
 import '@weasel-js/labkit/config';
 import 'react';
 
@@ -8,15 +8,16 @@ interface FrameImporters {
 }
 interface FrameIndexEntry {
     id: string;
+    /** The story's title as indexed, which titles the file's stories when its meta names none. */
+    title: string;
     file: string;
     exportName: string;
 }
 interface MountFrameOptions {
     index: readonly FrameIndexEntry[];
     importers: FrameImporters;
-    root: string;
     setup?: FrameSetup;
-    load?: (mod: Record<string, unknown>, file: string, root: string, parameters?: Record<string, unknown>) => LoadedStory[];
+    load?: (mod: Record<string, unknown>, autoTitle: string, parameters?: Record<string, unknown>) => LoadedStory[];
 }
 /** The frame document's entry: takes the shell's port, loads the story named by the hash, and starts it. */
 declare function mountFrame(options: MountFrameOptions): Promise<void>;

package/dist/frame/index.js

@@ -1,8 +1,8 @@
-export { mountFrame, reportImportFault, startFrame } from '../chunk-KKF7ZX5E.js';
+export { mountFrame, reportImportFault, startFrame } from '../chunk-2MADHLRA.js';
 import '../chunk-2GXKNXTJ.js';
-import '../chunk-UZCXH724.js';
-import '../chunk-O5OQZQRZ.js';
-import '../chunk-KKVTFMWV.js';
-import '../chunk-IOBG7GZQ.js';
+import '../chunk-6SRQIHJQ.js';
+import '../chunk-2JDYOBWM.js';
+import '../chunk-TLO6UHF2.js';
+import '../chunk-FTFR2YPM.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,11 +1,103 @@
 export { f } from '@weasel-js/labkit/config';
-export { G as GlobalDeclaration, a as GlobalDeclarations, S as ShellConfig, d as defineFrameConfig, b as defineShellConfig } from './config-DdumOfyd.js';
-import { M as MetaSpec, S as StorySpec } from './FrameController-Ba3LaWfq.js';
-export { D as Decorator, F as FrameSetup, L as LoadedStory, P as PlayContext, a as StoryContext } from './FrameController-Ba3LaWfq.js';
+export { G as GlobalDeclaration, a as GlobalDeclarations, S as ShellConfig, d as defineFrameConfig, b as defineShellConfig } from './config-CrLpfSq9.js';
+import { ComponentType, ReactNode } from 'react';
+import { G as Globals, M as MetaSpec, S as StorySpec } from './FrameController-BPfCt4PJ.js';
+export { A as A11yFinding, a as A11yNode, b as A11yReport, D as Decorator, F as FrameSetup, L as LoadedStory, P as PlayContext, c as StoryContext } from './FrameController-BPfCt4PJ.js';
 import '@weasel-js/labkit';
-import 'react';
+
+/** Storybook's conditional control: shown only while an arg, or a global, meets the test. */
+type ArgCondition = ({
+    arg: string;
+} | {
+    global: string;
+}) & {
+    truthy?: boolean;
+    exists?: boolean;
+    eq?: unknown;
+    neq?: unknown;
+};
+/** A CSF `argTypes` entry, as far as forge reads it. */
+interface ArgType {
+    name?: string;
+    description?: string;
+    control?: string | false | {
+        type?: string;
+        min?: number;
+        max?: number;
+        step?: number;
+    };
+    options?: readonly unknown[];
+    table?: {
+        disable?: boolean;
+    };
+    if?: ArgCondition;
+}
+
+/**
+ * The CSF surface forge reads, as types a story file can annotate itself with.
+ *
+ * Component Story Format is a plain-module convention — a default export of
+ * meta, one named export per story — and forge's loader (`loadCsfModule`)
+ * implements it directly. These types are that loader's `Annotations`
+ * interface made public, so a CSF file is typed by the tool that runs it.
+ *
+ * They are deliberately narrower than Storybook's: what is here is what forge
+ * reads. A field forge ignores is a field a story should not be writing.
+ */
+
+/** The props a story's args describe: a component type resolves to its props,
+ *  and a bare props type stands for itself. */
+type ArgsOf<T> = T extends ComponentType<infer P> ? P : T;
+/** What a `render`, `decorators` entry or `play` is handed alongside the args. */
+interface CsfStoryContext {
+    args: Record<string, unknown>;
+    globals: Globals;
+    parameters: Record<string, unknown>;
+    title: string;
+    name: string;
+    id: string;
+    viewMode: 'story';
+}
+/** Groups a play function's steps for reporting. */
+type CsfStep = (label: string, fn: () => void | Promise<void>) => Promise<void>;
+/** What a `play` is handed: the story context, the element the story mounted
+ *  into, and `step`. */
+interface CsfPlayContext extends CsfStoryContext {
+    canvasElement: HTMLElement;
+    step: CsfStep;
+}
+/** Wraps a story. `Story` renders whatever it wraps — the next decorator in,
+ *  or the story itself. */
+type CsfDecorator = (Story: ComponentType, context: CsfStoryContext) => ReactNode;
+/** Fields a meta and a story both accept. A story's value wins. */
+interface Shared<T> {
+    args?: Partial<ArgsOf<T>>;
+    argTypes?: Partial<Record<keyof ArgsOf<T> & string, ArgType>> & Record<string, ArgType>;
+    parameters?: Record<string, unknown>;
+    globals?: Record<string, unknown>;
+    decorators?: CsfDecorator | CsfDecorator[];
+    render?: (args: ArgsOf<T>, context: CsfStoryContext) => ReactNode;
+    play?: (context: CsfPlayContext) => void | Promise<void>;
+}
+/** A CSF file's default export: what its stories share, and where they sit in
+ *  the sidebar. */
+interface Meta<T = unknown> extends Shared<T> {
+    /** Sidebar path, `/`-separated. Derived from the file's location when omitted. */
+    title?: string;
+    component?: ComponentType<ArgsOf<T>>;
+    /** Named exports to index as stories. Everything not excluded, by default. */
+    includeStories?: string[] | RegExp;
+    excludeStories?: string[] | RegExp;
+}
+/** One story: a named export of a CSF file. */
+interface StoryObj<T = unknown> extends Shared<T> {
+    /** Overrides the name derived from the export's identifier. */
+    name?: string;
+    /** Storybook's older spelling of `name`; forge reads both. */
+    storyName?: string;
+}
 
 declare function meta(spec: MetaSpec): MetaSpec;
 declare function story<C = Record<string, never>, S = undefined>(spec: StorySpec<C, S>): StorySpec<C, S>;
 
-export { MetaSpec, StorySpec, meta, story };
+export { type ArgType, type ArgsOf, type CsfDecorator, type CsfPlayContext, type CsfStep, type CsfStoryContext, type Meta, MetaSpec, type StoryObj, StorySpec, meta, story };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/config.ts"],"names":[],"mappings":";;;;AAcO,SAAS,kBAAkB,MAAA,EAAgC;AAChE,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,kBAAkB,MAAA,EAAkC;AAClE,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["import type { LabContribution } from '@weasel-js/labkit';\nimport type { ControlRenderer } from '@weasel-js/labkit/config';\nimport type { FrameSetup } from './frame/FrameController';\nimport type { GlobalDeclarations } from './shell/globals';\n\n/** A shell config module: what the workshop adds to the lab. Only the workshop page imports it. */\nexport interface ShellConfig {\n  labChrome?: readonly LabContribution[];\n  controls?: Record<string, ControlRenderer>;\n  /** Globals the lab's header sets for every story, each pinnable per trial. Frames apply them with `applyGlobals`. */\n  globals?: GlobalDeclarations;\n}\n\n/** A frame config module's default export. Only frame documents import it, so its CSS stays out of the workshop. */\nexport function defineFrameConfig(config: FrameSetup): FrameSetup {\n  return config;\n}\n\n/** A shell config module's default export. */\nexport function defineShellConfig(config: ShellConfig): ShellConfig {\n  return config;\n}\n"]}
+{"version":3,"sources":["../src/config.ts"],"names":[],"mappings":";;;;AAkBO,SAAS,kBAAkB,MAAA,EAAgC;AAChE,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,kBAAkB,MAAA,EAAkC;AAClE,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["import type { LabContribution, LabPage } from '@weasel-js/labkit';\nimport type { ControlRenderer } from '@weasel-js/labkit/config';\nimport type { FrameSetup } from './frame/FrameController';\nimport type { GlobalDeclarations } from './shell/globals';\n\n/** A shell config module: what the workshop adds to the lab. Only the workshop page imports it. */\nexport interface ShellConfig {\n  labChrome?: readonly LabContribution[];\n  controls?: Record<string, ControlRenderer>;\n  /** Globals the lab's header sets for every story, each pinnable per trial. Frames apply them with `applyGlobals`. */\n  globals?: GlobalDeclarations;\n  /** The project's other labs, offered in the workshop's title menu. */\n  pages?: readonly LabPage[];\n  /** Which of `pages` the workshop is, when the URL alone cannot say, as across dev servers on different ports. */\n  path?: string;\n}\n\n/** A frame config module's default export. Only frame documents import it, so its CSS stays out of the workshop. */\nexport function defineFrameConfig(config: FrameSetup): FrameSetup {\n  return config;\n}\n\n/** A shell config module's default export. */\nexport function defineShellConfig(config: ShellConfig): ShellConfig {\n  return config;\n}\n"]}

package/dist/shell/index.css

@@ -31,6 +31,16 @@
   width: 100%;
   height: 100%;
   border: 0;
+  transition: opacity var(--wzl-motion-fast) var(--wzl-ease-out-cubic);
+}
+.fg-frame-view[data-pending] {
+  visibility: hidden;
+  opacity: 0;
+}
+@media (prefers-reduced-motion: reduce) {
+  .fg-frame-view {
+    transition: none;
+  }
 }
 .fg-fault {
   position: absolute;
@@ -80,6 +90,7 @@
 .fg-tree__filter {
   box-sizing: border-box;
   width: 100%;
+  font-size: var(--wzl-font-size);
 }
 .fg-tree__items,
 .fg-tree__group {
@@ -87,7 +98,7 @@
   flex-direction: column;
 }
 .fg-tree__items {
-  font-size: var(--wzl-font-size-sm);
+  font-size: var(--wzl-font-size);
 }
 .fg-tree__group {
   padding-inline-start: var(--wzl-space-sm);
@@ -165,34 +176,108 @@
   flex-direction: column;
   gap: var(--wzl-space-xs);
 }
-.fg-css-vars__list {
+.fg-css-vars-focus {
   display: flex;
   flex-direction: column;
   gap: var(--wzl-space-xs);
-  max-height: 60vh;
-  overflow: auto;
+  min-width: 0;
 }
-.fg-css-vars__empty {
+.fg-css-vars__trial {
   margin: 0;
+  overflow: hidden;
   color: var(--wzl-fg-muted);
   font-size: var(--wzl-font-size-sm);
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
-.fg-css-var {
+.fg-css-vars__controls {
+  position: sticky;
+  top: 0;
+  z-index: 1;
   display: flex;
-  align-items: flex-end;
+  flex-direction: column;
   gap: var(--wzl-space-xs);
-  font-family: var(--wzl-font-mono);
+  padding-block-end: var(--wzl-space-xs);
+  background: var(--wzl-surface);
 }
-.fg-css-var__rows {
-  flex: 1;
-  min-width: 0;
+.fg-css-vars__empty {
+  margin: 0;
+  color: var(--wzl-fg-muted);
+  font-size: var(--wzl-font-size-sm);
 }
 .fg-globals {
   display: flex;
   align-items: center;
   gap: var(--wzl-space-xs);
 }
-.fg-globals__select {
+.fg-a11y,
+.fg-a11y-focus {
+  display: flex;
+  flex-direction: column;
+  gap: var(--wzl-space-xs);
+  min-width: 0;
+}
+.fg-a11y__trial {
+  margin: 0;
+  overflow: hidden;
+  color: var(--wzl-fg-muted);
+  font-size: var(--wzl-font-size-sm);
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.fg-a11y__controls {
+  display: flex;
+  gap: var(--wzl-space-xs);
+}
+.fg-a11y__note,
+.fg-a11y__tally {
+  margin: 0;
+  color: var(--wzl-fg-muted);
+  font-size: var(--wzl-font-size-sm);
+  font-variant-numeric: tabular-nums;
+}
+.fg-a11y__group {
+  display: flex;
+  flex-direction: column;
+  gap: var(--wzl-space-xs);
+}
+.fg-a11y__group-title {
+  margin: 0;
   font-size: var(--wzl-font-size-sm);
+  font-variant-numeric: tabular-nums;
+}
+.fg-a11y__findings,
+.fg-a11y__nodes {
+  display: flex;
+  flex-direction: column;
+  gap: var(--wzl-space-xs);
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+.fg-a11y__finding {
+  border-inline-start: 2px solid var(--wzl-border);
+  padding-inline-start: var(--wzl-space-xs);
+}
+.fg-a11y__help {
+  display: flex;
+  align-items: baseline;
+  gap: var(--wzl-space-xs);
+  margin: 0;
+  font-size: var(--wzl-font-size-sm);
+}
+.fg-a11y__impact {
+  color: var(--wzl-fg-muted);
+  font-size: var(--wzl-font-size-xs);
+  text-transform: uppercase;
+}
+.fg-a11y__impact[data-impact=serious],
+.fg-a11y__impact[data-impact=critical] {
+  color: var(--wzl-danger);
+}
+.fg-a11y__nodes {
+  color: var(--wzl-fg-muted);
+  font-size: var(--wzl-font-size-xs);
+  word-break: break-all;
 }
 /*# sourceMappingURL=index.css.map */

package/dist/shell/index.css.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shell/shell.css"],"sourcesContent":[".fg-empty {\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  gap: var(--wzl-space-xs);\n  min-height: 100vh;\n  padding-inline: var(--wzl-space-md);\n  background: var(--wzl-surface-sunken);\n  color: var(--wzl-fg);\n}\n\n.fg-empty__title {\n  margin: 0;\n  font-weight: var(--wzl-font-weight-bold);\n}\n\n.fg-empty__globs {\n  margin: 0;\n  padding: 0;\n  list-style: none;\n  font-family: var(--wzl-font-mono);\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-frame-host {\n  position: relative;\n  width: 100%;\n  height: 100%;\n}\n\n.fg-frame-view {\n  display: block;\n  width: 100%;\n  height: 100%;\n  border: 0;\n}\n\n.fg-fault {\n  position: absolute;\n  inset: 0;\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n  padding: var(--wzl-space-md);\n  overflow: auto;\n  background: var(--wzl-surface-sunken);\n  color: var(--wzl-fg);\n  font-family: var(--wzl-font-mono);\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-fault__phase {\n  color: var(--wzl-danger);\n  font-weight: var(--wzl-font-weight-bold);\n  text-transform: uppercase;\n}\n\n.fg-fault__message {\n  margin: 0;\n  white-space: pre-wrap;\n}\n\n.fg-tree {\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n  padding: 0 var(--wzl-space-xs) var(--wzl-space-xs);\n  border-bottom: var(--wzl-border-w) solid var(--wzl-line-subtle);\n  color: var(--wzl-fg);\n}\n\n.fg-tree__heading {\n  margin: 0;\n  padding-block: var(--wzl-space-xs);\n  color: var(--wzl-fg-muted);\n  font-family: var(--wzl-font-display);\n  font-size: var(--wzl-font-size-sm);\n  font-weight: var(--wzl-font-weight-normal);\n  letter-spacing: 0.08em;\n  text-transform: uppercase;\n}\n\n.fg-route-miss {\n  margin: 0;\n  color: var(--wzl-danger);\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-tree__filter {\n  box-sizing: border-box;\n  width: 100%;\n}\n\n.fg-tree__items,\n.fg-tree__group {\n  display: flex;\n  flex-direction: column;\n}\n\n.fg-tree__items {\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-tree__group {\n  padding-inline-start: var(--wzl-space-sm);\n}\n\n.fg-tree__node {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  outline: none;\n}\n\n.fg-tree__item {\n  display: flex;\n  align-items: center;\n  gap: var(--wzl-space-xs);\n  padding: calc(var(--wzl-space-xs) / 2) var(--wzl-space-xs);\n  border-radius: var(--wzl-radius-sm);\n  overflow: hidden;\n  color: inherit;\n  text-decoration: none;\n  white-space: nowrap;\n  cursor: pointer;\n}\n\n/* text-overflow does not reach a flex container's anonymous text box, so the label clips itself. */\n.fg-tree__label {\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.fg-tree__item:hover {\n  background: var(--wzl-surface-hover);\n}\n\n/* A folder item holds its group, so its ring goes on its own row rather than around the subtree. */\n.fg-tree__story:focus-visible,\n.fg-tree__node:focus-visible > .fg-tree__folder {\n  outline: var(--wzl-line-width) solid var(--wzl-accent);\n  outline-offset: calc(-1 * var(--wzl-line-width));\n}\n\n.fg-tree__item[aria-current='true'] {\n  color: var(--wzl-accent);\n}\n\n/* Drawn with borders rather than a glyph, which would join the item's accessible name. */\n.fg-tree__folder::before {\n  content: '';\n  flex: none;\n  width: 0.35em;\n  height: 0.35em;\n  border: solid currentColor;\n  border-width: 0 1.5px 1.5px 0;\n  transform: rotate(-45deg);\n}\n\n.fg-tree__node[aria-expanded='true'] > .fg-tree__folder::before {\n  transform: rotate(45deg);\n}\n\n.fg-tree__story {\n  padding-inline-start: calc(var(--wzl-space-xs) * 2 + 0.35em);\n}\n\n.lk-trial.fg-flash {\n  outline: var(--wzl-line-width) solid var(--wzl-accent);\n  outline-offset: calc(-1 * var(--wzl-line-width));\n  animation: fg-flash 600ms ease-out forwards;\n}\n\n@keyframes fg-flash {\n  from {\n    outline-color: var(--wzl-accent);\n  }\n  to {\n    outline-color: transparent;\n  }\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .lk-trial.fg-flash {\n    animation: none;\n  }\n}\n\n.fg-css-vars {\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n}\n\n.fg-css-vars__list {\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n  max-height: 60vh;\n  overflow: auto;\n}\n\n.fg-css-vars__empty {\n  margin: 0;\n  color: var(--wzl-fg-muted);\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-css-var {\n  display: flex;\n  align-items: flex-end;\n  gap: var(--wzl-space-xs);\n  font-family: var(--wzl-font-mono);\n}\n\n.fg-css-var__rows {\n  flex: 1;\n  min-width: 0;\n}\n\n.fg-globals {\n  display: flex;\n  align-items: center;\n  gap: var(--wzl-space-xs);\n}\n\n.fg-globals__select {\n  font-size: var(--wzl-font-size-sm);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/shell/shell.css"],"sourcesContent":[".fg-empty {\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  gap: var(--wzl-space-xs);\n  min-height: 100vh;\n  padding-inline: var(--wzl-space-md);\n  background: var(--wzl-surface-sunken);\n  color: var(--wzl-fg);\n}\n\n.fg-empty__title {\n  margin: 0;\n  font-weight: var(--wzl-font-weight-bold);\n}\n\n.fg-empty__globs {\n  margin: 0;\n  padding: 0;\n  list-style: none;\n  font-family: var(--wzl-font-mono);\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-frame-host {\n  position: relative;\n  width: 100%;\n  height: 100%;\n}\n\n.fg-frame-view {\n  display: block;\n  width: 100%;\n  height: 100%;\n  border: 0;\n  transition: opacity var(--wzl-motion-fast) var(--wzl-ease-out-cubic);\n}\n\n.fg-frame-view[data-pending] {\n  visibility: hidden;\n  opacity: 0;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .fg-frame-view {\n    transition: none;\n  }\n}\n\n.fg-fault {\n  position: absolute;\n  inset: 0;\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n  padding: var(--wzl-space-md);\n  overflow: auto;\n  background: var(--wzl-surface-sunken);\n  color: var(--wzl-fg);\n  font-family: var(--wzl-font-mono);\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-fault__phase {\n  color: var(--wzl-danger);\n  font-weight: var(--wzl-font-weight-bold);\n  text-transform: uppercase;\n}\n\n.fg-fault__message {\n  margin: 0;\n  white-space: pre-wrap;\n}\n\n.fg-tree {\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n  padding: 0 var(--wzl-space-xs) var(--wzl-space-xs);\n  border-bottom: var(--wzl-border-w) solid var(--wzl-line-subtle);\n  color: var(--wzl-fg);\n}\n\n.fg-tree__heading {\n  margin: 0;\n  padding-block: var(--wzl-space-xs);\n  color: var(--wzl-fg-muted);\n  font-family: var(--wzl-font-display);\n  font-size: var(--wzl-font-size-sm);\n  font-weight: var(--wzl-font-weight-normal);\n  letter-spacing: 0.08em;\n  text-transform: uppercase;\n}\n\n.fg-route-miss {\n  margin: 0;\n  color: var(--wzl-danger);\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-tree__filter {\n  box-sizing: border-box;\n  width: 100%;\n  font-size: var(--wzl-font-size);\n}\n\n.fg-tree__items,\n.fg-tree__group {\n  display: flex;\n  flex-direction: column;\n}\n\n.fg-tree__items {\n  font-size: var(--wzl-font-size);\n}\n\n.fg-tree__group {\n  padding-inline-start: var(--wzl-space-sm);\n}\n\n.fg-tree__node {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  outline: none;\n}\n\n.fg-tree__item {\n  display: flex;\n  align-items: center;\n  gap: var(--wzl-space-xs);\n  padding: calc(var(--wzl-space-xs) / 2) var(--wzl-space-xs);\n  border-radius: var(--wzl-radius-sm);\n  overflow: hidden;\n  color: inherit;\n  text-decoration: none;\n  white-space: nowrap;\n  cursor: pointer;\n}\n\n/* text-overflow does not reach a flex container's anonymous text box, so the label clips itself. */\n.fg-tree__label {\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.fg-tree__item:hover {\n  background: var(--wzl-surface-hover);\n}\n\n/* A folder item holds its group, so its ring goes on its own row rather than around the subtree. */\n.fg-tree__story:focus-visible,\n.fg-tree__node:focus-visible > .fg-tree__folder {\n  outline: var(--wzl-line-width) solid var(--wzl-accent);\n  outline-offset: calc(-1 * var(--wzl-line-width));\n}\n\n.fg-tree__item[aria-current='true'] {\n  color: var(--wzl-accent);\n}\n\n/* Drawn with borders rather than a glyph, which would join the item's accessible name. */\n.fg-tree__folder::before {\n  content: '';\n  flex: none;\n  width: 0.35em;\n  height: 0.35em;\n  border: solid currentColor;\n  border-width: 0 1.5px 1.5px 0;\n  transform: rotate(-45deg);\n}\n\n.fg-tree__node[aria-expanded='true'] > .fg-tree__folder::before {\n  transform: rotate(45deg);\n}\n\n.fg-tree__story {\n  padding-inline-start: calc(var(--wzl-space-xs) * 2 + 0.35em);\n}\n\n.lk-trial.fg-flash {\n  outline: var(--wzl-line-width) solid var(--wzl-accent);\n  outline-offset: calc(-1 * var(--wzl-line-width));\n  animation: fg-flash 600ms ease-out forwards;\n}\n\n@keyframes fg-flash {\n  from {\n    outline-color: var(--wzl-accent);\n  }\n  to {\n    outline-color: transparent;\n  }\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .lk-trial.fg-flash {\n    animation: none;\n  }\n}\n\n.fg-css-vars {\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n}\n\n.fg-css-vars-focus {\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n  min-width: 0;\n}\n\n.fg-css-vars__trial {\n  margin: 0;\n  overflow: hidden;\n  color: var(--wzl-fg-muted);\n  font-size: var(--wzl-font-size-sm);\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n/* Held at the top while the list scrolls the aside under it. */\n.fg-css-vars__controls {\n  position: sticky;\n  top: 0;\n  z-index: 1;\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n  padding-block-end: var(--wzl-space-xs);\n  background: var(--wzl-surface);\n}\n\n.fg-css-vars__empty {\n  margin: 0;\n  color: var(--wzl-fg-muted);\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-globals {\n  display: flex;\n  align-items: center;\n  gap: var(--wzl-space-xs);\n}\n\n\n.fg-a11y,\n.fg-a11y-focus {\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n  min-width: 0;\n}\n\n.fg-a11y__trial {\n  margin: 0;\n  overflow: hidden;\n  color: var(--wzl-fg-muted);\n  font-size: var(--wzl-font-size-sm);\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.fg-a11y__controls {\n  display: flex;\n  gap: var(--wzl-space-xs);\n}\n\n.fg-a11y__note,\n.fg-a11y__tally {\n  margin: 0;\n  color: var(--wzl-fg-muted);\n  font-size: var(--wzl-font-size-sm);\n  font-variant-numeric: tabular-nums;\n}\n\n.fg-a11y__group {\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n}\n\n.fg-a11y__group-title {\n  margin: 0;\n  font-size: var(--wzl-font-size-sm);\n  font-variant-numeric: tabular-nums;\n}\n\n.fg-a11y__findings,\n.fg-a11y__nodes {\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n  margin: 0;\n  padding: 0;\n  list-style: none;\n}\n\n.fg-a11y__finding {\n  border-inline-start: 2px solid var(--wzl-border);\n  padding-inline-start: var(--wzl-space-xs);\n}\n\n.fg-a11y__help {\n  display: flex;\n  align-items: baseline;\n  gap: var(--wzl-space-xs);\n  margin: 0;\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-a11y__impact {\n  color: var(--wzl-fg-muted);\n  font-size: var(--wzl-font-size-xs);\n  text-transform: uppercase;\n}\n\n.fg-a11y__impact[data-impact='serious'],\n.fg-a11y__impact[data-impact='critical'] {\n  color: var(--wzl-danger);\n}\n\n.fg-a11y__nodes {\n  color: var(--wzl-fg-muted);\n  font-size: var(--wzl-font-size-xs);\n  word-break: break-all;\n}\n"],"mappings":"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","names":[]}

package/dist/shell/index.d.ts

@@ -1,10 +1,15 @@
-import { I as IndexEntry, c as FromFrame } from '../FrameController-Ba3LaWfq.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { StorageAdapter, InstrumentList } from '@weasel-js/labkit';
-import { S as ShellConfig, a as GlobalDeclarations } from '../config-DdumOfyd.js';
+import { LabContribution, StorageAdapter, InstrumentList } from '@weasel-js/labkit';
+import { I as IndexEntry, e as FromFrame, b as A11yReport, T as ToFrame, C as CssVarReport, f as CapturedPicture, V as Viewport } from '../FrameController-BPfCt4PJ.js';
+import { S as ShellConfig, a as GlobalDeclarations } from '../config-CrLpfSq9.js';
 import * as react from 'react';
+import { RefObject } from 'react';
 import '@weasel-js/labkit/config';
 
+/** What axe found in the story of the trial this is rendered inside, re-run on demand. */
+declare function A11yPanel(): react_jsx_runtime.JSX.Element;
+declare const A11Y_SECTION: LabContribution;
+
 interface WorkshopProps {
     index: readonly IndexEntry[];
     frameUrl: string;
@@ -34,6 +39,54 @@ type Ready = Extract<FromFrame, {
     type: 'ready';
 }>;
 
+type Send = (msg: ToFrame) => void;
+/** What an axe run in the frame came back with. */
+type A11yOutcome = {
+    ok: true;
+    report: A11yReport;
+} | {
+    ok: false;
+    message: string;
+};
+/** The half of a trial's frame that answers a request: each call is one round trip over the frame's channel. */
+interface TrialFrameCalls {
+    send: Send;
+    audit: () => Promise<A11yOutcome>;
+    /** Rejects when the frame could not draw itself, or went away before it did. */
+    capture: () => Promise<CapturedPicture>;
+}
+/** What trial chrome can reach of the frame its trial shows. */
+interface TrialFrame {
+    /** Null while no frame is connected. */
+    send: Send | null;
+    /** The frame's latest `vars` report. */
+    vars: readonly CssVarReport[];
+    /** Runs axe over the story and records the answer as `a11y`. Null while no frame is connected. */
+    audit: (() => Promise<A11yOutcome>) | null;
+    /** What the last audit found; null until one has run against the connected frame. */
+    a11y: A11yOutcome | null;
+    /** The story's own picture, for an export to draw over. Null while no frame is connected. */
+    capture: (() => Promise<CapturedPicture>) | null;
+    /** The story's content box, as the frame last measured it; null until it has. */
+    size: Viewport | null;
+}
+/** Each trial's frame, keyed by trial id: `FrameView` connects and reports, trial chrome reads. */
+interface TrialFrames {
+    /** Returns a disconnect that does nothing once a newer connection replaced this one. */
+    connect(trialId: string, calls: TrialFrameCalls): () => void;
+    report(trialId: string, vars: readonly CssVarReport[]): void;
+    reportA11y(trialId: string, outcome: A11yOutcome): void;
+    reportSize(trialId: string, size: Viewport): void;
+    /** The element a trial's frame is mounted in — stable across the frame reloads that replace the link,
+     *  because an annotation target's ref has to outlive them. */
+    hostRef(trialId: string): RefObject<HTMLElement | null>;
+    get(trialId: string): TrialFrame;
+    subscribe(listener: () => void): () => void;
+}
+declare const TrialFramesContext: react.Context<TrialFrames | null>;
+/** The frame of the trial `trialId` names, re-read when it connects or reports. */
+declare function useTrialFrame(trialId: string): TrialFrame;
+
 interface StoryRegistry {
     instruments: InstrumentList;
     /** Called by FrameView. Replaces the story's instrument only when `ready.schema`, layout or viewport differ from what it holds. */
@@ -46,6 +99,7 @@ interface StoryRegistry {
 declare function useStoryRegistry(index: readonly IndexEntry[], options: {
     frameUrl: string;
     globals?: GlobalDeclarations;
+    frames?: TrialFrames;
 }): StoryRegistry;
 
-export { type MountWorkshopOptions, type MountedWorkshop, StoryGlobalsContext, type StoryRegistry, Workshop, type WorkshopProps, mountWorkshop, useStoryRegistry };
+export { A11Y_SECTION, type A11yOutcome, A11yPanel, type MountWorkshopOptions, type MountedWorkshop, StoryGlobalsContext, type StoryRegistry, type TrialFrame, type TrialFrames, TrialFramesContext, Workshop, type WorkshopProps, mountWorkshop, useStoryRegistry, useTrialFrame };