@wildwinter/app-shell 0.37.0 → 0.39.0

package/dist/tokens.css

@@ -2,6 +2,8 @@
 :root {
   color-scheme: light dark;
   --ok: light-dark(#3f7d49, #79bd80);
+  --on-accent: light-dark(#ffffff, #1b1916);
+  --scrim: color-mix(in oklab, var(--ink) 28%, transparent);
   --shadow-1: 0 1px 3px rgba(0, 0, 0, 0.05);
   --shadow-2: 0 6px 20px rgba(0, 0, 0, 0.14);
   --shadow-3: 0 16px 48px rgba(0, 0, 0, 0.28);
@@ -17,6 +19,7 @@
   --anim-screen-in: screen-in var(--dur-panel) var(--ease-standard);
   --anim-panel-out: panel-out var(--dur-exit) var(--ease-standard) forwards;
   --anim-backdrop-out: backdrop-out var(--dur-exit) var(--ease-standard) forwards;
+  --anim-job-band: job-band 1.4s var(--ease-standard) infinite;
   --radius-sm: 6px;
   --radius-md: 10px;
   --radius-lg: 14px;
@@ -24,6 +27,21 @@
   --scroll-thumb: color-mix(in oklab, var(--ink) 20%, transparent);
   --scroll-thumb-hover: color-mix(in oklab, var(--ink) 40%, transparent);
 }
+[data-icon] {
+  display: block;
+  flex: none;
+  pointer-events: none;
+}
+:where(button, [role=button], input, select, textarea, summary, a[href], [tabindex]):focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 1px;
+}
+.overline {
+  font: 600 0.66rem/1 var(--font-ui);
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  color: var(--muted);
+}
 * {
   scrollbar-width: thin;
   scrollbar-color: var(--scroll-thumb) transparent;
@@ -101,6 +119,7 @@
     --anim-screen-in: none;
     --anim-panel-out: none;
     --anim-backdrop-out: none;
+    --anim-job-band: none;
   }
 }
 /*# sourceMappingURL=tokens.css.map */

