@wildwinter/app-shell 0.38.0 → 0.40.0

package/dist/link-status.css

@@ -0,0 +1,76 @@
+/* src/link-status.css */
+.linkstatus {
+  position: fixed;
+  right: 14.5px;
+  bottom: 5px;
+  z-index: 40;
+  display: inline-flex;
+  align-items: center;
+  gap: 6.5px;
+}
+.linkstatus[hidden] {
+  display: none;
+}
+.linkstatus-word {
+  font: 11px var(--font-ui);
+  color: var(--muted);
+  user-select: none;
+}
+.linkstatus-url {
+  font: 11.5px var(--font-mono);
+  color: var(--muted);
+  background: var(--surface);
+  border: 1px solid var(--line);
+  border-radius: var(--radius-sm);
+  padding: 2px 7px;
+  cursor: pointer;
+  transition: color var(--dur-quick) var(--ease-standard), border-color var(--dur-quick) var(--ease-standard);
+}
+.linkstatus-url:hover {
+  border-color: var(--accent);
+  color: var(--accent);
+}
+.linkstatus-url.copied {
+  color: var(--accent);
+  border-color: var(--accent);
+}
+.linkstatus-url[hidden] {
+  display: none;
+}
+.linkstatus-toggle {
+  flex: none;
+  width: 22.5px;
+  height: 22.5px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0;
+  border: 1px solid var(--line);
+  border-radius: var(--radius-sm);
+  background: var(--surface);
+  color: var(--muted);
+  cursor: pointer;
+  transition: color var(--dur-quick) var(--ease-standard), border-color var(--dur-quick) var(--ease-standard);
+}
+.linkstatus-toggle:hover {
+  border-color: var(--accent);
+}
+.linkstatus-toggle svg {
+  display: block;
+}
+.linkstatus-toggle.listening {
+  color: var(--warn);
+  border-color: var(--warn);
+  background: color-mix(in oklab, var(--warn) 12%, var(--surface));
+}
+.linkstatus-toggle.live {
+  color: var(--ok);
+  border-color: var(--ok);
+  background: color-mix(in oklab, var(--ok) 14%, var(--surface));
+}
+.linkstatus-toggle.stale {
+  color: var(--danger);
+  border-color: var(--danger);
+  background: color-mix(in oklab, var(--danger) 12%, var(--surface));
+}
+/*# sourceMappingURL=link-status.css.map */

package/dist/link-status.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/link-status.css"],"sourcesContent":["/* ---------------------------------------------------------------------------\n   The live-link status chip (link-status.ts): the bottom-right plug, its\n   four states, and the copiable address. Consumes the host palette\n   (--surface / --ink / --muted / --line / --accent / --warn / --ok /\n   --danger / --font-ui / --font-mono) over the shared tokens.\n   --------------------------------------------------------------------------- */\n\n.linkstatus { position: fixed; right: 14.5px; bottom: 5px; z-index: 40; display: inline-flex; align-items: center; gap: 6.5px; }\n.linkstatus[hidden] { display: none; }\n.linkstatus-word { font: 11px var(--font-ui); color: var(--muted); user-select: none; }\n\n.linkstatus-url {\n  font: 11.5px var(--font-mono); color: var(--muted); background: var(--surface);\n  border: 1px solid var(--line); border-radius: var(--radius-sm); padding: 2px 7px; cursor: pointer;\n  transition: color var(--dur-quick) var(--ease-standard), border-color var(--dur-quick) var(--ease-standard);\n}\n.linkstatus-url:hover { border-color: var(--accent); color: var(--accent); }\n/* Lit for a moment after a copy (copyWithFeedback). */\n.linkstatus-url.copied { color: var(--accent); border-color: var(--accent); }\n.linkstatus-url[hidden] { display: none; }\n\n.linkstatus-toggle {\n  flex: none; width: 22.5px; height: 22.5px; display: inline-flex; align-items: center; justify-content: center;\n  padding: 0; border: 1px solid var(--line); border-radius: var(--radius-sm); background: var(--surface);\n  color: var(--muted); cursor: pointer;\n  transition: color var(--dur-quick) var(--ease-standard), border-color var(--dur-quick) var(--ease-standard);\n}\n.linkstatus-toggle:hover { border-color: var(--accent); }\n.linkstatus-toggle svg { display: block; }\n/* The four states. */\n.linkstatus-toggle.listening { color: var(--warn); border-color: var(--warn); background: color-mix(in oklab, var(--warn) 12%, var(--surface)); }\n.linkstatus-toggle.live { color: var(--ok); border-color: var(--ok); background: color-mix(in oklab, var(--ok) 14%, var(--surface)); }\n.linkstatus-toggle.stale { color: var(--danger); border-color: var(--danger); background: color-mix(in oklab, var(--danger) 12%, var(--surface)); }\n"],"mappings":";AAOA,CAAC;AAAa,YAAU;AAAO,SAAO;AAAQ,UAAQ;AAAK,WAAS;AAAI,WAAS;AAAa,eAAa;AAAQ,OAAK;AAAO;AAC/H,CADC,UACU,CAAC;AAAU,WAAS;AAAM;AACrC,CAAC;AAAkB,QAAM,KAAK,IAAI;AAAY,SAAO,IAAI;AAAU,eAAa;AAAM;AAEtF,CAAC;AACC,QAAM,OAAO,IAAI;AAAc,SAAO,IAAI;AAAU,cAAY,IAAI;AACpE,UAAQ,IAAI,MAAM,IAAI;AAAS,iBAAe,IAAI;AAAc,WAAS,IAAI;AAAK,UAAQ;AAC1F,cAAY,MAAM,IAAI,aAAa,IAAI,gBAAgB,EAAE,aAAa,IAAI,aAAa,IAAI;AAC7F;AACA,CALC,cAKc;AAAS,gBAAc,IAAI;AAAW,SAAO,IAAI;AAAW;AAE3E,CAPC,cAOc,CAAC;AAAS,SAAO,IAAI;AAAW,gBAAc,IAAI;AAAW;AAC5E,CARC,cAQc,CAAC;AAAU,WAAS;AAAM;AAEzC,CAAC;AACC,QAAM;AAAM,SAAO;AAAQ,UAAQ;AAAQ,WAAS;AAAa,eAAa;AAAQ,mBAAiB;AACvG,WAAS;AAAG,UAAQ,IAAI,MAAM,IAAI;AAAS,iBAAe,IAAI;AAAc,cAAY,IAAI;AAC5F,SAAO,IAAI;AAAU,UAAQ;AAC7B,cAAY,MAAM,IAAI,aAAa,IAAI,gBAAgB,EAAE,aAAa,IAAI,aAAa,IAAI;AAC7F;AACA,CANC,iBAMiB;AAAS,gBAAc,IAAI;AAAW;AACxD,CAPC,kBAOkB;AAAM,WAAS;AAAO;AAEzC,CATC,iBASiB,CAAC;AAAY,SAAO,IAAI;AAAS,gBAAc,IAAI;AAAS,cAAY,UAAU,GAAG,KAAK,EAAE,IAAI,QAAQ,GAAG,EAAE,IAAI;AAAa;AAChJ,CAVC,iBAUiB,CAAC;AAAO,SAAO,IAAI;AAAO,gBAAc,IAAI;AAAO,cAAY,UAAU,GAAG,KAAK,EAAE,IAAI,MAAM,GAAG,EAAE,IAAI;AAAa;AACrI,CAXC,iBAWiB,CAAC;AAAQ,SAAO,IAAI;AAAW,gBAAc,IAAI;AAAW,cAAY,UAAU,GAAG,KAAK,EAAE,IAAI,UAAU,GAAG,EAAE,IAAI;AAAa;","names":[]}

