@wildwinter/app-shell 0.38.0 → 0.40.0

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 12.5px/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: 13.5px/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: 11.5px/1 var(--font-ui); color: var(--muted); }\n.shell-notes-line { font: 13px/1.4 var(--font-read, var(--font-ui)); color: var(--muted); }\n.shell-notes-cls {\n  font: 11px/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: 11.5px/1 var(--font-ui); color: var(--muted); margin: 0; }\n.shell-notes-add { font: 12.5px/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,MAAM,CAAC,IAAI,IAAI;AAAY,SAAO,IAAI;AAClD;AACA,CAAC;AAAoB,WAAS;AAAM,kBAAgB;AAAQ,OAAK;AAAK;AAGtE,QAAQ,CAAC;AACP,SAAO;AAAM,cAAY;AAAY,UAAQ;AAC7C,QAAM,MAAM,CAAC,KAAK,IAAI,WAAW,EAAE,IAAI;AACzC;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,MAAM,CAAC,EAAE,IAAI;AAAY,SAAO,IAAI;AAAU;AAC/E,CAAC;AAAmB,QAAM,IAAI,CAAC,IAAI,IAAI,WAAW,EAAE,IAAI;AAAa,SAAO,IAAI;AAAU;AAC1F,CAAC;AACC,QAAM,IAAI,CAAC,EAAE,IAAI;AAAY,SAAO,IAAI;AACxC,UAAQ,IAAI,MAAM,IAAI;AAAc,iBAAe,IAAI;AACvD,WAAS,IAAI;AAAK,gBAAc;AAClC;AACA,CAAC;AAAmB,QAAM,MAAM,CAAC,EAAE,IAAI;AAAY,SAAO,IAAI;AAAU,UAAQ;AAAG;AACnF,CAAC;AAAkB,QAAM,MAAM,CAAC,EAAE,IAAI;AAAY,cAAY;AAAY;","names":[]}

package/dist/pane-shell.css

@@ -5,6 +5,11 @@
   flex-direction: column;
   min-height: 0;
 }