package/dist/tokens.css.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/tokens.css"],"sourcesContent":["/* ============================================================================\n   Design-token GRAMMAR - the app-agnostic layer (design-language.md section 4).\n\n   The shared half of \"two palettes, one grammar\": the scales that are IDENTICAL\n   across the editor family - elevation, motion, radius, scrollbar chrome. Each\n   app supplies its own colour + font VALUES (its palette) over this grammar in\n   its own theme.css. Do not add app-specific colours here.\n   ============================================================================ */\n\n:root {\n  color-scheme: light dark;\n\n  /* The semantic set's third member, and the only COLOUR in this file.\n\n     It is here because it kept not being anywhere. An app's palette owns\n     --danger and --warn; neither owned \"all is well\", so a real need - the live\n     debug link, an in-sync shard, a saved document - was met with a raw green\n     literal that could not theme-shift (surface-audit-shell.md F2). A default\n     in the grammar layer means the shell's own widgets may say it, and an app\n     that has not thought about green yet still gets a green that works on both\n     grounds. Every palette should override it in its theme.css, as it does the\n     other two: this is a floor, not a decision. */\n  --ok: light-dark(#3f7d49, #79bd80);\n\n  /* Elevation: three tiers by how far a surface floats (resting cards,\n     floating menus/popovers, full overlays). Theme-agnostic black so it\n     deepens naturally on the dark palettes. */\n  --shadow-1: 0 1px 3px rgba(0, 0, 0, 0.05);\n  --shadow-2: 0 6px 20px rgba(0, 0, 0, 0.14);\n  --shadow-3: 0 16px 48px rgba(0, 0, 0, 0.28);\n\n  /* Motion: one easing curve + a small duration scale, plus the shared\n     panel/backdrop/screen enter-exit vocabulary. Nothing pops. */\n  --ease-standard: cubic-bezier(0.2, 0, 0, 1);\n  --dur-quick: 120ms;\n  --dur-base: 150ms;\n  --dur-settle: 200ms;\n  --dur-slow: 1s;\n  --dur-panel: 260ms;\n  --dur-exit: 170ms;\n  --anim-panel-in: panel-in var(--dur-panel) var(--ease-standard);\n  --anim-backdrop-in: backdrop-in var(--dur-settle) var(--ease-standard);\n  --anim-screen-in: screen-in var(--dur-panel) var(--ease-standard);\n  --anim-panel-out: panel-out var(--dur-exit) var(--ease-standard) forwards;\n  --anim-backdrop-out: backdrop-out var(--dur-exit) var(--ease-standard) forwards;\n\n  /* Corner radius: four steps cover every surface. */\n  --radius-sm: 6px;\n  --radius-md: 10px;\n  --radius-lg: 14px;\n  --radius-pill: 999px;\n\n  /* Scrollbar thumb: a translucent ink, so it adapts per palette. */\n  --scroll-thumb: color-mix(in oklab, var(--ink) 20%, transparent);\n  --scroll-thumb-hover: color-mix(in oklab, var(--ink) 40%, transparent);\n}\n\n* { scrollbar-width: thin; scrollbar-color: var(--scroll-thumb) transparent; }\n::-webkit-scrollbar { width: 11px; height: 11px; }\n::-webkit-scrollbar-track { background: transparent; }\n::-webkit-scrollbar-corner { background: transparent; }\n::-webkit-scrollbar-thumb { background: var(--scroll-thumb); border-radius: var(--radius-sm); border: 3px solid transparent; background-clip: padding-box; }\n::-webkit-scrollbar-thumb:hover { background: var(--scroll-thumb-hover); background-clip: padding-box; }\n\n@keyframes panel-in { from { opacity: 0; transform: translateY(-9px) scale(0.965); } to { opacity: 1; transform: none; } }\n@keyframes backdrop-in { from { opacity: 0; } to { opacity: 1; } }\n@keyframes screen-in { from { opacity: 0; transform: translateY(6px); } to { opacity: 1; transform: none; } }\n@keyframes panel-out { from { opacity: 1; transform: none; } to { opacity: 0; transform: translateY(-6px) scale(0.97); } }\n@keyframes backdrop-out { from { opacity: 1; } to { opacity: 0; } }\n\n@media (prefers-reduced-motion: reduce) {\n  :root {\n    --anim-panel-in: none; --anim-backdrop-in: none; --anim-screen-in: none;\n    --anim-panel-out: none; --anim-backdrop-out: none;\n  }\n}\n"],"mappings":";AASA;AACE,gBAAc,MAAM;AAYpB,QAAM,WAAW,OAAO,EAAE;AAK1B,cAAY,EAAE,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;AACpC,cAAY,EAAE,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;AACrC,cAAY,EAAE,KAAK,KAAK,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;AAItC,mBAAiB,aAAa,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE;AACzC,eAAa;AACb,cAAY;AACZ,gBAAc;AACd,cAAY;AACZ,eAAa;AACb,cAAY;AACZ,mBAAiB,SAAS,IAAI,aAAa,IAAI;AAC/C,sBAAoB,YAAY,IAAI,cAAc,IAAI;AACtD,oBAAkB,UAAU,IAAI,aAAa,IAAI;AACjD,oBAAkB,UAAU,IAAI,YAAY,IAAI,iBAAiB;AACjE,uBAAqB,aAAa,IAAI,YAAY,IAAI,iBAAiB;AAGvE,eAAa;AACb,eAAa;AACb,eAAa;AACb,iBAAe;AAGf,kBAAgB,UAAU,GAAG,KAAK,EAAE,IAAI,OAAO,GAAG,EAAE;AACpD,wBAAsB,UAAU,GAAG,KAAK,EAAE,IAAI,OAAO,GAAG,EAAE;AAC5D;AAEA;AAAI,mBAAiB;AAAM,mBAAiB,IAAI,gBAAgB;AAAa;AAC7E;AAAsB,SAAO;AAAM,UAAQ;AAAM;AACjD;AAA4B,cAAY;AAAa;AACrD;AAA6B,cAAY;AAAa;AACtD;AAA4B,cAAY,IAAI;AAAiB,iBAAe,IAAI;AAAc,UAAQ,IAAI,MAAM;AAAa,mBAAiB;AAAa;AAC3J,yBAAyB;AAAS,cAAY,IAAI;AAAuB,mBAAiB;AAAa;AAEvG,WAAW;AAAW;AAAO,aAAS;AAAG,eAAW,WAAW,MAAM,MAAM;AAAQ;AAAE;AAAK,aAAS;AAAG,eAAW;AAAM;AAAE;AACzH,WAAW;AAAc;AAAO,aAAS;AAAG;AAAE;AAAK,aAAS;AAAG;AAAE;AACjE,WAAW;AAAY;AAAO,aAAS;AAAG,eAAW,WAAW;AAAM;AAAE;AAAK,aAAS;AAAG,eAAW;AAAM;AAAE;AAC5G,WAAW;AAAY;AAAO,aAAS;AAAG,eAAW;AAAM;AAAE;AAAK,aAAS;AAAG,eAAW,WAAW,MAAM,MAAM;AAAO;AAAE;AACzH,WAAW;AAAe;AAAO,aAAS;AAAG;AAAE;AAAK,aAAS;AAAG;AAAE;AAElE,QAAO,wBAAyB;AAC9B;AACE,qBAAiB;AAAM,wBAAoB;AAAM,sBAAkB;AACnE,sBAAkB;AAAM,yBAAqB;AAC/C;AACF;","names":[]}
+{"version":3,"sources":["../src/tokens.css"],"sourcesContent":["/* ============================================================================\n   Design-token GRAMMAR - the app-agnostic layer (design-language.md section 4).\n\n   The shared half of \"two palettes, one grammar\": the scales that are IDENTICAL\n   across the editor family - elevation, motion, radius, scrollbar chrome. Each\n   app supplies its own colour + font VALUES (its palette) over this grammar in\n   its own theme.css. Do not add app-specific colours here.\n   ============================================================================ */\n\n:root {\n  color-scheme: light dark;\n\n  /* The semantic set's third member, and the only COLOUR in this file.\n\n     It is here because it kept not being anywhere. An app's palette owns\n     --danger and --warn; neither owned \"all is well\", so a real need - the live\n     debug link, an in-sync shard, a saved document - was met with a raw green\n     literal that could not theme-shift (surface-audit-shell.md F2). A default\n     in the grammar layer means the shell's own widgets may say it, and an app\n     that has not thought about green yet still gets a green that works on both\n     grounds. Every palette should override it in its theme.css, as it does the\n     other two: this is a floor, not a decision. */\n  --ok: light-dark(#3f7d49, #79bd80);\n\n  /* The ink that sits ON the accent: a primary button's label, a selected\n     row's text. Every palette overrides it (a light tan accent on a dark\n     palette wants dark ink, not white); this floor only stops the shell's own\n     primary buttons from falling back to a raw #fff literal, which is what\n     they did until 0.39.0 and which read white-on-tan on Night and Slate. */\n  --on-accent: light-dark(#ffffff, #1b1916);\n\n  /* The one scrim behind every modal in the family (confirm, settings,\n     identity, about, notes). Four recipes had grown across five files. */\n  --scrim: color-mix(in oklab, var(--ink) 28%, transparent);\n\n  /* Elevation: three tiers by how far a surface floats (resting cards,\n     floating menus/popovers, full overlays). Theme-agnostic black so it\n     deepens naturally on the dark palettes. */\n  --shadow-1: 0 1px 3px rgba(0, 0, 0, 0.05);\n  --shadow-2: 0 6px 20px rgba(0, 0, 0, 0.14);\n  --shadow-3: 0 16px 48px rgba(0, 0, 0, 0.28);\n\n  /* Motion: one easing curve + a small duration scale, plus the shared\n     panel/backdrop/screen enter-exit vocabulary. Nothing pops. */\n  --ease-standard: cubic-bezier(0.2, 0, 0, 1);\n  --dur-quick: 120ms;\n  --dur-base: 150ms;\n  --dur-settle: 200ms;\n  --dur-slow: 1s;\n  --dur-panel: 260ms;\n  --dur-exit: 170ms;\n  --anim-panel-in: panel-in var(--dur-panel) var(--ease-standard);\n  --anim-backdrop-in: backdrop-in var(--dur-settle) var(--ease-standard);\n  --anim-screen-in: screen-in var(--dur-panel) var(--ease-standard);\n  --anim-panel-out: panel-out var(--dur-exit) var(--ease-standard) forwards;\n  --anim-backdrop-out: backdrop-out var(--dur-exit) var(--ease-standard) forwards;\n  /* The long-job strip's indeterminate band (job.css draws the keyframes). */\n  --anim-job-band: job-band 1.4s var(--ease-standard) infinite;\n\n  /* Corner radius: four steps cover every surface. */\n  --radius-sm: 6px;\n  --radius-md: 10px;\n  --radius-lg: 14px;\n  --radius-pill: 999px;\n\n  /* Scrollbar thumb: a translucent ink, so it adapts per palette. */\n  --scroll-thumb: color-mix(in oklab, var(--ink) 20%, transparent);\n  --scroll-thumb-hover: color-mix(in oklab, var(--ink) 40%, transparent);\n}\n\n/* A drawn icon (`iconNode` / `iconHtml` in icons.ts stamp `data-icon`). A\n   block, so it never sits on a text baseline with descender space under it;\n   no flex shrink, so a crowded row squeezes the text and not the picture; and\n   no pointer events, so a click lands on the button and never on the drawing\n   (a handler comparing `event.target` to its button would otherwise miss).\n   Colour is inherited: every drawing is currentColor. */\n[data-icon] { display: block; flex: none; pointer-events: none; }\n\n/* The family's keyboard focus ring: one rule, zero specificity (:where), so a\n   component may draw its own and win without !important. Until 0.39.0\n   Patterpad's main window had no ring at all and Storyletter carried five\n   copies of this line. Mouse focus stays quiet; only :focus-visible draws. */\n:where(button, [role=\"button\"], input, select, textarea, summary, a[href], [tabindex]):focus-visible {\n  outline: 2px solid var(--accent);\n  outline-offset: 1px;\n}\n\n/* The tracked uppercase caption, kept for exactly two jobs: table column heads\n   and screenplay character cues, where uppercase is the domain's own\n   convention (design-language.md, \"Captions are words, not overlines\"). A\n   section caption anywhere else is sentence-case text at label size, weight\n   600, in the UI face, which is what the shell's own captions now are. */\n.overline { font: 600 0.66rem/1 var(--font-ui); text-transform: uppercase; letter-spacing: 0.06em; color: var(--muted); }\n\n* { scrollbar-width: thin; scrollbar-color: var(--scroll-thumb) transparent; }\n::-webkit-scrollbar { width: 11px; height: 11px; }\n::-webkit-scrollbar-track { background: transparent; }\n::-webkit-scrollbar-corner { background: transparent; }\n::-webkit-scrollbar-thumb { background: var(--scroll-thumb); border-radius: var(--radius-sm); border: 3px solid transparent; background-clip: padding-box; }\n::-webkit-scrollbar-thumb:hover { background: var(--scroll-thumb-hover); background-clip: padding-box; }\n\n@keyframes panel-in { from { opacity: 0; transform: translateY(-9px) scale(0.965); } to { opacity: 1; transform: none; } }\n@keyframes backdrop-in { from { opacity: 0; } to { opacity: 1; } }\n@keyframes screen-in { from { opacity: 0; transform: translateY(6px); } to { opacity: 1; transform: none; } }\n@keyframes panel-out { from { opacity: 1; transform: none; } to { opacity: 0; transform: translateY(-6px) scale(0.97); } }\n@keyframes backdrop-out { from { opacity: 1; } to { opacity: 0; } }\n\n@media (prefers-reduced-motion: reduce) {\n  :root {\n    --anim-panel-in: none; --anim-backdrop-in: none; --anim-screen-in: none;\n    --anim-panel-out: none; --anim-backdrop-out: none; --anim-job-band: none;\n  }\n}\n"],"mappings":";AASA;AACE,gBAAc,MAAM;AAYpB,QAAM,WAAW,OAAO,EAAE;AAO1B,eAAa,WAAW,OAAO,EAAE;AAIjC,WAAS,UAAU,GAAG,KAAK,EAAE,IAAI,OAAO,GAAG,EAAE;AAK7C,cAAY,EAAE,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;AACpC,cAAY,EAAE,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;AACrC,cAAY,EAAE,KAAK,KAAK,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;AAItC,mBAAiB,aAAa,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE;AACzC,eAAa;AACb,cAAY;AACZ,gBAAc;AACd,cAAY;AACZ,eAAa;AACb,cAAY;AACZ,mBAAiB,SAAS,IAAI,aAAa,IAAI;AAC/C,sBAAoB,YAAY,IAAI,cAAc,IAAI;AACtD,oBAAkB,UAAU,IAAI,aAAa,IAAI;AACjD,oBAAkB,UAAU,IAAI,YAAY,IAAI,iBAAiB;AACjE,uBAAqB,aAAa,IAAI,YAAY,IAAI,iBAAiB;AAEvE,mBAAiB,SAAS,KAAK,IAAI,iBAAiB;AAGpD,eAAa;AACb,eAAa;AACb,eAAa;AACb,iBAAe;AAGf,kBAAgB,UAAU,GAAG,KAAK,EAAE,IAAI,OAAO,GAAG,EAAE;AACpD,wBAAsB,UAAU,GAAG,KAAK,EAAE,IAAI,OAAO,GAAG,EAAE;AAC5D;AAQA,CAAC;AAAa,WAAS;AAAO,QAAM;AAAM,kBAAgB;AAAM;AAMhE,OAAO,QAAQ,CAAC,cAAgB,OAAO,QAAQ,UAAU,SAAS,CAAC,CAAC,OAAO,CAAC,UAAU;AACpF,WAAS,IAAI,MAAM,IAAI;AACvB,kBAAgB;AAClB;AAOA,CAAC;AAAW,QAAM,IAAI,OAAO,CAAC,EAAE,IAAI;AAAY,kBAAgB;AAAW,kBAAgB;AAAQ,SAAO,IAAI;AAAU;AAExH;AAAI,mBAAiB;AAAM,mBAAiB,IAAI,gBAAgB;AAAa;AAC7E;AAAsB,SAAO;AAAM,UAAQ;AAAM;AACjD;AAA4B,cAAY;AAAa;AACrD;AAA6B,cAAY;AAAa;AACtD;AAA4B,cAAY,IAAI;AAAiB,iBAAe,IAAI;AAAc,UAAQ,IAAI,MAAM;AAAa,mBAAiB;AAAa;AAC3J,yBAAyB;AAAS,cAAY,IAAI;AAAuB,mBAAiB;AAAa;AAEvG,WAAW;AAAW;AAAO,aAAS;AAAG,eAAW,WAAW,MAAM,MAAM;AAAQ;AAAE;AAAK,aAAS;AAAG,eAAW;AAAM;AAAE;AACzH,WAAW;AAAc;AAAO,aAAS;AAAG;AAAE;AAAK,aAAS;AAAG;AAAE;AACjE,WAAW;AAAY;AAAO,aAAS;AAAG,eAAW,WAAW;AAAM;AAAE;AAAK,aAAS;AAAG,eAAW;AAAM;AAAE;AAC5G,WAAW;AAAY;AAAO,aAAS;AAAG,eAAW;AAAM;AAAE;AAAK,aAAS;AAAG,eAAW,WAAW,MAAM,MAAM;AAAO;AAAE;AACzH,WAAW;AAAe;AAAO,aAAS;AAAG;AAAE;AAAK,aAAS;AAAG;AAAE;AAElE,QAAO,wBAAyB;AAC9B;AACE,qBAAiB;AAAM,wBAAoB;AAAM,sBAAkB;AACnE,sBAAkB;AAAM,yBAAqB;AAAM,qBAAiB;AACtE;AACF;","names":[]}

package/dist/tool-window.cjs

@@ -101,8 +101,71 @@ function openToolWindow(existing, opts) {
   else void w.loadFile(path.join(opts.rendererDir, opts.page));
   return w;
 }
+function defineToolWindows(specs, env) {
+  const live = /* @__PURE__ */ new Map();
+  const byName = (name) => {
+    const found = specs.find((s) => s.name === name);
+    if (!found) throw new Error(`no tool window "${name}"`);
+    return found;
+  };
+  const get = (name) => {
+    const w = live.get(name);
+    return w && !w.isDestroyed() ? w : void 0;
+  };
+  if (env.session) {
+    for (const spec of specs) {
+      env.session.addSatellite({
+        window: () => get(spec.name),
+        channel: spec.channel ?? env.session.channel,
+        ...spec.clear ? { clear: spec.clear } : {}
+      });
+    }
+  }
+  const open = (name) => {
+    const spec = byName(name);
+    const existing = get(name);
+    const opened = openToolWindow(existing, {
+      title: spec.title,
+      page: spec.page,
+      frame: spec.frame ?? false,
+      rendererDir: env.rendererDir,
+      preload: env.preload,
+      rect: savedWindowRect(spec.bounds(), spec.def, spec.min),
+      min: spec.min,
+      pinTo: env.pinTo,
+      pinned: spec.pinned(),
+      remember: spec.remember
+    });
+    if (opened !== existing) {
+      live.set(name, opened);
+      opened.on("closed", () => {
+        if (live.get(name) === opened) live.delete(name);
+      });
+      env.onOpened?.(opened, name);
+    }
+    return opened;
+  };
+  const rescue = () => {
+    env.resetStore?.();
+    for (const spec of specs) rescueToolWindow(get(spec.name), spec.def);
+    for (const spec of specs) {
+      const w = get(spec.name);
+      if (!w) continue;
+      pinToolWindow(w, env.pinTo(), true);
+      w.webContents.send(env.pinChannel ?? "state:pinned", true);
+    }
+  };
+  return {
+    open,
+    get,
+    rescue,
+    all: () => specs.map((s) => get(s.name)).filter((w) => w !== void 0),
+    names: specs.map((s) => s.name)
+  };
+}
 
 exports.centeredOnPrimary = centeredOnPrimary;
+exports.defineToolWindows = defineToolWindows;
 exports.openToolWindow = openToolWindow;
 exports.pinToolWindow = pinToolWindow;
 exports.rememberBounds = rememberBounds;

package/dist/tool-window.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/tool-window.ts"],"names":["screen","app","BrowserWindow","join"],"mappings":"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","file":"tool-window.cjs","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\";\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  app.on(\"did-become-active\", () => { 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; otherwise the next\n      // did-become-active raises it.\n      w.setAlwaysOnTop(BrowserWindow.getFocusedWindow() !== null, \"floating\");\n    } else {\n      macPinned.delete(w);\n      w.setAlwaysOnTop(false);\n    }\n    return;\n  }\n  w.setAlwaysOnTop(false);\n  w.setParentWindow(on && parent && !parent.isDestroyed() ? parent : null);\n}\n\nexport interface ToolWindowOptions {\n  title: string;\n  /** Renderer entry, relative to rendererDir (e.g. \"table.html\", \"search/index.html\"). */\n  page: string;\n  /** Absolute path of the built renderer dir (join(import.meta.dirname, \"../renderer\")). */\n  rendererDir: string;\n  /** Absolute path of the preload bridge. */\n  preload: string;\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  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      preload: opts.preload,\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 (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"]}
+{"version":3,"sources":["../src/tool-window.ts"],"names":["screen","app","BrowserWindow","join"],"mappings":"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","file":"tool-window.cjs","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  app.on(\"did-become-active\", () => { 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; otherwise the next\n      // did-become-active raises it.\n      w.setAlwaysOnTop(BrowserWindow.getFocusedWindow() !== null, \"floating\");\n    } else {\n      macPinned.delete(w);\n      w.setAlwaysOnTop(false);\n    }\n    return;\n  }\n  w.setAlwaysOnTop(false);\n  w.setParentWindow(on && parent && !parent.isDestroyed() ? parent : null);\n}\n\nexport interface ToolWindowOptions {\n  title: string;\n  /** Renderer entry, relative to rendererDir (e.g. \"table.html\", \"search/index.html\"). */\n  page: string;\n  /** Absolute path of the built renderer dir (join(import.meta.dirname, \"../renderer\")). */\n  rendererDir: string;\n  /** Absolute path of the preload bridge. */\n  preload: string;\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  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      preload: opts.preload,\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 (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/tool-window.css

@@ -14,9 +14,7 @@
   -webkit-app-region: no-drag;
 }
 .swin-title {
-  font: 600 0.68rem/1 var(--font-ui);
-  text-transform: uppercase;
-  letter-spacing: 0.07em;
+  font: 600 0.82rem/1.2 var(--font-ui);
   color: var(--muted);
 }
 .swin-spacer {
@@ -57,4 +55,9 @@
   font: 0.8rem var(--font-ui);
   padding: 2px 7px;
 }
