@wildwinter/app-shell 0.38.0 → 0.39.0

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 0.78rem/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);
 }
 .shell-notes-inherited {
   display: flex;
@@ -85,23 +61,4 @@
   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

@@ -1 +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: var(--radius-pill);\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,IAAI;AACvD,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":[]}
+{"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. The panel,\n   scrim, title and actions row are the dialog frame's (dialog.css); the text\n   areas and the Done button are controls.css's `.field` and `.btn`. */\n.shell-notes { --dialog-width: 560px; }\n.shell-notes-body { display: flex; flex-direction: column; gap: 10px; max-height: 60vh; overflow-y: auto; }\n/* A caption is sentence-case text at label size, weight 600, in the UI face. */\n.shell-notes-caption {\n  font: 600 0.78rem/1.2 var(--font-ui); color: var(--muted);\n}\n.shell-notes-class { display: flex; flex-direction: column; gap: 4px; }\n/* Notes are prose, so the area is set in the reading face; the element\n   selector out-specifies `.field`, whichever stylesheet loads first. */\ntextarea.shell-notes-text {\n  width: 100%; box-sizing: border-box; resize: vertical;\n  font: 0.85rem/1.45 var(--font-read, var(--font-ui));\n}\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: var(--radius-pill);\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"],"mappings":";AAIA,CAAC;AAAc,kBAAgB;AAAO;AACtC,CAAC;AAAmB,WAAS;AAAM,kBAAgB;AAAQ,OAAK;AAAM,cAAY;AAAM,cAAY;AAAM;AAE1G,CAAC;AACC,QAAM,IAAI,OAAO,CAAC,IAAI,IAAI;AAAY,SAAO,IAAI;AACnD;AACA,CAAC;AAAoB,WAAS;AAAM,kBAAgB;AAAQ,OAAK;AAAK;AAGtE,QAAQ,CAAC;AACP,SAAO;AAAM,cAAY;AAAY,UAAQ;AAC7C,QAAM,OAAO,CAAC,KAAK,IAAI,WAAW,EAAE,IAAI;AAC1C;AAEA,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,IAAI;AACvD,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;","names":[]}

package/dist/pane-shell.css

@@ -28,13 +28,15 @@
   gap: 10px;
 }
 .pane-toggle {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
   color: var(--muted);
   font: inherit;
-  font-size: 0.95rem;
   background: none;
   border: 0;
   border-radius: var(--radius-sm);
-  padding: 2px 8px;
+  padding: 4px 8px;
   cursor: pointer;
 }
 .pane-toggle:hover {
@@ -103,6 +105,18 @@
   cursor: col-resize;
   touch-action: none;
 }
+.pane-resizer::after {
+  content: "";
+  position: absolute;
+  inset: 0 3px;
+  background: transparent;
+  transition: background var(--dur-quick) var(--ease-standard);
+}
+.pane-resizer:hover::after,
+.pane-resizer.dragging::after,
+body.pane-resizing .pane-resizer::after {
+  background: color-mix(in oklab, var(--accent) 45%, transparent);
+}
 .pane-resizer-nav {
   left: calc(var(--nav-w) - 3px);
 }
@@ -136,7 +150,6 @@ body.pane-resizing .panes {
   border-radius: var(--radius-sm);
   background: none;
   color: var(--muted);
-  font-size: 0.95rem;
   line-height: 1;
   cursor: pointer;
 }

package/dist/pane-shell.css.map