package/dist/link-status.d.cts

@@ -0,0 +1,53 @@
+type LinkStatus = {
+    state: "off";
+} | {
+    state: "error";
+    message: string;
+} | {
+    state: "listening";
+    port: number;
+    address?: string;
+} | {
+    state: "connected";
+    port: number;
+    address?: string;
+    /** What connected, if it said. */
+    project?: string;
+    /** Whether the game's build matches the editor's. */
+    build?: "match" | "stale" | "unknown";
+    /** One extra sentence for the tip (Storyletter names the live boxes). */
+    note?: string;
+};
+/** The chip's colour class for a state: the four. */
+type LinkStatusClass = "off" | "listening" | "live" | "stale";
+interface LinkStatusOptions {
+    /** A word beside the chip ("Live link"), so a bottom-corner plug is not a
+     *  mystery. Omitted draws none. */
+    label?: string;
+    /** Start when off or failed, stop otherwise. A returned status is applied;
+     *  a status pushed later through `apply` works as well. */
+    onToggle: (current: LinkStatus) => LinkStatus | void | Promise<LinkStatus | void>;
+    /** Runs after the address is copied. The copy itself is the chip's. */
+    onCopy?: (address: string) => void;
+    /** Controls before the address (Patterpad's flow picker). */
+    lead?: HTMLElement[];
+}
+interface LinkStatusChip {
+    el: HTMLElement;
+    apply(status: LinkStatus): void;
+    status(): LinkStatus;
+    /** Show / hide the control (shown when a project is open). */
+    setVisible(on: boolean): void;
+    /** Toggle the link (a menu item routes here). */
+    toggle(): void;
+}
+declare function linkStatusClass(s: LinkStatus): LinkStatusClass;
+/** The tooltip, spelling the state out. One wording for the family. */
+declare function linkStatusTip(s: LinkStatus): string;
+/** The address a game connects to. */
+declare function linkAddress(s: LinkStatus): string | undefined;
+/** Mount the chip into `host` (document.body in both apps: it is fixed to the
+ *  window's corner). Hidden until `setVisible(true)`. */
+declare function mountLinkStatus(host: HTMLElement, opts: LinkStatusOptions): LinkStatusChip;
+
+export { type LinkStatus, type LinkStatusChip, type LinkStatusClass, type LinkStatusOptions, linkAddress, linkStatusClass, linkStatusTip, mountLinkStatus };

package/dist/link-status.d.ts

@@ -0,0 +1,53 @@
+type LinkStatus = {
+    state: "off";
+} | {
+    state: "error";
+    message: string;
+} | {
+    state: "listening";
+    port: number;
+    address?: string;
+} | {
+    state: "connected";
+    port: number;
+    address?: string;
+    /** What connected, if it said. */
+    project?: string;
+    /** Whether the game's build matches the editor's. */
+    build?: "match" | "stale" | "unknown";
+    /** One extra sentence for the tip (Storyletter names the live boxes). */
+    note?: string;
+};
+/** The chip's colour class for a state: the four. */
+type LinkStatusClass = "off" | "listening" | "live" | "stale";
+interface LinkStatusOptions {
+    /** A word beside the chip ("Live link"), so a bottom-corner plug is not a
+     *  mystery. Omitted draws none. */
+    label?: string;
+    /** Start when off or failed, stop otherwise. A returned status is applied;
+     *  a status pushed later through `apply` works as well. */
+    onToggle: (current: LinkStatus) => LinkStatus | void | Promise<LinkStatus | void>;
+    /** Runs after the address is copied. The copy itself is the chip's. */
+    onCopy?: (address: string) => void;
+    /** Controls before the address (Patterpad's flow picker). */
+    lead?: HTMLElement[];
+}
+interface LinkStatusChip {
+    el: HTMLElement;
+    apply(status: LinkStatus): void;
+    status(): LinkStatus;
+    /** Show / hide the control (shown when a project is open). */
+    setVisible(on: boolean): void;
+    /** Toggle the link (a menu item routes here). */
+    toggle(): void;
+}
+declare function linkStatusClass(s: LinkStatus): LinkStatusClass;
+/** The tooltip, spelling the state out. One wording for the family. */
+declare function linkStatusTip(s: LinkStatus): string;
+/** The address a game connects to. */
+declare function linkAddress(s: LinkStatus): string | undefined;
+/** Mount the chip into `host` (document.body in both apps: it is fixed to the
+ *  window's corner). Hidden until `setVisible(true)`. */
+declare function mountLinkStatus(host: HTMLElement, opts: LinkStatusOptions): LinkStatusChip;
+
+export { type LinkStatus, type LinkStatusChip, type LinkStatusClass, type LinkStatusOptions, linkAddress, linkStatusClass, linkStatusTip, mountLinkStatus };

