@weasel-js/forge 1.9.3 → 1.10.0

package/dist/test/index.d.ts

@@ -1,4 +1,4 @@
-import { F as FrameSetup } from '../FrameController-CpcY0DNB.js';
+import { F as FrameSetup } from '../FrameController-UeTY7ubF.js';
 import '@weasel-js/labkit/config';
 import 'react';
 
@@ -13,6 +13,8 @@ interface RunStoryOptions {
  * Renders one story in the test page the way the workshop does — defaults, no state, no globals — then plays it.
  * Throws on a render the story's boundary caught, or a play function that fails.
  */
-declare function runStory(mod: Record<string, unknown>, exportName: string, file: string, autoTitle: string, { setup, viewport }?: RunStoryOptions): Promise<void>;
+declare function runStory(mod: Record<string, unknown>, exportName: string, file: string, 
+/** The file's index entry title. */
+title: string, { setup, viewport }?: RunStoryOptions): Promise<void>;
 
 export { type RunStoryOptions, runStory };

package/dist/test/index.js

@@ -1,10 +1,10 @@
-import { StoryTrial } from '../chunk-BGOHALHO.js';
-import '../chunk-GZPQMGXJ.js';
-import { loadStories } from '../chunk-Q2EZXJFE.js';
+import { StoryTrial } from '../chunk-ENXU34PI.js';
+import '../chunk-DFKCLZKS.js';
+import { loadStories } from '../chunk-4NM3RTYK.js';
 import '../chunk-L5XM5VKB.js';
-import '../chunk-HRGPFQBW.js';
-import '../chunk-MGQWCPYE.js';
-import '../chunk-KJGXJD3U.js';
+import '../chunk-ZAWXMUGZ.js';
+import '../chunk-GB6PRJET.js';
+import '../chunk-FL2MUPUL.js';
 import { withValueAtPath } from '@weasel-js/labkit/config';
 import { useState, useEffect } from 'react';
 import { createRoot } from 'react-dom/client';
@@ -33,11 +33,11 @@ function TestTrial({ story, setup, hostRef, onConfig, onRendered, onError }) {
 }
 var leftover = null;
 var pageSize = null;
-async function runStory(mod, exportName, file, autoTitle, { setup = {}, viewport } = {}) {
+async function runStory(mod, exportName, file, title, { setup = {}, viewport } = {}) {
   leftover?.();
   let story;
   try {
-    story = loadStories(mod, autoTitle, setup.parameters).find((s) => s.exportName === exportName);
+    story = loadStories(mod, title, setup.parameters).find((s) => s.exportName === exportName);
   } catch (error) {
     throw phased("load", error);
   }

package/dist/test/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/test/runStory.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { withValueAtPath } from '@weasel-js/labkit/config';\nimport { type RefObject, useEffect, useState } from 'react';\nimport { createRoot, type Root } from 'react-dom/client';\nimport type { FrameSetup } from '../frame/FrameController';\nimport type { Viewport } from '../protocol/messages';\nimport { StoryTrial } from '../shell/StoryTrial';\nimport { loadStories } from '../story/load';\nimport type { LoadedStory } from '../story/types';\n\n/** Prefixes `error` with the phase it came from, keeping its stack. */\nfunction phased(phase: string, error: unknown): Error {\n  const message = error instanceof Error ? error.message : String(error);\n  const out = new Error(`${phase} fault: ${message}`, { cause: error });\n  if (error instanceof Error && error.stack) out.stack = `${phase} fault: ${error.stack}`;\n  return out;\n}\n\nconst settle = () =>\n  new Promise<void>((resolve) => {\n    requestAnimationFrame(() => setTimeout(resolve, 0));\n  });\n\ninterface TestTrialProps {\n  story: LoadedStory;\n  setup: FrameSetup;\n  hostRef: RefObject<HTMLElement | null>;\n  /** The config in force after each commit, so `play` reads what the story last wrote. */\n  onConfig: (config: unknown) => void;\n  onRendered: () => void;\n  onError: (error: unknown) => void;\n}\n\n/** The trial a story test runs in: its config and state, held the way a lab trial holds them. */\nfunction TestTrial({ story, setup, hostRef, onConfig, onRendered, onError }: TestTrialProps) {\n  const [config, setConfigState] = useState<unknown>(() => story.config.defaults());\n  const [state, setState] = useState<unknown>(null);\n  useEffect(() => onConfig(config), [config, onConfig]);\n  const ctx = {\n    config,\n    state,\n    setConfig: (path: string, value: unknown) => setConfigState((prev: unknown) => withValueAtPath(prev, path, value)),\n    setState,\n  };\n  return <StoryTrial story={story} setup={setup} ctx={ctx} hostRef={hostRef} onRendered={onRendered} onError={onError} />;\n}\n\n/** Options for `runStory`. */\nexport interface RunStoryOptions {\n  /** The frame config (`frameConfig`). */\n  setup?: FrameSetup;\n  /** Resizes the page, for a story that names a viewport. Without it, stories run at whatever size the page is. */\n  viewport?: (width: number, height: number) => Promise<void>;\n}\n\n/** Stops the story a timed-out test left mounted. */\nlet leftover: (() => unknown) | null = null;\n/** The page's size before any story resized it; a story with no viewport runs at this size. */\nlet pageSize: Viewport | null = null;\n\n/**\n * Renders one story in the test page the way the workshop does — defaults, no state, no globals — then plays it.\n * Throws on a render the story's boundary caught, or a play function that fails.\n */\nexport async function runStory(\n  mod: Record<string, unknown>,\n  exportName: string,\n  file: string,\n  autoTitle: string,\n  { setup = {}, viewport }: RunStoryOptions = {},\n): Promise<void> {\n  leftover?.();\n  let story: LoadedStory | undefined;\n  try {\n    story = loadStories(mod, autoTitle, setup.parameters).find((s) => s.exportName === exportName);\n  } catch (error) {\n    throw phased('load', error);\n  }\n  if (!story) throw new Error(`load fault: ${file} has no story export \"${exportName}\"`);\n\n  pageSize ??= { width: window.innerWidth, height: window.innerHeight };\n  const size = story.viewport ?? pageSize;\n  if (viewport && (window.innerWidth !== size.width || window.innerHeight !== size.height)) {\n    await viewport(size.width, size.height);\n  }\n\n  const container = document.createElement('div');\n  document.body.append(container);\n  let root: Root | undefined;\n  /** Returns what unmounting threw, having released everything else regardless. */\n  const cleanup = (): { error: unknown } | null => {\n    if (leftover === cleanup) leftover = null;\n    let thrown: { error: unknown } | null = null;\n    try {\n      root?.unmount();\n    } catch (error) {\n      thrown = { error };\n    } finally {\n      root = undefined;\n      container.remove();\n    }\n    return thrown;\n  };\n  leftover = cleanup;\n\n  const hostRef: RefObject<HTMLElement | null> = { current: null };\n  let config: unknown;\n  let renderError: { error: unknown } | null = null;\n  let markRendered: () => void = () => {};\n  const rendered = new Promise<void>((resolve) => {\n    markRendered = resolve;\n  });\n  const fail = (error: unknown) => {\n    renderError ??= { error };\n    // An error the boundary could not catch leaves nothing to announce `rendered`; the check below throws instead.\n    markRendered();\n  };\n  const checkRender = () => {\n    if (renderError) throw phased('render', renderError.error);\n  };\n\n  let failure: { error: unknown } | null = null;\n  try {\n    try {\n      await setup.prepare?.(story);\n      root = createRoot(container, { onUncaughtError: fail });\n      root.render(\n        <TestTrial\n          story={story}\n          setup={setup}\n          hostRef={hostRef}\n          onConfig={(next) => {\n            config = next;\n          }}\n          onRendered={markRendered}\n          onError={fail}\n        />,\n      );\n    } catch (error) {\n      throw phased('mount', error);\n    }\n    await rendered;\n    await settle();\n    checkRender();\n    const host = hostRef.current;\n    if (!host) throw new Error('render fault: the story host never mounted');\n    if (story.play) {\n      try {\n        await story.play({ canvasElement: host, config, globals: {} });\n      } catch (error) {\n        throw phased('play', error);\n      }\n      await settle();\n      checkRender();\n    }\n  } catch (error) {\n    failure = { error };\n  }\n  const cleanupError = cleanup();\n  if (failure) throw failure.error;\n  if (cleanupError) throw phased('cleanup', cleanupError.error);\n}\n"]}
+{"version":3,"sources":["../../src/test/runStory.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { withValueAtPath } from '@weasel-js/labkit/config';\nimport { type RefObject, useEffect, useState } from 'react';\nimport { createRoot, type Root } from 'react-dom/client';\nimport type { FrameSetup } from '../frame/FrameController';\nimport type { Viewport } from '../protocol/messages';\nimport { StoryTrial } from '../shell/StoryTrial';\nimport { loadStories } from '../story/load';\nimport type { LoadedStory } from '../story/types';\n\n/** Prefixes `error` with the phase it came from, keeping its stack. */\nfunction phased(phase: string, error: unknown): Error {\n  const message = error instanceof Error ? error.message : String(error);\n  const out = new Error(`${phase} fault: ${message}`, { cause: error });\n  if (error instanceof Error && error.stack) out.stack = `${phase} fault: ${error.stack}`;\n  return out;\n}\n\nconst settle = () =>\n  new Promise<void>((resolve) => {\n    requestAnimationFrame(() => setTimeout(resolve, 0));\n  });\n\ninterface TestTrialProps {\n  story: LoadedStory;\n  setup: FrameSetup;\n  hostRef: RefObject<HTMLElement | null>;\n  /** The config in force after each commit, so `play` reads what the story last wrote. */\n  onConfig: (config: unknown) => void;\n  onRendered: () => void;\n  onError: (error: unknown) => void;\n}\n\n/** The trial a story test runs in: its config and state, held the way a lab trial holds them. */\nfunction TestTrial({ story, setup, hostRef, onConfig, onRendered, onError }: TestTrialProps) {\n  const [config, setConfigState] = useState<unknown>(() => story.config.defaults());\n  const [state, setState] = useState<unknown>(null);\n  useEffect(() => onConfig(config), [config, onConfig]);\n  const ctx = {\n    config,\n    state,\n    setConfig: (path: string, value: unknown) => setConfigState((prev: unknown) => withValueAtPath(prev, path, value)),\n    setState,\n  };\n  return <StoryTrial story={story} setup={setup} ctx={ctx} hostRef={hostRef} onRendered={onRendered} onError={onError} />;\n}\n\n/** Options for `runStory`. */\nexport interface RunStoryOptions {\n  /** The frame config (`frameConfig`). */\n  setup?: FrameSetup;\n  /** Resizes the page, for a story that names a viewport. Without it, stories run at whatever size the page is. */\n  viewport?: (width: number, height: number) => Promise<void>;\n}\n\n/** Stops the story a timed-out test left mounted. */\nlet leftover: (() => unknown) | null = null;\n/** The page's size before any story resized it; a story with no viewport runs at this size. */\nlet pageSize: Viewport | null = null;\n\n/**\n * Renders one story in the test page the way the workshop does — defaults, no state, no globals — then plays it.\n * Throws on a render the story's boundary caught, or a play function that fails.\n */\nexport async function runStory(\n  mod: Record<string, unknown>,\n  exportName: string,\n  file: string,\n  /** The file's index entry title. */\n  title: string,\n  { setup = {}, viewport }: RunStoryOptions = {},\n): Promise<void> {\n  leftover?.();\n  let story: LoadedStory | undefined;\n  try {\n    story = loadStories(mod, title, setup.parameters).find((s) => s.exportName === exportName);\n  } catch (error) {\n    throw phased('load', error);\n  }\n  if (!story) throw new Error(`load fault: ${file} has no story export \"${exportName}\"`);\n\n  pageSize ??= { width: window.innerWidth, height: window.innerHeight };\n  const size = story.viewport ?? pageSize;\n  if (viewport && (window.innerWidth !== size.width || window.innerHeight !== size.height)) {\n    await viewport(size.width, size.height);\n  }\n\n  const container = document.createElement('div');\n  document.body.append(container);\n  let root: Root | undefined;\n  /** Returns what unmounting threw, having released everything else regardless. */\n  const cleanup = (): { error: unknown } | null => {\n    if (leftover === cleanup) leftover = null;\n    let thrown: { error: unknown } | null = null;\n    try {\n      root?.unmount();\n    } catch (error) {\n      thrown = { error };\n    } finally {\n      root = undefined;\n      container.remove();\n    }\n    return thrown;\n  };\n  leftover = cleanup;\n\n  const hostRef: RefObject<HTMLElement | null> = { current: null };\n  let config: unknown;\n  let renderError: { error: unknown } | null = null;\n  let markRendered: () => void = () => {};\n  const rendered = new Promise<void>((resolve) => {\n    markRendered = resolve;\n  });\n  const fail = (error: unknown) => {\n    renderError ??= { error };\n    // An error the boundary could not catch leaves nothing to announce `rendered`; the check below throws instead.\n    markRendered();\n  };\n  const checkRender = () => {\n    if (renderError) throw phased('render', renderError.error);\n  };\n\n  let failure: { error: unknown } | null = null;\n  try {\n    try {\n      await setup.prepare?.(story);\n      root = createRoot(container, { onUncaughtError: fail });\n      root.render(\n        <TestTrial\n          story={story}\n          setup={setup}\n          hostRef={hostRef}\n          onConfig={(next) => {\n            config = next;\n          }}\n          onRendered={markRendered}\n          onError={fail}\n        />,\n      );\n    } catch (error) {\n      throw phased('mount', error);\n    }\n    await rendered;\n    await settle();\n    checkRender();\n    const host = hostRef.current;\n    if (!host) throw new Error('render fault: the story host never mounted');\n    if (story.play) {\n      try {\n        await story.play({ canvasElement: host, config, globals: {} });\n      } catch (error) {\n        throw phased('play', error);\n      }\n      await settle();\n      checkRender();\n    }\n  } catch (error) {\n    failure = { error };\n  }\n  const cleanupError = cleanup();\n  if (failure) throw failure.error;\n  if (cleanupError) throw phased('cleanup', cleanupError.error);\n}\n"]}

package/dist/test/play.d.ts

@@ -5,12 +5,10 @@ export { default as userEvent } from '@testing-library/user-event';
 /**
  * What a CSF `play` function asserts with.
  *
- * A play runs inside the story's frame — a real browser document, driven by
- * `forgeTest` under vitest or by the workshop — so it cannot import `vitest`,
+ * A play runs in the test page beside the story, so it cannot import `vitest`,
  * whose entry only exists inside a test worker. This module assembles the same
  * `expect` vitest hands a test: chai carrying `@vitest/expect`'s jest-style
- * matchers. Queries and input come from testing-library, which is already
- * browser-only.
+ * matchers.
  *
  * No jest-dom matchers. They install through `expect.extend`, which wants the
  * matcher state a test worker sets up, and there is none here — the call

package/dist/test/play.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/test/play.ts"],"names":["expect"],"mappings":";;;;;;AAmBK,IAAA,CAAA,GAAA,CAAI,UAAU,CAAA;AACd,IAAA,CAAA,GAAA,CAAI,cAAc,CAAA;AAClB,IAAA,CAAA,GAAA,CAAI,sBAAsB,CAAA;AAGxB,IAAMA,OAAAA,GAAc,IAAA,CAAA","file":"play.js","sourcesContent":["/**\n * What a CSF `play` function asserts with.\n *\n * A play runs inside the story's frame — a real browser document, driven by\n * `forgeTest` under vitest or by the workshop — so it cannot import `vitest`,\n * whose entry only exists inside a test worker. This module assembles the same\n * `expect` vitest hands a test: chai carrying `@vitest/expect`'s jest-style\n * matchers. Queries and input come from testing-library, which is already\n * browser-only.\n *\n * No jest-dom matchers. They install through `expect.extend`, which wants the\n * matcher state a test worker sets up, and there is none here — the call\n * throws at module scope. Assert on the DOM directly instead:\n * `expect(el.textContent).toBe(…)` for `toHaveTextContent`,\n * `expect(el).not.toBeNull()` for `toBeInTheDocument`.\n */\nimport { type ExpectStatic, JestAsymmetricMatchers, JestChaiExpect, JestExtend } from '@vitest/expect';\nimport * as chai from 'chai';\n\nchai.use(JestExtend);\nchai.use(JestChaiExpect);\nchai.use(JestAsymmetricMatchers);\n\n/** `expect`, with jest's matchers. */\nexport const expect = chai.expect as unknown as ExpectStatic;\n\nexport { screen, waitFor, within } from '@testing-library/dom';\nexport { default as userEvent } from '@testing-library/user-event';\n"]}
+{"version":3,"sources":["../../src/test/play.ts"],"names":["expect"],"mappings":";;;;;;AAiBK,IAAA,CAAA,GAAA,CAAI,UAAU,CAAA;AACd,IAAA,CAAA,GAAA,CAAI,cAAc,CAAA;AAClB,IAAA,CAAA,GAAA,CAAI,sBAAsB,CAAA;AAGxB,IAAMA,OAAAA,GAAc,IAAA,CAAA","file":"play.js","sourcesContent":["/**\n * What a CSF `play` function asserts with.\n *\n * A play runs in the test page beside the story, so it cannot import `vitest`,\n * whose entry only exists inside a test worker. This module assembles the same\n * `expect` vitest hands a test: chai carrying `@vitest/expect`'s jest-style\n * matchers.\n *\n * No jest-dom matchers. They install through `expect.extend`, which wants the\n * matcher state a test worker sets up, and there is none here — the call\n * throws at module scope. Assert on the DOM directly instead:\n * `expect(el.textContent).toBe(…)` for `toHaveTextContent`,\n * `expect(el).not.toBeNull()` for `toBeInTheDocument`.\n */\nimport { type ExpectStatic, JestAsymmetricMatchers, JestChaiExpect, JestExtend } from '@vitest/expect';\nimport * as chai from 'chai';\n\nchai.use(JestExtend);\nchai.use(JestChaiExpect);\nchai.use(JestAsymmetricMatchers);\n\n/** `expect`, with jest's matchers. */\nexport const expect = chai.expect as unknown as ExpectStatic;\n\nexport { screen, waitFor, within } from '@testing-library/dom';\nexport { default as userEvent } from '@testing-library/user-event';\n"]}

package/dist/vite/index.d.ts

@@ -1,15 +1,32 @@
 import { Plugin } from 'vite';
 
+/** Narrows which props get a control. */
+interface PropControlsOptions {
+    /**
+     * Leaves out a prop declared in a file this answers true for, given the file's absolute path. Props that React's
+     * types or TypeScript's libraries declare are always left out.
+     */
+    skip?: (declaredIn: string) => boolean;
+}
+
 /** Options for the `forge` vite plugin. */
 interface ForgeOptions {
     /** Globs of story files, relative to the vite root. */
     stories: string[];
-    /** Path to the frame config module, relative to the vite root. Only frame documents import it. Optional. */
+    /** Path to the frame config module, relative to the vite root. The workshop page and every frame document import it. Optional. */
     frameConfig?: string;
     /** Path to the shell config module, relative to the vite root. Only the workshop page imports it. Optional. */
     shellConfig?: string;
+    /** Stylesheets for frame documents alone, relative to the vite root: a page background, a body font. The workshop page never loads them. */
+    frameStyles?: string[];
     /** Alias Storybook's runtime modules to forge shims. Default true. */
     storybookShims?: boolean;
+    /**
+     * Give a CSF story a control for each prop of its meta's `component`, read from the component's TypeScript types;
+     * the story's own `args` and `argTypes` refine them. Needs `typescript` installed. Default true; an object narrows
+     * which props are read.
+     */
+    propControls?: boolean | PropControlsOptions;
 }
 /**
  * The vite plugin that serves the workshop: it indexes the story files, serves the workshop at `/` and the frame
@@ -32,4 +49,4 @@ interface ForgeTestOptions {
  */
 declare function forgeTest(options: ForgeTestOptions): Plugin[];
 
-export { type ForgeOptions, type ForgeTestOptions, forge, forgeTest };
+export { type ForgeOptions, type ForgeTestOptions, type PropControlsOptions, forge, forgeTest };