@weasel-js/forge 1.11.0 → 1.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weasel-js/forge",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "description": "A component workshop on labkit: stories in isolated frames, controls and state in lab trials.",
   "license": "MIT",
   "type": "module",
@@ -69,11 +69,12 @@
     "@testing-library/dom": "^10.4.0",
     "@testing-library/user-event": "^14.6.1",
     "@vitest/expect": "^5.0.2",
-    "@weasel-js/icons": "1.11.0",
-    "@weasel-js/prefs": "1.11.0",
-    "@weasel-js/registry": "1.11.0",
-    "@weasel-js/theme": "1.11.0",
-    "@weasel-js/ui": "1.11.0",
+    "@weasel-js/icons": "1.12.0",
+    "@weasel-js/prefs": "1.12.0",
+    "@weasel-js/registry": "1.12.0",
+    "@weasel-js/svg": "1.12.0",
+    "@weasel-js/theme": "1.12.0",
+    "@weasel-js/ui": "1.12.0",
     "axe-core": "^4.13.0",
     "chai": "^6.2.2"
   },
@@ -81,15 +82,19 @@
     "@babel/types": "^8.0.6"
   },
   "peerDependencies": {
-    "@weasel-js/core": "1.11.0",
-    "@weasel-js/labkit": "1.11.0",
+    "@weasel-js/core": "1.12.0",
+    "@weasel-js/labkit": "1.12.0",
     "react": "^19.0.0",
+    "playwright": "^1.50.0",
     "react-dom": "^19.0.0",
     "typescript": ">=5.0.0",
     "vite": "^8.0.0",
     "vitest": "^4.0.0 || ^5.0.0"
   },
   "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    },
     "typescript": {
       "optional": true
     },

package/dist/chunk-2OJAV522.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/protocol/messages.ts"],"names":[],"mappings":";;;AAEO,IAAM,gBAAA,GAAmB;AA2FzB,IAAM,YAAA,GAAe;AASrB,IAAM,WAAA,GAAc","file":"chunk-2OJAV522.js","sourcesContent":["import type { SchemaDescription } from './schema.ts';\n\nexport const PROTOCOL_VERSION = 1;\n\n/** The workshop's toolbar globals as a story reads them, by name. */\nexport type Globals = Readonly<Record<string, unknown>>;\n/** How a story sits in its frame. */\nexport type Layout = 'centered' | 'padded' | 'fullscreen';\n/** A frame size a story asks for, in CSS pixels. */\nexport interface Viewport {\n  width: number;\n  height: number;\n}\n/** Where a frame's fault happened: loading the story, rendering it, or reading a message. */\nexport type FaultPhase = 'import' | 'render' | 'protocol';\n\n/** One custom property as the frame found it. */\nexport interface CssVarReport {\n  name: string;\n  value: string;\n  /** Whether a `vars.set` override is in force on it. */\n  overridden: boolean;\n  /** Whether the story reads it, directly or through another property it reads. */\n  used: boolean;\n}\n\n/** Visibility and validation answers, keyed by the config they were computed for. */\nexport interface ConfigAnswers {\n  /** `stableStringify(config)` of the config the frame evaluated. */\n  configKey: string;\n  hidden: string[];\n  errors: Record<string, string[]>;\n}\n\n/** One element axe faulted on, inside the frame's own document. */\nexport interface A11yNode {\n  /** The CSS selectors, outermost first, that reach the element in the frame. */\n  target: readonly string[];\n  html: string;\n  failureSummary?: string;\n}\n\n/** One axe rule's outcome on the story, with the elements it names. */\nexport interface A11yFinding {\n  id: string;\n  impact: 'minor' | 'moderate' | 'serious' | 'critical' | null;\n  help: string;\n  helpUrl: string;\n  description: string;\n  nodes: readonly A11yNode[];\n}\n\n/** What axe found on one story: the rules it failed, and the ones it could not decide. */\nexport interface A11yReport {\n  violations: readonly A11yFinding[];\n  incomplete: readonly A11yFinding[];\n  /** Rules that passed, and rules no element on the page could be judged by. */\n  passes: number;\n  inapplicable: number;\n}\n\n/** A message the workshop sends a story's frame. */\nexport type ToFrame =\n  | { type: 'init'; config: unknown; state: unknown; globals: Globals }\n  | { type: 'config'; config: unknown }\n  | { type: 'state'; state: unknown }\n  | { type: 'globals'; globals: Globals }\n  | { type: 'vars.set'; name: string; value: string | null }\n  /** Run axe over the story's own subtree. Answered by `a11y` carrying the same `id`. */\n  | { type: 'a11y.run'; id: string };\n\n/** A message a story's frame sends the workshop. */\nexport type FromFrame =\n  | { type: 'ready'; schema: SchemaDescription; layout: Layout; viewport: Viewport | null }\n  /** Sent once, when the story's first render after `init` has committed. */\n  | { type: 'rendered' }\n  | { type: 'answers'; answers: ConfigAnswers }\n  | { type: 'setConfig'; path: string; value: unknown }\n  | { type: 'setState'; state: unknown }\n  | { type: 'vars'; vars: CssVarReport[] }\n  /** Asks the shell to show story `id` in this frame's trial in place of what it shows now. */\n  | { type: 'open'; id: string }\n  | { type: 'a11y'; id: string; ok: true; report: A11yReport }\n  | { type: 'a11y'; id: string; ok: false; message: string }\n  /** `seq`, on a render fault only: how many `init`/`config`/`state`/`globals` messages the frame had received. */\n  | { type: 'fault'; phase: FaultPhase; message: string; stack?: string; seq?: number };\n\nexport interface Envelope<M> {\n  v: number;\n  msg: M;\n}\n\n/** Posted on the frame's window with the port transferred alongside it, as a `PortHandoff`. */\nexport const PORT_HANDOFF = 'weaselforge:port';\n\n/** What the shell posts with the port: `id` names what the frame shows, a story or an index. */\nexport interface PortHandoff {\n  type: typeof PORT_HANDOFF;\n  id: string;\n}\n\n/** Posted by a frame document to its parent as soon as its entry runs, asking for a port. */\nexport const FRAME_HELLO = 'weaselforge:hello';\n\nexport { stableStringify } from '@weasel-js/core';\n"]}

