@weasel-js/forge 1.11.0 → 1.12.0

package/README.md

@@ -62,7 +62,8 @@ The vite plugin takes two optional config modules:
 - `shellConfig` default-exports `defineShellConfig({...})`: lab chrome, control
   renderers, and global declarations. Only the workshop page imports it.
   `title` names the workshop in its header and as the document title
-  (default `weaselforge`), and `cssVars: false` leaves out the CSS Vars panel.
+  (default `weaselforge`). The CSS Vars panel stays hidden until its header toggle
+  is pressed, and the lab remembers the choice; `cssVars: false` leaves out both.
   `libraries` names the project's libraries, each a stretch of file path, a
   label and an optional badge tone: `{ path: '/packages/ui/', label: 'ui' }`.
   The tree's package filter, index pages, and Get Info show the label; a
@@ -159,6 +160,96 @@ focused trial when it shows the routed story, else the first that does. An index
 isolated story's frame and a story test show the story paused at its span's
 start, with no transport.
 
+## Loupe
+
+A lens shows the patch of a story under its reticle, magnified, or rendered
+under a different condition, or both. Lenses float over the whole workshop:
+one stays where it was put while the panes under it scroll and zoom, and one
+parked over a trial can aim at another. They last for the session and are not
+saved with a trial. Drag a lens or its reticle to move it, drag its edge to
+resize it, and press Delete to close a selected one; the lenses keep an undo
+history of their own.
+
+Every lens key is in the Loupe keymap. Alt+L opens it, a hint lists its keys
+while it is open, and Escape closes it. Holding Alt+L keeps it open, so a Follow
+lens can be pinned while the pointer is still on the story. Inside it, each key
+acts on the selected lens, or on the last one added when none is selected:
+
+| Key | Does | Key | Does |
+|---|---|---|---|
+| `l` | add a lens | `Shift+L` | close the lens |
+| `p` | pin the reticle | `f` | make the reticle follow the pointer |
+| `v` | Live source | `x` | Pixels source |
+| `r` | Pixels at 1×, 2×, or both side by side | `=` / `-` | zoom in / out |
+| `o` | compare with the opposite mode | `k` | choose a comparison |
+| `Shift+O` | clear the comparison | `s` / `\` / `d` | Swap / Split / Difference |
+| `t` | Token readout | `c` | Contrast readout |
+| `g` | pixel grid | | |
+
+Each binding's id is its action id (`loupe.add`, `loupe.view.split`, …), so a
+binding override can rebind it. Alt+Slash opens a panel listing every key
+binding the workshop registers, the lens keys included.
+
+Token shows the color at the aim and the `--wzl-*` token chain behind it;
+Contrast shows the WCAG ratio of the text there against its background, with
+AA and AAA marks, read from computed styles on a Live lens and from the pixels
+on a Pixels one; the pixel grid draws on a Pixels lens zoomed to 8× or more per
+captured pixel (its zoom over the capture's DPR). On a Live lens with a
+comparison, Token and Contrast read the compared copy. Token reads the DOM, so a
+Pixels lens with a comparison has none to give, and neither reads inside an
+isolated story's frame.
+
+**Live** renders the story a second time inside the lens, with the
+comparison's globals or args laid over the trial's. It is sharp at any factor
+and follows the trial's state, but takes no clicks, and it is never the real
+pixels. Being a second render, it shares the story's args and trial state but
+not the story's own React state: a story whose pan and zoom a lens should
+follow keeps them in an arg through `useArgs`, as CanvasStack's stories do.
+**Pixels** asks the dev server
+for a PNG of the story rendered in headless Chromium at a chosen DPR and enlarges
+it nearest-neighbor, so a hairline half a pixel off looks as it does on screen.
+A capture reproduces the story's args, globals, trial state, playhead, CSS
+variable overrides, scroll position (an isolated story's excepted), the lab's
+theme and the OS color scheme; it lags the live story
+by one capture, and has no hover or focus in it. Difference always compares two
+Pixels captures, whichever source the lens shows.
+
+Playwright is an optional peer dependency. Without it, or without its Chromium
+(`npx playwright install chromium`), a lens says why Pixels is unavailable and
+offers Live only. The endpoint imports `@weasel-js/core/json`, which resolves to
+core's built `dist`, so build core before starting the dev server in a fresh
+checkout.
+
+The endpoint is `<base>__forge/capture`, on the dev server only. A GET says
+whether captures are available, without starting Chromium; a POST takes a JSON
+payload and answers with the PNG. It is guarded against being used to load
+anyone else's page:
+
+- The capture page's URL is built from the socket the request arrived on,
+  never from its `Host` header.
+- A POST must be `application/json`, and one whose `Origin` is not the dev
+  server's own is refused.
+- A CSS variable override must be a custom property name with no `{`, `}` or
+  `;` in its value, and overrides are written through the CSSOM.
+- A body past 16 MB is answered 413 and the connection closed.
+- The capture browser blocks service workers, closes every WebSocket but the
+  dev server's own, and ignores certificate errors only for an https dev
+  server; a listed origin's requests are then fetched from Node, so its
+  certificate is still checked.
+- The capture page can load nothing but the dev server's own origin and the
+  origins the shell config lists in `capture.allowOrigins`, such as a web-font
+  service's:
+
+```ts
+defineShellConfig({ capture: { allowOrigins: ['https://fonts.googleapis.com', 'https://fonts.gstatic.com'] } });
+```
+
+Captures are cached in the dev-server process, at most 64 entries and 64 MB of
+PNG bytes, least recently used out first. The cache is cleared on any client
+module update and when the server closes. There is one Chromium, started on the
+first capture that misses the cache and closed after 120 s idle or when the
+server closes.
+
 ## Index pages
 
 Every component — every story title — has an index page, opened by clicking

package/dist/{FrameController-BRhShqut.d.ts → FrameController-CdnaIo4C.d.ts}

@@ -92,6 +92,14 @@ interface A11yReport {
     passes: number;
     inapplicable: number;
 }
+/** What an axe run in the frame came back with. */
+type A11yOutcome = {
+    ok: true;
+    report: A11yReport;
+} | {
+    ok: false;
+    message: string;
+};
 /** A message the workshop sends a story's frame. */
 type ToFrame = {
     type: 'init';
@@ -116,6 +124,11 @@ type ToFrame = {
  | {
     type: 'a11y.run';
     id: string;
+}
+/** Outlines the elements each `A11yNode.target` reaches, in place of the last ones; an empty list clears. */
+ | {
+    type: 'a11y.highlight';
+    targets: readonly (readonly string[])[];
 };
 /** A message a story's frame sends the workshop. */
 type FromFrame = {
@@ -145,17 +158,10 @@ type FromFrame = {
  | {
     type: 'open';
     id: string;
-} | {
+} | ({
     type: 'a11y';
     id: string;
-    ok: true;
-    report: A11yReport;
-} | {
-    type: 'a11y';
-    id: string;
-    ok: false;
-    message: string;
-}
+} & A11yOutcome)
 /** `seq`, on a render fault only: how many `init`/`config`/`state`/`globals` messages the frame had received. */
  | {
     type: 'fault';
@@ -329,6 +335,8 @@ interface ComponentHistory {
     modified: string;
     /** The first release holding the file, from the nearest tag after it was added; null while no release does. */
     introduced: string | null;
+    /** The first release holding the file's last change; null while no release does. */
+    modifiedIn: string | null;
 }
 /** One component's place in the component graph. Every list holds story titles, sorted. */
 interface ComponentDeps {
@@ -388,4 +396,4 @@ declare function startFrame({ story, channel, container, setup }: StartFrameOpti
 /** Reports an import failure — there is no story to start. */
 declare function reportImportFault(channel: Channel<ToFrame, FromFrame>, error: unknown): void;
 
-export { type A11yFinding as A, type ClockState as C, type Decorator as D, type FrameSetup as F, type Globals as G, type IndexContext as I, type LoadedStory as L, type MetaSpec as M, type PlayContext as P, type StorySpec as S, type TimelineSpec as T, type Viewport as V, type SpanOverride as a, type A11yNode as b, type A11yReport as c, type ComponentDeps as d, type ComponentHistory as e, type DepGraph as f, type GlobalsTarget as g, type IndexRender as h, type IndexStoryProps as i, type StoryContext as j, type Layout as k, type Span as l, type IndexEntry as m, type FromFrame as n, type ToFrame as o, type CssVarReport as p, type DescribedEntry as q, type DescribedShape as r, type SchemaDescription as s, type SectionDescription as t, type Channel as u, type ConfigAnswers as v, type FaultPhase as w, type StartFrameOptions as x, reportImportFault as y, startFrame as z };
+export { type A11yFinding as A, type SectionDescription as B, type Channel as C, type Decorator as D, type FrameSetup as F, type Globals as G, type IndexEntry as I, type Layout as L, type MetaSpec as M, type PlayContext as P, type StartFrameOptions as S, type ToFrame as T, type Viewport as V, type ConfigAnswers as a, type FaultPhase as b, type FromFrame as c, type StorySpec as d, type ClockState as e, type SpanOverride as f, type A11yNode as g, type A11yReport as h, type ComponentDeps as i, type ComponentHistory as j, type DepGraph as k, type GlobalsTarget as l, type IndexContext as m, type IndexRender as n, type IndexStoryProps as o, type LoadedStory as p, type StoryContext as q, reportImportFault as r, startFrame as s, type Span as t, type TimelineSpec as u, type CssVarReport as v, type A11yOutcome as w, type DescribedEntry as x, type DescribedShape as y, type SchemaDescription as z };

package/dist/{chunk-7BQPHMA2.js → chunk-3BAM6M26.js}

@@ -77,5 +77,5 @@ function withGlobals(schema, declarations) {
 }
 
 export { FOLLOW_APP, GLOBALS_KEY, PLAYHEAD_KEY, effectiveGlobals, followApp, isForgePath, isGlobalsPath, labGlobals, labOptions, storyConfig, withGlobals };
-//# sourceMappingURL=chunk-7BQPHMA2.js.map
-//# sourceMappingURL=chunk-7BQPHMA2.js.map
+//# sourceMappingURL=chunk-3BAM6M26.js.map
+//# sourceMappingURL=chunk-3BAM6M26.js.map

package/dist/chunk-3BAM6M26.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shell/globals.ts"],"names":["from"],"mappings":"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","file":"chunk-3BAM6M26.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   * The value opposite `value`, for the global a lens's opposite-mode comparison flips (`ShellConfig.loupe`'s\n   * `modeGlobal`); undefined when it has none. `App` and `auto` are resolved to the mode they show before this is\n   * asked. Absent, the lens swaps `light` and `dark`.\n   */\n  opposite?: (value: string, globals: Globals) => string | undefined;\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-ZAWXMUGZ.js → chunk-5WS67HMU.js}

@@ -17,6 +17,11 @@ function storyNameFromExport(exportName) {
 // src/csf/propArgTypes.ts
 var PROP_ARG_TYPES_EXPORT = "__forgeArgTypes";
 
-export { PROP_ARG_TYPES_EXPORT, sanitize, storyId, storyNameFromExport };
-//# sourceMappingURL=chunk-ZAWXMUGZ.js.map
-//# sourceMappingURL=chunk-ZAWXMUGZ.js.map
+// src/frame/safeOverride.ts
+function isSafeOverride(name, value) {
+  return /^--[\w-]+$/.test(name) && !/[{};]/.test(value);
+}
+
+export { PROP_ARG_TYPES_EXPORT, isSafeOverride, sanitize, storyId, storyNameFromExport };
+//# sourceMappingURL=chunk-5WS67HMU.js.map
+//# sourceMappingURL=chunk-5WS67HMU.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/story/ids.ts","../src/csf/propArgTypes.ts","../src/frame/safeOverride.ts"],"names":[],"mappings":";AAIO,SAAS,SAAS,IAAA,EAAsB;AAC7C,EAAA,OAAO,KACJ,WAAA,EAAY,CACZ,OAAA,CAAQ,iDAAA,EAAmD,GAAG,CAAA,CAC9D,OAAA,CAAQ,KAAA,EAAO,GAAG,EAClB,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA,CACjB,OAAA,CAAQ,OAAO,EAAE,CAAA;AACtB;AAEA,SAAS,YAAA,CAAa,MAAc,IAAA,EAA+B;AACjE,EAAA,MAAM,SAAA,GAAY,SAAS,IAAI,CAAA;AAC/B,EAAA,IAAI,SAAA,KAAc,IAAI,MAAM,IAAI,MAAM,CAAA,QAAA,EAAW,IAAI,CAAA,EAAA,EAAK,IAAI,CAAA,uCAAA,CAAyC,CAAA;AACvG,EAAA,OAAO,SAAA;AACT;AAEO,SAAS,OAAA,CAAQ,OAAe,UAAA,EAA4B;AACjE,EAAA,OAAO,CAAA,EAAG,aAAa,KAAA,EAAO,MAAM,CAAC,CAAA,EAAA,EAAK,YAAA,CAAa,UAAA,EAAY,MAAM,CAAC,CAAA,CAAA;AAC5E;AAGO,SAAS,oBAAoB,UAAA,EAA4B;AAC9D,EAAA,OAAO,WACJ,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAA,CACjB,QAAQ,IAAA,EAAM,GAAG,CAAA,CACjB,OAAA,CAAQ,OAAO,GAAG,CAAA,CAClB,QAAQ,wBAAA,EAA0B,CAAC,GAAG,CAAA,EAAW,CAAA,EAAW,CAAA,KAAc,CAAA,EAAG,CAAC,CAAA,CAAA,EAAI,CAAC,GAAG,CAAC,CAAA,CAAE,EACzF,OAAA,CAAQ,iBAAA,EAAmB,CAAC,CAAA,EAAG,GAAW,CAAA,KAAc,CAAA,EAAG,CAAC,CAAA,CAAA,EAAI,CAAC,EAAE,CAAA,CACnE,OAAA,CAAQ,kBAAA,EAAoB,CAAC,GAAG,CAAA,EAAW,CAAA,KAAc,CAAA,EAAG,CAAC,IAAI,CAAC,CAAA,CAAE,CAAA,CACpE,OAAA,CAAQ,oBAAoB,CAAC,CAAA,EAAG,GAAW,CAAA,KAAc,CAAA,EAAG,CAAC,CAAA,CAAA,EAAI,CAAC,CAAA,CAAE,CAAA,CACpE,QAAQ,aAAA,EAAe,CAAC,GAAG,CAAA,EAAW,CAAA,KAAc,GAAG,CAAC,CAAA,EAAG,CAAA,CAAE,WAAA,EAAa,CAAA,CAAE,CAAA,CAC5E,QAAQ,KAAA,EAAO,GAAG,EAClB,IAAA,EAAK;AACV;;;ACnCO,IAAM,qBAAA,GAAwB;;;ACG9B,SAAS,cAAA,CAAe,MAAc,KAAA,EAAwB;AACnE,EAAA,OAAO,aAAa,IAAA,CAAK,IAAI,KAAK,CAAC,OAAA,CAAQ,KAAK,KAAK,CAAA;AACvD","file":"chunk-5WS67HMU.js","sourcesContent":["// sanitize, storyId and storyNameFromExport are ports of storybook/internal/csf (10.4.0)'s\n// sanitize, toId and storyNameFromExport; they must agree or links diverge.\n\n/** Lower-case; runs of the listed separators become one dash. Everything else, non-ASCII letters included, survives. */\nexport function sanitize(part: string): string {\n  return part\n    .toLowerCase()\n    .replace(/[ ’–—―′¿'`~!@#$%^&*()_|+\\-=?;:'\",.<>{}[\\]\\\\/]/gi, '-')\n    .replace(/-+/g, '-')\n    .replace(/^-+/, '')\n    .replace(/-+$/, '');\n}\n\nfunction sanitizeSafe(part: string, kind: 'kind' | 'name'): string {\n  const sanitized = sanitize(part);\n  if (sanitized === '') throw new Error(`Invalid ${kind} '${part}', must include alphanumeric characters`);\n  return sanitized;\n}\n\nexport function storyId(title: string, exportName: string): string {\n  return `${sanitizeSafe(title, 'kind')}--${sanitizeSafe(exportName, 'name')}`;\n}\n\n/** `PrimaryButton` → `Primary Button`, `withIcon2` → `With Icon 2`. */\nexport function storyNameFromExport(exportName: string): string {\n  return exportName\n    .replace(/_/g, ' ')\n    .replace(/-/g, ' ')\n    .replace(/\\./g, ' ')\n    .replace(/([^\\n])([A-Z])([a-z])/g, (_, a: string, b: string, c: string) => `${a} ${b}${c}`)\n    .replace(/([a-z])([A-Z])/g, (_, a: string, b: string) => `${a} ${b}`)\n    .replace(/([a-z])([0-9])/gi, (_, a: string, b: string) => `${a} ${b}`)\n    .replace(/([0-9])([a-z])/gi, (_, a: string, b: string) => `${a} ${b}`)\n    .replace(/(\\s|^)(\\w)/g, (_, a: string, b: string) => `${a}${b.toUpperCase()}`)\n    .replace(/ +/g, ' ')\n    .trim();\n}\n","/** The named export forge's vite plugin adds to a story module: argTypes read from the props of the meta's `component`. */\nexport const PROP_ARG_TYPES_EXPORT = '__forgeArgTypes';\n","/**\n * Whether a CSS variable override can be declared as given: a custom property name, and a value that cannot close\n * the declaration or the rule around it. A value that could would let whoever sets it write rules of their own.\n */\nexport function isSafeOverride(name: string, value: string): boolean {\n  return /^--[\\w-]+$/.test(name) && !/[{};]/.test(value);\n}\n"]}

