smoodly 0.0.60 → 0.0.62

package/dist/admin/ui/theme.js

@@ -34,8 +34,8 @@ const TOKENS_LIGHT = `
   --selection-global:#C4620C;
   --hover:rgba(21,23,39,.05); --press:rgba(21,23,39,.09); --control-hover:#ECEDF1; --canvas-ground:#EDEDED;
   --btn-secondary-bg:var(--surface); --btn-secondary-hover:#ECEDF1;
-  /* The rail sits on the frame: its own greys, the active tile a white tint. */
-  --rail-fg:#B9BDCE; --rail-active-fg:#FFFFFF; --rail-active-bg:rgba(255,255,255,.14); --rail-hover-bg:rgba(255,255,255,.08);
+  /* The navigation bar sits on the frame: its own greys, the active item a white tint, its dark menus a step lighter than the frame. */
+  --navbar-fg:#B9BDCE; --navbar-active-fg:#FFFFFF; --navbar-active-bg:rgba(255,255,255,.14); --navbar-hover-bg:rgba(255,255,255,.08); --navbar-menu-bg:#242840;
   --bar-bg:transparent; --bar-border:0; --menu-border:0; --card-divider:0;
   --card-title-size:var(--text-md); --card-title-color:var(--text);
   /* In-card segmented (tabs, the span bar): white track, the chosen option in the tile grey. */
@@ -52,7 +52,7 @@ const TOKENS_LIGHT = `
      dark mode that washed out over the white page, 2026-09-10). */
   --plus-bg:#DDEBE4; --plus-hover:#D0E3D9; --plus-fg:#1C6E5B;
   --plus-icon-bg:#1C6E5B; --plus-icon-fg:#FFFFFF; --plus-shadow:none;
-  --logo-color:var(--accent); --logo-outer:#0B5A49; --logo-inner:#5FC9A0; /* the rail's app icon: deep green square, mint s (2026-10-23) */
+  --logo-color:var(--accent); --logo-outer:#0B5A49; --logo-inner:#5FC9A0; /* the bar's app icon: deep green square, mint s (2026-10-23) */
 
   --status-published-fg:var(--green-700); --status-published-bg:var(--green-50);
   --status-changes-fg:var(--amber-700); --status-changes-bg:var(--amber-50);
@@ -78,7 +78,7 @@ const TOKENS_LIGHT = `
 `;
 /* The handoff's dark proposal (VisualEditor.md, 8c right board): the frame
    and sheet a step darker, tiles a step lighter, fields in the sheet tone;
-   the rail and the logo unchanged. */
+   the bar and the logo unchanged. */
 const TOKENS_DARK = `
   --accent:#6CC4A6; --accent-hover:#82D2B8; --accent-soft:rgba(108,196,166,.18); --accent-line:#6CC4A6; --on-accent:#151727;
   --selection-global:#F09A5C;
@@ -133,10 +133,10 @@ const SCALE = `
   --control-h:40px; --control-h-sm:34px; --control-h-lg:48px; --button-h:36px; --button-h-sm:28px; --row-h:48px; --topbar-h:64px;
   --outline-row-h:36px; --seg-pad-y:7px; --tabs-pad:3px;
   --plus-h:32px; --plus-pad:0 14px 0 6px; --plus-label:inline;
-  --nav-w:72px; --inspector-w:360px; --gutter:20px;
-  /* The frame is 8px above, right of and below the sheet (6px in the handoff, +2px 2026-10-23); the rail fills the left edge. */
-  --frame-pad:8px; --frame-pad-top:8px; --shell-gap:0px; --sheet-radius:20px; --sheet-pad:0 24px 24px;
-  --rail-pad:18px 6px 16px; --rail-logo:block; --rail-logo-opacity:1; --rail-tile-w:44px; --rail-tile-h:40px; --rail-tile-radius:12px;
+  --inspector-w:360px; --gutter:20px;
+  /* The frame is 8px left of, right of and below the sheet (6px in the handoff, +2px 2026-10-23); the bar fills the top edge. */
+  --frame-pad:8px; --shell-gap:0px; --sheet-radius:20px; --sheet-pad:0 24px 24px;
+  --navbar-h:64px; --navbar-pad-x:12px; --navbar-item-h:40px; --navbar-item-radius:10px;
   --topbar-pad:0; --back-size:32px; --back-bg:var(--surface);
   --table-pad:8px 12px; --table-top:80px; --canvas-pad:28px 40px 0; --card-pad:16px 18px; --card-gap:12px; --form-pad:32px 40px;
   --border:1px solid var(--line);
