@weasel-js/forge 1.13.0 → 1.14.0

package/dist/test/index.d.ts

@@ -1,4 +1,4 @@
-import { F as FrameSetup } from '../FrameController-DgfVaENb.js';
+import { F as FrameSetup } from '../FrameController-BM6xuEfY.js';
 import '@weasel-js/icons';
 import '@weasel-js/labkit/config';
 import 'react';

package/dist/test/index.js

@@ -1,10 +1,10 @@
-import { StoryTrial } from '../chunk-XIBKYSRU.js';
-import '../chunk-3BAM6M26.js';
-import { loadStories } from '../chunk-GHPMNT2A.js';
-import '../chunk-L5XM5VKB.js';
+import { StoryTrial } from '../chunk-UDEUT7AG.js';
+import '../chunk-FPF2JSWB.js';
+import { loadStories } from '../chunk-PGLOYXDP.js';
+import '../chunk-TT4ZOYB6.js';
 import '../chunk-5WS67HMU.js';
-import '../chunk-7XJNVJB5.js';
-import '../chunk-2ZBZRBHI.js';
+import '../chunk-B26DWEYT.js';
+import '../chunk-STK2AZH2.js';
 import { withValueAtPath } from '@weasel-js/labkit/config';
 import { useState, useEffect } from 'react';
 import { createRoot } from 'react-dom/client';
@@ -42,10 +42,8 @@ async function runStory(mod, exportName, file, title, { setup = {} } = {}) {
   }
   if (!story) throw new Error(`load fault: ${file} has no story export "${exportName}"`);
   const container = document.createElement("div");
