@wildwinter/app-shell 0.1.0 → 0.14.0

package/dist/session.js

@@ -0,0 +1,50 @@
+import { resolve } from 'path';
+
+// src/session.ts
+function createProjectSession(opts) {
+  let session;
+  const satellites = [...opts.satellites ?? []];
+  const invalidateSatellites = () => {
+    for (const sat of satellites) {
+      sat.clear?.();
+      const win = sat.window();
+      if (win && !win.isDestroyed()) win.webContents.send(sat.channel);
+    }
+  };
+  return {
+    current: () => session,
+    openAt(path) {
+      const opened = opts.open(path);
+      if ("error" in opened) {
+        opts.store.forgetProject(path);
+        opts.refreshMenu?.();
+        return opened;
+      }
+      if (session !== void 0) opts.close?.(session);
+      session = opened.session;
+      opts.store.touchProject(opened.root);
+      invalidateSatellites();
+      opts.refreshMenu?.();
+      return opened.reply;
+    },
+    isKnownPath(path) {
+      const s = opts.store.get();
+      const known = new Set(
+        [s.lastProject, ...s.recents].filter((p) => typeof p === "string" && p !== "").map((p) => resolve(p))
+      );
+      return known.has(resolve(path));
+    },
+    addSatellite(satellite) {
+      satellites.push(satellite);
+      return () => {
+        const i = satellites.indexOf(satellite);
+        if (i >= 0) satellites.splice(i, 1);
+      };
+    },
+    invalidateSatellites
+  };
+}
+
+export { createProjectSession };
+//# sourceMappingURL=session.js.map
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session.ts"],"names":[],"mappings":";;;AAwGO,SAAS,qBAA2B,IAAA,EAAyD;AAClG,EAAA,IAAI,OAAA;AACJ,EAAA,MAAM,aAA0B,CAAC,GAAI,IAAA,CAAK,UAAA,IAAc,EAAG,CAAA;AAE3D,EAAA,MAAM,uBAAuB,MAAY;AACvC,IAAA,KAAA,MAAW,OAAO,UAAA,EAAY;AAC5B,MAAA,GAAA,CAAI,KAAA,IAAQ;AACZ,MAAA,MAAM,GAAA,GAAM,IAAI,MAAA,EAAO;AACvB,MAAA,IAAI,GAAA,IAAO,CAAC,GAAA,CAAI,WAAA,IAAe,GAAA,CAAI,WAAA,CAAY,IAAA,CAAK,GAAA,CAAI,OAAO,CAAA;AAAA,IACjE;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,SAAS,MAAM,OAAA;AAAA,IAEf,OAAO,IAAA,EAAM;AACX,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA;AAC7B,MAAA,IAAI,WAAW,MAAA,EAAQ;AACrB,QAAA,IAAA,CAAK,KAAA,CAAM,cAAc,IAAI,CAAA;AAC7B,QAAA,IAAA,CAAK,WAAA,IAAc;AACnB,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,IAAI,OAAA,KAAY,MAAA,EAAW,IAAA,CAAK,KAAA,GAAQ,OAAO,CAAA;AAC/C,MAAA,OAAA,GAAU,MAAA,CAAO,OAAA;AACjB,MAAA,IAAA,CAAK,KAAA,CAAM,YAAA,CAAa,MAAA,CAAO,IAAI,CAAA;AACnC,MAAA,oBAAA,EAAqB;AACrB,MAAA,IAAA,CAAK,WAAA,IAAc;AACnB,MAAA,OAAO,MAAA,CAAO,KAAA;AAAA,IAChB,CAAA;AAAA,IAEA,YAAY,IAAA,EAAM;AAChB,MAAA,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,GAAA,EAAI;AACzB,MAAA,MAAM,QAAQ,IAAI,GAAA;AAAA,QAChB,CAAC,EAAE,WAAA,EAAa,GAAG,EAAE,OAAO,CAAA,CAAE,OAAO,CAAC,CAAA,KAAmB,OAAO,CAAA,KAAM,QAAA,IAAY,MAAM,EAAE,CAAA,CAAE,IAAI,CAAC,CAAA,KAAM,OAAA,CAAQ,CAAC,CAAC;AAAA,OACnH;AACA,MAAA,OAAO,KAAA,CAAM,GAAA,CAAI,OAAA,CAAQ,IAAI,CAAC,CAAA;AAAA,IAChC,CAAA;AAAA,IAEA,aAAa,SAAA,EAAW;AACtB,MAAA,UAAA,CAAW,KAAK,SAAS,CAAA;AACzB,MAAA,OAAO,MAAM;AACX,QAAA,MAAM,CAAA,GAAI,UAAA,CAAW,OAAA,CAAQ,SAAS,CAAA;AACtC,QAAA,IAAI,CAAA,IAAK,CAAA,EAAG,UAAA,CAAW,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,MACpC,CAAA;AAAA,IACF,CAAA;AAAA,IAEA;AAAA,GACF;AACF","file":"session.js","sourcesContent":["// ---------------------------------------------------------------------------\n// The project session: what happens around opening a project, as opposed to\n// the opening itself.\n//\n// Both apps have a function - `openAt` here, `openAndRecord` there - and under\n// two different names they do the same six things in the same order:\n//\n//   1. Ask the app to open it, which is the only app-specific step.\n//   2. On failure, drop it from recents (a project that has moved should stop\n//      being offered) and rebuild the menu.\n//   3. On success, finish with the outgoing session.\n//   4. Record the opened ROOT in the store, which also clears the remembered\n//      place when it is a different project.\n//   5. Invalidate everything main was caching FOR THE OLD PROJECT, and tell\n//      each satellite tool window that the ground moved.\n//   6. Rebuild the menu, so File > Open Recent is current.\n//\n// Step 5 is the one worth extracting on its own. Both apps hand-wire it per\n// window - a cached result nulled, then `if (win && !win.isDestroyed())\n// win.webContents.send(...)` - Storyletter three times, Patterpad twice, and\n// every new tool window is another chance to forget one and leave a window\n// describing a project that is no longer open. Registering a satellite once\n// makes forgetting it impossible.\n//\n// It also carries `isKnownPath`, which only Patterpad had and which is a real\n// guard rather than a tidiness: a renderer must not be able to name an\n// arbitrary directory and have main open it. Fresh paths enter through the\n// native dialogs, which run in main where the person actually chose them;\n// everything else must already be in recents.\n//\n// Electron-free: a satellite is anything with the two methods it needs, which\n// a BrowserWindow satisfies and a test can fake.\n// ---------------------------------------------------------------------------\n\nimport { resolve } from \"node:path\";\n\n/** As much of a BrowserWindow as this file has any business knowing. */\nexport interface SatelliteWindow {\n  isDestroyed(): boolean;\n  webContents: { send(channel: string, ...args: unknown[]): void };\n}\n\n/**\n * A tool window that shows something about the open project, and any state\n * main is holding on its behalf.\n */\nexport interface Satellite {\n  /** Looked up each time rather than held: these windows open and close. */\n  window: () => SatelliteWindow | undefined | null;\n  /** What to send when the project changes. The window re-fetches; it is a\n   *  nudge, not a payload, because by then the new project is already open. */\n  channel: string;\n  /** Drop what main was caching for the old project - a coverage report, a\n   *  search anchor. Called before the window is told. */\n  clear?: () => void;\n}\n\n/** The slice of the app store this needs. Structural, so the real store fits\n *  without dragging its generic parameters in here. */\nexport interface SessionStore {\n  get(): { recents: string[]; lastProject?: string };\n  touchProject(path: string): void;\n  forgetProject(path: string): void;\n}\n\nexport interface ProjectSessionOptions<S, R> {\n  store: SessionStore;\n  /**\n   * Open it. The one app-specific step.\n   *\n   * `root` is what gets recorded, and it is not always the path asked for: a\n   * file-association launch names a shard INSIDE a project, and it is the\n   * project that belongs in recents. `reply` is whatever the app sends back to\n   * its renderer - this never looks inside it.\n   */\n  open: (path: string) => { session: S; root: string; reply: R } | { error: string };\n  /**\n   * The outgoing session is finished with: sweep its temporary files, close its\n   * handles. Called only once the replacement has opened successfully, so a\n   * failed open leaves the current project entirely alone.\n   */\n  close?: (session: S) => void;\n  /** Rebuild the application menu. Called after a change either way, because a\n   *  failed open changes recents too. */\n  refreshMenu?: () => void;\n  satellites?: Satellite[];\n}\n\nexport interface ProjectSession<S, R> {\n  /** The open project, or undefined before the first one. */\n  current: () => S | undefined;\n  /** Open, with everything in the comment above. */\n  openAt: (path: string) => R | { error: string };\n  /** May the renderer ask for this path? See the note above: only paths the app\n   *  already knows, because a native dialog put them there. */\n  isKnownPath: (path: string) => boolean;\n  /** Register a tool window after construction, which is when they usually\n   *  appear. Returns a function that unregisters it. */\n  addSatellite: (satellite: Satellite) => () => void;\n  /** Fire every satellite by hand. For the cases that are not an open but do\n   *  invalidate the same things - a merge landing new content underneath. */\n  invalidateSatellites: () => void;\n}\n\nexport function createProjectSession<S, R>(opts: ProjectSessionOptions<S, R>): ProjectSession<S, R> {\n  let session: S | undefined;\n  const satellites: Satellite[] = [...(opts.satellites ?? [])];\n\n  const invalidateSatellites = (): void => {\n    for (const sat of satellites) {\n      sat.clear?.();\n      const win = sat.window();\n      if (win && !win.isDestroyed()) win.webContents.send(sat.channel);\n    }\n  };\n\n  return {\n    current: () => session,\n\n    openAt(path) {\n      const opened = opts.open(path);\n      if (\"error\" in opened) {\n        opts.store.forgetProject(path);\n        opts.refreshMenu?.();\n        return opened;\n      }\n      if (session !== undefined) opts.close?.(session);\n      session = opened.session;\n      opts.store.touchProject(opened.root);\n      invalidateSatellites();\n      opts.refreshMenu?.();\n      return opened.reply;\n    },\n\n    isKnownPath(path) {\n      const s = opts.store.get();\n      const known = new Set(\n        [s.lastProject, ...s.recents].filter((p): p is string => typeof p === \"string\" && p !== \"\").map((p) => resolve(p)),\n      );\n      return known.has(resolve(path));\n    },\n\n    addSatellite(satellite) {\n      satellites.push(satellite);\n      return () => {\n        const i = satellites.indexOf(satellite);\n        if (i >= 0) satellites.splice(i, 1);\n      };\n    },\n\n    invalidateSatellites,\n  };\n}\n"]}

