smoodly 0.0.15 → 0.0.17

package/dist/admin/ui/theme.js

@@ -25,6 +25,7 @@ const TOKENS_LIGHT = `
   --line:#E8E3DA; --line-dashed:#D8D1C4; --line-soft:#EFEBE3;
   --text:#1F1D1A; --text-secondary:#4E4942; --text-muted:#7A746A; --text-subtle:#A39C90; --text-disabled:#C4BDB1;
   --selection:var(--accent); --nav-active-bg:var(--accent-soft); --nav-active-fg:var(--accent);
+  --selection-global:#C4620C;
   --hover:rgba(31,29,26,.05); --press:rgba(31,29,26,.09); --control-hover:#F8F6F1;
   --btn-secondary-bg:var(--surface); --btn-secondary-hover:#F8F6F1; --tile-hover:var(--surface);
   --bar-bg:transparent; --bar-border:0; --menu-border:0; --card-divider:0;
@@ -40,7 +41,8 @@ const TOKENS_LIGHT = `
   --logo-color:var(--accent);
 
   --status-published-fg:var(--green-700); --status-published-bg:var(--green-50);
-  --status-draft-fg:var(--amber-700); --status-draft-bg:var(--amber-50);
+  --status-changes-fg:var(--amber-700); --status-changes-bg:var(--amber-50);
+  --status-draft-fg:var(--text-muted); --status-draft-bg:var(--surface-inset);
   --status-scheduled-fg:var(--accent); --status-scheduled-bg:var(--accent-soft);
   --status-saved-dot:var(--green-500);
   --warn:var(--amber-700); --warn-soft:var(--amber-50);
@@ -61,6 +63,7 @@ const TOKENS_LIGHT = `
 `;
 const TOKENS_DARK = `
   --accent:#6CC4A6; --accent-hover:#82D2B8; --accent-soft:rgba(108,196,166,.18); --accent-line:#6CC4A6; --on-accent:#0B1F18;
+  --selection-global:#F09A5C;
   --bg:#1C1A17; --canvas:#141210; --surface:#27241F; --surface-form:#27241F; --surface-inset:#1C1A17;
   --input-bg:#211E1A; --input-hover-bg:#211E1A; --input-focus-bg:#211E1A;
   --line:#3A3630; --line-dashed:#4A453D; --line-soft:#3A3630;
@@ -70,7 +73,8 @@ const TOKENS_DARK = `
   --toolbar-bg:#0F0E0C; --toolbar-fg:#F1EDE6;
 
   --status-published-fg:var(--green-300); --status-published-bg:rgba(111,211,154,.14);
-  --status-draft-fg:var(--amber-300); --status-draft-bg:rgba(232,184,90,.14);
+  --status-changes-fg:var(--amber-300); --status-changes-bg:rgba(232,184,90,.14);
+  --status-draft-fg:var(--text-muted); --status-draft-bg:var(--press);
   --warn:var(--amber-300); --warn-soft:rgba(232,184,90,.14);
   --danger:var(--red-300); --danger-soft:rgba(244,102,92,.14);
 
@@ -106,6 +110,7 @@ const SCALE = `
   --table-pad:8px 12px; --table-top:80px; --canvas-pad:24px 40px 0; --card-pad:16px 18px; --card-gap:12px; --form-pad:32px 40px;
   --border:1px solid var(--line);
   --outline-selection:2px solid var(--selection);
+  --outline-selection-global:2px solid var(--selection-global);
 `;
 /* ── TEMPORARY: the original look, kept for side-by-side comparison while
    the warm restyle lands. Frozen copies of the three strings above as they
@@ -128,11 +133,13 @@ const TECHNICAL_LIGHT = `
   --text:var(--gray-900); --text-muted:var(--gray-600); --text-subtle:var(--gray-500);
   --accent:var(--brand-600); --on-accent:#FFFFFF; --accent-soft:var(--brand-50);
   --selection:var(--brand-600); --nav-active-bg:var(--brand-100); --nav-active-fg:var(--brand-600);
+  --selection-global:#D2610A;
   --hover:rgba(15,20,32,.045); --press:rgba(15,20,32,.08);
   --control-hover:var(--gray-100);
 
   --status-published-fg:var(--green-700); --status-published-bg:var(--green-50);
-  --status-draft-fg:var(--amber-700); --status-draft-bg:var(--amber-50);
+  --status-changes-fg:var(--amber-700); --status-changes-bg:var(--amber-50);
+  --status-draft-fg:var(--text-muted); --status-draft-bg:var(--surface-inset);
   --status-scheduled-fg:var(--accent); --status-scheduled-bg:var(--accent-soft);
   --status-saved-dot:var(--green-500);
   --warn:var(--amber-700); --warn-soft:var(--amber-50);
@@ -155,12 +162,14 @@ const TECHNICAL_DARK = `
   --line:#2A2F3B; --line-dashed:#2A2F3B;
   --text:#EEF0F5; --text-muted:#8C94A8; --text-subtle:#6B7386;
   --accent:var(--brand-300); --on-accent:#06122F; --accent-soft:rgba(110,150,255,.16);
+  --selection-global:#F2A35F;
   --nav-active-bg:rgba(110,150,255,.14); --nav-active-fg:var(--brand-200);
   --hover:rgba(238,240,245,.05); --press:rgba(238,240,245,.09);
   --control-hover:var(--input-bg);
 
   --status-published-fg:var(--green-300); --status-published-bg:rgba(111,211,154,.14);
-  --status-draft-fg:var(--amber-300); --status-draft-bg:rgba(232,184,90,.14);
+  --status-changes-fg:var(--amber-300); --status-changes-bg:rgba(232,184,90,.14);
+  --status-draft-fg:var(--text-muted); --status-draft-bg:var(--press);
   --warn:var(--amber-300); --warn-soft:rgba(232,184,90,.14);
   --danger:var(--red-300); --danger-soft:rgba(244,102,92,.14);
 
@@ -181,6 +190,7 @@ const TECHNICAL_SCALE = `
   --nav-w:72px; --inspector-w:380px;
   --border:1px solid var(--line);
   --outline-selection:1.5px solid var(--selection);
+  --outline-selection-global:1.5px solid var(--selection-global);
 `;
 /* The tokens the warm restyle added, with the values the technical look
    implied, so the frozen block above renders the old shapes too. */
