@wildwinter/app-shell 0.1.0 → 0.14.0

package/dist/job.d.ts

@@ -0,0 +1,56 @@
+/** The channel a host should send progress on, and the shape it carries. */
+declare const JOB_PROGRESS = "job:progress";
+interface JobProgress {
+    /** Which job this is about ("coverage"), so one listener can serve many. */
+    kind: string;
+    /** Units finished and expected. `total` 0 means "no idea yet". */
+    done: number;
+    total: number;
+    /** Milliseconds since the job started, for elapsed + estimated remaining. */
+    elapsedMs: number;
+}
+/** What the work is given: a cancellation flag and the one call that both
+ *  reports progress and yields. */
+interface JobContext {
+    /** True once someone has cancelled. Check it to bail out early, or to
+     *  return a partial result rather than nothing. */
+    readonly cancelled: boolean;
+    /** Report progress and, when enough time has passed, hand the event loop
+     *  back. Await it: that await IS the yield. */
+    step(done: number, total: number): Promise<void>;
+}
+type JobResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    cancelled: true;
+    value?: T;
+} | {
+    error: string;
+};
+interface JobHost {
+    /** Run `work` as the job of this kind. Rejects a second start of the same
+     *  kind while one is in flight (the caller should have disabled the button;
+     *  this is the backstop). */
+    start<T>(kind: string, work: (ctx: JobContext) => Promise<T>): Promise<JobResult<T>>;
+    /** Ask the running job of this kind to stop. It stops at its next step(). */
+    cancel(kind: string): void;
+    running(kind: string): boolean;
+}
+interface JobHostOptions {
+    /** Deliver a progress message to whoever is watching (typically
+     *  `window.webContents.send(JOB_PROGRESS, payload)` for each live window). */
+    send: (channel: string, payload: JobProgress) => void;
+    /** How long the work may hold the event loop between yields (default 16ms,
+     *  about one frame). Smaller is smoother and slower. */
+    sliceMs?: number;
+    /** How often a progress message may be sent (default 100ms). Progress is
+     *  for a human to read; flooding the channel just costs IPC. */
+    reportMs?: number;
+    /** Injectable clock + yield, for tests. */
+    now?: () => number;
+    yieldToLoop?: () => Promise<void>;
+}
+declare function createJobHost(opts: JobHostOptions): JobHost;
+
+export { JOB_PROGRESS, type JobContext, type JobHost, type JobHostOptions, type JobProgress, type JobResult, createJobHost };

package/dist/job.js

@@ -0,0 +1,3 @@
+export { JOB_PROGRESS, createJobHost } from './chunk-MDGOIT3O.js';
+//# sourceMappingURL=job.js.map
+//# sourceMappingURL=job.js.map

package/dist/job.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"job.js"}

package/dist/menu.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+// src/menu.ts
+var EDIT_MENU = {
+  undo: { label: "Undo", accelerator: "CmdOrCtrl+Z" },
+  redo: { label: "Redo", accelerator: "Shift+CmdOrCtrl+Z" },
+  duplicate: { label: "Duplicate", accelerator: "CmdOrCtrl+D" },
+  find: { label: "Find\u2026", accelerator: "CmdOrCtrl+F" }
+};
+var PANE_MENU = {
+  showNav: { label: "Show Navigator", accelerator: "CmdOrCtrl+1" },
+  showInspector: { label: "Show Inspector", accelerator: "CmdOrCtrl+2" },
+  resetView: { label: "Reset View" }
+};
+
+exports.EDIT_MENU = EDIT_MENU;
+exports.PANE_MENU = PANE_MENU;
+//# sourceMappingURL=menu.cjs.map
+//# sourceMappingURL=menu.cjs.map

