@weasel-js/forge 1.7.3 → 1.8.1

package/dist/test/index.d.ts

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

package/dist/test/index.js

@@ -1,9 +1,10 @@
-import { StoryTrial } from '../chunk-SEK6EKHO.js';
-import '../chunk-JNJGIUYU.js';
-import { loadStories } from '../chunk-NYBMOSSR.js';
-import '../chunk-Y3WZ2EWR.js';
+import { StoryTrial } from '../chunk-GHTVXHNJ.js';
+import '../chunk-NI5FYQHW.js';
+import { loadStories } from '../chunk-5N4YP5HS.js';
+import '../chunk-L5XM5VKB.js';
 import '../chunk-HRGPFQBW.js';
-import '../chunk-YKN3IAEX.js';
+import '../chunk-MGQWCPYE.js';
+import '../chunk-KJGXJD3U.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\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  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.js

@@ -1,6 +1,6 @@
 import { isGallery } from '../chunk-WEQSLPKT.js';
 import { storyNameFromExport, storyId } from '../chunk-HRGPFQBW.js';
-import { existsSync, readFileSync, mkdirSync, writeFileSync, globSync, statSync } from 'fs';
+import { readFileSync, existsSync, mkdirSync, writeFileSync, globSync, statSync } from 'fs';
 import { resolve, sep, relative, matchesGlob, dirname, join, basename } from 'path';
 import { parse } from '@babel/parser';
 import { fileURLToPath } from 'url';
@@ -344,17 +344,63 @@ function namesIn(node) {
   walk(node);
   return out;
 }
