@weasel-js/forge 1.7.3 → 1.8.1

package/dist/chunk-CJX3W5HY.js

@@ -0,0 +1,151 @@
+import { isPlainObject, stableStringify } from './chunk-KJGXJD3U.js';
+import { valueAtPath, isConfigBranch } from '@weasel-js/labkit/config';
+
+var PLAYHEAD_PARAM = "t";
+var RESERVED_PARAMS = /* @__PURE__ */ new Set([PLAYHEAD_PARAM]);
+var INTERNAL_PREFIX = "$";
+function parseRoute(hash) {
+  const body = hash.startsWith("#") ? hash.slice(1) : hash;
+  if (!body.startsWith("/")) return { story: null, params: {} };
+  const at = body.indexOf("?");
+  const path = at === -1 ? body.slice(1) : body.slice(1, at);
+  let story;
+  try {
+    story = decodeURIComponent(path) || null;
+  } catch {
+    story = null;
+  }
+  const params = {};
+  if (at !== -1) for (const [key, value] of new URLSearchParams(body.slice(at + 1))) params[key] = value;
+  return { story, params };
+}
+function formatRoute(route) {
+  const query = new URLSearchParams(Object.entries(route.params)).toString();
+  return `#/${encodeURIComponent(route.story ?? "")}${query ? `?${query}` : ""}`;
+}
+function isKnobParam(name) {
+  return name !== "" && !RESERVED_PARAMS.has(name) && !name.startsWith(INTERNAL_PREFIX);
+}
+function knobParams(params) {
+  return Object.fromEntries(Object.entries(params).filter(([name]) => isKnobParam(name)));
+}
+function reservedParams(params) {
+  return Object.fromEntries(Object.entries(params).filter(([name]) => !isKnobParam(name)));
+}
+function codecOf(leaf) {
+  switch (leaf.kind) {
+    case "number":
+    case "boolean":
+    case "string":
+    case "enum":
+      return leaf.kind;
+    case "color":
+      return "string";
+    case "list":
+    case "json":
+      return "json";
+  }
+  const d = leaf.default;
+  if (typeof d === "number" || typeof d === "boolean" || typeof d === "string") return typeof d;
+  return Array.isArray(d) || isPlainObject(d) ? "json" : null;
+}
+function encodeKnob(value) {
+  switch (typeof value) {
+    case "string":
+      return value;
+    case "number":
+    case "boolean":
+      return String(value);
+    case "object":
+      return value !== null && (Array.isArray(value) || isPlainObject(value)) ? JSON.stringify(value) : void 0;
+    default:
+      return void 0;
+  }
+}
+function fits(codec, value, leaf) {
+  if (codec !== "json") return true;
+  const d = leaf.default;
+  if (Array.isArray(d)) {
+    if (!Array.isArray(value)) return false;
+    return leaf.kind !== "list" || value.every((item) => typeof item === "string");
+  }
+  if (isPlainObject(d)) return isPlainObject(value);
+  return true;
+}
+function decodeKnob(raw, leaf) {
+  const codec = codecOf(leaf);
+  switch (codec) {
+    case "number": {
+      const n = raw.trim() === "" ? Number.NaN : Number(raw);
+      return Number.isNaN(n) ? void 0 : { value: n };
+    }
+    case "boolean":
+      if (raw === "" || raw === "true" || raw === "1") return { value: true };
+      if (raw === "false" || raw === "0") return { value: false };
+      return void 0;
+    case "string":
+      return { value: raw };
+    case "enum": {
+      const options = leaf.annotations?.options;
+      return !options || options.some((o) => o.value === raw) ? { value: raw } : void 0;
+    }
+    case "json": {
+      try {
+        const value = JSON.parse(raw);
+        return fits(codec, value, leaf) ? { value } : void 0;
+      } catch {
+        return void 0;
+      }
+    }
+    default:
+      return void 0;
+  }
+}
+function knobPaths(schema) {
+  const out = [];
+  const walk = (shape, at) => {
+    for (const [key, entry] of Object.entries(shape)) {
+      if (key.startsWith(INTERNAL_PREFIX) || key.includes(".")) continue;
+      const path = at === "" ? key : `${at}.${key}`;
+      if (isConfigBranch(entry)) walk(entry.children, path);
+      else if (codecOf(entry) !== null) out.push({ path, leaf: entry });
+    }
+  };
+  walk(schema.nodes, "");
+  return out;
+}
+function sameKnob(a, b) {
+  return Object.is(a, b) || stableStringify(a) === stableStringify(b);
+}
+function knobsToParams(schema, config) {
+  const params = {};
+  for (const { path, leaf } of knobPaths(schema)) {
+    const value = valueAtPath(config, path);
+    if (value === void 0 || sameKnob(value, leaf.default)) continue;
+    const encoded = encodeKnob(value);
+    if (encoded !== void 0) params[path] = encoded;
+  }
+  return params;
+}
+function paramsToKnobs(schema, params) {
+  const knobs = {};
+  for (const { path, leaf } of knobPaths(schema)) {
+    const raw = params[path];
+    if (raw === void 0 || !isKnobParam(path)) continue;
+    const decoded = decodeKnob(raw, leaf);
+    if (decoded) knobs[path] = decoded.value;
+  }
+  return knobs;
+}
+function storyHref(story, knobs = {}, params = {}) {
+  const encoded = {};
+  for (const [path, value] of Object.entries(knobs)) {
+    const raw = encodeKnob(value);
+    if (raw !== void 0 && isKnobParam(path)) encoded[path] = raw;
+  }
+  return formatRoute({ story, params: { ...encoded, ...reservedParams(params) } });
+}
+
+export { PLAYHEAD_PARAM, RESERVED_PARAMS, decodeKnob, encodeKnob, formatRoute, knobParams, knobPaths, knobsToParams, paramsToKnobs, parseRoute, reservedParams, sameKnob, storyHref };
+//# sourceMappingURL=chunk-CJX3W5HY.js.map
+//# sourceMappingURL=chunk-CJX3W5HY.js.map

