@weasel-js/forge 1.6.1 → 1.7.1

package/dist/test/index.d.ts

@@ -1,7 +1,8 @@
-import { F as FrameSetup } from '../FrameController-BspC9Zr5.js';
+import { F as FrameSetup } from '../FrameController-RdGggdGA.js';
 import '@weasel-js/labkit/config';
 import 'react';
 
+/** Options for `runStory`. */
 interface RunStoryOptions {
     /** The frame config (`frameConfig`). */
     setup?: FrameSetup;

package/dist/test/index.js

@@ -1,8 +1,9 @@
-import { StoryTrial } from '../chunk-DIOLWCH7.js';
-import { loadStories } from '../chunk-OLWZURU3.js';
-import '../chunk-2GXKNXTJ.js';
+import { StoryTrial } from '../chunk-SEK6EKHO.js';
+import '../chunk-JNJGIUYU.js';
+import { loadStories } from '../chunk-NYBMOSSR.js';
+import '../chunk-Y3WZ2EWR.js';
 import '../chunk-HRGPFQBW.js';
-import '../chunk-JXIWZFD4.js';
+import '../chunk-YKN3IAEX.js';
 import { withValueAtPath } from '@weasel-js/labkit/config';
 import { useState, useEffect } from 'react';
 import { createRoot } from 'react-dom/client';

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\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  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"]}

package/dist/vite/index.d.ts

@@ -1,5 +1,6 @@
 import { Plugin } from 'vite';
 
+/** Options for the `forge` vite plugin. */
 interface ForgeOptions {
     /** Globs of story files, relative to the vite root. */
     stories: string[];
@@ -7,11 +8,16 @@ interface ForgeOptions {
     frameConfig?: string;
     /** Path to the shell config module, relative to the vite root. Only the workshop page imports it. Optional. */
     shellConfig?: string;
-    /** Alias Storybook's runtime modules to forge shims (Task 13). Default true. */
+    /** Alias Storybook's runtime modules to forge shims. Default true. */
     storybookShims?: boolean;
 }
+/**
+ * The vite plugin that serves the workshop: it indexes the story files, serves the workshop at `/` and the frame
+ * document at `/frame.html`, pushes a new index to the open page as story files change, and builds both pages.
+ */
 declare function forge(options: ForgeOptions): Plugin[];
 
+/** Options for the `forgeTest` vite plugin. */
 interface ForgeTestOptions {
     /** Globs of story files, relative to the vite root. Each matching file becomes a test file. */
     stories: string[];

package/dist/vite/index.js

@@ -1,8 +1,9 @@
+import { isGallery } from '../chunk-WEQSLPKT.js';
 import { storyNameFromExport, storyId } from '../chunk-HRGPFQBW.js';
 import { existsSync, readFileSync, mkdirSync, writeFileSync, globSync, statSync } from 'fs';
-import { resolve, relative, sep, matchesGlob, dirname, join, basename } from 'path';
-import { fileURLToPath } from 'url';
+import { resolve, sep, relative, matchesGlob, dirname, join, basename } from 'path';
 import { parse } from '@babel/parser';
+import { fileURLToPath } from 'url';
 
 // src/vite/html.ts
 function html(entry, mode = "serve") {
@@ -74,6 +75,275 @@ function autoTitle(file, root, stories) {
   }
   return titleFrom(importPath, ".");
 }
+var keyOf = (file, local) => `${file}#${local}`;
+var fileOfKey = (key) => key.slice(0, key.lastIndexOf("#"));
+var SCRIPT = /\.[cm]?[jt]sx?$/;
+var DEFAULT_LOCAL = "*default*";
+var TYPE_KEYS = /* @__PURE__ */ new Set(["typeAnnotation", "typeParameters", "typeArguments", "returnType", "superTypeParameters", "implements"]);
+function createDepGraph({ root, read }) {
+  const modules = /* @__PURE__ */ new Map();
+  const resolutions = /* @__PURE__ */ new Map();
+  const info = (file) => {
+    if (!modules.has(file)) {
+      let parsed = null;
+      try {
+        parsed = moduleInfo(read(file), file);
+      } catch {
+        parsed = null;
+      }
+      modules.set(file, parsed);
+    }
+    return modules.get(file) ?? null;
+  };
+  return {
+    invalidate(file) {
+      const known = modules.has(file) || resolutions.has(file);
+      modules.delete(file);
+      resolutions.delete(file);
+      return known;
+    },
+    reset() {
+      resolutions.clear();
+    },
+    async build(entries, resolve4) {
+      const resolveFrom = (spec, importer) => {
+        let byImporter = resolutions.get(importer);
+        if (!byImporter) {
+          byImporter = /* @__PURE__ */ new Map();
+          resolutions.set(importer, byImporter);
+        }
+        let pending = byImporter.get(spec);
+        if (!pending) {
+          pending = resolve4(spec, importer).then(
+            (id) => {
+              const file = id?.split("?")[0];
+              return file && !file.startsWith("\0") && SCRIPT.test(file) && !file.split(/[\\/]/).includes("node_modules") ? file : null;
+            },
+            () => null
+          );
+          byImporter.set(spec, pending);
+        }
+        return pending;
+      };
+      const declaring = async (file, name, depth = 0) => {
+        const mod = info(file);
+        if (!mod || depth > 32) return null;
+        const exp = mod.exports.get(name);
+        if (exp?.kind === "local") {
+          const imp = mod.imports.get(exp.local);
+          return imp ? importKey(file, imp, depth + 1) : keyOf(file, exp.local);
+        }
+        if (exp?.kind === "from") {
+          const target = await resolveFrom(exp.spec, file);
+          return target ? declaring(target, exp.imported, depth + 1) : null;
+        }
+        if (name === "default") return null;
+        for (const spec of mod.stars) {
+          const target = await resolveFrom(spec, file);
+          const found = target ? await declaring(target, name, depth + 1) : null;
+          if (found) return found;
+        }
+        return null;
+      };
+      const importKey = async (importer, imp, depth = 0) => {
+        if (imp.imported === "*") return null;
+        const target = await resolveFrom(imp.spec, importer);
+        return target ? declaring(target, imp.imported, depth) : null;
+      };
+      const componentOf = async (entry) => {
+        const mod = info(entry.file);
+        if (!mod) return null;
+        const byTitle = entry.title.split("/").pop()?.replace(/\s+/g, "");
+        for (const local of [entry.componentName, byTitle]) {
+          const imp = local ? mod.imports.get(local) : void 0;
+          const key = imp ? await importKey(entry.file, imp) : null;
+          if (key) return key;
+        }
+        return null;
+      };
+      const titles = /* @__PURE__ */ new Map();
+      for (const entry of entries) {
+        if (isGallery(entry)) continue;
+        const list = titles.get(entry.title);
+        if (list) list.push(entry);
+        else titles.set(entry.title, [entry]);
+      }
+      const components = /* @__PURE__ */ new Map();
+      const byKey = /* @__PURE__ */ new Map();
+      for (const [title, list] of titles) {
+        let key = null;
+        for (const file of new Set(list.map((e) => e.file))) {
+          key = await componentOf(list.find((e) => e.file === file));
+          if (key) break;
+        }
+        components.set(title, key);
+        if (key) byKey.set(key, [...byKey.get(key) ?? [], title]);
+      }
+      const componentFiles = new Set([...byKey.keys()].map(fileOfKey));
+      const reached = async (key) => {
+        const out = /* @__PURE__ */ new Set();
+        const home = fileOfKey(key);
+        const homeDir = dirname(home);
+        const visited = /* @__PURE__ */ new Set();
+        const walkFile = async (file, roots) => {
+          const mod = info(file);
+          if (!mod) return;
+          const locals = /* @__PURE__ */ new Set();
+          if (roots === null) {
+            for (const name of mod.refs.keys()) locals.add(name);
+            for (const name of mod.imports.keys()) locals.add(name);
+          } else {
+            const queue = [...roots];
+            while (queue.length > 0) {
+              const name = queue.pop();
+              if (locals.has(name)) continue;
+              locals.add(name);
+              const here = keyOf(file, name);
+              if (here !== key && byKey.has(here)) {
+                out.add(here);
+                continue;
+              }
+              for (const ref of mod.refs.get(name) ?? []) {
+                if (mod.refs.has(ref) || mod.imports.has(ref)) queue.push(ref);
+              }
+            }
+          }
+          for (const name of locals) {
+            const imp = mod.imports.get(name);
+            if (!imp) continue;
+            const target = await importKey(file, imp);
+            if (target && byKey.has(target)) {
+              if (target !== key) out.add(target);
+              continue;
+            }
+            if (!imp.spec.startsWith(".")) continue;
+            const helper = await resolveFrom(imp.spec, file);
+            if (!helper || visited.has(helper) || componentFiles.has(helper)) continue;
+            if (relative(homeDir, helper).startsWith("..")) continue;
+            visited.add(helper);
+            await walkFile(helper, null);
+          }
+        };
+        visited.add(home);
+        await walkFile(home, [key.slice(home.length + 1)]);
+        return out;
+      };
+      const graph = {};
+      for (const [title, key] of components) {
+        graph[title] = { source: key ? relative(root, fileOfKey(key)).split(sep).join("/") : null, uses: [], usedBy: [] };
+      }
+      for (const [title, key] of components) {
+        if (!key) continue;
+        const uses = /* @__PURE__ */ new Set();
+        for (const target of await reached(key)) {
+          for (const other of byKey.get(target) ?? []) if (other !== title) uses.add(other);
+        }
+        const node = graph[title];
+        node.uses = [...uses].sort();
+        for (const other of node.uses) graph[other]?.usedBy.push(title);
+      }
+      for (const node of Object.values(graph)) node.usedBy.sort();
+      return Object.fromEntries(Object.entries(graph).sort(([a], [b]) => a.localeCompare(b)));
+    }
+  };
+}
+function moduleInfo(code, file) {
+  const plugins = ["typescript", "decorators-legacy", .../\.[cm]?[jt]sx$/.test(file) ? ["jsx"] : []];
+  const program = parse(code, { sourceType: "module", plugins }).program;
+  const imports = /* @__PURE__ */ new Map();
+  const exports = /* @__PURE__ */ new Map();
+  const stars = [];
+  const refs = /* @__PURE__ */ new Map();
+  const declare = (name, node) => refs.set(name, node ? namesIn(node) : /* @__PURE__ */ new Set());
+  const declareStatement = (decl) => {
+    if (!decl) return [];
+    switch (decl.type) {
+      case "FunctionDeclaration":
+      case "ClassDeclaration":
+        if (!decl.id) return [];
+        declare(decl.id.name, decl);
+        return [decl.id.name];
+      case "VariableDeclaration":
+        return decl.declarations.flatMap((d) => {
+          if (d.id.type !== "Identifier") return [];
+          declare(d.id.name, d.init);
+          return [d.id.name];
+        });
+      default:
+        return [];
+    }
+  };
+  for (const stmt of program.body) {
+    switch (stmt.type) {
+      case "ImportDeclaration":
+        if (stmt.importKind === "type") break;
+        for (const spec of stmt.specifiers) {
+          if (spec.type === "ImportSpecifier" && spec.importKind === "type") continue;
+          const imported = spec.type === "ImportNamespaceSpecifier" ? "*" : spec.type === "ImportDefaultSpecifier" ? "default" : nameOf(spec.imported);
+          imports.set(spec.local.name, { spec: stmt.source.value, imported });
+        }
+        break;
+      case "ExportNamedDeclaration":
+        if (stmt.exportKind === "type") break;
+        for (const name of declareStatement(stmt.declaration)) exports.set(name, { kind: "local", local: name });
+        for (const spec of stmt.specifiers) {
+          if (spec.type === "ExportSpecifier" && spec.exportKind === "type") continue;
+          if (spec.type !== "ExportSpecifier") continue;
+          const exported = nameOf(spec.exported);
+          const local = nameOf(spec.local);
+          exports.set(exported, stmt.source ? { kind: "from", spec: stmt.source.value, imported: local } : { kind: "local", local });
+        }
+        break;
+      case "ExportAllDeclaration":
+        if (stmt.exportKind !== "type") stars.push(stmt.source.value);
+        break;
+      case "ExportDefaultDeclaration": {
+        const decl = stmt.declaration;
+        const named = (decl.type === "FunctionDeclaration" || decl.type === "ClassDeclaration") && decl.id ? decl.id.name : null;
+        if (named) declare(named, decl);
+        else if (decl.type === "Identifier") {
+          exports.set("default", { kind: "local", local: decl.name });
+          break;
+        } else declare(DEFAULT_LOCAL, decl);
+        exports.set("default", { kind: "local", local: named ?? DEFAULT_LOCAL });
+        break;
+      }
+      default:
+        declareStatement(stmt);
+    }
+  }
+  return { imports, exports, stars, refs };
+}
+function nameOf(node) {
+  return node.type === "Identifier" ? node.name : node.value;
+}
+function namesIn(node) {
+  const out = /* @__PURE__ */ new Set();
+  const walk = (value, key) => {
+    if (key !== void 0 && TYPE_KEYS.has(key)) return;
+    if (Array.isArray(value)) {
+      for (const item of value) walk(item);
+      return;
+    }
+    if (!value || typeof value !== "object" || typeof value.type !== "string") return;
+    const n = value;
+    if (n.type.startsWith("TS") && !("expression" in n)) return;
+    if (n.type === "Identifier" || n.type === "JSXIdentifier") {
+      out.add(n.name);
+      return;
+    }
+    for (const [k, child] of Object.entries(n)) {
+      if (k === "leadingComments" || k === "trailingComments" || k === "innerComments" || k === "loc") continue;
+      if ((n.type === "MemberExpression" || n.type === "OptionalMemberExpression") && k === "property" && !n.computed) continue;
+      if (n.type === "JSXMemberExpression" && k === "property") continue;
+      if ((n.type === "ObjectProperty" || n.type === "ObjectMethod" || n.type === "ClassMethod" || n.type === "ClassProperty") && k === "key" && !n.computed) continue;
+      if (n.type === "JSXAttribute" && k === "name") continue;
+      walk(child, k);
+    }
+  };
+  walk(node);
+  return out;
+}
 function indexFile(code, file, autoTitle2) {
   try {
     const plugins = ["typescript", "decorators-legacy", .../\.[jt]sx$/.test(file) ? ["jsx"] : []];
@@ -119,7 +389,7 @@ function indexProgram(program, file, autoTitle2) {
     for (const spec of stmt.specifiers) {
       if (spec.type !== "ExportSpecifier" || spec.exportKind === "type") continue;
       const name = exportedName(spec.exported);
-      const node = stmt.source ? void 0 : bindings.get(spec.local.name);
+      const node = stmt.source ? void 0 : bindings.get(exportedName(spec.local));
       if (name === "default") {
         metaNode = node;
         metaDoc ??= doc;
@@ -134,9 +404,11 @@ function indexProgram(program, file, autoTitle2) {
   const componentNode = prop(meta, "component");
   const componentName = componentNode?.type === "Identifier" ? componentNode.name : void 0;
   const metaIsolate = isolateOf(meta, bindings, wrappers, "default");
+  const metaTags = tagsOf(meta);
   return exported.filter(({ name }) => name !== "__namedExportsOrder").filter(({ name }) => (!include || include(name)) && (!exclude || !exclude(name))).map(({ name, node, doc }) => {
     const spec = objectOf(node, bindings, wrappers);
     const isolate = isolateOf(spec, bindings, wrappers, name) ?? metaIsolate;
+    const tags = combineTags(metaTags, tagsOf(spec));
     return {
       id: storyId(title, name),
       title,
@@ -146,7 +418,8 @@ function indexProgram(program, file, autoTitle2) {
       ...doc === void 0 ? {} : { description: doc },
       ...metaDoc === void 0 ? {} : { componentDescription: metaDoc },
       ...componentName === void 0 ? {} : { componentName },
-      ...isolate === void 0 ? {} : { isolate }
+      ...isolate === void 0 ? {} : { isolate },
+      ...tags === void 0 ? {} : { tags }
     };
   });
 }
@@ -159,6 +432,20 @@ function isolateOf(obj, bindings, wrappers, exportName) {
   if (literal === void 0) throw new Error(`${exportName}: isolate must be a string literal`);
   return literal;
 }
+function tagsOf(obj) {
+  const value = prop(obj, "tags");
+  if (value?.type !== "ArrayExpression") return void 0;
+  return value.elements.flatMap((e) => e ? stringLiteral(e) ?? [] : []);
+}
+function combineTags(meta, own) {
+  if (meta === void 0 && own === void 0) return void 0;
+  const out = new Set(meta);
+  for (const tag of own ?? []) {
+    if (tag.startsWith("!")) out.delete(tag.slice(1));
+    else out.add(tag);
+  }
+  return [...out];
+}
 function stringLiteral(node) {
   if (node.type === "StringLiteral") return node.value;
   if (node.type === "TemplateLiteral" && node.expressions.length === 0) return node.quasis.map((q) => q.value.cooked ?? q.value.raw).join("");
@@ -221,6 +508,18 @@ function storyFilter(obj, key) {
   }
   return null;
 }
+function ownEntries(realms) {
+  const here = fileURLToPath(import.meta.url);
+  for (let dir = dirname(here); dir !== dirname(dir); dir = dirname(dir)) {
+    const manifest = join(dir, "package.json");
+    if (!existsSync(manifest) || JSON.parse(readFileSync(manifest, "utf8")).name !== "@weasel-js/forge") {
+      continue;
+    }
+    const source = !relative(join(dir, "src"), here).startsWith("..");
+    return realms.map((realm) => join(dir, source ? `src/${realm}/index.ts` : `dist/${realm}/index.js`));
+  }
+  return [];
+}
 var SHIMS = [
   [/^@?storybook\/preview-api$/, "@weasel-js/forge/preview-api"],
   [/^@?storybook\/test$/, "@weasel-js/forge/play"]
@@ -239,25 +538,16 @@ function storybookShims() {
 
 // src/vite/plugin.ts
 var PREFIX = "virtual:forge/";
-var MODULES = /* @__PURE__ */ new Set(["index.js", "importers.js", "frame-config.js", "shell-config.js", "shell-entry.js", "frame-entry.js"]);
+var MODULES = /* @__PURE__ */ new Set(["index.js", "importers.js", "deps.js", "frame-config.js", "shell-config.js", "shell-entry.js", "frame-entry.js"]);
 var PAGES2 = { "/": "shell-entry.js", "/index.html": "shell-entry.js", "/frame.html": "frame-entry.js" };
-function ownEntries() {
-  const here = fileURLToPath(import.meta.url);
-  for (let dir = dirname(here); dir !== dirname(dir); dir = dirname(dir)) {
-    const manifest = join(dir, "package.json");
-    if (!existsSync(manifest) || JSON.parse(readFileSync(manifest, "utf8")).name !== "@weasel-js/forge") {
-      continue;
-    }
-    const source = !relative(join(dir, "src"), here).startsWith("..");
-    return ["shell", "frame"].map((realm) => join(dir, source ? `src/${realm}/index.ts` : `dist/${realm}/index.js`));
-  }
-  return [];
-}
 function forge(options) {
   let root = process.cwd();
   let base = "/";
   let byFile = null;
   let logger;
+  let deps = null;
+  let depsSent = null;
+  let depsPending = null;
   const glob = () => {
     const files2 = options.stories.flatMap(
       (pattern) => globSync(pattern, { cwd: root, exclude: (name) => basename(String(name)) === "node_modules" }).map((f) => resolve(root, f)).filter((f) => statSync(f).isFile()).sort()
@@ -284,6 +574,7 @@ function forge(options) {
     return byFile;
   };
   const index = () => [...files().values()].flat();
+  const depGraph = () => deps ??= createDepGraph({ root, read: (file) => readFileSync(file, "utf8") });
   const configModule = (path) => path ? `export { default } from ${JSON.stringify(resolve(root, path))};
 ` : "export default {};\n";
   const modules = {
@@ -315,6 +606,9 @@ const workshop = mountWorkshop({
   stories: ${JSON.stringify(options.stories)},
 });
 import.meta.hot?.on('forge:index', (next) => workshop.setIndex(next));
+// Read from source on first request, so the graph costs nothing until the page is up.
+import('virtual:forge/deps.js').then((m) => workshop.setDependencies(m.default));
+import.meta.hot?.on('forge:deps', (next) => workshop.setDependencies(next));
 // A story edit reaches here as an update of the importers module, whose fresh import() URLs carry the new
 // timestamps; the file it names arrives just before, so the reload waits for the importers that can fetch it.
 const stale = new Set();
@@ -338,12 +632,34 @@ mountFrame({ index, importers, setup });
 import.meta.hot?.accept('virtual:forge/importers.js', () => location.reload());
 `
   };
+  const invalidate = (server, names) => {
+    for (const env of Object.values(server.environments)) {
+      for (const name of names) {
+        const mod = env.moduleGraph.getModuleById(`\0${PREFIX}${name}`);
+        if (mod) env.moduleGraph.invalidateModule(mod);
+      }
+    }
+  };
+  function redeps(server) {
+    if (depsSent === null || depsPending) return;
+    const resolve4 = async (spec, importer) => (await server.environments.client.pluginContainer.resolveId(spec, importer))?.id ?? null;
+    depsPending = Promise.resolve().then(async () => {
+      const graph = await depGraph().build(index(), resolve4);
+      const json = JSON.stringify(graph);
+      if (json === depsSent) return;
+      depsSent = json;
+      invalidate(server, ["deps.js"]);
+      server.ws.send({ type: "custom", event: "forge:deps", data: graph });
+    }).catch(logError).finally(() => {
+      depsPending = null;
+    });
+  }
   function reindex(server, file, event) {
     const current = files();
     if (event === "change" && current.has(file)) server.ws.send({ type: "custom", event: "forge:story", data: { file } });
-    if (event === "change" && !current.has(file)) return;
-    if (event === "add" && !matches(file)) return;
-    if (event === "unlink" && !current.has(file)) return;
+    if (event === "change" && !current.has(file)) return false;
+    if (event === "add" && !matches(file)) return false;
+    if (event === "unlink" && !current.has(file)) return false;
     const before = JSON.stringify(index());
     if (event === "unlink") {
       current.delete(file);
@@ -352,18 +668,14 @@ import.meta.hot?.accept('virtual:forge/importers.js', () => location.reload());
         current.set(file, read(file));
       } catch (err) {
         logError(err);
-        return;
+        return false;
       }
     }
     const next = index();
-    if (JSON.stringify(next) === before) return;
-    for (const env of Object.values(server.environments)) {
-      for (const name of ["index.js", "importers.js"]) {
-        const mod = env.moduleGraph.getModuleById(`\0${PREFIX}${name}`);
-        if (mod) env.moduleGraph.invalidateModule(mod);
-      }
-    }
+    if (JSON.stringify(next) === before) return false;
+    invalidate(server, ["index.js", "importers.js"]);
     server.ws.send({ type: "custom", event: "forge:index", data: next });
+    return true;
   }
   return [
     ...options.storybookShims === false ? [] : [storybookShims()],
@@ -374,7 +686,7 @@ import.meta.hot?.accept('virtual:forge/importers.js', () => location.reload());
         const entries = [
           ...options.stories,
           ...[options.frameConfig, options.shellConfig].flatMap((path) => path ? [resolve(at, path)] : []),
-          ...ownEntries()
+          ...ownEntries(["shell", "frame"])
         ];
         const optimizeDeps = { entries };
         if (command !== "build") return { optimizeDeps };
@@ -391,18 +703,32 @@ import.meta.hot?.accept('virtual:forge/importers.js', () => location.reload());
         base = config.base;
         logger = config.logger;
         byFile = null;
+        deps = null;
+        depsSent = null;
       },
       resolveId(id) {
         return id.startsWith(PREFIX) && MODULES.has(id.slice(PREFIX.length)) ? `\0${id}` : void 0;
       },
-      load(id) {
+      async load(id) {
         if (!id.startsWith(`\0${PREFIX}`)) return void 0;
-        return modules[id.slice(PREFIX.length + 1)]?.();
+        const name = id.slice(PREFIX.length + 1);
+        if (name !== "deps.js") return modules[name]?.();
+        const graph = await depGraph().build(index(), async (spec, importer) => (await this.resolve(spec, importer))?.id ?? null);
+        depsSent = JSON.stringify(graph);
+        return `export default ${depsSent};
+`;
       },
       configureServer(server) {
         server.watcher.add([...files().keys()]);
         for (const event of ["add", "change", "unlink"]) {
-          server.watcher.on(event, (file) => reindex(server, resolve(file), event));
+          server.watcher.on(event, (path) => {
+            const file = resolve(path);
+            const indexed = reindex(server, file, event);
+            const added = event === "add" && /\.[cm]?[jt]sx?$/.test(file) && !file.split(sep).includes("node_modules");
+            if (added) depGraph().reset();
+            const read2 = added || event !== "add" && depGraph().invalidate(file);
+            if (indexed || read2) redeps(server);
+          });
         }
         server.middlewares.use((req, res, next) => {
           const url = req.url ?? "/";
@@ -438,6 +764,15 @@ function forgeTest(options) {
     {
       name: "weaselforge:test",
       enforce: "pre",
+      config(config) {
+        const at = resolve(config.root ?? process.cwd());
+        const entries = [
+          ...options.stories,
+          ...options.frameConfig ? [resolve(at, options.frameConfig)] : [],
+          ...ownEntries(["test"])
+        ];
+        return { optimizeDeps: { entries } };
+      },
       configResolved(config) {
         root = config.root;
       },