@weasel-js/forge 1.11.0 → 1.12.0

package/dist/test/index.css

@@ -0,0 +1,58 @@
+/* src/shell/loupe/loupe.css */
+.fg-lens-live {
+  position: absolute;
+  inset: 0;
+  overflow: hidden;
+}
+.fg-lens-copy {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: var(--fg-lens-copy-w);
+  height: var(--fg-lens-copy-h);
+  transform-origin: 0 0;
+  transform: translate(var(--fg-lens-copy-x), var(--fg-lens-copy-y)) scale(var(--fg-lens-copy-f));
+}
+.fg-lens-copy > .fg-story,
+.fg-lens-copy > .fg-frame-host {
+  background: var(--wzl-bg);
+}
+.fg-lens-pixels {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  image-rendering: pixelated;
+}
+.fg-lens-empty {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: var(--wzl-space-4);
+  text-align: center;
+  font-size: 11px;
+  color: var(--wzl-fg-muted);
+  background: var(--wzl-bg);
+}
+.fg-lens-empty[hidden] {
+  display: none;
+}
+.fg-loupe-hint {
+  position: absolute;
+  left: var(--wzl-space-8);
+  bottom: var(--wzl-space-8);
+  z-index: 4;
+}
+.fg-lens-token__link {
+  padding: 0;
+  border: 0;
+  font: inherit;
+  color: inherit;
+  text-decoration: underline;
+  background: none;
+  cursor: pointer;
+  pointer-events: auto;
+}
+/*# sourceMappingURL=index.css.map */

package/dist/test/index.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shell/loupe/loupe.css"],"sourcesContent":["/* A Live lens's own box inside its slot: the copy is portaled into it, and the message beneath it shows when no copy is. */\n.fg-lens-live {\n  position: absolute;\n  inset: 0;\n  overflow: hidden;\n}\n\n/* A second render of a story, at its host's own size, scaled about the reticle's point onto the slot's center. */\n.fg-lens-copy {\n  position: absolute;\n  top: 0;\n  left: 0;\n  width: var(--fg-lens-copy-w);\n  height: var(--fg-lens-copy-h);\n  transform-origin: 0 0;\n  transform: translate(var(--fg-lens-copy-x), var(--fg-lens-copy-y)) scale(var(--fg-lens-copy-f));\n}\n\n/* Painted in the copy's own mode, so a transparent story does not show the lab through the lens. */\n.fg-lens-copy > .fg-story,\n.fg-lens-copy > .fg-frame-host {\n  background: var(--wzl-bg);\n}\n\n/* A Pixels lens's capture, enlarged nearest-neighbor: the browser scaling the canvas to the screen keeps it so. */\n.fg-lens-pixels {\n  position: absolute;\n  inset: 0;\n  width: 100%;\n  height: 100%;\n  image-rendering: pixelated;\n}\n\n/* What a lens says in place of its story: nothing under the reticle, or why it cannot show it. */\n.fg-lens-empty {\n  position: absolute;\n  inset: 0;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  padding: var(--wzl-space-4);\n  text-align: center;\n  font-size: 11px;\n  color: var(--wzl-fg-muted);\n  background: var(--wzl-bg);\n}\n\n.fg-lens-empty[hidden] {\n  display: none;\n}\n\n/* Above the lens layer, in the lab body's corner. */\n.fg-loupe-hint {\n  position: absolute;\n  left: var(--wzl-space-8);\n  bottom: var(--wzl-space-8);\n  z-index: 4;\n}\n\n/* A token in the Token readout: the readouts take no pointer, so the link takes it back. */\n.fg-lens-token__link {\n  padding: 0;\n  border: 0;\n  font: inherit;\n  color: inherit;\n  text-decoration: underline;\n  background: none;\n  cursor: pointer;\n  pointer-events: auto;\n}\n"],"mappings":";AACA,CAAC;AACC,YAAU;AACV,SAAO;AACP,YAAU;AACZ;AAGA,CAAC;AACC,YAAU;AACV,OAAK;AACL,QAAM;AACN,SAAO,IAAI;AACX,UAAQ,IAAI;AACZ,oBAAkB,EAAE;AACpB,aAAW,UAAU,IAAI,iBAAiB,EAAE,IAAI,mBAAmB,MAAM,IAAI;AAC/E;AAGA,CAXC,aAWa,EAAE,CAAC;AACjB,CAZC,aAYa,EAAE,CAAC;AACf,cAAY,IAAI;AAClB;AAGA,CAAC;AACC,YAAU;AACV,SAAO;AACP,SAAO;AACP,UAAQ;AACR,mBAAiB;AACnB;AAGA,CAAC;AACC,YAAU;AACV,SAAO;AACP,WAAS;AACT,eAAa;AACb,mBAAiB;AACjB,WAAS,IAAI;AACb,cAAY;AACZ,aAAW;AACX,SAAO,IAAI;AACX,cAAY,IAAI;AAClB;AAEA,CAbC,aAaa,CAAC;AACb,WAAS;AACX;AAGA,CAAC;AACC,YAAU;AACV,QAAM,IAAI;AACV,UAAQ,IAAI;AACZ,WAAS;AACX;AAGA,CAAC;AACC,WAAS;AACT,UAAQ;AACR,QAAM;AACN,SAAO;AACP,mBAAiB;AACjB,cAAY;AACZ,UAAQ;AACR,kBAAgB;AAClB;","names":[]}

