smoodly 0.0.45 → 0.0.47

package/dist/render.d.ts

@@ -1,94 +1,17 @@
-import { type ComponentType, type ReactElement, type ReactNode } from "react";
-import type { PageAlternate } from "./paths.ts";
+import { type ComponentType, type ReactElement } from "react";
 import type { PageSchema } from "./page.ts";
 import type { BuilderMap, Values } from "./schema.ts";
 import { type StyleValues } from "./styles.ts";
-import { type CustomOptions } from "./custom/index.ts";
-export type TreeNode = {
-    id: string;
-    type: string;
-    fields: Record<string, unknown>;
-    /** The developer's knobs (spec 2026-09-14 §3). */
-    settings?: Record<string, unknown>;
-    /** Smoodly's styles steps (spec 2026-09-14 §2); absent keys are Default. */
-    styles?: Record<string, unknown>;
-    /** The custom-CSS snippet (spec 2026-09-14 §4), scoped by the wrapper. */
-    css?: string;
-};
-/** `meta` is the page's own metadata (SEO title, description, og image).
- * It rides inside the tree deliberately: trees are already JSONB in
- * page_versions, so this needs no DDL change, and page meta becomes
- * versioned with content — draft SEO edits stay unpublished, and publish
- * moves content and meta together. */
-export type PageTree = {
-    zones: Record<string, TreeNode[]>;
-    meta?: Record<string, unknown>;
-    fields?: Record<string, unknown>;
-};
-/** Where a rendered page sits in the tree — what a view needs for
- *  breadcrumbs and sub-navigation without a query (spec 2026-09-05 §5).
- *  `path` is the locale-relative CMS path (what the content API returns);
- *  `url` is that path through the app's `href` seam — `/fi/yritys` under
- *  next-intl, `/yritys` without it — so a page shape links the same way
- *  in both layouts. `fields` is the linked page's own page fields (spec
- *  2026-09-10 page fields §3): the published tree's outside draft mode,
- *  raw (no asset resolution), defaults applied, `{}` for a folder. */
-export type PageLink = {
-    title: string;
-    path: string;
-    hasPage: boolean;
-    fields: Record<string, unknown>;
-};
-export type PageContextLink = PageLink & {
-    url: string;
-};
-/** The page's address in one other locale, `url` through the app's href seam (spec 2026-09-15 §3). */
-export type PageContextAlternate = PageAlternate & {
-    url: string;
-};
-export type PageContext<Fields = Record<string, unknown>> = {
-    id: string;
-    title: string;
-    path: string;
-    url: string;
-    /** The locale the page was rendered in. */
-    locale: string;
-    /** The page's own fields, typed from its schema on the view; resolved, defaults applied. */
-    fields: Fields;
-    /** Root first, parent last. */
-    ancestors: ReadonlyArray<PageContextLink>;
-    children: ReadonlyArray<PageContextLink>;
-    /** One key per supported locale: the page's `{ slug, path, url }` there, or null where it is
-     *  absent or unpublished (draft mode: absent only). What a language switch links to. */
-    locales: Readonly<Record<string, PageContextAlternate | null>>;
-};
-/** 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 declare const EMPTY_PAGE_CONTEXT: PageContext;
+import { type CustomOptions } from "./custom/CustomSection.tsx";
+import { type EditorWrap, type PageContext, type PageTree, type ZoneContent } from "./page-context.ts";
+export type { TreeNode, PageTree, PageLink, PageContextLink, PageContextAlternate, PageContext, ZoneContent, EditorWrap } from "./page-context.ts";
+export { EMPTY_PAGE_CONTEXT } from "./page-context.ts";
 type AnyPaired = ComponentType<any> & {
     schema: {
         name: string;
         title?: string;
     };
 };
-/** The adapter's canvas net (spec 2026-09-27 section guard §5): called per section, in editor mode only. */
-export type EditorWrap = (child: ReactNode, section: {
-    id: string;
-    title: string;
-}) => ReactNode;
-export type ZoneContent = {
-    readonly name: string;
-    readonly nodes: TreeNode[];
-    readonly components: ReadonlyMap<string, AnyPaired>;
-    /** The config's CSS values behind the styles set (spec 2026-09-14 §2). */
-    readonly styleValues: StyleValues;
-    readonly editor: boolean;
-    /** Control flow the guard must let through — the adapter's (Next: unstable_rethrow; spec 2026-09-27 section guard §2). */
-    readonly rethrow?: (error: unknown) => void;
-    readonly editorWrap?: EditorWrap;
-};
 export declare function Zone({ of: content }: {
     of: ZoneContent;
 }): import("react").JSX.Element | null;