package/dist/chunk-CJX3W5HY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/route/url.ts"],"names":[],"mappings":"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","file":"chunk-CJX3W5HY.js","sourcesContent":["import { type ConfigSchema, type ConfigShape, isConfigBranch, valueAtPath } from '@weasel-js/labkit/config';\nimport { isPlainObject } from '../csf/isPlainObject';\nimport { stableStringify } from '../protocol/messages';\n\n/**\n * Forge's URL, as pure functions: `#/<story id>?<params>`. The story and its params share the hash, so the page's\n * own query string stays the host's. A param is a knob — a story arg, addressed by its dotted config path\n * (`look.px`) — unless its name is reserved for the workshop itself.\n */\n\n/** The param a paused playhead is held in, in seconds. */\nexport const PLAYHEAD_PARAM = 't';\n\n/** Param names that are never knobs. */\nexport const RESERVED_PARAMS: ReadonlySet<string> = new Set([PLAYHEAD_PARAM]);\n\n/** Config keys forge keeps for itself, such as the `$globals` pins, start with this and never reach the URL. */\nconst INTERNAL_PREFIX = '$';\n\n/** What a forge hash holds: the story it names, and every param after it, knobs and reserved alike, in order. */\nexport interface ForgeRoute {\n  story: string | null;\n  params: Readonly<Record<string, string>>;\n}\n\n/** Reads a hash (`location.hash`, with or without its `#`). Anything not in the `#/<id>` form names no story. */\nexport function parseRoute(hash: string): ForgeRoute {\n  const body = hash.startsWith('#') ? hash.slice(1) : hash;\n  if (!body.startsWith('/')) return { story: null, params: {} };\n  const at = body.indexOf('?');\n  const path = at === -1 ? body.slice(1) : body.slice(1, at);\n  let story: string | null;\n  try {\n    story = decodeURIComponent(path) || null;\n  } catch {\n    story = null;\n  }\n  const params: Record<string, string> = {};\n  if (at !== -1) for (const [key, value] of new URLSearchParams(body.slice(at + 1))) params[key] = value;\n  return { story, params };\n}\n\n/** The hash for `route`, with its leading `#`. The inverse of `parseRoute`. */\nexport function formatRoute(route: ForgeRoute): string {\n  const query = new URLSearchParams(Object.entries(route.params)).toString();\n  return `#/${encodeURIComponent(route.story ?? '')}${query ? `?${query}` : ''}`;\n}\n\n/** Whether a param name can be a knob: not reserved and not one of forge's own config keys. */\nexport function isKnobParam(name: string): boolean {\n  return name !== '' && !RESERVED_PARAMS.has(name) && !name.startsWith(INTERNAL_PREFIX);\n}\n\n/** The params that are knobs, with the reserved ones left out. */\nexport function knobParams(params: Readonly<Record<string, string>>): Record<string, string> {\n  return Object.fromEntries(Object.entries(params).filter(([name]) => isKnobParam(name)));\n}\n\n/** The params that are not knobs. Kept as they are when the knobs are rewritten. */\nexport function reservedParams(params: Readonly<Record<string, string>>): Record<string, string> {\n  return Object.fromEntries(Object.entries(params).filter(([name]) => !isKnobParam(name)));\n}\n\n/** What a knob's value is decoded against: its schema leaf's declared kind, its default, and its choices. */\nexport interface KnobLeaf {\n  kind: string | null;\n  default: unknown;\n  annotations?: { options?: readonly { value: string }[] };\n}\n\ntype Codec = 'number' | 'boolean' | 'string' | 'enum' | 'json';\n\n/** How a leaf's value travels: by its declared kind first, then by the type of its default. */\nfunction codecOf(leaf: KnobLeaf): Codec | null {\n  switch (leaf.kind) {\n    case 'number':\n    case 'boolean':\n    case 'string':\n    case 'enum':\n      return leaf.kind;\n    case 'color':\n      return 'string';\n    case 'list':\n    case 'json':\n      return 'json';\n  }\n  const d = leaf.default;\n  if (typeof d === 'number' || typeof d === 'boolean' || typeof d === 'string') return typeof d as Codec;\n  return Array.isArray(d) || isPlainObject(d) ? 'json' : null;\n}\n\n/** A value as one param. Undefined for a value no param can carry, such as a function. */\nexport function encodeKnob(value: unknown): string | undefined {\n  switch (typeof value) {\n    case 'string':\n      return value;\n    case 'number':\n    case 'boolean':\n      return String(value);\n    case 'object':\n      return value !== null && (Array.isArray(value) || isPlainObject(value)) ? JSON.stringify(value) : undefined;\n    default:\n      return undefined;\n  }\n}\n\n/** Whether `value` is something a leaf of codec `codec` could hold, so a well-formed param of the wrong type is refused. */\nfunction fits(codec: Codec, value: unknown, leaf: KnobLeaf): boolean {\n  if (codec !== 'json') return true;\n  const d = leaf.default;\n  if (Array.isArray(d)) {\n    if (!Array.isArray(value)) return false;\n    return leaf.kind !== 'list' || value.every((item) => typeof item === 'string');\n  }\n  if (isPlainObject(d)) return isPlainObject(value);\n  return true;\n}\n\n/**\n * One param read as `leaf`'s type: `{ value }`, or undefined for a param that does not parse as one — a number that\n * is not a number, an option the enum does not list, malformed JSON. A bare boolean param (`?dark`) reads as true.\n */\nexport function decodeKnob(raw: string, leaf: KnobLeaf): { value: unknown } | undefined {\n  const codec = codecOf(leaf);\n  switch (codec) {\n    case 'number': {\n      const n = raw.trim() === '' ? Number.NaN : Number(raw);\n      return Number.isNaN(n) ? undefined : { value: n };\n    }\n    case 'boolean':\n      if (raw === '' || raw === 'true' || raw === '1') return { value: true };\n      if (raw === 'false' || raw === '0') return { value: false };\n      return undefined;\n    case 'string':\n      return { value: raw };\n    case 'enum': {\n      const options = leaf.annotations?.options;\n      return !options || options.some((o) => o.value === raw) ? { value: raw } : undefined;\n    }\n    case 'json': {\n      try {\n        const value: unknown = JSON.parse(raw);\n        return fits(codec, value, leaf) ? { value } : undefined;\n      } catch {\n        return undefined;\n      }\n    }\n    default:\n      return undefined;\n  }\n}\n\n/** One leaf a URL can address: its dotted path, and what its value decodes against. */\nexport interface KnobPath {\n  path: string;\n  leaf: KnobLeaf;\n}\n\n/** Every leaf of `schema` a param can carry, in schema order, with branches flattened into dotted paths. */\nexport function knobPaths(schema: Pick<ConfigSchema<unknown>, 'nodes'>): KnobPath[] {\n  const out: KnobPath[] = [];\n  const walk = (shape: ConfigShape, at: string): void => {\n    for (const [key, entry] of Object.entries(shape)) {\n      if (key.startsWith(INTERNAL_PREFIX) || key.includes('.')) continue;\n      const path = at === '' ? key : `${at}.${key}`;\n      if (isConfigBranch(entry)) walk(entry.children, path);\n      else if (codecOf(entry) !== null) out.push({ path, leaf: entry });\n    }\n  };\n  walk(schema.nodes, '');\n  return out;\n}\n\n/** Whether two knob values are the same value, compared as data. */\nexport function sameKnob(a: unknown, b: unknown): boolean {\n  return Object.is(a, b) || stableStringify(a) === stableStringify(b);\n}\n\n/**\n * The knob params for `config`: one per leaf whose value differs from its default, keyed by dotted path, in schema\n * order. A leaf absent from `config` is at its default.\n */\nexport function knobsToParams(schema: Pick<ConfigSchema<unknown>, 'nodes'>, config: unknown): Record<string, string> {\n  const params: Record<string, string> = {};\n  for (const { path, leaf } of knobPaths(schema)) {\n    const value = valueAtPath(config, path);\n    if (value === undefined || sameKnob(value, leaf.default)) continue;\n    const encoded = encodeKnob(value);\n    if (encoded !== undefined) params[path] = encoded;\n  }\n  return params;\n}\n\n/**\n * The knob values `params` sets, by dotted path, each coerced to its leaf's type. A param naming no leaf, a reserved\n * param, and one that does not parse as its leaf's type are left out rather than failing the rest.\n */\nexport function paramsToKnobs(\n  schema: Pick<ConfigSchema<unknown>, 'nodes'>,\n  params: Readonly<Record<string, string>>,\n): Record<string, unknown> {\n  const knobs: Record<string, unknown> = {};\n  for (const { path, leaf } of knobPaths(schema)) {\n    const raw = params[path];\n    if (raw === undefined || !isKnobParam(path)) continue;\n    const decoded = decodeKnob(raw, leaf);\n    if (decoded) knobs[path] = decoded.value;\n  }\n  return knobs;\n}\n\n/**\n * A link to a story at a given state, for a host that has no schema to hand: each knob is a dotted path and a value,\n * encoded by its own type. `params` adds workshop params, such as `t`.\n */\nexport function storyHref(\n  story: string,\n  knobs: Readonly<Record<string, unknown>> = {},\n  params: Readonly<Record<string, string>> = {},\n): string {\n  const encoded: Record<string, string> = {};\n  for (const [path, value] of Object.entries(knobs)) {\n    const raw = encodeKnob(value);\n    if (raw !== undefined && isKnobParam(path)) encoded[path] = raw;\n  }\n  return formatRoute({ story, params: { ...encoded, ...reservedParams(params) } });\n}\n"]}