package/dist/menu.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/menu.ts"],"names":[],"mappings":";;;AA2BO,IAAM,SAAA,GAKT;AAAA,EACF,IAAA,EAAM,EAAE,KAAA,EAAO,MAAA,EAAQ,aAAa,aAAA,EAAc;AAAA,EAClD,IAAA,EAAM,EAAE,KAAA,EAAO,MAAA,EAAQ,aAAa,mBAAA,EAAoB;AAAA,EACxD,SAAA,EAAW,EAAE,KAAA,EAAO,WAAA,EAAa,aAAa,aAAA,EAAc;AAAA,EAC5D,IAAA,EAAM,EAAE,KAAA,EAAO,YAAA,EAAS,aAAa,aAAA;AACvC;AAGO,IAAM,SAAA,GAIT;AAAA,EACF,OAAA,EAAS,EAAE,KAAA,EAAO,gBAAA,EAAkB,aAAa,aAAA,EAAc;AAAA,EAC/D,aAAA,EAAe,EAAE,KAAA,EAAO,gBAAA,EAAkB,aAAa,aAAA,EAAc;AAAA,EACrE,SAAA,EAAW,EAAE,KAAA,EAAO,YAAA;AACtB","file":"menu.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// Shell-owned menu naming: the labels + accelerators for the pane-frame menu\n// items, single-sourced so every app in the family names them identically\n// (and a rename here flows to all of them). Pure data - no electron, no DOM -\n// so a main-process menu builder can import it. Each app builds its own\n// MenuItem from these and wires the click to its shell controller.\n// ---------------------------------------------------------------------------\n\nexport interface MenuLabel {\n  label: string;\n  /** Electron accelerator string, when the item has one. */\n  accelerator?: string;\n}\n\n/**\n * The Edit menu items the family shares.\n *\n * Undo and Redo are here and the MECHANISM is not, which is the whole finding\n * about undo: Patterpad's is ProseMirror's document history, Storyletter's is a\n * replay of file bytes, and those have nothing in common but this. See\n * `design/shared-shell.md`.\n *\n * The rule both apps discovered separately, and the reason these are spelled\n * out rather than left as Electron's `role: \"undo\"`: the native role runs a DOM\n * text-field undo, which knows nothing about either app's model and will\n * silently undo the wrong thing.\n */\nexport const EDIT_MENU: {\n  undo: MenuLabel;\n  redo: MenuLabel;\n  duplicate: MenuLabel;\n  find: MenuLabel;\n} = {\n  undo: { label: \"Undo\", accelerator: \"CmdOrCtrl+Z\" },\n  redo: { label: \"Redo\", accelerator: \"Shift+CmdOrCtrl+Z\" },\n  duplicate: { label: \"Duplicate\", accelerator: \"CmdOrCtrl+D\" },\n  find: { label: \"Find…\", accelerator: \"CmdOrCtrl+F\" },\n};\n\n/** The pane-frame menu items (a View menu, conventionally). */\nexport const PANE_MENU: {\n  showNav: MenuLabel;\n  showInspector: MenuLabel;\n  resetView: MenuLabel;\n} = {\n  showNav: { label: \"Show Navigator\", accelerator: \"CmdOrCtrl+1\" },\n  showInspector: { label: \"Show Inspector\", accelerator: \"CmdOrCtrl+2\" },\n  resetView: { label: \"Reset View\" },\n};\n"]}

package/dist/menu.d.cts

@@ -0,0 +1,32 @@
+interface MenuLabel {
+    label: string;
+    /** Electron accelerator string, when the item has one. */
+    accelerator?: string;
+}
+/**
+ * The Edit menu items the family shares.
+ *
+ * Undo and Redo are here and the MECHANISM is not, which is the whole finding
+ * about undo: Patterpad's is ProseMirror's document history, Storyletter's is a
+ * replay of file bytes, and those have nothing in common but this. See
+ * `design/shared-shell.md`.
+ *
+ * The rule both apps discovered separately, and the reason these are spelled
+ * out rather than left as Electron's `role: "undo"`: the native role runs a DOM
+ * text-field undo, which knows nothing about either app's model and will
+ * silently undo the wrong thing.
+ */
+declare const EDIT_MENU: {
+    undo: MenuLabel;
+    redo: MenuLabel;
+    duplicate: MenuLabel;
+    find: MenuLabel;
+};
+/** The pane-frame menu items (a View menu, conventionally). */
+declare const PANE_MENU: {
+    showNav: MenuLabel;
+    showInspector: MenuLabel;
+    resetView: MenuLabel;
+};
+
+export { EDIT_MENU, type MenuLabel, PANE_MENU };

package/dist/menu.d.ts

@@ -0,0 +1,32 @@
+interface MenuLabel {
+    label: string;
+    /** Electron accelerator string, when the item has one. */
+    accelerator?: string;
+}
+/**
+ * The Edit menu items the family shares.
+ *
+ * Undo and Redo are here and the MECHANISM is not, which is the whole finding
+ * about undo: Patterpad's is ProseMirror's document history, Storyletter's is a
+ * replay of file bytes, and those have nothing in common but this. See
+ * `design/shared-shell.md`.
+ *
+ * The rule both apps discovered separately, and the reason these are spelled
+ * out rather than left as Electron's `role: "undo"`: the native role runs a DOM
+ * text-field undo, which knows nothing about either app's model and will
+ * silently undo the wrong thing.
+ */
+declare const EDIT_MENU: {
+    undo: MenuLabel;
+    redo: MenuLabel;
+    duplicate: MenuLabel;
+    find: MenuLabel;
+};
+/** The pane-frame menu items (a View menu, conventionally). */
+declare const PANE_MENU: {
+    showNav: MenuLabel;
+    showInspector: MenuLabel;
+    resetView: MenuLabel;
+};
+
+export { EDIT_MENU, type MenuLabel, PANE_MENU };

