smoodly 0.0.16 → 0.0.18

package/dist/render.js

@@ -1,11 +1,15 @@
 import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import { EMPTY_ATTR, ZONE_ATTR } from "./marks.js";
+import { SMD_KEY } from "./section-wrapper.js";
+import { DEFAULT_STYLE_VALUES } from "./styles.js";
+import { CUSTOM_NODE_TYPE, createCustomSection } from "./custom/index.js";
 /** The `page` prop of a view rendered outside the site (a test, a preview
  *  of a shape): a real object, so a view never guards an optional prop, but
  *  no position in the tree. Frozen: one singleton shared by every such
  *  render, so a view that pushed onto it would leak into the next. */
 export const EMPTY_PAGE_CONTEXT = Object.freeze({
-    id: "", title: "", path: "/", url: "/", fields: Object.freeze({}), ancestors: Object.freeze([]), children: Object.freeze([]),
+    id: "", title: "", path: "/", url: "/", locale: "", fields: Object.freeze({}), ancestors: Object.freeze([]), children: Object.freeze([]),
+    locales: Object.freeze({}),
 });
 export function Zone({ of: content }) {
     // A malformed tree (bad data, a client that skipped isPageTree) must not
@@ -22,10 +26,9 @@ export function Zone({ of: content }) {
                 console.warn(`smoodly: no registered component for node type "${node.type}" — skipping.`);
                 return null;
             }
-            const styles = content.editor
-                ? { ...(node.styles ?? {}), __smoodlyNode: node.id }
-                : (node.styles ?? {});
-            return _jsx(Component, { ...node.fields, styles: styles }, node.id);
+            // The node id, the css and the values ride the styles under one reserved key; the wrapper reads and strips it.
+            const styles = { ...(node.styles ?? {}), [SMD_KEY]: { node: node.id, css: typeof node.css === "string" ? node.css : undefined, values: content.styleValues } };
+            return _jsx(Component, { ...node.fields, settings: node.settings ?? {}, styles: styles }, node.id);
         }) }));
 }
 export function page(schema, View) {
@@ -41,9 +44,12 @@ export function renderPage(Page, tree, registry, options) {
     for (const c of [...(registry.sections ?? []), ...(registry.elements ?? [])]) {
         components.set(c.schema.name, c);
     }
+    // The custom section (spec 2026-09-14 §6): Smoodly's own renderer under the reserved node type.
+    components.set(CUSTOM_NODE_TYPE, createCustomSection({ ...(registry.custom ?? {}), elements: (registry.elements ?? []) }));
+    const styleValues = registry.styles ?? DEFAULT_STYLE_VALUES;
     const zones = Object.fromEntries(Object.keys(Page.schema.zones).map((zone) => [
         zone,
-        { name: zone, nodes: tree.zones?.[zone] ?? [], components, editor: options?.editor ?? false },
+        { name: zone, nodes: tree.zones?.[zone] ?? [], components, styleValues, editor: options?.editor ?? false },
     ]));
     return _jsx(Page, { zones: zones, page: (options?.page ?? EMPTY_PAGE_CONTEXT) });
 }

package/dist/resolve.d.ts

@@ -1,18 +1,19 @@
 import type { Descriptor } from "./fields.ts";
 import type { CollectionSchema } from "./collections.ts";
 import type { PageTree } from "./render.tsx";
-import { type SharedSchema } from "./shared.ts";
+import { type GlobalSchema } from "./global.ts";
 import { type AssetRecord } from "./media.ts";
 import { type ElementSchemas } from "./richtext-walk.ts";
 import type { SectionLike } from "./refs.ts";
+import type { Toolset } from "./toolset.ts";
 export type EntryFetcher = (collection: string, ids: string[]) => Promise<Record<string, Record<string, unknown>>>;
 export type AssetFetcher = (ids: string[]) => Promise<Record<string, AssetRecord>>;
 type SchemaLike = {
     name: string;
     fields: Record<string, Descriptor>;
-    styles?: Record<string, Descriptor>;
+    settings?: Record<string, Descriptor>;
 };
-/** One value set whose media resolves in place: a node's fields or styles,
+/** One value set whose media resolves in place: a node's fields or settings,
  *  an entry's fields, or an entry hydrated through a ref. */
 export type MediaSet = {
     values: Record<string, unknown> | undefined;
@@ -26,8 +27,8 @@ type ResolveOptions = {
     fetch: EntryFetcher;
     /** Media (spec 2026-09-08 §9): one batched asset fetch per page, values become resolved objects. */
     assets?: AssetFetcher;
-    /** The registered shared items a placement node may name (spec 2026-09-07 §4). */
-    shared?: SharedSchema[];
+    /** The registered global items a placement node may name (spec 2026-09-07 §4). */
+    globals?: GlobalSchema[];
     /** Registered Elements a richtext document may embed (spec 2026-09-08 block nodes §2). */
     elements?: SectionLike[];
     /** Optional safety valve on chain length; unlimited by default. */
@@ -36,9 +37,13 @@ type ResolveOptions = {
     page?: {
         fields: Record<string, Descriptor>;
     };
+    /** The custom section's columns toolset (spec 2026-09-14 §6); the default when absent. The schema is always in the map. */
+    custom?: {
+        toolset?: Toolset;
+    };
 };
 export declare function resolveTree(tree: PageTree, options: ResolveOptions): Promise<PageTree>;
-/** One value set's media, resolved in place. Exported for the site layer's shared-item styles. */
+/** One value set's media, resolved in place. Exported for the site layer's global-item settings. */
 export declare function resolveMedia(values: Record<string, unknown>, descriptors: Record<string, Descriptor>, fetch: AssetFetcher, elements?: ElementSchemas): Promise<void>;
 /** Many value sets, one asset round (plus one for posters): the tree's
  *  nodes and every entry hydrated through a ref, or a list page's items.

package/dist/resolve.js

@@ -6,9 +6,10 @@
 // Cycles are cut per path — a ref back to an entry already on its own
 // chain gets a shallow copy (refs as ids), so traversal terminates by
 // construction and the output stays JSON-serializable.
-import { sharedLink, SHARED_NODE_TYPE, STYLES_KEY } from "./shared.js";
+import { globalLink, GLOBAL_NODE_TYPE, SETTINGS_KEY, STYLES_KEY, CSS_KEY } from "./global.js";
 import { applyAssets, collectAssetIds } from "./media.js";
 import { elementSchemas } from "./richtext-walk.js";
+import { CUSTOM_NODE_TYPE, customSchema, customToolset } from "./custom/index.js";
 /** The built-in SEO set's one media value (spec 2026-09-10 page fields §2). */
 const META_DESCRIPTORS = { ogImage: { type: "image" } };
 function targetOf(d) {
@@ -31,8 +32,10 @@ export async function resolveTree(tree, options) {
         const schema = "schema" in s ? s.schema : s;
         return [schema.name, schema];
     }));
+    // The custom section (spec 2026-09-14 §6): its columns' images resolve like any section's richtext.
+    sectionSchemas.set(CUSTOM_NODE_TYPE, customSchema(customToolset(options.custom?.toolset)));
     const resolved = structuredClone(tree);
-    await rewritePlacements(resolved, options.shared ?? [], options.fetch);
+    await rewritePlacements(resolved, options.globals ?? [], options.fetch);
     const tasks = [];
     for (const nodes of Object.values(resolved.zones ?? {})) {
         for (const node of nodes) {
@@ -52,7 +55,7 @@ export async function resolveTree(tree, options) {
             if (!schema)
                 continue;
             sets.push({ values: node.fields, descriptors: schema.fields });
-            sets.push({ values: node.styles, descriptors: schema.styles ?? {} });
+            sets.push({ values: node.settings, descriptors: schema.settings ?? {} });
         }
         if (options.page && resolved.fields)
             sets.push({ values: resolved.fields, descriptors: options.page.fields });
@@ -78,7 +81,7 @@ async function fetchAssets(fetch, ids) {
             out.set(id, a);
     return out;
 }
-/** One value set's media, resolved in place. Exported for the site layer's shared-item styles. */
+/** One value set's media, resolved in place. Exported for the site layer's global-item settings. */
 export async function resolveMedia(values, descriptors, fetch, elements = {}) {
     await resolveMediaSets([{ values, descriptors }], fetch, elements);
 }
@@ -99,12 +102,12 @@ export async function resolveMediaSets(sets, fetch, elements = {}) {
  *  site cannot render: an unpublished or dangling row, an object item
  *  (no view), an unknown item. The normal pass then hydrates the
  *  rewritten nodes' own refs. */
-async function rewritePlacements(tree, shared, fetch) {
-    const byName = new Map(shared.map((s) => [s.name, s]));
+async function rewritePlacements(tree, globals, fetch) {
+    const byName = new Map(globals.map((s) => [s.name, s]));
     const wanted = new Map();
     for (const nodes of Object.values(tree.zones ?? {})) {
         for (const node of nodes) {
-            const link = sharedLink(node);
+            const link = globalLink(node);
             if (!link || !byName.get(link.item)?.section)
                 continue;
             const ids = wanted.get(link.item) ?? new Set();
@@ -116,16 +119,23 @@ async function rewritePlacements(tree, shared, fetch) {
     await Promise.all([...wanted].map(async ([item, ids]) => fetched.set(item, await fetch(item, [...ids]))));
     for (const [zone, nodes] of Object.entries(tree.zones ?? {})) {
         tree.zones[zone] = nodes.flatMap((node) => {
-            const link = sharedLink(node);
+            const link = globalLink(node);
             if (!link)
-                return node.type === SHARED_NODE_TYPE ? [] : [node];
+                return node.type === GLOBAL_NODE_TYPE ? [] : [node];
             const schema = byName.get(link.item);
             const row = fetched.get(link.item)?.[link.ref];
             if (!schema?.section || !row)
                 return [];
-            const { [STYLES_KEY]: styles, ...fields } = structuredClone(row);
-            const isObject = styles !== null && typeof styles === "object";
-            return [{ id: node.id, type: schema.section, fields, ...(isObject ? { styles: styles } : {}) }];
+            // The row's reserved keys become the node's namespaces (spec 2026-09-14 §8): the
+            // rewritten node is then a section node like any other, styles inline and css scoped.
+            const { [SETTINGS_KEY]: settings, [STYLES_KEY]: styles, [CSS_KEY]: css, ...fields } = structuredClone(row);
+            const ns = (v) => (v !== null && typeof v === "object" ? v : undefined);
+            return [{
+                    id: node.id, type: schema.section, fields,
+                    ...(ns(settings) ? { settings: ns(settings) } : {}),
+                    ...(ns(styles) ? { styles: ns(styles) } : {}),
+                    ...(typeof css === "string" && css !== "" ? { css } : {}),
+                }];
         });
     }
 }

package/dist/revalidate.d.ts

@@ -8,10 +8,10 @@ export type AffectedTargets = {
 };
 export declare const pageTag: (id: string) => string;
 export declare const entryTag: (id: string) => string;
-/** A shared item's cache unit, by NAME (a singleton has one row per
- *  locale, and code owns the name): the Next glue's getSmoodlyShared
- *  caches under it; ops.shared expires it. */
-export declare const sharedTag: (name: string) => string;
+/** A global item's cache unit, by NAME (a singleton has one row per
+ *  locale, and code owns the name): the Next glue's getSmoodlyGlobal
+ *  caches under it; ops.globals expires it. */
+export declare const globalTag: (name: string) => string;
 /** The page-tree listing's cache unit (spec 2026-09-11 §2): one tree-wide
  *  tag, fired by every page op that changes what the listing shows. */
 export declare const pagesTreeTag: () => string;

package/dist/revalidate.js

@@ -7,10 +7,10 @@
 // change (spec 2026-09-05 §5).
 export const pageTag = (id) => `page:${id}`;
 export const entryTag = (id) => `entry:${id}`;
-/** A shared item's cache unit, by NAME (a singleton has one row per
- *  locale, and code owns the name): the Next glue's getSmoodlyShared
- *  caches under it; ops.shared expires it. */
-export const sharedTag = (name) => `shared:${name}`;
+/** A global item's cache unit, by NAME (a singleton has one row per
+ *  locale, and code owns the name): the Next glue's getSmoodlyGlobal
+ *  caches under it; ops.globals expires it. */
+export const globalTag = (name) => `global:${name}`;
 /** The page-tree listing's cache unit (spec 2026-09-11 §2): one tree-wide
  *  tag, fired by every page op that changes what the listing shows. */
 export const pagesTreeTag = () => "pages:tree";

package/dist/richtext-render.js

@@ -67,8 +67,8 @@ function renderNode(node, r) {
             if (!Component)
                 return null;
             const fields = a.fields && typeof a.fields === "object" ? a.fields : {};
-            const styles = a.styles && typeof a.styles === "object" ? a.styles : {};
-            return _jsx(Component, { ...fields, styles: styles });
+            const settings = a.settings && typeof a.settings === "object" ? a.settings : {};
+            return _jsx(Component, { ...fields, settings: settings });
         }
         default: return children;
     }

package/dist/richtext-walk.d.ts

@@ -8,7 +8,7 @@ export type ImageNodeAttrs = {
 export type ElementNodeAttrs = {
     name?: unknown;
     fields?: unknown;
-    styles?: unknown;
+    settings?: unknown;
 };
 /** A block node as stored — `attrs` is the live object, so a walk may resolve in place. */
 export type BlockNode = {
@@ -20,23 +20,23 @@ export declare function richtextBlocks(doc: unknown): BlockNode[];
 /** An element's descriptors by name — what the walks read an element node against. */
 export type ElementSchemas = Record<string, {
     fields: Record<string, Descriptor>;
-    styles: Record<string, Descriptor>;
+    settings: Record<string, Descriptor>;
 }>;
 type ElementLike = {
     name: string;
     fields: Record<string, Descriptor>;
-    styles?: Record<string, Descriptor>;
+    settings?: Record<string, Descriptor>;
 } | {
     schema: {
         name: string;
         fields: Record<string, Descriptor>;
-        styles?: Record<string, Descriptor>;
+        settings?: Record<string, Descriptor>;
     };
 };
 export declare function elementSchemas(list: ElementLike[] | undefined): ElementSchemas;
 /** The element schema an element node names, or null for an unknown one. */
 export declare function elementOf(node: BlockNode, elements: ElementSchemas): ElementSchemas[string] | null;
-/** An element node's field and style value sets, for a walk. */
+/** An element node's field and settings value sets, for a walk. */
 export declare function elementSets(node: BlockNode, schema: ElementSchemas[string]): {
     values: Record<string, unknown>;
     descriptors: Record<string, Descriptor>;

package/dist/richtext-walk.js

@@ -24,7 +24,7 @@ export function elementSchemas(list) {
     for (const e of list ?? []) {
         const s = "schema" in e ? e.schema : e;
         if (!(s.name in out))
-            out[s.name] = { fields: s.fields, styles: s.styles ?? {} };
+            out[s.name] = { fields: s.fields, settings: s.settings ?? {} };
     }
     return out;
 }
@@ -34,13 +34,13 @@ export function elementOf(node, elements) {
     return typeof name === "string" ? elements[name] ?? null : null;
 }
 const asRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v) ? v : undefined;
-/** An element node's field and style value sets, for a walk. */
+/** An element node's field and settings value sets, for a walk. */
 export function elementSets(node, schema) {
     const a = node.attrs;
     const fields = asRecord(a.fields);
-    const styles = asRecord(a.styles);
+    const settings = asRecord(a.settings);
     return [
         ...(fields ? [{ values: fields, descriptors: schema.fields }] : []),
-        ...(styles ? [{ values: styles, descriptors: schema.styles }] : []),
+        ...(settings ? [{ values: settings, descriptors: schema.settings }] : []),
     ];
 }

package/dist/schema.d.ts

@@ -8,12 +8,15 @@ export type SectionSchema<F extends BuilderMap = BuilderMap, S extends BuilderMa
     icon?: string;
     description?: string;
     fields: Record<string, Descriptor>;
-    styles: Record<string, Descriptor>;
-    meta: Record<string, Descriptor>;
+    /** The developer's knobs (spec 2026-09-14 §3): the view alone interprets them. */
+    settings: Record<string, Descriptor>;
     sample?: Record<string, unknown>;
-    styleDefaults?: false | {
+    /** Smoodly's styles set (spec 2026-09-14 §2): absent = the whole set; `false` = none; `omit` drops keys. */
+    styles?: false | {
         omit: string[];
     };
+    /** The custom-CSS box (spec 2026-09-14 §4): `false` opts this section out. */
+    css?: false;
     /** phantom: builder types for Props inference */
     readonly __f?: F;
     readonly __s?: S;
@@ -34,23 +37,25 @@ export type NamespaceValues<M extends BuilderMap> = {
 } & {
     [K in OptionalKeys<M>]?: ValueOf<M[K]>;
 };
-type SectionInput<F extends BuilderMap, S extends BuilderMap, M extends BuilderMap> = {
+type SectionInput<F extends BuilderMap, S extends BuilderMap> = {
     name: string;
     title: string;
     icon?: string;
     description?: string;
     fields?: F;
-    styles?: S;
-    meta?: M;
-    sample?: Partial<NamespaceValues<F> & NamespaceValues<S>>;
-    styleDefaults?: false | {
+    settings?: S;
+    /** Gone (spec 2026-09-14 §1): an id is a setting the view passes to the wrapper. */
+    meta?: never;
+    styles?: false | {
         omit: string[];
     };
+    css?: false;
+    sample?: Partial<NamespaceValues<F> & NamespaceValues<S>>;
 };
 export declare const schema: {
     page: typeof pageSchema;
-    section<F extends BuilderMap = {}, S extends BuilderMap = {}, M extends BuilderMap = {}>(input: SectionInput<F, S, M>): SectionSchema<F, S>;
-    element<F extends BuilderMap = {}, S extends BuilderMap = {}, M extends BuilderMap = {}>(input: SectionInput<F, S, M> & {
+    section<F extends BuilderMap = {}, S extends BuilderMap = {}>(input: SectionInput<F, S>): SectionSchema<F, S>;
+    element<F extends BuilderMap = {}, S extends BuilderMap = {}>(input: SectionInput<F, S> & {
         contexts: ("richtext" | "column")[];
     }): ElementSchema<F, S>;
 };

package/dist/schema.js

@@ -1,5 +1,7 @@
 import { describePath, findMatch } from "./fields.js";
 import { pageSchema } from "./page.js";
+import { assertConditions } from "./conditions.js";
+import { STYLE_KEYS } from "./styles.js";
 function toDescriptors(map) {
     return Object.fromEntries(Object.entries(map ?? {}).map(([k, b]) => [k, b.descriptor]));
 }
@@ -13,21 +15,31 @@ function assertNotLocalized(ns, map) {
 function baseSchema(input) {
     if (!input?.name)
         throw new Error("smoodly: a schema requires a name.");
+    if ("meta" in input)
+        throw new Error('smoodly: "meta" is gone — put an id in settings and pass it as <smoodly.Section id={settings.id}>.');
+    if (input.styles !== undefined && input.styles !== false) {
+        if (typeof input.styles !== "object" || !Array.isArray(input.styles.omit)) {
+            throw new Error(`smoodly: section "${input.name}" declares styles — the developer's selects are "settings" since 2026-09-14; Smoodly's styles set is only toggled: false | { omit }.`);
+        }
+        for (const k of input.styles.omit) {
+            if (!STYLE_KEYS.includes(k))
+                throw new Error(`smoodly: section "${input.name}": styles.omit names "${k}", which is not a style key.`);
+        }
+    }
     const fields = toDescriptors(input.fields);
-    const styles = toDescriptors(input.styles);
-    const meta = toDescriptors(input.meta);
-    assertNotLocalized("styles", styles);
-    assertNotLocalized("meta", meta);
+    const settings = toDescriptors(input.settings);
+    assertNotLocalized("settings", settings);
+    assertConditions(input.name, { fields, settings });
     return {
         name: input.name,
         title: input.title,
         icon: input.icon,
         description: input.description,
         fields,
-        styles,
-        meta,
+        settings,
         sample: input.sample,
-        styleDefaults: input.styleDefaults,
+        ...(input.styles !== undefined ? { styles: input.styles } : {}),
+        ...(input.css !== undefined ? { css: input.css } : {}),
     };
 }
 export const schema = {

package/dist/section-wrapper.d.ts

@@ -1,11 +1,23 @@
 import type { CSSProperties, ReactNode } from "react";
-export declare function Section({ as, styles, className, style, children, }: {
+import { type StyleProps, type StyleValues } from "./styles.ts";
+/** The reserved key `<Zone>` and `getGlobal` ride on the styles object. */
+export declare const SMD_KEY = "__smd";
+export type SmdInternal = {
+    node?: string;
+    css?: string;
+    values?: StyleValues;
+    /** Pre-scoped layout CSS (the custom section, spec 2026-09-14 §6), emitted before the editor's css so the box wins. */
+    layoutCss?: string;
+};
+export declare function Section({ as, styles, className, style, children, ...rest }: {
     as?: keyof React.JSX.IntrinsicElements;
-    styles: Record<string, unknown>;
+    styles: StyleProps & {
+        [SMD_KEY]?: SmdInternal;
+    };
     className?: string;
     style?: CSSProperties;
     children?: ReactNode;
-}): import("react").ReactElement<{
-    className: string | undefined;
-    style: CSSProperties | undefined;
-}, string | import("react").JSXElementConstructor<any>>;
+    [attr: `data-${string}`]: string | number | boolean | undefined;
+    [attr: `aria-${string}`]: string | number | boolean | undefined;
+    id?: string;
+}): import("react").DOMElement<Record<string, unknown>, Element>;

package/dist/section-wrapper.js

@@ -1,20 +1,27 @@
 import { createElement } from "react";
 import { NODE_ATTR } from "./marks.js";
-// The root wrapper every section renders through. Owns the mechanical DOM
-// work on the real root element (no extra div): element choice via `as`,
-// string-valued styles emitted as kebab-cased data attributes. Built-in
-// meta (anchor, visibility) and editor chrome attach here when the
-// renderer and admin land. Bounded magic: everything else stays the dev's
-// job via normal className/style props.
-const kebab = (s) => s.replace(/[A-Z]/g, (c) => "-" + c.toLowerCase());
-export function Section({ as = "section", styles, className, style, children, }) {
-    const { __smoodlyNode, ...rest } = (styles ?? {});
-    const dataAttrs = {};
-    if (typeof __smoodlyNode === "string")
-        dataAttrs[NODE_ATTR] = __smoodlyNode;
-    for (const [key, value] of Object.entries(rest)) {
-        if (typeof value === "string")
-            dataAttrs[`data-${kebab(key)}`] = value;
-    }
-    return createElement(as, { className, style, ...dataAttrs }, children);
+import { DEFAULT_STYLE_VALUES, inlineStyles } from "./styles.js";
+import { safeCss, scopedCss } from "./css.js";
+// The root wrapper every section renders through (spec 2026-09-14 §2, §4).
+// Owns the real root element, no extra div: element choice via `as`,
+// Smoodly's styles set rendered INLINE (an editor's step beats the
+// section's own class rule with no ordering and no !important), the
+// node id as data-smd-node always (the custom-CSS scope needs it on the
+// live site), the scoped <style> child, and every other prop spread onto
+// the root — settings never become attributes; the view writes its own.
+/** The reserved key `<Zone>` and `getGlobal` ride on the styles object. */
+export const SMD_KEY = "__smd";
+export function Section({ as = "section", styles, className, style, children, ...rest }) {
+    const { [SMD_KEY]: smd, ...steps } = (styles ?? {});
+    const inline = inlineStyles(steps, smd?.values ?? DEFAULT_STYLE_VALUES);
+    const merged = { ...(style ?? {}), ...inline };
+    const attrs = { ...rest };
+    if (smd?.node)
+        attrs[NODE_ATTR] = smd.node;
+    if (className !== undefined)
+        attrs.className = className;
+    if (Object.keys(merged).length > 0)
+        attrs.style = merged;
+    const css = smd?.node ? safeCss(smd.css) : "";
+    return createElement(as, attrs, smd?.layoutCss ? createElement("style", { key: "smd-layout" }, smd.layoutCss) : null, css ? createElement("style", { key: "smd-css" }, scopedCss(smd.node, css)) : null, children);
 }

package/dist/site.d.ts

@@ -2,10 +2,12 @@ import type { AssetStore } from "./asset-store.ts";
 import type { CollectionSchema, EntryOrder } from "./collections.ts";
 import type { Descriptor } from "./fields.ts";
 import { type EntryRecord, type EntryStore, type Where } from "./entry-store.ts";
-import { type LocaleSet, type PathTarget } from "./paths.ts";
+import { type LocaleAlternate, type LocaleSet, type PageAlternate, type PathTarget } from "./paths.ts";
 import type { SectionLike } from "./refs.ts";
 import type { PageContext, PageLink, PageTree } from "./render.tsx";
-import { type SharedSchema } from "./shared.ts";
+import { type GlobalSchema } from "./global.ts";
+import { type StyleValues, type StyleValuesInput } from "./styles.ts";
+import { type CustomConfigInput, type ResolvedCustom } from "./custom/index.ts";
 import type { PageRecord, PageStore } from "./store.ts";
 export type SiteOptions = {
     stores: () => {
@@ -17,9 +19,13 @@ export type SiteOptions = {
     sections: SectionLike[];
     /** Registered Elements a richtext document may embed (spec 2026-09-08 block nodes §2). */
     elements?: SectionLike[];
-    shared?: SharedSchema[];
+    globals?: GlobalSchema[];
     locales: LocaleSet;
     homePageSlug?: string;
+    /** The CSS values behind Smoodly's styles set (spec 2026-09-14 §2); the package fallbacks fill the rest. */
+    styles?: StyleValuesInput;
+    /** The custom section's options (spec 2026-09-14 §6); the defaults when absent. */
+    custom?: CustomConfigInput;
     /** Page shapes (entry pages are ignored): the source of each template's page-field descriptors (spec 2026-09-10 page fields §3). */
     pages?: ReadonlyArray<SitePageSchema>;
 };
@@ -33,6 +39,8 @@ export type SitePageSchema = {
 };
 export type SitePage = {
     kind: "page";
+    /** The locale the hit was loaded in. */
+    locale: string;
     record: PageRecord;
     template: string;
     tree: PageTree;
@@ -42,20 +50,21 @@ export type SitePage = {
     fields: Record<string, unknown>;
     ancestors: PageLink[];
     children: PageLink[];
-    /** locale → path, for metadata alternates: the locales the page is
-     *  PUBLISHED in, since that is what may be advertised — draft mode
-     *  carries every locale the page exists in. */
-    paths: Record<string, string>;
+    /** One key per supported locale: the page's `{ slug, path }` there, or null where it is
+     *  absent or, outside draft mode, unpublished (spec 2026-09-15 §1). */
+    locales: Record<string, PageAlternate | null>;
 };
 export type SiteEntry = {
     kind: "entry";
+    /** The locale the hit was loaded in. */
+    locale: string;
     collection: string;
     /** `fields` are the locale's MERGED fields — shared + localized + slug —
      *  with refs resolved: the published snapshot on the public path, the
      *  live row in draft mode. */
     entry: EntryRecord;
     path: string;
-    paths: Record<string, string>;
+    locales: Record<string, LocaleAlternate | null>;
 };
 export type SiteHit = SitePage | SiteEntry;
 export type PageTreeItem = {
@@ -69,6 +78,8 @@ export type PageTreeItem = {
 export type SiteEntryItem = {
     entry: EntryRecord;
     path: string | null;
+    locale: string;
+    locales: Record<string, LocaleAlternate | null>;
 };
 export type EntryTreeItem = SiteEntryItem & {
     children: EntryTreeItem[];
@@ -90,6 +101,10 @@ export type LoadOptions = {
 export interface SmoodlySite {
     readonly locales: LocaleSet;
     readonly homePageSlug: string;
+    /** The resolved styles values the renderer and `getGlobal` hand the wrapper. */
+    readonly styles: StyleValues;
+    /** The custom section's resolved options the renderer hands renderPage. */
+    readonly custom: ResolvedCustom;
     /** One index hit: what lives at (locale, path). Uncached by design — the id it returns is the cache tag. */
     locate(locale: string, path: string): Promise<PathTarget | null>;
     /** Everything the renderer needs for one target: null when it is a folder, unpublished (outside draft), or gone. */
@@ -112,16 +127,16 @@ export interface SmoodlySite {
         locale?: string;
         draft?: boolean;
     }): Promise<EntryTreeItem[]>;
-    /** A shared item's content in a locale (spec 2026-09-07 §4): an object
+    /** A global item's content in a locale (spec 2026-09-07 §4): an object
      *  item's merged fields, or a visual item's section props (fields plus
-     *  `styles`), refs hydrated; null when the item has no row there or is
+     *  `settings`), refs hydrated; null when the item has no row there or is
      *  unpublished (outside draft mode). */
-    getShared<V>(item: SharedSchema<V>, options?: {
+    getGlobal<V>(item: GlobalSchema<V>, options?: {
         locale?: string;
         draft?: boolean;
     }): Promise<V | null>;
 }
-/** The `page` prop for a loaded page. `toUrl` is the app's `href` seam
- *  bound to the render locale; the default keeps CMS paths as URLs. */
-export declare function pageContextOf(hit: SitePage, toUrl?: (path: string) => string): PageContext;
+/** The `page` prop for a loaded page. `href` is the app's seam from a
+ *  locale-relative path to a site URL; the default keeps CMS paths as URLs. */
+export declare function pageContextOf(hit: SitePage, href?: (path: string, locale: string) => string): PageContext;
 export declare function createSmoodlySite(options: SiteOptions): SmoodlySite;