-  if (story.viewport) {
-    container.style.width = `${story.viewport.width}px`;
-    container.style.height = `${story.viewport.height}px`;
-  }
+  if (story.viewport) container.style.width = `${story.viewport.width}px`;
+  container.style.height = story.viewport ? `${story.viewport.height}px` : "100vh";
   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 { 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"]}
+{"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) container.style.width = `${story.viewport.width}px`;\n  // Without one the stage still fills the workshop's preview: an auto height lays a filling story out 0 tall.\n  container.style.height = story.viewport ? `${story.viewport.height}px` : '100vh';\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.js

@@ -1,9 +1,9 @@
-import { CAPTURE_PAGES, DEFAULT_TITLE, CAPTURE_PATH, parsePayload, messageOf } from '../chunk-ORMMZ5PV.js';
+import { CAPTURE_PAGES, DEFAULT_TITLE, ISSUES_PATH, CAPTURE_PATH, issueLabel, parsePayload, messageOf } from '../chunk-MRYXJTDO.js';
 import { byComponent } from '../chunk-RVJHUY7W.js';
 import { isGallery } from '../chunk-VUPN73JP.js';
 import { PROP_ARG_TYPES_EXPORT, storyNameFromExport, storyId } from '../chunk-5WS67HMU.js';
 import { readFileSync, mkdtempSync, existsSync, mkdirSync, writeFileSync, globSync, statSync, watch, rmSync } from 'fs';
-import { resolve, sep, relative, join, dirname, basename, matchesGlob, posix } from 'path';
+import { resolve, relative, sep, join, dirname, basename, matchesGlob, posix } from 'path';
 import { parse } from '@babel/parser';
 import { execFile } from 'child_process';
 import { fileURLToPath } from 'url';
@@ -1048,7 +1048,7 @@ function controlFor(reading, type, written) {
   const { TypeFlags } = reading.tsm;
   const parts = type.isUnion() ? type.types : [type];
   if (parts.every((part) => part.flags & TypeFlags.BooleanLike)) return { control: { type: "boolean" } };
-  if (parts.some((part) => part.flags & TypeFlags.String)) return { control: { type: "text" } };
+  if (textLike(reading, parts)) return { control: { type: "text" } };
   if (type.flags & TypeFlags.Number) return { control: { type: "number" } };
   const options = literalsOf(reading, parts);
   if (options.length > 1) {
@@ -1060,6 +1060,9 @@ function controlFor(reading, type, written) {
   return shape && shape.name !== "enum" && !(shape.name in SCALARS) ? { control: "object", type: shape } : null;
 }
 var SCALARS = { boolean: true, string: true, number: true };
+function textLike({ tsm }, parts) {
+  return parts.some((part) => part.flags & tsm.TypeFlags.String) && !parts.some((part) => part.flags & tsm.TypeFlags.Object);
+}
 function literalsOf({ tsm }, parts) {
   return parts.filter((part) => part.flags & tsm.TypeFlags.StringLiteral).map((part) => part.value);
 }
@@ -1072,7 +1075,7 @@ function shapeOf(reading, type, depth) {
   const parts = whole.isUnion() ? whole.types : [whole];
   if (parts.length === 0) return null;
   if (parts.every((part) => part.flags & TypeFlags.BooleanLike)) return { name: "boolean" };
-  if (parts.some((part) => part.flags & TypeFlags.String)) return { name: "string" };
+  if (textLike(reading, parts)) return { name: "string" };
   if (whole.flags & TypeFlags.Number) return { name: "number" };
   const literals = literalsOf(reading, parts);
   if (literals.length === parts.length || literals.length > 1) return { name: "enum", value: literals };
@@ -1166,6 +1169,86 @@ export const ${PROP_ARG_TYPES_EXPORT} = ${JSON.stringify(table.argTypes)};
     }
   };
 }
+var runGh = (args, cwd) => new Promise((done) => {
+  execFile(
+    "gh",
+    [...args],
+    { cwd, maxBuffer: 16 << 20, env: { ...process.env, GH_PROMPT_DISABLED: "1" } },
+    (error, stdout, stderr) => {
+      if (!error) return done({ stdout });
+      if (error.code === "ENOENT") return done({ missing: true });
+      done({ failed: stderr.trim() || error.message, code: typeof error.code === "number" ? error.code : null });
+    }
+  );
+});
+var SCP = /^(?:[^@\s/]+@)?([\w.-]+):(?!\/)([\w.-]+)\/([\w.-]+?)(?:\.git)?\/?$/;
+var URL_FORM = /^(?:ssh|git|https?):\/\/(?:[^@/\s]+@)?([\w.-]+)(?::\d+)?\/([\w.-]+)\/([\w.-]+?)(?:\.git)?\/?$/;
+function repoOf(remote) {
+  const match = SCP.exec(remote.trim()) ?? URL_FORM.exec(remote.trim());
+  if (!match) return null;
+  const [, rawHost = "", owner = "", name = ""] = match;
+  const host = rawHost === "github.com" || rawHost.endsWith(".github.com") ? "github.com" : rawHost;
+  const slug = `${owner}/${name}`;
+  return { slug, url: `https://${host}/${slug}`, ghRepo: host === "github.com" ? slug : `${host}/${slug}` };
+}
+var attempt = async (run) => {
+  try {
+    return (await run()).trim() || null;
+  } catch {
+    return null;
+  }
+};
+var GH_AUTH_EXIT = 4;
+var json = (res, status, body2) => {
+  res.statusCode = status;
+  res.setHeader("Content-Type", "application/json");
+  res.end(JSON.stringify(body2));
+};
+function serveIssues(server, base, root, { gh = runGh, git = runGit } = {}) {
+  const answer = async (component) => {
+    const cwd = root();
+    const [remote, head, commit] = await Promise.all([
+      attempt(() => git(["remote", "get-url", "origin"], cwd)),
+      attempt(() => git(["rev-parse", "--abbrev-ref", "HEAD"], cwd)),
+      attempt(() => git(["rev-parse", "HEAD"], cwd))
+    ]);
+    const found = remote === null ? null : repoOf(remote);
+    const context = {
+      repo: found && { slug: found.slug, url: found.url },
+      branch: head === "HEAD" ? null : head,
+      commit
+    };
+    if (!found) return { status: 200, body: { ...context, unavailable: "This checkout\u2019s origin is not a GitHub repository." } };
+    const fields = "number,title,url,createdAt";
+    const result = await gh(
+      ["issue", "list", "-R", found.ghRepo, "--label", issueLabel(component), "--state", "open", "--json", fields],
+      cwd
+    );
+    if ("missing" in result) return { status: 200, body: { ...context, unavailable: "The GitHub CLI (gh) is not installed." } };
+    if ("failed" in result) {
+      if (result.code === GH_AUTH_EXIT || /gh auth login/.test(result.failed)) {
+        return { status: 200, body: { ...context, unavailable: "The GitHub CLI (gh) is not logged in. Run gh auth login." } };
+      }
+      return { status: 502, body: { ...context, error: result.failed } };
+    }
+    let listed;
+    try {
+      listed = JSON.parse(result.stdout);
+    } catch {
+      return { status: 502, body: { ...context, error: "gh answered something that is not JSON" } };
+    }
+    const issues = listed.map(({ number, title, url, createdAt }) => ({ number, title, url, opened: createdAt }));
+    return { status: 200, body: { ...context, issues } };
+  };
+  server.middlewares.use((req, res, next) => {
+    const url = new URL(req.url ?? "/", "http://forge.invalid");
+    if (url.pathname !== `${base}${ISSUES_PATH}`) return next();
+    if (req.method !== "GET") return next();
+    const component = url.searchParams.get("component")?.trim();
+    if (!component) return json(res, 400, { error: "name a component: ?component=<name>" });
+    answer(component).then(({ status, body: body2 }) => json(res, status, body2), next);
+  });
+}
 var IDLE_CLOSE_MS = 12e4;
 var SHOT_DEADLINE_MS = 2e4;
 var QUEUE_CAP = 8;
@@ -1388,7 +1471,7 @@ function ownOrigin(origin, req, protocol, server) {
   const printed = [...server.resolvedUrls?.local ?? [], ...server.resolvedUrls?.network ?? []];
   return printed.some((u) => new URL(u).origin === url.origin);
 }
-var json = (res, status, body2) => {
+var json2 = (res, status, body2) => {
   res.statusCode = status;
   res.setHeader("Content-Type", "application/json");
   res.end(JSON.stringify(body2));
@@ -1426,37 +1509,37 @@ function serveCapture(server, base, allowOrigins = () => []) {
   const capture = async (req, res) => {
     const origin = req.headers.origin;
     if (origin !== void 0 && !ownOrigin(origin, req, protocol, server)) {
-      return json(res, 403, { error: "a capture is only taken for this server\u2019s own pages" });
+      return json2(res, 403, { error: "a capture is only taken for this server\u2019s own pages" });
     }
     const type = (req.headers["content-type"] ?? "").split(";")[0]?.trim().toLowerCase();
-    if (type !== "application/json") return json(res, 415, { error: "a capture payload is sent as application/json" });
+    if (type !== "application/json") return json2(res, 415, { error: "a capture payload is sent as application/json" });
     const body2 = await readBody(req);
     if (body2 === null) {
       res.setHeader("Connection", "close");
-      json(res, 413, { error: "capture payload is too large" });
+      json2(res, 413, { error: "capture payload is too large" });
       return void res.once("finish", () => req.destroy());
     }
     let parsed;
     try {
       parsed = JSON.parse(body2);
     } catch {
-      return json(res, 400, { error: "capture payload is not JSON" });
+      return json2(res, 400, { error: "capture payload is not JSON" });
     }
     const payload = parsePayload(parsed);
-    if ("error" in payload) return json(res, 400, payload);
+    if ("error" in payload) return json2(res, 400, payload);
     const key = keyOf2(payload);
     let png = cache.get(key);
     if (!png) {
       const result = await browser();
-      if ("unavailable" in result) return json(res, 503, { available: false, reason: result.unavailable });
+      if ("unavailable" in result) return json2(res, 503, { available: false, reason: result.unavailable });
       const page = `${socketOrigin(req, protocol)}${base}${payload.isolate ? CAPTURE_PAGES.frame : CAPTURE_PAGES.shell}`;
       const at = revision;
       try {
         png = await result.capture(page, payload, allowOrigins());
       } catch (err) {
         const message = messageOf(err);
-        if (message === QUEUE_FULL) return json(res, 503, { available: false, reason: QUEUE_FULL });
-        return json(res, 500, { error: message });
+        if (message === QUEUE_FULL) return json2(res, 503, { available: false, reason: QUEUE_FULL });
+        return json2(res, 500, { error: message });
       }
       if (at === revision) cache.set(key, png);
     }
@@ -1466,7 +1549,7 @@ function serveCapture(server, base, allowOrigins = () => []) {
   };
   const status = async (res) => {
     const result = await captureAvailability();
-    json(res, 200, "unavailable" in result ? { available: false, reason: result.unavailable } : { available: true });
+    json2(res, 200, "unavailable" in result ? { available: false, reason: result.unavailable } : { available: true });
   };
   server.middlewares.use((req, res, next) => {
     if (req.url?.split("?")[0] !== `${base}${CAPTURE_PATH}`) return next();
@@ -1641,6 +1724,7 @@ const workshop = mountWorkshop({
   config,
   frameUrl: ${JSON.stringify(`${base}frame.html`)},
   captureBase: ${JSON.stringify(base)},
+  issuesBase: ${JSON.stringify(base)},
   stories: ${JSON.stringify(stories)},
 });
 // Read from source on first request, so the graph costs nothing until the page is up.
@@ -1757,6 +1841,21 @@ function watchProbe({ probe } = {}) {
 
 // src/vite/plugin.ts
 var SCRIPT2 = /\.[cm]?[jt]sx?$/;
+function watchSources(server, { files, depGraph, reindex, redeps, logError }) {
+  server.watcher.add([...files]);
+  void warnWhenWatchIsSilent(server);
+  for (const event of ["add", "change", "unlink"]) {
+    server.watcher.on(event, (path) => {
+      const file = resolve(path);
+      const added = event === "add" && SCRIPT2.test(file) && !file.split(sep).includes("node_modules");
+      if (added) depGraph().reset();
+      const read = added || event !== "add" && depGraph().invalidate(file);
+      reindex(server, file, event).then((indexed) => {
+        if (indexed || read) redeps(server);
+      }, logError);
+    });
+  }
+}
 function forge(options) {
   let root = process.cwd();
   let base = "/";
@@ -1842,9 +1941,9 @@ function forge(options) {
     const resolve6 = async (spec, importer) => (await server.environments.client.pluginContainer.resolveId(spec, importer))?.id ?? null;
     depsPending = Promise.resolve().then(async () => {
       const graph = await graphOf(resolve6);
-      const json2 = JSON.stringify(graph);
-      if (json2 === depsSent) return;
-      depsSent = json2;
+      const json3 = JSON.stringify(graph);
+      if (json3 === depsSent) return;
+      depsSent = json3;
       invalidate(server, ["deps.js"]);
       server.ws.send({ type: "custom", event: "forge:deps", data: graph });
     }).catch(logError).finally(() => {
@@ -1949,20 +2048,9 @@ function forge(options) {
         for (const file of storiesReaching(modules2)) server.ws.send({ type: "custom", event: "forge:story", data: { file } });
       },
       configureServer(server) {
-        server.watcher.add([...files().keys()]);
-        void warnWhenWatchIsSilent(server);
-        for (const event of ["add", "change", "unlink"]) {
-          server.watcher.on(event, (path) => {
-            const file = resolve(path);
-            const added = event === "add" && SCRIPT2.test(file) && !file.split(sep).includes("node_modules");
-            if (added) depGraph().reset();
-            const read2 = added || event !== "add" && depGraph().invalidate(file);
-            reindex(server, file, event).then((indexed) => {
-              if (indexed || read2) redeps(server);
-            }, logError);
-          });
-        }
+        watchSources(server, { files: [...files().keys()], depGraph, reindex, redeps, logError });
         capture = servePages(server, base, () => shellUnder(root));
+        serveIssues(server, base, () => root);
       },
       closeServer: () => capture?.close()
     }