smoodly 0.0.13 → 0.0.14

package/README.md

@@ -255,9 +255,12 @@ Implemented:
   collection list. The editor
   is keyed by id, with a locale switcher loading that locale's own tree
   and pointing the canvas at `urls[locale]` and, while no block is
-  selected, page settings (`admin/editor/PageSettings.tsx`: the title and
-  slug of the ACTIVE locale through `pages.rename`; SEO/meta fields stay
-  OQ #17). The entry form prefixes its slug field with the collection's
+  selected, page settings (`admin/editor/PageInspector.tsx`, spec
+  2026-09-10 page fields: **SEO & Social** — title, description, social
+  image, hide from search engines, under the tree's `meta` — and
+  **Settings** — the ACTIVE locale's title and slug through `pages.rename`,
+  the template's page fields under the tree's `fields`, remove from
+  locale). The entry form prefixes its slug field with the collection's
   mount path. The serialized
   registry carries `collections[].path`/`depth`, `pages[].slugs` and
   `pageDepth`, and `defineConfig` validates `homePageSlug` — a real
@@ -278,12 +281,27 @@ Implemented:
   is the two in sequence — `locate` then `load` — for a caller that just
   wants the hit. A folder (null template), an
   unpublished record outside draft mode, or a missing one is `null`.
-  On top of it the published-only content API for menus, sitemaps and
-  custom routes: `getPagesTree({ locale })` (nested
-  `{ id, title, path, hasPage, children }`), `getPage(pathOrId)`,
-  `getEntries(collection, { locale, parent?, order? })`,
-  `getEntry(collection, idOrPath)` (an id, a path, or a bare slug naming a
-  root entry) and `getEntriesTree(collection)`.
+  On top of it the content API for menus, sitemaps and custom routes,
+  published-only unless `draft: true` (spec 2026-09-11):
+  `getPagesTree({ locale, draft? })` (nested
+  `{ id, title, path, hasPage, fields, children }`), `getPage(pathOrId)`,
+  `getEntries(collection, { locale, parent?, order?, where?, limit?, draft? })`
+  — `where` is equality / any-of on shared fields and `limit` a SQL limit,
+  both run by the store — `getEntry(collection, idOrPath)` (an id, a
+  path, or a bare slug naming a root entry) and `getEntriesTree(collection)`.
+  In the app, read through `q` (next bullet) rather than the site layer.
+- `createSmoodlyQueries` (`smoodly/next`, spec 2026-09-11) — the read
+  API the scaffold exports as `q`: `getPageTree({ locale })`,
+  `getPage(pathOrId)`, `getEntries("articles", { where, order, limit,
+  parent })`, `getEntry("articles", idOrPath)` (an id or a path — a bare
+  slug is refused, since its unit would sit under a tag no op fires) and
+  `getShared("header")`. Typed by the registry (names are checked, fields
+  typed), the live draft inside the editor preview, and outside it one
+  `unstable_cache` unit per distinct call under a tag the admin ops
+  expire: `pages:tree` (every page op that changes the listing),
+  `entries:<collection>` (every entry write), `page:<id>`, `entry:<id>`,
+  `shared:<name>`. `filterPageTree(items, keep)` prunes a tree for a nav
+  (a dropped parent drops its subtree).
 - `smoodly/next` — `createPageRenderer`, the site-route seam over that
   layer, bound once by the app like `createAdminOpHandler`. The two route
   files call `renderSmoodlyPath(segments, { locale?, searchParams? })` and
@@ -340,7 +358,8 @@ Implemented:
   registers a visual item, `smoodly.shared({ name, title, fields })` an
   object item; one registration materializes as a singleton entry in
   every supported locale. `site.getShared(item, { locale })` and the Next
-  glue's `getSmoodlyShared(item, { locale })` fetch it code-side; the
+  glue's `q.getShared("footer", { locale })` fetch it code-side (the
+  renderer's `getSmoodlyShared(item, { locale })` still works); the
   editor places a visual item in a zone from the "+" picker as a linked
   `{ type: "shared", fields: { item, ref } }` node the resolve pass
   rewrites into the section, and `z.locked(footer)` binds a zone to one.
@@ -407,6 +426,52 @@ after both are on the registry. From the repo root:
 `prepublishOnly` rebuilds each package. The Claude Code skill
 `.claude/skills/releasing-smoodly` carries the same order with its checks.
 
+## Follow-ups (logged 2026-09-11, queries spec)
+
+- `where` on localized fields (a join on the locale row), ranges and
+  negation; any-of over an array-valued field (any-of compares the text
+  form of the field, so it covers selects, refs and numbers; on a
+  checkboxes, refList or list field `site.getEntries` refuses it rather
+  than match nothing — both adapters agree on the text form, so a
+  one-element array never matches its element).
+- `where` filters a versioned collection's LIVE row, not its published
+  snapshot: an entry whose published version had `kind: "x"` and whose
+  draft changed it to `"y"` drops out of `where: { kind: "x" }` before
+  the change is published. The published gate is per locale row, the
+  filter is on the node's shared fields. Fix by filtering the snapshot
+  (a join on the version row) or by documenting that a versioned
+  collection's shared fields are live for filtering.
+- A GIN index on `entries.fields` when a customer's collection is large
+  enough to need it; additive, no migration.
+- OQ 26: whether page units should carry `pages:tree` too, replacing
+  the neighbour list.
+- Scripts and the seed write through the stores and expire nothing; a
+  `revalidate` hook for out-of-band writers.
+- `getEntriesTree` has no `q` counterpart yet; add one when a site
+  needs a nested collection nav.
+- `getEntry` by id goes through `site.getEntry`, which lists the whole
+  collection to find one row; a primary-key read first would be cheaper
+  on the uncached path (draft mode, first miss).
+
+## Follow-ups (logged 2026-09-10, page fields and SEO spec)
+
+- SEO for entry pages: entries have no `meta`; a `titleField`-based
+  title and a description field are the next step.
+- A `styles` block on pages, when a case needs presentation separate
+  from content.
+- Refs in page fields, once the refs index walks them.
+- A canonical URL field and a search-result preview snippet in the
+  SEO & Social tab.
+- Configurable SEO set (`meta: { seo: { twitter: true } }`) if the four
+  values prove too few.
+- Link fields are raw: an image in a page field reaches a nav link as
+  `{ asset, alt }`, not a URL. Resolve on demand if a nav ever wants one.
+- The social image URL goes through the default `next` loader at 1200px;
+  the cloud's transform loader (OQ 28) should serve a real 1200×630.
+- Page-field labels derive from the key (`showInNavigation` → "Show In
+  Navigation"), as every field's do; a `.label()` builder option would
+  read better for long keys.
+
 ## Follow-ups (logged 2026-09-10, inline editing spec)
 
 - Shared placements ignore field clicks: their fields live in the shared
@@ -713,9 +778,6 @@ the toolbar instead of pushing the content.
   in the single-language scaffold). Adding `locale` to `PageContext` and
   `EntryPageProps` would remove that dependency and let sections that
   format dates stay synchronous.
-- The content API is published-only, so the Articles index in the editor
-  canvas lists published articles while the hero above it is the draft.
-  A draft-aware `getEntries` for draft mode is the fix if that confuses.
 - The image widget edits the URL only; `alt` is set by the seed and cannot
   be changed in the admin.
 - A per-locale collection path or fixed slug must name the default locale;
@@ -923,8 +985,6 @@ the toolbar instead of pushing the content.
 - Nested entries have no admin UI beyond `entries.move`: nothing creates
   a child entry or shows the entry tree, and the entry form's slug prefix
   is the collection's mount base only, not the parent chain.
-- SEO/meta fields in page settings — DESIGN.md OQ #17. Title and slug per
-  locale shipped; nothing writes `PageTree.meta` yet.
 - `pages.get` makes four sequential store round trips for a non-root page
   (`getPage`, `getDraftTree`, `pathsOf`, and the parent read behind
   `parentLocales`; three for a root, which has no parent to read), and the

package/dist/admin/editor/EditorView.js

@@ -20,10 +20,10 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 // The pieces live beside it — `useCanvasBridge` (geometry and messages),
 // `usePageLocale` (switch/add/remove), `CanvasOverlay` and
 // `overlay-geometry` (the chrome above the iframe), `InsertPicker`,
-// `Outline`, `PageSettings`, `NoticePane`.
+// `Outline`, `PageInspector`, `NoticePane`.
 //
 // Chrome follows the design system's visual-editor screen: top bar, toned
-// canvas around a white page, 300px inspector holding fields then outline.
+// canvas around a white page, 360px inspector holding fields then outline.
 //
 // Core code: no next/* imports live here — the bridge is the only piece
 // that knows about Next, and it ships to the site, not the admin.
@@ -33,14 +33,14 @@ import { descriptorAt, getAtPath } from "../field-paths.js";
 import { FieldWidget } from "../forms/FieldWidget.js";
 import { revealField } from "../forms/reveal.js";
 import { tabOf, tabsFor } from "../forms/tabs.js";
-import { allowedSections, canInsert, fillLockedZones, findNode, insertNode, moveNode, moveNodeTo, newNodeId, nodeFromSample, patchNode, patchNodePath, placementNode, removeNode, zoneOf, } from "../tree-ops.js";
+import { allowedSections, canInsert, fillLockedZones, findNode, insertNode, moveNode, moveNodeTo, newNodeId, nodeFromSample, patchNode, patchNodePath, patchPage, placementNode, removeNode, zoneOf, } from "../tree-ops.js";
 import { useDraftAutosave } from "./autosave.js";
 import { CanvasOverlay } from "./CanvasOverlay.js";
 import { InlineRichtext } from "./InlineRichtext.js";
 import { InsertPicker } from "./InsertPicker.js";
 import { NoticePane } from "./NoticePane.js";
 import { Outline } from "./Outline.js";
-import { PageSettings } from "./PageSettings.js";
+import { PageInspector } from "./PageInspector.js";
 import { localeFromUrl } from "./locale-url.js";
 import { plusButtonsFor } from "./overlay-geometry.js";
 import { useCanvasBridge } from "./useCanvasBridge.js";
@@ -438,6 +438,8 @@ export function EditorView({ ops, registry, id }) {
     const doMove = (id, dir) => mutate((t) => moveNode(t, id, dir));
     const doMoveTo = (id, index) => mutate((t) => moveNodeTo(t, id, index));
     const doPatch = (id, ns, key, value) => mutate((t) => patchNode(t, id, ns, key, value));
+    /** A page-level value (page fields, SEO meta) — same dirty/debounce path as a node's (spec 2026-09-10 page fields §5). */
+    const doPatchPage = (ns, key, value) => mutate((t) => patchPage(t, ns, key, value));
     // ── publish ──────────────────────────────────────────────────────────
     const doPublish = async () => {
         setBanner(null);
@@ -539,16 +541,16 @@ export function EditorView({ ops, registry, id }) {
                                             if (!node || !section)
                                                 return null;
                                             return (_jsx(InlineRichtext, { mount: inline.richtext, pageWidth: pageWidth, value: getAtPath(node.fields, session.path), toolset: descriptorAt(section, session.path)?.toolset, onChange: (doc) => { inline.markChanged(); mutate((t) => patchNodePath(t, session.node, session.path, doc)); }, onEscape: inline.end }));
-                                        })()] }) })] }), _jsx(ResizeHandle, {}), _jsxs("aside", { className: "sm-inspector", ref: inspectorRef, children: [_jsxs("div", { className: "sm-card", children: [selected && (selectedSection || selectedShared) ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: "sm-inspector__head", children: [_jsxs("span", { style: { display: "flex", alignItems: "center", gap: 8, minWidth: 0 }, children: [_jsx("span", { className: "sm-blockglyph" }), _jsx("span", { className: "sm-title", style: { overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }, children: selectedSection?.title ?? selectedShared?.title })] }), _jsx(IconButton, { label: "Clear selection", onClick: () => setSelectedId(null), children: "\u00D7" })] }), tabs.length > 0 && (_jsx(Tabs, { tabs: tabs.map((t) => t.tab), value: activeTab, onChange: (t) => setTab(t) }))] })) : (_jsx("div", { className: "sm-inspector__head", children: _jsx("span", { className: "sm-label", children: "Nothing selected \u2014 page settings below" }) })), _jsxs("div", { className: "sm-inspector__body", children: [!selected && record && (_jsx(_Fragment, { children: _jsx(PageSettings, { record: record, locale: locale, registry: registry, path: paths[locale], fixed: isFixedNode(record, registry), onRename: onRename, onRemoveLocale: Object.keys(record.locales).length > 1 &&
-                                                        !isFixedNode(record, registry) &&
-                                                        !(record.parentId === null && record.locales[registry.locales.default]?.slug === registry.homePageSlug)
-                                                        ? () => { void doRemoveLocale(); }
-                                                        : undefined }) })), selected && selectedSection && entries.map(({ key, ns, descriptor }) => (_jsx(FieldWidget, { fieldKey: key, descriptor: descriptor, value: selected[ns]?.[key], refOptions: refOptionsFor(refOptions, refTargets, selectedSection, ns, key, descriptor), inlinePath: ns === "fields" && inline.session?.node === selected.id ? inline.session.path : undefined, onEditHere: () => { const p = inline.session?.path; inline.end(); if (p)
+                                        })()] }) })] }), _jsx(ResizeHandle, {}), _jsxs("aside", { className: "sm-inspector", ref: inspectorRef, children: [_jsxs("div", { className: "sm-card", children: [selected && (selectedSection || selectedShared) ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: "sm-inspector__head", children: [_jsxs("span", { style: { display: "flex", alignItems: "center", gap: 8, minWidth: 0 }, children: [_jsx("span", { className: "sm-blockglyph" }), _jsx("span", { className: "sm-title", style: { overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }, children: selectedSection?.title ?? selectedShared?.title })] }), _jsx(IconButton, { label: "Clear selection", onClick: () => setSelectedId(null), children: "\u00D7" })] }), tabs.length > 0 && (_jsx(Tabs, { tabs: tabs.map((t) => t.tab), value: activeTab, onChange: (t) => setTab(t) }))] })) : record ? (_jsx(PageInspector, { record: record, locale: locale, registry: registry, tree: tree, path: paths[locale], fixed: isFixedNode(record, registry), onRename: onRename, onPatch: doPatchPage, onRemoveLocale: Object.keys(record.locales).length > 1 &&
+                                            !isFixedNode(record, registry) &&
+                                            !(record.parentId === null && record.locales[registry.locales.default]?.slug === registry.homePageSlug)
+                                            ? () => { void doRemoveLocale(); }
+                                            : undefined })) : null, selected && (selectedSection || selectedShared) && (_jsxs("div", { className: "sm-inspector__body", children: [selectedSection && entries.map(({ key, ns, descriptor }) => (_jsx(FieldWidget, { fieldKey: key, descriptor: descriptor, value: selected[ns]?.[key], refOptions: refOptionsFor(refOptions, refTargets, selectedSection, ns, key, descriptor), inlinePath: ns === "fields" && inline.session?.node === selected.id ? inline.session.path : undefined, onEditHere: () => { const p = inline.session?.path; inline.end(); if (p)
                                                     reveal(p, selectedSection); }, onChange: (value) => {
                                                     doPatch(selected.id, ns, key, value);
                                                     if (ns === "fields")
                                                         syncTexts(selected.id, selectedSection, { ...selected.fields, [key]: value });
-                                                } }, `${selected.id}.${ns}.${key}`))), selected && selectedShared && (_jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 10 }, children: [_jsx("p", { className: "sm-hint", children: "This is shared content. Editing it changes every page it is placed on." }), _jsx(RouteLink, { className: "sm-nav-item", href: `${BASE}/shared/${encodeURIComponent(selectedShared.name)}?locale=${encodeURIComponent(locale)}`, children: "Edit shared item \u2192" })] }))] })] }), _jsx("div", { className: "sm-card", children: _jsx(Outline, { selectedId: selectedId, onSelect: select, onMove: doMove, onMoveTo: doMoveTo, onRemove: doRemove, zones: zoneOrder.map((zone) => ({
+                                                } }, `${selected.id}.${ns}.${key}`))), selectedShared && (_jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 10 }, children: [_jsx("p", { className: "sm-hint", children: "This is shared content. Editing it changes every page it is placed on." }), _jsx(RouteLink, { className: "sm-nav-item", href: `${BASE}/shared/${encodeURIComponent(selectedShared.name)}?locale=${encodeURIComponent(locale)}`, children: "Edit shared item \u2192" })] }))] }))] }), _jsx("div", { className: "sm-card", children: _jsx(Outline, { selectedId: selectedId, onSelect: select, onMove: doMove, onMoveTo: doMoveTo, onRemove: doRemove, zones: zoneOrder.map((zone) => ({
                                         zone, locked: policyOf(zone)?.kind === "locked", canTake: zoneCanTake(zone),
                                         nodes: nodesIn(zone).map((node) => ({ node, label: labelOf(node) })),
                                     })), onAddFirst: (zone) => {

package/dist/admin/editor/PageInspector.d.ts

@@ -0,0 +1,21 @@
+import type { PageTree } from "../../render.tsx";
+import type { PageRecord } from "../../store.ts";
+import type { AdminPageTemplate, AdminRegistry } from "../serialize.ts";
+export type PageTab = "SEO & Social" | "Settings";
+export declare function pageTabsFor(template: AdminPageTemplate | undefined): PageTab[];
+export declare function PageInspector({ record, locale, registry, tree, path, fixed, onRename, onRemoveLocale, onPatch }: {
+    record: PageRecord;
+    locale: string;
+    registry: AdminRegistry;
+    tree: PageTree | null;
+    /** The page's path in this locale (the `paths` index). */
+    path: string | undefined;
+    fixed: boolean;
+    onRename(patch: {
+        title?: string;
+        slug?: string;
+    }): Promise<string | null>;
+    /** Absent when the locale cannot be removed: a fixed node, the site root, or the page's last locale. */
+    onRemoveLocale?: () => void;
+    onPatch(ns: "fields" | "meta", key: string, value: unknown): void;
+}): import("react").JSX.Element;

package/dist/admin/editor/PageInspector.js

@@ -0,0 +1,24 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+// The inspector with nothing selected (spec 2026-09-10 page fields §5):
+// the page's title as the head, then SEO & Social (first and default when
+// the template enables it) and Settings — title, slug, the template's
+// page fields, remove from locale. Page tabs keep their own state and
+// reset when the page changes.
+import { useEffect, useState } from "react";
+import { FieldWidget } from "../forms/FieldWidget.js";
+import { Button, Tabs } from "../ui/primitives.js";
+import { PageSettings } from "./PageSettings.js";
+import { SeoSettings } from "./SeoSettings.js";
+export function pageTabsFor(template) {
+    return template?.seo ? ["SEO & Social", "Settings"] : ["Settings"];
+}
+export function PageInspector({ record, locale, registry, tree, path, fixed, onRename, onRemoveLocale, onPatch }) {
+    const template = registry.pages.find((p) => p.name === record.template);
+    const tabs = pageTabsFor(template);
+    const [tab, setTab] = useState(tabs[0]);
+    useEffect(() => { setTab(pageTabsFor(template)[0]); }, [record.id]); // eslint-disable-line react-hooks/exhaustive-deps
+    const active = tabs.includes(tab) ? tab : tabs[0];
+    const title = record.locales[locale]?.title ?? "";
+    return (_jsxs(_Fragment, { children: [_jsx("div", { className: "sm-inspector__head", children: _jsxs("span", { style: { display: "flex", alignItems: "center", gap: 8, minWidth: 0 }, children: [_jsx("span", { className: "sm-pageglyph" }), _jsx("span", { className: "sm-title", style: { overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }, children: title })] }) }), tabs.length > 1 && _jsx(Tabs, { tabs: tabs, value: active, onChange: setTab }), _jsx("div", { className: "sm-inspector__body", children: active === "SEO & Social" ? (_jsx(SeoSettings, { meta: tree?.meta ?? {}, onPatch: (key, value) => onPatch("meta", key, value) })) : (_jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 14 }, children: [_jsx(PageSettings, { record: record, locale: locale, registry: registry, path: path, fixed: fixed, onRename: onRename }), Object.entries(template?.fields ?? {}).map(([key, descriptor]) => (_jsx(FieldWidget, { fieldKey: key, descriptor: descriptor, value: tree?.fields?.[key], onChange: (value) => onPatch("fields", key, value) }, key))), onRemoveLocale && _jsxs(Button, { variant: "secondary", onClick: onRemoveLocale, children: ["Remove from ", locale] })] })) })] }));
+}

package/dist/admin/editor/PageSettings.d.ts

@@ -1,6 +1,6 @@
 import type { PageRecord } from "../../store.ts";
 import type { AdminRegistry } from "../serialize.ts";
-export declare function PageSettings({ record, locale, registry, path, fixed, onRename, onRemoveLocale }: {
+export declare function PageSettings({ record, locale, registry, path, fixed, onRename }: {
     record: PageRecord;
     locale: string;
     registry: AdminRegistry;
@@ -12,6 +12,4 @@ export declare function PageSettings({ record, locale, registry, path, fixed, on
         title?: string;
         slug?: string;
     }): Promise<string | null>;
-    /** Absent when the locale cannot be removed: a fixed node, the site root, or the page's last locale. */
-    onRemoveLocale?: () => void;
 }): import("react").JSX.Element | null;

package/dist/admin/editor/PageSettings.js

@@ -3,12 +3,13 @@ import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 // Page settings (spec 2026-09-05 §7; per locale since spec 2026-09-06
 // §6): the ACTIVE locale's title and slug, saved through pages.rename,
 // and "Remove from this locale". The switcher in the canvas meta row
-// selects the locale, so there are no per-locale tabs here. SEO/meta fields are OQ
-// #17's own design pass. Rendered in the inspector while no block is
-// selected.
+// selects the locale, so there are no per-locale tabs here. Rendered on
+// the Settings tab of PageInspector while no block is selected; the SEO
+// tab and the remove-from-locale button live there (spec 2026-09-10 page
+// fields §5).
 import { useEffect, useState } from "react";
-import { Button, Field, SectionLabel } from "../ui/primitives.js";
-export function PageSettings({ record, locale, registry, path, fixed, onRename, onRemoveLocale }) {
+import { Field, SectionLabel } from "../ui/primitives.js";
+export function PageSettings({ record, locale, registry, path, fixed, onRename }) {
     const row = record.locales[locale];
     const [draft, setDraft] = useState({ title: row?.title ?? "", slug: row?.slug ?? "" });
     const [error, setError] = useState(null);
@@ -36,5 +37,5 @@ export function PageSettings({ record, locale, registry, path, fixed, onRename,
             void commit(key);
         }
     };
-    return (_jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 14 }, children: [_jsxs(SectionLabel, { children: ["Page \u00B7 ", locale] }), fixed && _jsx("span", { className: "sm-hint", children: "Owned by code \u2014 change it in the registration." }), error && _jsx("span", { className: "sm-error", children: error }), _jsx(Field, { label: "Title", children: _jsx("input", { className: "sm-input", disabled: fixed, value: draft.title, onChange: (e) => setDraft((d) => ({ ...d, title: e.target.value })), onBlur: () => void commit("title"), onKeyDown: onKey("title") }) }), _jsx(Field, { label: "Slug", hint: path ?? "", children: _jsx("input", { className: "sm-input sm-input--mono", disabled: fixed || isHome, value: draft.slug, onChange: (e) => setDraft((d) => ({ ...d, slug: e.target.value })), onBlur: () => void commit("slug"), onKeyDown: onKey("slug") }) }), onRemoveLocale && (_jsxs(Button, { variant: "secondary", onClick: onRemoveLocale, children: ["Remove from ", locale] }))] }));
+    return (_jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 14 }, children: [_jsxs(SectionLabel, { children: ["Page \u00B7 ", locale] }), fixed && _jsx("span", { className: "sm-hint", children: "Owned by code \u2014 change it in the registration." }), error && _jsx("span", { className: "sm-error", children: error }), _jsx(Field, { label: "Title", children: _jsx("input", { className: "sm-input", disabled: fixed, value: draft.title, onChange: (e) => setDraft((d) => ({ ...d, title: e.target.value })), onBlur: () => void commit("title"), onKeyDown: onKey("title") }) }), _jsx(Field, { label: "Slug", hint: path ?? "", children: _jsx("input", { className: "sm-input sm-input--mono", disabled: fixed || isHome, value: draft.slug, onChange: (e) => setDraft((d) => ({ ...d, slug: e.target.value })), onBlur: () => void commit("slug"), onKeyDown: onKey("slug") }) })] }));
 }