package/dist/link-status.js

@@ -0,0 +1,5 @@
+export { linkAddress, linkStatusClass, linkStatusTip, mountLinkStatus } from './chunk-SDOKZTAR.js';
+import './chunk-P6WLAEKZ.js';
+import './chunk-UG2P777F.js';
+//# sourceMappingURL=link-status.js.map
+//# sourceMappingURL=link-status.js.map

package/dist/link-status.js.map

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

package/dist/menu.cjs

@@ -5,7 +5,8 @@ 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" }
+  find: { label: "Find\u2026", accelerator: "CmdOrCtrl+F" },
+  replace: { label: "Replace\u2026", acceleratorMac: "Cmd+Alt+F", acceleratorOther: "Ctrl+H" }
 };
 var GO_MENU = {
   back: { label: "Back", acceleratorMac: "Ctrl+Cmd+Left", acceleratorOther: "Alt+Left" },
@@ -39,12 +40,72 @@ function namedMenuItems(naming) {
     }
   };
 }
+var FILE_MENU = {
+  newProject: { label: "New Project\u2026", accelerator: "CmdOrCtrl+N" },
+  openProject: { label: "Open Project\u2026", accelerator: "CmdOrCtrl+O" },
+  openRecent: { label: "Open Recent" },
+  noRecents: { label: "No Recent Projects" },
+  clearRecents: { label: "Clear Recents" },
+  closeProject: { label: "Close Project" },
+  save: { label: "Save", accelerator: "CmdOrCtrl+S" },
+  saveAs: { label: "Save As\u2026", accelerator: "Shift+CmdOrCtrl+S" },
+  projectSettings: { label: "Project Settings\u2026", accelerator: "CmdOrCtrl+," }
+};
+var PLAY_MENU = {
+  liveLink: { label: "Live Link" }
+};
+var REVIEW_MENU = {
+  reviewFeedback: { label: "Review Feedback", accelerator: "CmdOrCtrl+Shift+R" },
+  nextFeedback: { label: "Next Feedback", accelerator: "F8" },
+  previousFeedback: { label: "Previous Feedback", accelerator: "Shift+F8" },
+  coverageTest: { label: "Coverage Test\u2026", accelerator: "Shift+CmdOrCtrl+C" },
+  findPropertyUsage: { label: "Find Property Usage\u2026" },
+  showResolvedComments: { label: "Show Resolved Comments" }
+};
+var PUBLISH_MENU = {
+  playableHtml: { label: "Publish Playable HTML\u2026" },
+  bundle: { label: "Publish Bundle", accelerator: "Shift+CmdOrCtrl+B" },
+  autoRebuild: { label: "Auto Rebuild" }
+};
+var VIEW_MENU = {
+  projectOverview: { label: "Project Overview" },
+  upALevel: { label: "Up a Level", accelerator: "CmdOrCtrl+[" },
+  colourTheme: { label: "Colour Theme" }
+};
+function tildePath(path, home) {
+  if (path === home) return "~";
+  const sep = home.includes("\\") ? "\\" : "/";
+  return path.startsWith(home + sep) ? `~${path.slice(home.length)}` : path;
+}
+function recentsSubmenu(recents, opts) {
+  const isMac = (opts.platform ?? process.platform) === "darwin";
+  if (recents.length === 0) return [{ label: FILE_MENU.noRecents.label, enabled: false }];
+  const items = recents.map((r) => {
+    const shown = tildePath(r.path, opts.home);
+    const name = r.name ?? r.path.split(/[\\/]/).filter(Boolean).pop() ?? r.path;
+    return {
+      label: isMac ? name : `${name}  (${shown})`,
+      sublabel: shown,
+      toolTip: r.path,
+      click: () => opts.onOpen(r.path)
+    };
+  });
+  if (opts.onClear) items.push({ type: "separator" }, { label: FILE_MENU.clearRecents.label, click: opts.onClear });
+  return items;
+}
 
 exports.APP_MENU = APP_MENU;
 exports.EDIT_MENU = EDIT_MENU;
+exports.FILE_MENU = FILE_MENU;
 exports.GO_MENU = GO_MENU;
 exports.HELP_MENU = HELP_MENU;
 exports.PANE_MENU = PANE_MENU;
+exports.PLAY_MENU = PLAY_MENU;
+exports.PUBLISH_MENU = PUBLISH_MENU;
+exports.REVIEW_MENU = REVIEW_MENU;
+exports.VIEW_MENU = VIEW_MENU;
 exports.namedMenuItems = namedMenuItems;
+exports.recentsSubmenu = recentsSubmenu;
+exports.tildePath = tildePath;
 //# sourceMappingURL=menu.cjs.map
 //# sourceMappingURL=menu.cjs.map

package/dist/menu.cjs.map