+.swin-follow.on {
+  color: var(--accent);
+  border-color: var(--accent);
+  background: color-mix(in oklab, var(--accent) 12%, transparent);
+}
 /*# sourceMappingURL=tool-window.css.map */

package/dist/tool-window.css.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/tool-window.css"],"sourcesContent":["/* ---------------------------------------------------------------------------\n   The tool-window kit, CHROME grammar: the slim drag bar a frameless helper\n   window draws in place of the OS title bar, and the pin / close buttons any\n   helper (framed or not) carries. Consumes the host palette (--surface /\n   --ink / --muted / --line / --line-soft / --accent / --font-ui) over the\n   shared tokens. Content styles stay app-side; this is the chrome only.\n   --------------------------------------------------------------------------- */\n\n/* The drag bar standing in for the OS title bar (frame: false). Buttons and\n   other controls inside it opt out so they stay clickable. */\n.swin-head {\n  -webkit-app-region: drag;\n  display: flex; align-items: center; gap: 6px;\n  padding: 7px 10px;\n  background: var(--surface);\n  /* --line-soft is an optional host token (Storyletter defines it; Patterpad\n     falls back to --line). */\n  border-bottom: 1px solid var(--line-soft, var(--line));\n}\n.swin-head button, .swin-head select, .swin-head input { -webkit-app-region: no-drag; }\n.swin-title {\n  font: 600 0.68rem/1 var(--font-ui);\n  text-transform: uppercase; letter-spacing: 0.07em;\n  color: var(--muted);\n}\n.swin-spacer { flex: 1; }\n\n/* The pin + close pair; motion is interpolation, never a jump. */\n.swin-pin, .swin-close {\n  flex: none; display: inline-flex; align-items: center; justify-content: center;\n  background: none; border: 1px solid transparent; border-radius: var(--radius-sm);\n  cursor: pointer; color: var(--muted); line-height: 0; padding: 4px;\n  transition: background var(--dur-quick) var(--ease-standard),\n    border-color var(--dur-quick) var(--ease-standard),\n    color var(--dur-quick) var(--ease-standard);\n}\n.swin-pin:hover, .swin-close:hover { border-color: var(--line); color: var(--ink); }\n.swin-pin svg { display: block; }\n.swin-pin.on {\n  color: var(--accent); border-color: var(--accent);\n  background: color-mix(in oklab, var(--accent) 12%, transparent);\n}\n.swin-close { font: 0.8rem var(--font-ui); padding: 2px 7px; }\n"],"mappings":";AAUA,CAAC;AACC,sBAAoB;AACpB,WAAS;AAAM,eAAa;AAAQ,OAAK;AACzC,WAAS,IAAI;AACb,cAAY,IAAI;AAGhB,iBAAe,IAAI,MAAM,IAAI,WAAW,EAAE,IAAI;AAChD;AACA,CATC,UASU;AAAQ,CATlB,UAS6B;AAAQ,CATrC,UASgD;AAAQ,sBAAoB;AAAS;AACtF,CAAC;AACC,QAAM,IAAI,OAAO,CAAC,EAAE,IAAI;AACxB,kBAAgB;AAAW,kBAAgB;AAC3C,SAAO,IAAI;AACb;AACA,CAAC;AAAc,QAAM;AAAG;AAGxB,CAAC;AAAU,CAAC;AACV,QAAM;AAAM,WAAS;AAAa,eAAa;AAAQ,mBAAiB;AACxE,cAAY;AAAM,UAAQ,IAAI,MAAM;AAAa,iBAAe,IAAI;AACpE,UAAQ;AAAS,SAAO,IAAI;AAAU,eAAa;AAAG,WAAS;AAC/D;AAAA,IAAY,WAAW,IAAI,aAAa,IAAI,gBAAgB;AAAA,IAC1D,aAAa,IAAI,aAAa,IAAI,gBAAgB;AAAA,IAClD,MAAM,IAAI,aAAa,IAAI;AAC/B;AACA,CARC,QAQQ;AAAQ,CARL,UAQgB;AAAS,gBAAc,IAAI;AAAS,SAAO,IAAI;AAAQ;AACnF,CATC,SASS;AAAM,WAAS;AAAO;AAChC,CAVC,QAUQ,CAAC;AACR,SAAO,IAAI;AAAW,gBAAc,IAAI;AACxC,cAAY,UAAU,GAAG,KAAK,EAAE,IAAI,UAAU,GAAG,EAAE;AACrD;AACA,CAdY;AAcE,QAAM,OAAO,IAAI;AAAY,WAAS,IAAI;AAAK;","names":[]}
+{"version":3,"sources":["../src/tool-window.css"],"sourcesContent":["/* ---------------------------------------------------------------------------\n   The tool-window kit, CHROME grammar: the slim drag bar a frameless helper\n   window draws in place of the OS title bar, and the pin / close buttons any\n   helper (framed or not) carries. Consumes the host palette (--surface /\n   --ink / --muted / --line / --line-soft / --accent / --font-ui) over the\n   shared tokens. Content styles stay app-side; this is the chrome only.\n   --------------------------------------------------------------------------- */\n\n/* The drag bar standing in for the OS title bar (frame: false). Buttons and\n   other controls inside it opt out so they stay clickable. */\n.swin-head {\n  -webkit-app-region: drag;\n  display: flex; align-items: center; gap: 6px;\n  padding: 7px 10px;\n  background: var(--surface);\n  /* --line-soft is an optional host token (Storyletter defines it; Patterpad\n     falls back to --line). */\n  border-bottom: 1px solid var(--line-soft, var(--line));\n}\n.swin-head button, .swin-head select, .swin-head input { -webkit-app-region: no-drag; }\n.swin-title {\n  font: 600 0.82rem/1.2 var(--font-ui);\n  color: var(--muted);\n}\n.swin-spacer { flex: 1; }\n\n/* The pin + close pair; motion is interpolation, never a jump. */\n.swin-pin, .swin-close {\n  flex: none; display: inline-flex; align-items: center; justify-content: center;\n  background: none; border: 1px solid transparent; border-radius: var(--radius-sm);\n  cursor: pointer; color: var(--muted); line-height: 0; padding: 4px;\n  transition: background var(--dur-quick) var(--ease-standard),\n    border-color var(--dur-quick) var(--ease-standard),\n    color var(--dur-quick) var(--ease-standard);\n}\n.swin-pin:hover, .swin-close:hover { border-color: var(--line); color: var(--ink); }\n.swin-pin svg { display: block; }\n.swin-pin.on {\n  color: var(--accent); border-color: var(--accent);\n  background: color-mix(in oklab, var(--accent) 12%, transparent);\n}\n.swin-close { font: 0.8rem var(--font-ui); padding: 2px 7px; }\n\n/* \"Follow in the editor\" (followButton): a `.btn` that lights like the pin\n   while it is on, so the two controls that say how the window sits beside the\n   editor read as one pair. */\n.swin-follow.on {\n  color: var(--accent); border-color: var(--accent);\n  background: color-mix(in oklab, var(--accent) 12%, transparent);\n}\n"],"mappings":";AAUA,CAAC;AACC,sBAAoB;AACpB,WAAS;AAAM,eAAa;AAAQ,OAAK;AACzC,WAAS,IAAI;AACb,cAAY,IAAI;AAGhB,iBAAe,IAAI,MAAM,IAAI,WAAW,EAAE,IAAI;AAChD;AACA,CATC,UASU;AAAQ,CATlB,UAS6B;AAAQ,CATrC,UASgD;AAAQ,sBAAoB;AAAS;AACtF,CAAC;AACC,QAAM,IAAI,OAAO,CAAC,IAAI,IAAI;AAC1B,SAAO,IAAI;AACb;AACA,CAAC;AAAc,QAAM;AAAG;AAGxB,CAAC;AAAU,CAAC;AACV,QAAM;AAAM,WAAS;AAAa,eAAa;AAAQ,mBAAiB;AACxE,cAAY;AAAM,UAAQ,IAAI,MAAM;AAAa,iBAAe,IAAI;AACpE,UAAQ;AAAS,SAAO,IAAI;AAAU,eAAa;AAAG,WAAS;AAC/D;AAAA,IAAY,WAAW,IAAI,aAAa,IAAI,gBAAgB;AAAA,IAC1D,aAAa,IAAI,aAAa,IAAI,gBAAgB;AAAA,IAClD,MAAM,IAAI,aAAa,IAAI;AAC/B;AACA,CARC,QAQQ;AAAQ,CARL,UAQgB;AAAS,gBAAc,IAAI;AAAS,SAAO,IAAI;AAAQ;AACnF,CATC,SASS;AAAM,WAAS;AAAO;AAChC,CAVC,QAUQ,CAAC;AACR,SAAO,IAAI;AAAW,gBAAc,IAAI;AACxC,cAAY,UAAU,GAAG,KAAK,EAAE,IAAI,UAAU,GAAG,EAAE;AACrD;AACA,CAdY;AAcE,QAAM,OAAO,IAAI;AAAY,WAAS,IAAI;AAAK;AAK7D,CAAC,WAAW,CATF;AAUR,SAAO,IAAI;AAAW,gBAAc,IAAI;AACxC,cAAY,UAAU,GAAG,KAAK,EAAE,IAAI,UAAU,GAAG,EAAE;AACrD;","names":[]}