@@ -182,106 +182,106 @@ html:has(.sm-admin),body:has(.sm-admin){overscroll-behavior:none}
 .sm-code{background:var(--surface);border-radius:8px;padding:10px 12px;margin:0;font:13px/1.5 var(--font-mono);overflow:auto}
 
 /* ── shell ─────────────────────────────────────────────────────────── */
-/* Rail | main. The shell is the frame (design_handoff_smoodly_neutral/
-   components/AppShell.html): navy, 8px above, right of and below the main
+/* Bar over main (2026-11-14; a 72px rail on the left before it). The shell is
+   the frame (design_handoff_smoodly_neutral/components/AppShell.html): navy,
+   the navigation bar across its top, 8px right of, left of and below the main
    column, which is the white sheet with a 20px radius and its own inner
-   padding; the rail fills the frame's left edge.
+   padding. The shell owns the viewport and the sheet scrolls inside itself,
+   so the bar stays put.
    The main column stacks the top bar over one tile-shaped region: list,
    form or editor. */
 .sm-shell{
-  display:grid;grid-template-columns:var(--nav-w) 1fr;column-gap:var(--shell-gap);
-  padding:var(--frame-pad-top) var(--frame-pad) var(--frame-pad) 0;height:100vh;height:100dvh;overflow:hidden;background:var(--frame);
+  display:grid;grid-template-rows:var(--navbar-h) minmax(0,1fr);grid-template-columns:minmax(0,1fr);row-gap:var(--shell-gap);
+  padding:0 var(--frame-pad) var(--frame-pad);height:100vh;height:100dvh;overflow:hidden;background:var(--frame);
 }
 .sm-shell>.sm-main{
   min-width:0;min-height:0;display:flex;flex-direction:column;overflow:hidden;
   background:var(--sheet);border-radius:var(--sheet-radius);padding:var(--sheet-pad);
 }
 .sm-wordmark{height:18px;width:auto;color:var(--logo-color);filter:var(--logo-filter);flex:none}
-/* The IconRail (design_handoff_smoodly_neutral/components/IconRail.html):
-   a 72px rail on the frame with the app icon on top, 18px Lucide icons
-   over a 10px label and a 44×40 active tile in a white tint — the rail's
-   own colour tokens, since the frame is navy in both themes. */
-.sm-rail{
-  width:var(--nav-w);height:100%;display:flex;flex-direction:column;align-items:center;gap:18px;
-  padding:var(--rail-pad);background:var(--bar-bg);border-right:var(--bar-border);color:var(--rail-fg);
-  font:500 10px/1 var(--font-sans);position:relative;
-}
+/* The navigation bar: the app icon on the left, the items centred, Deploy and
+   the avatar on the right. The rail's colours, icons and order: 18px Lucide
+   icons beside a 14px label, the active item a white-tint pill. */
+.sm-navbar{
+  display:grid;grid-template-columns:1fr auto 1fr;align-items:center;gap:16px;min-width:0;
+  padding:0 var(--navbar-pad-x);background:var(--bar-bg);color:var(--navbar-fg);
+  font:500 var(--text-md)/1 var(--font-sans);position:relative;z-index:30;
+}
+.sm-navbar__start{display:flex;align-items:center;justify-self:start}
+.sm-navbar__end{display:flex;align-items:center;gap:10px;justify-self:end}
 /* The app icon (the Smoodly menu's trigger): the deep green square with the
-   mint s, 26px wide (2026-10-23; the lozenge before it was 20px, asked for
-   2026-09-26, at .8 opacity). */
-.sm-rail__brand{appearance:none;background:none;border:0;padding:0;margin-bottom:6px;cursor:pointer;display:block;border-radius:6px;color:inherit}
+   mint s (2026-10-23). */
+.sm-navbar__brand{appearance:none;background:none;border:0;padding:0;cursor:pointer;display:block;border-radius:8px;color:inherit}
 /* Hover (2026-10-23): the app icon and the avatar brighten a touch. */