@@ -1 +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;AASO,IAAM,OAAA,GAGT;AAAA,EACF,MAAM,EAAE,KAAA,EAAO,QAAQ,cAAA,EAAgB,eAAA,EAAiB,kBAAkB,UAAA,EAAW;AAAA,EACrF,SAAS,EAAE,KAAA,EAAO,WAAW,cAAA,EAAgB,gBAAA,EAAkB,kBAAkB,WAAA;AACnF;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;AAkBO,IAAM,SAAA,GAET;AAAA,EACF,eAAA,EAAiB,EAAE,KAAA,EAAO,yBAAA;AAC5B;AAGO,IAAM,QAAA,GAET;AAAA;AAAA,EAEF,QAAA,EAAU,EAAE,KAAA,EAAO,wBAAA;AACrB;AA+BO,SAAS,eAAe,MAAA,EAI7B;AACA,EAAA,MAAM,KAAA,GAAQ,OAAO,SAAA,IAAa,QAAA;AAClC,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,EAAE,KAAA,EAAO,CAAA,MAAA,EAAS,OAAO,OAAO,CAAA,CAAA,EAAI,OAAO,IAAA,EAAK;AAAA,IACvD,IAAA,EAAM;AAAA,MACJ,KAAA,EAAO,CAAA,EAAG,MAAA,CAAO,OAAO,CAAA,cAAA,CAAA;AAAA,MACxB,GAAI,OAAO,OAAA,GAAU,EAAE,KAAK,MAAA,CAAO,OAAA,KAAY,EAAC;AAAA,MAChD,KAAA,EAAO,OAAO,OAAA,KAAY;AAAA,KAC5B;AAAA,IACA,SAAA,EAAW;AAAA,MACT,KAAA,EAAO,GAAG,KAAK,CAAA,mBAAA,CAAA;AAAA,MACf,GAAI,OAAO,YAAA,GAAe,EAAE,KAAK,MAAA,CAAO,YAAA,KAAiB,EAAC;AAAA,MAC1D,KAAA,EAAO,OAAO,YAAA,KAAiB;AAAA;AACjC,GACF;AACF","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/**\n * Back / Forward: navigation HISTORY, the other axis from Up a Level's\n * hierarchy. One string cannot serve both platforms - the mac pair is Xcode's\n * (Cmd+[ is already Up a Level in this family, so the browser pair is taken),\n * and the Alt pair is what every Windows browser and Explorer trained - so the\n * menu builder picks by platform.\n */\nexport const GO_MENU: {\n  back: { label: string; acceleratorMac: string; acceleratorOther: string };\n  forward: { label: string; acceleratorMac: string; acceleratorOther: string };\n} = {\n  back: { label: \"Back\", acceleratorMac: \"Ctrl+Cmd+Left\", acceleratorOther: \"Alt+Left\" },\n  forward: { label: \"Forward\", acceleratorMac: \"Ctrl+Cmd+Right\", acceleratorOther: \"Alt+Right\" },\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\n/**\n * The Help menu items the family shares, and the one platform rule that goes\n * with them.\n *\n * Lifted from Patterpad, which is the only app that has ever had these: a\n * second app writing its own updater or About is pure waste (`design/\n * shared-shell.md`), and a suite is recognised by finding Check for Updates\n * where you left it. Storyletter will grow both; until it does, these labels\n * are the agreement rather than a description of two implementations.\n *\n * PLACEMENT, which differs by platform and is easy to get wrong:\n * - macOS keeps About in the APP menu (the one named after the product), and\n *   Help carries documentation + Check for Updates only.\n * - Windows and Linux have no app menu, so About goes at the foot of Help,\n *   after a separator. That is the conventional home there.\n */\nexport const HELP_MENU: {\n  checkForUpdates: MenuLabel;\n} = {\n  checkForUpdates: { label: \"Check for Updates\\u2026\" },\n};\n\n/** The app-menu items the family shares (macOS; the identity item also belongs in File elsewhere). */\nexport const APP_MENU: {\n  userInfo: MenuLabel;\n} = {\n  /** Name + optional email, used to sign edits and comments. One label across the suite. */\n  userInfo: { label: \"User Information\\u2026\" },\n};\n\n/** What an app must tell the shell to build its named menu items. */\nexport interface MenuNaming {\n  /** The product, as it appears in menus: \"Patterpad\", \"Storyletter\". */\n  appName: string;\n  /** The product's own documentation URL. Omit while an app has no docs yet and\n   *  the item is rendered disabled rather than opening a broken link. */\n  docsUrl?: string;\n  /** The suite's documentation home, shared by every app in the family. */\n  suiteDocsUrl?: string;\n  /** The suite, as it appears in \"<suite> Documentation Home\". Defaults to \"Patter\". */\n  suiteName?: string;\n}\n\n/** A named menu item: the label, plus the URL it opens (absent = nothing wired yet). */\nexport interface NamedMenuItem extends MenuLabel {\n  url?: string;\n  /** False when the app has not supplied a URL, so the builder can render it\n   *  disabled instead of opening nothing. A placeholder, honestly labelled. */\n  ready: boolean;\n}\n\n/**\n * The menu labels that carry a product or suite name, so no app spells its own\n * About or Documentation item differently from the rest of the family.\n *\n * An app with no documentation site yet still gets the ITEM, marked\n * `ready: false`, so the menu has its family shape from day one and wiring the\n * URL later is a one-line change rather than a menu redesign.\n */\nexport function namedMenuItems(naming: MenuNaming): {\n  about: NamedMenuItem;\n  docs: NamedMenuItem;\n  suiteDocs: NamedMenuItem;\n} {\n  const suite = naming.suiteName ?? \"Patter\";\n  return {\n    about: { label: `About ${naming.appName}`, ready: true },\n    docs: {\n      label: `${naming.appName} Documentation`,\n      ...(naming.docsUrl ? { url: naming.docsUrl } : {}),\n      ready: naming.docsUrl !== undefined,\n    },\n    suiteDocs: {\n      label: `${suite} Documentation Home`,\n      ...(naming.suiteDocsUrl ? { url: naming.suiteDocsUrl } : {}),\n      ready: naming.suiteDocsUrl !== undefined,\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../src/menu.ts"],"names":[],"mappings":"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","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\nimport type { RecentProject } from \"./app-store.js\";\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  /** Replace is Find's second tab, on the platform's key for it. */\n  replace: { label: string; acceleratorMac: string; acceleratorOther: string };\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  replace: { label: \"Replace…\", acceleratorMac: \"Cmd+Alt+F\", acceleratorOther: \"Ctrl+H\" },\n};\n\n/**\n * Back / Forward: navigation HISTORY, the other axis from Up a Level's\n * hierarchy. One string cannot serve both platforms - the mac pair is Xcode's\n * (Cmd+[ is already Up a Level in this family, so the browser pair is taken),\n * and the Alt pair is what every Windows browser and Explorer trained - so the\n * menu builder picks by platform.\n */\nexport const GO_MENU: {\n  back: { label: string; acceleratorMac: string; acceleratorOther: string };\n  forward: { label: string; acceleratorMac: string; acceleratorOther: string };\n} = {\n  back: { label: \"Back\", acceleratorMac: \"Ctrl+Cmd+Left\", acceleratorOther: \"Alt+Left\" },\n  forward: { label: \"Forward\", acceleratorMac: \"Ctrl+Cmd+Right\", acceleratorOther: \"Alt+Right\" },\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\n/**\n * The Help menu items the family shares, and the one platform rule that goes\n * with them.\n *\n * Lifted from Patterpad, which is the only app that has ever had these: a\n * second app writing its own updater or About is pure waste (`design/\n * shared-shell.md`), and a suite is recognised by finding Check for Updates\n * where you left it. Storyletter will grow both; until it does, these labels\n * are the agreement rather than a description of two implementations.\n *\n * PLACEMENT, which differs by platform and is easy to get wrong:\n * - macOS keeps About in the APP menu (the one named after the product), and\n *   Help carries documentation + Check for Updates only.\n * - Windows and Linux have no app menu, so About goes at the foot of Help,\n *   after a separator. That is the conventional home there.\n */\nexport const HELP_MENU: {\n  checkForUpdates: MenuLabel;\n} = {\n  checkForUpdates: { label: \"Check for Updates\\u2026\" },\n};\n\n/** The app-menu items the family shares (macOS; the identity item also belongs in File elsewhere). */\nexport const APP_MENU: {\n  userInfo: MenuLabel;\n} = {\n  /** Name + optional email, used to sign edits and comments. One label across the suite. */\n  userInfo: { label: \"User Information\\u2026\" },\n};\n\n/** What an app must tell the shell to build its named menu items. */\nexport interface MenuNaming {\n  /** The product, as it appears in menus: \"Patterpad\", \"Storyletter\". */\n  appName: string;\n  /** The product's own documentation URL. Omit while an app has no docs yet and\n   *  the item is rendered disabled rather than opening a broken link. */\n  docsUrl?: string;\n  /** The suite's documentation home, shared by every app in the family. */\n  suiteDocsUrl?: string;\n  /** The suite, as it appears in \"<suite> Documentation Home\". Defaults to \"Patter\". */\n  suiteName?: string;\n}\n\n/** A named menu item: the label, plus the URL it opens (absent = nothing wired yet). */\nexport interface NamedMenuItem extends MenuLabel {\n  url?: string;\n  /** False when the app has not supplied a URL, so the builder can render it\n   *  disabled instead of opening nothing. A placeholder, honestly labelled. */\n  ready: boolean;\n}\n\n/**\n * The menu labels that carry a product or suite name, so no app spells its own\n * About or Documentation item differently from the rest of the family.\n *\n * An app with no documentation site yet still gets the ITEM, marked\n * `ready: false`, so the menu has its family shape from day one and wiring the\n * URL later is a one-line change rather than a menu redesign.\n */\nexport function namedMenuItems(naming: MenuNaming): {\n  about: NamedMenuItem;\n  docs: NamedMenuItem;\n  suiteDocs: NamedMenuItem;\n} {\n  const suite = naming.suiteName ?? \"Patter\";\n  return {\n    about: { label: `About ${naming.appName}`, ready: true },\n    docs: {\n      label: `${naming.appName} Documentation`,\n      ...(naming.docsUrl ? { url: naming.docsUrl } : {}),\n      ready: naming.docsUrl !== undefined,\n    },\n    suiteDocs: {\n      label: `${suite} Documentation Home`,\n      ...(naming.suiteDocsUrl ? { url: naming.suiteDocsUrl } : {}),\n      ready: naming.suiteDocsUrl !== undefined,\n    },\n  };\n}\n\n// --- the rest of the spine (ui-review-2026-09, finding 12) -----------------------\n// Each app used roughly half of what is above and hand-typed the other half,\n// and the copies had already drifted (Review Feedback's accelerator spelled\n// two ways; \"No Recent Projects\" vs \"No recent projects\"). Labels are Title\n// Case, as the platform's menus are; an item that opens something ends in the\n// command ellipsis.\n\n/** The File menu items the family shares. */\nexport const FILE_MENU: {\n  newProject: MenuLabel;\n  openProject: MenuLabel;\n  openRecent: MenuLabel;\n  /** The empty Open Recent submenu's one disabled item. */\n  noRecents: MenuLabel;\n  clearRecents: MenuLabel;\n  closeProject: MenuLabel;\n  save: MenuLabel;\n  saveAs: MenuLabel;\n  projectSettings: MenuLabel;\n} = {\n  newProject: { label: \"New Project…\", accelerator: \"CmdOrCtrl+N\" },\n  openProject: { label: \"Open Project…\", accelerator: \"CmdOrCtrl+O\" },\n  openRecent: { label: \"Open Recent\" },\n  noRecents: { label: \"No Recent Projects\" },\n  clearRecents: { label: \"Clear Recents\" },\n  closeProject: { label: \"Close Project\" },\n  save: { label: \"Save\", accelerator: \"CmdOrCtrl+S\" },\n  saveAs: { label: \"Save As…\", accelerator: \"Shift+CmdOrCtrl+S\" },\n  projectSettings: { label: \"Project Settings…\", accelerator: \"CmdOrCtrl+,\" },\n};\n\n/**\n * The Play menu's shared item. The play SURFACE itself (Patterpad's \"Play\n * Scene\" on Cmd+P, Storyletter's \"The Board\" on Cmd+T) is app-named and\n * app-keyed on purpose: the two are not the same act, so the family reserves\n * neither key.\n */\nexport const PLAY_MENU: {\n  liveLink: MenuLabel;\n} = {\n  liveLink: { label: \"Live Link\" },\n};\n\n/** The Review menu: examining what you have built rather than building or\n *  playing it. Review Feedback's accelerator is spelled ONCE, here. */\nexport const REVIEW_MENU: {\n  reviewFeedback: MenuLabel;\n  nextFeedback: MenuLabel;\n  previousFeedback: MenuLabel;\n  coverageTest: MenuLabel;\n  findPropertyUsage: MenuLabel;\n  showResolvedComments: MenuLabel;\n} = {\n  reviewFeedback: { label: \"Review Feedback\", accelerator: \"CmdOrCtrl+Shift+R\" },\n  nextFeedback: { label: \"Next Feedback\", accelerator: \"F8\" },\n  previousFeedback: { label: \"Previous Feedback\", accelerator: \"Shift+F8\" },\n  coverageTest: { label: \"Coverage Test…\", accelerator: \"Shift+CmdOrCtrl+C\" },\n  findPropertyUsage: { label: \"Find Property Usage…\" },\n  showResolvedComments: { label: \"Show Resolved Comments\" },\n};\n\n/** The Publish menu: everything that turns the project into something you\n *  hand to others (\"Publish\", never \"Export\"). */\nexport const PUBLISH_MENU: {\n  playableHtml: MenuLabel;\n  bundle: MenuLabel;\n  autoRebuild: MenuLabel;\n} = {\n  playableHtml: { label: \"Publish Playable HTML…\" },\n  bundle: { label: \"Publish Bundle\", accelerator: \"Shift+CmdOrCtrl+B\" },\n  autoRebuild: { label: \"Auto Rebuild\" },\n};\n\n/** The View menu items beyond the pane toggles (PANE_MENU) and history\n *  (GO_MENU). Cmd+[ is family-reserved for Up a Level, which is why Back\n *  takes Xcode's pair on the mac. */\nexport const VIEW_MENU: {\n  projectOverview: MenuLabel;\n  upALevel: MenuLabel;\n  colourTheme: MenuLabel;\n} = {\n  projectOverview: { label: \"Project Overview\" },\n  upALevel: { label: \"Up a Level\", accelerator: \"CmdOrCtrl+[\" },\n  colourTheme: { label: \"Colour Theme\" },\n};\n\n/** A path with the home directory as `~`, so a recents entry stays readable\n *  at menu width. `home` is `app.getPath(\"home\")`; this file stays\n *  electron-free. */\nexport function tildePath(path: string, home: string): string {\n  if (path === home) return \"~\";\n  const sep = home.includes(\"\\\\\") ? \"\\\\\" : \"/\";\n  return path.startsWith(home + sep) ? `~${path.slice(home.length)}` : path;\n}\n\n/** As much of Electron's MenuItemConstructorOptions as a recents entry needs;\n *  structurally assignable to it. */\nexport interface RecentsMenuItem {\n  label?: string;\n  sublabel?: string;\n  toolTip?: string;\n  enabled?: boolean;\n  type?: \"separator\";\n  click?: () => void;\n}\n\nexport interface RecentsSubmenuOptions {\n  onOpen: (path: string) => void;\n  /** Offered after a separator when there is anything to clear. */\n  onClear?: () => void;\n  /** `app.getPath(\"home\")`, for the `~` abbreviation. */\n  home: string;\n  /** Defaults to process.platform; a seam for the tests. */\n  platform?: string;\n}\n\n/**\n * The Open Recent submenu: the fifteen lines both apps had.\n *\n * Shows WHERE each recent lives. macOS renders `sublabel` as a dimmed second\n * line and `toolTip` on hover; native menus elsewhere render neither, so\n * there the path is folded into the label itself. Empty, it is the one\n * disabled \"No Recent Projects\" item.\n */\nexport function recentsSubmenu(recents: RecentProject[], opts: RecentsSubmenuOptions): RecentsMenuItem[] {\n  const isMac = (opts.platform ?? process.platform) === \"darwin\";\n  if (recents.length === 0) return [{ label: FILE_MENU.noRecents.label, enabled: false }];\n  const items: RecentsMenuItem[] = recents.map((r) => {\n    const shown = tildePath(r.path, opts.home);\n    const name = r.name ?? r.path.split(/[\\\\/]/).filter(Boolean).pop() ?? r.path;\n    return {\n      label: isMac ? name : `${name}  (${shown})`,\n      sublabel: shown,\n      toolTip: r.path,\n      click: () => opts.onOpen(r.path),\n    };\n  });\n  if (opts.onClear) items.push({ type: \"separator\" }, { label: FILE_MENU.clearRecents.label, click: opts.onClear });\n  return items;\n}\n"]}

