smoodly 0.0.45 → 0.0.46

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 = 9;
 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 = 9;
 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";
@@ -122,6 +133,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 +174,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;