@@ -1 +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). The host fills the pane bodies and the top-bar\n   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/* --- the fused title bar (the family ruling, 2026-08-27) --------------------\n   On macOS the topbar IS the window's title bar: the app's main window uses\n   titleBarStyle \"hiddenInset\" and marks the bar with these classes, so one\n   row carries the traffic lights, the identity and the top-level controls\n   instead of a native strip whose only cargo is a title. `titlebar` makes the\n   bar the drag surface (its controls stay clickable; add `no-drag` to any\n   other interactive thing the host mounts); `titlebar-inset` leaves room for\n   the traffic lights and is added ONLY on macOS - elsewhere the window keeps\n   its native frame and the same bar sits beneath it, identically in every\n   app of the family. */\n.topbar.titlebar { -webkit-app-region: drag; }\n.topbar.titlebar :is(button, input, select, a, .no-drag) { -webkit-app-region: no-drag; }\n.topbar.titlebar-inset { padding-left: 84px; }\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\n/* --- the back/forward pair (nav-history.ts) --------------------------------\n   VS Code's quietness: two plain chevrons, borderless, greyed where there is\n   nowhere to go. They sit to the LEFT of the app's normal navigation (the\n   crumb trail here, whatever the host's equivalent is), so they read as part\n   of the chrome, not a control demanding attention. */\n.shell-histnav { display: inline-flex; gap: 2px; margin-right: 6px; }\n.shell-histnav-btn { display: inline-flex; align-items: center; justify-content: center; width: 22px; height: 22px; padding: 0; border: none; border-radius: var(--radius-sm); background: none; color: var(--muted); font-size: 0.95rem; line-height: 1; cursor: pointer; }\n.shell-histnav-btn:hover:not(:disabled) { color: var(--ink); background: var(--accent-soft); }\n.shell-histnav-btn:disabled { opacity: 0.35; cursor: default; }\n"],"mappings":";AAQA,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;AAY3C,CAzBC,MAyBM,CAAC;AAAW,sBAAoB;AAAM;AAC7C,CA1BC,MA0BM,CADC,SACS,IAAI,QAAQ,OAAO,QAAQ,GAAG,CAAC;AAAW,sBAAoB;AAAS;AACxF,CA3BC,MA2BM,CAAC;AAAiB,gBAAc;AAAM;AAE7C,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;AAO9C,CAAC;AAAgB,WAAS;AAAa,OAAK;AAAK,gBAAc;AAAK;AACpE,CAAC;AAAoB,WAAS;AAAa,eAAa;AAAQ,mBAAiB;AAAQ,SAAO;AAAM,UAAQ;AAAM,WAAS;AAAG,UAAQ;AAAM,iBAAe,IAAI;AAAc,cAAY;AAAM,SAAO,IAAI;AAAU,aAAW;AAAS,eAAa;AAAG,UAAQ;AAAS;AAC3Q,CADC,iBACiB,MAAM,KAAK;AAAa,SAAO,IAAI;AAAQ,cAAY,IAAI;AAAgB;AAC7F,CAFC,iBAEiB;AAAY,WAAS;AAAM,UAAQ;AAAS;","names":[]}
+{"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). The host fills the pane bodies and the top-bar\n   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  display: inline-flex; align-items: center; justify-content: center;\n  color: var(--muted); font: inherit;\n  background: none; border: 0; border-radius: var(--radius-sm); padding: 4px 8px; cursor: pointer;\n}\n.pane-toggle:hover { color: var(--accent); }\n\n/* --- the fused title bar (the family ruling, 2026-08-27) --------------------\n   On macOS the topbar IS the window's title bar: the app's main window uses\n   titleBarStyle \"hiddenInset\" and marks the bar with these classes, so one\n   row carries the traffic lights, the identity and the top-level controls\n   instead of a native strip whose only cargo is a title. `titlebar` makes the\n   bar the drag surface (its controls stay clickable; add `no-drag` to any\n   other interactive thing the host mounts); `titlebar-inset` leaves room for\n   the traffic lights and is added ONLY on macOS - elsewhere the window keeps\n   its native frame and the same bar sits beneath it, identically in every\n   app of the family. */\n.topbar.titlebar { -webkit-app-region: drag; }\n.topbar.titlebar :is(button, input, select, a, .no-drag) { -webkit-app-region: no-drag; }\n.topbar.titlebar-inset { padding-left: 84px; }\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. The\n   seam is invisible at rest and lights up under the pointer and while dragging\n   (quiet chrome, shown on hover): a colour change only, at --dur-quick. */\n.pane-resizer { position: absolute; top: 0; bottom: 0; width: 7px; z-index: 6; cursor: col-resize; touch-action: none; }\n.pane-resizer::after { content: \"\"; position: absolute; inset: 0 3px; background: transparent; transition: background var(--dur-quick) var(--ease-standard); }\n.pane-resizer:hover::after, .pane-resizer.dragging::after, body.pane-resizing .pane-resizer::after { background: color-mix(in oklab, var(--accent) 45%, transparent); }\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\n/* --- the back/forward pair (nav-history.ts) --------------------------------\n   VS Code's quietness: two plain chevrons, borderless, greyed where there is\n   nowhere to go. They sit to the LEFT of the app's normal navigation (the\n   crumb trail here, whatever the host's equivalent is), so they read as part\n   of the chrome, not a control demanding attention. */\n.shell-histnav { display: inline-flex; gap: 2px; margin-right: 6px; }\n.shell-histnav-btn { display: inline-flex; align-items: center; justify-content: center; width: 22px; height: 22px; padding: 0; border: none; border-radius: var(--radius-sm); background: none; color: var(--muted); line-height: 1; cursor: pointer; }\n.shell-histnav-btn:hover:not(:disabled) { color: var(--ink); background: var(--accent-soft); }\n.shell-histnav-btn:disabled { opacity: 0.35; cursor: default; }\n"],"mappings":"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","names":[]}