@@ -114,4 +37,3 @@ export declare function renderPage<Zones extends Record<string, unknown>>(Page:
     rethrow?: (error: unknown) => void;
     editorWrap?: EditorWrap;
 }): ReactElement;
-export {};

package/dist/render.js

@@ -1,19 +1,14 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Fragment } from "react";
 import { EMPTY_ATTR, NODE_ATTR, ZONE_ATTR } from "./marks.js";
-import { SMD_KEY } from "./section-wrapper.js";
+import { SMD_KEY } from "./smd-key.js";
 import { DEFAULT_STYLE_VALUES } from "./styles.js";
-import { CUSTOM_NODE_TYPE, createCustomSection } from "./custom/index.js";
+import { CUSTOM_NODE_TYPE } from "./custom/index.js";
+import { createCustomSection } from "./custom/CustomSection.js";
+import { EMPTY_PAGE_CONTEXT } from "./page-context.js";
 import { renderGuarded } from "./section-guard.js";
 import { PLACEHOLDER_STYLE } from "./section-crash.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: "/", locale: "", fields: Object.freeze({}), ancestors: Object.freeze([]), children: Object.freeze([]),
-    locales: Object.freeze({}),
-});
+export { EMPTY_PAGE_CONTEXT } from "./page-context.js";
 export function Zone({ of: content }) {
     // A malformed tree (bad data, a client that skipped isPageTree) must not
     // crash the render — treat a non-array nodes as empty rather than throw.

package/dist/resolve.d.ts

@@ -1,6 +1,6 @@
 import type { Descriptor } from "./fields.ts";
 import type { CollectionSchema } from "./collections.ts";
-import type { PageTree } from "./render.tsx";
+import type { PageTree } from "./page-context.ts";
 import { type GlobalSchema } from "./global.ts";
 import { type AssetRecord } from "./media.ts";
 import { type ElementSchemas } from "./richtext-walk.ts";

package/dist/richtext/index.d.ts

@@ -6,7 +6,11 @@ export type CreateRichTextOptions = {
     /** next/image `sizes` for body images; the site's text column width. */
     sizes?: string;
 };
-export declare function createRichText({ elements, sizes }?: CreateRichTextOptions): (props: {
+/** The bound renderer; `elements` is the list it renders, which defineViews checks against the config's richtext elements. */
+export type BoundRichText = ((props: {
     doc: unknown;
-}) => ReactElement;
+}) => ReactElement) & {
+    elements: RichTextElement[];
+};
+export declare function createRichText({ elements, sizes }?: CreateRichTextOptions): BoundRichText;
 export type { RichTextElement, RichTextImageProps, RichTextProps } from "../richtext-render.tsx";

package/dist/richtext/index.js

@@ -3,7 +3,8 @@ import { RichText } from "../richtext-render.js";
 import { SmoodlyImage } from "../image/SmoodlyImage.js";
 export function createRichText({ elements = [], sizes } = {}) {
     const image = ({ image, caption }) => (_jsxs("figure", { children: [_jsx(SmoodlyImage, { image: image, sizes: sizes }), caption !== "" && _jsx("figcaption", { children: caption })] }));
-    return function BoundRichText({ doc }) {
+    function Bound({ doc }) {
         return _jsx(RichText, { doc: doc, elements: elements, image: image });
-    };
+    }
+    return Object.assign(Bound, { elements });
 }

package/dist/richtext-href.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedImage } from "./media.ts";
+export declare function safeHref(raw: unknown): string | null;
+export declare function escapeHtml(text: string): string;
+export declare const isResolvedImage: (v: unknown) => v is ResolvedImage;