package/dist/admin/editor/SeoSettings.d.ts

@@ -0,0 +1,7 @@
+export declare const SEO_TITLE_MAX = 60;
+export declare const SEO_DESCRIPTION_MAX = 160;
+export type SeoKey = "title" | "description" | "ogImage" | "noindex";
+export declare function SeoSettings({ meta, onPatch }: {
+    meta: Record<string, unknown>;
+    onPatch(key: SeoKey, value: unknown): void;
+}): import("react").JSX.Element;

package/dist/admin/editor/SeoSettings.js

@@ -0,0 +1,15 @@
+"use client";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { MediaWidget } from "../forms/MediaWidget.js";
+import { Field, Switch } from "../ui/primitives.js";
+export const SEO_TITLE_MAX = 60;
+export const SEO_DESCRIPTION_MAX = 160;
+const str = (v) => (typeof v === "string" ? v : "");
+function Counter({ n, max }) {
+    return _jsxs("span", { className: n > max ? "sm-counter--over" : undefined, children: [n, "/", max] });
+}
+export function SeoSettings({ meta, onPatch }) {
+    const title = str(meta.title);
+    const description = str(meta.description);
+    return (_jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 14 }, children: [_jsx(Field, { label: "Title", counter: _jsx(Counter, { n: title.length, max: SEO_TITLE_MAX }), hint: "Used in search results and link previews. Empty: the page title.", children: _jsx("input", { className: "sm-input", value: title, onChange: (e) => onPatch("title", e.target.value) }) }), _jsx(Field, { label: "Description", counter: _jsx(Counter, { n: description.length, max: SEO_DESCRIPTION_MAX }), children: _jsx("textarea", { className: "sm-textarea", rows: 3, value: description, onChange: (e) => onPatch("description", e.target.value) }) }), _jsx(Field, { label: "Social image", hint: "1200\u00D7630 recommended", asDiv: true, children: _jsx(MediaWidget, { descriptor: { type: "image" }, value: meta.ogImage, onChange: (v) => onPatch("ogImage", v) }) }), _jsx(Field, { label: "Hide from search engines", asDiv: true, children: _jsx(Switch, { checked: meta.noindex === true, onChange: (v) => onPatch("noindex", v), label: "Hide from search engines" }) })] }));
+}