package/dist/property-list-D3VZCJzi.d.cts

@@ -0,0 +1,162 @@
+/** A compact list row: a single `.set-rowline` (inline controls) plus, when
+ *  `details` are given, a disclosure that reveals a `.set-details` panel below,
+ *  so a list scans like a table with secondary fields tucked away. `name` is
+ *  what the row declares (a property's name, a field's), stamped on it as
+ *  `data-name` so `revealRow` can land on it. */
+declare function expandableRow(opts: {
+    line: HTMLElement[];
+    details?: HTMLElement[];
+    name?: string;
+}): HTMLElement;
+/**
+ * Land on one row of a list by the `name` it was built with: open its details
+ * (an enum's values sit behind the disclosure, and they are usually what the
+ * jump was for), bring it to the middle of its scroller, and light it for a
+ * moment (`.set-row.landed` in settings.css). "Go to definition" in both apps
+ * used to open the page a property is declared on and stop there, with the
+ * declaration below the fold and nothing marking it (Storyletter, 2026-09-14).
+ *
+ * Returns false when no row carries the name, so a host whose page fills in
+ * asynchronously can ask again on a later frame; asking again is the host's,
+ * since only the host knows what opens on its own time. The row is matched by
+ * reading the stamp rather than by an attribute selector, so a name needs no
+ * escaping.
+ */
+declare function revealRow(within: ParentNode, name: string): boolean;
+/**
+ * `revealRow`, retried over the next frames until the row exists or the tries
+ * run out: for a page that fills in on its own time after a navigation. Both
+ * apps hand-rolled this as `landOn` with the same twelve tries
+ * (ui-review-2026-09, finding 29). Resolves true when it landed, false when it
+ * gave up, and giving up is quiet: a name no page shows as a row is not a fault.
+ */
+declare function revealRowWhenReady(within: ParentNode, name: string, tries?: number): Promise<boolean>;
+/** After a "+ Add" re-renders a list, bring the new (last) row into view and
+ *  focus its name input (`.set-name`, else the first input). */
+declare function focusNewRow(listEl: HTMLElement | null | undefined): void;
+interface DupGuard {
+    /** Forget the previous render's inputs (call at the top of render). */
+    reset(): void;
+    /** Register a name input; `key` returns the comparison string (default the
+     *  input's value). Re-checks live on input. `also` = extra inputs that change the key. */
+    track(input: HTMLInputElement, key?: () => string, also?: HTMLInputElement[]): void;
+    /** Re-paint duplicates; true if any two non-blank keys collide. */
+    check(): boolean;
+    /** The first input currently flagged (after a fresh check), or null. */
+    firstDuplicate(): HTMLInputElement | null;
+}
+/** Case-insensitive duplicate-name detection: paints clashing inputs `.invalid`
+ *  and lets a Save gate block + jump via `firstDuplicate()`. */
+declare function dupGuard(): DupGuard;
+interface SettingsSectionHandle {
+    /** The first invalid control to jump to, blocking Save (e.g. a duplicate
+     *  name). Return `{ el, message }` to say WHICH fault in the error line;
+     *  a bare element says it through its own `data-tip` (the dup guard's, a
+     *  property-name field's), and the line falls back to a generic sentence
+     *  when it has neither. */
+    firstInvalid?(): HTMLElement | {
+        el: HTMLElement;
+        message?: string;
+    } | null;
+}
+interface SettingsSection {
+    id: string;
+    label: string;
+    /** Optional left-rail group heading above this tab. */
+    group?: string;
+    /** Build the section body into `host`; called fresh on each open so it reads
+     *  the current data. Return a handle (for the Save gate). */
+    mount(host: HTMLElement): SettingsSectionHandle;
+    /** Why this tab cannot be used right now, or null when it can. A reason
+     *  renders the tab dimmed and inert with the reason as its rollover
+     *  (Patterpad's Audio tab while the project is not voiced). Read on open
+     *  and on `refreshTabs()`, so a control inside the dialog can flip it. */
+    disabled?: () => string | null;
+}
+interface SettingsDialogOptions {
+    title: string;
+    sections: SettingsSection[];
+    /** Fired when Save is clicked and every section validates. The app reads its
+     *  own section state and persists. May be async; the dialog stays open until
+     *  it resolves, then closes. */
+    onSave: () => void | Promise<void>;
+}
+interface SettingsDialog {
+    /** Open (optionally on a given tab id). Sections re-mount from current data. */
+    open(tabId?: string): void;
+    /** Re-read every section's `disabled()`; a tab that has just become
+     *  disabled while showing hands over to the first usable one. */
+    refreshTabs(): void;
+    destroy(): void;
+}
+/** Build a settings dialog. The frame owns the modal, the tab rail, save-on-Save
+ *  (with a validation gate), and Cancel; the sections own their content + state. */
+declare function mountSettingsDialog(opts: SettingsDialogOptions): SettingsDialog;
+
+/** The six types both apps declare. */
+type PropertyListType = "number" | "boolean" | "string" | "enum" | "flags" | "quality";
+/** The shape a row edits. Apps' DTOs carry more (shared, writable, durable);
+ *  those ride through untouched. */
+interface PropertyDeclLike {
+    name: string;
+    type: string;
+    default?: unknown;
+    /** enum / flags */
+    values?: string[];
+    /** quality: the ladder, in order */
+    stages?: string[];
+    purpose?: string;
+}
+/** The type list, in the family's order, with the words the select shows. */
+declare const PROPERTY_TYPES: ReadonlyArray<readonly [PropertyListType, string]>;
+interface DefaultControlOptions {
+    /**
+     * How the default is stored. `false` (default): the string the field shows,
+     * "" for none (Storyletter's DTO). `true`: a typed value (boolean, number,
+     * string), and none DELETES the key (Patterpad's model).
+     */
+    typed?: boolean;
+}
+/**
+ * The type-appropriate control for a declaration's DEFAULT: a true / false
+ * picker for a boolean, the value list for an enum, the stage list for a
+ * quality (blank = the first rung), a note for flags (a set starts empty), a
+ * number or text field otherwise. The one label for "no default" is "(none)".
+ */
+declare function defaultControl(p: PropertyDeclLike, onChange?: () => void, opts?: DefaultControlOptions): HTMLElement;
+interface PropertyListOptions<T extends PropertyDeclLike> extends DefaultControlOptions {
+    /** Called after every mutation; a centre editor feeds its autosave here. */
+    onChange?: () => void;
+    /** The add button's label. Default "+ Add property". */
+    addLabel?: string;
+    /** The empty sentence. Default "No properties yet." */
+    emptyText?: string;
+    /** The type select's entries; default `PROPERTY_TYPES`. */
+    types?: ReadonlyArray<readonly [string, string]>;
+    /** A fresh declaration for the add button. Default: a blank of the first type. */
+    newDecl?: () => T;
+    /** Controls on the row's line, between the default and the movers
+     *  (Storyletter's "uses" affordance). */
+    extraLine?: (decl: T, index: number) => (HTMLElement | null)[];
+    /** Fields behind the disclosure, before Values / Stages / Purpose
+     *  (Shared, Temporary, Read-only, Durable). */
+    extraDetails?: (decl: T, index: number) => (HTMLElement | null)[];
+    /** Offer the Purpose field. Default true. */
+    purpose?: boolean;
+}
+interface PropertyListHandle extends SettingsSectionHandle {
+    /** Both faults, for the Save gate: a duplicate first, then an illegal name. */
+    firstInvalid(): HTMLInputElement | null;
+    /** The first name that clashes with another, or null. */
+    firstDuplicate(): HTMLInputElement | null;
+    /** The first name no expression could reach, or null. */
+    firstIllegalName(): HTMLInputElement | null;
+    /** Redraw from `decls` (after an outside change). */
+    render(): void;
+}
+/** Mount the list into `host`. Mutates `decls` in place; the caller reads
+ *  them back on save (pruning blank names is the caller's, since only it
+ *  knows its DTO). */
+declare function mountPropertyList<T extends PropertyDeclLike>(host: HTMLElement, decls: T[], opts?: PropertyListOptions<T>): PropertyListHandle;
+
+export { type DefaultControlOptions as D, PROPERTY_TYPES as P, type SettingsDialog as S, type DupGuard as a, type PropertyDeclLike as b, type PropertyListHandle as c, type PropertyListOptions as d, type PropertyListType as e, type SettingsDialogOptions as f, type SettingsSection as g, type SettingsSectionHandle as h, defaultControl as i, dupGuard as j, expandableRow as k, focusNewRow as l, mountPropertyList as m, mountSettingsDialog as n, revealRowWhenReady as o, revealRow as r };

