smoodly 0.0.34 → 0.0.36

package/dist/admin/drift.js

@@ -2,6 +2,7 @@ import { optionValues } from "../fields.js";
 import { isHidden } from "../conditions.js";
 import { allowedOf } from "../toolset.js";
 import { CUSTOM_NODE_TYPE } from "../custom/schema.js";
+import { SEO_KEY } from "../seo.js";
 import { CSS_KEY, GLOBAL_NODE_TYPE, SETTINGS_KEY, STYLES_KEY } from "../global.js";
 export const SEVERITY = {
     "unknown-section": "broken", "unknown-element": "broken", "unknown-shape": "broken", "unknown-collection": "broken",
@@ -209,7 +210,7 @@ export function pageDrift(registry, template, tree) {
     out.push(...holderDrift(registry, { scope: "page", name: shape.name }, "page.fields", { fields: tree.fields ?? {} }, { fields: shape.fields }));
     return out;
 }
-const RESERVED = new Set(["slug", SETTINGS_KEY, STYLES_KEY, CSS_KEY]);
+const RESERVED = new Set(["slug", SEO_KEY, SETTINGS_KEY, STYLES_KEY, CSS_KEY]);
 function localization(subject, descs, input, out) {
     if (!input.shared || !input.own)
         return;
@@ -231,7 +232,7 @@ export function entryDrift(registry, name, input) {
     const collection = registry.collections.find((c) => c.name === name);
     if (collection) {
         const subject = { scope: "collection", name };
-        const { slug: _slug, ...fields } = input.fields;
+        const { slug: _slug, [SEO_KEY]: _seo, ...fields } = input.fields;
         out.push(...holderDrift(registry, subject, "", { fields }, { fields: collection.fields }));
         localization(subject, collection.fields, input, out);
         return out;

package/dist/admin/editor/EditorView.js

@@ -64,6 +64,7 @@ import { PublishControl } from "../ui/PublishControl.js";
 import { confirm, DISCARD_CONFIRM } from "../ui/confirm.js";
 import { HistoryModal, historyRows } from "../ui/HistoryModal.js";
 import { draftToken } from "../../draft-token.js";
+import { useUnloadGuard } from "../shell/router.js";
 import { isStale, staleInfoOf } from "../shell/stale.js";
 import { StaleBanner } from "../ui/StaleBanner.js";
 import { DriftNotice } from "../ui/DriftNotice.js";
@@ -150,9 +151,14 @@ export function EditorView({ ops, registry, id }) {
             const r = await ops.pages.saveDraft(id, target, t, token());
             if (r.ok) {
                 // The badge and Publish follow each save without a re-get: saveDraft answers with the version id and the new token.
-                setRecord((rec) => rec?.locales[target]
-                    ? { ...rec, locales: { ...rec.locales, [target]: { ...rec.locales[target], draftVersionId: r.data.versionId, draftSavedAt: r.data.draft?.savedAt ?? null } } }
-                    : rec);
+                // The ref moves with the ack, not with the next render: a save that follows an unmounted view's
+                // (close()) must carry this token, and no render will ever run to refresh it (review I3).
+                const rec = recordRef.current;
+                if (rec?.locales[target]) {
+                    const next = { ...rec, locales: { ...rec.locales, [target]: { ...rec.locales[target], draftVersionId: r.data.versionId, draftSavedAt: r.data.draft?.savedAt ?? null } } };
+                    recordRef.current = next;
+                    setRecord(next);
+                }
                 setDirty(false);
                 presence?.announce(pageTarget(target), r.data.draft?.savedAt ?? null);
             }
@@ -166,6 +172,7 @@ export function EditorView({ ops, registry, id }) {
     // autosave (spec 2026-09-13 §4); the save ack refreshes the canvas
     // through the same inline-session deferral as the page's.
     const globalEdit = useGlobalEdit({ ops, onSaved: (name) => { setGlobalDirty(false); inlineRef.current?.onSaved(); presence?.announce({ kind: "global", id: name, locale }, null); } });
+    useUnloadGuard(dirty || saveState !== "saved" || globalDirty || globalEdit.saveState !== "saved");
     const patchGlobal = (name, path, value) => {
         globalEdit.patch(name, path, value);
         setGlobalDirty(true);

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

@@ -1,7 +1,13 @@
 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 }: {
+export declare function SeoSettings({ meta, onPatch, titleHint, descriptionHint, imageHint }: {
     meta: Record<string, unknown>;
     onPatch(key: SeoKey, value: unknown): void;
+    /** What an empty title does; the page editor's default names the page title (an entry's names its title field). */
+    titleHint?: string;
+    /** What an empty description does, when it falls back on a field. */
+    descriptionHint?: string;
+    /** What an empty social image does, when it falls back on a field. */
+    imageHint?: string;
 }): import("react").JSX.Element;

package/dist/admin/editor/SeoSettings.js

@@ -8,8 +8,8 @@ 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 }) {
+export function SeoSettings({ meta, onPatch, titleHint, descriptionHint, imageHint }) {
     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(MediaWidget, { descriptor: { type: "image" }, value: meta.ogImage, onChange: (v) => onPatch("ogImage", v), label: "Social image", hint: "1200\u00D7630 recommended" }), _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" }) })] }));
+    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. ${titleHint ?? "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 }), hint: descriptionHint, children: _jsx("textarea", { className: "sm-textarea", rows: 3, value: description, onChange: (e) => onPatch("description", e.target.value) }) }), _jsx(MediaWidget, { descriptor: { type: "image" }, value: meta.ogImage, onChange: (v) => onPatch("ogImage", v), label: "Social image", hint: imageHint ? `1200×630 recommended. ${imageHint}` : "1200×630 recommended" }), _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/editor/autosave.d.ts

@@ -12,6 +12,11 @@ export type DraftAutosave = {
     subscribe(listener: () => void): () => void;
     /** Cancel pending timers; call on unmount. */
     dispose(): void;
+    /** Unmount: save a pending edit now, cancel the timers, and retry nothing
+     *  afterwards (spec 2026-09-29 pre-install fixes §4). */
+    close(): Promise<boolean>;
+    /** Undo `close()` when the hook's effect runs again (React StrictMode mounts, cleans up, mounts). */
+    reopen(): void;
     /** Leave `stale` after the record was reloaded: timers cleared, the reloaded value counts as saved. */
     reset(): void;
 };
@@ -26,7 +31,7 @@ export declare function createDraftAutosave<T>(opts: {
 export type DraftAutosaveOptions<T> = Parameters<typeof createDraftAutosave<T>>[0];
 /** React glue: one controller per mount, always calling the latest
  *  `read`/`persist`/`onSaved` (their identities change on every render —
- *  `ops` and `slug` are props), timers cleared on unmount. */
+ *  `ops` and `slug` are props), a pending edit saved on unmount. */
 export declare function useDraftAutosave<T>(opts: DraftAutosaveOptions<T>): {
     saveState: SaveState;
     mark: () => void;

package/dist/admin/editor/autosave.js

@@ -12,13 +12,24 @@ export function createDraftAutosave(opts) {
     let revision = 0;
     let savedRevision = 0;
     let state = "saved";
+    let closed = false;
+    /** The save on the wire, if any: close() waits for it instead of racing it with a second save. */
+    let inflight = null;
     const listeners = new Set();
     const setState = (next) => {
         state = next;
         for (const l of listeners)
             l();
     };
-    const save = async () => {
+    const save = () => {
+        const run = send();
+        inflight = run;
+        const clear = () => { if (inflight === run)
+            inflight = null; };
+        run.then(clear, clear);
+        return run;
+    };
+    const send = async () => {
         const current = opts.read();
         if (current === null)
             return true;
@@ -60,6 +71,10 @@ export function createDraftAutosave(opts) {
         }
         else {
             // Keep local state; retry with a doubling, capped delay.
+            if (closed) {
+                setState("error");
+                return false;
+            }
             setState("error");
             const delay = retryDelay;
             retryDelay = Math.min(delay * 2, retryCapMs);
@@ -102,6 +117,28 @@ export function createDraftAutosave(opts) {
                 retryTimer = null;
             }
         },
+        close() {
+            closed = true;
+            if (debounceTimer) {
+                clearTimeout(debounceTimer);
+                debounceTimer = null;
+            }
+            if (retryTimer) {
+                clearTimeout(retryTimer);
+                retryTimer = null;
+            }
+            // A save in flight holds the token the next one must carry, and only its ack moves it (review I3):
+            // wait, then send whatever the ack did not cover.
+            const remainder = () => {
+                if (state === "stale")
+                    return Promise.resolve(false);
+                if (revision === savedRevision)
+                    return Promise.resolve(true);
+                return save();
+            };
+            return inflight ? inflight.then(remainder) : remainder();
+        },
+        reopen() { closed = false; },
         reset() {
             if (debounceTimer) {
                 clearTimeout(debounceTimer);
@@ -119,7 +156,7 @@ export function createDraftAutosave(opts) {
 }
 /** React glue: one controller per mount, always calling the latest
  *  `read`/`persist`/`onSaved` (their identities change on every render —
- *  `ops` and `slug` are props), timers cleared on unmount. */
+ *  `ops` and `slug` are props), a pending edit saved on unmount. */
 export function useDraftAutosave(opts) {
     const latest = useRef(opts);
     latest.current = opts;
@@ -131,7 +168,10 @@ export function useDraftAutosave(opts) {
         retryBaseMs: opts.retryBaseMs,
         retryCapMs: opts.retryCapMs,
     }));
-    useEffect(() => () => controller.dispose(), [controller]);
+    useEffect(() => {
+        controller.reopen();
+        return () => { void controller.close(); };
+    }, [controller]);
     const saveState = useSyncExternalStore(controller.subscribe, controller.getState, controller.getState);
     return { saveState, mark: controller.mark, flush: controller.flush, reset: controller.reset };
 }

package/dist/admin/field-label.d.ts

@@ -0,0 +1,2 @@
+/** A key as a caption, sentence case: `spacingTop` → "Spacing top", `css` → "Custom CSS". */
+export declare const fieldLabel: (key: string) => string;

package/dist/admin/field-label.js

@@ -0,0 +1,2 @@
+/** A key as a caption, sentence case: `spacingTop` → "Spacing top", `css` → "Custom CSS". */
+export const fieldLabel = (key) => key === "css" ? "Custom CSS" : key.replace(/([A-Z])/g, (c) => ` ${c.toLowerCase()}`).replace(/^./, (c) => c.toUpperCase());

package/dist/admin/forms/FieldWidget.js

@@ -11,10 +11,10 @@ import { optionsOf } from "../../fields.js";
 import { isHidden } from "../../conditions.js";
 import { cssProblem } from "../../css.js";
 import { Button, Field, Switch } from "../ui/primitives.js";
+import { fieldLabel } from "../field-label.js";
 import { patchObject } from "./list.js";
 import { tidySlug } from "./slug-field.js";
-/** A key as a caption, sentence case: `spacingTop` → "Spacing top", `css` → "Custom CSS". */
-const label = (key) => key === "css" ? "Custom CSS" : key.replace(/([A-Z])/g, (c) => ` ${c.toLowerCase()}`).replace(/^./, (c) => c.toUpperCase());
+const label = fieldLabel;
 export function FieldWidget({ descriptor: d, value: valueProp, onChange, errors, path: pathProp, bare, refOptions, suggestions, fieldKey, prefix, mark, inlinePath, onEditHere, scope, emptyLabel, hint, onBlur, }) {
     const path = pathProp ?? fieldKey;
     // A tags field has no per-chip slot: the first item error shows under the field.

package/dist/admin/forms/list.js

@@ -1,3 +1,6 @@
+// The list widget's logic as pure functions over plain arrays and objects,
+// so it is tested without a DOM. FieldWidget renders; this file decides.
+import { optionsOf } from "../../fields.js";
 /** An empty item: an object of its subfields' defaults, else the default. */
 export function emptyValue(d) {
     if (d.type === "object") {
@@ -9,7 +12,13 @@ export function emptyValue(d) {
         }
         return out;
     }
-    return d.default;
+    if (d.default !== undefined)
+        return d.default;
+    // A required choice shows its first option (FieldWidget renders no blank
+    // one), so it stores it too — a new item never looks set while it is empty.
+    if ((d.type === "select" || d.type === "radio") && d.optional !== true)
+        return optionsOf(d.options)[0]?.value;
+    return undefined;
 }
 export function addItem(items, list) {
     if (typeof list.max === "number" && items.length >= list.max)

package/dist/admin/next/create-admin.d.ts

@@ -2,15 +2,15 @@ import type { ReactNode } from "react";
 import type { ResolvedConfig } from "../../config.ts";
 import type { AdminOpAction } from "../ops.ts";
 import type { AuthConfig } from "../shell/session.ts";
-import type { ContentConfig } from "../../env.ts";
-/** `content` (optional) is the content project's public config for editing presence (spec 2026-09-26
- *  concurrency §5), async because its space is asked of the database; absent or failed, presence
+import type { PresenceConfig } from "../../env.ts";
+/** `presence` (optional) is the content project's public config for editing presence (spec 2026-09-26
+ *  concurrency §5; presence only, never content reads, spec 2026-09-29 content API contract §8), async because its space is asked of the database; absent or failed, presence
  *  is off and everything else works. */
 export declare function createSmoodlyAdmin(input: {
     config: ResolvedConfig;
     op: AdminOpAction;
     auth: () => AuthConfig;
-    content?: () => ContentConfig | Promise<ContentConfig>;
+    presence?: () => PresenceConfig | Promise<PresenceConfig>;
 }): {
     AdminPage: () => null;
     AdminLayout: ({ children }: {

package/dist/admin/next/create-admin.js

@@ -2,8 +2,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { serializeAdminConfig } from "../serialize.js";
 import { AdminApp } from "../shell/AdminApp.js";
 import { AdminStyles } from "../ui/theme.js";
-/** `content` (optional) is the content project's public config for editing presence (spec 2026-09-26
- *  concurrency §5), async because its space is asked of the database; absent or failed, presence
+/** `presence` (optional) is the content project's public config for editing presence (spec 2026-09-26
+ *  concurrency §5; presence only, never content reads, spec 2026-09-29 content API contract §8), async because its space is asked of the database; absent or failed, presence
  *  is off and everything else works. */
 export function createSmoodlyAdmin(input) {
     const registry = serializeAdminConfig(input.config);
@@ -28,14 +28,14 @@ export function createSmoodlyAdmin(input) {
         // Presence is the one thing that needs it: a failed lookup (an unmigrated project, an
         // unreachable database) is logged and turns presence off, so the shell still reaches
         // sign-in, the schema notice or the admin-path ErrorPane.
-        let content;
+        let presenceConfig;
         try {
-            content = await input.content?.();
+            presenceConfig = await input.presence?.();
         }
         catch (e) {
             console.error("smoodly: editing presence is off —", e instanceof Error ? e.message : e);
         }
-        return (_jsxs("div", { className: "sm-admin", suppressHydrationWarning: true, children: [_jsx(AdminStyles, {}), _jsx(AdminApp, { registry: registry, op: input.op, auth: input.auth(), content: content }), children] }));
+        return (_jsxs("div", { className: "sm-admin", suppressHydrationWarning: true, children: [_jsx(AdminStyles, {}), _jsx(AdminApp, { registry: registry, op: input.op, auth: input.auth(), presenceConfig: presenceConfig }), children] }));
     }
     return { AdminPage, AdminLayout };
 }

package/dist/admin/next/index.d.ts

@@ -4,5 +4,5 @@ export type { AdminOpCall, AdminOpAction, AdminOps, OpResult, MembersListResult
 export type { InviteInput, InviteResult, MemberRecord } from "../../member-store.ts";
 export type { MemberRole } from "../../permissions.ts";
 export type { AuthConfig } from "../shell/session.ts";
-export type { ContentConfig } from "../../env.ts";
+export type { PresenceConfig } from "../../env.ts";
 export type { AdminAuth } from "../auth.ts";

package/dist/admin/serialize.d.ts

@@ -34,6 +34,13 @@ export type AdminCollection = {
     depth: number;
     /** `order: "manual"` — the list drags into the `sort` order (spec 2026-09-09 §5). */
     manual: boolean;
+    /** The collection has SEO & Social values (spec 2026-09-29 content API contract §7); each label
+     *  names, in lower case, the field an empty value falls back on — the hints' copy. */
+    seo?: {
+        titleLabel: string;
+        descriptionLabel?: string;
+        imageLabel?: string;
+    };
 };
 export type AdminPageTemplate = {
     name: string;
@@ -45,7 +52,7 @@ export type AdminPageTemplate = {
     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: true` — the SEO & Social tab exists for this template. */
     seo: boolean;
 };
 export type AdminGlobal = {

package/dist/admin/serialize.js

@@ -1,5 +1,7 @@
 import { fixedSlug } from "../page.js";
 import { collectionDepth, collectionOrder } from "../collections.js";
+import { SEO_KEY } from "../seo.js";
+import { fieldLabel } from "./field-label.js";
 import { perLocaleSegments } from "../paths.js";
 import { styleDescriptors } from "../styles.js";
 import { CUSTOM_NODE_TYPE, customFields, defaultRow } from "../custom/index.js";
@@ -32,6 +34,15 @@ export function sectionSettings(config, name) {
 function sectionCss(config, name) {
     return config.css && (config.registry.sections ?? []).find((s) => s.schema.name === name)?.schema.css !== false;
 }
+const lower = (key) => fieldLabel(key).toLowerCase();
+function seoLabels(c) {
+    const named = c.seo === true || c.seo === undefined ? {} : c.seo;
+    return {
+        titleLabel: c.titleField ? lower(c.titleField) : "entry title",
+        ...(named.description ? { descriptionLabel: lower(named.description) } : {}),
+        ...(named.image ? { imageLabel: lower(named.image) } : {}),
+    };
+}
 export function serializeAdminConfig(config) {
     const perLocale = (v) => perLocaleSegments(v, config.locales.supported);
     return {
@@ -62,12 +73,17 @@ export function serializeAdminConfig(config) {
                 sample: e.sample,
             };
         }),
-        collections: (config.registry.collections ?? []).map((c) => ({
-            name: c.name, title: c.title, titleField: c.titleField, fields: serializeMap(c.fields),
-            ...(c.path !== undefined ? { path: perLocale(c.path) } : {}),
-            depth: collectionDepth(c),
-            manual: collectionOrder(c) === "manual",
-        })),
+        collections: (config.registry.collections ?? []).map((c) => {
+            // `$seo` is the SEO panel's, never a form field.
+            const { [SEO_KEY]: _seo, ...fields } = c.fields;
+            return {
+                name: c.name, title: c.title, titleField: c.titleField, fields: serializeMap(fields),
+                ...(c.path !== undefined ? { path: perLocale(c.path) } : {}),
+                depth: collectionDepth(c),
+                manual: collectionOrder(c) === "manual",
+                ...(c.seo !== undefined ? { seo: seoLabels(c) } : {}),
+            };
+        }),
         pages: (config.registry.pages ?? [])
             .filter(({ schema }) => schema.kind === "page")
             .map(({ schema }) => {
@@ -80,7 +96,7 @@ export function serializeAdminConfig(config) {
                 ...(typeof p.slug === "object" && p.slug !== null ? { slugs: { ...p.slug } } : {}),
                 zones: p.zones ?? {},
                 fields: serializeMap(p.fields),
-                seo: p.meta?.seo === true,
+                seo: p.seo === true,
             };
         }),
         globals: (config.registry.globals ?? []).map((s) => ({

package/dist/admin/shell/AdminApp.d.ts

@@ -1,10 +1,10 @@
 import type { AdminOpAction } from "../ops.ts";
 import type { AdminRegistry } from "../serialize.ts";
 import { type AuthConfig } from "./session.ts";
-import type { ContentConfig } from "../../env.ts";
-export declare function AdminApp({ registry, op, auth, content }: {
+import type { PresenceConfig } from "../../env.ts";
+export declare function AdminApp({ registry, op, auth, presenceConfig }: {
     registry: AdminRegistry;
     op: AdminOpAction;
     auth: AuthConfig;
-    content?: ContentConfig;
+    presenceConfig?: PresenceConfig;
 }): import("react").JSX.Element;

package/dist/admin/shell/AdminApp.js

@@ -39,7 +39,7 @@ import { schemaBehind } from "../../schema-version.js";
 import { createPresence, followTokenRefresh } from "./presence.js";
 import { connectRealtime } from "./presence-realtime.js";
 import { PresenceProvider } from "./presence-context.js";
-export function AdminApp({ registry, op, auth, content }) {
+export function AdminApp({ registry, op, auth, presenceConfig }) {
     const session = useAdminSession(auth);
     const [ops] = useState(() => makeClientOps(op, session.token));
     const route = useRoute(registry.adminPath);
@@ -89,7 +89,7 @@ export function AdminApp({ registry, op, auth, content }) {
     const tokenRef = useRef(session.token);
     tokenRef.current = session.token;
     const authClient = session.client;
-    const contentUrl = content?.url, contentKey = content?.key, contentSpace = content?.spaceId;
+    const contentUrl = presenceConfig?.url, contentKey = presenceConfig?.key, contentSpace = presenceConfig?.spaceId;
     useEffect(() => {
         if (!signedIn || !contentUrl || !contentKey || !contentSpace || !email) {
             setPresence(null);

package/dist/admin/shell/EntryForm.js

@@ -34,7 +34,7 @@ import { ResizeHandle } from "../ui/ResizeHandle.js";
 import { entrySourceLocale, entryTitle, localizedFieldKeys } from "./entries-list.js";
 import { useAdminHref } from "./base.js";
 import { localeFromUrl, writeLocaleToUrl } from "../editor/locale-url.js";
-import { navigate, useLeaveGuard } from "./router.js";
+import { navigate, useUnloadGuard } from "./router.js";
 import { LIVE_URL_CONFIRM, LIVE_URL_OPTION, liveUrlChanges } from "./live-url.js";
 import { confirm, confirmWithOption, DISCARD_CONFIRM } from "../ui/confirm.js";
 import { draftToken } from "../../draft-token.js";
@@ -49,6 +49,8 @@ import { usePresence, usePresenceState, useSavedElsewhere, useTrackPresence } fr
 import { editorsOf } from "./presence.js";
 import { PresenceLine } from "../ui/PresenceLine.js";
 import { slugHint, tidySlug, withFollowingSlug } from "../forms/slug-field.js";
+import { SeoSettings } from "../editor/SeoSettings.js";
+import { SEO_KEY } from "../../seo.js";
 /** A stable empty map for the hooks that run before the "no such collection" return. */
 const NO_FIELDS = {};
 /** True while the entry's slug box has focus: its field wrapper carries the path. */
@@ -139,6 +141,7 @@ export function EntryForm({ ops, registry, collection, id }) {
             const r = await ops.entries.save(collection, id, locale, value, token(), { redirect: redirectRef.current });
             if (r.ok) {
                 redirectRef.current = true;
+                recordRef.current = r.data;
                 setRecord(r.data);
                 setSaveErrors({});
                 presence?.announce(target, r.data.locales[locale]?.draftSavedAt ?? null);
@@ -155,7 +158,7 @@ export function EntryForm({ ops, registry, collection, id }) {
             setDirty(false); },
     });
     // Reload and close ask only while a save is pending or in flight.
-    useLeaveGuard(dirty || saveState !== "saved");
+    useUnloadGuard(dirty || saveState !== "saved");
     const refTargets = useMemo(() => {
         const out = {};
         for (const [key, d] of Object.entries(meta?.fields ?? {})) {
@@ -477,5 +480,10 @@ export function EntryForm({ ops, registry, collection, id }) {
                                             setDirty(true);
                                             setTouched(true);
                                             mark();
-                                        } })] })) : !notice && _jsx("p", { style: { color: "var(--text-muted)" }, children: "Loading\u2026" })] }), _jsx(ResizeHandle, {}), _jsxs("aside", { className: "sm-inspector", children: [record && row && (_jsxs("div", { className: "sm-card", children: [_jsx(SectionLabel, { children: "Document info" }), _jsx(InfoRow, { label: "Created", value: relativeTime(record.createdAt) }), _jsx(InfoRow, { label: "Updated", value: updatedLine(row.updatedAt, row.updatedBy) }), (redirects[locale] ?? []).length > 0 && _jsx(InfoRow, { label: "Redirects from", value: redirects[locale].join(", "), mono: true }), multilingual && _jsx(InfoRow, { label: "Languages", value: Object.keys(record.locales).join(", ") }), _jsx(InfoRow, { label: "ID", value: id, mono: true })] })), record && (_jsxs("div", { className: "sm-card", children: [multilingual && row && Object.keys(record.locales).length > 1 && (_jsxs(Button, { variant: "secondary", onClick: () => void doRemoveLocale(), children: ["Remove from ", locale] })), _jsx(Button, { variant: "danger", onClick: destroy, children: "Delete" })] }))] })] })] }));
+                                        } })] })) : !notice && _jsx("p", { style: { color: "var(--text-muted)" }, children: "Loading\u2026" })] }), _jsx(ResizeHandle, {}), _jsxs("aside", { className: "sm-inspector", children: [record && row && (_jsxs("div", { className: "sm-card", children: [_jsx(SectionLabel, { children: "Document info" }), _jsx(InfoRow, { label: "Created", value: relativeTime(record.createdAt) }), _jsx(InfoRow, { label: "Updated", value: updatedLine(row.updatedAt, row.updatedBy) }), (redirects[locale] ?? []).length > 0 && _jsx(InfoRow, { label: "Redirects from", value: redirects[locale].join(", "), mono: true }), multilingual && _jsx(InfoRow, { label: "Languages", value: Object.keys(record.locales).join(", ") }), _jsx(InfoRow, { label: "ID", value: id, mono: true })] })), record && row && meta.seo && (_jsxs("div", { className: "sm-card", children: [_jsx(SectionLabel, { children: "SEO & Social" }), _jsx(SeoSettings, { meta: fields?.[SEO_KEY] ?? {}, titleHint: `Empty: the ${meta.seo.titleLabel}.`, descriptionHint: meta.seo.descriptionLabel ? `Empty: the ${meta.seo.descriptionLabel}.` : undefined, imageHint: meta.seo.imageLabel ? `Empty: the ${meta.seo.imageLabel}.` : undefined, onPatch: (key, value) => {
+                                            setFields((f) => ({ ...(f ?? {}), [SEO_KEY]: { ...(f?.[SEO_KEY] ?? {}), [key]: value } }));
+                                            setDirty(true);
+                                            setTouched(true);
+                                            mark();
+                                        } })] })), record && (_jsxs("div", { className: "sm-card", children: [multilingual && row && Object.keys(record.locales).length > 1 && (_jsxs(Button, { variant: "secondary", onClick: () => void doRemoveLocale(), children: ["Remove from ", locale] })), _jsx(Button, { variant: "danger", onClick: destroy, children: "Delete" })] }))] })] })] }));
 }

package/dist/admin/shell/GlobalForm.js

@@ -29,7 +29,7 @@ import { ResizeHandle } from "../ui/ResizeHandle.js";
 import { useAdminHref } from "./base.js";
 import { GlobalFields } from "./GlobalFields.js";
 import { localeFromUrl, writeLocaleToUrl } from "../editor/locale-url.js";
-import { useLeaveGuard } from "./router.js";
+import { useUnloadGuard } from "./router.js";
 import { confirm, DISCARD_CONFIRM } from "../ui/confirm.js";
 import { draftToken } from "../../draft-token.js";
 import { isStale, staleInfoOf } from "./stale.js";
@@ -78,6 +78,7 @@ export function GlobalForm({ ops, registry, name }) {
         persist: async (value) => {
             const r = await ops.globals.save(name, locale, value, token());
             if (r.ok) {
+                recordRef.current = r.data;
                 setRecord(r.data);
                 presence?.announce(target, r.data.locales[locale]?.draftSavedAt ?? null);
             }
@@ -87,7 +88,7 @@ export function GlobalForm({ ops, registry, name }) {
         },
         onSaved: () => setDirty(false),
     });
-    useLeaveGuard(dirty || saveState !== "saved");
+    useUnloadGuard(dirty || saveState !== "saved");
     const refTargets = useMemo(() => {
         const out = {};
         for (const [key, d] of Object.entries(item?.fields ?? {})) {

package/dist/admin/shell/presence-realtime.d.ts

@@ -1,3 +1,3 @@
-import type { ContentConfig } from "../../env.ts";
+import type { PresenceConfig } from "../../env.ts";
 import type { PresenceChannel } from "./presence.ts";
-export declare function connectRealtime(config: ContentConfig, email: string, token: string): PresenceChannel;
+export declare function connectRealtime(config: PresenceConfig, email: string, token: string): PresenceChannel;

package/dist/admin/shell/router.d.ts

@@ -39,3 +39,8 @@ export declare function useRoute(base: string): Route;
 /** Register the calling view as dirty: navigate() asks before leaving,
  *  and beforeunload covers reload, closing the tab and a real link out. */
 export declare function useLeaveGuard(dirty: boolean): void;
+/** The tab-close half of useLeaveGuard alone, for a view that saves on
+ *  unmount (the page editor, spec 2026-09-29 pre-install fixes §4): an
+ *  in-app navigation loses nothing, so only reload, closing the tab and a
+ *  real link out ask, while a change or a save is pending. */
+export declare function useUnloadGuard(pending: boolean): void;

package/dist/admin/shell/router.js

@@ -94,3 +94,16 @@ export function useLeaveGuard(dirty) {
         return () => { guards.delete(guard); window.removeEventListener("beforeunload", onBeforeUnload); };
     }, [dirty]);
 }
+/** The tab-close half of useLeaveGuard alone, for a view that saves on
+ *  unmount (the page editor, spec 2026-09-29 pre-install fixes §4): an
+ *  in-app navigation loses nothing, so only reload, closing the tab and a
+ *  real link out ask, while a change or a save is pending. */
+export function useUnloadGuard(pending) {
+    useEffect(() => {
+        if (!pending)
+            return;
+        const onBeforeUnload = (e) => { e.preventDefault(); e.returnValue = ""; };
+        window.addEventListener("beforeunload", onBeforeUnload);
+        return () => window.removeEventListener("beforeunload", onBeforeUnload);
+    }, [pending]);
+}

package/dist/cli/space-io.js

@@ -47,7 +47,7 @@ export async function readSchemaVersion(db) {
 }
 export function schemaRefusal(missing, command) {
     return missing === "key"
-        ? `${command} needs SMOODLY_SECRET_KEY — the service-role key, or the cloud's write key. The publishable key sees published content only.`
+        ? `${command} needs SMOODLY_SECRET_KEY — the service-role key, or the cloud's write key. The publishable key reads no content.`
         : "This database has no Smoodly schema. Run `npx smoodly migrate`, then `supabase db push` (hosted) or `supabase db reset` (local).";
 }
 /** Every row of one table in one space, paged in primary-key order. The space filter is explicit: a service-role key sees every space. */

package/dist/collections.d.ts

@@ -1,5 +1,6 @@
 import type { Descriptor } from "./fields.ts";
 import type { BuilderMap, NamespaceValues } from "./schema.ts";
+import { type CollectionSeo } from "./seo.ts";
 /** How a collection is ordered — in the admin list and in public reads
  *  alike (spec 2026-09-05 §3). "manual" is the drag order (`sort`). */
 export type EntryOrder = "manual" | {
@@ -29,6 +30,8 @@ export type CollectionSchema<F extends BuilderMap = BuilderMap, N extends string
     admin?: {
         listColumns?: string[];
     };
+    /** Entries carry SEO & Social values (spec 2026-09-29 content API contract §7): stored under `$seo`, empty values falling back on `titleField` and the named fields. */
+    seo?: CollectionSeo;
     /** phantom: the entry value shape, used by f.ref target inference */
     readonly __entry?: NamespaceValues<F>;
 };
@@ -47,4 +50,5 @@ export declare function collection<F extends BuilderMap, const N extends string
     admin?: {
         listColumns?: string[];
     };
+    seo?: CollectionSeo;
 }): CollectionSchema<F, N>;

package/dist/collections.js

@@ -1,3 +1,4 @@
+import { SEO_DESCRIPTOR, SEO_KEY, validateCollectionSeo } from "./seo.js";
 export const DEFAULT_ORDER = { by: "createdAt", direction: "desc" };
 export const BUILT_IN_ORDER_FIELDS = ["createdAt", "updatedAt"];
 export const collectionOrder = (c) => c.order ?? DEFAULT_ORDER;
@@ -7,6 +8,9 @@ export function collection(input) {
         throw new Error("smoodly: a collection requires a name.");
     if (["global", "asset", "media"].includes(input.name))
         throw new Error(`smoodly: "${input.name}" is a reserved name.`);
+    if (Object.prototype.hasOwnProperty.call(input.fields, SEO_KEY)) {
+        throw new Error(`smoodly: collection "${input.name}": "${SEO_KEY}" is a reserved key.`);
+    }
     if (input.tree !== undefined && (!Number.isInteger(input.tree.depth) || input.tree.depth < 1)) {
         throw new Error(`smoodly: collection "${input.name}" declares an invalid tree depth.`);
     }
@@ -49,12 +53,16 @@ export function collection(input) {
             throw new Error(`smoodly: collection "${input.name}" slug field "${key}" follows an unknown field "${from}".`);
         }
     }
+    const fields = Object.fromEntries(Object.entries(input.fields).map(([k, b]) => [k, b.descriptor]));
+    if (input.seo !== undefined)
+        validateCollectionSeo(input.name, input.seo, fields);
     return {
         kind: "collection",
         name: input.name,
         title: input.title,
         titleField: input.titleField,
-        fields: Object.fromEntries(Object.entries(input.fields).map(([k, b]) => [k, b.descriptor])),
+        fields: input.seo !== undefined ? { ...fields, [SEO_KEY]: SEO_DESCRIPTOR } : fields,
+        ...(input.seo !== undefined ? { seo: input.seo } : {}),
         ...(input.path !== undefined ? { path: input.path } : {}),
         ...(input.tree !== undefined ? { tree: input.tree } : {}),
         ...(input.order !== undefined ? { order: input.order } : {}),