-function indexFile(code, file, autoTitle2) {
+function indexFile(code, file, autoTitle2, wrappers = /* @__PURE__ */ new Set()) {
   try {
-    const plugins = ["typescript", "decorators-legacy", .../\.[jt]sx$/.test(file) ? ["jsx"] : []];
-    return indexProgram(parse(code, { sourceType: "module", plugins }).program, file, autoTitle2);
+    return indexProgram(parseFile(code, file), file, autoTitle2, wrappers);
   } catch (err) {
     throw new Error(`${file}: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
   }
 }
-function indexProgram(program, file, autoTitle2) {
+function foreignCallees(code, file) {
+  const program = parseFile(code, file);
+  const { bindings } = scan(program, /* @__PURE__ */ new Set());
+  const imported = /* @__PURE__ */ new Map();
+  const exported = [];
+  for (const stmt of program.body) {
+    if (stmt.type === "ImportDeclaration" && stmt.importKind !== "type" && stmt.source.value !== "@weasel-js/forge") {
+      for (const spec of stmt.specifiers) {
+        if (spec.type === "ImportNamespaceSpecifier" || spec.type === "ImportSpecifier" && spec.importKind === "type") continue;
+        const name = spec.type === "ImportDefaultSpecifier" ? "default" : exportedName(spec.imported);
+        imported.set(spec.local.name, { local: spec.local.name, spec: stmt.source.value, imported: name });
+      }
+    }
+    if (stmt.type === "ExportDefaultDeclaration") exported.push(stmt.declaration);
+    if (stmt.type !== "ExportNamedDeclaration" || stmt.exportKind === "type") continue;
+    if (stmt.declaration?.type === "VariableDeclaration") exported.push(...stmt.declaration.declarations.map((d) => d.init));
+    if (stmt.source) continue;
+    for (const spec of stmt.specifiers) if (spec.type === "ExportSpecifier") exported.push(bindings.get(exportedName(spec.local)));
+  }
+  const found = /* @__PURE__ */ new Map();
+  for (const node of exported) {
+    const hit = imported.get(calleeOf(node ?? void 0, bindings) ?? "");
+    if (hit) found.set(hit.local, hit);
+  }
+  return [...found.values()];
+}
+function parseFile(code, file) {
+  const plugins = ["typescript", "decorators-legacy", .../\.[jt]sx$/.test(file) ? ["jsx"] : []];
+  return parse(code, { sourceType: "module", plugins }).program;
+}
+function calleeOf(node, bindings, depth = 0) {
+  if (!node || depth > 16) return void 0;
+  switch (node.type) {
+    case "TSSatisfiesExpression":
+    case "TSAsExpression":
+    case "TSTypeAssertion":
+    case "TSNonNullExpression":
+    case "ParenthesizedExpression":
+      return calleeOf(node.expression, bindings, depth + 1);
+    case "CallExpression":
+      return node.callee.type === "Identifier" ? node.callee.name : void 0;
+    case "Identifier":
+      return calleeOf(bindings.get(node.name), bindings, depth + 1);
+    default:
+      return void 0;
+  }
+}
+function scan(program, extra) {
   const bindings = /* @__PURE__ */ new Map();
-  const wrappers = /* @__PURE__ */ new Set();
+  const wrappers = new Set(extra);
   for (const stmt of program.body) {
     if (stmt.type === "ImportDeclaration" && stmt.source.value === "@weasel-js/forge") {
       for (const spec of stmt.specifiers) {
@@ -368,6 +414,10 @@ function indexProgram(program, file, autoTitle2) {
       for (const d of decl.declarations) if (d.id.type === "Identifier" && d.init) bindings.set(d.id.name, d.init);
     }
   }
+  return { bindings, wrappers };
+}
+function indexProgram(program, file, autoTitle2, extra) {
+  const { bindings, wrappers } = scan(program, extra);
   let metaNode;
   let metaDoc;
   const exported = [];
@@ -536,6 +586,67 @@ function storybookShims() {
   };
 }
 
+// src/vite/wrappers.ts
+function createWrapperResolver(read) {
+  const modules = /* @__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 async (file, callees, resolve4) => {
+    const reads = /* @__PURE__ */ new Set();
+    const wrappers = /* @__PURE__ */ new Set();
+    if (callees.length === 0) return { wrappers, reads };
+    const target = async (spec, importer) => {
+      const id = (await resolve4(spec, importer).catch(() => null))?.split("?")[0];
+      return id && !id.startsWith("\0") ? id : null;
+    };
+    const declaring = async (at, name, depth = 0) => {
+      reads.add(at);
+      const mod = info(at);
+      if (!mod || depth > 32) return null;
+      const exp = mod.exports.get(name);
+      if (exp?.kind === "local") {
+        const imp = mod.imports.get(exp.local);
+        if (!imp) return `${at}#${exp.local}`;
+        if (imp.imported === "*") return null;
+        const next = await target(imp.spec, at);
+        return next ? declaring(next, imp.imported, depth + 1) : null;
+      }
+      if (exp?.kind === "from") {
+        const next = await target(exp.spec, at);
+        return next ? declaring(next, exp.imported, depth + 1) : null;
+      }
+      if (name === "default") return null;
+      for (const spec of mod.stars) {
+        const next = await target(spec, at);
+        const found = next ? await declaring(next, name, depth + 1) : null;
+        if (found) return found;
+      }
+      return null;
+    };
+    const forge2 = await target("@weasel-js/forge", file);
+    if (!forge2) return { wrappers, reads };
+    const own = new Set(
+      (await Promise.all(["meta", "story"].map((name) => declaring(forge2, name)))).filter((key) => key !== null)
+    );
+    for (const callee of callees) {
+      const from = await target(callee.spec, file);
+      const key = from ? await declaring(from, callee.imported) : null;
+      if (key && own.has(key)) wrappers.add(callee.local);
+    }
+    return { wrappers, reads };
+  };
+}
+
 // src/vite/plugin.ts
 var PREFIX = "virtual:forge/";
 var MODULES = /* @__PURE__ */ new Set(["index.js", "importers.js", "deps.js", "frame-config.js", "shell-config.js", "shell-entry.js", "frame-entry.js"]);