package/dist/admin/forms/FieldWidget.d.ts

@@ -1,6 +1,6 @@
 import type { ReactElement, ReactNode } from "react";
 import type { AdminField } from "../serialize.ts";
-export declare function FieldWidget({ descriptor: d, value, onChange, errors, path: pathProp, bare, refOptions, fieldKey, prefix, mark, inlinePath, onEditHere, }: {
+export declare function FieldWidget({ descriptor: d, value: valueProp, onChange, errors, path: pathProp, bare, refOptions, fieldKey, prefix, mark, inlinePath, onEditHere, }: {
     descriptor: AdminField;
     value: unknown;
     onChange(value: unknown): void;

package/dist/admin/forms/FieldWidget.js

@@ -3,12 +3,15 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { RichtextWidget } from "./RichtextWidget.js";
 import { MediaWidget } from "./MediaWidget.js";
 import { ListField } from "./ListField.js";
-import { Button, Field, IconButton } from "../ui/primitives.js";
+import { optionsOf } from "../../fields.js";
+import { Button, Field, IconButton, Switch } from "../ui/primitives.js";
 import { patchObject } from "./list.js";
 const label = (key) => key.replace(/([A-Z])/g, " $1").replace(/^./, (c) => c.toUpperCase());
-export function FieldWidget({ descriptor: d, value, onChange, errors, path: pathProp, bare, refOptions = [], fieldKey, prefix, mark, inlinePath, onEditHere, }) {
+export function FieldWidget({ descriptor: d, value: valueProp, onChange, errors, path: pathProp, bare, refOptions = [], fieldKey, prefix, mark, inlinePath, onEditHere, }) {
     const path = pathProp ?? fieldKey;
     const message = errors?.[path];
+    // The descriptor's default shows while the value is absent (spec 2026-09-10 page fields §1).
+    const value = valueProp === undefined && d.default !== undefined ? d.default : valueProp;
     const optionTitle = (o) => o.status === "draft" ? `${o.title} (draft)` : o.title;
     let control;
     let counter;
@@ -27,9 +30,26 @@ export function FieldWidget({ descriptor: d, value, onChange, errors, path: path
         case "number":
             control = (_jsx("input", { className: "sm-input", type: "number", value: value == null ? "" : String(value), onChange: (e) => onChange(e.target.value === "" ? undefined : Number(e.target.value)) }));
             break;
+        case "boolean":
+            control = _jsx(Switch, { checked: value === true, onChange: onChange });
+            break;
         case "select": {
-            const options = Array.isArray(d.options) ? d.options : [];
-            control = (_jsxs("select", { className: "sm-select", value: String(value ?? ""), onChange: (e) => onChange(e.target.value), children: [d.optional === true && _jsx("option", { value: "", children: "\u2014" }), options.map((o) => _jsx("option", { value: o, children: o }, o))] }));
+            const options = optionsOf(d.options);
+            control = (_jsxs("select", { className: "sm-select", value: String(value ?? ""), onChange: (e) => onChange(e.target.value), children: [d.optional === true && _jsx("option", { value: "", children: "\u2014" }), options.map((o) => _jsx("option", { value: o.value, children: o.label }, o.value))] }));
+            break;
+        }
+        case "radio": {
+            asDiv = true; // several inputs: never inside one implicit label
+            control = (_jsx("div", { className: "sm-choices", role: "radiogroup", children: optionsOf(d.options).map((o) => (_jsxs("label", { className: "sm-choice", children: [_jsx("input", { type: "radio", name: path, value: o.value, checked: value === o.value, onChange: () => onChange(o.value) }), o.label] }, o.value))) }));
+            break;
+        }
+        case "checkboxes": {
+            asDiv = true;
+            const chosen = Array.isArray(value) ? value : [];
+            const all = optionsOf(d.options);
+            // Stored in option order, whatever order the boxes were ticked in.
+            const toggle = (v, on) => onChange(all.map((o) => o.value).filter((x) => (x === v ? on : chosen.includes(x))));
+            control = (_jsx("div", { className: "sm-choices", children: all.map((o) => (_jsxs("label", { className: "sm-choice", children: [_jsx("input", { type: "checkbox", checked: chosen.includes(o.value), onChange: (e) => toggle(o.value, e.target.checked) }), o.label] }, o.value))) }));
             break;
         }
         case "richtext":

package/dist/admin/ops-impl.js

@@ -1,7 +1,7 @@
 import { entryFieldsIn, entryTitleIn } from "../entry-store.js";
 import { ASSET_COLLECTION } from "../media.js";
 import { BASE } from "./shell/base.js";
-import { affectedTargets, entryTag, pageTag, sharedTag } from "../revalidate.js";
+import { affectedTargets, collectionTag, entryTag, pageTag, pagesTreeTag, sharedTag } from "../revalidate.js";
 import { ensureFixedNodes, fixedNodeOf } from "./fixed-nodes.js";
 import { ensureSharedItems } from "./shared-items.js";
 import { validateFields } from "./validate.js";
@@ -122,6 +122,36 @@ export function createAdminOps(deps) {
                 effects.revalidate(sharedTag(item.name));
         }
     };
+    /** An asset's metadata (alt, title, caption, credit) is read wherever media
+     *  resolves (spec 2026-09-08 §9): the entry and page units that reference the
+     *  asset, directly or through an entry, the shared items among those rows,
+     *  and the list units of every referencing entry's collection. The walk is
+     *  the entry fan-out's, seeded with the asset's id — which is no entry, so
+     *  it gets no tag of its own. */
+    const expireAssetUsers = async (assetId) => {
+        if (!effects?.revalidate)
+            return;
+        const { pageIds, entryIds } = await affectedTargets({ pages, entries }, assetId);
+        const users = entryIds.filter((id) => id !== assetId);
+        for (const id of users)
+            effects.revalidate(entryTag(id));
+        for (const id of pageIds)
+            effects.revalidate(pageTag(id));
+        const touched = new Set(users);
+        for (const item of config.registry.shared ?? []) {
+            const row = (await entries.list(item.name))[0];
+            if (row && touched.has(row.id))
+                effects.revalidate(sharedTag(item.name));
+        }
+        for (const c of config.registry.collections ?? []) {
+            for (const id of users) {
+                if (await entries.get(c.name, id)) {
+                    effects.revalidate(collectionTag(c.name));
+                    break;
+                }
+            }
+        }
+    };
     /** Expire the cached units a tree change touched, in order, once each. */
     const expirePages = (ids) => {
         if (!effects?.revalidate)
@@ -129,6 +159,10 @@ export function createAdminOps(deps) {
         for (const id of new Set(ids.filter((x) => typeof x === "string")))
             effects.revalidate(pageTag(id));
     };
+    /** The tree listing's unit (spec 2026-09-11 §2): every page op that changes what it shows. */
+    const expireTree = () => effects?.revalidate?.(pagesTreeTag());
+    /** A collection's list units: every entry write, since a non-versioned collection's published read is its live row. */
+    const expireCollection = (name) => effects?.revalidate?.(collectionTag(name));
     /** A node and every descendant, node first, in listPages() order. */
     const subtreeIds = async (id) => {
         const all = await pages.listPages();
@@ -244,10 +278,12 @@ export function createAdminOps(deps) {
                     // A root create competes with the code-owned slugs: make sure they exist first.
                     await ensureFixedNodes(pages, config);
                 }
-                return ok(await pages.createPage({
+                const created = await pages.createPage({
                     locale: input.locale, slug: input.slug, template: input.template, parentId: input.parentId,
                     ...(input.title !== undefined ? { title: input.title } : {}),
-                }));
+                });
+                expireTree();
+                return ok(created);
             }),
             saveDraft: (id, locale, tree) => guard(async () => {
                 const unsupported = supportedLocale(locale);
@@ -286,12 +322,18 @@ export function createAdminOps(deps) {
                         }
                     }
                 }
+                // The page's own fields (spec 2026-09-10 page fields §2); SEO meta is never validated.
+                const pageDescs = openTemplate(record.template)?.schema?.fields ?? {};
+                for (const fe of validateFields(draft.fields ?? {}, pageDescs, elementDescs)) {
+                    fieldErrors.push({ field: `page.fields.${fe.field}`, message: fe.message });
+                }
                 if (fieldErrors.length > 0) {
                     return err("validation", `smoodly: cannot publish "${row.slug}" — fix the listed fields first.`, fieldErrors);
                 }
                 const published = await pages.publish(id, locale);
                 // The parent's cached unit lists its published children.
                 expirePages([published.id, published.parentId]);
+                expireTree();
                 return ok(published);
             }),
             delete: (id) => guard(async () => {
@@ -307,6 +349,7 @@ export function createAdminOps(deps) {
                 // The cached unit is keyed by (locale, path) but tagged by the id
                 // found at the first miss; the parent's unit lists its children.
                 expirePages([id, record.parentId]);
+                expireTree();
                 return ok(null);
             }),
             rename: (id, patch) => guard(async () => {
@@ -325,6 +368,7 @@ export function createAdminOps(deps) {
                 // Every descendant's path changed with this segment; the parent
                 // lists this node's title and path.
                 expirePages([...(await subtreeIds(id)), record.parentId]);
+                expireTree();
                 return ok(renamed);
             }),
             move: (id, to) => guard(async () => {
@@ -347,6 +391,7 @@ export function createAdminOps(deps) {
                 }
                 const moved = await pages.move(id, to);
                 expirePages([...(await subtreeIds(id)), record.parentId, moved.parentId]);
+                expireTree();
                 return ok(moved);
             }),
             setTemplate: (id, template) => guard(async () => {
@@ -363,7 +408,9 @@ export function createAdminOps(deps) {
                 if (registration.schema.slug !== undefined) {
                     return err("validation", `smoodly: page template "${template}" is fixed — Smoodly creates that page for you.`);
                 }
-                return ok(await pages.setTemplate(id, template));
+                const withTemplate = await pages.setTemplate(id, template);
+                expireTree();
+                return ok(withTemplate);
             }),
             addLocale: (id, locale, options) => guard(async () => {
                 const unsupported = supportedLocale(locale) ?? supportedLocale(options?.from);
@@ -371,8 +418,10 @@ export function createAdminOps(deps) {
                     return unsupported;
                 if (!(await pages.getPage(id)))
                     return err("not_found", `smoodly: no page "${id}".`);
-                // A new locale is a draft: nothing public changes, nothing to expire.
-                return ok(await pages.addLocale(id, locale, { from: options.from }));
+                // A new locale is a draft: nothing public changes but the tree listing (spec 2026-09-11 §2).
+                const added = await pages.addLocale(id, locale, { from: options.from });
+                expireTree();
+                return ok(added);
             }),
             removeLocale: (id, locale) => guard(async () => {
                 const unsupported = supportedLocale(locale);
@@ -388,6 +437,7 @@ export function createAdminOps(deps) {
                 const removed = await pages.removeLocale(id, locale);
                 // The locale may have been published: its unit and the parent's listing go.
                 expirePages([id, record.parentId]);
+                expireTree();
                 return ok(removed);
             }),
         },
@@ -417,7 +467,9 @@ export function createAdminOps(deps) {
                 const fieldErrors = validateFields(input.fields, descriptors, elementDescs);
                 if (fieldErrors.length > 0)
                     return err("validation", "Some fields need attention.", fieldErrors);
-                return ok(await entries.create(collection, input.fields, { locale: input.locale, parentId: input.parentId ?? null }));
+                const created = await entries.create(collection, input.fields, { locale: input.locale, parentId: input.parentId ?? null });
+                expireCollection(collection);
+                return ok(created);
             }),
             save: (collection, id, locale, fields) => guard(async () => {
                 const unsupported = supportedLocale(locale);
@@ -431,6 +483,7 @@ export function createAdminOps(deps) {
                     return err("validation", "Some fields need attention.", fieldErrors);
                 const entry = await entries.update(collection, id, locale, fields);
                 await fanOut(id);
+                expireCollection(collection);
                 return ok(entry);
             }),
             setStatus: (collection, id, locale, status) => guard(async () => {
@@ -439,24 +492,29 @@ export function createAdminOps(deps) {
                     return unsupported;
                 const entry = await entries.setStatus(collection, id, locale, status);
                 await fanOut(id);
+                expireCollection(collection);
                 return ok(entry);
             }),
             // The tag expires only after the delete succeeded; a blocked delete expires nothing.
-            delete: (collection, id) => guard(async () => (await entries.delete(collection, id), await fanOut(id), ok(null))),
+            delete: (collection, id) => guard(async () => (await entries.delete(collection, id), await fanOut(id), expireCollection(collection), ok(null))),
             move: (collection, id, to) => guard(async () => {
                 const moved = await entries.move(collection, id, to);
                 if (effects?.revalidate) {
                     for (const entryId of await entrySubtreeIds(collection, id))
                         effects.revalidate(entryTag(entryId));
                 }
+                expireCollection(collection);
                 return ok(moved);
             }),
-            // A new locale starts as a draft: nothing public changes, nothing to expire.
+            // A new locale starts as a draft: nothing public changes, but the collection's
+            // list units are expired anyway (spec 2026-09-11 §2) so they can never go stale.
             addLocale: (collection, id, locale, options) => guard(async () => {
                 const unsupported = supportedLocale(locale);
                 if (unsupported)
                     return unsupported;
-                return ok(await entries.addLocale(collection, id, locale, { from: options.from }));
+                const added = await entries.addLocale(collection, id, locale, { from: options.from });
+                expireCollection(collection);
+                return ok(added);
             }),
             removeLocale: (collection, id, locale) => guard(async () => {
                 const unsupported = supportedLocale(locale);
@@ -464,6 +522,7 @@ export function createAdminOps(deps) {
                     return unsupported;
                 const entry = await entries.removeLocale(collection, id, locale);
                 await fanOut(id);
+                expireCollection(collection);
                 return ok(entry);
             }),
         },
@@ -560,7 +619,9 @@ export function createAdminOps(deps) {
                         return err("validation", `smoodly: ${key} must be text.`);
                     patch[key] = v;
                 }
-                return ok(await assets.update(id, patch));
+                const updated = await assets.update(id, patch);
+                await expireAssetUsers(id);
+                return ok(updated);
             }),
             delete: (id) => guard(async () => (assets ? (await assets.delete(id), ok(null)) : noMedia())),
             usage: (id) => guard(async () => {

package/dist/admin/serialize.d.ts

@@ -38,6 +38,10 @@ export type AdminPageTemplate = {
     /** The per-locale segments, only when the registration declares an object. */
     slugs?: Record<string, string>;
     zones: Record<string, ZonePolicy>;
+    /** The template's page fields (spec 2026-09-10 page fields §5), edited on the Settings tab. */
+    fields: Record<string, AdminField>;
+    /** `meta: { seo: true }` — the SEO & Social tab exists for this template. */
+    seo: boolean;
 };
 export type AdminShared = {
     name: string;

package/dist/admin/serialize.js

@@ -69,6 +69,8 @@ export function serializeAdminConfig(config) {
                 ...(slug !== undefined ? { slug } : {}),
                 ...(typeof p.slug === "object" && p.slug !== null ? { slugs: { ...p.slug } } : {}),
                 zones: p.zones ?? {},
+                fields: serializeMap(p.fields),
+                seo: p.meta?.seo === true,
             };
         }),
         shared: (config.registry.shared ?? []).map((s) => ({

package/dist/admin/tree-ops.d.ts

@@ -32,3 +32,5 @@ export declare function nodeFromSample(section: Pick<AdminSection, "name" | "fie
  * schema. Returns the same tree when nothing changed. */
 export declare function fillLockedZones(tree: PageTree, policies: Record<string, ZonePolicy>, sections: AdminSection[], sharedIds?: Record<string, string>): PageTree;
 export declare function newNodeId(type: string): string;
+/** A page-level value — the template's page fields or the SEO meta (spec 2026-09-10 page fields §5). */
+export declare function patchPage(tree: PageTree, ns: "fields" | "meta", key: string, value: unknown): PageTree;