+.topbar,
+.pane-nav,
+.pane-inspector {
+  font-size: var(--chrome-size);
+}
 .topbar {
   display: flex;
   align-items: center;
@@ -28,13 +33,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 {
@@ -50,8 +57,8 @@
   padding-left: 84px;
 }
 .panes {
-  --nav-open-w: 14rem;
-  --insp-open-w: 22rem;
+  --nav-open-w: 224px;
+  --insp-open-w: 384px;
   --nav-w: var(--nav-open-w);
   --insp-w: var(--insp-open-w);
   position: relative;
@@ -103,6 +110,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 +155,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/* The chrome base (tokens.css) is set on the CHROME panes only: the top bar,\n   the navigator and the inspector read at 14px whatever the app's reading root\n   is. The centre pane is the app's content and inherits the app's own size:\n   pinning the whole shell pulled Patterpad's script down to 14px. */\n.pane-shell { flex: 1; display: flex; flex-direction: column; min-height: 0; }\n.topbar, .pane-nav, .pane-inspector { font-size: var(--chrome-size); }\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: 224px; --insp-open-w: 384px;\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/problems.cjs

@@ -0,0 +1,61 @@
+'use strict';
+
+// src/problems.ts
+function problemName(p, dangling = false) {
+  if (p.title) return `\u201C${p.title}\u201D`;
+  if (dangling && p.where) return `(id ${p.where})`;
+  return "This";
+}
+function describeProblem(problem, table = {}) {
+  const entry = problem.code ? table[problem.code] : void 0;
+  if (entry) {
+    const copy = entry(problem);
+    const text = copy.dangling && !problem.title && problem.where && !copy.text.includes(`(id ${problem.where})`) ? `${copy.text} (id ${problem.where})` : copy.text;
+    return copy.next ? { text, next: copy.next } : { text };
+  }
+  const message = problem.message.replace(/\s*\[[^\]]*\]\s*$/, "").trim();
+  return { text: problem.title ? `${problem.title}: ${message}` : message };
+}
+function problemLine(problem, table) {
+  const { text, next } = describeProblem(problem, table);
+  return next ? `${text} ${next}` : text;
+}
+var defaultProblemCopy = {
+  "duplicate-gameid": (p) => ({
+    text: `The Game ID on ${problemName(p)} is already used elsewhere.`,
+    next: "Each one must be unique; change one of them."
+  }),
+  "invalid-gameid": (p) => ({
+    text: `The Game ID on ${problemName(p)} isn't valid.`,
+    next: "Use lowercase letters, digits and hyphens."
+  }),
+  "dangling-reference": (p) => ({
+    text: `${problemName(p, true)} points at something that no longer exists.`,
+    next: "Choose where it goes.",
+    dangling: true
+  }),
+  "unknown-property": (p) => ({
+    text: `${problemName(p)} uses a property that isn't set up yet.`,
+    next: "Declare it in the project settings, or fix the name."
+  }),
+  "missing-name": (p) => ({ text: `${problemName(p)} needs a name.` }),
+  "empty": (p) => ({
+    text: `${problemName(p)} is empty.`,
+    next: "Add something inside it, or remove it."
+  }),
+  "stale-build": (p) => ({
+    text: `Your playable build${p.path ? ` (${p.path})` : ""} is out of date.`,
+    next: "It refreshes the next time you publish."
+  }),
+  "merge-conflict": (p) => ({
+    text: `${p.path ?? "This file"} still has an unresolved merge conflict in it.`,
+    next: "Resolve it in your version control tool, then reopen the project."
+  })
+};
+
+exports.defaultProblemCopy = defaultProblemCopy;
+exports.describeProblem = describeProblem;
+exports.problemLine = problemLine;
+exports.problemName = problemName;
+//# sourceMappingURL=problems.cjs.map
+//# sourceMappingURL=problems.cjs.map

package/dist/problems.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/problems.ts"],"names":[],"mappings":"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","file":"problems.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// Problem copy: a validator's diagnostic rewritten for the person at the\n// keyboard, through a table the app fills.\n//\n// Patterpad's `humanizeProblem` (its renderer.ts) proved the shape: a dozen\n// validator categories each mapped to a plain sentence with a next step, naming\n// things by their title, and a fallback that softens the technical tells.\n// Storyletter showed the raw compiler string and labelled it `path [where]`\n// (ui-review-2026-09, finding 17), the bracketed id that \"Diagnostics name what\n// the author can see\" (design-language.md) rules out for anything but a\n// DANGLING reference. This module is the translator; the tables are the\n// apps', because the codes are theirs. `defaultProblemCopy` covers the handful\n// of codes both validators raise in some form, as a floor an app spreads into\n// its own table.\n// ---------------------------------------------------------------------------\n\n/** What a translator needs to know about a problem. `code` is the app's own\n *  category (Patterpad's `detail`, or a code Storyletter derives from its\n *  compiler message); `title` is the author-facing name of the thing the\n *  problem is about, when the app can resolve one; `where` is the raw\n *  reference (an id) for when it cannot. */\nexport interface ProblemLike {\n  code?: string;\n  message: string;\n  path?: string;\n  where?: string;\n  title?: string;\n}\n\nexport interface ProblemCopy {\n  /** The sentence: what is wrong, in the author's words. */\n  text: string;\n  /** What to do about it, when there is one thing to do. */\n  next?: string;\n  /** The reference this problem is about no longer has a name to give, so the\n   *  raw id may be shown, written `(id ...)` so it cannot be mistaken for a\n   *  name. Set by the table entry; the translator never guesses it. */\n  dangling?: boolean;\n}\n\nexport type ProblemCopyEntry = (problem: ProblemLike) => ProblemCopy;\nexport type ProblemCopyTable = Record<string, ProblemCopyEntry>;\n\n/** The name to call the thing a problem is about: its title in curly quotes,\n *  \"(id ...)\" only when the reference dangles and there is nothing else,\n *  and \"This\" otherwise, because the bar's \"go to\" shows the reader what\n *  \"this\" is and an id is not something they can look for. */\nexport function problemName(p: ProblemLike, dangling = false): string {\n  if (p.title) return `“${p.title}”`;\n  if (dangling && p.where) return `(id ${p.where})`;\n  return \"This\";\n}\n\n/**\n * Translate `problem` through `table`. A matching entry decides the copy; with\n * no entry the raw message is kept and prefixed by the title when there is one\n * (\"Burner Rig: duplicate id\"). Nothing here ever writes `[where]`; an id\n * appears only as `(id ...)`, only when the entry says the reference dangles,\n * and only when there is no title to say instead.\n */\nexport function describeProblem(problem: ProblemLike, table: ProblemCopyTable = {}): ProblemCopy {\n  const entry = problem.code ? table[problem.code] : undefined;\n  if (entry) {\n    const copy = entry(problem);\n    const text = copy.dangling && !problem.title && problem.where && !copy.text.includes(`(id ${problem.where})`)\n      ? `${copy.text} (id ${problem.where})`\n      : copy.text;\n    return copy.next ? { text, next: copy.next } : { text };\n  }\n  const message = problem.message.replace(/\\s*\\[[^\\]]*\\]\\s*$/, \"\").trim();\n  return { text: problem.title ? `${problem.title}: ${message}` : message };\n}\n\n/** `describeProblem` as one line for a bar that has room for one: the sentence,\n *  then the next step after a space. */\nexport function problemLine(problem: ProblemLike, table?: ProblemCopyTable): string {\n  const { text, next } = describeProblem(problem, table);\n  return next ? `${text} ${next}` : text;\n}\n\n/**\n * The codes both validators raise in some form, in the family's voice. An app\n * spreads this into its own table and adds its own codes over it; a code an\n * app does not raise costs nothing.\n *\n *   duplicate-gameid    two things share one Game ID\n *   invalid-gameid      a Game ID that breaks the address rule\n *   dangling-reference  a jump / tag / property points at something gone\n *   unknown-property    a condition or effect names an undeclared property\n *   missing-name        a thing that needs a name has none\n *   empty               a container with nothing in it\n *   stale-build         the playable build is older than the source\n *   merge-conflict      a file still carries conflict markers\n */\nexport const defaultProblemCopy: ProblemCopyTable = {\n  \"duplicate-gameid\": (p) => ({\n    text: `The Game ID on ${problemName(p)} is already used elsewhere.`,\n    next: \"Each one must be unique; change one of them.\",\n  }),\n  \"invalid-gameid\": (p) => ({\n    text: `The Game ID on ${problemName(p)} isn't valid.`,\n    next: \"Use lowercase letters, digits and hyphens.\",\n  }),\n  \"dangling-reference\": (p) => ({\n    text: `${problemName(p, true)} points at something that no longer exists.`,\n    next: \"Choose where it goes.\",\n    dangling: true,\n  }),\n  \"unknown-property\": (p) => ({\n    text: `${problemName(p)} uses a property that isn't set up yet.`,\n    next: \"Declare it in the project settings, or fix the name.\",\n  }),\n  \"missing-name\": (p) => ({ text: `${problemName(p)} needs a name.` }),\n  \"empty\": (p) => ({\n    text: `${problemName(p)} is empty.`,\n    next: \"Add something inside it, or remove it.\",\n  }),\n  \"stale-build\": (p) => ({\n    text: `Your playable build${p.path ? ` (${p.path})` : \"\"} is out of date.`,\n    next: \"It refreshes the next time you publish.\",\n  }),\n  \"merge-conflict\": (p) => ({\n    text: `${p.path ?? \"This file\"} still has an unresolved merge conflict in it.`,\n    next: \"Resolve it in your version control tool, then reopen the project.\",\n  }),\n};\n"]}

package/dist/problems.d.cts

@@ -0,0 +1,57 @@
+/** What a translator needs to know about a problem. `code` is the app's own
+ *  category (Patterpad's `detail`, or a code Storyletter derives from its
+ *  compiler message); `title` is the author-facing name of the thing the
+ *  problem is about, when the app can resolve one; `where` is the raw
+ *  reference (an id) for when it cannot. */
+interface ProblemLike {
+    code?: string;
+    message: string;
+    path?: string;
+    where?: string;
+    title?: string;
+}
+interface ProblemCopy {
+    /** The sentence: what is wrong, in the author's words. */
+    text: string;
+    /** What to do about it, when there is one thing to do. */
+    next?: string;
+    /** The reference this problem is about no longer has a name to give, so the
+     *  raw id may be shown, written `(id ...)` so it cannot be mistaken for a
+     *  name. Set by the table entry; the translator never guesses it. */
+    dangling?: boolean;
+}
+type ProblemCopyEntry = (problem: ProblemLike) => ProblemCopy;
+type ProblemCopyTable = Record<string, ProblemCopyEntry>;
+/** The name to call the thing a problem is about: its title in curly quotes,
+ *  "(id ...)" only when the reference dangles and there is nothing else,
+ *  and "This" otherwise, because the bar's "go to" shows the reader what
+ *  "this" is and an id is not something they can look for. */
+declare function problemName(p: ProblemLike, dangling?: boolean): string;
+/**
+ * Translate `problem` through `table`. A matching entry decides the copy; with
+ * no entry the raw message is kept and prefixed by the title when there is one
+ * ("Burner Rig: duplicate id"). Nothing here ever writes `[where]`; an id
+ * appears only as `(id ...)`, only when the entry says the reference dangles,
+ * and only when there is no title to say instead.
+ */
+declare function describeProblem(problem: ProblemLike, table?: ProblemCopyTable): ProblemCopy;
+/** `describeProblem` as one line for a bar that has room for one: the sentence,
+ *  then the next step after a space. */
+declare function problemLine(problem: ProblemLike, table?: ProblemCopyTable): string;
+/**
+ * The codes both validators raise in some form, in the family's voice. An app
+ * spreads this into its own table and adds its own codes over it; a code an
+ * app does not raise costs nothing.
+ *
+ *   duplicate-gameid    two things share one Game ID
+ *   invalid-gameid      a Game ID that breaks the address rule
+ *   dangling-reference  a jump / tag / property points at something gone
+ *   unknown-property    a condition or effect names an undeclared property
+ *   missing-name        a thing that needs a name has none
+ *   empty               a container with nothing in it
+ *   stale-build         the playable build is older than the source
+ *   merge-conflict      a file still carries conflict markers
+ */
+declare const defaultProblemCopy: ProblemCopyTable;
+
+export { type ProblemCopy, type ProblemCopyEntry, type ProblemCopyTable, type ProblemLike, defaultProblemCopy, describeProblem, problemLine, problemName };

package/dist/problems.d.ts

@@ -0,0 +1,57 @@
+/** What a translator needs to know about a problem. `code` is the app's own
+ *  category (Patterpad's `detail`, or a code Storyletter derives from its
+ *  compiler message); `title` is the author-facing name of the thing the
+ *  problem is about, when the app can resolve one; `where` is the raw
+ *  reference (an id) for when it cannot. */
+interface ProblemLike {
+    code?: string;
+    message: string;
+    path?: string;
+    where?: string;
+    title?: string;
+}
+interface ProblemCopy {
+    /** The sentence: what is wrong, in the author's words. */
+    text: string;
+    /** What to do about it, when there is one thing to do. */
+    next?: string;
+    /** The reference this problem is about no longer has a name to give, so the
+     *  raw id may be shown, written `(id ...)` so it cannot be mistaken for a
+     *  name. Set by the table entry; the translator never guesses it. */
+    dangling?: boolean;
+}
+type ProblemCopyEntry = (problem: ProblemLike) => ProblemCopy;
+type ProblemCopyTable = Record<string, ProblemCopyEntry>;
+/** The name to call the thing a problem is about: its title in curly quotes,
+ *  "(id ...)" only when the reference dangles and there is nothing else,
+ *  and "This" otherwise, because the bar's "go to" shows the reader what
+ *  "this" is and an id is not something they can look for. */
+declare function problemName(p: ProblemLike, dangling?: boolean): string;
+/**
+ * Translate `problem` through `table`. A matching entry decides the copy; with
+ * no entry the raw message is kept and prefixed by the title when there is one
+ * ("Burner Rig: duplicate id"). Nothing here ever writes `[where]`; an id
+ * appears only as `(id ...)`, only when the entry says the reference dangles,
+ * and only when there is no title to say instead.
+ */
+declare function describeProblem(problem: ProblemLike, table?: ProblemCopyTable): ProblemCopy;
+/** `describeProblem` as one line for a bar that has room for one: the sentence,
+ *  then the next step after a space. */
+declare function problemLine(problem: ProblemLike, table?: ProblemCopyTable): string;
+/**
+ * The codes both validators raise in some form, in the family's voice. An app
+ * spreads this into its own table and adds its own codes over it; a code an
+ * app does not raise costs nothing.
+ *
+ *   duplicate-gameid    two things share one Game ID
+ *   invalid-gameid      a Game ID that breaks the address rule
+ *   dangling-reference  a jump / tag / property points at something gone
+ *   unknown-property    a condition or effect names an undeclared property
+ *   missing-name        a thing that needs a name has none
+ *   empty               a container with nothing in it
+ *   stale-build         the playable build is older than the source
+ *   merge-conflict      a file still carries conflict markers
+ */
+declare const defaultProblemCopy: ProblemCopyTable;
+
+export { type ProblemCopy, type ProblemCopyEntry, type ProblemCopyTable, type ProblemLike, defaultProblemCopy, describeProblem, problemLine, problemName };

package/dist/problems.js

@@ -0,0 +1,3 @@
+export { defaultProblemCopy, describeProblem, problemLine, problemName } from './chunk-DS4XXAZS.js';
+//# sourceMappingURL=problems.js.map
+//# sourceMappingURL=problems.js.map

package/dist/problems.js.map

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

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 };