@@ -293,9 +303,7 @@ body:has(.sm-admin){margin:0}
 .sm-rail__btn[aria-current="page"],.sm-rail__btn[aria-expanded="true"]{color:var(--nav-active-fg);font-weight:600}
 .sm-rail__btn[aria-current="page"]:hover,.sm-rail__btn[aria-expanded="true"]:hover{color:var(--nav-active-fg)}
 .sm-rail__btn[aria-current="page"] .sm-rail__tile,.sm-rail__btn[aria-expanded="true"] .sm-rail__tile{background:var(--nav-active-bg)}
-.sm-rail__tile svg{width:18px;height:18px;stroke:currentColor;fill:none;stroke-width:1.75;stroke-linecap:round;stroke-linejoin:round}
-.sm-rail__chev{position:absolute;right:4px;bottom:3px;width:8px;height:8px}
-.sm-rail__chev svg{width:8px;height:8px;stroke-width:3}
+.sm-rail__tile svg{width:18px;height:18px;stroke:currentColor;fill:none;stroke-width:2;stroke-linecap:round;stroke-linejoin:round}
 .sm-rail__label{letter-spacing:.01em;white-space:nowrap}
 /* Not greyed: the reference renders every inactive item at --text and marks
    the unavailable ones only by being inert (no pointer, no hover). */
@@ -315,6 +323,11 @@ body:has(.sm-admin){margin:0}
 }
 .sm-rail__menu[data-open="true"]{display:flex}
 .sm-rail__menu--up{top:auto;bottom:0}