package/dist/settings.css

@@ -0,0 +1,266 @@
+/* src/settings.css */
+.settings-dialog {
+  padding: 0;
+  border: 1px solid var(--line);
+  border-radius: var(--radius-lg);
+  background: var(--surface);
+  color: var(--ink);
+  width: min(760px, 92vw);
+  max-height: 82vh;
+  box-shadow: var(--shadow-3);
+  font: 14px var(--font-ui, system-ui, sans-serif);
+}
+.settings-dialog::backdrop {
+  background: color-mix(in oklab, #000 42%, transparent);
+}
+.settings-form {
+  display: flex;
+  flex-direction: column;
+  max-height: 82vh;
+}
+.settings-title {
+  margin: 0;
+  padding: 16px 20px;
+  font-family: var(--font-read, inherit);
+  font-size: 1.15rem;
+  font-weight: 600;
+  border-bottom: 1px solid var(--line-soft, var(--line));
+}
+.settings-body {
+  display: flex;
+  min-height: 0;
+  flex: 1;
+}
+.settings-tabs {
+  flex: none;
+  width: 12rem;
+  overflow-y: auto;
+  padding: 10px 8px;
+  border-right: 1px solid var(--line-soft, var(--line));
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+}
+.settings-group {
+  padding: 12px 8px 4px;
+  font: 600 0.62rem/1 var(--font-ui);
+  text-transform: uppercase;
+  letter-spacing: 0.07em;
+  color: var(--muted);
+}
+.settings-tab {
+  text-align: left;
+  width: 100%;
+  padding: 6px 10px;
+  border: 0;
+  border-radius: var(--radius-sm);
+  background: none;
+  color: var(--ink);
+  font: inherit;
+  font-size: 0.88rem;
+  cursor: pointer;
+}
+.settings-tab:hover {
+  background: var(--accent-soft, color-mix(in oklab, var(--accent) 12%, transparent));
+}
+.settings-tab.active {
+  background: var(--accent-soft, color-mix(in oklab, var(--accent) 16%, transparent));
+  color: var(--accent);
+  font-weight: 500;
+}
+.settings-panels {
+  flex: 1;
+  min-width: 0;
+  overflow-y: auto;
+  padding: 18px 22px;
+}
+.settings-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+.settings-panel[hidden] {
+  display: none;
+}
+.settings-actions {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 12px 20px;
+  border-top: 1px solid var(--line-soft, var(--line));
+}
+.settings-error {
+  flex: 1;
+  margin: 0;
+  color: var(--danger);
+  font-size: 0.82rem;
+}
+.settings-actions button {
+  font: inherit;
+  padding: 6px 16px;
+  border: 1px solid var(--line);
+  border-radius: var(--radius-sm);
+  background: none;
+  color: var(--muted);
+  cursor: pointer;
+}
+.settings-actions button:hover {
+  color: var(--accent);
+  border-color: var(--accent);
+}
+.settings-actions .primary {
+  background: var(--accent);
+  color: var(--surface);
+  border-color: transparent;
+  font-weight: 500;
+}
+.settings-actions .primary:hover {
+  color: var(--surface);
+  filter: brightness(1.06);
+}
+.set-row {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 6px 0;
+  border-bottom: 1px solid var(--line-soft, var(--line));
+}
+.set-rowline {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.set-details {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 6px 0 4px 26px;
+}
+.set-details[hidden] {
+  display: none;
+}
+.set-expand {
+  flex: none;
+  width: 18px;
+  height: 18px;
+  border: 0;
+  background: none;
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0;
+}
+.set-expand::before {
+  content: "";
+  width: 0;
+  height: 0;
+  border-left: 6px solid currentColor;
+  border-top: 4.5px solid transparent;
+  border-bottom: 4.5px solid transparent;
+  transform-origin: 35% 50%;
+  transition: transform 0.12s ease;
+}
+.set-expand {
+  color: var(--muted);
+}
+.set-expand:hover,
+.set-expand.open {
+  color: var(--accent);
+}
+.set-expand.open::before {
+  transform: rotate(90deg);
+}
+.set-rowline input,
+.set-rowline select,
+.set-details input,
+.set-details select {
+  font: inherit;
+  font-size: 0.85rem;
+  background: var(--bg);
+  color: var(--ink);
+  border: 1px solid var(--line);
+  border-radius: var(--radius-sm);
+  padding: 4px 8px;
+}
+.set-rowline input.set-name {
+  flex: 1;
+  min-width: 6rem;
+}
+.set-rowline input.invalid,
+.set-details input.invalid {
+  border-color: var(--danger);
+}
+.set-rowline input:focus-visible,
+.set-rowline select:focus-visible,
+.set-details input:focus-visible,
+.set-details select:focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 0;
+  border-color: var(--accent);
+}
+.shell-icon {
+  flex: none;
+  width: 24px;
+  height: 24px;
+  border: 1px solid var(--line);
+  border-radius: var(--radius-sm);
+  background: none;
+  color: var(--muted);
+  cursor: pointer;
+  font-size: 0.8rem;
+}
+.shell-icon:hover:not(:disabled) {
+  color: var(--accent);
+  border-color: var(--accent);
+}
+.shell-icon:disabled {
+  opacity: 0.4;
+  cursor: default;
+}
+.shell-icon.danger:hover:not(:disabled) {
+  color: var(--surface);
+  background: var(--danger);
+  border-color: var(--danger);
+}
+.shell-labelled {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 0.85rem;
+}
+.shell-fieldcap {
+  color: var(--muted);
+  min-width: 5rem;
+}
+.shell-tags {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 5px;
+  align-items: center;
+}
+.shell-tag {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  font-size: 0.76rem;
+  padding: 2px 4px 2px 9px;
+  border: 1px solid var(--line);
+  border-radius: var(--radius-pill);
+  color: var(--ink);
+}
+.shell-tag-x {
+  border: 0;
+  background: none;
+  color: var(--muted);
+  cursor: pointer;
+  font-size: 0.7rem;
+  padding: 0 2px;
+}
+.shell-tag-x:hover {
+  color: var(--danger);
+}
+.shell-tag-input {
+  min-width: 8rem;
+}
+/*# sourceMappingURL=settings.css.map */

package/dist/settings.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/settings.css"],"sourcesContent":["/* ============================================================================\n   The settings dialog + list-editor styling. Reads the shared token grammar\n   (tokens.css) and the app's palette vars (--surface / --ink / --muted / --line\n   / --accent / --danger / --bg, optional --line-soft / --accent-soft). Neutral\n   class names; the app supplies section content.\n   ============================================================================ */\n\n.settings-dialog {\n  padding: 0; border: 1px solid var(--line); border-radius: var(--radius-lg);\n  background: var(--surface); color: var(--ink);\n  width: min(760px, 92vw); max-height: 82vh;\n  box-shadow: var(--shadow-3);\n  font: 14px var(--font-ui, system-ui, sans-serif);\n}\n.settings-dialog::backdrop { background: color-mix(in oklab, #000 42%, transparent); }\n.settings-form { display: flex; flex-direction: column; max-height: 82vh; }\n.settings-title { margin: 0; padding: 16px 20px; font-family: var(--font-read, inherit); font-size: 1.15rem; font-weight: 600; border-bottom: 1px solid var(--line-soft, var(--line)); }\n\n.settings-body { display: flex; min-height: 0; flex: 1; }\n.settings-tabs { flex: none; width: 12rem; overflow-y: auto; padding: 10px 8px; border-right: 1px solid var(--line-soft, var(--line)); display: flex; flex-direction: column; gap: 1px; }\n.settings-group { padding: 12px 8px 4px; font: 600 0.62rem/1 var(--font-ui); text-transform: uppercase; letter-spacing: 0.07em; color: var(--muted); }\n.settings-tab { text-align: left; width: 100%; padding: 6px 10px; border: 0; border-radius: var(--radius-sm); background: none; color: var(--ink); font: inherit; font-size: 0.88rem; cursor: pointer; }\n.settings-tab:hover { background: var(--accent-soft, color-mix(in oklab, var(--accent) 12%, transparent)); }\n.settings-tab.active { background: var(--accent-soft, color-mix(in oklab, var(--accent) 16%, transparent)); color: var(--accent); font-weight: 500; }\n\n.settings-panels { flex: 1; min-width: 0; overflow-y: auto; padding: 18px 22px; }\n.settings-panel { display: flex; flex-direction: column; gap: 14px; }\n/* A `display` on the class beats the UA's `[hidden] { display: none }`, so the\n   panels the tab switcher hides would all render at once. Opt back out. */\n.settings-panel[hidden] { display: none; }\n\n.settings-actions { display: flex; align-items: center; gap: 10px; padding: 12px 20px; border-top: 1px solid var(--line-soft, var(--line)); }\n.settings-error { flex: 1; margin: 0; color: var(--danger); font-size: 0.82rem; }\n.settings-actions button { font: inherit; padding: 6px 16px; border: 1px solid var(--line); border-radius: var(--radius-sm); background: none; color: var(--muted); cursor: pointer; }\n.settings-actions button:hover { color: var(--accent); border-color: var(--accent); }\n.settings-actions .primary { background: var(--accent); color: var(--surface); border-color: transparent; font-weight: 500; }\n.settings-actions .primary:hover { color: var(--surface); filter: brightness(1.06); }\n\n/* --- list editor (rows + disclosure + inline field kit) --------------------- */\n.set-row { display: flex; flex-direction: column; gap: 6px; padding: 6px 0; border-bottom: 1px solid var(--line-soft, var(--line)); }\n.set-rowline { display: flex; align-items: center; gap: 8px; }\n.set-details { display: flex; flex-direction: column; gap: 8px; padding: 6px 0 4px 26px; }\n.set-details[hidden] { display: none; }   /* see .settings-panel[hidden] */\n/* The disclosure triangle is drawn, not typed: U+25B8/25BE are \"small\"\n   triangles that stay hairline-thin at any font size. Rotates when open. */\n.set-expand { flex: none; width: 18px; height: 18px; border: 0; background: none; cursor: pointer; display: flex; align-items: center; justify-content: center; padding: 0; }\n.set-expand::before {\n  content: \"\"; width: 0; height: 0;\n  border-left: 6px solid currentColor; border-top: 4.5px solid transparent; border-bottom: 4.5px solid transparent;\n  transform-origin: 35% 50%; transition: transform 0.12s ease;\n}\n.set-expand { color: var(--muted); }\n.set-expand:hover, .set-expand.open { color: var(--accent); }\n.set-expand.open::before { transform: rotate(90deg); }\n\n.set-rowline input, .set-rowline select, .set-details input, .set-details select {\n  font: inherit; font-size: 0.85rem; background: var(--bg); color: var(--ink);\n  border: 1px solid var(--line); border-radius: var(--radius-sm); padding: 4px 8px;\n}\n.set-rowline input.set-name { flex: 1; min-width: 6rem; }\n.set-rowline input.invalid, .set-details input.invalid { border-color: var(--danger); }\n.set-rowline input:focus-visible, .set-rowline select:focus-visible,\n.set-details input:focus-visible, .set-details select:focus-visible { outline: 2px solid var(--accent); outline-offset: 0; border-color: var(--accent); }\n\n.shell-icon { flex: none; width: 24px; height: 24px; border: 1px solid var(--line); border-radius: var(--radius-sm); background: none; color: var(--muted); cursor: pointer; font-size: 0.8rem; }\n.shell-icon:hover:not(:disabled) { color: var(--accent); border-color: var(--accent); }\n.shell-icon:disabled { opacity: 0.4; cursor: default; }\n.shell-icon.danger:hover:not(:disabled) { color: var(--surface); background: var(--danger); border-color: var(--danger); }\n\n.shell-labelled { display: flex; align-items: center; gap: 8px; font-size: 0.85rem; }\n.shell-fieldcap { color: var(--muted); min-width: 5rem; }\n\n.shell-tags { display: flex; flex-wrap: wrap; gap: 5px; align-items: center; }\n.shell-tag { display: inline-flex; align-items: center; gap: 4px; font-size: 0.76rem; padding: 2px 4px 2px 9px; border: 1px solid var(--line); border-radius: var(--radius-pill); color: var(--ink); }\n.shell-tag-x { border: 0; background: none; color: var(--muted); cursor: pointer; font-size: 0.7rem; padding: 0 2px; }\n.shell-tag-x:hover { color: var(--danger); }\n.shell-tag-input { min-width: 8rem; }\n"],"mappings":";AAOA,CAAC;AACC,WAAS;AAAG,UAAQ,IAAI,MAAM,IAAI;AAAS,iBAAe,IAAI;AAC9D,cAAY,IAAI;AAAY,SAAO,IAAI;AACvC,SAAO,IAAI,KAAK,EAAE;AAAO,cAAY;AACrC,cAAY,IAAI;AAChB,QAAM,KAAK,IAAI,SAAS,EAAE,SAAS,EAAE;AACvC;AACA,CAPC,eAOe;AAAa,cAAY,UAAU,GAAG,KAAK,EAAE,KAAK,GAAG,EAAE;AAAc;AACrF,CAAC;AAAgB,WAAS;AAAM,kBAAgB;AAAQ,cAAY;AAAM;AAC1E,CAAC;AAAiB,UAAQ;AAAG,WAAS,KAAK;AAAM,eAAa,IAAI,WAAW,EAAE;AAAU,aAAW;AAAS,eAAa;AAAK,iBAAe,IAAI,MAAM,IAAI,WAAW,EAAE,IAAI;AAAU;AAEvL,CAAC;AAAgB,WAAS;AAAM,cAAY;AAAG,QAAM;AAAG;AACxD,CAAC;AAAgB,QAAM;AAAM,SAAO;AAAO,cAAY;AAAM,WAAS,KAAK;AAAK,gBAAc,IAAI,MAAM,IAAI,WAAW,EAAE,IAAI;AAAU,WAAS;AAAM,kBAAgB;AAAQ,OAAK;AAAK;AACxL,CAAC;AAAiB,WAAS,KAAK,IAAI;AAAK,QAAM,IAAI,OAAO,CAAC,EAAE,IAAI;AAAY,kBAAgB;AAAW,kBAAgB;AAAQ,SAAO,IAAI;AAAU;AACrJ,CAAC;AAAe,cAAY;AAAM,SAAO;AAAM,WAAS,IAAI;AAAM,UAAQ;AAAG,iBAAe,IAAI;AAAc,cAAY;AAAM,SAAO,IAAI;AAAQ,QAAM;AAAS,aAAW;AAAS,UAAQ;AAAS;AACvM,CADC,YACY;AAAS,cAAY,IAAI,aAAa,EAAE,UAAU,GAAG,KAAK,EAAE,IAAI,UAAU,GAAG,EAAE;AAAe;AAC3G,CAFC,YAEY,CAAC;AAAS,cAAY,IAAI,aAAa,EAAE,UAAU,GAAG,KAAK,EAAE,IAAI,UAAU,GAAG,EAAE;AAAe,SAAO,IAAI;AAAW,eAAa;AAAK;AAEpJ,CAAC;AAAkB,QAAM;AAAG,aAAW;AAAG,cAAY;AAAM,WAAS,KAAK;AAAM;AAChF,CAAC;AAAiB,WAAS;AAAM,kBAAgB;AAAQ,OAAK;AAAM;AAGpE,CAHC,cAGc,CAAC;AAAU,WAAS;AAAM;AAEzC,CAAC;AAAmB,WAAS;AAAM,eAAa;AAAQ,OAAK;AAAM,WAAS,KAAK;AAAM,cAAY,IAAI,MAAM,IAAI,WAAW,EAAE,IAAI;AAAU;AAC5I,CAAC;AAAiB,QAAM;AAAG,UAAQ;AAAG,SAAO,IAAI;AAAW,aAAW;AAAS;AAChF,CAFC,iBAEiB;AAAS,QAAM;AAAS,WAAS,IAAI;AAAM,UAAQ,IAAI,MAAM,IAAI;AAAS,iBAAe,IAAI;AAAc,cAAY;AAAM,SAAO,IAAI;AAAU,UAAQ;AAAS;AACrL,CAHC,iBAGiB,MAAM;AAAS,SAAO,IAAI;AAAW,gBAAc,IAAI;AAAW;AACpF,CAJC,iBAIiB,CAAC;AAAU,cAAY,IAAI;AAAW,SAAO,IAAI;AAAY,gBAAc;AAAa,eAAa;AAAK;AAC5H,CALC,iBAKiB,CADC,OACO;AAAS,SAAO,IAAI;AAAY,UAAQ,WAAW;AAAO;AAGpF,CAAC;AAAU,WAAS;AAAM,kBAAgB;AAAQ,OAAK;AAAK,WAAS,IAAI;AAAG,iBAAe,IAAI,MAAM,IAAI,WAAW,EAAE,IAAI;AAAU;AACpI,CAAC;AAAc,WAAS;AAAM,eAAa;AAAQ,OAAK;AAAK;AAC7D,CAAC;AAAc,WAAS;AAAM,kBAAgB;AAAQ,OAAK;AAAK,WAAS,IAAI,EAAE,IAAI;AAAM;AACzF,CADC,WACW,CAAC;AAAU,WAAS;AAAM;AAGtC,CAAC;AAAa,QAAM;AAAM,SAAO;AAAM,UAAQ;AAAM,UAAQ;AAAG,cAAY;AAAM,UAAQ;AAAS,WAAS;AAAM,eAAa;AAAQ,mBAAiB;AAAQ,WAAS;AAAG;AAC5K,CADC,UACU;AACT,WAAS;AAAI,SAAO;AAAG,UAAQ;AAC/B,eAAa,IAAI,MAAM;AAAc,cAAY,MAAM,MAAM;AAAa,iBAAe,MAAM,MAAM;AACrG,oBAAkB,IAAI;AAAK,cAAY,UAAU,MAAM;AACzD;AACA,CANC;AAMa,SAAO,IAAI;AAAU;AACnC,CAPC,UAOU;AAAQ,CAPlB,UAO6B,CAAC;AAAO,SAAO,IAAI;AAAW;AAC5D,CARC,UAQU,CADoB,IACf;AAAW,aAAW,OAAO;AAAQ;AAErD,CAfC,YAeY;AAAO,CAfnB,YAegC;AAAQ,CAdxC,YAcqD;AAAO,CAd5D,YAcyE;AACxE,QAAM;AAAS,aAAW;AAAS,cAAY,IAAI;AAAO,SAAO,IAAI;AACrE,UAAQ,IAAI,MAAM,IAAI;AAAS,iBAAe,IAAI;AAAc,WAAS,IAAI;AAC/E;AACA,CAnBC,YAmBY,KAAK,CAAC;AAAW,QAAM;AAAG,aAAW;AAAM;AACxD,CApBC,YAoBY,KAAK,CAAC;AAAS,CAnB3B,YAmBwC,KAAK,CAA3B;AAAsC,gBAAc,IAAI;AAAW;AACtF,CArBC,YAqBY,KAAK;AAAgB,CArBjC,YAqB8C,MAAM;AACrD,CArBC,YAqBY,KAAK;AAAgB,CArBjC,YAqB8C,MAAM;AAAiB,WAAS,IAAI,MAAM,IAAI;AAAW,kBAAgB;AAAG,gBAAc,IAAI;AAAW;AAExJ,CAAC;AAAa,QAAM;AAAM,SAAO;AAAM,UAAQ;AAAM,UAAQ,IAAI,MAAM,IAAI;AAAS,iBAAe,IAAI;AAAc,cAAY;AAAM,SAAO,IAAI;AAAU,UAAQ;AAAS,aAAW;AAAQ;AAChM,CADC,UACU,MAAM,KAAK;AAAa,SAAO,IAAI;AAAW,gBAAc,IAAI;AAAW;AACtF,CAFC,UAEU;AAAY,WAAS;AAAK,UAAQ;AAAS;AACtD,CAHC,UAGU,CAAC,MAAM,MAAM,KAAK;AAAa,SAAO,IAAI;AAAY,cAAY,IAAI;AAAW,gBAAc,IAAI;AAAW;AAEzH,CAAC;AAAiB,WAAS;AAAM,eAAa;AAAQ,OAAK;AAAK,aAAW;AAAS;AACpF,CAAC;AAAiB,SAAO,IAAI;AAAU,aAAW;AAAM;AAExD,CAAC;AAAa,WAAS;AAAM,aAAW;AAAM,OAAK;AAAK,eAAa;AAAQ;AAC7E,CAAC;AAAY,WAAS;AAAa,eAAa;AAAQ,OAAK;AAAK,aAAW;AAAS,WAAS,IAAI,IAAI,IAAI;AAAK,UAAQ,IAAI,MAAM,IAAI;AAAS,iBAAe,IAAI;AAAgB,SAAO,IAAI;AAAQ;AACrM,CAAC;AAAc,UAAQ;AAAG,cAAY;AAAM,SAAO,IAAI;AAAU,UAAQ;AAAS,aAAW;AAAQ,WAAS,EAAE;AAAK;AACrH,CADC,WACW;AAAS,SAAO,IAAI;AAAW;AAC3C,CAAC;AAAkB,aAAW;AAAM;","names":[]}

package/dist/tool-window.cjs

@@ -0,0 +1,79 @@
+'use strict';
+
+var electron = require('electron');
+var path = require('path');
+
+// src/tool-window.ts
+function savedWindowRect(saved, def, min) {
+  if (!saved) return { ...def };
+  const w = Math.max(min.width, saved.width), h = Math.max(min.height, saved.height);
+  if (saved.x != null && saved.y != null) {
+    const onScreen = electron.screen.getAllDisplays().some((d) => {
+      const a = d.workArea;
+      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;
+    });
+    if (onScreen) return { x: saved.x, y: saved.y, width: w, height: h };
+  }
+  return { width: w, height: h };
+}
+function rememberBounds(w, write) {
+  const saveBounds = () => {
+    if (!w.isDestroyed()) write(w.getBounds());
+  };
+  let boundsTimer;
+  const queueSave = () => {
+    clearTimeout(boundsTimer);
+    boundsTimer = setTimeout(saveBounds, 400);
+  };
+  w.on("resize", queueSave);
+  w.on("move", queueSave);
+  w.on("close", () => {
+    clearTimeout(boundsTimer);
+    saveBounds();
+  });
+}
+function centeredOnPrimary(size) {
+  const a = electron.screen.getPrimaryDisplay().workArea;
+  return { x: Math.round(a.x + (a.width - size.width) / 2), y: Math.round(a.y + (a.height - size.height) / 2) };
+}
+function rescueToolWindow(w, def) {
+  if (!w || w.isDestroyed()) return;
+  if (w.isMinimized()) w.restore();
+  w.setAlwaysOnTop(true);
+  w.setBounds({ ...def, ...centeredOnPrimary(def) });
+  w.show();
+}
+function openToolWindow(existing, opts) {
+  if (existing && !existing.isDestroyed()) {
+    existing.focus();
+    return existing;
+  }
+  const w = new electron.BrowserWindow({
+    ...opts.rect,
+    ...opts.min !== void 0 ? { minWidth: opts.min.width, minHeight: opts.min.height } : {},
+    show: false,
+    title: opts.title,
+    ...opts.frame !== void 0 ? { frame: opts.frame } : {},
+    ...opts.alwaysOnTop !== void 0 ? { alwaysOnTop: opts.alwaysOnTop } : {},
+    webPreferences: {
+      contextIsolation: true,
+      nodeIntegration: false,
+      sandbox: true,
+      preload: opts.preload
+    }
+  });
+  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}`);
+  else void w.loadFile(path.join(opts.rendererDir, opts.page));
+  return w;
+}
+
+exports.centeredOnPrimary = centeredOnPrimary;
+exports.openToolWindow = openToolWindow;
+exports.rememberBounds = rememberBounds;
+exports.rescueToolWindow = rescueToolWindow;
+exports.savedWindowRect = savedWindowRect;
+//# sourceMappingURL=tool-window.cjs.map
+//# sourceMappingURL=tool-window.cjs.map

package/dist/tool-window.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tool-window.ts"],"names":["screen","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, 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.setAlwaysOnTop(true);\n  w.setBounds({ ...def, ...centeredOnPrimary(def) });\n  w.show();\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  /** Floats over the editor (the pin); remembered by the host. */\n  alwaysOnTop?: 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    ...(opts.alwaysOnTop !== undefined ? { alwaysOnTop: opts.alwaysOnTop } : {}),\n    webPreferences: {\n      contextIsolation: true, nodeIntegration: false, sandbox: true,\n      preload: opts.preload,\n    },\n  });\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"]}

package/dist/tool-window.css

@@ -0,0 +1,60 @@
+/* src/tool-window.css */
+.swin-head {
+  -webkit-app-region: drag;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 7px 10px;
+  background: var(--surface);
+  border-bottom: 1px solid var(--line-soft, var(--line));
+}
+.swin-head button,
+.swin-head select,
+.swin-head input {
+  -webkit-app-region: no-drag;
+}
+.swin-title {
+  font: 600 0.68rem/1 var(--font-ui);
+  text-transform: uppercase;
+  letter-spacing: 0.07em;
+  color: var(--muted);
+}
+.swin-spacer {
+  flex: 1;
+}
+.swin-pin,
+.swin-close {
+  flex: none;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  background: none;
+  border: 1px solid transparent;
+  border-radius: var(--radius-sm);
+  cursor: pointer;
+  color: var(--muted);
+  line-height: 0;
+  padding: 4px;
+  transition:
+    background var(--dur-quick) var(--ease-standard),
+    border-color var(--dur-quick) var(--ease-standard),
+    color var(--dur-quick) var(--ease-standard);
+}
+.swin-pin:hover,
+.swin-close:hover {
+  border-color: var(--line);
+  color: var(--ink);
+}
+.swin-pin svg {
+  display: block;
+}
+.swin-pin.on {
+  color: var(--accent);
+  border-color: var(--accent);
+  background: color-mix(in oklab, var(--accent) 12%, transparent);
+}
+.swin-close {
+  font: 0.8rem var(--font-ui);
+  padding: 2px 7px;
+}
+/*# sourceMappingURL=tool-window.css.map */

package/dist/tool-window.css.map

@@ -0,0 +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":[]}

package/dist/tool-window.d.cts

@@ -0,0 +1,63 @@
+import { BrowserWindow } from 'electron';
+
+interface ToolWindowSize {
+    width: number;
+    height: number;
+}
+interface ToolWindowBounds {
+    x?: number;
+    y?: number;
+    width: number;
+    height: number;
+}
+/** The per-window store slice every app remembers: where it was, whether it
+ *  floats. (Patterpad's PlayWindowState, generalised.) */
+interface ToolWindowState {
+    bounds?: ToolWindowBounds;
+    pinned: boolean;
+}
+/** Use a remembered rect only if it still intersects a live display (a window
+ *  saved on a now-disconnected monitor must not open offscreen). Falls back
+ *  to the default size; a remembered size is kept even when the position is
+ *  dropped (Electron then centres it). */
+declare function savedWindowRect(saved: ToolWindowBounds | undefined, def: ToolWindowSize, min: ToolWindowSize): ToolWindowBounds;
+/** Persist a helper window's bounds as the user moves / resizes / closes it
+ *  (debounced 400ms; close flushes synchronously). */
+declare function rememberBounds(w: BrowserWindow, write: (bounds: ToolWindowBounds) => void): void;
+/** Centre a rect on the primary display's work area. */
+declare function centeredOnPrimary(size: ToolWindowSize): {
+    x: number;
+    y: number;
+};
+/** Reset View's per-window half: un-minimise, re-pin (always - the store
+ *  says pinned:true after a rescue, so the window must agree), default size,
+ *  centred on the primary display, shown. The host clears its remembered
+ *  bounds itself (that's a store concern). No focus steal: helpers show
+ *  behind the editor. */
+declare function rescueToolWindow(w: BrowserWindow | undefined | null, def: ToolWindowSize): void;
+interface ToolWindowOptions {
+    title: string;
+    /** Renderer entry, relative to rendererDir (e.g. "table.html", "search/index.html"). */
+    page: string;
+    /** Absolute path of the built renderer dir (join(import.meta.dirname, "../renderer")). */
+    rendererDir: string;
+    /** Absolute path of the preload bridge. */
+    preload: string;
+    rect: ToolWindowBounds;
+    min?: ToolWindowSize;
+    /** false = frameless: the renderer draws its own slim drag bar (.swin-head). */
+    frame?: boolean;
+    /** Floats over the editor (the pin); remembered by the host. */
+    alwaysOnTop?: boolean;
+    /** Wire debounced bounds persistence into the host's store slice. */
+    remember?: (bounds: ToolWindowBounds) => void;
+    /** Fired when THIS window closes (identity-guarded; a stale close never
+     *  clears a newer window). Null the host's handle here. */
+    onClosed?: () => void;
+}
+/** The pinnable detached-window factory (hardened webPreferences, one
+ *  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;
+
+export { type ToolWindowBounds, type ToolWindowOptions, type ToolWindowSize, type ToolWindowState, centeredOnPrimary, openToolWindow, rememberBounds, rescueToolWindow, savedWindowRect };

package/dist/tool-window.d.ts

@@ -0,0 +1,63 @@
+import { BrowserWindow } from 'electron';
+
+interface ToolWindowSize {
+    width: number;
+    height: number;
+}
+interface ToolWindowBounds {
+    x?: number;
+    y?: number;
+    width: number;
+    height: number;
+}
+/** The per-window store slice every app remembers: where it was, whether it
+ *  floats. (Patterpad's PlayWindowState, generalised.) */
+interface ToolWindowState {
+    bounds?: ToolWindowBounds;
+    pinned: boolean;
+}
+/** Use a remembered rect only if it still intersects a live display (a window
+ *  saved on a now-disconnected monitor must not open offscreen). Falls back
+ *  to the default size; a remembered size is kept even when the position is
+ *  dropped (Electron then centres it). */
+declare function savedWindowRect(saved: ToolWindowBounds | undefined, def: ToolWindowSize, min: ToolWindowSize): ToolWindowBounds;
+/** Persist a helper window's bounds as the user moves / resizes / closes it
+ *  (debounced 400ms; close flushes synchronously). */
+declare function rememberBounds(w: BrowserWindow, write: (bounds: ToolWindowBounds) => void): void;
+/** Centre a rect on the primary display's work area. */
+declare function centeredOnPrimary(size: ToolWindowSize): {
+    x: number;
+    y: number;
+};
+/** Reset View's per-window half: un-minimise, re-pin (always - the store
+ *  says pinned:true after a rescue, so the window must agree), default size,
+ *  centred on the primary display, shown. The host clears its remembered
+ *  bounds itself (that's a store concern). No focus steal: helpers show
+ *  behind the editor. */
+declare function rescueToolWindow(w: BrowserWindow | undefined | null, def: ToolWindowSize): void;
+interface ToolWindowOptions {
+    title: string;
+    /** Renderer entry, relative to rendererDir (e.g. "table.html", "search/index.html"). */
+    page: string;
+    /** Absolute path of the built renderer dir (join(import.meta.dirname, "../renderer")). */
+    rendererDir: string;
+    /** Absolute path of the preload bridge. */
+    preload: string;
+    rect: ToolWindowBounds;
+    min?: ToolWindowSize;
+    /** false = frameless: the renderer draws its own slim drag bar (.swin-head). */
+    frame?: boolean;
+    /** Floats over the editor (the pin); remembered by the host. */
+    alwaysOnTop?: boolean;
+    /** Wire debounced bounds persistence into the host's store slice. */
+    remember?: (bounds: ToolWindowBounds) => void;
+    /** Fired when THIS window closes (identity-guarded; a stale close never
+     *  clears a newer window). Null the host's handle here. */
+    onClosed?: () => void;
+}
+/** The pinnable detached-window factory (hardened webPreferences, one
+ *  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;
+
+export { type ToolWindowBounds, type ToolWindowOptions, type ToolWindowSize, type ToolWindowState, centeredOnPrimary, openToolWindow, rememberBounds, rescueToolWindow, savedWindowRect };