smoodly 0.0.35 → 0.0.37

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/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/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/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

@@ -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. */
@@ -478,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/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/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 } : {}),

package/dist/entry-page.d.ts

@@ -1,21 +1,23 @@
 import type { ComponentType, ReactElement } from "react";
 import type { CollectionSchema } from "./collections.ts";
-import type { EntryRecord } from "./entry-store.ts";
-import type { LocaleAlternate } from "./paths.ts";
+import type { EntryItem } from "./read-shapes.ts";
+import type { Materialize } from "./schema.ts";
 export type EntryPageSchema = {
     kind: "entryPage";
     name: string;
     collection: string;
 };
-/** What an entry page renders: the entry in the render locale, its path
- *  there, and its address in every supported locale (spec 2026-09-15 §1). */
-export type EntryPageProps = {
-    entry: EntryRecord;
-    path: string;
-    locale: string;
-    locales: Record<string, LocaleAlternate | null>;
+/** What an entry page renders: the entry as a read returns it — its path, locale and
+ *  locale alternates ride on it (spec 2026-09-29 content API contract §3). */
+export type EntryPageProps<F = Record<string, unknown>> = {
+    entry: EntryItem<F>;
 };
 export type PairedEntryPage = ((props: EntryPageProps) => ReactElement) & {
     schema: EntryPageSchema;
 };
-export declare function entryPage(collection: CollectionSchema<any>, View: ComponentType<EntryPageProps>): PairedEntryPage;
+/** The collection's fields as a read returns them. */
+type Materialized<C extends CollectionSchema<any>> = {
+    [K in keyof NonNullable<C["__entry"]>]: Materialize<NonNullable<C["__entry"]>[K]>;
+};
+export declare function entryPage<C extends CollectionSchema<any>>(collection: C, View: ComponentType<EntryPageProps<Materialized<C>>>): PairedEntryPage;
+export {};

package/dist/entry-store.d.ts

@@ -81,6 +81,22 @@ export type ListOptions = {
      */
     parent?: string | null;
 };
+export type SnapshotQuery = {
+    locale: string;
+    /** true: the live row (the editor preview); false: the published snapshot. */
+    draft: boolean;
+    where?: Where;
+    order?: EntryOrder;
+    limit?: number;
+    parent?: string | null;
+    /** Only these entries (getEntry by id). */
+    ids?: string[];
+};
+/** `fields` is the merged snapshot (shared, localized, `slug`) of the version shown; `record` never leaves the site layer. */
+export type SnapshotRow = {
+    record: EntryRecord;
+    fields: Record<string, unknown>;
+};
 export type CreateEntryOptions = {
     locale: string;
     parentId?: string | null;
@@ -102,6 +118,11 @@ export interface EntryStore {
     create(collection: string, fields: Record<string, unknown>, options: CreateEntryOptions, by?: string): Promise<EntryRecord>;
     get(collection: string, id: string): Promise<EntryRecord | null>;
     list(collection: string, options?: ListOptions): Promise<EntryRecord[]>;
+    /** Filters, orders and limits over the version SHOWN: the published snapshot (a row
+     *  without one falls back to the live merge), or the live row when `draft` (spec
+     *  2026-09-29 content API contract §5). Only rows present in `locale`; the published
+     *  path also needs the row published. */
+    query(collection: string, q: SnapshotQuery): Promise<SnapshotRow[]>;
     /** Every entry row, registered collection or not, with each published locale's live fields (spec 2026-09-27 editor safety §3). */
     scanEntries(): Promise<EntryScan[]>;
     /** Batched read for the resolver: the MERGED fields in `locale`, keyed
@@ -168,6 +189,8 @@ export interface EntryStore {
     }[]>;
     resolvePath(locale: string, path: string): Promise<PathHit | null>;
     pathsOf(collection: string, id: string): Promise<Record<string, string>>;
+    /** id → full live path in `locale` for many entries of one collection; ids without one are absent. */
+    pathsIn(collection: string, ids: string[], locale: string): Promise<Record<string, string>>;
     /** locale → this entry's old addresses. */
     redirectsOf(collection: string, id: string): Promise<Record<string, string[]>>;
 }
@@ -235,10 +258,14 @@ export declare function entryTitleIn(record: EntryRecord, locale: string, schema
  * the creation tiebreak follows `direction` for non-manual orders.
  * Declared fields compare numerically when both values are numbers,
  * otherwise as strings via `localeCompare` — the same order Postgres
- * gives the jsonb VALUE (`fields->x`) for one type; see the README's
+ * gives the jsonb VALUE (`fields->x`) for one type; see MAINTAINERS.md's
  * follow-ups for the mixed-type and JSON-null edges.
  */
 export declare function compareEntries(order: EntryOrder, seq: (e: EntryRecord) => number): (a: EntryRecord, b: EntryRecord) => number;
+/** Comparator for `query`: like compareEntries, but a declared field reads the
+ *  merged snapshot, `updatedAt` the locale row's, and an absent, null or empty-string value
+ *  sorts last in both directions; ties break by creation order (ascending). */
+export declare function compareSnapshots(order: EntryOrder, locale: string, seq: (id: string) => number): (a: SnapshotRow, b: SnapshotRow) => number;
 export declare class MemoryEntryStore implements EntryStore {
     private refs;
     private entries;
@@ -287,6 +314,7 @@ export declare class MemoryEntryStore implements EntryStore {
     create(collection: string, fields: Record<string, unknown>, options: CreateEntryOptions, by?: string): Promise<EntryRecord>;
     get(collection: string, id: string): Promise<EntryRecord | null>;
     list(collection: string, options?: ListOptions): Promise<EntryRecord[]>;
+    query(collection: string, q: SnapshotQuery): Promise<SnapshotRow[]>;
     getMany(collection: string, ids: string[], locale: string, options?: {
         status?: "published";
     }): Promise<Record<string, Record<string, unknown>>>;
@@ -315,6 +343,7 @@ export declare class MemoryEntryStore implements EntryStore {
         sourceId: string;
     }[]>;
     resolvePath(locale: string, path: string): Promise<PathHit | null>;
+    pathsIn(collection: string, ids: string[], locale: string): Promise<Record<string, string>>;
     pathsOf(collection: string, id: string): Promise<{}>;
     redirectsOf(collection: string, id: string): Promise<Record<string, string[]>>;
 }

package/dist/entry-store.js

@@ -150,7 +150,7 @@ export function entryTitleIn(record, locale, schema) {
  * the creation tiebreak follows `direction` for non-manual orders.
  * Declared fields compare numerically when both values are numbers,
  * otherwise as strings via `localeCompare` — the same order Postgres
- * gives the jsonb VALUE (`fields->x`) for one type; see the README's
+ * gives the jsonb VALUE (`fields->x`) for one type; see MAINTAINERS.md's
  * follow-ups for the mixed-type and JSON-null edges.
  */
 export function compareEntries(order, seq) {
@@ -172,6 +172,32 @@ export function compareEntries(order, seq) {
         return d !== 0 ? d * dir : (seq(a) - seq(b)) * dir;
     };
 }
+/** Comparator for `query`: like compareEntries, but a declared field reads the
+ *  merged snapshot, `updatedAt` the locale row's, and an absent, null or empty-string value
+ *  sorts last in both directions; ties break by creation order (ascending). */
+export function compareSnapshots(order, locale, seq) {
+    return (a, b) => {
+        if (order === "manual") {
+            const d = (a.record.sort ?? Infinity) - (b.record.sort ?? Infinity);
+            return d !== 0 ? d : seq(a.record.id) - seq(b.record.id);
+        }
+        const dir = order.direction === "asc" ? 1 : -1;
+        const value = (r) => order.by === "createdAt" ? r.record.createdAt : order.by === "updatedAt" ? r.record.locales[locale]?.updatedAt : r.fields[order.by];
+        const empty = (v) => (v === "" ? undefined : v); // a cleared text or date is empty too
+        const va = empty(value(a)), vb = empty(value(b));
+        const tie = seq(a.record.id) - seq(b.record.id);
+        if (order.by === "createdAt")
+            return tie * dir; // the clock can tie within a millisecond; creation order cannot
+        if (va == null && vb == null)
+            return tie;
+        if (va == null)
+            return 1;
+        if (vb == null)
+            return -1;
+        const d = typeof va === "number" && typeof vb === "number" ? va - vb : String(va).localeCompare(String(vb));
+        return d !== 0 ? d * dir : tie;
+    };
+}
 export class MemoryEntryStore {
     constructor(collections, 
     // pass the SAME index to MemoryPageStore so cross-kind questions work
@@ -389,6 +415,29 @@ export class MemoryEntryStore {
             rows = rows.slice(0, options.limit);
         return rows.map((e) => this.snapshot(e));
     }
+    async query(collection, q) {
+        const schema = this.schema(collection);
+        const wanted = q.ids ? new Set(q.ids) : null;
+        const rows = [];
+        for (const e of this.entries.values()) {
+            if (e.collection !== collection)
+                continue;
+            if (wanted && !wanted.has(e.id))
+                continue;
+            if (q.parent !== undefined && e.parentId !== q.parent)
+                continue;
+            const row = e.locales[q.locale];
+            if (!row || (!q.draft && row.status !== "published"))
+                continue;
+            const snapshot = !q.draft && row.publishedVersionId ? this.versions.get(row.publishedVersionId) : undefined;
+            const fields = snapshot ? structuredClone(snapshot.fields) : entryFieldsIn(e, q.locale);
+            if (q.where && !matchesWhere(fields, q.where))
+                continue;
+            rows.push({ record: this.snapshot(e), fields });
+        }
+        rows.sort(compareSnapshots(q.order ?? collectionOrder(schema), q.locale, (id) => this.order.get(id)));
+        return typeof q.limit === "number" ? rows.slice(0, q.limit) : rows;
+    }
     async getMany(collection, ids, locale, options) {
         this.schema(collection);
         const out = {};
@@ -644,6 +693,10 @@ export class MemoryEntryStore {
     resolvePath(locale, path) {
         return this.paths.resolve(locale, path);
     }
+    pathsIn(collection, ids, locale) {
+        this.schema(collection);
+        return this.paths.livePathsIn("entry", ids, locale);
+    }
     pathsOf(collection, id) {
         return this.row(collection, id) ? this.paths.pathsOf({ kind: "entry", id }) : Promise.resolve({});
     }

package/dist/env.d.ts

@@ -4,7 +4,7 @@ export type SmoodlyEnv = {
     url: string;
     /** Server-only: the service-role key (self-host) or the environment's write key (cloud). */
     secretKey: string;
-    /** What a browser may hold for the content project: anon/publishable key, or the read key. */
+    /** What a browser may hold for the content project: anon/publishable key, or the cloud's per-environment key. It reads no content (sign-in and presence only). */
     publishableKey: string;
     /** Where editors sign in. Defaults to `url`. */
     authUrl: string;
@@ -15,12 +15,12 @@ export declare function resolveSmoodlyEnv(env: Record<string, string | undefined
 /** `resolveSmoodlyEnv(process.env)` — call lazily, never at module load,
  *  so `next build` without env still succeeds. */
 export declare const smoodlyEnv: () => SmoodlyEnv;
-/** What the browser needs to join the content project's presence channel (spec 2026-09-26 concurrency §5): public values only. */
-export type ContentConfig = {
+/** What the browser needs to join the admin's presence channel: the content project's URL, publishable key and space, public values only — never for content reads (spec 2026-09-29 content API contract §8). */
+export type PresenceConfig = {
     url: string;
     key: string;
     spaceId: string;
 };
-/** The public config, with the space the database says the secret key acts in —
+/** The presence config, with the space the database says the secret key acts in —
  *  asked, never read out of the key, so it cannot disagree with where rows land. */
-export declare function publicContentConfig(env: SmoodlyEnv, db?: Parameters<typeof readCurrentSpace>[0]): Promise<ContentConfig>;
+export declare function presenceConfig(env: SmoodlyEnv, db?: Parameters<typeof readCurrentSpace>[0]): Promise<PresenceConfig>;

package/dist/env.js

@@ -25,9 +25,9 @@ export const smoodlyEnv = () => resolveSmoodlyEnv(process.env);
 /** One lookup per process per content project and key: the space never
  *  changes for a key. A failed lookup is not cached, so the next call retries. */
 const spaces = new Map();
-/** The public config, with the space the database says the secret key acts in —
+/** The presence config, with the space the database says the secret key acts in —
  *  asked, never read out of the key, so it cannot disagree with where rows land. */
-export function publicContentConfig(env, db) {
+export function presenceConfig(env, db) {
     const cacheKey = `${env.url}\n${env.secretKey}`;
     let space = spaces.get(cacheKey);
     if (!space) {