package/dist/richtext-href.js

@@ -0,0 +1,17 @@
+/** Only schemes an editor's link may carry reach the page: http(s), mailto, tel, and site-relative targets.
+ *  Anything else (javascript:, data:, an empty href, a protocol-relative `//host` or a backslash form
+ *  `/\host` that a browser treats the same way) renders the text without an anchor. */
+const SAFE_HREF = /^(https?:|mailto:|tel:|\/(?![/\\])|#|\?|\.)/i;
+export function safeHref(raw) {
+    if (typeof raw !== "string")
+        return null;
+    // URL parsers drop tab, LF and CR, so normalise before testing to see what the parser sees.
+    const href = raw.replace(/[\t\n\r]/g, "").trim();
+    return href !== "" && SAFE_HREF.test(href) ? href : null;
+}
+const ESCAPES = { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#x27;" };
+export function escapeHtml(text) {
+    return text.replace(/[&<>"']/g, (c) => ESCAPES[c]);
+}
+export const isResolvedImage = (v) => typeof v === "object" && v !== null && typeof v.url === "string"
+    && typeof v.width === "number" && typeof v.height === "number";

package/dist/richtext-render.js

@@ -9,26 +9,13 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 // (default: a figure over a plain <img>); an `element` node renders the
 // paired component named in `elements`, nothing when unknown.
 import { Fragment, createElement } from "react";
+import { isResolvedImage, safeHref } from "./richtext-href.js";
 import { ELEMENT_NODE, IMAGE_NODE } from "./richtext-walk.js";
-/** Only schemes an editor's link may carry reach the page: http(s), mailto, tel,
- *  and site-relative targets. Anything else (javascript:, data:, an empty href,
- *  a protocol-relative `//host` or a backslash form `/\host` that a browser
- *  treats the same way) renders the text without an anchor. */
-const SAFE_HREF = /^(https?:|mailto:|tel:|\/(?![/\\])|#|\?|\.)/i;
-function safeHref(raw) {
-    if (typeof raw !== "string")
-        return null;
-    // URL parsers drop tab, LF and CR, so normalise before testing to see what the parser sees.
-    const href = raw.replace(/[\t\n\r]/g, "").trim();
-    return href !== "" && SAFE_HREF.test(href) ? href : null;
-}
 /** Lazy by default: body images sit below the fold, and a lazy <img> is
  *  the one React does not hoist a preload hint for on the server. */
 export function defaultRichTextImage({ image, caption }) {
     return (_jsxs("figure", { children: [_jsx("img", { src: image.url, width: image.width, height: image.height, alt: image.alt, loading: "lazy" }), caption !== "" && _jsx("figcaption", { children: caption })] }));
 }
-const isResolvedImage = (v) => typeof v === "object" && v !== null && typeof v.url === "string"
-    && typeof v.width === "number" && typeof v.height === "number";
 export function RichText({ doc, elements = [], image = defaultRichTextImage }) {
     const d = doc;
     if (!d || typeof d !== "object" || d.type !== "doc" || !Array.isArray(d.content))

package/dist/schema-version.d.ts

@@ -1,7 +1,7 @@
 /** The minimum schema version the package needs. Moves ONLY in a release
  *  that adds a table, column, function or policy the package reads; a
  *  unit test holds it equal to the highest file in `migrations/`. */
-export declare const SCHEMA_VERSION = 7;
+export declare const SCHEMA_VERSION = 10;
 export declare const SCHEMA_VERSION_KEY = "schema_version";
 export declare const CORE_FILE_RE: RegExp;
 export declare const VIEWS_FILE_RE: RegExp;

package/dist/schema-version.js

@@ -7,7 +7,7 @@
 /** The minimum schema version the package needs. Moves ONLY in a release
  *  that adds a table, column, function or policy the package reads; a
  *  unit test holds it equal to the highest file in `migrations/`. */
-export const SCHEMA_VERSION = 7;
+export const SCHEMA_VERSION = 10;
 export const SCHEMA_VERSION_KEY = "schema_version";
 export const CORE_FILE_RE = /^(\d{14})_smoodly_v(\d+)\.sql$/;
 export const VIEWS_FILE_RE = /^(\d{14})_smoodly_views\.sql$/;

package/dist/section-crash.d.ts

@@ -1,8 +1,8 @@
 import type { CSSProperties } from "react";
+import { crashMessage } from "./crash-message.ts";
+export { crashMessage };
 /** The canvas placeholders' look — the unknown section's too (spec 2026-09-27 editor safety §5). */
 export declare const PLACEHOLDER_STYLE: CSSProperties;
-/** Why it crashed, for the placeholder: the message, or the digest when a production build stripped the message. */
-export declare function crashMessage(error: unknown): string;
 export declare function CrashPlaceholder({ id, title, error, live }: {
     id: string;
     title: string;

package/dist/section-crash.js

@@ -1,16 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { crashMessage } from "./crash-message.js";
 import { CRASHED_ATTR, NODE_ATTR } from "./marks.js";
+export { crashMessage };
 /** The canvas placeholders' look — the unknown section's too (spec 2026-09-27 editor safety §5). */
 export const PLACEHOLDER_STYLE = {
     padding: "24px 16px", border: "1px dashed #b54708", color: "#b54708", font: "500 14px/1.4 system-ui, sans-serif", textAlign: "center",
 };
-/** Why it crashed, for the placeholder: the message, or the digest when a production build stripped the message. */
-export function crashMessage(error) {
-    const digest = typeof error === "object" && error !== null ? error.digest : undefined;
-    if (typeof digest === "string")
-        return `the server log has the error (digest ${digest})`;
-    return error instanceof Error ? error.message : String(error);
-}
 export function CrashPlaceholder({ id, title, error, live }) {
     return (_jsx("div", { [NODE_ATTR]: id, [CRASHED_ATTR]: live, style: PLACEHOLDER_STYLE, children: `Section “${title}” failed to render — ${crashMessage(error)}` }));
 }

package/dist/section-wrapper.d.ts

@@ -1,14 +1,7 @@
 import type { CSSProperties, ReactNode } from "react";
-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;
-};
+import { type StyleProps } from "./styles.ts";
+import { SMD_KEY, type SmdInternal } from "./smd-key.ts";
+export { SMD_KEY, type SmdInternal };
 export declare function Section({ as, styles, className, style, children, ...rest }: {
     as?: keyof React.JSX.IntrinsicElements;
     styles: StyleProps & {

package/dist/section-wrapper.js

@@ -2,6 +2,7 @@ import { createElement } from "react";
 import { NODE_ATTR } from "./marks.js";
 import { DEFAULT_STYLE_VALUES, inlineStyles } from "./styles.js";
 import { safeCss, scopedCss } from "./css.js";
+import { SMD_KEY } from "./smd-key.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
@@ -9,8 +10,8 @@ import { safeCss, scopedCss } from "./css.js";
 // 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";
+// The reserved key lives in smd-key.ts (pure), re-exported here.
+export { SMD_KEY };
 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);

package/dist/site.d.ts

@@ -4,18 +4,31 @@ import type { Descriptor } from "./fields.ts";
 import { type EntryRecord, type EntryStore, type Where } from "./entry-store.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 GlobalSchema } from "./global.ts";
-import { type StyleValues, type StyleValuesInput } from "./styles.ts";
-import { type CustomConfigInput, type ResolvedCustom } from "./custom/index.ts";
+import type { PageContext, PageLink, PageTree } from "./page-context.ts";
+import type { GlobalSchema } from "./global.ts";
+import type { StyleValues, StyleValuesInput } from "./styles.ts";
+import type { CustomConfigInput, ResolvedCustom } from "./custom/index.ts";
 import type { PageRecord, PageStore } from "./store.ts";
 import type { PathHit } from "./path-index.ts";
 import { type EntryItem, type PageItem, type Seo } from "./read-shapes.ts";
+import type { SchemaOr } from "./registration.ts";
+/** An address read with its layout's globals: the hit as `lookup` answers it, and each item's value by name. */
+export type AddressWithGlobals = {
+    hit: SiteHit | {
+        kind: "redirect";
+        target: PathTarget;
+    } | null;
+    globals: Map<string, unknown>;
+};
+import type { PublishedStore } from "./published.ts";
+import { type Projector } from "./project.ts";
 export type SiteOptions = {
+    /** `published`: the delivery documents outside draft mode read (spec 2026-10-07 delivery model §3). */
     stores: () => {
         pages: PageStore;
         entries: EntryStore;
         assets?: AssetStore;
+        published: PublishedStore;
     };
     collections: CollectionSchema<any>[];
     sections: SectionLike[];
@@ -31,18 +44,16 @@ export type SiteOptions = {
     /** Page shapes (entry pages are ignored): the source of each template's page-field descriptors (spec 2026-09-10 page fields §3)
      *  and of the fixed pages' addresses (spec 2026-09-29 nested paths §3) — `config.registry.pages`. Required: a site that
      *  missed one would take its code-owned record for an orphan and drop its URLs at the first lookup. */
-    pages: ReadonlyArray<SitePageSchema>;
+    pages: ReadonlyArray<SchemaOr<SitePageSchema>>;
 };
-/** A page registration as the site needs it: the template's page fields, and a fixed page's address. */
+/** A page type as the site needs it: its page fields, and a fixed page's address. */
 export type SitePageSchema = {
-    schema: {
-        kind: string;
-        name: string;
-        title?: string;
-        slug?: string | Record<string, string>;
-        fields?: Record<string, Descriptor>;
-        seo?: true;
-    };
+    kind: string;
+    name: string;
+    title?: string;
+    slug?: string | Record<string, string>;
+    fields?: Record<string, Descriptor>;
+    seo?: true;
 };
 export type SitePage = {
     kind: "page";
@@ -111,6 +122,8 @@ export interface SmoodlySite {
     /** The package version and a hash of the registered model: a part of every cache key, so an upgrade or a
      *  model change never serves a unit cached in the old shape (spec 2026-09-30 tester findings §3). */
     readonly cacheKey: string;
+    /** The document stamp a delivery row carries (DESIGN §3): the format number and the model hash, never the version. */
+    readonly stamp: 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. */
@@ -122,6 +135,17 @@ export interface SmoodlySite {
     /** Everything the renderer needs for one target: null when it is a folder, unpublished (outside draft), or gone. */
     load(target: PathTarget, locale: string, path: string, options?: LoadOptions): Promise<SiteHit | null>;
     resolve(locale: string, path: string, options?: LoadOptions): Promise<SiteHit | null>;
+    /** The published read of an address (spec 2026-10-07 delivery model §3): one lookup of the stored document; on a miss
+     *  the code-owned page, then one locate that tells a redirect row from a record to assemble and from a 404. */
+    lookup(locale: string, path: string): Promise<SiteHit | {
+        kind: "redirect";
+        target: PathTarget;
+    } | null>;
+    /** The same lookup with the layout's global items riding along (schema v9): one store call answers the page and
+     *  each item's value by name, a row behind the model healed as `getGlobal` heals it. A miss brings no globals. */
+    lookupWithGlobals(locale: string, path: string, items: readonly GlobalSchema<any>[]): Promise<AddressWithGlobals>;
+    /** Writes delivery rows from the editing tables: Publish calls it, and heal on read goes through it. */
+    readonly projector: Projector;
     /** A fixed page type (or a collection's index page) as code alone describes it, when `path` is its address in
      *  `locale`: an empty tree, the page fields' defaults, the registration's title. The renderer serves it where
      *  the index has no row — a page type added after install, a locale added to the config — until the admin
@@ -152,5 +176,7 @@ export interface SmoodlySite {
         draft?: boolean;
     }): Promise<V | null>;
 }
+/** 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;