@wildwinter/app-shell 0.57.0 → 0.58.0

package/dist/{chunk-CPNTROWD.js → chunk-OZQ2BYXH.js}

@@ -124,6 +124,9 @@ function openToolWindow(existing, opts) {
     existing.focus();
     return existing;
   }
+  if (opts.url === void 0 && (opts.page === void 0 || opts.rendererDir === void 0)) {
+    throw new Error("openToolWindow needs a url, or a page and its rendererDir");
+  }
   const w = new BrowserWindow({
     ...opts.rect,
     ...opts.min !== void 0 ? { minWidth: opts.min.width, minHeight: opts.min.height } : {},
@@ -134,14 +137,20 @@ function openToolWindow(existing, opts) {
       contextIsolation: true,
       nodeIntegration: false,
       sandbox: true,
-      preload: opts.preload
+      // Electron's defaults, said out loud: no webview tag, and a dropped file never navigates the window.
+      webviewTag: false,
+      navigateOnDragDrop: false,
+      preload: opts.preload,
+      ...opts.partition !== void 0 ? { partition: opts.partition } : {},
+      ...opts.devTools !== void 0 ? { devTools: opts.devTools } : {}
     }
   });
   if (opts.pinTo !== void 0) pinToolWindow(w, opts.pinTo(), opts.pinned ?? false);
   if (opts.remember) rememberBounds(w, opts.remember);
   w.once("ready-to-show", () => w.show());
   if (opts.onClosed) w.on("closed", opts.onClosed);
-  if (process.env["ELECTRON_RENDERER_URL"]) void w.loadURL(`${process.env["ELECTRON_RENDERER_URL"]}/${opts.page}`);
+  if (opts.url !== void 0) void w.loadURL(opts.url);
+  else if (process.env["ELECTRON_RENDERER_URL"]) void w.loadURL(`${process.env["ELECTRON_RENDERER_URL"]}/${opts.page}`);
   else void w.loadFile(join(opts.rendererDir, opts.page));
   return w;
 }
@@ -209,5 +218,5 @@ function defineToolWindows(specs, env) {
 }
 
 export { centeredOnPrimary, defineToolWindows, frontForModal, openToolWindow, pinToolWindow, rememberBounds, rescueToolWindow, savedWindowRect };
-//# sourceMappingURL=chunk-CPNTROWD.js.map
-//# sourceMappingURL=chunk-CPNTROWD.js.map
+//# sourceMappingURL=chunk-OZQ2BYXH.js.map
+//# sourceMappingURL=chunk-OZQ2BYXH.js.map