-.sm-rail__logo{transition:filter .15s}
-.sm-rail__brand:hover .sm-rail__logo{filter:brightness(1.3)}
-.sm-rail__user{transition:background .15s}
-.sm-rail__user:hover{background:color-mix(in srgb,var(--accent-soft),#fff 60%)}
-.sm-rail__brand:focus-visible{outline:2px solid var(--rail-active-fg);outline-offset:2px;box-shadow:none}
-.sm-rail__logo{width:26px;height:auto;display:var(--rail-logo);flex:none;opacity:var(--rail-logo-opacity)}
-.sm-rail__ext{width:13px;height:13px;flex:none;margin-left:12px;opacity:.45}
-.sm-rail__menu-item:hover .sm-rail__ext,.sm-rail__menu-item:focus-visible .sm-rail__ext{opacity:.8}
-.sm-rail__menu-version{font-size:var(--text-xs);color:var(--text-subtle);padding:7px 10px 4px;margin-top:3px;border-top:1px solid var(--line)}
-.sm-rail__list{display:flex;flex-direction:column;gap:8px;width:100%;margin:0;padding:0;list-style:none}
-.sm-rail__item{position:relative}
-.sm-rail__btn{
-  appearance:none;background:none;border:0;margin:0;padding:2px 0;width:100%;display:flex;flex-direction:column;
-  align-items:center;gap:6px;color:inherit;font:inherit;cursor:pointer;border-radius:var(--radius-md);text-decoration:none;
-}
-.sm-rail__btn:hover{color:inherit}
-.sm-rail__btn:focus-visible{outline:2px solid var(--rail-active-fg);outline-offset:-2px;box-shadow:none}
-.sm-rail__tile{position:relative;width:var(--rail-tile-w);height:var(--rail-tile-h);border-radius:var(--rail-tile-radius);display:grid;place-items:center;transition:background .12s}
-.sm-rail__btn:hover .sm-rail__tile{background:var(--rail-hover-bg)}
-.sm-rail__btn[aria-current="page"],.sm-rail__btn[aria-expanded="true"]{color:var(--rail-active-fg);font-weight:600}
-.sm-rail__btn[aria-current="page"]:hover,.sm-rail__btn[aria-expanded="true"]:hover{color:var(--rail-active-fg)}
-.sm-rail__btn[aria-current="page"] .sm-rail__tile,.sm-rail__btn[aria-expanded="true"] .sm-rail__tile{background:var(--rail-active-bg)}
-.sm-rail__tile svg{width:18px;height:18px;stroke:currentColor;fill:none;stroke-width:2;stroke-linecap:round;stroke-linejoin:round}
-/* A collection's own title can be long: it ends in an ellipsis inside the rail (2026-11-13). */
-.sm-rail__label{letter-spacing:.01em;white-space:nowrap;max-width:100%;overflow:hidden;text-overflow:ellipsis}
-/* Not greyed: the reference renders every inactive item at --text and marks
-   the unavailable ones only by being inert (no pointer, no hover). */
-.sm-rail__btn[aria-disabled="true"]{cursor:default}
-.sm-rail__btn[aria-disabled="true"]:hover .sm-rail__tile{background:transparent}
-/* The Deploy tile (spec 2026-10-09 static mode §6): above the avatar; the badge is the count waiting, the
-   lit tile a build in flight, the warning tile a build that has not landed or a site that did not answer. */
-.sm-rail__deploy{margin-top:auto}
-.sm-rail__deploy+.sm-rail__foot{margin-top:0}
-/* A publish on its way to the site (plan 2026-10-14 publish through the queue): a quiet line above the Deploy tile
-   and the avatar, the warning colour when a delivery landed late or with an error. */
-.sm-rail__badge{position:absolute;top:-4px;right:-6px;min-width:16px;height:16px;padding:0 4px;border-radius:var(--radius-round);background:var(--accent);color:#fff;font-size:10px;font-weight:600;line-height:16px;text-align:center}
-.sm-rail__tile--lit{background:var(--accent-soft);color:var(--accent);animation:sm-rail-pulse 1.6s ease-in-out infinite}
-.sm-rail__tile--warn{background:var(--warn-soft);color:var(--warn)}
-@keyframes sm-rail-pulse{0%,100%{opacity:1}50%{opacity:.55}}
-.sm-rail__menu-detail{font-size:var(--text-sm);color:var(--text);padding:6px 8px 4px;white-space:normal}
-.sm-rail__menu-note{font-size:var(--text-xs);color:var(--text-muted);padding:4px 8px 6px;white-space:normal}
-.sm-rail__menu-item:disabled{cursor:default;color:var(--text-muted)}
-.sm-rail__menu-item:disabled:hover{background:none}
-.sm-rail__foot{margin-top:auto;display:flex;flex-direction:column;align-items:center}
-.sm-rail__user{
-  width:28px;height:28px;border-radius:var(--radius-round);background:var(--accent-soft);color:var(--accent);
-  display:grid;place-items:center;font-size:var(--text-xs);font-weight:600;border:0;cursor:pointer;padding:0;
-}
-.sm-rail__user:focus-visible{outline:2px solid var(--rail-active-fg);outline-offset:1px;box-shadow:none}
-/* Flyout: 6px right of the rail, aligned with its item (the user menu aligns to the bottom).
+.sm-navbar__logo{width:30px;height:auto;display:block;flex:none;transition:filter .15s}
+.sm-navbar__brand:hover .sm-navbar__logo{filter:brightness(1.3)}
+.sm-navbar__brand:focus-visible{outline:2px solid var(--navbar-active-fg);outline-offset:2px;box-shadow:none}
+.sm-navbar__user{
+  width:32px;height:32px;border-radius:var(--radius-round);background:var(--accent-soft);color:var(--accent);
+  display:grid;place-items:center;font-size:var(--text-xs);font-weight:600;border:0;cursor:pointer;padding:0;transition:background .15s;
+}
+.sm-navbar__user:hover{background:color-mix(in srgb,var(--accent-soft),#fff 60%)}
+.sm-navbar__user:focus-visible{outline:2px solid var(--navbar-active-fg);outline-offset:2px;box-shadow:none}
+.sm-navbar__ext{width:13px;height:13px;flex:none;margin-left:12px;opacity:.45}
+.sm-navbar__menu-item:hover .sm-navbar__ext,.sm-navbar__menu-item:focus-visible .sm-navbar__ext{opacity:.8}
+.sm-navbar__menu-version{font-size:var(--text-xs);color:var(--text-subtle);padding:7px 10px 4px;margin-top:3px;border-top:1px solid var(--line)}
+.sm-navbar__list{display:flex;align-items:center;gap:4px;margin:0;padding:0;list-style:none;min-width:0}
+.sm-navbar__item{position:relative;list-style:none}
+.sm-navbar__btn{
+  appearance:none;background:none;border:0;margin:0;height:var(--navbar-item-h);padding:0 12px;display:flex;align-items:center;gap:8px;
+  color:inherit;font:inherit;cursor:pointer;border-radius:var(--navbar-item-radius);text-decoration:none;white-space:nowrap;transition:background .12s,color .12s;
+}
+.sm-navbar__btn--icon{padding:0;width:var(--navbar-item-h);justify-content:center}
+.sm-navbar__btn:hover{color:var(--navbar-active-fg);background:var(--navbar-hover-bg)}
+.sm-navbar__btn:focus-visible{outline:2px solid var(--navbar-active-fg);outline-offset:-2px;box-shadow:none}
+.sm-navbar__btn[aria-current="page"],.sm-navbar__btn[aria-expanded="true"]{color:var(--navbar-active-fg);background:var(--navbar-active-bg)}
+.sm-navbar__btn svg{flex:none;stroke:currentColor;fill:none;stroke-linecap:round;stroke-linejoin:round}
+.sm-navbar__chevron{margin-left:-2px;opacity:.8}
+/* A collection's own title can be long: it ends in an ellipsis (2026-11-13). */
+.sm-navbar__label{letter-spacing:.01em;white-space:nowrap;max-width:160px;overflow:hidden;text-overflow:ellipsis}
+/* A narrow window keeps the icons and drops the labels; each item keeps its name for a screen reader and a tooltip. */
+@media (max-width:820px){
+  .sm-navbar__list .sm-navbar__label,.sm-navbar__deploy .sm-navbar__label{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)}
+  .sm-navbar__btn{padding:0 10px}
+}
+/* The Deploy item (spec 2026-10-09 static mode §6): next to the avatar; the badge is the count waiting, the
+   lit item a build in flight, the warning item a build that has not landed or a site that did not answer. */
+.sm-navbar__icon{position:relative;display:grid;place-items:center}
+.sm-navbar__badge{position:absolute;top:-7px;right:-9px;min-width:16px;height:16px;padding:0 4px;border-radius:var(--radius-round);background:var(--accent);color:#fff;font-size:10px;font-weight:600;line-height:16px;text-align:center}
+.sm-navbar__btn--lit,.sm-navbar__btn--lit:hover{background:var(--accent-soft);color:var(--accent);animation:sm-navbar-pulse 1.6s ease-in-out infinite}
+.sm-navbar__btn--warn,.sm-navbar__btn--warn:hover{background:var(--warn-soft);color:var(--warn)}
+@keyframes sm-navbar-pulse{0%,100%{opacity:1}50%{opacity:.55}}
+.sm-navbar__menu-detail{font-size:var(--text-sm);color:var(--text);padding:6px 8px 4px;white-space:normal}
+.sm-navbar__menu-note{font-size:var(--text-xs);color:var(--text-muted);padding:4px 8px 6px;white-space:normal}
+.sm-navbar__menu-item:disabled{cursor:default;color:var(--text-muted)}
+.sm-navbar__menu-item:disabled:hover{background:none}
+/* A menu drops 6px below its item, aligned with its left edge (the end group's with its right edge).
    Menus float on --menu-bg (the sheet white in the neutral look, so they read over the frame). */
-.sm-rail__menu{
-  position:absolute;left:calc(100% + 6px);top:0;z-index:20;width:168px;padding:6px;margin:0;list-style:none;
+.sm-navbar__menu{
+  position:absolute;left:0;top:calc(100% + 6px);z-index:20;width:200px;padding:6px;margin:0;list-style:none;
   background:var(--menu-bg);border:var(--menu-border);border-radius:var(--radius-md);box-shadow:var(--shadow-pop);
-  display:none;flex-direction:column;gap:1px;font-size:var(--text-md);font-weight:500;color:var(--text);
-}
-.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--brand{width:220px}
-.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{
+  display:none;flex-direction:column;gap:1px;font-size:var(--text-md);font-weight:500;line-height:1.4;color:var(--text);
+}
+.sm-navbar__menu[data-open="true"]{display:flex}
+.sm-navbar__menu--end{left:auto;right:0;width:240px}
+.sm-navbar__menu--brand{width:240px}
+/* An invisible bridge spans the 6px gap so the pointer can cross from Collections into its hover menu. */
+.sm-navbar__menu--collections::before{content:"";position:absolute;left:0;right:0;top:-8px;height:8px}
+.sm-navbar__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-navbar__menu-item{
   appearance:none;background:none;border:0;width:100%;display:flex;align-items:center;justify-content:space-between;
   padding:7px 10px;border-radius:var(--radius-sm);color:inherit;font:inherit;cursor:pointer;text-align:left;text-decoration:none;
 }
-.sm-rail__menu-item:hover,.sm-rail__menu-item:focus-visible{background:var(--hover);color:inherit;outline:0;box-shadow:none}
-.sm-rail__menu-item[aria-current="page"],.sm-rail__menu-item[aria-current="page"]:hover{background:var(--nav-active-bg);color:var(--nav-active-fg);font-weight:600}
+.sm-navbar__menu-item:hover,.sm-navbar__menu-item:focus-visible{background:var(--hover);color:inherit;outline:0;box-shadow:none}
+.sm-navbar__menu-item[aria-current="page"],.sm-navbar__menu-item[aria-current="page"]:hover{background:var(--nav-active-bg);color:var(--nav-active-fg);font-weight:600}
+.sm-navbar__menu-label{display:flex;align-items:center;gap:10px;min-width:0}
+.sm-navbar__menu-label>span{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.sm-navbar__menu-label svg{flex:none;stroke:currentColor;fill:none}
+/* Collections and ⋮ are dark (2026-11-14): they carry the bar's own items, so they take its colours. */
+.sm-navbar__menu--dark{background:var(--navbar-menu-bg);color:var(--navbar-fg);border:0;padding:6px;gap:2px}
+.sm-navbar__menu--dark .sm-navbar__menu-item{padding:9px 12px}
+.sm-navbar__menu--dark .sm-navbar__menu-item:hover,.sm-navbar__menu--dark .sm-navbar__menu-item:focus-visible{background:var(--navbar-hover-bg);color:var(--navbar-active-fg)}
+.sm-navbar__menu--dark .sm-navbar__menu-item[aria-current="page"],.sm-navbar__menu--dark .sm-navbar__menu-item[aria-current="page"]:hover{background:var(--navbar-active-bg);color:var(--navbar-active-fg)}
 .sm-when-light{display:var(--when-light);align-items:center;gap:8px}
 .sm-when-dark{display:var(--when-dark);align-items:center;gap:8px}
 /* .sm-nav-item survives as the inspector's link style (EditorView). */
@@ -488,6 +488,7 @@ html:has(.sm-admin),body:has(.sm-admin){overscroll-behavior:none}
 /* Inline editing in the canvas (spec 2026-09-10). The outlines are drawn in
    the overlay from the bridge's field rects; the toolbar floats above the
    selection. */
+.sm-dim{background:color-mix(in srgb,var(--canvas) 62%,transparent);pointer-events:none}
 .sm-fieldhover{outline:1px solid color-mix(in srgb,var(--selection) 55%,transparent);outline-offset:2px;border-radius:2px;pointer-events:none}
 .sm-fieldedit{outline:1.5px solid var(--selection);outline-offset:3px;border-radius:2px;pointer-events:none}
 .sm-floatbar{
@@ -800,6 +801,13 @@ html:has(.sm-admin),body:has(.sm-admin){overscroll-behavior:none}
   min-width:0;min-height:0;overflow:hidden;
 }
 .sm-canvas__scroll{flex:1;min-height:0;overflow:auto;padding:var(--canvas-pad)}
+/* A global item's canvas (spec 2026-11-14): a row above the frame — where the item is used, and which page shows it. */
+.sm-globalcanvas{display:flex;flex-direction:column;min-width:0;min-height:0}
+.sm-globalcanvas>.sm-canvas{flex:1}
+.sm-globalcanvas__bar{flex:none;display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap;padding:0 4px 8px;min-height:28px}
+.sm-globalcanvas__bar .sm-hint{margin:0}
+.sm-globalcanvas__pick{display:flex;align-items:center;gap:8px}
+.sm-globalcanvas__pick .sm-select{width:auto;height:30px;padding:0 10px}
 .sm-page{
   position:relative;background:var(--page-bg);border-radius:var(--page-radius);
   box-shadow:var(--shadow-page);min-height:100%;

package/dist/api-client.js

@@ -3,7 +3,7 @@
 // config exactly as the service's site computes them (site.ts siteStatics), so a cache key never disagrees across
 // the wire. A document's tags ride on the hit (SiteHit.tags), where the read layer takes them.
 import { countRead } from "./read-counter.js";
-import { pushBody, pushSchema } from "./push.js";
+import { pushBody, pushLine, pushSchema } from "./push.js";
 import { siteOptions, siteStatics, } from "./site.js";
 /** The content API refused a read: its status, its code (`unauthorized`, `not_found`, `validation`, `internal`) and its message. */
 export class SmoodlyApiError extends Error {
@@ -24,9 +24,11 @@ export function createSmoodlyApi(options) {
     const localeOf = (o) => o?.locale ?? statics.locales.default;
     const env = typeof process === "undefined" ? {} : process.env;
     const push = options.push ?? (env.NODE_ENV === "development" ? pushBody(options.config, env, "live") : false);
-    /** One push per client, awaited by every call until it settles; its failure is logged, never thrown. */
+    /** One push per client, awaited by every call until it settles; its failure is logged, never thrown. What landed is
+     *  said once, with the kind of space it reached (spec 2026-11-13 production first and the preview copy §7): a dev
+     *  server pushes its schema to the space it reads, so the developer must see when that space is production. */
     let pushed = null;
-    const pushOnce = (body) => (pushed ?? (pushed = pushSchema({ apiUrl, spaceId: options.spaceId, key: options.key, fetch: doFetch }, body).then(() => undefined, (e) => console.error(`smoodly: the schema push failed — ${e instanceof Error ? e.message : String(e)}; the site runs against the schema the space has.`))));
+    const pushOnce = (body) => (pushed ?? (pushed = pushSchema({ apiUrl, spaceId: options.spaceId, key: options.key, fetch: doFetch }, body).then((result) => { const line = pushLine(options.spaceId, result); console.log(`smoodly: ${line[0].toLowerCase()}${line.slice(1)}`); }, (e) => console.error(`smoodly: the schema push failed — ${e instanceof Error ? e.message : String(e)}; the site runs against the schema the space has.`))));
     async function call(path, params) {
         if (push)
             await pushOnce(push);

package/dist/astro/index.js

@@ -11,7 +11,7 @@ import { apiTransport, createSmoodlyContent } from "../content/content-api.js";
 import { markerJson, MARKER_PATH } from "../deploy-state.js";
 import { DEFAULT_API_URL, apiEnv, siteUrl } from "../env.js";
 import { createSmoodlyApi } from "../api-client.js";
-import { pushBody, pushSchema } from "../push.js";
+import { pushBody, pushLine, pushSchema } from "../push.js";
 import { loadSmoodlyEnv } from "./env-files.js";
 import { astroRouting, localeHref } from "./locale-paths.js";
 import { PREVIEW_BASE } from "./preview.js";
@@ -159,8 +159,8 @@ export default function smoodly(options = {}) {
                 astroRouting(i18n, loaded.locales, loaded.routing);
                 try {
                     const env = apiEnv(process.env);
-                    const { version, changed } = await pushSchema(env, pushBody(loaded, process.env, output === "static" ? "static" : "live"));
-                    logger.info(changed ? `smoodly: pushed schema version ${version} to ${env.spaceId}.` : `smoodly: schema unchanged (version ${version}).`);
+                    const line = pushLine(env.spaceId, await pushSchema(env, pushBody(loaded, process.env, output === "static" ? "static" : "live")));
+                    logger.info(`smoodly: ${line[0].toLowerCase()}${line.slice(1)}`);
                 }
                 catch (e) {
                     logger.warn(`smoodly: the schema push failed — ${e instanceof Error ? e.message : String(e)}; the site runs against the schema the space has.`);

package/dist/cli/push.js

@@ -4,7 +4,7 @@
 // except when npm runs the command as a build's `prebuild`: a push never fails a build (the spec's rule), so there it
 // says what failed and exits 0, and the site runs against the schema the space has.
 import { apiEnv } from "../env.js";
-import { pushBody, pushSchema } from "../push.js";
+import { pushBody, pushLine, pushSchema } from "../push.js";
 import { loadAppEnv } from "./app-env.js";
 import { loadConfig } from "./load-config.js";
 export async function runPush(_args, out, deps = {}) {
@@ -15,8 +15,7 @@ export async function runPush(_args, out, deps = {}) {
         const config = await loadConfig(cwd);
         const { apiUrl, spaceId, key } = apiEnv(env);
         const body = pushBody(config, env, env.SMOODLY_STATIC === "1" ? "static" : "live");
-        const { version, changed } = await pushSchema({ apiUrl, spaceId, key, fetch: deps.fetch }, body);
-        out(changed ? `Pushed schema version ${version} to ${spaceId}.` : `Schema unchanged (version ${version}).`);
+        out(pushLine(spaceId, await pushSchema({ apiUrl, spaceId, key, fetch: deps.fetch }, body)));
         return 0;
     }
     catch (e) {

package/dist/env.js

@@ -11,8 +11,9 @@ const ADMIN_NEEDS = SITE_NEEDS;
 const NEEDS = { site: SITE_NEEDS, admin: ADMIN_NEEDS };
 const isHttp = (v) => /^https?:\/\/[^/\s]+/.test(v);
 const DEPLOYING = "https://smoodly.io/docs/getting-started/deploying";
-/** A Smoodly key: its kind, the space it belongs to, the random part and the stamp (spec 2026-10-16 the control plane §1). */
-const SMOODLY_KEY = (kind) => new RegExp(`^${kind}_sp_(eu_)?[a-z2-7]{20}_[a-z2-7]{32}_[a-z2-7]{16}$`);
+/** A Smoodly key: its kind, the space it belongs to (a preview space's id carries `preview_`, spec 2026-11-13 production
+ *  first and the preview copy §8), the random part and the stamp (spec 2026-10-16 the control plane §1). */
+const SMOODLY_KEY = (kind) => new RegExp(`^${kind}_sp_(eu_)?(preview_)?[a-z2-7]{20}_[a-z2-7]{32}_[a-z2-7]{16}$`);
 /** The live site and its admin read over the API with its address, the space and the secret key (spec 2026-10-16 the
  *  control plane §5). A key in the wrong variable or of no known form is named here, not by a failed read later. */
 export function resolveSmoodlyEnv(env, need = "site") {

package/dist/push.d.ts

@@ -23,6 +23,13 @@ export type PushApi = {
     key: string;
     fetch?: typeof fetch;
 };
+/** What a push says when it landed: the version, and which kind of space it reached, read from the id (spec 2026-11-13
+ *  production first and the preview copy §7), so a developer who meant the preview space sees at once that the machine
+ *  reads production. */
+export declare function pushLine(spaceId: string, result: {
+    version: number;
+    changed: boolean;
+}): string;
 /** One push: the space's version of the registry, and whether this push changed it. A refusal throws `SmoodlyApiError`. */
 export declare function pushSchema(api: PushApi, body: PushBody): Promise<{
     version: number;

package/dist/push.js

@@ -2,6 +2,7 @@
 // delivery mode, and the package version, at `POST /v1/spaces/:space/schema` under the secret key. `smoodly push`, Astro's
 // build hook, the Next templates' prebuild and the API client in development all send this one body. The space keeps
 // the registry, versions it and purges its pages when it changed; a failed push never fails a build.
+import { spaceKind } from "./space-kind.js";
 import { SmoodlyApiError } from "./api-client.js";
 import { serializeRegistry } from "./registry-json.js";
 import { SMOODLY_VERSION } from "./version.js";
@@ -29,6 +30,13 @@ export function siteInfo(config, env, mode) {
 export function pushBody(config, env, mode) {
     return { registry: serializeRegistry(config), site: siteInfo(config, env, mode), package: SMOODLY_VERSION };
 }
+/** What a push says when it landed: the version, and which kind of space it reached, read from the id (spec 2026-11-13
+ *  production first and the preview copy §7), so a developer who meant the preview space sees at once that the machine
+ *  reads production. */
+export function pushLine(spaceId, result) {
+    const where = `the ${spaceKind(spaceId)} space ${spaceId}`;
+    return result.changed ? `Pushed schema version ${result.version} to ${where}.` : `Schema unchanged (version ${result.version}) in ${where}.`;
+}
 /** One push: the space's version of the registry, and whether this push changed it. A refusal throws `SmoodlyApiError`. */
 export async function pushSchema(api, body) {
     const apiUrl = api.apiUrl.replace(/\/+$/, "");

package/dist/space-kind.d.ts

@@ -0,0 +1,2 @@
+export type SpaceKind = "production" | "preview";
+export declare const spaceKind: (spaceId: string) => SpaceKind;

package/dist/space-kind.js

@@ -0,0 +1 @@
+export const spaceKind = (spaceId) => (/^sp_(eu_)?preview_/.test(spaceId) ? "preview" : "production");

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SMOODLY_VERSION = "0.0.60";
+export declare const SMOODLY_VERSION = "0.0.62";

package/dist/version.js

@@ -1,2 +1,2 @@
 // Generated by scripts/write-version.mjs from package.json — do not edit.
-export const SMOODLY_VERSION = "0.0.60";
+export const SMOODLY_VERSION = "0.0.62";

package/docs/collections/defining.md

@@ -0,0 +1,57 @@
+# Defining a collection
+
+A collection is a content type with a fixed shape and many entries: posts, people, products. You declare its fields once; editors get a list, a form and publishing for it.
+
+## The schema
+
+`smoodly.collection()` takes a name, a title and the fields of one entry:
+
+File: `smoodly/collections.ts`
+
+```ts
+import { f, smoodly } from "smoodly";
+// …
+export const people = smoodly.collection({
+  name: "people",
+  title: "People",
+  titleField: "name",
+  order: "manual",
+  fields: {
+    name: f.text(),
+    role: f.text().localized(),
+  },
+});
+```
+
+| Name | Description |
+| --- | --- |
+| `name` | What references and queries use. Keep it stable once entries exist. global, asset and media are reserved. |
+| `title` | The label in the admin's navigation and list. |
+| `titleField` | The field whose value names an entry in lists and pickers. Without one, or while it is empty, an entry reads Untitled. |
+| `fields` | Any builders. A field named slug gives entries a URL part; .localized() gives a field a value per language. |
+| `path` | Serves each entry at its own URL under this segment. See Entry pages. |
+| `order` | How the list and queries sort. See Ordering. |
+| `admin.showInNav` | true gives the collection its own item in the admin's main navigation, after Pages, instead of a line in the Collections menu. Default false. |
+| `seo` | Adds the SEO & Social panel to the entry form; `{ description, image }` names the fields that fill an empty description and social image. See SEO. |
+
+Register the export in the `collections` list of `smoodly/collections.ts`, which the config registers. Every collection stores its entries in the same tables, so the admin lists a new one at once. Smoodly's service indexes the new collection's lists itself: there is nothing to migrate.
+
+## Entries in the admin
+
+The *Collections* item in the admin's top bar opens a menu of every collection. A collection editors open all day can sit on the bar itself: add `admin: { showInNav: true }` to its schema and it appears after *Pages* under its title, and leaves the menu. A collection's list shows its entries with their title, status and when they changed, 20 to a page; *Previous* and *Next* under the rows move through a longer list, and *Per page* shows 100 or 500 instead, a choice the browser remembers. The box above the rows filters by the collection's `titleField`: it finds the entries whose title holds the text, in any language, and searches the whole collection, not the page on screen. A collection without a `titleField` has no filter. While a filter is on, a hand-ordered list does not drag. *+ New entry* creates an empty draft in the selected language and opens the form at once. The form autosaves, and carries the same *Publish* control as a page, so an entry is published per language like a page. *History* and *Discard changes* work the same way.
+
+An entry cannot be deleted while a page, a section or another entry references it. The message says how many, and the media library shows the same for assets.
+
+## Shared and localized
+
+A field's value is shared across languages unless it chains `.localized()`. In the starter's people, a person's name is the same everywhere and the role is translated. The form marks shared fields with a globe-off icon on a multilingual site, and the slug is always per language. [Localized fields](../languages/localized-fields.md) has the rules.
+
+## Where entries appear
+
+Three ways, which the next pages cover:
+
+- **Referenced** from a section or another entry with `f.ref()` or `f.refList()`: the starter's *People* section picks team members by hand. See [Reference and tags](../fields/reference-and-tags.md).
+- **At their own URL**, when the collection has a `path` and an [entry page](../collections/entry-pages.md).
+- **Queried** from your code with `q()`, for an index grid or a related list. See [Queries](../collections/queries.md).
+
+Next, [Entry pages](../collections/entry-pages.md).