package/dist/chunk-5DXUNLV2.js

@@ -1,6 +0,0 @@
-// src/title.ts
-var DEFAULT_TITLE = "weaselforge";
-
-export { DEFAULT_TITLE };
-//# sourceMappingURL=chunk-5DXUNLV2.js.map
-//# sourceMappingURL=chunk-5DXUNLV2.js.map

package/dist/chunk-5DXUNLV2.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/title.ts"],"names":[],"mappings":";AACO,IAAM,aAAA,GAAgB","file":"chunk-5DXUNLV2.js","sourcesContent":["/** The workshop's name when the shell config gives none: in its header, and as the document title. */\nexport const DEFAULT_TITLE = 'weaselforge';\n"]}

package/dist/chunk-7BQPHMA2.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/shell/globals.ts"],"names":["from"],"mappings":"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","file":"chunk-7BQPHMA2.js","sourcesContent":["import { isPlainObject } from '@weasel-js/core';\nimport type { IconRef } from '@weasel-js/icons';\nimport type { LabMode } from '@weasel-js/labkit';\nimport { type ConfigSchema, f } from '@weasel-js/labkit/config';\nimport type { Globals } from '../protocol/messages';\n\n/** One global the workshop's toolbar sets for every story, and a trial may pin for its own. */\nexport interface GlobalDeclaration {\n  label: string;\n  options: readonly { value: string; label: string }[];\n  default: string;\n  /** Another global's key: the toolbar shows this one in a popover beside that one rather than in the bar itself. */\n  under?: string;\n  /** The glyph on the button opening the globals declared `under` this one. Default `core:tune`. */\n  icon?: IconRef;\n  /**\n   * Whether the toolbar offers `value` given the lab's other values; every option shows when absent. `globals` is\n   * resolved without any declaration's `shows`, so one `shows` cannot depend on another's outcome.\n   */\n  shows?: (value: string, globals: Globals) => boolean;\n  /**\n   * What this global reads from the lab's own chrome. Given, the lab's value may be `App` (`FOLLOW_APP`), offered\n   * first, and while it is the global follows that chrome control, as the header's mode switch sets it. A trial's\n   * pin follows the lab or names a value; it cannot follow the app on its own.\n   */\n  follows?: (chrome: LabChrome) => string;\n}\n\n/** The lab chrome's own settings a global can follow. */\nexport interface LabChrome {\n  mode: LabMode;\n}\n\n/** The shell config's `globals`: each declaration by the key stories read it under. */\nexport type GlobalDeclarations = Readonly<Record<string, GlobalDeclaration>>;\n\n/** The config group every story schema gains, holding the trial's pins. A story never sees it. */\nexport const GLOBALS_KEY = '$globals';\n/** A pin's value when the trial follows the lab. */\nexport const FOLLOW_LAB = 'lab';\n/** A lab value, for a declaration that `follows` the app, meaning whatever the app's chrome is set to. */\nexport const FOLLOW_APP = 'app';\n\nconst APP_OPTION = { value: FOLLOW_APP, label: 'App' } as const;\n\nconst isRecord = isPlainObject;\n\nexport const isGlobalsPath = (path: string): boolean => path === GLOBALS_KEY || path.startsWith(`${GLOBALS_KEY}.`);\n\n/** The config key a timeline story's paused playhead is kept under, so labkit persists and snapshots it. */\nexport const PLAYHEAD_KEY = '$playhead';\n\n/** Config keys forge owns: a story neither sees nor writes them. */\nconst FORGE_KEYS: ReadonlySet<string> = new Set([GLOBALS_KEY, PLAYHEAD_KEY]);\n\n/** Whether a config path lies under a key forge owns. */\nexport const isForgePath = (path: string): boolean => FORGE_KEYS.has(path.split('.')[0]!);\n\n/** The options the toolbar offers for `declaration` at `globals`. */\nexport function shownOptions(declaration: GlobalDeclaration, globals: Globals): GlobalDeclaration['options'] {\n  const { shows } = declaration;\n  return shows ? declaration.options.filter((option) => shows(option.value, globals)) : declaration.options;\n}\n\n/** The options the lab's own control offers: `shownOptions`, after `App` where the declaration follows the app. */\nexport function labOptions(declaration: GlobalDeclaration, globals: Globals): GlobalDeclaration['options'] {\n  const shown = shownOptions(declaration, globals);\n  return declaration.follows ? [APP_OPTION, ...shown] : shown;\n}\n\n/** `values` with each `App` replaced by what its declaration reads from `chrome`; `values` itself when none is. */\nexport function followApp(declarations: GlobalDeclarations, values: Globals, chrome: LabChrome): Globals {\n  const followed = Object.entries(declarations).flatMap(([key, { follows }]) =>\n    follows && values[key] === FOLLOW_APP ? [[key, follows(chrome)] as const] : [],\n  );\n  return followed.length === 0 ? values : { ...values, ...Object.fromEntries(followed) };\n}\n\n/**\n * The lab's values from what was stored: declared keys only. A value no option offers falls back to the default, and\n * one its declaration's `shows` hides falls back to the shown option nearest it in `options`, the earlier on a tie.\n */\nexport function labGlobals(declarations: GlobalDeclarations, stored: unknown): Globals {\n  const from = isRecord(stored) ? stored : {};\n  const offered: Globals = Object.fromEntries(\n    Object.entries(declarations).map(([key, declaration]) => {\n      const value = from[key];\n      const known =\n        declaration.options.some((option) => option.value === value) || (declaration.follows && value === FOLLOW_APP);\n      return [key, known ? value : declaration.default];\n    }),\n  );\n  return Object.fromEntries(\n    Object.entries(declarations).map(([key, declaration]) => {\n      const shown = shownOptions(declaration, offered);\n      const value = offered[key];\n      if (value === FOLLOW_APP && declaration.follows) return [key, value];\n      if (!declaration.shows || shown.length === 0 || shown.some((option) => option.value === value)) return [key, value];\n      const at = (v: unknown) => declaration.options.findIndex((option) => option.value === v);\n      const from = at(value);\n      const nearest = shown.reduce((best, option) =>\n        Math.abs(at(option.value) - from) < Math.abs(at(best.value) - from) ? option : best,\n      );\n      return [key, nearest.value];\n    }),\n  );\n}\n\n/** The lab's values, overridden by the pins in a trial's config that do not follow the lab. */\nexport function effectiveGlobals(lab: Globals, pins: unknown): Globals {\n  if (!isRecord(pins)) return lab;\n  const pinned = Object.entries(pins).filter(([key, value]) => key in lab && value !== FOLLOW_LAB);\n  return pinned.length === 0 ? lab : { ...lab, ...Object.fromEntries(pinned) };\n}\n\n/**\n * The config a story receives: the trial's, without the keys forge owns. Returns `previous` when every other entry is\n * the same, so a change to a pin or the playhead alone is not a change to the story's config.\n */\nexport function storyConfig(config: unknown, previous?: unknown): unknown {\n  if (!isRecord(config) || !Object.keys(config).some((key) => FORGE_KEYS.has(key))) return config;\n  const rest = Object.fromEntries(Object.entries(config).filter(([key]) => !FORGE_KEYS.has(key)));\n  if (isRecord(previous)) {\n    const keys = Object.keys(rest);\n    if (keys.length === Object.keys(previous).length && keys.every((key) => rest[key] === previous[key])) return previous;\n  }\n  return rest;\n}\n\n/** `schema` with a `$globals` group appended: one leaf per declaration, following the lab until pinned. */\nexport function withGlobals(schema: ConfigSchema<unknown>, declarations: GlobalDeclarations): ConfigSchema<unknown> {\n  const entries = Object.entries(declarations);\n  if (entries.length === 0) return schema;\n  const leaves = Object.fromEntries(\n    entries.map(([key, declaration]) => [\n      key,\n      f.enum(FOLLOW_LAB, [{ value: FOLLOW_LAB, label: 'Lab' }, ...declaration.options]).label(declaration.label),\n    ]),\n  );\n  // An empty group name contributes rows without a heading of its own, under the section's.\n  const group = f.group(leaves).label('').section('Globals', { layout: 'inline', pack: 'pairs', className: 'fg-globals-pins' });\n  return f.schema({ ...schema.nodes, [GLOBALS_KEY]: group }) as ConfigSchema<unknown>;\n}\n"]}

package/dist/chunk-J3GYSNCK.js

@@ -1,285 +0,0 @@
-import { GLOBALS_KEY, effectiveGlobals, storyConfig, isForgePath, PLAYHEAD_KEY } from './chunk-7BQPHMA2.js';
-import { StoryHost, useNearViewport, IN_VIEW_MARGIN, createOverrides, createGlobalsTarget, useStoryClock, useClockLoop, scanCssVars, runAxe } from './chunk-NVNTQ4AT.js';
-import { ClockContext } from './chunk-L5XM5VKB.js';
-import { createEmitter } from '@weasel-js/registry';
-import { createContext, memo, useContext, useCallback, useSyncExternalStore, useMemo, useId, useState, useRef, useLayoutEffect, useEffect } from 'react';
-import { useLatest } from '@weasel-js/core';
-import { usePersistedState, TrialIdContext, LabBoundary } from '@weasel-js/labkit';
-import { OverlayPortalProvider } from '@weasel-js/ui';
-import { jsx } from 'react/jsx-runtime';
-
-var NO_FRAME = { send: null, vars: [], audit: null, a11y: null };
-function createTrialFrames() {
-  const frames = /* @__PURE__ */ new Map();
-  const changes = createEmitter();
-  const changed = changes.emit;
-  const patch = (trialId, next) => {
-    const frame = frames.get(trialId);
-    if (!frame) return;
-    frames.set(trialId, { ...frame, ...next });
-    changed();
-  };
-  return {
-    connect(trialId, calls) {
-      frames.set(trialId, { send: calls.send, vars: [], audit: calls.audit, a11y: null });
-      changed();
-      return () => {
-        if (frames.get(trialId)?.send !== calls.send) return;
-        frames.delete(trialId);
-        changed();
-      };
-    },
-    report: (trialId, vars) => patch(trialId, { vars }),
-    reportA11y: (trialId, a11y) => patch(trialId, { a11y }),
-    get: (trialId) => frames.get(trialId) ?? NO_FRAME,
-    subscribe: changes.subscribe
-  };
-}
-var TrialFramesContext = createContext(null);
-function useTrialFrame(trialId) {
-  const frames = useContext(TrialFramesContext);
-  const subscribe = useCallback((listener) => frames?.subscribe(listener) ?? (() => {
-  }), [frames]);
-  const read = () => frames?.get(trialId) ?? NO_FRAME;
-  return useSyncExternalStore(subscribe, read, read);
-}
-var StoryGlobalsContext = createContext({});
-var NONE = {};
-function useCssOverrides() {
-  return usePersistedState("fg-css-overrides", NONE, { scope: "trial" });
-}
-var VARS_SETTLE_MS = 100;
-var scopeOf = (id) => `[data-fg-host="${id}"]`;
-function TrialHost({ layout, setup, config, children, hostRef, onRendered }) {
-  const trialId = useContext(TrialIdContext);
-  const frames = useContext(TrialFramesContext);
-  const labGlobals = useContext(StoryGlobalsContext);
-  const pins = config?.[GLOBALS_KEY];
-  const globals = useMemo(() => effectiveGlobals(labGlobals, pins), [labGlobals, pins]);
-  const [persisted] = useCssOverrides();
-  const reactId = useId();
-  const hostId = trialId ?? reactId;
-  const [host, setHost] = useState(null);
-  const elementRef = useRef(null);
-  const inView = useNearViewport(elementRef, IN_VIEW_MARGIN);
-  const [pending, setPending] = useState(true);
-  const overridesRef = useRef(null);
-  const latest = useLatest({ setup, onRendered });
-  useLayoutEffect(() => {
-    if (!host) return;
-    const doc = host.ownerDocument;
-    const scope = scopeOf(hostId);
-    const { cssVarsScope } = latest.current.setup;
-    const overrides = createOverrides(doc, cssVarsScope ? `${scope}, ${scope} :is(${cssVarsScope})` : scope);
-    overridesRef.current = overrides;
-    let lastVars = null;
-    let reported = null;
-    const publish = (vars) => {
-      lastVars = vars;
-      const key = JSON.stringify(vars);
-      if (key === reported) return;
-      reported = key;
-      if (trialId) frames?.report(trialId, vars);
-    };
-    const scan = () => publish(scanCssVars(doc, overrides.has, host));
-    let settleTimer;
-    const ownMutation = (record) => overrides.owns(record.target) || record.type === "childList" && [...record.addedNodes, ...record.removedNodes].length > 0 && [...record.addedNodes, ...record.removedNodes].every(overrides.owns);
-    const mutations = typeof MutationObserver === "undefined" ? null : new MutationObserver((records) => {
-      if (records.every(ownMutation)) return;
-      clearTimeout(settleTimer);
-      settleTimer = setTimeout(scan, VARS_SETTLE_MS);
-    });
-    mutations?.observe(host, { subtree: true, childList: true, characterData: true, attributes: true });
-    const send = (msg) => {
-      if (msg.type !== "vars.set") return;
-      overrides.set(msg.name, msg.value);
-      if (lastVars?.some((v) => v.name === msg.name)) scan();
-    };
-    const audit = async () => {
-      let outcome;
-      try {
-        outcome = { ok: true, report: await runAxe(host, { page: false }) };
-      } catch (error) {
-        outcome = { ok: false, message: error instanceof Error ? error.message : String(error) };
-      }
-      if (trialId) frames?.reportA11y(trialId, outcome);
-      return outcome;
-    };
-    const disconnect = frames && trialId ? frames.connect(trialId, { send, audit }) : () => {
-    };
-    return () => {
-      disconnect();
-      mutations?.disconnect();
-      clearTimeout(settleTimer);
-      overrides.dispose();
-      overridesRef.current = null;
-    };
-  }, [host, hostId, trialId, frames, latest]);
-  const applied = useRef({});
-  useLayoutEffect(() => {
-    const overrides = overridesRef.current;
-    if (!overrides) return;
-    for (const name of Object.keys(applied.current)) if (!(name in persisted)) overrides.set(name, null);
-    for (const [name, value] of Object.entries(persisted)) overrides.set(name, value);
-    applied.current = { ...persisted };
-  }, [host, persisted]);
-  useLayoutEffect(() => {
-    if (!host) return;
-    const target = createGlobalsTarget(host, scopeOf(hostId));
-    latest.current.setup.applyGlobals?.(globals, target);
-    return () => target.dispose();
-  }, [host, hostId, globals, latest]);
-  const announced = useRef(false);
-  useEffect(() => {
-    if (!host || !inView || announced.current) return;
-    let canceled = false;
-    const done = () => {
-      if (canceled) return;
-      announced.current = true;
-      setPending(false);
-      latest.current.onRendered?.();
-    };
-    const { fonts } = host.ownerDocument;
-    if (!fonts) {
-      done();
-      return;
-    }
-    const afterPaint = () => requestAnimationFrame(done);
-    void fonts.ready.then(afterPaint, afterPaint);
-    return () => {
-      canceled = true;
-    };
-  }, [host, inView, latest]);
-  return /* @__PURE__ */ jsx(
-    "div",
-    {
-      ref: (el) => {
-        elementRef.current = el;
-        if (hostRef) hostRef.current = el;
-        setHost(el);
-      },
-      className: "fg-story",
-      "data-fg-host": hostId,
-      "data-fg-layout": layout,
-      "data-pending": pending || void 0,
-      children: host && inView ? (
-        // The workshop is itself a lab; below the boundary a story sees no lab, trial or theme above it, as in a
-        // document of its own.
-        /* @__PURE__ */ jsx(LabBoundary, { children: /* @__PURE__ */ jsx(OverlayPortalProvider, { container: host, children: children(globals) }) })
-      ) : null
-    }
-  );
-}
-function createTrialClocks() {
-  const clocks = /* @__PURE__ */ new Map();
-  const changed = createEmitter();
-  const notify = changed.emit;
-  return {
-    publish(trialId, clock) {
-      clocks.set(trialId, clock);
-      notify();
-      return () => {
-        if (clocks.get(trialId) !== clock) return;
-        clocks.delete(trialId);
-        notify();
-      };
-    },
-    get: (trialId) => clocks.get(trialId) ?? null,
-    subscribe: changed.subscribe
-  };
-}
-var TrialClocksContext = createContext(null);
-var NEVER = () => () => {
-};
-var NONE2 = () => null;
-function useTrialClock(trialId) {
-  const clocks = useContext(TrialClocksContext);
-  return useSyncExternalStore(clocks?.subscribe ?? NEVER, clocks ? () => clocks.get(trialId) : NONE2);
-}
-function usePersistedPlayhead(clock, persisted, write) {
-  const written = useRef(persisted);
-  const latestWrite = useLatest(write);
-  useEffect(() => {
-    if (!clock || persisted === written.current) return;
-    written.current = persisted;
-    clock.request(persisted);
-  }, [clock, persisted]);
-  useEffect(() => {
-    if (!clock) return;
-    return clock.subscribe(() => {
-      const { playing, time } = clock.get();
-      if (playing || clock.pending() !== null || time === written.current) return;
-      written.current = time;
-      latestWrite.current(time);
-    });
-  }, [clock, latestWrite]);
-}
-var NO_DECORATORS = [];
-var StoryBody = memo(function StoryBody2({ story, config, setConfig, state, setState, globals, decorators, resetKey, onError }) {
-  const storyCtx = { config, setConfig, state, setState, globals, title: story.title, name: story.name };
-  return /* @__PURE__ */ jsx(StoryHost, { story, ctx: storyCtx, decorators, resetKey, onError });
-});
-function StoryTrial({ story, setup, ctx, hostRef, onRendered, onError }) {
-  const latestRef = useLatest(ctx);
-  const [heldConfig, setHeldConfig] = useState(() => storyConfig(ctx.config));
-  const config = storyConfig(ctx.config, heldConfig);
-  if (config !== heldConfig) setHeldConfig(config);
-  const seeded = useRef(false);
-  useEffect(() => {
-    if (seeded.current || ctx.state !== null || !story.initialState) return;
-    seeded.current = true;
-    ctx.setState(story.initialState(config));
-  }, [ctx, story, config]);
-  const [input, setInput] = useState({ config, state: ctx.state, key: 0 });
-  let resetKey = input.key;
-  if (input.config !== config || input.state !== ctx.state) {
-    resetKey = input.key + 1;
-    setInput({ config, state: ctx.state, key: resetKey });
-  }
-  const setConfig = useCallback((path, value) => {
-    if (!isForgePath(path)) latestRef.current.setConfig(path, value);
-  }, [latestRef]);
-  const setState = useCallback((next) => latestRef.current.setState(next), [latestRef]);
-  const trialId = useContext(TrialIdContext);
-  const clocks = useContext(TrialClocksContext);
-  const ownHost = useRef(null);
-  const host = hostRef ?? ownHost;
-  const kept = ctx.config?.[PLAYHEAD_KEY];
-  const persisted = typeof kept === "number" && Number.isFinite(kept) ? kept : null;
-  const clock = useStoryClock(story.timeline?.(config) ?? null, () => persisted);
-  useClockLoop(clock, host);
-  usePersistedPlayhead(clock, persisted, (time) => latestRef.current.setConfig(PLAYHEAD_KEY, time));
-  useEffect(() => clock && clocks && trialId ? clocks.publish(trialId, clock) : void 0, [clock, clocks, trialId]);
-  const decorators = setup.decorators ?? NO_DECORATORS;
-  const latestError = useLatest(onError);
-  const reportError = useCallback((error) => latestError.current?.(error), [latestError]);
-  const render = (globals) => /* @__PURE__ */ jsx(ClockContext.Provider, { value: clock, children: /* @__PURE__ */ jsx(
-    StoryBody,
-    {
-      story,
-      config,
-      setConfig,
-      state: ctx.state,
-      setState,
-      globals,
-      decorators,
-      resetKey,
-      onError: reportError
-    }
-  ) });
-  return /* @__PURE__ */ jsx(
-    TrialHost,
-    {
-      layout: story.layout,
-      setup,
-      config: ctx.config,
-      hostRef: host,
-      ...onRendered ? { onRendered } : {},
-      children: render
-    }
-  );
-}
-
-export { StoryGlobalsContext, StoryTrial, TrialClocksContext, TrialFramesContext, TrialHost, createTrialClocks, createTrialFrames, useCssOverrides, useTrialClock, useTrialFrame };
-//# sourceMappingURL=chunk-J3GYSNCK.js.map
-//# sourceMappingURL=chunk-J3GYSNCK.js.map

package/dist/chunk-J3GYSNCK.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/shell/trialFrames.ts","../src/shell/StoryGlobalsContext.ts","../src/shell/cssVars/overrides.ts","../src/shell/TrialHost.tsx","../src/timeline/trialClocks.ts","../src/timeline/usePersistedPlayhead.ts","../src/shell/StoryTrial.tsx"],"names":["createContext","useContext","createEmitter","NONE","useSyncExternalStore","useRef","useLatest","useEffect","StoryBody","jsx","useState","useCallback","TrialIdContext"],"mappings":"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","file":"chunk-J3GYSNCK.js","sourcesContent":["import { createEmitter } from '@weasel-js/registry';\nimport { createContext, useCallback, useContext, useSyncExternalStore } from 'react';\nimport type { A11yReport, CssVarReport, ToFrame } from '../protocol/messages';\n\n/** What an axe run in the frame came back with. */\nexport type A11yOutcome = { ok: true; report: A11yReport } | { ok: false; message: string };\n\n/** The half of a trial's frame that answers a request: each call is one round trip over the frame's channel. */\nexport interface TrialFrameCalls {\n  send: (msg: ToFrame) => void;\n  audit: () => Promise<A11yOutcome>;\n}\n\n/** What trial chrome can reach of the frame its trial shows. */\nexport interface TrialFrame {\n  /** Null while no frame is connected. */\n  send: ((msg: ToFrame) => void) | null;\n  /** The frame's latest `vars` report. */\n  vars: readonly CssVarReport[];\n  /** Runs axe over the story and records the answer as `a11y`. Null while no frame is connected. */\n  audit: (() => Promise<A11yOutcome>) | null;\n  /** What the last audit found; null until one has run against the connected frame. */\n  a11y: A11yOutcome | null;\n}\n\n/** Each trial's frame, keyed by trial id: `FrameView` connects and reports, trial chrome reads. */\nexport interface TrialFrames {\n  /** Returns a disconnect that does nothing once a newer connection replaced this one. */\n  connect(trialId: string, calls: TrialFrameCalls): () => void;\n  report(trialId: string, vars: readonly CssVarReport[]): void;\n  reportA11y(trialId: string, outcome: A11yOutcome): void;\n  get(trialId: string): TrialFrame;\n  subscribe(listener: () => void): () => void;\n}\n\nconst NO_FRAME: TrialFrame = { send: null, vars: [], audit: null, a11y: null };\n\nexport function createTrialFrames(): TrialFrames {\n  const frames = new Map<string, TrialFrame>();\n  const changes = createEmitter();\n  const changed = changes.emit;\n  const patch = (trialId: string, next: Partial<TrialFrame>) => {\n    const frame = frames.get(trialId);\n    if (!frame) return;\n    frames.set(trialId, { ...frame, ...next });\n    changed();\n  };\n  return {\n    connect(trialId, calls) {\n      frames.set(trialId, { send: calls.send, vars: [], audit: calls.audit, a11y: null });\n      changed();\n      return () => {\n        if (frames.get(trialId)?.send !== calls.send) return;\n        frames.delete(trialId);\n        changed();\n      };\n    },\n    report: (trialId, vars) => patch(trialId, { vars }),\n    reportA11y: (trialId, a11y) => patch(trialId, { a11y }),\n    get: (trialId) => frames.get(trialId) ?? NO_FRAME,\n    subscribe: changes.subscribe,\n  };\n}\n\n/** The workshop's `TrialFrames`; `null` outside a `Workshop`. */\nexport const TrialFramesContext = createContext<TrialFrames | null>(null);\n\n/** The frame of the trial `trialId` names, re-read when it connects or reports. */\nexport function useTrialFrame(trialId: string): TrialFrame {\n  const frames = useContext(TrialFramesContext);\n  const subscribe = useCallback((listener: () => void) => frames?.subscribe(listener) ?? (() => {}), [frames]);\n  const read = () => frames?.get(trialId) ?? NO_FRAME;\n  return useSyncExternalStore(subscribe, read, read);\n}\n","import { createContext } from 'react';\nimport type { Globals } from '../protocol/messages';\n\n/** The lab's global values, which a trial's pins override. A change reaches open frames without replacing instruments. */\nexport const StoryGlobalsContext = createContext<Globals>({});\n","import { usePersistedState } from '@weasel-js/labkit';\n\nexport type CssOverrides = Readonly<Record<string, string>>;\n\nconst NONE: CssOverrides = {};\n\n/** The CSS variable overrides of the trial this is rendered inside, persisted with it. */\nexport function useCssOverrides() {\n  return usePersistedState<CssOverrides>('fg-css-overrides', NONE, { scope: 'trial' });\n}\n","import { useLatest } from '@weasel-js/core';\nimport { LabBoundary, TrialIdContext } from '@weasel-js/labkit';\nimport { OverlayPortalProvider } from '@weasel-js/ui';\nimport {\n  type ReactNode,\n  type RefObject,\n  useContext,\n  useEffect,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { runAxe } from '../frame/a11y';\nimport { createOverrides, type Overrides, scanCssVars } from '../frame/cssVars';\nimport type { FrameSetup } from '../frame/FrameController';\nimport { IN_VIEW_MARGIN, useNearViewport } from '../frame/useNearViewport';\nimport { createGlobalsTarget } from '../frame/globalsTarget';\nimport type { CssVarReport, Globals, Layout, ToFrame } from '../protocol/messages';\nimport { useCssOverrides } from './cssVars/overrides';\nimport { effectiveGlobals, GLOBALS_KEY } from './globals';\nimport { StoryGlobalsContext } from './StoryGlobalsContext';\nimport { type A11yOutcome, TrialFramesContext } from './trialFrames';\n\n/** Props for `TrialHost`. */\nexport interface TrialHostProps {\n  layout: Layout;\n  setup: FrameSetup;\n  /** The trial's config, read for its `$globals` pins. */\n  config: unknown;\n  /** Rendered once the host element exists, with the globals in force on it. */\n  children: (globals: Globals) => ReactNode;\n  /** Receives the host element, for a caller with no trial to reach it through. */\n  hostRef?: RefObject<HTMLElement | null>;\n  /** Called once the children's first commit has painted. */\n  onRendered?: () => void;\n}\n\nconst VARS_SETTLE_MS = 100;\n\n/** A selector matching only the element carrying `id`. */\nconst scopeOf = (id: string) => `[data-fg-host=\"${id}\"]`;\n\n/**\n * One story's box in the workshop document: what a frame document was, as an element. It applies the globals to\n * itself, keeps its CSS variable overrides on itself, contains fixed-position descendants and portals, reports its\n * vars and audits to the trial's frame registry, and unmounts its content while out of view.\n */\nexport function TrialHost({ layout, setup, config, children, hostRef, onRendered }: TrialHostProps) {\n  const trialId = useContext(TrialIdContext);\n  const frames = useContext(TrialFramesContext);\n  const labGlobals = useContext(StoryGlobalsContext);\n  const pins = (config as Record<string, unknown> | null | undefined)?.[GLOBALS_KEY];\n  const globals = useMemo(() => effectiveGlobals(labGlobals, pins), [labGlobals, pins]);\n  const [persisted] = useCssOverrides();\n  const reactId = useId();\n  const hostId = trialId ?? reactId;\n  const [host, setHost] = useState<HTMLDivElement | null>(null);\n  const elementRef = useRef<HTMLDivElement | null>(null);\n  const inView = useNearViewport(elementRef, IN_VIEW_MARGIN);\n  const [pending, setPending] = useState(true);\n  const overridesRef = useRef<Overrides | null>(null);\n  const latest = useLatest({ setup, onRendered });\n\n  // Everything the host owns for its lifetime: the globals target, the overrides rule, the registry connection.\n  useLayoutEffect(() => {\n    if (!host) return;\n    const doc = host.ownerDocument;\n    const scope = scopeOf(hostId);\n    const { cssVarsScope } = latest.current.setup;\n    const overrides = createOverrides(doc, cssVarsScope ? `${scope}, ${scope} :is(${cssVarsScope})` : scope);\n    overridesRef.current = overrides;\n    let lastVars: CssVarReport[] | null = null;\n    let reported: string | null = null;\n    const publish = (vars: CssVarReport[]) => {\n      lastVars = vars;\n      const key = JSON.stringify(vars);\n      if (key === reported) return;\n      reported = key;\n      if (trialId) frames?.report(trialId, vars);\n    };\n    const scan = () => publish(scanCssVars(doc, overrides.has, host));\n    let settleTimer: ReturnType<typeof setTimeout> | undefined;\n    const ownMutation = (record: MutationRecord) =>\n      overrides.owns(record.target) ||\n      (record.type === 'childList' &&\n        [...record.addedNodes, ...record.removedNodes].length > 0 &&\n        [...record.addedNodes, ...record.removedNodes].every(overrides.owns));\n    const mutations =\n      typeof MutationObserver === 'undefined'\n        ? null\n        : new MutationObserver((records) => {\n            if (records.every(ownMutation)) return;\n            clearTimeout(settleTimer);\n            settleTimer = setTimeout(scan, VARS_SETTLE_MS);\n          });\n    mutations?.observe(host, { subtree: true, childList: true, characterData: true, attributes: true });\n\n    const send = (msg: ToFrame) => {\n      if (msg.type !== 'vars.set') return;\n      overrides.set(msg.name, msg.value);\n      if (lastVars?.some((v) => v.name === msg.name)) scan();\n    };\n    const audit = async (): Promise<A11yOutcome> => {\n      let outcome: A11yOutcome;\n      try {\n        outcome = { ok: true, report: await runAxe(host, { page: false }) };\n      } catch (error) {\n        outcome = { ok: false, message: error instanceof Error ? error.message : String(error) };\n      }\n      if (trialId) frames?.reportA11y(trialId, outcome);\n      return outcome;\n    };\n    const disconnect = frames && trialId ? frames.connect(trialId, { send, audit }) : () => {};\n\n    return () => {\n      disconnect();\n      mutations?.disconnect();\n      clearTimeout(settleTimer);\n      overrides.dispose();\n      overridesRef.current = null;\n    };\n  }, [host, hostId, trialId, frames, latest]);\n\n  // The overrides the trial persisted, put back on every mount and kept in step with the panel's edits.\n  const applied = useRef<Record<string, string>>({});\n  useLayoutEffect(() => {\n    const overrides = overridesRef.current;\n    if (!overrides) return;\n    for (const name of Object.keys(applied.current)) if (!(name in persisted)) overrides.set(name, null);\n    for (const [name, value] of Object.entries(persisted)) overrides.set(name, value);\n    applied.current = { ...persisted };\n  }, [host, persisted]);\n\n  useLayoutEffect(() => {\n    if (!host) return;\n    const target = createGlobalsTarget(host, scopeOf(hostId));\n    latest.current.setup.applyGlobals?.(globals, target);\n    return () => target.dispose();\n  }, [host, hostId, globals, latest]);\n\n  // The host is hidden until its first commit has painted with its fonts, so a new trial never shows a jump.\n  const announced = useRef(false);\n  useEffect(() => {\n    if (!host || !inView || announced.current) return;\n    let canceled = false;\n    const done = () => {\n      if (canceled) return;\n      announced.current = true;\n      setPending(false);\n      latest.current.onRendered?.();\n    };\n    const { fonts } = host.ownerDocument;\n    if (!fonts) {\n      done();\n      return;\n    }\n    const afterPaint = () => requestAnimationFrame(done);\n    void fonts.ready.then(afterPaint, afterPaint);\n    return () => {\n      canceled = true;\n    };\n  }, [host, inView, latest]);\n\n  return (\n    <div\n      ref={(el) => {\n        elementRef.current = el;\n        if (hostRef) hostRef.current = el;\n        setHost(el);\n      }}\n      className=\"fg-story\"\n      data-fg-host={hostId}\n      data-fg-layout={layout}\n      data-pending={pending || undefined}\n    >\n      {host && inView ? (\n        // The workshop is itself a lab; below the boundary a story sees no lab, trial or theme above it, as in a\n        // document of its own.\n        <LabBoundary>\n          <OverlayPortalProvider container={host}>{children(globals)}</OverlayPortalProvider>\n        </LabBoundary>\n      ) : null}\n    </div>\n  );\n}\n","import { createEmitter } from '@weasel-js/registry';\nimport { createContext, useContext, useSyncExternalStore } from 'react';\nimport type { Clock } from './clock';\n\n/** Each trial's story clock, by trial id: the story's trial publishes it, and the trial's transport reads it. */\nexport interface TrialClocks {\n  /** Publishes `clock` as `trialId`'s; the returned function withdraws it. */\n  publish(trialId: string, clock: Clock): () => void;\n  get(trialId: string): Clock | null;\n  subscribe(listener: () => void): () => void;\n}\n\nexport function createTrialClocks(): TrialClocks {\n  const clocks = new Map<string, Clock>();\n  const changed = createEmitter();\n  const notify = changed.emit;\n  return {\n    publish(trialId, clock) {\n      clocks.set(trialId, clock);\n      notify();\n      return () => {\n        if (clocks.get(trialId) !== clock) return;\n        clocks.delete(trialId);\n        notify();\n      };\n    },\n    get: (trialId) => clocks.get(trialId) ?? null,\n    subscribe: changed.subscribe,\n  };\n}\n\nexport const TrialClocksContext = createContext<TrialClocks | null>(null);\n\nconst NEVER = () => () => {};\nconst NONE = () => null;\n\n/** The clock trial `trialId`'s story published, or null. */\nexport function useTrialClock(trialId: string): Clock | null {\n  const clocks = useContext(TrialClocksContext);\n  return useSyncExternalStore(clocks?.subscribe ?? NEVER, clocks ? () => clocks.get(trialId) : NONE);\n}\n","import { useLatest } from '@weasel-js/core';\nimport { useEffect, useRef } from 'react';\nimport type { Clock } from './clock';\n\n/**\n * Keeps `clock`'s paused time in the trial, through `write`, so a reload or a snapshot brings the story back there.\n * It writes when the clock stops or moves while stopped, never on a playing frame. A `persisted` value arriving from\n * outside — a snapshot loaded, a Reset — is requested of the clock, so a span set later can still hold it; null\n * stands for the span's start. Nothing is written while a request waits on a span.\n */\nexport function usePersistedPlayhead(clock: Clock | null, persisted: number | null, write: (time: number) => void): void {\n  const written = useRef(persisted);\n  const latestWrite = useLatest(write);\n\n  useEffect(() => {\n    if (!clock || persisted === written.current) return;\n    written.current = persisted;\n    clock.request(persisted);\n  }, [clock, persisted]);\n\n  useEffect(() => {\n    if (!clock) return;\n    return clock.subscribe(() => {\n      const { playing, time } = clock.get();\n      if (playing || clock.pending() !== null || time === written.current) return;\n      written.current = time;\n      latestWrite.current(time);\n    });\n  }, [clock, latestWrite]);\n}\n","import { type RenderContext, TrialIdContext } from '@weasel-js/labkit';\nimport { useLatest } from '@weasel-js/core';\nimport { memo, type RefObject, useCallback, useContext, useEffect, useRef, useState } from 'react';\nimport type { FrameSetup } from '../frame/FrameController';\nimport { StoryHost } from '../frame/StoryHost';\nimport type { Globals } from '../protocol/messages';\nimport type { Decorator, LoadedStory, StoryContext } from '../story/types';\nimport { ClockContext } from '../timeline/context';\nimport { useStoryClock } from '../timeline/StoryClock';\nimport { TrialClocksContext } from '../timeline/trialClocks';\nimport { useClockLoop } from '../timeline/useClockLoop';\nimport { usePersistedPlayhead } from '../timeline/usePersistedPlayhead';\nimport { isForgePath, PLAYHEAD_KEY, storyConfig } from './globals';\nimport { TrialHost } from './TrialHost';\n\n/** Props for `StoryTrial`. */\nexport interface StoryTrialProps {\n  story: LoadedStory;\n  setup: FrameSetup;\n  /** The trial's config and state; the story reads and writes them through its `StoryContext`. */\n  ctx: Pick<RenderContext<unknown, unknown>, 'config' | 'state' | 'setConfig' | 'setState'>;\n  hostRef?: RefObject<HTMLElement | null>;\n  onRendered?: () => void;\n  /** A render throw, after the boundary has shown it. */\n  onError?: (error: unknown) => void;\n}\n\nconst NO_DECORATORS: readonly Decorator[] = [];\n\ninterface StoryBodyProps {\n  story: LoadedStory;\n  config: StoryContext['config'];\n  setConfig: StoryContext['setConfig'];\n  state: unknown;\n  setState: StoryContext['setState'];\n  globals: Globals;\n  decorators: readonly Decorator[];\n  resetKey: number;\n  onError: (error: unknown) => void;\n}\n\n/** Calls `render` only when its inputs change, as Storybook does: the lab re-renders a trial for its own reasons, and a\n *  story declaring a component inside `render` remounts it on every extra call. */\nconst StoryBody = memo(function StoryBody({ story, config, setConfig, state, setState, globals, decorators, resetKey, onError }: StoryBodyProps) {\n  const storyCtx: StoryContext = { config, setConfig, state, setState, globals, title: story.title, name: story.name };\n  return <StoryHost story={story} ctx={storyCtx} decorators={decorators} resetKey={resetKey} onError={onError} />;\n});\n\n/** A story rendered in the workshop document, inside a `TrialHost`, from the trial's own config and state. */\nexport function StoryTrial({ story, setup, ctx, hostRef, onRendered, onError }: StoryTrialProps) {\n  const latestRef = useLatest(ctx);\n  // Kept across a write to a key forge owns, so moving the playhead or a pin does not re-render the story.\n  const [heldConfig, setHeldConfig] = useState(() => storyConfig(ctx.config));\n  const config = storyConfig(ctx.config, heldConfig);\n  if (config !== heldConfig) setHeldConfig(config);\n\n  // A trial opened on the provisional instrument starts at `null`; the story's own initial state fills it once.\n  const seeded = useRef(false);\n  useEffect(() => {\n    if (seeded.current || ctx.state !== null || !story.initialState) return;\n    seeded.current = true;\n    ctx.setState(story.initialState(config));\n  }, [ctx, story, config]);\n\n  // Each new input retries a render the boundary caught, as the frame did on each message.\n  // State, not a ref: a render React throws away takes its bump with it.\n  const [input, setInput] = useState({ config, state: ctx.state, key: 0 });\n  let resetKey = input.key;\n  if (input.config !== config || input.state !== ctx.state) {\n    resetKey = input.key + 1;\n    setInput({ config, state: ctx.state, key: resetKey });\n  }\n\n  // Stable, as the frame's were: a story may list them as effect dependencies.\n  // The pins belong to the trial; a story cannot see them, so it cannot set them either.\n  const setConfig = useCallback((path: string, value: unknown) => {\n    if (!isForgePath(path)) latestRef.current.setConfig(path, value);\n  }, [latestRef]);\n  const setState = useCallback((next: unknown) => latestRef.current.setState(next), [latestRef]);\n\n  // The story's clock lives with its trial: the trial's transport reads it from the registry, the story from context.\n  const trialId = useContext(TrialIdContext);\n  const clocks = useContext(TrialClocksContext);\n  const ownHost = useRef<HTMLElement | null>(null);\n  const host = hostRef ?? ownHost;\n  const kept = (ctx.config as Record<string, unknown> | null)?.[PLAYHEAD_KEY];\n  const persisted = typeof kept === 'number' && Number.isFinite(kept) ? kept : null;\n  const clock = useStoryClock(story.timeline?.(config) ?? null, () => persisted);\n  useClockLoop(clock, host);\n  usePersistedPlayhead(clock, persisted, (time) => latestRef.current.setConfig(PLAYHEAD_KEY, time));\n  useEffect(() => (clock && clocks && trialId ? clocks.publish(trialId, clock) : undefined), [clock, clocks, trialId]);\n\n  const decorators = setup.decorators ?? NO_DECORATORS;\n  const latestError = useLatest(onError);\n  const reportError = useCallback((error: unknown) => latestError.current?.(error), [latestError]);\n  const render = (globals: Globals) => (\n    <ClockContext.Provider value={clock}>\n      <StoryBody\n        story={story}\n        config={config}\n        setConfig={setConfig}\n        state={ctx.state}\n        setState={setState}\n        globals={globals}\n        decorators={decorators}\n        resetKey={resetKey}\n        onError={reportError}\n      />\n    </ClockContext.Provider>\n  );\n\n  return (\n    <TrialHost\n      layout={story.layout}\n      setup={setup}\n      config={ctx.config}\n      hostRef={host}\n      {...(onRendered ? { onRendered } : {})}\n    >\n      {render}\n    </TrialHost>\n  );\n}\n"]}