package/dist/property-list-D3VZCJzi.d.ts

@@ -0,0 +1,162 @@
+/** A compact list row: a single `.set-rowline` (inline controls) plus, when
+ *  `details` are given, a disclosure that reveals a `.set-details` panel below,
+ *  so a list scans like a table with secondary fields tucked away. `name` is
+ *  what the row declares (a property's name, a field's), stamped on it as
+ *  `data-name` so `revealRow` can land on it. */
+declare function expandableRow(opts: {
+    line: HTMLElement[];
+    details?: HTMLElement[];
+    name?: string;
+}): HTMLElement;
+/**
+ * Land on one row of a list by the `name` it was built with: open its details
+ * (an enum's values sit behind the disclosure, and they are usually what the
+ * jump was for), bring it to the middle of its scroller, and light it for a
+ * moment (`.set-row.landed` in settings.css). "Go to definition" in both apps
+ * used to open the page a property is declared on and stop there, with the
+ * declaration below the fold and nothing marking it (Storyletter, 2026-09-14).
+ *
+ * Returns false when no row carries the name, so a host whose page fills in
+ * asynchronously can ask again on a later frame; asking again is the host's,
+ * since only the host knows what opens on its own time. The row is matched by
+ * reading the stamp rather than by an attribute selector, so a name needs no
+ * escaping.
+ */
+declare function revealRow(within: ParentNode, name: string): boolean;
+/**
+ * `revealRow`, retried over the next frames until the row exists or the tries
+ * run out: for a page that fills in on its own time after a navigation. Both
+ * apps hand-rolled this as `landOn` with the same twelve tries
+ * (ui-review-2026-09, finding 29). Resolves true when it landed, false when it
+ * gave up, and giving up is quiet: a name no page shows as a row is not a fault.
+ */
+declare function revealRowWhenReady(within: ParentNode, name: string, tries?: number): Promise<boolean>;
+/** After a "+ Add" re-renders a list, bring the new (last) row into view and
+ *  focus its name input (`.set-name`, else the first input). */
+declare function focusNewRow(listEl: HTMLElement | null | undefined): void;
+interface DupGuard {
+    /** Forget the previous render's inputs (call at the top of render). */
+    reset(): void;
+    /** Register a name input; `key` returns the comparison string (default the
+     *  input's value). Re-checks live on input. `also` = extra inputs that change the key. */
+    track(input: HTMLInputElement, key?: () => string, also?: HTMLInputElement[]): void;
+    /** Re-paint duplicates; true if any two non-blank keys collide. */
+    check(): boolean;
+    /** The first input currently flagged (after a fresh check), or null. */
+    firstDuplicate(): HTMLInputElement | null;
+}
+/** Case-insensitive duplicate-name detection: paints clashing inputs `.invalid`
+ *  and lets a Save gate block + jump via `firstDuplicate()`. */
+declare function dupGuard(): DupGuard;
+interface SettingsSectionHandle {
+    /** The first invalid control to jump to, blocking Save (e.g. a duplicate
+     *  name). Return `{ el, message }` to say WHICH fault in the error line;
+     *  a bare element says it through its own `data-tip` (the dup guard's, a
+     *  property-name field's), and the line falls back to a generic sentence
+     *  when it has neither. */
+    firstInvalid?(): HTMLElement | {
+        el: HTMLElement;
+        message?: string;
+    } | null;
+}
+interface SettingsSection {
+    id: string;
+    label: string;
+    /** Optional left-rail group heading above this tab. */
+    group?: string;
+    /** Build the section body into `host`; called fresh on each open so it reads
+     *  the current data. Return a handle (for the Save gate). */
+    mount(host: HTMLElement): SettingsSectionHandle;
+    /** Why this tab cannot be used right now, or null when it can. A reason
+     *  renders the tab dimmed and inert with the reason as its rollover
+     *  (Patterpad's Audio tab while the project is not voiced). Read on open
+     *  and on `refreshTabs()`, so a control inside the dialog can flip it. */
+    disabled?: () => string | null;
+}
+interface SettingsDialogOptions {
+    title: string;
+    sections: SettingsSection[];
+    /** Fired when Save is clicked and every section validates. The app reads its
+     *  own section state and persists. May be async; the dialog stays open until
+     *  it resolves, then closes. */
+    onSave: () => void | Promise<void>;
+}
+interface SettingsDialog {
+    /** Open (optionally on a given tab id). Sections re-mount from current data. */
+    open(tabId?: string): void;
+    /** Re-read every section's `disabled()`; a tab that has just become
+     *  disabled while showing hands over to the first usable one. */
+    refreshTabs(): void;
+    destroy(): void;
+}
+/** Build a settings dialog. The frame owns the modal, the tab rail, save-on-Save
+ *  (with a validation gate), and Cancel; the sections own their content + state. */
+declare function mountSettingsDialog(opts: SettingsDialogOptions): SettingsDialog;
+
+/** The six types both apps declare. */
+type PropertyListType = "number" | "boolean" | "string" | "enum" | "flags" | "quality";
+/** The shape a row edits. Apps' DTOs carry more (shared, writable, durable);
+ *  those ride through untouched. */
+interface PropertyDeclLike {
+    name: string;
+    type: string;
+    default?: unknown;
+    /** enum / flags */
+    values?: string[];
+    /** quality: the ladder, in order */
+    stages?: string[];
+    purpose?: string;
+}
+/** The type list, in the family's order, with the words the select shows. */
+declare const PROPERTY_TYPES: ReadonlyArray<readonly [PropertyListType, string]>;
+interface DefaultControlOptions {
+    /**
+     * How the default is stored. `false` (default): the string the field shows,
+     * "" for none (Storyletter's DTO). `true`: a typed value (boolean, number,
+     * string), and none DELETES the key (Patterpad's model).
+     */
+    typed?: boolean;
+}
+/**
+ * The type-appropriate control for a declaration's DEFAULT: a true / false
+ * picker for a boolean, the value list for an enum, the stage list for a
+ * quality (blank = the first rung), a note for flags (a set starts empty), a
+ * number or text field otherwise. The one label for "no default" is "(none)".
+ */
+declare function defaultControl(p: PropertyDeclLike, onChange?: () => void, opts?: DefaultControlOptions): HTMLElement;
+interface PropertyListOptions<T extends PropertyDeclLike> extends DefaultControlOptions {
+    /** Called after every mutation; a centre editor feeds its autosave here. */
+    onChange?: () => void;
+    /** The add button's label. Default "+ Add property". */
+    addLabel?: string;
+    /** The empty sentence. Default "No properties yet." */
+    emptyText?: string;
+    /** The type select's entries; default `PROPERTY_TYPES`. */
+    types?: ReadonlyArray<readonly [string, string]>;
+    /** A fresh declaration for the add button. Default: a blank of the first type. */
+    newDecl?: () => T;
+    /** Controls on the row's line, between the default and the movers
+     *  (Storyletter's "uses" affordance). */
+    extraLine?: (decl: T, index: number) => (HTMLElement | null)[];
+    /** Fields behind the disclosure, before Values / Stages / Purpose
+     *  (Shared, Temporary, Read-only, Durable). */
+    extraDetails?: (decl: T, index: number) => (HTMLElement | null)[];
+    /** Offer the Purpose field. Default true. */
+    purpose?: boolean;
+}
+interface PropertyListHandle extends SettingsSectionHandle {
+    /** Both faults, for the Save gate: a duplicate first, then an illegal name. */
+    firstInvalid(): HTMLInputElement | null;
+    /** The first name that clashes with another, or null. */
+    firstDuplicate(): HTMLInputElement | null;
+    /** The first name no expression could reach, or null. */
+    firstIllegalName(): HTMLInputElement | null;
+    /** Redraw from `decls` (after an outside change). */
+    render(): void;
+}
+/** Mount the list into `host`. Mutates `decls` in place; the caller reads
+ *  them back on save (pruning blank names is the caller's, since only it
+ *  knows its DTO). */
+declare function mountPropertyList<T extends PropertyDeclLike>(host: HTMLElement, decls: T[], opts?: PropertyListOptions<T>): PropertyListHandle;
+
+export { type DefaultControlOptions as D, PROPERTY_TYPES as P, type SettingsDialog as S, type DupGuard as a, type PropertyDeclLike as b, type PropertyListHandle as c, type PropertyListOptions as d, type PropertyListType as e, type SettingsDialogOptions as f, type SettingsSection as g, type SettingsSectionHandle as h, defaultControl as i, dupGuard as j, expandableRow as k, focusNewRow as l, mountPropertyList as m, mountSettingsDialog as n, revealRowWhenReady as o, revealRow as r };