smoodly 0.0.61 → 0.0.63

package/dist/sample-tree.js

@@ -0,0 +1,76 @@
+// The picker's samples (spec 2026-11-14 add section previews): what a zone's "+" offers, as nodes the site can draw.
+// The admin's modal shows each row as the site itself renders it; the site builds this tree from its registry (the
+// service holds no samples), the service resolves it in place of the page's draft (ContentReads.loadSamples), and
+// the admin finds each row's node in the frame by the ids below. Framework-free: both adapters use it.
+import { allowsCustom } from "./admin/custom-section.js";
+import { nodeFromSample } from "./admin/tree-ops.js";
+import { CUSTOM_NODE_TYPE, defaultRow } from "./custom/index.js";
+import { GLOBAL_NODE_TYPE } from "./global.js";
+import { SAMPLE_PICK_LIMIT, sampleCollections } from "./sample-fill.js";
+/** A sample node's id, fixed so the admin finds it without asking. The middle word keeps a section a developer
+ *  named `custom` (or `global-…`) apart from the Custom section and from a global item. */
+export function sampleNodeId(kind, name) {
+    return kind === "custom" ? "sample-custom" : `sample-${kind}-${name}`;
+}
+/** The sections a zone's picker offers: none for a locked zone or one the page type does not have. */
+function offered(source, policy) {
+    if (!policy || policy.kind === "locked")
+        return [];
+    return source.sections.filter((s) => policy.allow === "*" || policy.allow.includes(s.name));
+}
+/** The collections a zone's offered sections reference (spec 2026-11-14 filled samples): what the picks are read for. */
+export const zoneSampleCollections = (source, policy) => sampleCollections(offered(source, policy));
+/** The zone's picker rows as nodes, in the picker's order: the sections its policy allows, the Custom section where
+ *  the zone takes one, the visual global items whose section it allows. Each is what an insert would create; a
+ *  placement names its item alone (the service finds the row, and drops an item that has none). No other zone is
+ *  in the tree. `picks` fill the sections' reference fields (spec 2026-11-14 filled samples); the tree is always the
+ *  filled one, whatever the picker's switch says. */
+export function sampleTree(source, policy, zone, picks) {
+    const nodes = [];
+    if (policy && policy.kind !== "locked") {
+        const allows = (section) => policy.allow === "*" || policy.allow.includes(section);
+        for (const s of offered(source, policy))
+            nodes.push(nodeFromSample(s, sampleNodeId("section", s.name), { picks }));
+        // As the admin's customNode: the registry's custom sample is one default row.
+        if (allowsCustom(policy))
+            nodes.push({ id: sampleNodeId("custom"), type: CUSTOM_NODE_TYPE, fields: { rows: [defaultRow()] } });
+        for (const item of source.globals) {
+            if (item.section !== undefined && allows(item.section))
+                nodes.push({ id: sampleNodeId("global", item.name), type: GLOBAL_NODE_TYPE, fields: { item: item.name } });
+        }
+    }
+    return { zones: { [zone]: nodes } };
+}
+/** The reference picks of a zone's samples (spec 2026-11-14 filled samples): the first published entries of each
+ *  collection its sections reference, one published read per collection in the page's locale: the read the admin's
+ *  `entries.samplePicks` makes for the insert. A read that fails leaves that collection's references unfilled. */
+async function samplePicks(site, template, zone, locale) {
+    const picks = {};
+    await Promise.all(site.sampleCollections(template, zone).map(async (collection) => {
+        try {
+            picks[collection] = (await site.getEntries(collection, { locale, limit: SAMPLE_PICK_LIMIT })).map((e) => e.id);
+        }
+        catch (e) {
+            console.error(`smoodly: the picker's sample entries of "${collection}" could not be read — ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }));
+    return picks;
+}
+/** What a samples address draws for a hit: the page with the zone's samples resolved by the service. A page the
+ *  service cannot answer for (no record yet, an older service, an outage) is drawn with its zones empty, so the
+ *  admin finds no node and every row keeps its icon; an entry has no zones and is returned as it is. */
+export async function samplesHit(site, hit, target, locale, path, zone) {
+    if (hit.kind !== "page")
+        return hit;
+    const emptied = { ...hit, tree: { ...hit.tree, zones: {} } };
+    if (!target)
+        return emptied;
+    try {
+        const resolved = await site.loadSamples(target, locale, path, site.sampleTree(hit.template, zone, await samplePicks(site, hit.template, zone, locale)));
+        return resolved?.kind === "page" ? resolved : emptied;
+    }
+    catch (e) {
+        console.error(`smoodly: the picker's samples could not be loaded — ${e instanceof Error ? e.message : String(e)}`);
+        return emptied;
+    }
+}

package/dist/site.d.ts

@@ -12,6 +12,7 @@ import type { StyleValues, StyleValuesInput } from "./styles.ts";
 import type { CustomConfigInput, ResolvedCustom } from "./custom/index.ts";
 import type { PageRecord, PageStore } from "./store.ts";
 import type { PathHit } from "./path-index.ts";
+import type { SamplePicks } from "./sample-fill.ts";
 import type { EntryItem, PageItem, Seo } from "./read-shapes.ts";
 import type { SchemaOr } from "./registration.ts";
 import type { ResolvedConfig } from "./config.ts";
@@ -144,6 +145,16 @@ export interface ContentReads {
     targetPaths(target: PathTarget): Promise<Record<string, string>>;
     /** Everything the renderer needs for one target: null when it is a folder, unpublished (outside draft), or gone. */
     load(target: PathTarget, locale: string, path: string, options?: LoadOptions): Promise<SiteHit | null>;
+    /** The picker's rows for a zone of a page type, as raw nodes built from the registry's samples (sample-tree.ts):
+     *  what `loadSamples` is handed. A static: the service holds no samples. */
+    sampleTree(template: string, zone: string, picks?: SamplePicks): PageTree;
+    /** The collections the zone's offered sections reference (spec 2026-11-14 filled samples): the picks are their
+     *  first published entries, read before the tree is built. A static. */
+    sampleCollections(template: string, zone: string): string[];
+    /** The picker's samples (spec 2026-11-14 add section previews): the page's draft with `tree`'s zones resolved in
+     *  place of the stored ones, images, references and placed globals as a draft has them. Draft only; nothing is
+     *  stored. A placement names its item alone. Null for an entry, a page that is gone or not in `locale`. */
+    loadSamples(target: PathTarget, locale: string, path: string, tree: PageTree): Promise<SiteHit | null>;
     /** The published read of an address: one locate that tells a record to assemble from a redirect row, and the
      *  code-owned page where the index has no row. */
     lookup(locale: string, path: string): Promise<SiteHit | {
@@ -220,6 +231,8 @@ export declare function siteStatics(options: Omit<SiteOptions, "stores">): {
     custom: ResolvedCustom;
     cacheKey: string;
     codePage: (locale: string, path: string) => SitePage | null;
+    sampleTree: (template: string, zone: string, picks?: SamplePicks) => PageTree;
+    sampleCollections: (template: string, zone: string) => string[];
 };
 /** What createSmoodlySite takes, read off the config. */
 export declare function siteOptions(config: ResolvedConfig, stores?: SiteOptions["stores"]): SiteOptions;

package/dist/site.js

@@ -2,6 +2,7 @@ import { lastPart } from "./addresses.js";
 import { withDefaults } from "./field-defaults.js";
 import { modelKey } from "./model-key.js";
 import { SMOODLY_VERSION } from "./version.js";
+import { sampleTree as buildSampleTree, zoneSampleCollections } from "./sample-tree.js";
 import { pageSeo } from "./seo.js";
 import { pageFieldsOf, siteShape } from "./assemble.js";
 /** The `page` prop for a loaded page. `href` is the app's seam from a
@@ -60,7 +61,15 @@ export function siteStatics(options) {
             ...(withSeo ? { seo: pageSeo(undefined, spec.title) } : {}),
         };
     }
-    return { shape, locales, homePageSlug, styles, custom, cacheKey, codePage };
+    const sampleSource = {
+        sections: options.sections.map((x) => ("schema" in x ? x.schema : x)),
+        globals: (options.globals ?? []).map((g) => ({ name: g.name, ...(g.section !== undefined ? { section: g.section } : {}) })),
+    };
+    // A page type's schema carries its zones (page.ts); the site's own page type names only what the reads use.
+    const policyOf = (template, zone) => pageSchemas.find((x) => x.kind === "page" && x.name === template)?.zones?.[zone];
+    const sampleTree = (template, zone, picks) => buildSampleTree(sampleSource, policyOf(template, zone), zone, picks);
+    const sampleCollections = (template, zone) => zoneSampleCollections(sampleSource, policyOf(template, zone));
+    return { shape, locales, homePageSlug, styles, custom, cacheKey, codePage, sampleTree, sampleCollections };
 }
 /** What createSmoodlySite takes, read off the config. */
 export function siteOptions(config, stores) {

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SMOODLY_VERSION = "0.0.61";
+export declare const SMOODLY_VERSION = "0.0.63";

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.61";
+export const SMOODLY_VERSION = "0.0.63";

package/docs/collections/defining.md

@@ -26,7 +26,7 @@ export const people = smoodly.collection({
 | 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 rail and list. |
+| `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. |
@@ -38,7 +38,7 @@ Register the export in the `collections` list of `smoodly/collections.ts`, which
 
 ## Entries in the admin
 
-The *Collections* item in the admin's rail opens a menu of every collection. A collection editors open all day can sit on the rail 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.
+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.
 

package/docs/content-modeling/sections.md

@@ -32,7 +32,7 @@ export const heroSchema = smoodly.schema.section({
 | --- | --- |
 | `name` | What the content stores for every placed Hero, so keep it stable once pages exist. |
 | `title` | The label in Add section and in the inspector. |
-| `description` | One line under the title in Add section. Optional, like icon. |
+| `description` | A line about the section, kept for later use: the admin does not show it today. Optional, like icon. |
 | `fields` | What editors fill. Field order is form order: editors see Kicker, Heading, Text, Buttons, Image, top to bottom. |
 | `sample` | What a new Hero starts with. See Sample content below. |
 
@@ -195,12 +195,28 @@ A registered section that no zone lists never appears in *Add section*. Lorem Co
 
 ## Sample content
 
-`sample` is what a section starts with, so a page never shows an empty one. Smoodly uses it twice:
+`sample` is what a section starts with, so a page never shows an empty one. Smoodly uses it three times:
 
+- *Add section* shows each section as your site draws it with its sample, so an editor sees what they are about to add.
 - When an editor picks the section in *Add section*, the new section carries the sample.
 - When a page opens with an empty locked zone, Smoodly fills the zone from the locked section's sample.
 
-Fields the sample leaves out start from their `.default()`, or empty. A missing image or number stays unset rather than showing a broken picture or a stray zero. Make the sample a complete value in plain copy: it is what editors see first, and what they overwrite.
+What Smoodly shows is what it inserts: the picture and the new section are built by the same rules.
+
+The sample always comes first. A field it sets is taken as it is, and nothing is added to it or inside it. A field it leaves out starts from its `.default()`. A field with neither is filled by Smoodly, so a section with a thin sample still looks like itself:
+
+| Name | Description |
+| --- | --- |
+| `f.text()` | Required: a short Latin phrase where the key reads as a title (title, heading, label, name, button and the like), else one sentence, cut to .max(n). Optional: empty. |
+| `f.richtext()` | Required: a heading, two paragraphs and a list where the toolset has them, else one paragraph. Optional: empty. |
+| `f.image()` | A placeholder picture, required or optional. It shows in the editor and in previews only, never on the live page; publishing treats it as no image, so a required image still asks for a photo. |
+| `f.ref(), f.refList()` | The collection's first published entries: one for a required f.ref, up to three for an f.refList, fewer if .max(n) is lower. |
+| `f.list(item)` | Required: .min(n) items, or three, never more than .max(n). Each item is filled the same way. |
+| `f.object({ … })` | Required: its fields, filled the same way. |
+
+Numbers, dates, links, videos and files are not filled (a number, a video and a file stay unset; a date and a link start empty), a list nothing fills starts as an empty list, and settings are never filled: they keep their defaults. An empty list in a sample (`people: []`) counts as left out. To choose the content yourself, put it in the sample.
+
+*Add section* has an *Insert filled* switch under its list. Turned off, a section arrives empty: without the sample and without anything generated. The picture still shows the filled section.
 
 The sample may set settings too, under their own keys.
 

package/docs/content-modeling/zones.md

@@ -52,13 +52,13 @@ function LandingView({ zones }: Props<typeof landingSchema>) {
 export const LandingPage = smoodly.page(landingSchema, LandingView);
 ```
 
-The hero zone offers a choice of two openers and takes one of them. The body takes anything. The closing zone always shows the site's one quote, edited under *Site*.
+The hero zone offers a choice of two openers and takes one of them. The body takes anything. The closing zone always shows the site's one quote, edited under *Sections*.
 
 > **Note:** `sections: "*"` includes every registered section, the header and footer too. List the sections instead when some are only meant for the layout.
 
 ## What editors see
 
-In the canvas, *Add section* appears between the sections of a zone and at its end. It opens a picker with the sections the policy allows, then *Custom section* where `custom: true`, then a *Global* group with the globals whose section is allowed there. A zone capped with `.max(n)` loses its *Add section* once it is full.
+In the canvas, *Add section* appears between the sections of a zone and at its end. It opens a picker with the sections the policy allows, then *Custom section* where `custom: true`, then a *Global* group with the globals whose section is allowed there. A zone capped with `.max(n)` loses its *Add section* once it is full. The picker shows each section as your site draws it, filled where its `sample` is silent; its *Insert filled* switch, when turned off, inserts the section empty instead ([Sample content](../content-modeling/sections.md#sample-content)).
 
 A section's toolbar moves it up or down, duplicates it or removes it. In a locked zone the section is tagged *locked* and the toolbar says *fields only*. Smoodly fills the zone from the section's `sample` the first time the page opens.
 
@@ -66,7 +66,7 @@ An empty zone shows as a box in the canvas so it can take a section. On the site
 
 ## Locking a zone to a global
 
-`z.locked()` also takes a global with a section, as `closing` does above. The zone then shows that one global on every page of the type. Editors change it once, under *Site* or right in any canvas that shows it, and every page follows. The starter's header and footer take a different route: the layout renders them directly, so they need no zone.
+`z.locked()` also takes a global with a section, as `closing` does above. The zone then shows that one global on every page of the type. Editors change it once, under *Globals* or right in any canvas that shows it, and every page follows. The starter's header and footer take a different route: the layout renders them directly, so they need no zone.
 
 A global can also be placed by hand. The starter lists Quote in its body zones, so the picker's *Global* group offers the site quote there, and an editor may still add a one-off Quote from the sections list.
 

package/docs/getting-started/deploying.md

@@ -51,7 +51,7 @@ export default defineConfig({
 });
 ```
 
-Publishing does not change the live site. Editors press **Deploy** in the admin's rail when they are done, and the host builds. Give the site the host's deploy hook as `SMOODLY_DEPLOY_HOOK` where `astro build` runs (on Vercel: Settings › Git › Deploy Hooks): the build hands it to Smoodly's API with the site's address; without it the tile shows what is waiting and Deploy stays disabled. `SITE_URL` must be the site's own address, and the build refuses static output without it: the tile reads the build's marker, `/_smoodly/build.json`, from there. It says *Building…* until the new build answers, *N changes* while publishes wait (an unpublish or a delete counts as one too), and *The build has not landed* after ten minutes with no new build, in which case look at the host's log. A host that strips query strings from a cached file can hold the old marker for its max-age.
+Publishing does not change the live site. Editors press **Deploy** in the admin's top bar, next to their avatar, when they are done, and the host builds. Give the site the host's deploy hook as `SMOODLY_DEPLOY_HOOK` where `astro build` runs (on Vercel: Settings › Git › Deploy Hooks): the build hands it to Smoodly's API with the site's address; without it the tile shows what is waiting and Deploy stays disabled. `SITE_URL` must be the site's own address, and the build refuses static output without it: the tile reads the build's marker, `/_smoodly/build.json`, from there. It says *Building…* until the new build answers, *N changes* while publishes wait (an unpublish or a delete counts as one too), and *The build has not landed* after ten minutes with no new build, in which case look at the host's log. A host that strips query strings from a cached file can hold the old marker for its max-age.
 
 The admin, its revalidate and preview routes and the preview address still run on demand, so the deployment is files plus one function; a host with no function at all cannot run the admin. A static page has no lists by query string and no draft at its real address: drafts are edited through the preview address, as in live mode. A moved page's old address becomes one of the host's redirects at build, so it is answered without a function too. The cache provider in `astro.config` is unused in static output and may stay.
 

package/docs/getting-started/working-together.md

@@ -20,7 +20,7 @@ Editors sign in at smoodly.io, never on your site: `/admin` sends them there and
 
 ## Who is editing what
 
-A lock after a title in Pages, in a collection or in Site means someone else has that item open in the language you are looking at. Hover it for their name. Opening the item anyway shows a line under the top bar: *aleksi is also editing this page.* Nothing is locked; it is a heads-up.
+A lock after a title in Pages, in a collection or in Globals means someone else has that item open in the language you are looking at. Hover it for their name. Opening the item anyway shows a line under the top bar: *aleksi is also editing this page.* Nothing is locked; it is a heads-up.
 
 Presence runs on Smoodly's service, over one connection per open admin tab. Without it the admin works exactly the same, minus the locks and the line; a tab that loses its connection reconnects on its own.
 

package/docs/globals/defining.md

@@ -45,7 +45,7 @@ Register the list in the config's `globals`. A visual global's section must be i
 
 ## In the admin
 
-*Site* in the rail lists every global with its kind, *Visual* or *Fields*, and its status in the selected language. Each opens a form like an entry's: the fields in schema order, and for a visual global the *Settings* tab's groups after them. The form autosaves, and carries the same *Publish* control, *History* and *Discard changes* as a page. A visual global's page also says on how many pages it is used.
+*Globals*, under ⋮ in the admin's top bar, lists every global with its kind, *Visual* or *Fields*, and its status in the selected language. A *Fields* global opens a form like an entry's, the fields in schema order. A *Visual* global opens on a canvas: a page of the site that shows it, the home page for a `layout` global and otherwise the first page that places it, with the global selected and the rest of the page dimmed. Its fields sit beside the canvas under *Content* and *Settings*, text marked for inline editing can be typed in place, and when several pages place it, *Shown on* picks the page. A visual global no page shows yet opens as a form. Either way the page autosaves, and carries the same *Publish* control, *History* and *Discard changes* as a page.
 
 A global exists in every language from the start, so there is nothing to add or delete. Publishing is per language, as for pages. A field's value is shared across languages unless it chains `.localized()`: the starter's contact email is one value, its address is translated.
 

package/docs/globals/header-and-footer.md

@@ -25,7 +25,7 @@ export const headerSchema = smoodly.schema.section({
 
 `styles: false` takes away the *Spacing & layout* group, because the header's spacing is the design's. The brand is shared across languages and the navigation is localized as a whole, so each language has its own labels and links. The footer follows the same pattern with a tagline, three link columns and a copyright line.
 
-Both are registered in `smoodly/sections.ts` and named with `smoodly.global()` in `smoodly/globals.ts`, which gives each a row under *Site* and its `sample` as starting content. No zone lists them, so the *Add section* picker never offers them. Both are `layout: true` ([Defining a global](../globals/defining.md#layout-globals)): on Astro they arrive with the page's own read, so rendering them costs no extra call.
+Both are registered in `smoodly/sections.ts` and named with `smoodly.global()` in `smoodly/globals.ts`, which gives each a row under *Sections* and its `sample` as starting content. No zone lists them, so the *Add section* picker never offers them. Both are `layout: true` ([Defining a global](../globals/defining.md#layout-globals)): on Astro they arrive with the page's own read, so rendering them costs no extra call.
 
 ## Rendering them
 
@@ -112,6 +112,6 @@ On a single-language site there are no links and the header shows the brand and
 
 ## Editing them
 
-Editors change the header and footer under *Site*, or in any page's canvas: both are selectable there, tagged *global*, with their own form and their own *Publish* in the inspector. The header's navigation edits in place like any list with [marks](../content-modeling/marks.md). Publishing a page never publishes the footer, because a footer going live on every page is a deliberate click.
+Editors change the header and footer under *Globals*, or in any page's canvas: both are selectable there, tagged *global*, with their own form and their own *Publish* in the inspector. The header's navigation edits in place like any list with [marks](../content-modeling/marks.md). Publishing a page never publishes the footer, because a footer going live on every page is a deliberate click.
 
 Next, [The media library](../media/library.md).

package/docs/media/library.md

@@ -4,7 +4,7 @@ Every image, video and file editors upload lives in one library. A field stores
 
 ## Uploading
 
-Editors upload from two places. A media field takes a dropped file straight away, or opens the library to pick one. *Media* in the rail shows the whole library, with an upload button and a filter for images, video and files.
+Editors upload from two places. A media field takes a dropped file straight away, or opens the library to pick one. *Media* in the top bar shows the whole library, with an upload button and a filter for images, video and files.
 
 The browser measures an image's dimensions on upload, and captures a frame of a video as its poster, stored as an image asset of its own. What the site can accept is config:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smoodly",
-  "version": "0.0.61",
+  "version": "0.0.63",
   "description": "Open-source, code-first CMS for Astro and Next.js: define a component once, it becomes a typed, editable building block.",
   "license": "MIT",
   "engines": {

package/dist/admin/shell/IconRail.js

@@ -1,109 +0,0 @@
-"use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// packages/smoodly/src/admin/shell/IconRail.tsx
-// The admin's primary navigation: the design handoff's 72px IconRail (the
-// cool-blue look's components/navigation/IconRail, in the tree until 2026-10-19;
-// the shipped tokens are design_handoff_smoodly_neutral/), which replaced the
-// 200px SideNav so the visual editor gets the width. Ported markup-for-markup;
-// the handoff's click handlers are the shell's router.
-//
-// Items are registry-derived, never separately configured: Pages, then a
-// rail item for each collection registered with `admin.showInNav`
-// (2026-11-13), then Collections — one rail item whose flyout lists every
-// other collection, absent when none is left — then
-// Media, Globals (the global content items, when the registry has any;
-// the route is /globals), and Settings (the Settings area, spec
-// 2026-09-25; the route is /settings; every member has a page there since
-// Redirects, 2026-09-26, so the shell passes `settings` once the role is
-// known). The user avatar is pinned to the bottom and opens the account
-// flyout: the email, the theme toggle, "My Account" (at smoodly.io) and Sign
-// out (spec 2026-10-16 sign-in and the dashboard §6).
-//
-// Flyouts: click toggles, Esc closes and returns focus to the trigger,
-// ↑/↓ move between entries, a pointer down outside closes. A child being
-// active highlights its parent tile and the entry inside the menu.
-import { useEffect, useId, useRef, useState } from "react";
-import { ExternalLink, Globe, Image, Layers, LibraryBig, PanelTop, RadioTower, Settings } from "lucide-react";
-import { tileCopy } from "./deploy-tile.js";
-import { ThemeToggle } from "../ui/primitives.js";
-import { useAdminHref } from "./base.js";
-import { consoleLinks } from "./console-links.js";
-import { SMOODLY_VERSION } from "../../version.js";
-import { RouteLink } from "./RouteLink.js";
-/** Lucide at the rail's size and stroke (the tile's CSS restates both). */
-const ICON = { size: 18, strokeWidth: 2, "aria-hidden": true };
-/** The app icon, inlined: a package can't ship a file into the host app's
- *  /public. The wordmark's "s" on a rounded square (chosen 2026-10-23; the
- *  same tile, green with a white s, is smoodly.io's favicon). The square takes
- *  --logo-outer and the glyph --logo-inner, so a look decides its colours. */
-function AppIcon() {
-    return (_jsxs("svg", { className: "sm-rail__logo", viewBox: "0 0 64 64", fill: "none", xmlns: "http://www.w3.org/2000/svg", role: "img", "aria-label": "Smoodly", children: [_jsx("rect", { width: "64", height: "64", rx: "14", style: { fill: "var(--logo-outer)" } }), _jsx("path", { style: { fill: "var(--logo-inner)" }, transform: "translate(14.382 -4.365) scale(0.7123)", d: "M30.5851 22.9763C36.7891 22.9763 45.6052 24.6681 49.3603 26.5237L46.2583 42.2415C41.6869 40.113 35.2653 38.4212 29.4422 38.4212C26.0137 38.4212 23.7825 39.1852 23.7825 40.9862C23.7825 42.1869 24.9797 42.8964 27.1021 43.333L31.5647 44.3153C40.8162 46.3346 45.5508 51.1373 45.5508 58.505C45.5508 73.4587 33.9592 79.1345 18.939 79.1345C11.4833 79.1345 4.24536 77.3335 0.109375 75.6963L3.42905 58.9416C8.97998 61.8341 16.4356 63.6351 21.2247 63.6351C24.6532 63.6351 26.9933 62.7619 26.9933 60.6334C26.9933 59.4327 26.1226 58.505 23.5648 58.0684L19.7553 57.3043C12.5173 55.9399 6.31336 50.9735 6.31336 43.0055C6.31336 30.6169 15.6737 23.0309 30.6939 23.0309L30.5851 22.9763Z" })] }));
-}
-/** A menu link that opens smoodly.io in a new tab, with the arrow that says so. */
-function ExtLink({ href, onClick, children }) {
-    return (_jsxs("a", { role: "menuitem", className: "sm-rail__menu-item", href: href, target: "_blank", rel: "noreferrer", onClick: onClick, children: [_jsx("span", { children: children }), _jsx(ExternalLink, { className: "sm-rail__ext", size: 13, strokeWidth: 1.75, "aria-hidden": "true" })] }));
-}
-export function IconRail({ registry, active, email, settings = true, deploy, onSignOut }) {
-    const adminHref = useAdminHref();
-    const root = useRef(null);
-    const uid = useId();
-    const [open, setOpen] = useState(null);
-    // Collections opens on hover as well (spec 2026-09-15 rail tweaks): a hover
-    // open closes when the pointer leaves and never steals focus; a click open
-    // is sticky and moves focus into the menu for the keyboard.
-    const [hovered, setHovered] = useState(false);
-    const menuId = (key) => `sm-rail-menu${uid}${key}`;
-    const toggle = (key) => setOpen((cur) => (cur === key ? null : key));
-    const close = () => setOpen(null);
-    const hoverLeave = () => setHovered(false);
-    // A click open moves focus into the menu; a pointer down outside closes it.
-    // Outside means outside the menu and its trigger — the rest of the rail
-    // counts too (2026-09-26); the trigger is left to its own toggle.
-    useEffect(() => {
-        if (!open || !root.current)
-            return;
-        if (!hovered)
-            root.current.querySelector(`#${CSS.escape(menuId(open))} [role=menuitem]`)?.focus();
-        const onPointerDown = (e) => {
-            if (!(e.target instanceof Node))
-                return;
-            const menu = root.current?.querySelector(`#${CSS.escape(menuId(open))}`);
-            const trigger = root.current?.querySelector(`[aria-controls="${menuId(open)}"]`);
-            if (menu?.contains(e.target) || trigger?.contains(e.target))
-                return;
-            close();
-        };
-        document.addEventListener("pointerdown", onPointerDown);
-        return () => document.removeEventListener("pointerdown", onPointerDown);
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [open]);
-    const onKeyDown = (e) => {
-        if (!open || !root.current)
-            return;
-        if (e.key === "Escape") {
-            close();
-            root.current.querySelector(`[aria-controls="${menuId(open)}"]`)?.focus();
-        }
-        else if (e.key === "ArrowDown" || e.key === "ArrowUp") {
-            const items = Array.from(root.current.querySelectorAll(`#${CSS.escape(menuId(open))} [role=menuitem]`));
-            if (!items.length)
-                return;
-            e.preventDefault();
-            const i = items.indexOf(document.activeElement);
-            items[(i + (e.key === "ArrowDown" ? 1 : -1) + items.length) % items.length].focus();
-        }
-    };
-    const link = (key, label, icon, href) => (_jsx("li", { className: "sm-rail__item", children: _jsxs(RouteLink, { className: "sm-rail__btn", href: href, "aria-current": key === active ? "page" : undefined, onClick: close, children: [_jsx("span", { className: "sm-rail__tile", children: icon }), _jsx("span", { className: "sm-rail__label", title: label, children: label })] }) }, key));
-    // A collection with `admin.showInNav` is a rail item of its own; the rest stay in the Collections menu.
-    const pinned = registry.collections.filter((c) => c.inNav);
-    const collections = registry.collections.filter((c) => !c.inNav);
-    const collectionActive = collections.some((c) => c.name === active);
-    const collectionsOpen = open === "collections" || (hovered && open === null);
-    const name = email?.split("@")[0] ?? "Editor";
-    const initials = name.slice(0, 2).toUpperCase();
-    return (_jsxs("nav", { className: "sm-rail", "aria-label": "Primary", ref: root, onKeyDown: onKeyDown, children: [_jsxs("div", { className: "sm-rail__item", children: [_jsx("button", { type: "button", className: "sm-rail__brand", title: "Smoodly", "aria-haspopup": "menu", "aria-expanded": open === "brand", "aria-controls": menuId("brand"), onClick: () => toggle("brand"), children: _jsx(AppIcon, {}) }), _jsxs("ul", { className: "sm-rail__menu sm-rail__menu--brand", role: "menu", id: menuId("brand"), "data-open": open === "brand", children: [_jsx("li", { role: "none", children: _jsx(ExtLink, { href: consoleLinks().project, onClick: close, children: "This site at smoodly.io" }) }), _jsx("li", { role: "none", children: _jsx(ExtLink, { href: consoleLinks().docs, onClick: close, children: "Documentation" }) }), _jsxs("li", { className: "sm-rail__menu-version", role: "presentation", children: ["Smoodly ", SMOODLY_VERSION] })] })] }), _jsxs("ul", { className: "sm-rail__list", children: [link("pages", "Pages", _jsx(PanelTop, { ...ICON }), adminHref("/pages")), pinned.map((c) => link(c.name, c.title, _jsx(Layers, { ...ICON }), adminHref(`/${c.name}`))), collections.length > 0 && (_jsxs("li", { className: "sm-rail__item", onMouseEnter: () => setHovered(true), onMouseLeave: hoverLeave, children: [_jsxs("button", { type: "button", className: "sm-rail__btn", "aria-current": collectionActive ? "page" : undefined, "aria-haspopup": "menu", "aria-expanded": collectionsOpen, "aria-controls": menuId("collections"), onClick: () => toggle("collections"), children: [_jsx("span", { className: "sm-rail__tile", children: _jsx(LibraryBig, { ...ICON }) }), _jsx("span", { className: "sm-rail__label", children: "Collections" })] }), _jsx("ul", { className: "sm-rail__menu sm-rail__menu--collections", role: "menu", id: menuId("collections"), "data-open": collectionsOpen, children: collections.map((c) => (_jsx("li", { role: "none", children: _jsx(RouteLink, { role: "menuitem", className: "sm-rail__menu-item", href: adminHref(`/${c.name}`), "aria-current": c.name === active ? "page" : undefined, onClick: () => { close(); hoverLeave(); }, children: _jsx("span", { children: c.title }) }) }, c.name))) })] })), link("media", "Media", _jsx(Image, { ...ICON }), adminHref("/media")), registry.globals.length > 0 && link("globals", "Site", _jsx(Globe, { ...ICON }), adminHref("/globals")), settings && link("settings", "Settings", _jsx(Settings, { ...ICON }), adminHref("/settings"))] }), deploy && (() => {
-                const copy = tileCopy(deploy.status, Date.now());
-                const id = menuId("deploy");
-                return (_jsxs("div", { className: "sm-rail__item sm-rail__deploy", "data-state": deploy.status.state, children: [_jsxs("button", { type: "button", className: "sm-rail__btn", "aria-haspopup": "menu", "aria-expanded": open === "deploy", "aria-controls": id, onClick: () => toggle("deploy"), title: copy.detail, children: [_jsxs("span", { className: `sm-rail__tile${copy.lit ? " sm-rail__tile--lit" : ""}${copy.warn ? " sm-rail__tile--warn" : ""}`, children: [_jsx(RadioTower, { ...ICON }), copy.badge && _jsx("span", { className: "sm-rail__badge", "aria-label": `${copy.badge} changes waiting`, children: copy.badge })] }), _jsx("span", { className: "sm-rail__label", children: copy.label })] }), _jsxs("ul", { className: "sm-rail__menu sm-rail__menu--up", role: "menu", id: id, "data-open": open === "deploy", children: [_jsx("li", { className: "sm-rail__menu-detail", role: "presentation", children: copy.detail }), _jsx("li", { role: "none", children: _jsx("button", { type: "button", role: "menuitem", className: "sm-rail__menu-item", disabled: copy.action === null || deploy.busy, title: copy.disabledReason ?? undefined, onClick: () => { close(); deploy.onDeploy(); }, children: copy.action === "retry" ? "Deploy again" : "Deploy now" }) }), copy.disabledReason && _jsx("li", { className: "sm-rail__menu-note", role: "presentation", children: copy.disabledReason })] })] }));
-            })(), _jsxs("div", { className: "sm-rail__item sm-rail__foot", children: [_jsx("button", { type: "button", className: "sm-rail__user", title: name, "aria-haspopup": "menu", "aria-expanded": open === "user", "aria-controls": menuId("user"), onClick: () => toggle("user"), children: initials }), _jsxs("ul", { className: "sm-rail__menu sm-rail__menu--up", role: "menu", id: menuId("user"), "data-open": open === "user", children: [_jsx("li", { className: "sm-rail__menu-title", role: "presentation", children: email ?? name }), _jsx("li", { role: "none", children: _jsx(ThemeToggle, {}) }), _jsx("li", { role: "none", children: _jsx(ExtLink, { href: consoleLinks().account, onClick: close, children: "My Account" }) }), _jsx("li", { role: "none", children: _jsx("button", { type: "button", role: "menuitem", className: "sm-rail__menu-item", onClick: () => { close(); onSignOut(); }, children: "Sign out" }) })] })] })] }));
-}