package/dist/chunk-OZQ2BYXH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tool-window.ts"],"names":[],"mappings":"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","file":"chunk-OZQ2BYXH.js","sourcesContent":["// ---------------------------------------------------------------------------\n// The tool-window kit, MAIN-PROCESS half: the detached helper-window\n// machinery both apps had grown four copies of (Patterpad's Play + Search +\n// Coverage, Storyletter's Board + Find). Remembered bounds with a\n// disconnected-monitor guard, debounced persistence, the Reset View rescue,\n// and the pinnable window factory they compose into.\n//\n// This module imports electron, so it ships as its own subpath\n// (@wildwinter/app-shell/tool-window) - never import it from renderer code.\n// The renderer half (pin button, .swin drag-bar grammar) lives in the root\n// export + tool-window.css.\n//\n// Two deliberate corrections over the Patterpad originals, for when it\n// migrates here: rescueToolWindow re-pins EVERY window it rescues (Patterpad\n// re-pinned only Play, so its store lied about Search + Coverage), and the\n// factory always wires closed-cleanup through an identity guard.\n// ---------------------------------------------------------------------------\n\nimport { BrowserWindow, app, screen } from \"electron\";\nimport { join } from \"node:path\";\nimport type { Satellite } from \"./session.js\";\n\nexport interface ToolWindowSize {\n  width: number;\n  height: number;\n}\n\nexport interface ToolWindowBounds {\n  x?: number;\n  y?: number;\n  width: number;\n  height: number;\n}\n\n/** The per-window store slice every app remembers: where it was, whether it\n *  floats. (Patterpad's PlayWindowState, generalised.) */\nexport interface ToolWindowState {\n  bounds?: ToolWindowBounds;\n  pinned: boolean;\n}\n\n/** Use a remembered rect only if it still intersects a live display (a window\n *  saved on a now-disconnected monitor must not open offscreen). Falls back\n *  to the default size; a remembered size is kept even when the position is\n *  dropped (Electron then centres it). */\nexport function savedWindowRect(\n  saved: ToolWindowBounds | undefined,\n  def: ToolWindowSize,\n  min: ToolWindowSize,\n): ToolWindowBounds {\n  if (!saved) return { ...def };\n  const w = Math.max(min.width, saved.width), h = Math.max(min.height, saved.height);\n  if (saved.x != null && saved.y != null) {\n    const onScreen = screen.getAllDisplays().some((d) => {\n      const a = d.workArea;\n      return saved.x! + w > a.x + 40 && saved.x! < a.x + a.width - 40 && saved.y! + h > a.y + 20 && saved.y! < a.y + a.height - 20;\n    });\n    if (onScreen) return { x: saved.x, y: saved.y, width: w, height: h };\n  }\n  return { width: w, height: h };\n}\n\n/** Persist a helper window's bounds as the user moves / resizes / closes it\n *  (debounced 400ms; close flushes synchronously). */\nexport function rememberBounds(w: BrowserWindow, write: (bounds: ToolWindowBounds) => void): void {\n  const saveBounds = (): void => { if (!w.isDestroyed()) write(w.getBounds()); };\n  let boundsTimer: ReturnType<typeof setTimeout> | undefined;\n  const queueSave = (): void => { clearTimeout(boundsTimer); boundsTimer = setTimeout(saveBounds, 400); };\n  w.on(\"resize\", queueSave);\n  w.on(\"move\", queueSave);\n  w.on(\"close\", () => { clearTimeout(boundsTimer); saveBounds(); });\n}\n\n/** Centre a rect on the primary display's work area. */\nexport function centeredOnPrimary(size: ToolWindowSize): { x: number; y: number } {\n  const a = screen.getPrimaryDisplay().workArea;\n  return { x: Math.round(a.x + (a.width - size.width) / 2), y: Math.round(a.y + (a.height - size.height) / 2) };\n}\n\n/** Reset View's per-window half: un-minimise, re-pin (always - the store\n *  says pinned:true after a rescue, so the window must agree), default size,\n *  centred on the primary display, shown. The host clears its remembered\n *  bounds itself (that's a store concern). No focus steal: helpers show\n *  behind the editor. */\nexport function rescueToolWindow(w: BrowserWindow | undefined | null, def: ToolWindowSize): void {\n  if (!w || w.isDestroyed()) return;\n  if (w.isMinimized()) w.restore();\n  w.setBounds({ ...def, ...centeredOnPrimary(def) });\n  w.show();\n  // Raise within OUR stack. This used to setAlwaysOnTop(true), which on macOS\n  // and Windows floats the window above every other APPLICATION - and stuck\n  // that way, since nothing ever unset it.\n  w.moveTop();\n}\n\n/** macOS pinned windows, for the activation toggle below. */\nconst macPinned = new Set<BrowserWindow>();\nlet macActivationWired = false;\nfunction wireMacActivation(): void {\n  if (macActivationWired) return;\n  macActivationWired = true;\n  // Floating is a GLOBAL window level: left on while another app is front,\n  // the pinned window would sit over that app too - the exact 2026-08-25\n  // complaint. Scoping it to our app's active state keeps the pin meaning\n  // \"above my editor\" and nothing more.\n  // Not while a modal has the pins held (frontForModal): the editor is in\n  // front for it, and coming back to the app must not cover it again.\n  app.on(\"did-become-active\", () => { if (pinsHeld > 0) return; for (const w of macPinned) if (!w.isDestroyed()) w.setAlwaysOnTop(true, \"floating\"); });\n  app.on(\"did-resign-active\", () => { for (const w of macPinned) if (!w.isDestroyed()) w.setAlwaysOnTop(false); });\n}\n\n/**\n * The pin: keep a tool window above THIS APP'S MAIN WINDOW, not above the\n * world. Two findings shaped the mechanism, one per platform family:\n *\n * - Bare `alwaysOnTop` (the first implementation) floats the window over\n *   every other application on macOS and Windows, so a pinned Board meant\n *   nothing else on the machine could come to the front (a Storyletter user\n *   report, 2026-08-25).\n * - A CHILD window (the second implementation) is position-coupled to its\n *   parent on macOS: dragging the editor dragged the Board with it (a\n *   Storyletter user report, 2026-08-28). Windows and Linux owned windows do\n *   not move with their owner, so the child mechanism stays right for them.\n *\n * So: on macOS the pin is ACTIVATION-SCOPED alwaysOnTop - floating while\n * this app is active, dropped the moment it resigns - which is above the\n * editor without following its drags and without covering anyone else. On\n * Windows and Linux the pin is a child window, which stays over its parent\n * and stacks normally against everything else. Each branch clears the other\n * mechanism first, which also heals a window an older build pinned the old\n * way. `platform` is a seam for the tests; leave it defaulted.\n */\nexport function pinToolWindow(\n  w: BrowserWindow | undefined | null, parent: BrowserWindow | undefined | null, on: boolean,\n  platform: NodeJS.Platform = process.platform,\n): void {\n  if (!w || w.isDestroyed()) return;\n  if (platform === \"darwin\") {\n    w.setParentWindow(null);\n    if (on) {\n      if (!macPinned.has(w)) {\n        macPinned.add(w);\n        w.once(\"closed\", () => macPinned.delete(w));\n      }\n      wireMacActivation();\n      // Raise only when the app is active now and no modal has the pins\n      // held; otherwise the next did-become-active, or the release, raises it.\n      w.setAlwaysOnTop(pinsHeld === 0 && BrowserWindow.getFocusedWindow() !== null, \"floating\");\n    } else {\n      macPinned.delete(w);\n      w.setAlwaysOnTop(false);\n    }\n    return;\n  }\n  w.setAlwaysOnTop(false);\n  const owner = on && parent && !parent.isDestroyed() ? parent : null;\n  // While a modal has the pins held, remember the choice and apply it at the\n  // release, so the editor stays in front until the modal closes.\n  if (pinsHeld > 0) {\n    if (owner) heldChildren.set(w, owner); else heldChildren.delete(w);\n    w.setParentWindow(null);\n    return;\n  }\n  w.setParentWindow(owner);\n}\n\n// ---------------------------------------------------------------------------\n// Fronting the main window for a modal. A pinned tool window rides above the\n// editor by design, so a modal the EDITOR shows (the updater's prompts) opened\n// underneath one: the editor blurred behind its scrim and the prompt was\n// hidden, with nothing on screen to say why (both apps, 2026-10-02, the Play\n// window over the editor). While such a modal is up the pins step aside and\n// the editor comes forward; when it closes, every pin goes back as it was.\n// ---------------------------------------------------------------------------\n\n/** How many modals are holding the pins down. The pins return at zero. */\nlet pinsHeld = 0;\n/** Windows and Linux: the tool windows unparented by the hold, and the window\n *  each goes back to. */\nconst heldChildren = new Map<BrowserWindow, BrowserWindow>();\n\n/**\n * Bring `main` in front of every tool window, pinned ones included, for as\n * long as a modal it shows is open: un-minimise, show, focus, with the pins\n * set aside. Returns the release, which puts the pins back (idempotent; holds\n * nest, and the pins return when the last is released). Call it only while\n * the app is active: focusing a window of an inactive app is the focus steal\n * the platforms forbid. `platform` is a seam for the tests.\n */\nexport function frontForModal(main: BrowserWindow, platform: NodeJS.Platform = process.platform): () => void {\n  if (main.isDestroyed()) return () => {};\n  pinsHeld++;\n  if (platform === \"darwin\") {\n    for (const w of macPinned) if (!w.isDestroyed()) w.setAlwaysOnTop(false);\n  } else {\n    for (const w of BrowserWindow.getAllWindows()) {\n      if (w === main || w.isDestroyed()) continue;\n      const owner = w.getParentWindow();\n      if (owner !== main) continue;\n      heldChildren.set(w, main);\n      w.setParentWindow(null);\n    }\n  }\n  if (main.isMinimized()) main.restore();\n  main.show();\n  main.focus();\n\n  let released = false;\n  return () => {\n    if (released) return;\n    released = true;\n    if (--pinsHeld > 0) return;\n    if (platform === \"darwin\") {\n      // Only float again if the app is active; otherwise did-become-active does.\n      const active = BrowserWindow.getFocusedWindow() !== null;\n      if (active) for (const w of macPinned) if (!w.isDestroyed()) w.setAlwaysOnTop(true, \"floating\");\n    } else {\n      for (const [w, owner] of heldChildren) {\n        if (!w.isDestroyed() && !owner.isDestroyed()) w.setParentWindow(owner);\n      }\n      heldChildren.clear();\n    }\n  };\n}\n\nexport interface ToolWindowOptions {\n  title: string;\n  /** Renderer entry, relative to rendererDir (e.g. \"table.html\", \"search/index.html\"). Not used with `url`. */\n  page?: string;\n  /** Absolute path of the built renderer dir (join(import.meta.dirname, \"../renderer\")). Not used with `url`. */\n  rendererDir?: string;\n  /** Load this URL instead of a page from the renderer dir (a view window's `patter-view://...`). */\n  url?: string;\n  /** Absolute path of the preload bridge. */\n  preload: string;\n  /** A session partition of the window's own (a view's in-memory `view-<id>`); the default session otherwise. */\n  partition?: string;\n  /** Whether the window may open devtools; Electron's default (yes) when absent. */\n  devTools?: boolean;\n  rect: ToolWindowBounds;\n  min?: ToolWindowSize;\n  /** false = frameless: the renderer draws its own slim drag bar (.swin-head). */\n  frame?: boolean;\n  /** The window to PIN ABOVE: the app's main window, resolved at open time (a\n   *  getter, because the main window can be recreated). With `pinned` true\n   *  the new tool window rides above it - on macOS via activation-scoped\n   *  alwaysOnTop (a child window there follows the editor's drags), on\n   *  Windows and Linux as a child window (bare alwaysOnTop there floats over\n   *  the whole machine). See pinToolWindow for both findings. */\n  pinTo?: () => BrowserWindow | undefined;\n  /** Start pinned (the host remembers); flip later with `pinToolWindow`. */\n  pinned?: boolean;\n  /** Wire debounced bounds persistence into the host's store slice. */\n  remember?: (bounds: ToolWindowBounds) => void;\n  /** Fired when THIS window closes (identity-guarded; a stale close never\n   *  clears a newer window). Null the host's handle here. */\n  onClosed?: () => void;\n}\n\n/** The pinnable detached-window factory (hardened webPreferences, one\n *  preload, electron-vite's dev-URL/file split). Focuses and returns the\n *  existing window when there is one; otherwise creates, wires, and loads. */\nexport function openToolWindow(existing: BrowserWindow | undefined | null, opts: ToolWindowOptions): BrowserWindow {\n  if (existing && !existing.isDestroyed()) { existing.focus(); return existing; }\n  if (opts.url === undefined && (opts.page === undefined || opts.rendererDir === undefined)) {\n    throw new Error(\"openToolWindow needs a url, or a page and its rendererDir\");\n  }\n  const w = new BrowserWindow({\n    ...opts.rect,\n    ...(opts.min !== undefined ? { minWidth: opts.min.width, minHeight: opts.min.height } : {}),\n    show: false,\n    title: opts.title,\n    ...(opts.frame !== undefined ? { frame: opts.frame } : {}),\n    webPreferences: {\n      contextIsolation: true, nodeIntegration: false, sandbox: true,\n      // Electron's defaults, said out loud: no webview tag, and a dropped file never navigates the window.\n      webviewTag: false, navigateOnDragDrop: false,\n      preload: opts.preload,\n      ...(opts.partition !== undefined ? { partition: opts.partition } : {}),\n      ...(opts.devTools !== undefined ? { devTools: opts.devTools } : {}),\n    },\n  });\n  if (opts.pinTo !== undefined) pinToolWindow(w, opts.pinTo(), opts.pinned ?? false);\n  if (opts.remember) rememberBounds(w, opts.remember);\n  w.once(\"ready-to-show\", () => w.show());\n  if (opts.onClosed) w.on(\"closed\", opts.onClosed);\n  if (opts.url !== undefined) void w.loadURL(opts.url);\n  else if (process.env[\"ELECTRON_RENDERER_URL\"]) void w.loadURL(`${process.env[\"ELECTRON_RENDERER_URL\"]}/${opts.page}`);\n  else void w.loadFile(join(opts.rendererDir!, opts.page!));\n  return w;\n}\n\n// ---------------------------------------------------------------------------\n// The tool windows AS DATA: one row per window, and everything that walks the\n// windows walks the rows. Lifted from Storyletter's TOOL_WINDOWS table +\n// openToolWindowFor + rescueWindows (studio/src/main/index.ts), where it had\n// replaced four near-identical openX() functions whose differences were all\n// mistakes (only one forwarded its console; Reset View rescued two of four).\n// Patterpad's three hand copies (createPlayWindow / createSearchWindow /\n// createCoverageWindow and a four-branch rescueWindows) become three rows.\n//\n// Two things the table makes structurally impossible: forgetting to register\n// a window as a satellite for the project-changed nudge (every row is\n// registered when a session is given), and Reset View rescuing a subset (it\n// walks the rows).\n// ---------------------------------------------------------------------------\n\n\nexport interface ToolWindowSpec<N extends string = string> {\n  /** The window's key: the store slice it remembers under, the dev-console\n   *  prefix, and what `open(name)` takes. */\n  name: N;\n  title: string;\n  /** Renderer entry, relative to the env's rendererDir. */\n  page: string;\n  def: ToolWindowSize;\n  min: ToolWindowSize;\n  /** The remembered rect, read at open time (a store read-through). */\n  bounds: () => ToolWindowBounds | undefined;\n  /** Persist a moved / resized rect (debounced by the factory). */\n  remember: (bounds: ToolWindowBounds) => void;\n  /** Whether it starts pinned above the editor (both apps default true). */\n  pinned: () => boolean;\n  /** Frameless (the family's shape: the renderer draws `toolWindowHead`).\n   *  Default false = frameless; pass `frame: true` for an OS title bar. */\n  frame?: boolean;\n  /** The project-changed channel for THIS window when it differs from the\n   *  env's (Storyletter's Links window listens on \"links:focus\"). */\n  channel?: string;\n  /** Drop what main caches for the outgoing project on this window's behalf\n   *  (a coverage report, a search anchor). Runs whether the window is open\n   *  or not: see session.ts. */\n  clear?: () => void;\n}\n\nexport interface ToolWindowEnv {\n  /** Absolute path of the built renderer dir. */\n  rendererDir: string;\n  /** Absolute path of the preload bridge. */\n  preload: string;\n  /** The window to pin above: the app's main window, resolved at open time. */\n  pinTo: () => BrowserWindow | undefined;\n  /** Register every row as a satellite of the project session, so a new\n   *  project cannot open underneath a tool window that still shows the old\n   *  one. `channel` is the nudge each window listens on (a row may override). */\n  session?: { addSatellite: (satellite: Satellite) => () => void; channel: string };\n  /** Reset View's store half, run first: forget every remembered rect and\n   *  set pinned true (`resetWindows(store)` from app-store, or the app's own). */\n  resetStore?: () => void;\n  /** The channel a rescued window's renderer hears its re-pin on, so its pin\n   *  button agrees with the store (default \"state:pinned\"). */\n  pinChannel?: string;\n  /** Runs once per window created: forward its console in dev, say. */\n  onOpened?: (w: BrowserWindow, name: string) => void;\n}\n\nexport interface ToolWindows<N extends string> {\n  /** Open (or focus) one window by name. */\n  open(name: N): BrowserWindow;\n  /** The live window, if open. */\n  get(name: N): BrowserWindow | undefined;\n  /** Reset View's window half, over the table: store reset, then every open\n   *  window restored, default size, centred, re-pinned, and told so. */\n  rescue(): void;\n  /** Every window that is open right now. */\n  all(): BrowserWindow[];\n  readonly names: readonly N[];\n}\n\n/** Build the table. The windows are owned here: a host reads them through\n *  `get(name)` rather than holding module variables of its own. */\nexport function defineToolWindows<N extends string>(specs: ToolWindowSpec<N>[], env: ToolWindowEnv): ToolWindows<N> {\n  const live = new Map<N, BrowserWindow>();\n  const byName = (name: N): ToolWindowSpec<N> => {\n    const found = specs.find((s) => s.name === name);\n    if (!found) throw new Error(`no tool window \"${name}\"`);\n    return found;\n  };\n  const get = (name: N): BrowserWindow | undefined => {\n    const w = live.get(name);\n    return w && !w.isDestroyed() ? w : undefined;\n  };\n  if (env.session) {\n    for (const spec of specs) {\n      env.session.addSatellite({\n        window: () => get(spec.name),\n        channel: spec.channel ?? env.session.channel,\n        ...(spec.clear ? { clear: spec.clear } : {}),\n      });\n    }\n  }\n  const open = (name: N): BrowserWindow => {\n    const spec = byName(name);\n    const existing = get(name);\n    const opened = openToolWindow(existing, {\n      title: spec.title, page: spec.page, frame: spec.frame ?? false,\n      rendererDir: env.rendererDir, preload: env.preload,\n      rect: savedWindowRect(spec.bounds(), spec.def, spec.min),\n      min: spec.min,\n      pinTo: env.pinTo,\n      pinned: spec.pinned(),\n      remember: spec.remember,\n    });\n    if (opened !== existing) {\n      live.set(name, opened);\n      // Identity-guarded: a stale close never clears a newer window.\n      opened.on(\"closed\", () => { if (live.get(name) === opened) live.delete(name); });\n      env.onOpened?.(opened, name);\n    }\n    return opened;\n  };\n  const rescue = (): void => {\n    env.resetStore?.();\n    for (const spec of specs) rescueToolWindow(get(spec.name), spec.def);\n    // ACTUALLY pin them, then tell them. `rescueToolWindow` restores, resizes,\n    // centres and raises but never pins; the store now says pinned, so the\n    // window and its button have to agree before the claim is made.\n    for (const spec of specs) {\n      const w = get(spec.name);\n      if (!w) continue;\n      pinToolWindow(w, env.pinTo(), true);\n      w.webContents.send(env.pinChannel ?? \"state:pinned\", true);\n    }\n  };\n  return {\n    open, get, rescue,\n    all: () => specs.map((s) => get(s.name)).filter((w): w is BrowserWindow => w !== undefined),\n    names: specs.map((s) => s.name),\n  };\n}\n"]}