package/dist/menu.d.cts

@@ -1,3 +1,5 @@
+import { RecentProject } from './app-store.cjs';
+
 interface MenuLabel {
     label: string;
     /** Electron accelerator string, when the item has one. */
@@ -21,6 +23,12 @@ declare const EDIT_MENU: {
     redo: MenuLabel;
     duplicate: MenuLabel;
     find: MenuLabel;
+    /** Replace is Find's second tab, on the platform's key for it. */
+    replace: {
+        label: string;
+        acceleratorMac: string;
+        acceleratorOther: string;
+    };
 };
 /**
  * Back / Forward: navigation HISTORY, the other axis from Up a Level's
@@ -102,5 +110,84 @@ declare function namedMenuItems(naming: MenuNaming): {
     docs: NamedMenuItem;
     suiteDocs: NamedMenuItem;
 };
+/** The File menu items the family shares. */
+declare const FILE_MENU: {
+    newProject: MenuLabel;
+    openProject: MenuLabel;
+    openRecent: MenuLabel;
+    /** The empty Open Recent submenu's one disabled item. */
+    noRecents: MenuLabel;
+    clearRecents: MenuLabel;
+    closeProject: MenuLabel;
+    save: MenuLabel;
+    saveAs: MenuLabel;
+    projectSettings: MenuLabel;
+};
+/**
+ * The Play menu's shared item. The play SURFACE itself (Patterpad's "Play
+ * Scene" on Cmd+P, Storyletter's "The Board" on Cmd+T) is app-named and
+ * app-keyed on purpose: the two are not the same act, so the family reserves
+ * neither key.
+ */
+declare const PLAY_MENU: {
+    liveLink: MenuLabel;
+};
+/** The Review menu: examining what you have built rather than building or
+ *  playing it. Review Feedback's accelerator is spelled ONCE, here. */
+declare const REVIEW_MENU: {
+    reviewFeedback: MenuLabel;
+    nextFeedback: MenuLabel;
+    previousFeedback: MenuLabel;
+    coverageTest: MenuLabel;
+    findPropertyUsage: MenuLabel;
+    showResolvedComments: MenuLabel;
+};
+/** The Publish menu: everything that turns the project into something you
+ *  hand to others ("Publish", never "Export"). */
+declare const PUBLISH_MENU: {
+    playableHtml: MenuLabel;
+    bundle: MenuLabel;
+    autoRebuild: MenuLabel;
+};
+/** The View menu items beyond the pane toggles (PANE_MENU) and history
+ *  (GO_MENU). Cmd+[ is family-reserved for Up a Level, which is why Back
+ *  takes Xcode's pair on the mac. */
+declare const VIEW_MENU: {
+    projectOverview: MenuLabel;
+    upALevel: MenuLabel;
+    colourTheme: MenuLabel;
+};
+/** A path with the home directory as `~`, so a recents entry stays readable
+ *  at menu width. `home` is `app.getPath("home")`; this file stays
+ *  electron-free. */
+declare function tildePath(path: string, home: string): string;
+/** As much of Electron's MenuItemConstructorOptions as a recents entry needs;
+ *  structurally assignable to it. */
+interface RecentsMenuItem {
+    label?: string;
+    sublabel?: string;
+    toolTip?: string;
+    enabled?: boolean;
+    type?: "separator";
+    click?: () => void;
+}
+interface RecentsSubmenuOptions {
+    onOpen: (path: string) => void;
+    /** Offered after a separator when there is anything to clear. */
+    onClear?: () => void;
+    /** `app.getPath("home")`, for the `~` abbreviation. */
+    home: string;
+    /** Defaults to process.platform; a seam for the tests. */
+    platform?: string;
+}
+/**
+ * The Open Recent submenu: the fifteen lines both apps had.
+ *
+ * Shows WHERE each recent lives. macOS renders `sublabel` as a dimmed second
+ * line and `toolTip` on hover; native menus elsewhere render neither, so
+ * there the path is folded into the label itself. Empty, it is the one
+ * disabled "No Recent Projects" item.
+ */
+declare function recentsSubmenu(recents: RecentProject[], opts: RecentsSubmenuOptions): RecentsMenuItem[];
 
-export { APP_MENU, EDIT_MENU, GO_MENU, HELP_MENU, type MenuLabel, type MenuNaming, type NamedMenuItem, PANE_MENU, namedMenuItems };
+export { APP_MENU, EDIT_MENU, FILE_MENU, GO_MENU, HELP_MENU, type MenuLabel, type MenuNaming, type NamedMenuItem, PANE_MENU, PLAY_MENU, PUBLISH_MENU, REVIEW_MENU, type RecentsMenuItem, type RecentsSubmenuOptions, VIEW_MENU, namedMenuItems, recentsSubmenu, tildePath };

package/dist/menu.d.ts

@@ -1,3 +1,5 @@
+import { RecentProject } from './app-store.js';
+
 interface MenuLabel {
     label: string;
     /** Electron accelerator string, when the item has one. */
@@ -21,6 +23,12 @@ declare const EDIT_MENU: {
     redo: MenuLabel;
     duplicate: MenuLabel;
     find: MenuLabel;
+    /** Replace is Find's second tab, on the platform's key for it. */
+    replace: {
+        label: string;
+        acceleratorMac: string;
+        acceleratorOther: string;
+    };
 };
 /**
  * Back / Forward: navigation HISTORY, the other axis from Up a Level's
@@ -102,5 +110,84 @@ declare function namedMenuItems(naming: MenuNaming): {
     docs: NamedMenuItem;
     suiteDocs: NamedMenuItem;
 };
+/** The File menu items the family shares. */
+declare const FILE_MENU: {
+    newProject: MenuLabel;
+    openProject: MenuLabel;
+    openRecent: MenuLabel;
+    /** The empty Open Recent submenu's one disabled item. */
+    noRecents: MenuLabel;
+    clearRecents: MenuLabel;
+    closeProject: MenuLabel;
+    save: MenuLabel;
+    saveAs: MenuLabel;
+    projectSettings: MenuLabel;
+};
+/**
+ * The Play menu's shared item. The play SURFACE itself (Patterpad's "Play
+ * Scene" on Cmd+P, Storyletter's "The Board" on Cmd+T) is app-named and
+ * app-keyed on purpose: the two are not the same act, so the family reserves
+ * neither key.
+ */
+declare const PLAY_MENU: {
+    liveLink: MenuLabel;
+};
+/** The Review menu: examining what you have built rather than building or
+ *  playing it. Review Feedback's accelerator is spelled ONCE, here. */
+declare const REVIEW_MENU: {
+    reviewFeedback: MenuLabel;
+    nextFeedback: MenuLabel;
+    previousFeedback: MenuLabel;
+    coverageTest: MenuLabel;
+    findPropertyUsage: MenuLabel;
+    showResolvedComments: MenuLabel;
+};
+/** The Publish menu: everything that turns the project into something you
+ *  hand to others ("Publish", never "Export"). */
+declare const PUBLISH_MENU: {
+    playableHtml: MenuLabel;
+    bundle: MenuLabel;
+    autoRebuild: MenuLabel;
+};
+/** The View menu items beyond the pane toggles (PANE_MENU) and history
+ *  (GO_MENU). Cmd+[ is family-reserved for Up a Level, which is why Back
+ *  takes Xcode's pair on the mac. */
+declare const VIEW_MENU: {
+    projectOverview: MenuLabel;
+    upALevel: MenuLabel;
+    colourTheme: MenuLabel;
+};
+/** A path with the home directory as `~`, so a recents entry stays readable
+ *  at menu width. `home` is `app.getPath("home")`; this file stays
+ *  electron-free. */
+declare function tildePath(path: string, home: string): string;
+/** As much of Electron's MenuItemConstructorOptions as a recents entry needs;
+ *  structurally assignable to it. */
+interface RecentsMenuItem {
+    label?: string;
+    sublabel?: string;
+    toolTip?: string;
+    enabled?: boolean;
+    type?: "separator";
+    click?: () => void;
+}
+interface RecentsSubmenuOptions {
+    onOpen: (path: string) => void;
+    /** Offered after a separator when there is anything to clear. */
+    onClear?: () => void;
+    /** `app.getPath("home")`, for the `~` abbreviation. */
+    home: string;
+    /** Defaults to process.platform; a seam for the tests. */
+    platform?: string;
+}
+/**
+ * The Open Recent submenu: the fifteen lines both apps had.
+ *
+ * Shows WHERE each recent lives. macOS renders `sublabel` as a dimmed second
+ * line and `toolTip` on hover; native menus elsewhere render neither, so
+ * there the path is folded into the label itself. Empty, it is the one
+ * disabled "No Recent Projects" item.
+ */
+declare function recentsSubmenu(recents: RecentProject[], opts: RecentsSubmenuOptions): RecentsMenuItem[];
 
-export { APP_MENU, EDIT_MENU, GO_MENU, HELP_MENU, type MenuLabel, type MenuNaming, type NamedMenuItem, PANE_MENU, namedMenuItems };
+export { APP_MENU, EDIT_MENU, FILE_MENU, GO_MENU, HELP_MENU, type MenuLabel, type MenuNaming, type NamedMenuItem, PANE_MENU, PLAY_MENU, PUBLISH_MENU, REVIEW_MENU, type RecentsMenuItem, type RecentsSubmenuOptions, VIEW_MENU, namedMenuItems, recentsSubmenu, tildePath };

package/dist/menu.js

@@ -1,3 +1,3 @@
-export { APP_MENU, EDIT_MENU, GO_MENU, HELP_MENU, PANE_MENU, namedMenuItems } from './chunk-QDPFU4WX.js';
+export { APP_MENU, EDIT_MENU, FILE_MENU, GO_MENU, HELP_MENU, PANE_MENU, PLAY_MENU, PUBLISH_MENU, REVIEW_MENU, VIEW_MENU, namedMenuItems, recentsSubmenu, tildePath } from './chunk-2ECJUTSX.js';
 //# sourceMappingURL=menu.js.map
 //# sourceMappingURL=menu.js.map

package/dist/notes-editor.css

@@ -1,19 +1,6 @@
 /* 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;
+  --dialog-width: 560px;
 }
 .shell-notes-body {
   display: flex;
@@ -23,30 +10,19 @@
   overflow-y: auto;
 }
 .shell-notes-caption {
-  font: 0.72rem/1 var(--font-ui);
+  font: 600 12.5px/1.2 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 {
+textarea.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);
+  font: 13.5px/1.45 var(--font-read, var(--font-ui));
 }
 .shell-notes-inherited {
   display: flex;
@@ -61,15 +37,15 @@
   gap: 2px;
 }
 .shell-notes-level-label {
-  font: 0.72rem/1 var(--font-ui);
+  font: 11.5px/1 var(--font-ui);
   color: var(--muted);
 }
 .shell-notes-line {
-  font: 0.82rem/1.4 var(--font-read, var(--font-ui));
+  font: 13px/1.4 var(--font-read, var(--font-ui));
   color: var(--muted);
 }
 .shell-notes-cls {
-  font: 0.68rem/1 var(--font-ui);
+  font: 11px/1 var(--font-ui);
   color: var(--muted);
   border: 1px solid var(--line-soft);
   border-radius: var(--radius-pill);
@@ -77,31 +53,12 @@
   margin-right: 6px;
 }
 .shell-notes-hint {
-  font: 0.72rem/1 var(--font-ui);
+  font: 11.5px/1 var(--font-ui);
   color: var(--muted);
   margin: 0;
 }
 .shell-notes-add {
-  font: 0.78rem/1 var(--font-ui);
+  font: 12.5px/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 */