@@ -548,6 +659,8 @@ function forge(options) {
   let deps = null;
   let depsSent = null;
   let depsPending = null;
+  const wrappersOf = /* @__PURE__ */ new Map();
+  let settledAll = 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()
@@ -558,7 +671,7 @@ function forge(options) {
     const path = relative(root, file).split(sep).join("/");
     return !path.split("/").includes("node_modules") && options.stories.some((pattern) => matchesGlob(path, pattern));
   };
-  const read = (file) => indexFile(readFileSync(file, "utf8"), file, autoTitle(file, root, options.stories));
+  const read = (file) => indexFile(readFileSync(file, "utf8"), file, autoTitle(file, root, options.stories), wrappersOf.get(file)?.wrappers);
   const logError = (err) => logger?.error(`[forge] ${err instanceof Error ? err.message : String(err)}`);
   const files = () => {
     byFile ??= new Map(
@@ -574,6 +687,27 @@ function forge(options) {
     return byFile;
   };
   const index = () => [...files().values()].flat();
+  const settle = async (targets, resolveImport) => {
+    const decide = createWrapperResolver((file) => readFileSync(file, "utf8"));
+    const current = files();
+    for (const file of targets) {
+      if (!current.has(file)) continue;
+      let next;
+      try {
+        next = await decide(file, foreignCallees(readFileSync(file, "utf8"), file), resolveImport);
+      } catch {
+        continue;
+      }
+      const before = wrappersOf.get(file)?.wrappers ?? /* @__PURE__ */ new Set();
+      wrappersOf.set(file, next);
+      if (before.size === next.wrappers.size && [...before].every((name) => next.wrappers.has(name))) continue;
+      try {
+        current.set(file, read(file));
+      } catch (err) {
+        logError(err);
+      }
+    }
+  };
   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";
@@ -654,23 +788,26 @@ import.meta.hot?.accept('virtual:forge/importers.js', () => location.reload());
       depsPending = null;
     });
   }
-  function reindex(server, file, event) {
+  async 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 false;
-    if (event === "add" && !matches(file)) return false;
-    if (event === "unlink" && !current.has(file)) return false;
+    const own = event === "add" ? matches(file) : current.has(file);
+    const through = [...wrappersOf].filter(([story, { reads }]) => story !== file && reads.has(file)).map(([story]) => story);
+    if (!own && through.length === 0) return false;
     const before = JSON.stringify(index());
-    if (event === "unlink") {
+    if (own && event === "unlink") {
       current.delete(file);
-    } else {
+      wrappersOf.delete(file);
+    } else if (own) {
       try {
         current.set(file, read(file));
       } catch (err) {
         logError(err);
-        return false;
+        if (through.length === 0) return false;
       }
     }
+    const resolveImport = async (spec, importer) => (await server.environments.client.pluginContainer.resolveId(spec, importer))?.id ?? null;
+    await settle([...own && event !== "unlink" ? [file] : [], ...through], resolveImport);
     const next = index();
     if (JSON.stringify(next) === before) return false;
     invalidate(server, ["index.js", "importers.js"]);
@@ -703,6 +840,8 @@ import.meta.hot?.accept('virtual:forge/importers.js', () => location.reload());
         base = config.base;
         logger = config.logger;
         byFile = null;
+        wrappersOf.clear();
+        settledAll = null;
         deps = null;
         depsSent = null;
       },
@@ -712,6 +851,10 @@ import.meta.hot?.accept('virtual:forge/importers.js', () => location.reload());
       async load(id) {
         if (!id.startsWith(`\0${PREFIX}`)) return void 0;
         const name = id.slice(PREFIX.length + 1);
+        if (name === "index.js") {
+          settledAll ??= settle([...files().keys()], async (spec, importer) => (await this.resolve(spec, importer))?.id ?? null);
+          await settledAll;
+        }
         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);
@@ -723,11 +866,12 @@ import.meta.hot?.accept('virtual:forge/importers.js', () => location.reload());
         for (const event of ["add", "change", "unlink"]) {
           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);
+            reindex(server, file, event).then((indexed) => {
+              if (indexed || read2) redeps(server);
+            }, logError);
           });
         }
         server.middlewares.use((req, res, next) => {