package/dist/menu.js

@@ -0,0 +1,3 @@
+export { EDIT_MENU, PANE_MENU } from './chunk-R6RO5TXB.js';
+//# sourceMappingURL=menu.js.map
+//# sourceMappingURL=menu.js.map

package/dist/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"menu.js"}

package/dist/notes-editor.css

@@ -0,0 +1,107 @@
+/* src/notes-editor.css */
+.shell-notes {
+  width: min(560px, 92vw);
+  border: 1px solid var(--line);
+  border-radius: var(--radius-md);
+  background: var(--surface);
+  color: var(--ink);
+  padding: 16px 18px;
+  box-shadow: var(--shadow-2, var(--shadow-1));
+}
+.shell-notes::backdrop {
+  background: rgba(0, 0, 0, 0.28);
+}
+.shell-notes-title {
+  font: 600 0.95rem/1.3 var(--font-ui);
+  margin-bottom: 10px;
+}
+.shell-notes-body {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  max-height: 60vh;
+  overflow-y: auto;
+}
+.shell-notes-caption {
+  font: 0.72rem/1 var(--font-ui);
+  color: var(--muted);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+.shell-notes-class {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.shell-notes-text {
+  width: 100%;
+  box-sizing: border-box;
+  resize: vertical;
+  border: 1px solid var(--line-soft);
+  border-radius: var(--radius-sm);
+  background: var(--card);
+  color: var(--ink);
+  font: 0.85rem/1.45 var(--font-read, var(--font-ui));
+  padding: 6px 8px;
+}
+.shell-notes-text:focus {
+  outline: none;
+  border-color: var(--accent);
+}
+.shell-notes-inherited {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding-bottom: 4px;
+  border-bottom: 1px solid var(--line-soft);
+}
+.shell-notes-level {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+.shell-notes-level-label {
+  font: 0.72rem/1 var(--font-ui);
+  color: var(--muted);
+}
+.shell-notes-line {
+  font: 0.82rem/1.4 var(--font-read, var(--font-ui));
+  color: var(--muted);
+}
+.shell-notes-cls {
+  font: 0.68rem/1 var(--font-ui);
+  color: var(--muted);
+  border: 1px solid var(--line-soft);
+  border-radius: 999px;
+  padding: 1px 6px;
+  margin-right: 6px;
+}
+.shell-notes-hint {
+  font: 0.72rem/1 var(--font-ui);
+  color: var(--muted);
+  margin: 0;
+}
+.shell-notes-add {
+  font: 0.78rem/1 var(--font-ui);
+  align-self: flex-start;
+}
+.shell-notes-actions {
+  display: flex;
+  justify-content: flex-end;
+  margin-top: 12px;
+}
+.shell-notes-btn {
+  font: 0.8rem/1 var(--font-ui);
+  padding: 6px 14px;
+  border-radius: var(--radius-sm);
+  border: 1px solid var(--line);
+  background: var(--card);
+  color: var(--ink);
+  cursor: pointer;
+}
+.shell-notes-btn.primary {
+  background: var(--accent);
+  border-color: var(--accent);
+  color: var(--on-accent, #fff);
+}
+/*# sourceMappingURL=notes-editor.css.map */

package/dist/notes-editor.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/notes-editor.css"],"sourcesContent":["/* The documentation-notes editor (notes-editor.ts): a modal, because notes are\n   prose and the popover Patterpad tried first was too cramped. */\n.shell-notes {\n  width: min(560px, 92vw);\n  border: 1px solid var(--line); border-radius: var(--radius-md);\n  background: var(--surface); color: var(--ink);\n  padding: 16px 18px;\n  box-shadow: var(--shadow-2, var(--shadow-1));\n}\n.shell-notes::backdrop { background: rgba(0, 0, 0, 0.28); }\n.shell-notes-title { font: 600 0.95rem/1.3 var(--font-ui); margin-bottom: 10px; }\n.shell-notes-body { display: flex; flex-direction: column; gap: 10px; max-height: 60vh; overflow-y: auto; }\n.shell-notes-caption {\n  font: 0.72rem/1 var(--font-ui); color: var(--muted);\n  text-transform: uppercase; letter-spacing: 0.04em;\n}\n.shell-notes-class { display: flex; flex-direction: column; gap: 4px; }\n.shell-notes-text {\n  width: 100%; box-sizing: border-box; resize: vertical;\n  border: 1px solid var(--line-soft); border-radius: var(--radius-sm);\n  background: var(--card); color: var(--ink);\n  font: 0.85rem/1.45 var(--font-read, var(--font-ui)); padding: 6px 8px;\n}\n.shell-notes-text:focus { outline: none; border-color: var(--accent); }\n/* Inherited notes read as CONTEXT rather than as fields: no box, no cursor. */\n.shell-notes-inherited {\n  display: flex; flex-direction: column; gap: 6px;\n  padding-bottom: 4px; border-bottom: 1px solid var(--line-soft);\n}\n.shell-notes-level { display: flex; flex-direction: column; gap: 2px; }\n.shell-notes-level-label { font: 0.72rem/1 var(--font-ui); color: var(--muted); }\n.shell-notes-line { font: 0.82rem/1.4 var(--font-read, var(--font-ui)); color: var(--muted); }\n.shell-notes-cls {\n  font: 0.68rem/1 var(--font-ui); color: var(--muted);\n  border: 1px solid var(--line-soft); border-radius: 999px;\n  padding: 1px 6px; margin-right: 6px;\n}\n.shell-notes-hint { font: 0.72rem/1 var(--font-ui); color: var(--muted); margin: 0; }\n.shell-notes-add { font: 0.78rem/1 var(--font-ui); align-self: flex-start; }\n.shell-notes-actions { display: flex; justify-content: flex-end; margin-top: 12px; }\n.shell-notes-btn {\n  font: 0.8rem/1 var(--font-ui); padding: 6px 14px;\n  border-radius: var(--radius-sm); border: 1px solid var(--line);\n  background: var(--card); color: var(--ink); cursor: pointer;\n}\n.shell-notes-btn.primary { background: var(--accent); border-color: var(--accent); color: var(--on-accent, #fff); }\n"],"mappings":";AAEA,CAAC;AACC,SAAO,IAAI,KAAK,EAAE;AAClB,UAAQ,IAAI,MAAM,IAAI;AAAS,iBAAe,IAAI;AAClD,cAAY,IAAI;AAAY,SAAO,IAAI;AACvC,WAAS,KAAK;AACd,cAAY,IAAI,UAAU,EAAE,IAAI;AAClC;AACA,CAPC,WAOW;AAAa,cAAY,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;AAAO;AAC1D,CAAC;AAAoB,QAAM,IAAI,OAAO,CAAC,IAAI,IAAI;AAAY,iBAAe;AAAM;AAChF,CAAC;AAAmB,WAAS;AAAM,kBAAgB;AAAQ,OAAK;AAAM,cAAY;AAAM,cAAY;AAAM;AAC1G,CAAC;AACC,QAAM,OAAO,CAAC,EAAE,IAAI;AAAY,SAAO,IAAI;AAC3C,kBAAgB;AAAW,kBAAgB;AAC7C;AACA,CAAC;AAAoB,WAAS;AAAM,kBAAgB;AAAQ,OAAK;AAAK;AACtE,CAAC;AACC,SAAO;AAAM,cAAY;AAAY,UAAQ;AAC7C,UAAQ,IAAI,MAAM,IAAI;AAAc,iBAAe,IAAI;AACvD,cAAY,IAAI;AAAS,SAAO,IAAI;AACpC,QAAM,OAAO,CAAC,KAAK,IAAI,WAAW,EAAE,IAAI;AAAa,WAAS,IAAI;AACpE;AACA,CANC,gBAMgB;AAAS,WAAS;AAAM,gBAAc,IAAI;AAAW;AAEtE,CAAC;AACC,WAAS;AAAM,kBAAgB;AAAQ,OAAK;AAC5C,kBAAgB;AAAK,iBAAe,IAAI,MAAM,IAAI;AACpD;AACA,CAAC;AAAoB,WAAS;AAAM,kBAAgB;AAAQ,OAAK;AAAK;AACtE,CAAC;AAA0B,QAAM,OAAO,CAAC,EAAE,IAAI;AAAY,SAAO,IAAI;AAAU;AAChF,CAAC;AAAmB,QAAM,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,IAAI;AAAa,SAAO,IAAI;AAAU;AAC7F,CAAC;AACC,QAAM,OAAO,CAAC,EAAE,IAAI;AAAY,SAAO,IAAI;AAC3C,UAAQ,IAAI,MAAM,IAAI;AAAc,iBAAe;AACnD,WAAS,IAAI;AAAK,gBAAc;AAClC;AACA,CAAC;AAAmB,QAAM,OAAO,CAAC,EAAE,IAAI;AAAY,SAAO,IAAI;AAAU,UAAQ;AAAG;AACpF,CAAC;AAAkB,QAAM,OAAO,CAAC,EAAE,IAAI;AAAY,cAAY;AAAY;AAC3E,CAAC;AAAsB,WAAS;AAAM,mBAAiB;AAAU,cAAY;AAAM;AACnF,CAAC;AACC,QAAM,MAAM,CAAC,EAAE,IAAI;AAAY,WAAS,IAAI;AAC5C,iBAAe,IAAI;AAAc,UAAQ,IAAI,MAAM,IAAI;AACvD,cAAY,IAAI;AAAS,SAAO,IAAI;AAAQ,UAAQ;AACtD;AACA,CALC,eAKe,CAAC;AAAU,cAAY,IAAI;AAAW,gBAAc,IAAI;AAAW,SAAO,IAAI,WAAW,EAAE;AAAO;","names":[]}

package/dist/pane-shell.css

@@ -0,0 +1,114 @@
+/* src/pane-shell.css */
+.pane-shell {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+}
+.topbar {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 8px 14px;
+  border-bottom: 1px solid var(--line-soft, var(--line));
+  background: var(--surface);
+}
+.topbar-lead {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+}
+.topbar-spacer {
+  flex: 1;
+}
+.topbar-trail {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+}
+.pane-toggle {
+  color: var(--muted);
+  font: inherit;
+  font-size: 0.95rem;
+  background: none;
+  border: 0;
+  border-radius: var(--radius-sm);
+  padding: 2px 8px;
+  cursor: pointer;
+}
+.pane-toggle:hover {
+  color: var(--accent);
+}
+.panes {
+  --nav-open-w: 14rem;
+  --insp-open-w: 22rem;
+  --nav-w: var(--nav-open-w);
+  --insp-w: var(--insp-open-w);
+  position: relative;
+  flex: 1;
+  min-height: 0;
+  display: grid;
+  grid-template-columns: var(--nav-w) minmax(0, 1fr) var(--insp-w);
+  transition: grid-template-columns var(--dur-panel) var(--ease-standard);
+}
+.panes.no-nav {
+  --nav-w: 0px;
+}
+.panes.no-inspector {
+  --insp-w: 0px;
+}
+.pane {
+  overflow: hidden;
+  min-height: 0;
+}
+.pane-inner {
+  height: 100%;
+  overflow: auto;
+}
+.pane-nav .pane-inner {
+  width: var(--nav-open-w);
+}
+.pane-inspector .pane-inner {
+  width: var(--insp-open-w);
+}
+.pane-centre {
+  min-width: 0;
+  min-height: 0;
+  overflow: auto;
+}
+.panes > .pane {
+  transition: opacity var(--dur-panel) var(--ease-standard);
+}
+.panes.no-nav > .pane-nav,
+.panes.no-inspector > .pane-inspector {
+  opacity: 0;
+  pointer-events: none;
+}
+.pane-resizer {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  width: 7px;
+  z-index: 6;
+  cursor: col-resize;
+  touch-action: none;
+}
+.pane-resizer-nav {
+  left: calc(var(--nav-w) - 3px);
+}
+.pane-resizer-insp {
+  right: calc(var(--insp-w) - 3px);
+}
+.panes.no-nav .pane-resizer-nav,
+.panes.no-inspector .pane-resizer-insp {
+  display: none;
+}
+body.pane-resizing {
+  cursor: col-resize;
+  user-select: none;
+}
+body.pane-resizing .panes {
+  transition: none;
+}
+/*# sourceMappingURL=pane-shell.css.map */

package/dist/pane-shell.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pane-shell.css"],"sourcesContent":["/* ============================================================================\n   The pane-shell frame: top bar + nav | centre | inspector grid with collapse\n   and drag-resize. Reads the shared token grammar (tokens.css) and the app's\n   palette vars (--surface / --ink / --muted / --line / --accent, and an\n   optional --line-soft). App-specifics stay in the host: the window-drag region\n   (-webkit-app-region) and traffic-light padding, if the app is frameless, are\n   applied by the host over .topbar; the host also fills the pane bodies and the\n   top-bar lead/trail slots.\n   ============================================================================ */\n\n.pane-shell { flex: 1; display: flex; flex-direction: column; min-height: 0; }\n\n.topbar {\n  display: flex; align-items: center; gap: 10px;\n  padding: 8px 14px;\n  border-bottom: 1px solid var(--line-soft, var(--line));\n  background: var(--surface);\n}\n.topbar-lead { display: flex; align-items: center; gap: 8px; min-width: 0; }\n.topbar-spacer { flex: 1; }\n.topbar-trail { display: flex; align-items: center; gap: 10px; }\n.pane-toggle {\n  color: var(--muted); font: inherit; font-size: 0.95rem;\n  background: none; border: 0; border-radius: var(--radius-sm); padding: 2px 8px; cursor: pointer;\n}\n.pane-toggle:hover { color: var(--accent); }\n\n.panes {\n  --nav-open-w: 14rem; --insp-open-w: 22rem;\n  --nav-w: var(--nav-open-w); --insp-w: var(--insp-open-w);\n  position: relative; flex: 1; min-height: 0;\n  display: grid; grid-template-columns: var(--nav-w) minmax(0, 1fr) var(--insp-w);\n  transition: grid-template-columns var(--dur-panel) var(--ease-standard);\n}\n.panes.no-nav { --nav-w: 0px; }\n.panes.no-inspector { --insp-w: 0px; }\n\n/* Side panes clip; their inner holds a fixed width so a collapse wipes cleanly\n   rather than reflowing while the column animates to 0. */\n.pane { overflow: hidden; min-height: 0; }\n.pane-inner { height: 100%; overflow: auto; }\n.pane-nav .pane-inner { width: var(--nav-open-w); }\n.pane-inspector .pane-inner { width: var(--insp-open-w); }\n.pane-centre { min-width: 0; min-height: 0; overflow: auto; }\n\n.panes > .pane { transition: opacity var(--dur-panel) var(--ease-standard); }\n.panes.no-nav > .pane-nav, .panes.no-inspector > .pane-inspector { opacity: 0; pointer-events: none; }\n\n/* Drag seams over each side pane's inner edge, tracking the grid columns. */\n.pane-resizer { position: absolute; top: 0; bottom: 0; width: 7px; z-index: 6; cursor: col-resize; touch-action: none; }\n.pane-resizer-nav { left: calc(var(--nav-w) - 3px); }\n.pane-resizer-insp { right: calc(var(--insp-w) - 3px); }\n.panes.no-nav .pane-resizer-nav, .panes.no-inspector .pane-resizer-insp { display: none; }\nbody.pane-resizing { cursor: col-resize; user-select: none; }\nbody.pane-resizing .panes { transition: none; }   /* 1:1 feel: suspend the grid tween mid-drag */\n"],"mappings":";AAUA,CAAC;AAAa,QAAM;AAAG,WAAS;AAAM,kBAAgB;AAAQ,cAAY;AAAG;AAE7E,CAAC;AACC,WAAS;AAAM,eAAa;AAAQ,OAAK;AACzC,WAAS,IAAI;AACb,iBAAe,IAAI,MAAM,IAAI,WAAW,EAAE,IAAI;AAC9C,cAAY,IAAI;AAClB;AACA,CAAC;AAAc,WAAS;AAAM,eAAa;AAAQ,OAAK;AAAK,aAAW;AAAG;AAC3E,CAAC;AAAgB,QAAM;AAAG;AAC1B,CAAC;AAAe,WAAS;AAAM,eAAa;AAAQ,OAAK;AAAM;AAC/D,CAAC;AACC,SAAO,IAAI;AAAU,QAAM;AAAS,aAAW;AAC/C,cAAY;AAAM,UAAQ;AAAG,iBAAe,IAAI;AAAc,WAAS,IAAI;AAAK,UAAQ;AAC1F;AACA,CAJC,WAIW;AAAS,SAAO,IAAI;AAAW;AAE3C,CAAC;AACC,gBAAc;AAAO,iBAAe;AACpC,WAAS,IAAI;AAAe,YAAU,IAAI;AAC1C,YAAU;AAAU,QAAM;AAAG,cAAY;AACzC,WAAS;AAAM,yBAAuB,IAAI,SAAS,OAAO,CAAC,EAAE,KAAK,IAAI;AACtE,cAAY,sBAAsB,IAAI,aAAa,IAAI;AACzD;AACA,CAPC,KAOK,CAAC;AAAS,WAAS;AAAK;AAC9B,CARC,KAQK,CAAC;AAAe,YAAU;AAAK;AAIrC,CAAC;AAAO,YAAU;AAAQ,cAAY;AAAG;AACzC,CAAC;AAAa,UAAQ;AAAM,YAAU;AAAM;AAC5C,CAAC,SAAS,CADT;AACuB,SAAO,IAAI;AAAe;AAClD,CAAC,eAAe,CAFf;AAE6B,SAAO,IAAI;AAAgB;AACzD,CAAC;AAAc,aAAW;AAAG,cAAY;AAAG,YAAU;AAAM;AAE5D,CAlBC,MAkBM,EAAE,CANR;AAMgB,cAAY,QAAQ,IAAI,aAAa,IAAI;AAAkB;AAC5E,CAnBC,KAmBK,CAZC,OAYO,EAAE,CALf;AAK0B,CAnB1B,KAmBgC,CAX1B,aAWwC,EAAE,CAJhD;AAIkE,WAAS;AAAG,kBAAgB;AAAM;AAGrG,CAAC;AAAe,YAAU;AAAU,OAAK;AAAG,UAAQ;AAAG,SAAO;AAAK,WAAS;AAAG,UAAQ;AAAY,gBAAc;AAAM;AACvH,CAAC;AAAmB,QAAM,KAAK,IAAI,SAAS,EAAE;AAAM;AACpD,CAAC;AAAoB,SAAO,KAAK,IAAI,UAAU,EAAE;AAAM;AACvD,CAzBC,KAyBK,CAlBC,OAkBO,CAFb;AAEgC,CAzBhC,KAyBsC,CAjBhC,aAiB8C,CADpD;AACyE,WAAS;AAAM;AACzF,IAAI,CAAC;AAAgB,UAAQ;AAAY,eAAa;AAAM;AAC5D,IAAI,CADC,cACc,CA3BlB;AA2B2B,cAAY;AAAM;","names":[]}

package/dist/session.cjs

@@ -0,0 +1,52 @@
+'use strict';
+
+var path = require('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$1) {
+      const s = opts.store.get();
+      const known = new Set(
+        [s.lastProject, ...s.recents].filter((p) => typeof p === "string" && p !== "").map((p) => path.resolve(p))
+      );
+      return known.has(path.resolve(path$1));
+    },
+    addSatellite(satellite) {
+      satellites.push(satellite);
+      return () => {
+        const i = satellites.indexOf(satellite);
+        if (i >= 0) satellites.splice(i, 1);
+      };
+    },
+    invalidateSatellites
+  };
+}
+
+exports.createProjectSession = createProjectSession;
+//# sourceMappingURL=session.cjs.map
+//# sourceMappingURL=session.cjs.map

package/dist/session.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session.ts"],"names":["path","resolve"],"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,YAAYA,MAAA,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,KAAMC,YAAA,CAAQ,CAAC,CAAC;AAAA,OACnH;AACA,MAAA,OAAO,KAAA,CAAM,GAAA,CAAIA,YAAA,CAAQD,MAAI,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.cjs","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/session.d.cts

@@ -0,0 +1,79 @@
+/** As much of a BrowserWindow as this file has any business knowing. */
+interface SatelliteWindow {
+    isDestroyed(): boolean;
+    webContents: {
+        send(channel: string, ...args: unknown[]): void;
+    };
+}
+/**
+ * A tool window that shows something about the open project, and any state
+ * main is holding on its behalf.
+ */
+interface Satellite {
+    /** Looked up each time rather than held: these windows open and close. */
+    window: () => SatelliteWindow | undefined | null;
+    /** What to send when the project changes. The window re-fetches; it is a
+     *  nudge, not a payload, because by then the new project is already open. */
+    channel: string;
+    /** Drop what main was caching for the old project - a coverage report, a
+     *  search anchor. Called before the window is told. */
+    clear?: () => void;
+}
+/** The slice of the app store this needs. Structural, so the real store fits
+ *  without dragging its generic parameters in here. */
+interface SessionStore {
+    get(): {
+        recents: string[];
+        lastProject?: string;
+    };
+    touchProject(path: string): void;
+    forgetProject(path: string): void;
+}
+interface ProjectSessionOptions<S, R> {
+    store: SessionStore;
+    /**
+     * Open it. The one app-specific step.
+     *
+     * `root` is what gets recorded, and it is not always the path asked for: a
+     * file-association launch names a shard INSIDE a project, and it is the
+     * project that belongs in recents. `reply` is whatever the app sends back to
+     * its renderer - this never looks inside it.
+     */
+    open: (path: string) => {
+        session: S;
+        root: string;
+        reply: R;
+    } | {
+        error: string;
+    };
+    /**
+     * The outgoing session is finished with: sweep its temporary files, close its
+     * handles. Called only once the replacement has opened successfully, so a
+     * failed open leaves the current project entirely alone.
+     */
+    close?: (session: S) => void;
+    /** Rebuild the application menu. Called after a change either way, because a
+     *  failed open changes recents too. */
+    refreshMenu?: () => void;
+    satellites?: Satellite[];
+}
+interface ProjectSession<S, R> {
+    /** The open project, or undefined before the first one. */
+    current: () => S | undefined;
+    /** Open, with everything in the comment above. */
+    openAt: (path: string) => R | {
+        error: string;
+    };
+    /** May the renderer ask for this path? See the note above: only paths the app
+     *  already knows, because a native dialog put them there. */
+    isKnownPath: (path: string) => boolean;
+    /** Register a tool window after construction, which is when they usually
+     *  appear. Returns a function that unregisters it. */
+    addSatellite: (satellite: Satellite) => () => void;
+    /** Fire every satellite by hand. For the cases that are not an open but do
+     *  invalidate the same things - a merge landing new content underneath. */
+    invalidateSatellites: () => void;
+}
+declare function createProjectSession<S, R>(opts: ProjectSessionOptions<S, R>): ProjectSession<S, R>;
+
+export { type ProjectSession, type ProjectSessionOptions, type Satellite, type SatelliteWindow, type SessionStore, createProjectSession };

package/dist/session.d.ts

@@ -0,0 +1,79 @@
+/** As much of a BrowserWindow as this file has any business knowing. */
+interface SatelliteWindow {
+    isDestroyed(): boolean;
+    webContents: {
+        send(channel: string, ...args: unknown[]): void;
+    };
+}
+/**
+ * A tool window that shows something about the open project, and any state
+ * main is holding on its behalf.
+ */
+interface Satellite {
+    /** Looked up each time rather than held: these windows open and close. */
+    window: () => SatelliteWindow | undefined | null;
+    /** What to send when the project changes. The window re-fetches; it is a
+     *  nudge, not a payload, because by then the new project is already open. */
+    channel: string;
+    /** Drop what main was caching for the old project - a coverage report, a
+     *  search anchor. Called before the window is told. */
+    clear?: () => void;
+}
+/** The slice of the app store this needs. Structural, so the real store fits
+ *  without dragging its generic parameters in here. */
+interface SessionStore {
+    get(): {
+        recents: string[];
+        lastProject?: string;
+    };
+    touchProject(path: string): void;
+    forgetProject(path: string): void;
+}
+interface ProjectSessionOptions<S, R> {
+    store: SessionStore;
+    /**
+     * Open it. The one app-specific step.
+     *
+     * `root` is what gets recorded, and it is not always the path asked for: a
+     * file-association launch names a shard INSIDE a project, and it is the
+     * project that belongs in recents. `reply` is whatever the app sends back to
+     * its renderer - this never looks inside it.
+     */
+    open: (path: string) => {
+        session: S;
+        root: string;
+        reply: R;
+    } | {
+        error: string;
+    };
+    /**
+     * The outgoing session is finished with: sweep its temporary files, close its
+     * handles. Called only once the replacement has opened successfully, so a
+     * failed open leaves the current project entirely alone.
+     */
+    close?: (session: S) => void;
+    /** Rebuild the application menu. Called after a change either way, because a
+     *  failed open changes recents too. */
+    refreshMenu?: () => void;
+    satellites?: Satellite[];
+}
+interface ProjectSession<S, R> {
+    /** The open project, or undefined before the first one. */
+    current: () => S | undefined;
+    /** Open, with everything in the comment above. */
+    openAt: (path: string) => R | {
+        error: string;
+    };
+    /** May the renderer ask for this path? See the note above: only paths the app
+     *  already knows, because a native dialog put them there. */
+    isKnownPath: (path: string) => boolean;
+    /** Register a tool window after construction, which is when they usually
+     *  appear. Returns a function that unregisters it. */
+    addSatellite: (satellite: Satellite) => () => void;
+    /** Fire every satellite by hand. For the cases that are not an open but do
+     *  invalidate the same things - a merge landing new content underneath. */
+    invalidateSatellites: () => void;
+}
+declare function createProjectSession<S, R>(opts: ProjectSessionOptions<S, R>): ProjectSession<S, R>;
+
+export { type ProjectSession, type ProjectSessionOptions, type Satellite, type SatelliteWindow, type SessionStore, createProjectSession };