+/* The Collections flyout opens on hover, so it is roomier (the names at --text-lg) and an invisible
+   bridge spans the 6px gap so the pointer can cross from the rail without closing it. */
+.sm-rail__menu--collections{width:208px;padding:8px;gap:2px;font-size:var(--text-lg)}
+.sm-rail__menu--collections::before{content:"";position:absolute;left:-8px;top:0;bottom:0;width:8px}
+.sm-rail__menu--collections .sm-rail__menu-item{padding:9px 12px}
 .sm-rail__menu-title{font-size:9px;font-weight:600;letter-spacing:var(--tracking-label);text-transform:uppercase;color:var(--text-muted);padding:6px 8px 4px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .sm-rail__menu-item{
   appearance:none;background:none;border:0;width:100%;display:flex;align-items:center;justify-content:space-between;
@@ -375,7 +388,7 @@ body:has(.sm-admin){margin:0}
 .sm-btn--ok{background:var(--status-published-bg);color:var(--status-published-fg);font-weight:600;padding:0 18px}
 .sm-btn:disabled,.sm-btn[aria-disabled="true"]{opacity:.5;cursor:default;pointer-events:none}
 .sm-btn:focus-visible,.sm-iconbtn:focus-visible,.sm-nav-item:focus-visible,
-.sm-tab:focus-visible,.sm-seg__opt:focus-visible,.sm-row:focus-visible{
+.sm-tab:focus-visible,.sm-seg__opt:focus-visible,.sm-pill:focus-visible,.sm-row:focus-visible{
   outline:2px solid var(--accent);outline-offset:1px
 }
 
@@ -403,6 +416,10 @@ body:has(.sm-admin){margin:0}
 .sm-label__mark{display:inline-flex;color:var(--text-subtle);cursor:help}
 .sm-label__mark svg{width:13px;height:13px}
 .sm-counter{font-size:var(--text-sm);color:var(--text-subtle)}
+.sm-field__aside{display:flex;align-items:baseline;gap:10px;flex:none}
+/* A head's text action (a list's Collapse all / Expand all): a small accent link. */
+.sm-field__action{background:none;border:0;padding:0;font:inherit;font-size:var(--text-sm);font-weight:600;color:var(--accent);cursor:pointer}
+.sm-field__action:hover{color:var(--accent-hover)}
 .sm-hint{font-size:var(--text-sm);color:var(--text-muted)}
 .sm-input,.sm-textarea,.sm-select{
   width:100%;min-width:0;border:1px solid var(--input-border);border-radius:var(--radius-md);
@@ -494,7 +511,8 @@ body:has(.sm-admin){margin:0}
 .sm-rtcard__icon{width:18px;height:18px;flex:none;border-radius:var(--radius-xs);background:var(--accent-soft);color:var(--accent);display:grid;place-items:center;font-size:11px}
 .sm-rtcard__title{flex:1;min-width:0;font-weight:600;font-size:var(--text-sm);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .sm-rtcard__body{display:flex;flex-direction:column;gap:10px;padding:10px 12px 12px;border-top:1px solid var(--line)}
-.sm-rtcard__thumb{display:block;width:100%;max-height:160px;object-fit:cover;border-radius:var(--radius-sm);background:var(--surface-inset)}
+/* The whole image, letterboxed on the inset tone, never cropped: the card is a preview, not a crop. */
+.sm-rtcard__thumb{display:block;width:100%;height:160px;object-fit:contain;border-radius:var(--radius-sm);background:var(--surface-inset)}
 .sm-rtcard__file{font-size:var(--text-sm);color:var(--text-muted);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .sm-richtext__content blockquote{padding-left:12px;border-left:2px solid var(--line);color:var(--text-muted)}
 .sm-richtext__content a{color:var(--accent);text-decoration:underline;text-underline-offset:3px;text-decoration-color:var(--accent-line)}
@@ -523,6 +541,23 @@ body:has(.sm-admin){margin:0}
   display:flex;align-items:center;justify-content:space-between;gap:8px;min-height:var(--control-h);padding:0 6px 0 14px;
   border-radius:var(--radius-md);background:var(--surface-inset);color:var(--text-muted);font-size:var(--text-sm);
 }
+/* The custom section's row cards and the width bar (spec 2026-09-14 §6). */
+.sm-rowcards{display:flex;flex-direction:column;gap:12px;align-items:stretch}
+.sm-rowcard{display:flex;flex-direction:column;gap:12px;padding:12px;border:1px solid var(--line);border-radius:var(--radius-md);background:var(--surface);min-width:0}
+.sm-rowcard__head{display:flex;align-items:center;gap:4px}
+.sm-rowcard__title{flex:1;font-weight:600}
+.sm-rowcard__presets{display:flex;flex-wrap:wrap;gap:6px;margin-top:8px}
+/* Secondary buttons sit on the white card: an outline so they read as buttons. */
+.sm-rowcard__presets .sm-btn{height:var(--control-h-sm);padding:0 10px;font-size:var(--text-sm);border:1px solid var(--line)}
+.sm-rowcards > .sm-btn{align-self:flex-start;border:1px solid var(--line)}
+.sm-stepper{display:flex;align-items:center;gap:8px}
+.sm-stepper__value{min-width:20px;text-align:center;font-weight:600}
+.sm-spanbar{display:flex;gap:2px;height:32px;background:var(--seg-bg);border-radius:var(--radius-md);padding:3px;user-select:none}
+.sm-spanbar__col{position:relative;display:flex;align-items:center;justify-content:center;min-width:0;background:var(--surface);border-radius:6px;font-size:var(--text-sm);color:var(--text-muted)}
+.sm-spanbar__handle{position:absolute;right:-6px;top:0;bottom:0;width:10px;padding:0;border:0;background:transparent;cursor:col-resize;touch-action:none;z-index:1}
+.sm-spanbar__handle::after{content:"";position:absolute;left:4px;top:8px;bottom:8px;width:2px;border-radius:1px;background:var(--text-muted)}
+.sm-spanbar__handle:focus-visible{outline:none}
+.sm-spanbar__handle:focus-visible::after,.sm-spanbar__handle:hover::after{background:var(--accent)}
 /* A field revealed from a canvas click: one pulse of the accent, then nothing. */
 .sm-field--reveal{animation:sm-reveal .9s ease-out;border-radius:var(--radius-sm)}
 @keyframes sm-reveal{0%{outline:2px solid var(--selection);outline-offset:4px}100%{outline:2px solid transparent;outline-offset:4px}}
@@ -592,6 +627,15 @@ body:has(.sm-admin){margin:0}
   border-radius:var(--radius-sm);line-height:1;height:24px;
 }
 .sm-rowmenu:hover{background:var(--surface-inset);color:var(--text)}
+.sm-dotmenu{
+  width:var(--button-h);height:var(--button-h);flex:none;border-radius:50%;border:0;padding:0;
+  background:var(--btn-secondary-bg);color:var(--text-muted);font:inherit;font-weight:700;letter-spacing:1px;
+  display:grid;place-items:center;cursor:pointer;
+}
+.sm-dotmenu:hover{background:var(--btn-secondary-hover);color:var(--text)}
+.sm-dotmenu:disabled{opacity:.4;cursor:default}
+.sm-dotmenu:disabled:hover{background:var(--btn-secondary-bg);color:var(--text-muted)}
+.sm-picker--menu{position:absolute;top:calc(100% + 6px);right:0;width:220px;z-index:60}
 
 /* Status pill: a dot before the word in the warm look (none in the technical). */
 .sm-badge{
@@ -637,6 +681,18 @@ body:has(.sm-admin){margin:0}
 .sm-seg__opt[aria-pressed="true"]{background:var(--surface);color:var(--text);font-weight:600;box-shadow:var(--shadow-seg)}
 /* A locale the record does not have yet: subtle, still a button (it opens the add pane). */
 .sm-seg__opt--absent{color:var(--text-subtle)}
+/* f.radio as a pill row (spec 2026-09-14 §5): small chips a step below the tabs and the
+   segmented control — no track, the chosen pill filled in the soft accent, the rest bare.
+   Wraps when the labels need it. */
+.sm-pills{display:flex;flex-wrap:wrap;gap:4px;padding:2px 0}
+.sm-pill{
+  height:var(--control-h-sm);padding:0 10px;border:0;border-radius:var(--radius-btn);background:transparent;
+  color:var(--text-muted);font:inherit;font-size:var(--text-sm);font-weight:500;line-height:1;cursor:pointer;white-space:nowrap;
+}
+.sm-pill:hover{color:var(--text);background:var(--surface-inset)}
+.sm-pill[aria-pressed="true"]{background:var(--accent-soft);color:var(--accent);font-weight:600}
+/* The custom-CSS box: code, no wrapping, no spellcheck. */
+.sm-css{font-family:var(--font-mono);font-size:12px;line-height:1.5;white-space:pre;overflow-x:auto}
 /* Switch (f.boolean, the SEO noindex toggle): a pill track, knob slides right when on. */
 .sm-switch{width:36px;height:20px;padding:2px;border:0;border-radius:var(--radius-round);background:var(--seg-bg);cursor:pointer;display:inline-flex;align-items:center;flex:none}
 .sm-switch[aria-checked="true"]{background:var(--accent)}
@@ -664,9 +720,11 @@ body:has(.sm-admin){margin:0}
 .sm-banner--error{background:var(--danger-soft);color:var(--danger)}
 .sm-banner--ok{background:var(--status-published-bg);color:var(--status-published-fg)}
 .sm-banner--warn{background:var(--warn-soft);color:var(--warn)}
+.sm-fielderr{margin:6px 0 0;padding-left:18px;font:inherit;font-size:var(--text-sm);font-family:var(--font-mono)}
+.sm-fielderr__field{background:none;border:0;padding:0;font:inherit;color:inherit;text-decoration:underline;cursor:pointer}
 
 /* ── cards ─────────────────────────────────────────────────────────── */
-/* The inspector column (editor, entry and shared forms) is a stack of
+/* The inspector column (editor, entry and global forms) is a stack of
    cards; the technical look draws them flush with a hairline between. */
 .sm-inspector{
   display:flex;flex-direction:column;gap:var(--card-gap);min-height:0;overflow:auto;
@@ -683,7 +741,10 @@ body:has(.sm-admin){margin:0}
 }
 .sm-inspector__head{display:flex;align-items:center;justify-content:space-between;gap:8px;flex:none}
 .sm-inspector__body{display:flex;flex-direction:column;gap:14px}
-/* The form card: the main column of the entry and shared forms. Every
+/* A tab's groups (spec 2026-09-14 §5): the section's own settings untitled, then Spacing & layout and Advanced under a hairline. */
+.sm-inspector__group{display:flex;flex-direction:column;gap:12px}
+.sm-inspector__group+.sm-inspector__group{margin-top:8px;padding-top:12px;border-top:1px solid var(--line)}
+/* The form card: the main column of the entry and global forms. Every
    field (and the banner) is a centred 680px column — a reading width —
    while the card itself still fills the main area. */
 .sm-form{
@@ -732,12 +793,13 @@ body:has(.sm-admin){margin:0}
   letter-spacing:var(--blocktag-tracking);text-transform:var(--blocktag-transform);padding:3px 10px;
   border-radius:var(--blocktag-radius);white-space:nowrap;
 }
+.sm-blocktag--global{background:var(--selection-global)}
 .sm-blocktoolbar{
   display:flex;gap:2px;padding:3px;background:var(--toolbar-bg);border-radius:var(--radius-btn);
   box-shadow:var(--shadow-float);
 }
 .sm-blocktoolbar__note{font-family:var(--font-mono);font-size:var(--text-xs);color:var(--toolbar-fg);opacity:.7;padding:4px 8px}
-/* The insert affordance between blocks: a labelled pill (the label is
+/* The insert affordance between sections: a labelled pill (the label is
    hidden in the technical look, leaving the 24px circle). */
 .sm-plus{
   display:inline-flex;align-items:center;gap:8px;height:var(--plus-h);min-width:var(--plus-h);padding:var(--plus-pad);
@@ -785,6 +847,10 @@ body:has(.sm-admin){margin:0}
   border:0;border-radius:var(--radius-sm);padding:8px 10px;cursor:pointer;color:var(--text);font:inherit;
 }
 .sm-picker__item:hover{background:var(--nav-active-bg)}
+/* after the base item rule: same specificity, so source order decides (ActionMenu states) */
+.sm-picker__item:disabled{opacity:.4;cursor:default}
+.sm-picker__item:disabled:hover{background:transparent}
+.sm-picker__item--danger{color:var(--danger)}
 .sm-picker__icon{
   width:26px;height:26px;flex:none;border-radius:var(--radius-sm);background:var(--accent-soft);
   color:var(--accent);display:grid;place-items:center;font-size:13px;
@@ -796,7 +862,9 @@ body:has(.sm-admin){margin:0}
 }
 
 /* ── media ─────────────────────────────────────────────────────────── */
-.sm-modal{position:fixed;inset:0;z-index:70;background:rgba(0,0,0,.45);display:grid;place-items:center;padding:24px}
+/* The single track is minmax(0,1fr), not auto: an auto track grows to the panel's own width, so the
+   panel's max-width:100% would cap at nothing and a 1200px History panel ran past a laptop viewport. */
+.sm-modal{position:fixed;inset:0;z-index:70;background:rgba(0,0,0,.45);display:grid;grid-template-columns:minmax(0,1fr);grid-template-rows:minmax(0,1fr);place-items:center;padding:24px}
 .sm-modal__panel{
   max-width:100%;max-height:100%;display:flex;flex-direction:column;background:var(--surface);
   border:var(--menu-border);border-radius:var(--radius-card);box-shadow:var(--shadow-pop);overflow:hidden;
@@ -804,6 +872,18 @@ body:has(.sm-admin){margin:0}
 .sm-modal__head{display:flex;align-items:center;justify-content:space-between;padding:14px 16px 10px;border-bottom:var(--card-divider)}
 .sm-modal__body{padding:12px 16px;overflow:auto;display:flex;flex-direction:column;gap:10px;min-height:0}
 .sm-modal__foot{display:flex;justify-content:flex-end;gap:8px;padding:12px 16px 14px;border-top:var(--card-divider)}
+.sm-modal__body--flush{padding:0;gap:0;flex:1}
+/* ── history (spec 2026-09-13) ─────────────────────────────────── */
+.sm-history{display:flex;flex:1;min-height:0}
+.sm-history__list{width:260px;flex:none;overflow:auto;display:flex;flex-direction:column;border-right:var(--card-divider)}
+.sm-history__row{display:flex;align-items:center;justify-content:space-between;gap:8px;padding:10px 12px;border:0;border-bottom:var(--card-divider);background:none;color:inherit;font:inherit;font-size:var(--text-sm);text-align:left;cursor:pointer}
+.sm-history__row:hover{background:var(--input-bg)}
+.sm-history__row--active,.sm-history__row--active:hover{background:var(--input-bg);font-weight:600}
+.sm-history__tag{font-size:var(--text-sm);color:var(--text-muted);padding:1px 8px;border-radius:999px;border:1px solid var(--line-dashed)}
+.sm-history__tag--live{color:var(--status-published-fg);background:var(--status-published-bg);border-color:transparent}
+.sm-history__main{flex:1;min-width:0;display:flex;overflow:auto}
+.sm-history__frame{flex:1;width:100%;height:100%;border:0;background:#fff}
+.sm-history__form{flex:1;min-width:0;margin:0;padding:16px;border:0;pointer-events:none;display:flex;flex-direction:column;gap:14px}
 .sm-picker-bar{display:flex;align-items:center;gap:8px;flex-wrap:wrap}
 .sm-dropzone{
   border:1px dashed var(--line-dashed);border-radius:var(--radius-lg);background:var(--input-bg);color:var(--text-muted);

package/dist/admin/validate.d.ts

@@ -10,11 +10,36 @@ type Desc = {
     min?: unknown;
     fields?: unknown;
     item?: unknown;
+    hidden?: unknown;
+};
+/** What conditions read beyond the current level: the node's two namespaces. */
+export type ValidationScope = {
+    fields?: Record<string, unknown>;
+    settings?: Record<string, unknown>;
 };
 /** The element schemas an element node is validated against (spec 2026-09-08 block nodes §2). */
 export type ElementDescs = Record<string, {
     fields: Record<string, Desc>;
-    styles?: Record<string, Desc>;
+    settings?: Record<string, Desc>;
 }>;
-export declare function validateFields(values: Record<string, unknown>, descriptors: Record<string, Desc>, elements?: ElementDescs): FieldError[];
+/** Validate one value map. Without `scope.fields` the values ARE the fields (an entry, a page, an object global). */
+export declare function validateFields(values: Record<string, unknown>, descriptors: Record<string, Desc>, elements?: ElementDescs, scope?: ValidationScope): FieldError[];
+/** A tree node (or a visual global, in node shape) against its schema: fields, settings (prefixed), css (spec 2026-09-14 §3, §4). */
+export declare function validateNode(node: {
+    fields?: Record<string, unknown>;
+    settings?: Record<string, unknown>;
+    css?: unknown;
+    [other: string]: unknown;
+}, schema: {
+    fields: Record<string, Desc>;
+    settings?: Record<string, Desc>;
+}, elements?: ElementDescs): FieldError[];
+/** A custom section node (spec 2026-09-14 §6): the columns' richtext (element nodes included), the row structure, the css.
+ *  The generic walk's own words on `rows.<i>.spans` are dropped (`spans` is no descriptor type it knows) so rowsProblems
+ *  is the one voice on structure; the columns' richtext errors keep their paths. */
+export declare function validateCustomNode(node: {
+    fields?: Record<string, unknown>;
+    css?: unknown;
+    [other: string]: unknown;
+}, fields: Record<string, Desc>, elements?: ElementDescs): FieldError[];
 export {};

package/dist/admin/validate.js

@@ -2,9 +2,15 @@
 // lives admin/server-side). Entry saves validate; page drafts do NOT
 // (drafts must save freely) — publish validates every node. Objects and
 // lists recurse; error paths are dotted (`cta.href`, `points.2.heading`).
+// A field whose `.hidden()` condition holds is skipped entirely — a hidden
+// required field is not required (spec 2026-09-14 §12); the same isHidden
+// the form uses decides, over the same scope.
 import { optionValues } from "../fields.js";
+import { isHidden } from "../conditions.js";
+import { cssProblem } from "../css.js";
 import { hasContent } from "./richtext-doc.js";
 import { ELEMENT_NODE, richtextBlocks } from "../richtext-walk.js";
+import { rowsProblems } from "../custom/rows.js";
 const subfields = (d) => d.fields && typeof d.fields === "object" ? d.fields : {};
 const itemOf = (d) => d.item && typeof d.item === "object" ? d.item : undefined;
 const isEmpty = (v) => v === undefined || v === null || v === "" || (Array.isArray(v) && v.length === 0);
@@ -12,7 +18,7 @@ const isEmpty = (v) => v === undefined || v === null || v === "" || (Array.isArr
  *  may be absent — may be absent altogether. */
 const mayBeAbsent = (d) => d.optional === true || d.type === "boolean" || (d.type === "object" && Object.values(subfields(d)).every(mayBeAbsent));
 const plural = (n, word) => `${n} ${word}${n === 1 ? "" : "s"}`;
-function validateValue(path, value, d, errors, elements) {
+function validateValue(path, value, d, errors, elements, scope) {
     if (isEmpty(value)) {
         if (!mayBeAbsent(d))
             errors.push({ field: path, message: "Required." });
@@ -34,8 +40,9 @@ function validateValue(path, value, d, errors, elements) {
             const el = typeof a.name === "string" ? elements[a.name] : undefined;
             if (el) {
                 const fields = (a.fields && typeof a.fields === "object" ? a.fields : {});
-                for (const [k, sub] of Object.entries(el.fields))
-                    validateValue(`${path}.elements.${i}.${k}`, fields[k], sub, errors, elements);
+                const settings = (a.settings && typeof a.settings === "object" ? a.settings : {});
+                validateMap(`${path}.elements.${i}`, fields, el.fields, errors, elements, { self: fields, fields, settings });
+                validateMap(`${path}.elements.${i}.settings`, settings, el.settings ?? {}, errors, elements, { self: settings, fields, settings });
             }
             i++;
         }
@@ -57,8 +64,9 @@ function validateValue(path, value, d, errors, elements) {
         if (typeof d.max === "number" && value.length > d.max)
             errors.push({ field: path, message: `At most ${plural(d.max, "item")}.` });
         const item = itemOf(d);
-        if (item)
-            value.forEach((v, i) => validateValue(`${path}.${i}`, v, item, errors, elements));
+        // A scalar item's condition reads the list's own level; an object item reads itself (the object branch).
+        if (item && !isHidden(item, scope))
+            value.forEach((v, i) => validateValue(`${path}.${i}`, v, item, errors, elements, scope));
         return;
     }
     if (d.type === "object") {
@@ -66,8 +74,7 @@ function validateValue(path, value, d, errors, elements) {
             errors.push({ field: path, message: "Must be an object." });
             return;
         }
-        for (const [k, sub] of Object.entries(subfields(d)))
-            validateValue(`${path}.${k}`, value[k], sub, errors, elements);
+        validateMap(path, value, subfields(d), errors, elements, { ...scope, self: value });
         return;
     }
     if (d.type === "boolean") {
@@ -97,9 +104,39 @@ function validateValue(path, value, d, errors, elements) {
         errors.push({ field: path, message: `Must be at most ${d.max} characters.` });
     }
 }
-export function validateFields(values, descriptors, elements = {}) {
+/** One descriptor map at one level: hidden entries are skipped. `prefix` is the dotted path above it ("" at the top). */
+function validateMap(prefix, values, descriptors, errors, elements, scope) {
+    for (const [key, d] of Object.entries(descriptors)) {
+        if (isHidden(d, scope))
+            continue;
+        validateValue(prefix === "" ? key : `${prefix}.${key}`, values[key], d, errors, elements, scope);
+    }
+}
+/** Validate one value map. Without `scope.fields` the values ARE the fields (an entry, a page, an object global). */
+export function validateFields(values, descriptors, elements = {}, scope = {}) {
     const errors = [];
-    for (const [field, d] of Object.entries(descriptors))
-        validateValue(field, values[field], d, errors, elements);
+    validateMap("", values, descriptors, errors, elements, { self: values, fields: scope.fields ?? values, settings: scope.settings });
+    return errors;
+}
+/** A tree node (or a visual global, in node shape) against its schema: fields, settings (prefixed), css (spec 2026-09-14 §3, §4). */
+export function validateNode(node, schema, elements = {}) {
+    const fields = node.fields ?? {};
+    const settings = node.settings ?? {};
+    const scope = { fields, settings };
+    const errors = validateFields(fields, schema.fields, elements, scope);
+    for (const e of validateFields(settings, schema.settings ?? {}, elements, scope))
+        errors.push({ field: `settings.${e.field}`, message: e.message });
+    if (typeof node.css === "string" && node.css !== "") {
+        const problem = cssProblem(node.css);
+        if (problem)
+            errors.push({ field: "css", message: problem });
+    }
     return errors;
 }
+/** A custom section node (spec 2026-09-14 §6): the columns' richtext (element nodes included), the row structure, the css.
+ *  The generic walk's own words on `rows.<i>.spans` are dropped (`spans` is no descriptor type it knows) so rowsProblems
+ *  is the one voice on structure; the columns' richtext errors keep their paths. */
+export function validateCustomNode(node, fields, elements = {}) {
+    const errors = validateNode(node, { fields }, elements).filter((e) => !e.field.startsWith("rows.") || e.field.includes(".columns."));
+    return [...rowsProblems(node.fields?.rows), ...errors];
+}

package/dist/collections.d.ts

@@ -9,10 +9,10 @@ export type EntryOrder = "manual" | {
 export declare const DEFAULT_ORDER: EntryOrder;
 export declare const BUILT_IN_ORDER_FIELDS: readonly ["createdAt", "updatedAt"];
 export type CollectionSchema<F extends BuilderMap = BuilderMap, N extends string = string> = {
-    /** "shared" marks a code-declared singleton (spec 2026-09-07 decision
-     *  4): a shared item IS a collection with one entry, so both entry
+    /** "global" marks a code-declared singleton (spec 2026-09-07 decision
+     *  4): a global item IS a collection with one entry, so both entry
      *  stores accept it in the same list and branch on this. */
-    kind: "collection" | "shared";
+    kind: "collection" | "global";
     /** Literal when declared inline (spec 2026-09-11 §6), so a queries object can check names. */
     name: N;
     title: string;
@@ -29,11 +29,6 @@ export type CollectionSchema<F extends BuilderMap = BuilderMap, N extends string
     admin?: {
         listColumns?: string[];
     };
-    /** Per-locale version history for this collection's entries (spec
-     *  2026-09-06 §7): every save becomes an `entry_versions` snapshot and
-     *  publish moves a pointer, as on pages. Off by default — a People list
-     *  does not want history; articles do. */
-    versions?: boolean;
     /** phantom: the entry value shape, used by f.ref target inference */
     readonly __entry?: NamespaceValues<F>;
 };
@@ -52,5 +47,4 @@ export declare function collection<F extends BuilderMap, const N extends string
     admin?: {
         listColumns?: string[];
     };
-    versions?: boolean;
 }): CollectionSchema<F, N>;

package/dist/collections.js

@@ -5,7 +5,7 @@ export const collectionDepth = (c) => c.tree?.depth ?? 1;
 export function collection(input) {
     if (!input?.name)
         throw new Error("smoodly: a collection requires a name.");
-    if (["shared", "asset", "media"].includes(input.name))
+    if (["global", "asset", "media"].includes(input.name))
         throw new Error(`smoodly: "${input.name}" is a reserved name.`);
     if (input.tree !== undefined && (!Number.isInteger(input.tree.depth) || input.tree.depth < 1)) {
         throw new Error(`smoodly: collection "${input.name}" declares an invalid tree depth.`);
@@ -43,7 +43,6 @@ export function collection(input) {
         ...(input.path !== undefined ? { path: input.path } : {}),
         ...(input.tree !== undefined ? { tree: input.tree } : {}),
         ...(input.order !== undefined ? { order: input.order } : {}),
-        ...(input.versions ? { versions: true } : {}),
         admin: input.admin,
     };
 }

package/dist/conditions.d.ts

@@ -0,0 +1,33 @@
+import type { Descriptor } from "./fields.ts";
+export type ConditionOp = "is" | "isNot" | "in" | "isEmpty" | "isNotEmpty";
+export type Condition = {
+    path: string;
+    op: ConditionOp;
+    value?: unknown;
+};
+export declare function when(path: string): {
+    is: (value: unknown) => Condition;
+    isNot: (value: unknown) => Condition;
+    in: (values: readonly unknown[]) => Condition;
+    isEmpty: () => Condition;
+    isNotEmpty: () => Condition;
+};
+/** Where a condition reads: the current level's values, and the two namespaces. */
+export type ConditionScope = {
+    self: Record<string, unknown> | undefined;
+    fields?: Record<string, unknown>;
+    settings?: Record<string, unknown>;
+};
+/** `["settings", "mediaType"]` for a prefixed path, `[null, "kind"]` for a bare one. */
+export declare function splitConditionPath(path: string): [("fields" | "settings") | null, string];
+export declare function evaluate(c: Condition, scope: ConditionScope): boolean;
+/** True when the descriptor's condition holds; false without one. */
+export declare function isHidden(d: object, scope: ConditionScope): boolean;
+/** Every condition in both namespaces names a field that exists: a typo
+ *  fails at registration, not in the form. Walks objects (siblings are the
+ *  object's keys) and lists (an object item's keys; a scalar item reads the
+ *  list's own level). */
+export declare function assertConditions(owner: string, maps: {
+    fields: Record<string, Descriptor>;
+    settings: Record<string, Descriptor>;
+}): void;

package/dist/conditions.js

@@ -0,0 +1,79 @@
+export function when(path) {
+    if (typeof path !== "string" || path === "")
+        throw new Error("smoodly: f.when() needs a field path.");
+    return {
+        is: (value) => ({ path, op: "is", value }),
+        isNot: (value) => ({ path, op: "isNot", value }),
+        in: (values) => ({ path, op: "in", value: [...values] }),
+        isEmpty: () => ({ path, op: "isEmpty" }),
+        isNotEmpty: () => ({ path, op: "isNotEmpty" }),
+    };
+}
+const PREFIXES = ["fields", "settings"];
+/** `["settings", "mediaType"]` for a prefixed path, `[null, "kind"]` for a bare one. */
+export function splitConditionPath(path) {
+    for (const p of PREFIXES)
+        if (path.startsWith(`${p}.`))
+            return [p, path.slice(p.length + 1)];
+    return [null, path];
+}
+function lookup(path, scope) {
+    const [ns, key] = splitConditionPath(path);
+    const holder = ns === null ? scope.self : scope[ns];
+    return holder?.[key];
+}
+/** Empty as the validator sees it, plus a media value with no asset. */
+const isEmptyValue = (v) => v === undefined || v === null || v === "" || (Array.isArray(v) && v.length === 0) ||
+    (typeof v === "object" && !Array.isArray(v) && Object.keys(v).length === 0) ||
+    (typeof v === "object" && !Array.isArray(v) && "asset" in v && typeof v.asset !== "string");
+export function evaluate(c, scope) {
+    const v = lookup(c.path, scope);
+    switch (c.op) {
+        case "is": return v === c.value;
+        case "isNot": return v !== c.value;
+        case "in": return Array.isArray(c.value) && c.value.includes(v);
+        case "isEmpty": return isEmptyValue(v);
+        case "isNotEmpty": return !isEmptyValue(v);
+        default: return false;
+    }
+}
+const isCondition = (c) => typeof c === "object" && c !== null && typeof c.path === "string" && typeof c.op === "string";
+/** True when the descriptor's condition holds; false without one. */
+export function isHidden(d, scope) {
+    const { hidden } = d;
+    return isCondition(hidden) ? evaluate(hidden, scope) : false;
+}
+/** Every condition in both namespaces names a field that exists: a typo
+ *  fails at registration, not in the form. Walks objects (siblings are the
+ *  object's keys) and lists (an object item's keys; a scalar item reads the
+ *  list's own level). */
+export function assertConditions(owner, maps) {
+    const top = { fields: new Set(Object.keys(maps.fields)), settings: new Set(Object.keys(maps.settings)) };
+    const check = (key, d, siblings) => {
+        if (d.hidden === undefined)
+            return;
+        if (!isCondition(d.hidden))
+            throw new Error(`smoodly: ${owner}: "${key}" has a malformed hidden condition — use f.when(path).`);
+        const [ns, name] = splitConditionPath(d.hidden.path);
+        const known = ns === null ? siblings : top[ns];
+        if (!known.has(name))
+            throw new Error(`smoodly: ${owner}: "${key}" is hidden by "${d.hidden.path}", which is not a field.`);
+    };
+    const walk = (map) => {
+        const siblings = new Set(Object.keys(map));
+        for (const [key, d] of Object.entries(map)) {
+            check(key, d, siblings);
+            if (d.type === "object")
+                walk(d.fields);
+            if (d.type === "list") {
+                const item = d.item;
+                if (item.type === "object")
+                    walk(item.fields);
+                else
+                    check(key, item, siblings);
+            }
+        }
+    };
+    walk(maps.fields);
+    walk(maps.settings);
+}