package/dist/tool-window.d.cts

@@ -1,4 +1,6 @@
 import { BrowserWindow } from 'electron';
+import { Satellite } from './session.cjs';
+import './app-store.cjs';
 
 interface ToolWindowSize {
     width: number;
@@ -88,5 +90,69 @@ interface ToolWindowOptions {
  *  preload, electron-vite's dev-URL/file split). Focuses and returns the
  *  existing window when there is one; otherwise creates, wires, and loads. */
 declare function openToolWindow(existing: BrowserWindow | undefined | null, opts: ToolWindowOptions): BrowserWindow;
+interface ToolWindowSpec<N extends string = string> {
+    /** The window's key: the store slice it remembers under, the dev-console
+     *  prefix, and what `open(name)` takes. */
+    name: N;
+    title: string;
+    /** Renderer entry, relative to the env's rendererDir. */
+    page: string;
+    def: ToolWindowSize;
+    min: ToolWindowSize;
+    /** The remembered rect, read at open time (a store read-through). */
+    bounds: () => ToolWindowBounds | undefined;
+    /** Persist a moved / resized rect (debounced by the factory). */
+    remember: (bounds: ToolWindowBounds) => void;
+    /** Whether it starts pinned above the editor (both apps default true). */
+    pinned: () => boolean;
+    /** Frameless (the family's shape: the renderer draws `toolWindowHead`).
+     *  Default false = frameless; pass `frame: true` for an OS title bar. */
+    frame?: boolean;
+    /** The project-changed channel for THIS window when it differs from the
+     *  env's (Storyletter's Links window listens on "links:focus"). */
+    channel?: string;
+    /** Drop what main caches for the outgoing project on this window's behalf
+     *  (a coverage report, a search anchor). Runs whether the window is open
+     *  or not: see session.ts. */
+    clear?: () => void;
+}
+interface ToolWindowEnv {
+    /** Absolute path of the built renderer dir. */
+    rendererDir: string;
+    /** Absolute path of the preload bridge. */
+    preload: string;
+    /** The window to pin above: the app's main window, resolved at open time. */
+    pinTo: () => BrowserWindow | undefined;
+    /** Register every row as a satellite of the project session, so a new
+     *  project cannot open underneath a tool window that still shows the old
+     *  one. `channel` is the nudge each window listens on (a row may override). */
+    session?: {
+        addSatellite: (satellite: Satellite) => () => void;
+        channel: string;
+    };
+    /** Reset View's store half, run first: forget every remembered rect and
+     *  set pinned true (`resetWindows(store)` from app-store, or the app's own). */
+    resetStore?: () => void;
+    /** The channel a rescued window's renderer hears its re-pin on, so its pin
+     *  button agrees with the store (default "state:pinned"). */
+    pinChannel?: string;
+    /** Runs once per window created: forward its console in dev, say. */
+    onOpened?: (w: BrowserWindow, name: string) => void;
+}
+interface ToolWindows<N extends string> {
+    /** Open (or focus) one window by name. */
+    open(name: N): BrowserWindow;
+    /** The live window, if open. */
+    get(name: N): BrowserWindow | undefined;
+    /** Reset View's window half, over the table: store reset, then every open
+     *  window restored, default size, centred, re-pinned, and told so. */
+    rescue(): void;
+    /** Every window that is open right now. */
+    all(): BrowserWindow[];
+    readonly names: readonly N[];
+}
+/** Build the table. The windows are owned here: a host reads them through
+ *  `get(name)` rather than holding module variables of its own. */
+declare function defineToolWindows<N extends string>(specs: ToolWindowSpec<N>[], env: ToolWindowEnv): ToolWindows<N>;
 
-export { type ToolWindowBounds, type ToolWindowOptions, type ToolWindowSize, type ToolWindowState, centeredOnPrimary, openToolWindow, pinToolWindow, rememberBounds, rescueToolWindow, savedWindowRect };
+export { type ToolWindowBounds, type ToolWindowEnv, type ToolWindowOptions, type ToolWindowSize, type ToolWindowSpec, type ToolWindowState, type ToolWindows, centeredOnPrimary, defineToolWindows, openToolWindow, pinToolWindow, rememberBounds, rescueToolWindow, savedWindowRect };

package/dist/tool-window.d.ts

@@ -1,4 +1,6 @@
 import { BrowserWindow } from 'electron';
+import { Satellite } from './session.js';
+import './app-store.js';
 
 interface ToolWindowSize {
     width: number;
@@ -88,5 +90,69 @@ interface ToolWindowOptions {
  *  preload, electron-vite's dev-URL/file split). Focuses and returns the
  *  existing window when there is one; otherwise creates, wires, and loads. */
 declare function openToolWindow(existing: BrowserWindow | undefined | null, opts: ToolWindowOptions): BrowserWindow;
+interface ToolWindowSpec<N extends string = string> {
+    /** The window's key: the store slice it remembers under, the dev-console
+     *  prefix, and what `open(name)` takes. */
+    name: N;
+    title: string;
+    /** Renderer entry, relative to the env's rendererDir. */
+    page: string;
+    def: ToolWindowSize;
+    min: ToolWindowSize;
+    /** The remembered rect, read at open time (a store read-through). */
+    bounds: () => ToolWindowBounds | undefined;
+    /** Persist a moved / resized rect (debounced by the factory). */
+    remember: (bounds: ToolWindowBounds) => void;
+    /** Whether it starts pinned above the editor (both apps default true). */
+    pinned: () => boolean;
+    /** Frameless (the family's shape: the renderer draws `toolWindowHead`).
+     *  Default false = frameless; pass `frame: true` for an OS title bar. */
+    frame?: boolean;
+    /** The project-changed channel for THIS window when it differs from the
+     *  env's (Storyletter's Links window listens on "links:focus"). */
+    channel?: string;
+    /** Drop what main caches for the outgoing project on this window's behalf
+     *  (a coverage report, a search anchor). Runs whether the window is open
+     *  or not: see session.ts. */
+    clear?: () => void;
+}
+interface ToolWindowEnv {
+    /** Absolute path of the built renderer dir. */
+    rendererDir: string;
+    /** Absolute path of the preload bridge. */
+    preload: string;
+    /** The window to pin above: the app's main window, resolved at open time. */
+    pinTo: () => BrowserWindow | undefined;
+    /** Register every row as a satellite of the project session, so a new
+     *  project cannot open underneath a tool window that still shows the old
+     *  one. `channel` is the nudge each window listens on (a row may override). */
+    session?: {
+        addSatellite: (satellite: Satellite) => () => void;
+        channel: string;
+    };
+    /** Reset View's store half, run first: forget every remembered rect and
+     *  set pinned true (`resetWindows(store)` from app-store, or the app's own). */
+    resetStore?: () => void;
+    /** The channel a rescued window's renderer hears its re-pin on, so its pin
+     *  button agrees with the store (default "state:pinned"). */
+    pinChannel?: string;
+    /** Runs once per window created: forward its console in dev, say. */
+    onOpened?: (w: BrowserWindow, name: string) => void;
+}
+interface ToolWindows<N extends string> {
+    /** Open (or focus) one window by name. */
+    open(name: N): BrowserWindow;
+    /** The live window, if open. */
+    get(name: N): BrowserWindow | undefined;
+    /** Reset View's window half, over the table: store reset, then every open
+     *  window restored, default size, centred, re-pinned, and told so. */
+    rescue(): void;
+    /** Every window that is open right now. */
+    all(): BrowserWindow[];
+    readonly names: readonly N[];
+}
+/** Build the table. The windows are owned here: a host reads them through
+ *  `get(name)` rather than holding module variables of its own. */
+declare function defineToolWindows<N extends string>(specs: ToolWindowSpec<N>[], env: ToolWindowEnv): ToolWindows<N>;
 
-export { type ToolWindowBounds, type ToolWindowOptions, type ToolWindowSize, type ToolWindowState, centeredOnPrimary, openToolWindow, pinToolWindow, rememberBounds, rescueToolWindow, savedWindowRect };
+export { type ToolWindowBounds, type ToolWindowEnv, type ToolWindowOptions, type ToolWindowSize, type ToolWindowSpec, type ToolWindowState, type ToolWindows, centeredOnPrimary, defineToolWindows, openToolWindow, pinToolWindow, rememberBounds, rescueToolWindow, savedWindowRect };

package/dist/tool-window.js

@@ -99,7 +99,69 @@ function openToolWindow(existing, opts) {
   else void w.loadFile(join(opts.rendererDir, opts.page));
   return w;
 }
+function defineToolWindows(specs, env) {
+  const live = /* @__PURE__ */ new Map();
+  const byName = (name) => {
+    const found = specs.find((s) => s.name === name);
+    if (!found) throw new Error(`no tool window "${name}"`);
+    return found;
+  };
+  const get = (name) => {
+    const w = live.get(name);
+    return w && !w.isDestroyed() ? w : void 0;
+  };
+  if (env.session) {
+    for (const spec of specs) {
+      env.session.addSatellite({
+        window: () => get(spec.name),
+        channel: spec.channel ?? env.session.channel,
+        ...spec.clear ? { clear: spec.clear } : {}
+      });
+    }
+  }
+  const open = (name) => {
+    const spec = byName(name);
+    const existing = get(name);
+    const opened = openToolWindow(existing, {
+      title: spec.title,
+      page: spec.page,
+      frame: spec.frame ?? false,
+      rendererDir: env.rendererDir,
+      preload: env.preload,
+      rect: savedWindowRect(spec.bounds(), spec.def, spec.min),
+      min: spec.min,
+      pinTo: env.pinTo,
+      pinned: spec.pinned(),
+      remember: spec.remember
+    });
+    if (opened !== existing) {
+      live.set(name, opened);
+      opened.on("closed", () => {
+        if (live.get(name) === opened) live.delete(name);
+      });
+      env.onOpened?.(opened, name);
+    }
+    return opened;
+  };
+  const rescue = () => {
+    env.resetStore?.();
+    for (const spec of specs) rescueToolWindow(get(spec.name), spec.def);
+    for (const spec of specs) {
+      const w = get(spec.name);
+      if (!w) continue;
+      pinToolWindow(w, env.pinTo(), true);
+      w.webContents.send(env.pinChannel ?? "state:pinned", true);
+    }
+  };
+  return {
+    open,
+    get,
+    rescue,
+    all: () => specs.map((s) => get(s.name)).filter((w) => w !== void 0),
+    names: specs.map((s) => s.name)
+  };
+}
 
-export { centeredOnPrimary, openToolWindow, pinToolWindow, rememberBounds, rescueToolWindow, savedWindowRect };
+export { centeredOnPrimary, defineToolWindows, openToolWindow, pinToolWindow, rememberBounds, rescueToolWindow, savedWindowRect };
 //# sourceMappingURL=tool-window.js.map
 //# sourceMappingURL=tool-window.js.map

package/dist/tool-window.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/tool-window.ts"],"names":[],"mappings":"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","file":"tool-window.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\";\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  app.on(\"did-become-active\", () => { 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; otherwise the next\n      // did-become-active raises it.\n      w.setAlwaysOnTop(BrowserWindow.getFocusedWindow() !== null, \"floating\");\n    } else {\n      macPinned.delete(w);\n      w.setAlwaysOnTop(false);\n    }\n    return;\n  }\n  w.setAlwaysOnTop(false);\n  w.setParentWindow(on && parent && !parent.isDestroyed() ? parent : null);\n}\n\nexport interface ToolWindowOptions {\n  title: string;\n  /** Renderer entry, relative to rendererDir (e.g. \"table.html\", \"search/index.html\"). */\n  page: string;\n  /** Absolute path of the built renderer dir (join(import.meta.dirname, \"../renderer\")). */\n  rendererDir: string;\n  /** Absolute path of the preload bridge. */\n  preload: string;\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  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      preload: opts.preload,\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 (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"]}
+{"version":3,"sources":["../src/tool-window.ts"],"names":[],"mappings":"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","file":"tool-window.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  app.on(\"did-become-active\", () => { 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; otherwise the next\n      // did-become-active raises it.\n      w.setAlwaysOnTop(BrowserWindow.getFocusedWindow() !== null, \"floating\");\n    } else {\n      macPinned.delete(w);\n      w.setAlwaysOnTop(false);\n    }\n    return;\n  }\n  w.setAlwaysOnTop(false);\n  w.setParentWindow(on && parent && !parent.isDestroyed() ? parent : null);\n}\n\nexport interface ToolWindowOptions {\n  title: string;\n  /** Renderer entry, relative to rendererDir (e.g. \"table.html\", \"search/index.html\"). */\n  page: string;\n  /** Absolute path of the built renderer dir (join(import.meta.dirname, \"../renderer\")). */\n  rendererDir: string;\n  /** Absolute path of the preload bridge. */\n  preload: string;\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  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      preload: opts.preload,\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 (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"]}