package/dist/index.cjs

@@ -1262,10 +1262,10 @@ function mountSettingsDialog(opts) {
     for (const s of opts.sections) {
       const found = handles.get(s.id)?.firstInvalid?.();
       if (!found) continue;
-      const bad = found instanceof HTMLElement ? found : found.el;
-      const message = (found instanceof HTMLElement ? void 0 : found.message) ?? bad.dataset["tip"];
+      const bad2 = found instanceof HTMLElement ? found : found.el;
+      const message = (found instanceof HTMLElement ? void 0 : found.message) ?? bad2.dataset["tip"];
       showTab(s.id);
-      bad.focus();
+      bad2.focus();
       error.textContent = message || "Fix the highlighted fields first.";
       error.hidden = false;
       return;
@@ -3838,6 +3838,325 @@ function historyNav(onBack, onForward) {
   };
 }
 
+// src/view-protocol.ts
+var VIEW_API = 1;
+var VIEW_PORT_CHANNEL = "wildwinter-view:port";
+var VIEW_PORT_MESSAGE = "wildwinter-view:port";
+
+// src/view-host-web.ts
+var PALETTE_TOKENS = [
+  "--bg",
+  "--surface",
+  "--card",
+  "--ink",
+  "--muted",
+  "--line",
+  "--line-soft",
+  "--accent",
+  "--accent-soft",
+  "--on-accent",
+  "--danger",
+  "--warn",
+  "--ok",
+  "--font-ui",
+  "--font-read",
+  "--font-mono",
+  ...Array.from({ length: 12 }, (_, i) => `--char-${i}`)
+];
+var GRAMMAR_TOKENS = [
+  "--color-scheme",
+  "--chrome-size",
+  "--scrim",
+  "--shadow-1",
+  "--shadow-2",
+  "--shadow-3",
+  "--ease-standard",
+  "--dur-quick",
+  "--dur-base",
+  "--dur-settle",
+  "--dur-slow",
+  "--dur-panel",
+  "--dur-exit",
+  "--radius-sm",
+  "--radius-md",
+  "--radius-lg",
+  "--radius-pill",
+  "--scroll-thumb",
+  "--scroll-thumb-hover"
+];
+var VIEW_THEME_TOKENS = [...PALETTE_TOKENS, ...GRAMMAR_TOKENS];
+function readTheme(root = document.documentElement, tokens = VIEW_THEME_TOKENS) {
+  const style = getComputedStyle(root);
+  const out = {};
+  for (const name of tokens) {
+    const value = style.getPropertyValue(name).trim();
+    if (value !== "") out[name] = value;
+  }
+  const declared = (style.getPropertyValue("color-scheme") || style.colorScheme || "").trim();
+  const words = declared.split(/\s+/);
+  let scheme = "light";
+  if (declared === "dark") scheme = "dark";
+  else if (words.includes("light") && words.includes("dark")) {
+    scheme = typeof matchMedia === "function" && matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+  }
+  return { scheme, tokens: out };
+}
+function onViewPort(fn, target = window, closed) {
+  const listener = (e) => {
+    if (e.source !== target) return;
+    const data = e.data;
+    if (!data || typeof data !== "object" || data.type !== VIEW_PORT_MESSAGE) return;
+    const port = e.ports?.[0];
+    const meta = data.meta;
+    if (!meta || typeof meta.window !== "number" || typeof meta.extension !== "string" || typeof meta.view !== "string") return;
+    if (meta.closed === true) {
+      closed?.(meta);
+      return;
+    }
+    if (!port) return;
+    fn(port, meta);
+  };
+  target.addEventListener("message", listener);
+  return () => target.removeEventListener("message", listener);
+}
+var NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+var isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isId = (v) => typeof v === "string" && v !== "";
+function isJson(v, depth = 0) {
+  if (depth > 64) return false;
+  if (v === null || typeof v === "string" || typeof v === "boolean") return true;
+  if (typeof v === "number") return Number.isFinite(v);
+  if (Array.isArray(v)) return v.every((x) => isJson(x, depth + 1));
+  if (isObj(v)) return Object.getPrototypeOf(v) === Object.prototype && Object.values(v).every((x) => isJson(x, depth + 1));
+  return false;
+}
+var bad = (message) => ({ code: "bad-request", message });
+function argsProblem(op, args) {
+  switch (op) {
+    case "project":
+    case "selection":
+      return null;
+    case "node":
+      if (!isId(args["id"])) return "A node request names the node by its id.";
+      if (args["children"] !== void 0 && typeof args["children"] !== "boolean") return "A node request's children is true or false.";
+      return null;
+    case "media":
+      if (!Array.isArray(args["ids"]) || !args["ids"].every(isId)) return "A media request lists the lines' ids.";
+      return null;
+    case "select":
+      return isId(args["id"]) ? null : "A select request names the node by its id.";
+    case "write": {
+      if (typeof args["label"] !== "string" || args["label"].trim() === "") return "A write has a label, for the undo step.";
+      const edits = args["edits"];
+      if (!Array.isArray(edits)) return "A write lists its edits.";
+      for (const e of edits) {
+        if (!isObj(e) || !isId(e["node"])) return "Each edit names its node by id.";
+        if (typeof e["field"] !== "string" || !NAME.test(e["field"])) return "Each edit names one of the extension's fields, never a path inside one.";
+        if ("value" in e && e["value"] !== void 0 && !isJson(e["value"])) return `The value for ${e["field"]} isn't plain JSON.`;
+      }
+      return null;
+    }
+  }
+}
+var OPS = ["project", "node", "selection", "media", "write", "select"];
+function hostView(port, adapter, opts) {
+  const { meta } = opts;
+  const ext = meta.extension;
+  const allowed = /* @__PURE__ */ new Set([ext, ...opts.reads]);
+  const theme = opts.theme ?? (() => readTheme());
+  const debounceMs = opts.debounceMs ?? 100;
+  let welcomed = false;
+  let closed = false;
+  let pending = null;
+  let timer3;
+  const post = (msg) => {
+    if (!closed) port.postMessage(msg);
+  };
+  const emit = (name, value) => {
+    if (welcomed) post({ t: "event", name, value });
+  };
+  const filterNode = (node2) => {
+    const keptExt = {};
+    for (const [id, data] of Object.entries(node2.ext ?? {})) if (allowed.has(id)) keptExt[id] = data;
+    const base = { id: node2.id, kind: node2.kind, parent: node2.parent, label: node2.label, host: node2.host ?? {}, ext: keptExt };
+    const out = typeof node2.held === "string" ? { ...base, held: node2.held } : base;
+    return node2.children ? { ...out, children: node2.children.map(filterNode) } : out;
+  };
+  const answer = async (op, args) => {
+    switch (op) {
+      case "project":
+        return { value: filterNode(await adapter.project()) };
+      case "node": {
+        const node2 = await adapter.node(args["id"], args["children"] === true);
+        return { value: node2 ? filterNode(node2) : null };
+      }
+      case "selection":
+        return { value: await adapter.selection() };
+      case "media":
+        if (!adapter.media) return { refusal: { code: "unsupported", message: "This app has no recordings or timings for lines." } };
+        return { value: await adapter.media(args["ids"]) };
+      case "select":
+        return { value: await adapter.select(args["id"]) };
+      case "write": {
+        const writable = adapter.writable(ext);
+        if (writable.readOnly) return { refusal: { code: "read-only", message: writable.why ?? "This project is read-only just now." } };
+        const edits = args["edits"].map((e) => "value" in e && e.value !== void 0 ? { node: e.node, field: e.field, value: e.value } : { node: e.node, field: e.field });
+        if (edits.length === 0) return { value: { written: 0 } };
+        if (edits.length > 1) {
+          const projectId = (await adapter.project()).id;
+          const onProject = edits.filter((e) => e.node === projectId).length;
+          if (onProject > 0 && onProject < edits.length) {
+            return { refusal: bad("A write changes the project or other nodes, not both: they undo separately. Make two writes.") };
+          }
+        }
+        const refused = await adapter.write(ext, args["label"], edits);
+        if (refused) return { refusal: refused };
+        return { value: { written: edits.length } };
+      }
+    }
+  };
+  const request = async (msg) => {
+    const id = msg["id"];
+    if (typeof id !== "number" || !Number.isInteger(id)) return;
+    const reply = (r) => post("refusal" in r ? { t: "reply", id, ok: false, refusal: r.refusal } : { t: "reply", id, ok: true, value: r.value });
+    const op = msg["op"];
+    if (typeof op !== "string" || !OPS.includes(op)) {
+      reply({ refusal: bad(`There's no request called ${JSON.stringify(op)}.`) });
+      return;
+    }
+    const args = msg["args"] ?? {};
+    if (!isObj(args)) {
+      reply({ refusal: bad("A request's args are an object.") });
+      return;
+    }
+    const problem = argsProblem(op, args);
+    if (problem) {
+      reply({ refusal: bad(problem) });
+      return;
+    }
+    try {
+      reply(await answer(op, args));
+    } catch (e) {
+      reply({ refusal: { code: "failed", message: `The app couldn't do that: ${e instanceof Error ? e.message : String(e)}` } });
+    }
+  };
+  const hello = (msg) => {
+    const api = msg["api"];
+    if (api !== VIEW_API) {
+      const who = `${opts.names?.extension ?? ext}'s ${opts.names?.view ?? meta.view}`;
+      const message = typeof api === "number" ? `${who} was built for view API ${api}; this app serves ${VIEW_API}.` : `${who} didn't say which view API it was built for; this app serves ${VIEW_API}.`;
+      post({ t: "refused", message });
+      close(false);
+      return;
+    }
+    const welcome = {
+      t: "welcome",
+      api: VIEW_API,
+      host: adapter.host,
+      extension: { id: ext, version: meta.version, ...meta.pinned !== void 0 ? { pinned: meta.pinned } : {} },
+      view: meta.view,
+      settings: adapter.settings(ext),
+      theme: theme(),
+      writable: adapter.writable(ext)
+    };
+    welcomed = true;
+    post(welcome);
+  };
+  const onMessage = (e) => {
+    const msg = e.data;
+    if (closed || !isObj(msg)) return;
+    if (!welcomed) {
+      if (msg["t"] === "hello") hello(msg);
+      return;
+    }
+    if (msg["t"] === "request") void request(msg);
+    else if (msg["t"] === "key" && typeof msg["combo"] === "string") adapter.key?.(msg["combo"]);
+  };
+  port.addEventListener("message", onMessage);
+  port.start();
+  const flush = () => {
+    timer3 = void 0;
+    const nodes = pending;
+    pending = null;
+    if (nodes === null) return;
+    emit("changed", { nodes: nodes === "all" ? "all" : [...nodes] });
+  };
+  function close(sayClosing = true) {
+    if (closed) return;
+    if (sayClosing) emit("closing", {});
+    clearTimeout(timer3);
+    closed = true;
+    port.removeEventListener("message", onMessage);
+    port.close();
+  }
+  return {
+    changed(nodes) {
+      if (closed || !welcomed) return;
+      if (nodes === "all" || pending === "all") pending = "all";
+      else {
+        pending ??= /* @__PURE__ */ new Set();
+        for (const n of nodes) pending.add(n);
+      }
+      if (timer3 === void 0) timer3 = setTimeout(flush, debounceMs);
+    },
+    selection() {
+      if (closed || !welcomed) return;
+      void Promise.resolve().then(() => adapter.selection()).then((s) => emit("selection", s), () => {
+      });
+    },
+    theme() {
+      if (!closed) emit("theme", theme());
+    },
+    writable() {
+      if (!closed) emit("writable", adapter.writable(ext));
+    },
+    close: () => close(true)
+  };
+}
+function hostViews(setup, opts = {}) {
+  const handles = /* @__PURE__ */ new Map();
+  const drop = (meta) => {
+    handles.get(meta.window)?.close();
+    handles.delete(meta.window);
+  };
+  const stop = onViewPort((port, meta) => {
+    drop(meta);
+    const s = setup(meta);
+    if (!s) {
+      port.close();
+      return;
+    }
+    handles.set(meta.window, hostView(port, s.adapter, {
+      meta,
+      reads: s.reads,
+      ...s.names !== void 0 ? { names: s.names } : {},
+      ...opts.theme !== void 0 ? { theme: opts.theme } : {},
+      ...opts.debounceMs !== void 0 ? { debounceMs: opts.debounceMs } : {}
+    }));
+  }, opts.target ?? window, drop);
+  const each = (f) => {
+    for (const h of handles.values()) f(h);
+  };
+  return {
+    get size() {
+      return handles.size;
+    },
+    changed: (nodes) => each((h) => h.changed(nodes)),
+    selection: () => each((h) => h.selection()),
+    theme: () => each((h) => h.theme()),
+    writable: () => each((h) => h.writable()),
+    close: () => {
+      each((h) => h.close());
+      handles.clear();
+    },
+    dispose: () => {
+      stop();
+      each((h) => h.close());
+      handles.clear();
+    }
+  };
+}
+
 exports.EDIT_MENU = EDIT_MENU;
 exports.FILE_MENU = FILE_MENU;
 exports.GO_MENU = GO_MENU;
@@ -3853,7 +4172,11 @@ exports.PROPERTY_TYPES = PROPERTY_TYPES;
 exports.PUBLISH_MENU = PUBLISH_MENU;
 exports.RESERVED_PROPERTY_NAMES = RESERVED_PROPERTY_NAMES;
 exports.REVIEW_MENU = REVIEW_MENU;
+exports.VIEW_API = VIEW_API;
 exports.VIEW_MENU = VIEW_MENU;
+exports.VIEW_PORT_CHANNEL = VIEW_PORT_CHANNEL;
+exports.VIEW_PORT_MESSAGE = VIEW_PORT_MESSAGE;
+exports.VIEW_THEME_TOKENS = VIEW_THEME_TOKENS;
 exports.askIdentity = askIdentity;
 exports.bindPropertyName = bindPropertyName;
 exports.bindPropertyRef = bindPropertyRef;
@@ -3891,6 +4214,8 @@ exports.gameIdify = gameIdify;
 exports.hideTip = hideTip;
 exports.hintBar = hintBar;
 exports.historyNav = historyNav;
+exports.hostView = hostView;
+exports.hostViews = hostViews;
 exports.icon = icon;
 exports.iconBtn = iconBtn;
 exports.iconHtml = iconHtml;
@@ -3925,6 +4250,7 @@ exports.mountPropertyList = mountPropertyList;
 exports.mountSettingsDialog = mountSettingsDialog;
 exports.mountWelcome = mountWelcome;
 exports.moveItem = moveItem;
+exports.onViewPort = onViewPort;
 exports.openAnchoredPanel = openAnchoredPanel;
 exports.openComments = openComments;
 exports.openContextMenu = openContextMenu;
@@ -3941,6 +4267,7 @@ exports.problemName = problemName;
 exports.propertyNameProblem = propertyNameProblem;
 exports.propertyNameify = propertyNameify;
 exports.propertyRefProblem = propertyRefProblem;
+exports.readTheme = readTheme;
 exports.relativeTime = relativeTime;
 exports.renderStepperBar = renderStepperBar;
 exports.revalidatePropertyRefs = revalidatePropertyRefs;