package/dist/{chunk-SEK6EKHO.js → chunk-GHTVXHNJ.js}

@@ -1,5 +1,6 @@
-import { GLOBALS_KEY, effectiveGlobals, storyConfig, isGlobalsPath } from './chunk-JNJGIUYU.js';
-import { StoryHost, createOverrides, createGlobalsTarget, scanCssVars, runAxe, captureElement } from './chunk-NYBMOSSR.js';
+import { GLOBALS_KEY, effectiveGlobals, storyConfig, isForgePath, PLAYHEAD_KEY } from './chunk-NI5FYQHW.js';
+import { StoryHost, createOverrides, createGlobalsTarget, useStoryClock, useClockLoop, scanCssVars, runAxe, captureElement } from './chunk-5N4YP5HS.js';
+import { ClockContext } from './chunk-L5XM5VKB.js';
 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';
@@ -227,6 +228,55 @@ function TrialHost({ layout, setup, config, children, hostRef, onRendered }) {
     }
   );
 }
+function createTrialClocks() {
+  const clocks = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  const notify = () => {
+    for (const listener of [...listeners]) listener();
+  };
+  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(listener) {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    }
+  };
+}
+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 };
@@ -234,7 +284,9 @@ var StoryBody = memo(function StoryBody2({ story, config, setConfig, state, setS
 });
 function StoryTrial({ story, setup, ctx, hostRef, onRendered, onError }) {
   const latest = useLatest(ctx);
-  const config = useMemo(() => storyConfig(ctx.config), [ctx.config]);
+  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;
@@ -248,13 +300,23 @@ function StoryTrial({ story, setup, ctx, hostRef, onRendered, onError }) {
     setInput({ config, state: ctx.state, key: resetKey });
   }
   const setConfig = useCallback((path, value) => {
-    if (!isGlobalsPath(path)) latest.current.setConfig(path, value);
+    if (!isForgePath(path)) latest.current.setConfig(path, value);
   }, [latest]);
   const setState = useCallback((next) => latest.current.setState(next), [latest]);
+  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) => latest.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(
+  const render = (globals) => /* @__PURE__ */ jsx(ClockContext.Provider, { value: clock, children: /* @__PURE__ */ jsx(
     StoryBody,
     {
       story,
@@ -267,20 +329,20 @@ function StoryTrial({ story, setup, ctx, hostRef, onRendered, onError }) {
       resetKey,
       onError: reportError
     }
-  );
+  ) });
   return /* @__PURE__ */ jsx(
     TrialHost,
     {
       layout: story.layout,
       setup,
       config: ctx.config,
-      ...hostRef ? { hostRef } : {},
+      hostRef: host,
       ...onRendered ? { onRendered } : {},
       children: render
     }
   );
 }
 
-export { StoryGlobalsContext, StoryTrial, TrialFramesContext, TrialHost, createTrialFrames, useCssOverrides, useTrialFrame };
-//# sourceMappingURL=chunk-SEK6EKHO.js.map
-//# sourceMappingURL=chunk-SEK6EKHO.js.map
+export { StoryGlobalsContext, StoryTrial, TrialClocksContext, TrialFramesContext, TrialHost, createTrialClocks, createTrialFrames, useCssOverrides, useTrialClock, useTrialFrame };
+//# sourceMappingURL=chunk-GHTVXHNJ.js.map
+//# sourceMappingURL=chunk-GHTVXHNJ.js.map

package/dist/chunk-GHTVXHNJ.js.map

@@ -0,0 +1 @@
+{"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","NONE","useSyncExternalStore","useRef","useLatest","useEffect","StoryBody","jsx","useState","useCallback","TrialIdContext"],"mappings":"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","file":"chunk-GHTVXHNJ.js","sourcesContent":["import { createContext, type RefObject, useCallback, useContext, useSyncExternalStore } from 'react';\nimport type { A11yReport, CapturedPicture, CssVarReport, ToFrame, Viewport } from '../protocol/messages';\n\ntype Send = (msg: ToFrame) => void;\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: Send;\n  audit: () => Promise<A11yOutcome>;\n  /** Rejects when the frame could not draw itself, or went away before it did. */\n  capture: () => Promise<CapturedPicture>;\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: Send | 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  /** The story's own picture, for an export to draw over. Null while no frame is connected. */\n  capture: (() => Promise<CapturedPicture>) | null;\n  /** The story's content box, as the frame last measured it; null until it has. */\n  size: Viewport | 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  reportSize(trialId: string, size: Viewport): void;\n  /** The element a trial's frame is mounted in — stable across the frame reloads that replace the link,\n   *  because an annotation target's ref has to outlive them. */\n  hostRef(trialId: string): RefObject<HTMLElement | null>;\n  get(trialId: string): TrialFrame;\n  subscribe(listener: () => void): () => void;\n}\n\nconst NO_FRAME: TrialFrame = { send: null, vars: [], audit: null, a11y: null, capture: null, size: null };\n\nexport function createTrialFrames(): TrialFrames {\n  const frames = new Map<string, TrialFrame>();\n  const hosts = new Map<string, RefObject<HTMLElement | null>>();\n  const listeners = new Set<() => void>();\n  const changed = () => {\n    for (const listener of [...listeners]) listener();\n  };\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      const held = frames.get(trialId);\n      frames.set(trialId, {\n        send: calls.send,\n        vars: [],\n        audit: calls.audit,\n        a11y: null,\n        capture: calls.capture,\n        size: held?.size ?? null,\n      });\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    reportSize(trialId, size) {\n      const frame = frames.get(trialId) ?? NO_FRAME;\n      if (frame.size?.width === size.width && frame.size?.height === size.height) return;\n      frames.set(trialId, { ...frame, size });\n      changed();\n    },\n    hostRef(trialId) {\n      let ref = hosts.get(trialId);\n      if (!ref) {\n        ref = { current: null };\n        hosts.set(trialId, ref);\n      }\n      return ref;\n    },\n    get: (trialId) => frames.get(trialId) ?? NO_FRAME,\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\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 { captureElement } from '../frame/capture';\nimport { createOverrides, type Overrides, scanCssVars } from '../frame/cssVars';\nimport type { FrameSetup } from '../frame/FrameController';\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\n/** How far past the viewport a story stays mounted, so a small scroll back does not remount it. */\nconst IN_VIEW_MARGIN = '50%';\nconst VARS_SETTLE_MS = 100;\n\n/** Whether `ref`'s element is near the viewport; true where the browser cannot say. */\nfunction useInView(ref: RefObject<Element | null>): boolean {\n  const [inView, setInView] = useState(true);\n  useEffect(() => {\n    const el = ref.current;\n    if (!el || typeof IntersectionObserver === 'undefined') return;\n    const observer = new IntersectionObserver(\n      (entries) => {\n        const last = entries.at(-1);\n        if (last) setInView(last.isIntersecting);\n      },\n      { rootMargin: IN_VIEW_MARGIN },\n    );\n    observer.observe(el);\n    return () => observer.disconnect();\n  }, [ref]);\n  return inView;\n}\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, size 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 = useInView(elementRef);\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      const at = lastVars?.findIndex((v) => v.name === msg.name) ?? -1;\n      if (!lastVars || at < 0) return;\n      const vars = lastVars.slice();\n      vars[at] = { ...vars[at]!, overridden: overrides.has(msg.name) };\n      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 capture = async () => captureElement(host);\n    const disconnect = frames && trialId ? frames.connect(trialId, { send, audit, capture }) : () => {};\n    if (frames && trialId) frames.hostRef(trialId).current = host;\n\n    const sizes =\n      typeof ResizeObserver === 'undefined'\n        ? null\n        : new ResizeObserver(() => {\n            const { width, height } = host.getBoundingClientRect();\n            if (trialId) frames?.reportSize(trialId, { width: Math.ceil(width), height: Math.ceil(height) });\n          });\n    sizes?.observe(host);\n\n    return () => {\n      disconnect();\n      sizes?.disconnect();\n      mutations?.disconnect();\n      clearTimeout(settleTimer);\n      overrides.dispose();\n      overridesRef.current = null;\n      if (frames && trialId && frames.hostRef(trialId).current === host) frames.hostRef(trialId).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    announced.current = true;\n    let canceled = false;\n    const done = () => {\n      if (canceled) return;\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 { 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 listeners = new Set<() => void>();\n  const notify = () => {\n    for (const listener of [...listeners]) listener();\n  };\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(listener) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\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 latest = 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)) latest.current.setConfig(path, value);\n  }, [latest]);\n  const setState = useCallback((next: unknown) => latest.current.setState(next), [latest]);\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) => latest.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"]}