package/dist/{chunk-R5F44ECM.js → chunk-ATI7FYJ7.js}

@@ -1,6 +1,6 @@
-import { useNearViewport, StoryHost } from './chunk-NVNTQ4AT.js';
-import { sanitize } from './chunk-ZAWXMUGZ.js';
-import { PROTOCOL_VERSION } from './chunk-2OJAV522.js';
+import { useNearViewport, StoryHost } from './chunk-WMGEO5M6.js';
+import { sanitize } from './chunk-5WS67HMU.js';
+import { PROTOCOL_VERSION } from './chunk-GH5RE5X5.js';
 import { createRoot } from 'react-dom/client';
 import { IconRegistryProvider, isPlainObject } from '@weasel-js/core';
 import { kitIcons } from '@weasel-js/ui/kit-icons';
@@ -170,6 +170,9 @@ function librariesFrom(table = []) {
 }
 var TITLE_LIBRARIES = librariesFrom();
 var LibrariesContext = createContext(TITLE_LIBRARIES);
+
+// src/shell/labDensity.ts
+var LAB_DENSITY = "roomy";
 function LibraryBadge({ library, className }) {
   const tone = useContext(LibrariesContext).toneOf(library);
   return /* @__PURE__ */ jsx(Badge, { status: "muted", ...tone === void 0 ? {} : { tone }, variant: "subtle", size: "sm", ...className ? { className } : {}, children: library });
@@ -315,10 +318,15 @@ function IndexDependencies() {
   ] });
 }
 var DAY = new Intl.DateTimeFormat(void 0, { dateStyle: "medium" });