package/dist/test/index.d.ts

@@ -1,4 +1,4 @@
-import { F as FrameSetup } from '../FrameController-BRhShqut.js';
+import { F as FrameSetup } from '../FrameController-CdnaIo4C.js';
 import '@weasel-js/icons';
 import '@weasel-js/labkit/config';
 import 'react';
@@ -7,8 +7,6 @@ import 'react';
 interface RunStoryOptions {
     /** The frame config (`frameConfig`). */
     setup?: FrameSetup;
-    /** Resizes the page, for a story that names a viewport. Without it, stories run at whatever size the page is. */
-    viewport?: (width: number, height: number) => Promise<void>;
 }
 /**
  * Renders one story in the test page the way the workshop does — defaults, no state, no globals — then plays it.
@@ -16,6 +14,6 @@ interface RunStoryOptions {
  */
 declare function runStory(mod: Record<string, unknown>, exportName: string, file: string, 
 /** The file's index entry title. */
-title: string, { setup, viewport }?: RunStoryOptions): Promise<void>;
+title: string, { setup }?: RunStoryOptions): Promise<void>;
 
 export { type RunStoryOptions, runStory };

package/dist/test/index.js

@@ -1,10 +1,10 @@
-import { StoryTrial } from '../chunk-J3GYSNCK.js';
-import '../chunk-7BQPHMA2.js';
-import { loadStories } from '../chunk-NVNTQ4AT.js';
+import { StoryTrial } from '../chunk-YDLRSEUN.js';
+import '../chunk-3BAM6M26.js';
+import { loadStories } from '../chunk-WMGEO5M6.js';
 import '../chunk-L5XM5VKB.js';
-import '../chunk-ZAWXMUGZ.js';
-import '../chunk-SQ4KCIEH.js';
-import '../chunk-2OJAV522.js';
+import '../chunk-5WS67HMU.js';
+import '../chunk-KEQBGDUZ.js';
+import '../chunk-GH5RE5X5.js';
 import { withValueAtPath } from '@weasel-js/labkit/config';
 import { useState, useEffect } from 'react';
 import { createRoot } from 'react-dom/client';
@@ -32,8 +32,7 @@ function TestTrial({ story, setup, hostRef, onConfig, onRendered, onError }) {
   return /* @__PURE__ */ jsx(StoryTrial, { story, setup, ctx, hostRef, onRendered, onError });
 }
 var leftover = null;
-var pageSize = null;
-async function runStory(mod, exportName, file, title, { setup = {}, viewport } = {}) {
+async function runStory(mod, exportName, file, title, { setup = {} } = {}) {
   leftover?.();
   let story;
   try {
@@ -42,12 +41,11 @@ async function runStory(mod, exportName, file, title, { setup = {}, viewport } =
     throw phased("load", error);
   }
   if (!story) throw new Error(`load fault: ${file} has no story export "${exportName}"`);
-  pageSize ??= { width: window.innerWidth, height: window.innerHeight };
-  const size = story.viewport ?? pageSize;
-  if (viewport && (window.innerWidth !== size.width || window.innerHeight !== size.height)) {
-    await viewport(size.width, size.height);
-  }
   const container = document.createElement("div");
+  if (story.viewport) {
+    container.style.width = `${story.viewport.width}px`;
+    container.style.height = `${story.viewport.height}px`;
+  }
   document.body.append(container);
   let root;
   const cleanup = () => {

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  /** 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"]}
+{"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 { 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}\n\n/** Stops the story a timed-out test left mounted. */\nlet leftover: (() => unknown) | 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 = {} }: 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  const container = document.createElement('div');\n  // The workshop gives a story's viewport to its stage, a box of that size, not to the window.\n  if (story.viewport) {\n    container.style.width = `${story.viewport.width}px`;\n    container.style.height = `${story.viewport.height}px`;\n  }\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"]}