package/dist/{chunk-KIFCYY4F.js → chunk-JQD3MVUQ.js}

@@ -1,6 +1,6 @@
-import { StoryHost } from './chunk-NYBMOSSR.js';
+import { StoryHost } from './chunk-5N4YP5HS.js';
 import { sanitize } from './chunk-HRGPFQBW.js';
-import { PROTOCOL_VERSION, isPlainObject } from './chunk-YKN3IAEX.js';
+import { PROTOCOL_VERSION, isPlainObject } from './chunk-KJGXJD3U.js';
 import { f, isConfigBranch, resolveConfigSchema, schemaNodeAtPath, titleCase } from '@weasel-js/labkit/config';
 import { Badge } from '@weasel-js/ui/components/Badge';
 import { jsx, jsxs } from 'react/jsx-runtime';
@@ -401,5 +401,5 @@ function IndexPage({ env, render }) {
 }
 
 export { IndexPage, LibraryBadge, answerSchema, describeSchema, indexEntries, indexId, isIndexId, libraryOf, openChannel, schemaFromDescription };
-//# sourceMappingURL=chunk-KIFCYY4F.js.map
-//# sourceMappingURL=chunk-KIFCYY4F.js.map
+//# sourceMappingURL=chunk-JQD3MVUQ.js.map
+//# sourceMappingURL=chunk-JQD3MVUQ.js.map