-function HistoryDate({ label, iso }) {
+function HistoryDate({ label, iso, version }) {
   return /* @__PURE__ */ jsxs("div", { className: "fg-index-history__item", children: [
     /* @__PURE__ */ jsx("dt", { className: "fg-index-history__label", children: label }),
-    /* @__PURE__ */ jsx("dd", { className: `fg-index-history__value ${num.numeric}`, children: /* @__PURE__ */ jsx("time", { dateTime: iso, children: DAY.format(new Date(iso)) }) })
+    /* @__PURE__ */ jsxs("dd", { className: `fg-index-history__value ${num.numeric}`, children: [
+      /* @__PURE__ */ jsx("time", { dateTime: iso, children: DAY.format(new Date(iso)) }),
+      " (",
+      version ?? "unreleased",
+      ")"
+    ] })
   ] });
 }
 function IndexHistory() {
@@ -326,12 +334,8 @@ function IndexHistory() {
   const history = gallery ? void 0 : dependencies?.history;
   if (!history) return null;
   return /* @__PURE__ */ jsxs("dl", { className: "fg-index-history", "aria-label": "History", children: [
-    /* @__PURE__ */ jsxs("div", { className: "fg-index-history__item", children: [
-      /* @__PURE__ */ jsx("dt", { className: "fg-index-history__label", children: "Since" }),
-      /* @__PURE__ */ jsx("dd", { className: `fg-index-history__value ${num.numeric}`, children: history.introduced ?? "Unreleased" })
-    ] }),
-    /* @__PURE__ */ jsx(HistoryDate, { label: "Created", iso: history.created }),
-    /* @__PURE__ */ jsx(HistoryDate, { label: "Modified", iso: history.modified })
+    /* @__PURE__ */ jsx(HistoryDate, { label: "Created", iso: history.created, version: history.introduced }),
+    /* @__PURE__ */ jsx(HistoryDate, { label: "Modified", iso: history.modified, version: history.modifiedIn })
   ] });
 }
 function StorySection({ story, variants }) {
@@ -404,6 +408,6 @@ function IndexPage({ env, render }) {
   return /* @__PURE__ */ jsx(IndexEnvContext.Provider, { value: env, children: render ? render(indexContext(env)) : /* @__PURE__ */ jsx(DefaultIndex, {}) });
 }
 
-export { IndexPage, LibrariesContext, LibraryBadge, TITLE_LIBRARIES, answerSchema, createKitRoot, describeSchema, indexEntries, indexId, isIndexId, librariesFrom, openChannel, schemaFromDescription };
-//# sourceMappingURL=chunk-R5F44ECM.js.map
-//# sourceMappingURL=chunk-R5F44ECM.js.map
+export { IndexPage, LAB_DENSITY, LibrariesContext, LibraryBadge, TITLE_LIBRARIES, answerSchema, createKitRoot, describeSchema, indexEntries, indexId, isIndexId, librariesFrom, openChannel, schemaFromDescription };
+//# sourceMappingURL=chunk-ATI7FYJ7.js.map
+//# sourceMappingURL=chunk-ATI7FYJ7.js.map

package/dist/chunk-ATI7FYJ7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/kitIcons.tsx","../src/protocol/schema.ts","../src/protocol/channel.ts","../src/story/indexPages.ts","../src/story/library.ts","../src/shell/labDensity.ts","../src/frame/index/LibraryBadge.tsx","../src/frame/index/variants.ts","../src/frame/index/IndexPage.tsx"],"names":["jsx","resolveConfigSchema","isEntryShown","isConfigBranch","createContext","useContext","Badge"],"mappings":"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","file":"chunk-ATI7FYJ7.js","sourcesContent":["import type { ReactNode } from 'react';\nimport { createRoot, type Root } from 'react-dom/client';\nimport { IconRegistryProvider } from '@weasel-js/core';\nimport type { IconTable } from '@weasel-js/icons';\nimport { kitIcons } from '@weasel-js/ui/kit-icons';\n\n/** A React root whose every render draws its icons from the kit's tables, plus `extra` (an app's own): the\n *  workshop's, and each story frame's. */\nexport function createKitRoot(container: Element, extra: readonly IconTable[] = []): Pick<Root, 'render' | 'unmount'> {\n  const root = createRoot(container);\n  const icons = extra.length > 0 ? [...kitIcons, ...extra] : kitIcons;\n  return {\n    render: (node: ReactNode) => root.render(<IconRegistryProvider icons={icons}>{node}</IconRegistryProvider>),\n    unmount: () => root.unmount(),\n  };\n}\n","import {\n  f,\n  isConfigBranch,\n  isEntryShown,\n  resolveConfigSchema,\n  schemaNodeAtPath,\n  type Annotations,\n  type BranchAnnotations,\n  type ConfigBranch,\n  type ConfigEntry,\n  type ConfigNode,\n  type ConfigSchema,\n  type ConfigShape,\n  type NodeOptions,\n} from '@weasel-js/labkit/config';\n\n/** The section a described entry sits in, as structured-clone data. */\nexport interface SectionDescription {\n  label: string;\n  collapsed?: boolean;\n}\n\n/** One key of a described shape: a leaf, or a branch holding more. */\nexport type DescribedEntry =\n  | {\n      branch: true;\n      annotations: BranchAnnotations;\n      section?: SectionDescription;\n      conditional: boolean;\n      children: DescribedShape;\n    }\n  | {\n      branch: false;\n      kind: string | null;\n      default: unknown;\n      annotations: Annotations;\n      section?: SectionDescription;\n      conditional: boolean;\n      validated: boolean;\n      /** The node draws its own row with `.render`, which stays in the frame. */\n      customControl: boolean;\n    };\n\n/** A config shape as structured-clone data: each key's entry, described. */\nexport type DescribedShape = { [key: string]: DescribedEntry };\n\n/** A story's `f.schema` as structured-clone data. */\nexport interface SchemaDescription {\n  nodes: DescribedShape;\n}\n\n/** Answers the workshop has for the rebuilt schema's predicates. */\nexport interface SchemaAnswers {\n  hidden(path: string, config: unknown): boolean;\n  errors(path: string, config: unknown): string[];\n}\n\nconst joinPath = (at: string, key: string): string => (at === '' ? key : `${at}.${key}`);\n\nfunction describeShape(shape: ConfigShape): DescribedShape {\n  const out: DescribedShape = {};\n  for (const [key, entry] of Object.entries(shape)) {\n    const { section, showIf } = entry.options;\n    const common = {\n      annotations: { ...entry.annotations },\n      ...(section === undefined ? {} : { section: { ...section } }),\n      conditional: showIf !== undefined,\n    };\n    out[key] = isConfigBranch(entry)\n      ? { branch: true, ...common, children: describeShape(entry.children) }\n      : {\n          branch: false,\n          kind: entry.kind,\n          default: entry.default,\n          ...common,\n          validated: entry.options.validate !== undefined,\n          customControl: entry.options.render !== undefined,\n        };\n  }\n  return out;\n}\n\nexport function describeSchema(schema: ConfigSchema<unknown>): SchemaDescription {\n  return { nodes: describeShape(schema.nodes) };\n}\n\nfunction rebuildShape(shape: DescribedShape, at: string, answers: SchemaAnswers): ConfigShape {\n  const out: Record<string, ConfigEntry> = {};\n  for (const [key, entry] of Object.entries(shape)) {\n    const path = joinPath(at, key);\n    const options: NodeOptions = {\n      ...(entry.section === undefined ? {} : { section: entry.section }),\n      ...(entry.conditional ? { showIf: (config) => !answers.hidden(path, config) } : {}),\n    };\n    if (entry.branch) {\n      const branch: ConfigBranch = {\n        children: rebuildShape(entry.children, path, answers),\n        annotations: entry.annotations,\n        options,\n      };\n      out[key] = branch;\n    } else {\n      const node: ConfigNode = {\n        kind: entry.kind,\n        default: entry.default,\n        annotations: entry.annotations,\n        options: entry.validated ? { ...options, validate: (_leaf, config) => answers.errors(path, config) } : options,\n      };\n      out[key] = node;\n    }\n  }\n  return out;\n}\n\nexport function schemaFromDescription(\n  description: SchemaDescription,\n  answers: SchemaAnswers,\n): ConfigSchema<unknown> {\n  return f.schema(rebuildShape(description.nodes, '', answers)) as ConfigSchema<unknown>;\n}\n\n/** Evaluate a schema's own predicates for one config — the frame's half of `answers`. */\nexport function answerSchema(\n  schema: ConfigSchema<unknown>,\n  config: unknown,\n): { hidden: string[]; errors: Record<string, string[]> } {\n  const hidden: string[] = [];\n  const errors: Record<string, string[]> = {};\n  const record = config as Record<string, unknown>;\n  const { group } = resolveConfigSchema(schema);\n\n  const walk = (shape: ConfigShape, at: string): void => {\n    for (const [key, entry] of Object.entries(shape)) {\n      const path = joinPath(at, key);\n      if (!isEntryShown(entry, record, group)) hidden.push(path);\n      if (isConfigBranch(entry)) {\n        walk(entry.children, path);\n        continue;\n      }\n      const { validate } = entry.options;\n      if (!validate) continue;\n      const leaf = schemaNodeAtPath(group, path);\n      if (!leaf || 'children' in leaf) continue;\n      const found = validate(leaf, record);\n      if (found.length > 0) errors[path] = found;\n    }\n  };\n  walk(schema.nodes, '');\n  return { hidden, errors };\n}\n","import { createEmitter } from '@weasel-js/registry';\nimport { type Envelope, PROTOCOL_VERSION } from './messages';\n\nexport interface PortLike {\n  postMessage(message: unknown): void;\n  addEventListener(type: 'message', fn: (event: MessageEvent) => void): void;\n  removeEventListener(type: 'message', fn: (event: MessageEvent) => void): void;\n  start?(): void;\n  close(): void;\n}\n\n/** One end of a two-way message link: sends `Out`, hears `In`. */\nexport interface Channel<In, Out> {\n  send(msg: Out): void;\n  on(fn: (msg: In) => void): () => void;\n  close(): void;\n}\n\nexport type Mismatch = { reason: 'not-an-envelope' } | { reason: 'version'; version: unknown };\n\nexport interface ChannelOptions {\n  onMismatch?: (mismatch: Mismatch) => void;\n}\n\nexport function openChannel<In, Out>(port: PortLike, options: ChannelOptions = {}): Channel<In, Out> {\n  const messages = createEmitter<[msg: In]>();\n  const onMessage = (event: MessageEvent) => {\n    const data: unknown = event.data;\n    if (typeof data !== 'object' || data === null || !('msg' in data)) {\n      options.onMismatch?.({ reason: 'not-an-envelope' });\n      return;\n    }\n    const envelope = data as Partial<Envelope<In>>;\n    if (envelope.v !== PROTOCOL_VERSION) {\n      options.onMismatch?.({ reason: 'version', version: envelope.v });\n      return;\n    }\n    messages.emit(envelope.msg as In);\n  };\n  port.addEventListener('message', onMessage);\n  port.start?.();\n  return {\n    send: (msg) => port.postMessage({ v: PROTOCOL_VERSION, msg } satisfies Envelope<Out>),\n    on: messages.subscribe,\n    close: () => {\n      port.removeEventListener('message', onMessage);\n      port.close();\n    },\n  };\n}\n","import { sanitize } from './ids';\nimport type { IndexEntry } from './types';\n\nconst SUFFIX = ':index';\n\n/** The name an index page goes by in the sidebar and in its trial's title. */\nexport const INDEX_NAME = 'Index';\n\n/** The id of `title`'s index page. A colon never survives `sanitize`, so no story id can collide with it. */\nexport function indexId(title: string): string {\n  return `${sanitize(title)}${SUFFIX}`;\n}\n\nexport function isIndexId(id: string): boolean {\n  return id.endsWith(SUFFIX);\n}\n\n/**\n * One index-page entry per title in `stories`, in the order titles first appear. It routes and runs like a story:\n * its `file` is the title's first story file, its descriptions are the title's own, and its tags are those every story\n * of the title carries.\n */\nexport function indexEntries(stories: readonly IndexEntry[]): IndexEntry[] {\n  const byTitle = new Map<string, IndexEntry>();\n  for (const entry of stories) {\n    const page = byTitle.get(entry.title);\n    if (page) {\n      if (page.tags) {\n        const common = page.tags.filter((tag) => entry.tags?.includes(tag));\n        if (common.length > 0) page.tags = common;\n        else delete page.tags;\n      }\n      continue;\n    }\n    byTitle.set(entry.title, {\n      id: indexId(entry.title),\n      title: entry.title,\n      name: INDEX_NAME,\n      exportName: '',\n      file: entry.file,\n      ...(entry.componentDescription === undefined ? {} : { componentDescription: entry.componentDescription }),\n      ...(entry.componentName === undefined ? {} : { componentName: entry.componentName }),\n      ...(entry.tags === undefined ? {} : { tags: entry.tags }),\n    });\n  }\n  return [...byTitle.values()];\n}\n","import type { StanceProps } from '@weasel-js/ui/stance';\nimport { createContext } from 'react';\n\n/** One library of a project: the story files under `path` carry `label`. */\nexport interface Library {\n  /** A stretch of path every story file of the library has, with forward slashes: `/packages/ui/`. */\n  path: string;\n  label: string;\n  /** The tone of the library's badge, as a `<Badge>` takes one. Default: the badge's own muted tone. */\n  tone?: StanceProps['tone'];\n}\n\n/** A project's libraries, as the tree's package filter, the index page header, and Get Info ask about them. */\nexport interface Libraries {\n  /** The label of the first library whose `path` the story's file holds, else its title's first segment. */\n  of(entry: { file: string; title: string }): string;\n  toneOf(label: string): StanceProps['tone'];\n}\n\nexport function librariesFrom(table: readonly Library[] = []): Libraries {\n  return {\n    of(entry) {\n      const file = entry.file.replaceAll('\\\\', '/');\n      return table.find((library) => file.includes(library.path))?.label ?? entry.title.split('/')[0] ?? entry.title;\n    },\n    toneOf: (label) => table.find((library) => library.label === label)?.tone,\n  };\n}\n\n/** No table: every story's library is its title's first segment. */\nexport const TITLE_LIBRARIES = librariesFrom();\n\n/** The workshop's libraries, from `ShellConfig.libraries`. */\nexport const LibrariesContext = createContext<Libraries>(TITLE_LIBRARIES);\n","/** The density the workshop's lab is drawn at, and so the density a capture of a story in it takes. */\nexport const LAB_DENSITY = 'roomy';\n","// The component's own entry, not the barrel: the barrel would bring every weasel-ui component into each frame.\nimport { Badge } from '@weasel-js/ui/components/Badge';\nimport { useContext } from 'react';\nimport { LibrariesContext } from '../../story/library';\n\n/** A component's library, as a badge in the tone the project gave that library. */\nexport function LibraryBadge({ library, className }: { library: string; className?: string }) {\n  const tone = useContext(LibrariesContext).toneOf(library);\n  return (\n    <Badge status=\"muted\" {...(tone === undefined ? {} : { tone })} variant=\"subtle\" size=\"sm\" {...(className ? { className } : {})}>\n      {library}\n    </Badge>\n  );\n}\n","import { type ConfigSchema, type ConfigShape, isConfigBranch, isEntryShown, resolveConfigSchema, titleCase } from '@weasel-js/labkit/config';\nimport { isPlainObject } from '@weasel-js/core';\n\nexport interface VariantValue {\n  value: unknown;\n  label: string;\n}\n\n/** One control a story is shown varying along, with every other control at its default. */\nexport interface VariantRow {\n  /** Dotted, as `setConfig` takes it. */\n  path: string;\n  label: string;\n  values: VariantValue[];\n}\n\n/** Above this many choices a row stops being something to scan. */\nexport const MAX_ENUM_OPTIONS = 8;\nexport const MAX_ROWS = 6;\n\nconst labelOf = (key: string, name: string | undefined): string => name ?? titleCase(key);\n\n/**\n * The boolean and enum controls of `schema` a story can be shown varying along, in schema order: skipped are\n * controls that draw their own row, controls hidden at the defaults, and enums with more than\n * `MAX_ENUM_OPTIONS` choices. At most `MAX_ROWS`.\n */\nexport function variantRows(schema: ConfigSchema<unknown>): VariantRow[] {\n  const defaults = schema.defaults() as Record<string, unknown>;\n  const { group } = resolveConfigSchema(schema);\n  const rows: VariantRow[] = [];\n  const walk = (shape: ConfigShape, at: string): void => {\n    for (const [key, entry] of Object.entries(shape)) {\n      if (rows.length >= MAX_ROWS) return;\n      const path = at === '' ? key : `${at}.${key}`;\n      if (!isEntryShown(entry, defaults, group)) continue;\n      if (isConfigBranch(entry)) {\n        walk(entry.children, path);\n        continue;\n      }\n      if (entry.annotations.hidden || entry.options.render) continue;\n      const label = labelOf(key, entry.annotations.name);\n      if (entry.kind === 'boolean') {\n        rows.push({ path, label, values: [false, true].map((value) => ({ value, label: String(value) })) });\n      } else if (entry.kind === 'enum') {\n        const options = entry.annotations.options ?? [];\n        if (options.length < 2 || options.length > MAX_ENUM_OPTIONS) continue;\n        rows.push({ path, label, values: options.map((o) => ({ value: o.value, label: o.label })) });\n      }\n    }\n  };\n  walk(schema.nodes, '');\n  return rows;\n}\n\n/** `over` merged into `base`: nested plain objects merge, anything else replaces. */\nexport function mergeConfig(base: unknown, over: unknown): unknown {\n  if (!isPlainObject(base) || !isPlainObject(over)) return over === undefined ? base : over;\n  const out: Record<string, unknown> = { ...base };\n  for (const [key, value] of Object.entries(over)) out[key] = mergeConfig(base[key], value);\n  return out;\n}\n\n/** `config` with `value` at dotted `path`, copying each object along the way. */\nexport function withValueAt(config: unknown, path: string, value: unknown): unknown {\n  const [head, ...rest] = path.split('.');\n  if (head === undefined) return value;\n  const record = isPlainObject(config) ? config : {};\n  return { ...record, [head]: rest.length === 0 ? value : withValueAt(record[head], rest.join('.'), value) };\n}\n","// The components' own entries, not the barrel: the barrel would bring every weasel-ui component into each frame.\nimport { Badge } from '@weasel-js/ui/components/Badge';\nimport { Button } from '@weasel-js/ui/components/Button';\nimport {\n  createContext,\n  type MouseEvent,\n  type ReactNode,\n  useContext,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport type { Globals } from '../../protocol/messages';\nimport { indexId } from '../../story/indexPages';\nimport type { ComponentDeps, Decorator, IndexContext, IndexStoryProps, LoadedStory, StoryContext } from '../../story/types';\nimport { StoryHost } from '../StoryHost';\nimport { useNearViewport } from '../useNearViewport';\nimport { mergeConfig, variantRows, withValueAt } from './variants';\nimport './index.css';\nimport { LibraryBadge } from './LibraryBadge';\nimport num from '@weasel-js/theme/numeric.module.css';\n\n/** What every cell on an index page shares with the frame that hosts it. */\nexport interface IndexEnv {\n  title: string;\n  /** The package the component ships in. */\n  library?: string;\n  description?: string;\n  stories: readonly LoadedStory[];\n  /** Per story id, the JSDoc above its export. */\n  descriptions: Readonly<Record<string, string>>;\n  /** A catalog or showcase rather than one component: every story of it is tagged `gallery`. */\n  gallery?: boolean;\n  /** The ids of the stories tagged `gallery`. */\n  galleries?: readonly string[];\n  /** The component's place in the component graph; absent until the graph arrives, and for a gallery. */\n  dependencies?: ComponentDeps;\n  globals: Globals;\n  /** The frame config's, outermost. */\n  decorators: readonly Decorator[];\n  open: (id: string) => void;\n  onError: (error: unknown) => void;\n}\n\nexport const IndexEnvContext = createContext<IndexEnv | null>(null);\n\nfunction useEnv(): IndexEnv {\n  const env = useContext(IndexEnvContext);\n  if (!env) throw new Error('An index page part rendered outside its index page');\n  return env;\n}\n\n/** How far past the viewport a cell stays mounted. */\nconst NEAR_MARGIN = '100%';\n\n/**\n * One story at its defaults with `config` over them. It keeps its own config and state, so it stays interactive, and\n * it mounts only while near the viewport, so a page of canvas stories stays under the browser's WebGL context cap.\n */\nexport function IndexStory({ story, config: over, label }: IndexStoryProps) {\n  const env = useEnv();\n  const [config, setConfig] = useState(() => mergeConfig(story.config.defaults(), over));\n  const [state, setState] = useState<unknown>(() => story.initialState?.(config) ?? null);\n  const cell = useRef<HTMLElement>(null);\n  // Starts unmounted, so a page of canvas stories never mounts every cell at once.\n  const near = useNearViewport(cell, NEAR_MARGIN, false);\n  // Held while unmounted, so scrolling past a cell does not move everything after it.\n  const [height, setHeight] = useState<number | null>(null);\n  useEffect(() => {\n    const el = cell.current;\n    if (!near || !el || typeof ResizeObserver === 'undefined') return;\n    const observer = new ResizeObserver(() => setHeight(el.getBoundingClientRect().height));\n    observer.observe(el);\n    return () => observer.disconnect();\n  }, [near]);\n  const ctx: StoryContext = {\n    config,\n    setConfig: (path, value) => setConfig((prev: unknown) => withValueAt(prev, path, value)),\n    state,\n    setState: (next) =>\n      setState((prev: unknown) => (typeof next === 'function' ? (next as (p: unknown) => unknown)(prev) : next)),\n    globals: env.globals,\n    title: story.title,\n    name: story.name,\n  };\n  return (\n    <figure\n      ref={cell}\n      className={`fg-index-cell fg-index-cell--${story.layout}`}\n      style={!near && height !== null ? { minHeight: height } : undefined}\n    >\n      <div className=\"fg-index-cell__stage\">\n        {near ? (\n          <StoryHost story={story} ctx={ctx} decorators={env.decorators} resetKey={0} onError={env.onError} />\n        ) : null}\n      </div>\n      {label === undefined ? null : <figcaption className=\"fg-index-cell__label\">{label}</figcaption>}\n    </figure>\n  );\n}\n\n/** `story` once per value of each boolean and enum control, every other control at its default. */\nexport function IndexVariants({ story }: { story: LoadedStory }) {\n  const rows = useMemo(() => variantRows(story.config), [story]);\n  const defaults = useMemo(() => story.config.defaults(), [story]);\n  if (rows.length === 0) return null;\n  return (\n    <div className=\"fg-index-variants\">\n      {rows.map((row) => (\n        <section key={row.path} className=\"fg-index-variants__row\" aria-label={row.label}>\n          <h4 className=\"fg-index-variants__label\">{row.label}</h4>\n          <div className=\"fg-index-variants__cells\">\n            {row.values.map((v) => (\n              <IndexStory\n                key={String(v.value)}\n                story={story}\n                config={withValueAt(defaults, row.path, v.value) as Record<string, unknown>}\n                label={v.label}\n              />\n            ))}\n          </div>\n        </section>\n      ))}\n    </div>\n  );\n}\n\nfunction GalleryBadge() {\n  return (\n    <Badge status=\"accent\" variant=\"subtle\" size=\"sm\">\n      Gallery\n    </Badge>\n  );\n}\n\nfunction DependencyList({ label, titles, empty }: { label: string; titles: readonly string[]; empty: string }) {\n  const env = useEnv();\n  const labelId = useId();\n  const follow = (event: MouseEvent, id: string) => {\n    if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return;\n    event.preventDefault();\n    env.open(id);\n  };\n  return (\n    <div className=\"fg-index-deps__row\">\n      <dt id={labelId} className=\"fg-index-deps__label\">\n        {label}\n      </dt>\n      <dd className=\"fg-index-deps__value\">\n        {titles.length === 0 ? (\n          <span className=\"fg-index-deps__empty\">{empty}</span>\n        ) : (\n          <ul className=\"fg-index-deps__list\" aria-labelledby={labelId}>\n            {titles.map((title) => {\n              const cut = title.lastIndexOf('/') + 1;\n              const id = indexId(title);\n              return (\n                <li key={title}>\n                  <a className=\"fg-index-deps__link\" href={`#/${encodeURIComponent(id)}`} onClick={(event) => follow(event, id)}>\n                    <span className=\"fg-index-deps__prefix\">{title.slice(0, cut)}</span>\n                    {title.slice(cut)}\n                  </a>\n                </li>\n              );\n            })}\n          </ul>\n        )}\n      </dd>\n    </div>\n  );\n}\n\n/** The listed components this one uses and those that use it, read from source. Nothing for a gallery. */\nexport function IndexDependencies() {\n  const { gallery, dependencies } = useEnv();\n  if (gallery || !dependencies) return null;\n  if (dependencies.source === null) {\n    return (\n      <p className=\"fg-index-deps__none\">\n        forge found no source file for this component, so it lists none of its dependencies. It looks for the\n        import the meta&rsquo;s <code>component</code> names, or else the one the title&rsquo;s last segment names.\n      </p>\n    );\n  }\n  return (\n    <dl className=\"fg-index-deps\" aria-label=\"Dependencies\">\n      <DependencyList label=\"Uses\" titles={dependencies.uses} empty=\"No listed component.\" />\n      <DependencyList label=\"Used by\" titles={dependencies.usedBy} empty=\"No listed component uses it.\" />\n    </dl>\n  );\n}\n\nconst DAY = new Intl.DateTimeFormat(undefined, { dateStyle: 'medium' });\n\nfunction HistoryDate({ label, iso, version }: { label: string; iso: string; version: string | null }) {\n  return (\n    <div className=\"fg-index-history__item\">\n      <dt className=\"fg-index-history__label\">{label}</dt>\n      <dd className={`fg-index-history__value ${num.numeric}`}>\n        <time dateTime={iso}>{DAY.format(new Date(iso))}</time> ({version ?? 'unreleased'})\n      </dd>\n    </div>\n  );\n}\n\n/** When the component's source file was created and last changed, each with the release that shipped it, read from\n *  git. Nothing for a gallery, or for a source file git has never committed. */\nexport function IndexHistory() {\n  const { gallery, dependencies } = useEnv();\n  const history = gallery ? undefined : dependencies?.history;\n  if (!history) return null;\n  return (\n    <dl className=\"fg-index-history\" aria-label=\"History\">\n      <HistoryDate label=\"Created\" iso={history.created} version={history.introduced} />\n      <HistoryDate label=\"Modified\" iso={history.modified} version={history.modifiedIn} />\n    </dl>\n  );\n}\n\nfunction StorySection({ story, variants }: { story: LoadedStory; variants: boolean }) {\n  const env = useEnv();\n  const headingId = useId();\n  const description = env.descriptions[story.id];\n  const gallery = !env.gallery && env.galleries?.includes(story.id);\n  return (\n    <section className=\"fg-index-story\" aria-labelledby={headingId}>\n      <header className=\"fg-index-story__head\">\n        <h2 id={headingId} className=\"fg-index-story__name\">\n          {story.name}\n        </h2>\n        {gallery ? <GalleryBadge /> : null}\n        <Button variant=\"secondary\" size=\"sm\" onClick={() => env.open(story.id)}>\n          Open\n        </Button>\n      </header>\n      {description ? <p className=\"fg-index-story__description\">{description}</p> : null}\n      <IndexStory story={story} />\n      {variants ? <IndexVariants story={story} /> : null}\n    </section>\n  );\n}\n\n/** Which of `stories` show their variants: the first of each set of controls. Stories of one CSF file share their\n *  meta's controls, and the same rows under every story would only repeat. */\nfunction firstOfEachControlSet(stories: readonly LoadedStory[]): Set<string> {\n  const seen = new Set<string>();\n  const shown = new Set<string>();\n  for (const story of stories) {\n    const key = JSON.stringify(variantRows(story.config));\n    if (seen.has(key)) continue;\n    seen.add(key);\n    shown.add(story.id);\n  }\n  return shown;\n}\n\n/** The generated page: the component's title and description, then each story, with the variants of the first of\n *  each set of controls. */\nexport function DefaultIndex() {\n  const env = useEnv();\n  const withVariants = useMemo(() => firstOfEachControlSet(env.stories), [env.stories]);\n  const segments = env.title.split('/');\n  const name = segments.pop();\n  const { library } = env;\n  if (library !== undefined && segments[0] === library) segments.shift();\n  return (\n    <article className=\"fg-index\">\n      <header className=\"fg-index__head\">\n        {segments.length > 0 || library !== undefined ? (\n          <p className=\"fg-index__path\">\n            {library !== undefined ? <LibraryBadge library={library} className=\"fg-index__library\" /> : null}\n            {segments.join(' / ')}\n          </p>\n        ) : null}\n        <div className=\"fg-index__title-row\">\n          <h1 className=\"fg-index__title\">{name}</h1>\n          {env.gallery ? <GalleryBadge /> : null}\n        </div>\n        {env.description ? <p className=\"fg-index__description\">{env.description}</p> : null}\n        <IndexHistory />\n        <IndexDependencies />\n      </header>\n      {env.stories.map((story) => (\n        <StorySection key={story.id} story={story} variants={withVariants.has(story.id)} />\n      ))}\n    </article>\n  );\n}\n\n/** What a component's own index page is handed. */\nexport function indexContext(env: IndexEnv): IndexContext {\n  return {\n    title: env.title,\n    ...(env.description === undefined ? {} : { description: env.description }),\n    stories: env.stories,\n    globals: env.globals,\n    Story: IndexStory,\n    Variants: IndexVariants,\n    DefaultIndex,\n    Dependencies: IndexDependencies,\n    History: IndexHistory,\n    gallery: env.gallery ?? false,\n    open: env.open,\n  };\n}\n\n/** The page itself: the component's own, or the generated one. */\nexport function IndexPage({ env, render }: { env: IndexEnv; render: ((ctx: IndexContext) => ReactNode) | null }) {\n  return (\n    <IndexEnvContext.Provider value={env}>{render ? render(indexContext(env)) : <DefaultIndex />}</IndexEnvContext.Provider>\n  );\n}\n"]}

package/dist/{chunk-2OJAV522.js → chunk-GH5RE5X5.js}

@@ -6,5 +6,5 @@ var PORT_HANDOFF = "weaselforge:port";
 var FRAME_HELLO = "weaselforge:hello";
 
 export { FRAME_HELLO, PORT_HANDOFF, PROTOCOL_VERSION };
-//# sourceMappingURL=chunk-2OJAV522.js.map
-//# sourceMappingURL=chunk-2OJAV522.js.map
+//# sourceMappingURL=chunk-GH5RE5X5.js.map
+//# sourceMappingURL=chunk-GH5RE5X5.js.map

package/dist/chunk-GH5RE5X5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol/messages.ts"],"names":[],"mappings":";;;AAEO,IAAM,gBAAA,GAAmB;AA+FzB,IAAM,YAAA,GAAe;AASrB,IAAM,WAAA,GAAc","file":"chunk-GH5RE5X5.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/** What an axe run in the frame came back with. */\nexport type A11yOutcome = { ok: true; report: A11yReport } | { ok: false; message: string };\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  /** Outlines the elements each `A11yNode.target` reaches, in place of the last ones; an empty list clears. */\n  | { type: 'a11y.highlight'; targets: readonly (readonly 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 } & A11yOutcome)\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-SQ4KCIEH.js → chunk-KEQBGDUZ.js}

@@ -1,4 +1,4 @@
-import { stableStringify } from './chunk-2OJAV522.js';
+import { stableStringify } from './chunk-GH5RE5X5.js';
 import { createContext } from 'react';
 import { isPlainObject } from '@weasel-js/core';
 
@@ -93,5 +93,5 @@ function withUnsent(sent, original) {
 }
 
 export { ArgsContext, appliedLocal, coverOf, isPortSafe, portSafePart, withUnsent };
-//# sourceMappingURL=chunk-SQ4KCIEH.js.map
-//# sourceMappingURL=chunk-SQ4KCIEH.js.map
+//# sourceMappingURL=chunk-KEQBGDUZ.js.map
+//# sourceMappingURL=chunk-KEQBGDUZ.js.map

package/dist/{chunk-SQ4KCIEH.js.map → chunk-KEQBGDUZ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/csf/argsContext.ts","../src/csf/portSafe.ts"],"names":[],"mappings":"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","file":"chunk-SQ4KCIEH.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","import { isPlainObject } from '@weasel-js/core';\n\nconst 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\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 : isPlainObject(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) || !isPlainObject(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"]}
+{"version":3,"sources":["../src/csf/argsContext.ts","../src/csf/portSafe.ts"],"names":[],"mappings":"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","file":"chunk-KEQBGDUZ.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","import { isPlainObject } from '@weasel-js/core';\n\nconst 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\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 : isPlainObject(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) || !isPlainObject(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/{chunk-DPTECNYC.js → chunk-LTTEILXY.js}

@@ -1,4 +1,4 @@
-import { stableStringify } from './chunk-2OJAV522.js';
+import { stableStringify } from './chunk-GH5RE5X5.js';
 import { valueAtPath, isConfigBranch } from '@weasel-js/labkit/config';
 import { isPlainObject } from '@weasel-js/core';
 
@@ -148,5 +148,5 @@ function storyHref(story, knobs = {}, params = {}) {
 }
 
 export { PLAYHEAD_PARAM, RESERVED_PARAMS, decodeKnob, encodeKnob, formatRoute, knobParams, knobPaths, knobsToParams, paramsToKnobs, parseRoute, reservedParams, sameKnob, storyHref };
-//# sourceMappingURL=chunk-DPTECNYC.js.map
-//# sourceMappingURL=chunk-DPTECNYC.js.map
+//# sourceMappingURL=chunk-LTTEILXY.js.map
+//# sourceMappingURL=chunk-LTTEILXY.js.map

package/dist/{chunk-DPTECNYC.js.map → chunk-LTTEILXY.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/route/url.ts"],"names":[],"mappings":"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","file":"chunk-DPTECNYC.js","sourcesContent":["import { type ConfigSchema, type ConfigShape, isConfigBranch, valueAtPath } from '@weasel-js/labkit/config';\nimport { isPlainObject } from '@weasel-js/core';\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"]}
+{"version":3,"sources":["../src/route/url.ts"],"names":[],"mappings":"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","file":"chunk-LTTEILXY.js","sourcesContent":["import { type ConfigSchema, type ConfigShape, isConfigBranch, valueAtPath } from '@weasel-js/labkit/config';\nimport { isPlainObject } from '@weasel-js/core';\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"]}