@elytracms/core 0.0.6

package/dist/rich-text/render.d.ts

@@ -0,0 +1,69 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { ComponentNode } from '@elytracms/core/project-graph';
+import type { RichTextDoc, RichTextValue } from './schema';
+import type { RichTextRegistry } from './registry';
+/**
+ * Server-safe read-only renderer: rich-text storage JSON → React (brief §7.6).
+ *
+ * "Server-safe" means this module imports only `react` (no `react-dom`, no browser
+ * globals, no editor bundle), so an exported Next.js app can render content on the
+ * server. It returns React elements; callers turn them into markup with
+ * `react-dom/server` or hydrate them as-is.
+ *
+ * Unknown node types never crash: each one renders a visible fallback and is
+ * collected as a structured {@link RichTextRenderIssue} (validation is first-class).
+ */
+/**
+ * A structured problem found while rendering: an unknown node type, or a
+ * `componentEmbed` whose embedded composition value is missing/malformed (EC-189).
+ */
+export interface RichTextRenderIssue {
+    code: 'unknown-node' | 'invalid-embed';
+    message: string;
+    /** The offending storage `node.type`. */
+    nodeType: string;
+    /** Index path into the document tree (content indices), for tooling. */
+    path: number[];
+}
+/**
+ * Renders an embedded composition value (a single `ComponentNode`, EC-189) to
+ * React. INJECTED by the host so the rich-text package stays free of
+ * `@elytracms/core/runtime-renderer` (which already depends on rich-text via the RichText
+ * primitive). The host binds this to `renderComposition(node, renderContext)`, so
+ * an embed renders byte-equivalent to the same component in a page/block field.
+ * Omit to fall back to the visible placeholder (e.g. server-safe validation passes
+ * with no registry/implementations available).
+ */
+export type RichTextEmbedRenderer = (node: ComponentNode) => ReactNode;
+export interface RenderRichTextOptions {
+    /** Registry of custom block/inline renderers. Defaults to empty. */
+    registry?: RichTextRegistry;
+    /**
+     * Renders `componentEmbed` nodes (EC-189). Bound by the host to
+     * `renderComposition`. When absent, embeds show the visible fallback.
+     */
+    renderEmbed?: RichTextEmbedRenderer;
+    /**
+     * Collector invoked once per unknown node encountered. Lets tooling surface
+     * issues without re-walking the tree.
+     */
+    onIssue?: (issue: RichTextRenderIssue) => void;
+    /** className applied to the wrapping element of the document. */
+    className?: string;
+}
+/** Built-in node types this renderer understands without any registry. */
+export declare const BUILTIN_NODE_TYPES: readonly ["doc", "paragraph", "text", "heading", "bulletList", "orderedList", "listItem", "blockquote", "codeBlock", "hardBreak", "horizontalRule", "image", "embed", "componentEmbed"];
+/** Built-in mark types this renderer understands. */
+export declare const BUILTIN_MARK_TYPES: readonly ["bold", "italic", "code", "link", "strike", "underline"];
+/**
+ * Render a parsed rich-text document tree to a React element. Pure: no DOM access.
+ * The wrapping element is a `div.rich-text` so consumers can scope styles.
+ */
+export declare function renderRichTextDoc(doc: RichTextDoc, options?: RenderRichTextOptions): ReactElement;
+/** Render a versioned rich-text value (convenience over {@link renderRichTextDoc}). */
+export declare function renderRichTextValue(value: RichTextValue, options?: RenderRichTextOptions): ReactElement;
+/**
+ * Walk a document and collect every unknown-node issue *without* rendering. Useful
+ * for pre-flight validation (e.g. before export) where you only want the issues.
+ */
+export declare function findUnknownNodes(doc: RichTextDoc, registry?: RichTextRegistry): RichTextRenderIssue[];

package/dist/rich-text/render.js

@@ -0,0 +1,205 @@
+import { Fragment, createElement } from 'react';
+import { COMPONENT_EMBED_NODE_TYPE, embeddedComponentNode } from './embed';
+import { emptyRichTextRegistry } from './registry';
+/** Built-in node types this renderer understands without any registry. */
+export const BUILTIN_NODE_TYPES = [
+    'doc',
+    'paragraph',
+    'text',
+    'heading',
+    'bulletList',
+    'orderedList',
+    'listItem',
+    'blockquote',
+    'codeBlock',
+    'hardBreak',
+    'horizontalRule',
+    'image',
+    'embed',
+    // EC-189: an embedded registry component (a composition value). Built-in so a
+    // document carrying embeds is never flagged "unknown-node" — its render is
+    // delegated to the injected embed renderer (see `RichTextEmbedRenderer`).
+    COMPONENT_EMBED_NODE_TYPE,
+];
+/** Built-in mark types this renderer understands. */
+export const BUILTIN_MARK_TYPES = ['bold', 'italic', 'code', 'link', 'strike', 'underline'];
+function attrString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function attrNumber(value) {
+    return typeof value === 'number' ? value : undefined;
+}
+/** Wrap inline content in the elements implied by its marks, innermost-first. */
+function applyMarks(content, marks, key) {
+    if (!marks || marks.length === 0)
+        return content;
+    return marks.reduce((acc, mark, i) => {
+        const markKey = `${key}-m${i}`;
+        switch (mark.type) {
+            case 'bold':
+                return createElement('strong', { key: markKey }, acc);
+            case 'italic':
+                return createElement('em', { key: markKey }, acc);
+            case 'code':
+                return createElement('code', { key: markKey }, acc);
+            case 'strike':
+                return createElement('s', { key: markKey }, acc);
+            case 'underline':
+                return createElement('u', { key: markKey }, acc);
+            case 'link': {
+                const href = attrString(mark.attrs?.href) ?? '#';
+                const target = attrString(mark.attrs?.target);
+                const rel = target === '_blank' ? 'noopener noreferrer' : attrString(mark.attrs?.rel);
+                return createElement('a', { key: markKey, href, ...(target ? { target } : {}), ...(rel ? { rel } : {}) }, acc);
+            }
+            default:
+                // Unknown mark: keep the text visible, wrapped in a tagged span so it is
+                // inspectable but never lost.
+                return createElement('span', { key: markKey, 'data-unknown-mark': mark.type }, acc);
+        }
+    }, content);
+}
+/** The visible fallback shown for an embed the renderer cannot resolve (EC-189). */
+function invalidEmbedFallback(key) {
+    return createElement('div', { key, 'data-invalid-embed': '', className: 'rich-text-invalid-embed', role: 'note' }, 'Invalid embedded component.');
+}
+function renderChildren(nodes, ctx, path) {
+    if (!nodes)
+        return [];
+    return nodes.map((child, i) => renderNode(child, ctx, [...path, i]));
+}
+/** The visible fallback shown for any node type the renderer cannot resolve. */
+function unknownFallback(node, key) {
+    return createElement('div', { key, 'data-unknown-node': node.type, className: 'rich-text-unknown', role: 'note' }, `Unknown content block: ${node.type}`);
+}
+function renderNode(node, ctx, path) {
+    const key = `n-${path.join('-')}`;
+    // Leaf text node.
+    if (node.type === 'text') {
+        return applyMarks(node.text ?? '', node.marks, key);
+    }
+    switch (node.type) {
+        case 'paragraph':
+            return createElement('p', { key }, ...renderChildren(node.content, ctx, path));
+        case 'heading': {
+            const level = attrNumber(node.attrs?.level);
+            const clamped = level && level >= 1 && level <= 6 ? level : 1;
+            return createElement(`h${clamped}`, { key }, ...renderChildren(node.content, ctx, path));
+        }
+        case 'bulletList':
+            return createElement('ul', { key }, ...renderChildren(node.content, ctx, path));
+        case 'orderedList':
+            return createElement('ol', { key }, ...renderChildren(node.content, ctx, path));
+        case 'listItem':
+            return createElement('li', { key }, ...renderChildren(node.content, ctx, path));
+        case 'blockquote':
+            return createElement('blockquote', { key }, ...renderChildren(node.content, ctx, path));
+        case 'codeBlock': {
+            const language = attrString(node.attrs?.language);
+            return createElement('pre', { key }, createElement('code', language ? { className: `language-${language}` } : {}, ...renderChildren(node.content, ctx, path)));
+        }
+        case 'hardBreak':
+            return createElement('br', { key });
+        case 'horizontalRule':
+            return createElement('hr', { key });
+        case 'image': {
+            const src = attrString(node.attrs?.src) ?? '';
+            const alt = attrString(node.attrs?.alt) ?? '';
+            const title = attrString(node.attrs?.title);
+            return createElement('img', { key, src, alt, ...(title ? { title } : {}) });
+        }
+        case 'embed': {
+            // Generic media/embed: an iframe by URL (e.g. video, map). Server-safe.
+            const src = attrString(node.attrs?.src) ?? '';
+            const title = attrString(node.attrs?.title) ?? 'Embedded content';
+            return createElement('iframe', {
+                key,
+                src,
+                title,
+                loading: 'lazy',
+                'data-embed-provider': attrString(node.attrs?.provider) ?? undefined,
+            });
+        }
+        case COMPONENT_EMBED_NODE_TYPE: {
+            // EC-189: an embedded registry component. Resolve the embedded composition
+            // value and delegate to the injected embed renderer (bound to
+            // `renderComposition`), so the embed renders identically to the same
+            // component in a page/block field. A missing renderer or a malformed embed
+            // degrades to the visible fallback — never a crash, never silent.
+            const embedded = embeddedComponentNode(node);
+            if (!embedded) {
+                ctx.onIssue?.({
+                    code: 'invalid-embed',
+                    message: 'Component embed is missing a valid embedded component node.',
+                    nodeType: node.type,
+                    path,
+                });
+                return invalidEmbedFallback(key);
+            }
+            if (!ctx.renderEmbed)
+                return invalidEmbedFallback(key);
+            return createElement(Fragment, { key }, ctx.renderEmbed(embedded));
+        }
+        default: {
+            // Custom node from the registry (block or inline).
+            const def = ctx.registry.get(node.type);
+            if (def) {
+                const children = node.content && node.content.length > 0 ? renderChildren(node.content, ctx, path) : undefined;
+                const element = def.render({ node, children });
+                return element ? createElement(Fragment, { key }, element) : null;
+            }
+            // Unknown: visible fallback + structured issue. Never throws.
+            ctx.onIssue?.({
+                code: 'unknown-node',
+                message: `No renderer registered for rich-text node type "${node.type}".`,
+                nodeType: node.type,
+                path,
+            });
+            return unknownFallback(node, key);
+        }
+    }
+}
+/**
+ * Render a parsed rich-text document tree to a React element. Pure: no DOM access.
+ * The wrapping element is a `div.rich-text` so consumers can scope styles.
+ */
+export function renderRichTextDoc(doc, options = {}) {
+    const ctx = {
+        registry: options.registry ?? emptyRichTextRegistry,
+        renderEmbed: options.renderEmbed,
+        onIssue: options.onIssue,
+    };
+    const children = renderChildren(doc.content, ctx, []);
+    return createElement('div', { className: options.className ? `rich-text ${options.className}` : 'rich-text' }, ...children);
+}
+/** Render a versioned rich-text value (convenience over {@link renderRichTextDoc}). */
+export function renderRichTextValue(value, options = {}) {
+    return renderRichTextDoc(value.doc, options);
+}
+/**
+ * Walk a document and collect every unknown-node issue *without* rendering. Useful
+ * for pre-flight validation (e.g. before export) where you only want the issues.
+ */
+export function findUnknownNodes(doc, registry = emptyRichTextRegistry) {
+    const issues = [];
+    const builtins = new Set(BUILTIN_NODE_TYPES);
+    const walk = (nodes, path) => {
+        if (!nodes)
+            return;
+        nodes.forEach((node, i) => {
+            const here = [...path, i];
+            if (!builtins.has(node.type) && !registry.has(node.type)) {
+                issues.push({
+                    code: 'unknown-node',
+                    message: `No renderer registered for rich-text node type "${node.type}".`,
+                    nodeType: node.type,
+                    path: here,
+                });
+            }
+            walk(node.content, here);
+        });
+    };
+    walk(doc.content, []);
+    return issues;
+}
+//# sourceMappingURL=render.js.map

package/dist/rich-text/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/rich-text/render.tsx"],"names":[],"mappings":"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"}

package/dist/rich-text/schema.d.ts

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import type { JsonValue } from '@elytracms/core/project-graph';
+/**
+ * Rich-text storage format (brief §7.6).
+ *
+ * The on-disk shape is intentionally ProseMirror/TipTap-shaped: a JSON document is
+ * a tree of nodes `{ type, attrs?, content?, marks?, text? }`. Keeping the storage
+ * format identical to ProseMirror's lets a TipTap editor plug in later behind the
+ * {@link RichTextAdapter} seam without a migration — the editor reads/writes the
+ * exact same JSON this package validates and renders.
+ *
+ * Nothing in this module imports TipTap. The format is modelled directly so the
+ * spike has no required dependency on a paid or cloud editor service.
+ */
+/** The schema version this build of the package reads and writes. Stored per value. */
+export declare const RICH_TEXT_SCHEMA_VERSION = 1;
+/** Attribute bag carried by a node or mark. Plain JSON only — never runtime handles. */
+export declare const richTextAttrsSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+export type RichTextAttrs = Record<string, JsonValue>;
+/**
+ * A mark applied to inline text (bold, italic, code, link, …). Marks are
+ * ProseMirror-shaped: a `type` plus an optional attribute bag (e.g. a link `href`).
+ */
+export declare const richTextMarkSchema: z.ZodObject<{
+    type: z.ZodString;
+    attrs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+}, z.core.$strip>;
+export type RichTextMark = z.infer<typeof richTextMarkSchema>;
+/**
+ * A single node in the document tree.
+ *
+ * - Leaf text nodes carry `text` (and optional `marks`).
+ * - Block/inline nodes carry `content` (ordered children) and/or `attrs`.
+ *
+ * The schema deliberately keeps `type` an open string: a document referencing an
+ * unknown node type still *parses* so the renderer can show a visible fallback and
+ * tooling can report a structured issue — mirroring how the project graph keeps
+ * component ids as open strings (see `@elytracms/core/project-graph`).
+ */
+export interface RichTextNode {
+    type: string;
+    attrs?: RichTextAttrs;
+    content?: RichTextNode[];
+    marks?: RichTextMark[];
+    text?: string;
+}
+export declare const richTextNodeSchema: z.ZodType<RichTextNode>;
+/** The root document node. By ProseMirror convention its `type` is `doc`. */
+export declare const richTextDocSchema: z.ZodObject<{
+    type: z.ZodLiteral<"doc">;
+    content: z.ZodDefault<z.ZodArray<z.ZodType<RichTextNode, unknown, z.core.$ZodTypeInternals<RichTextNode, unknown>>>>;
+}, z.core.$strip>;
+export type RichTextDoc = z.infer<typeof richTextDocSchema>;
+/**
+ * A stored rich-text value. Every value carries the schema {@link version} it was
+ * written under so old content stays readable across format changes (brief §7.6).
+ */
+export declare const richTextValueSchema: z.ZodObject<{
+    version: z.ZodNumber;
+    doc: z.ZodObject<{
+        type: z.ZodLiteral<"doc">;
+        content: z.ZodDefault<z.ZodArray<z.ZodType<RichTextNode, unknown, z.core.$ZodTypeInternals<RichTextNode, unknown>>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type RichTextValue = z.infer<typeof richTextValueSchema>;
+/** Wrap a document tree in a versioned value, stamping the current schema version. */
+export declare function createRichTextValue(doc: RichTextDoc): RichTextValue;
+/** Convenience constructor for an empty (but valid) versioned value. */
+export declare function emptyRichTextValue(): RichTextValue;
+export type ParseRichTextResult = {
+    ok: true;
+    value: RichTextValue;
+} | {
+    ok: false;
+    error: z.ZodError;
+};
+/**
+ * Parse a rich-text value from a JSON string or already-parsed object. Never throws
+ * on invalid input — returns a structured failure instead (validation is
+ * first-class; see AGENTS.md).
+ */
+export declare function parseRichTextValue(input: string | unknown): ParseRichTextResult;
+/** Serialize a rich-text value to JSON, parsing first so output is always valid. */
+export declare function serializeRichTextValue(value: RichTextValue): string;
+/** True when a value's stored version matches the version this build understands. */
+export declare function isCompatibleRichTextVersion(value: RichTextValue): boolean;

package/dist/rich-text/schema.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { jsonValueSchema } from '@elytracms/core/project-graph';
+/**
+ * Rich-text storage format (brief §7.6).
+ *
+ * The on-disk shape is intentionally ProseMirror/TipTap-shaped: a JSON document is
+ * a tree of nodes `{ type, attrs?, content?, marks?, text? }`. Keeping the storage
+ * format identical to ProseMirror's lets a TipTap editor plug in later behind the
+ * {@link RichTextAdapter} seam without a migration — the editor reads/writes the
+ * exact same JSON this package validates and renders.
+ *
+ * Nothing in this module imports TipTap. The format is modelled directly so the
+ * spike has no required dependency on a paid or cloud editor service.
+ */
+/** The schema version this build of the package reads and writes. Stored per value. */
+export const RICH_TEXT_SCHEMA_VERSION = 1;
+/** Attribute bag carried by a node or mark. Plain JSON only — never runtime handles. */
+export const richTextAttrsSchema = z.record(z.string(), jsonValueSchema);
+/**
+ * A mark applied to inline text (bold, italic, code, link, …). Marks are
+ * ProseMirror-shaped: a `type` plus an optional attribute bag (e.g. a link `href`).
+ */
+export const richTextMarkSchema = z.object({
+    type: z.string().min(1),
+    attrs: richTextAttrsSchema.optional(),
+});
+export const richTextNodeSchema = z.lazy(() => z.object({
+    type: z.string().min(1),
+    attrs: richTextAttrsSchema.optional(),
+    content: z.array(richTextNodeSchema).optional(),
+    marks: z.array(richTextMarkSchema).optional(),
+    text: z.string().optional(),
+}));
+/** The root document node. By ProseMirror convention its `type` is `doc`. */
+export const richTextDocSchema = z.object({
+    type: z.literal('doc'),
+    content: z.array(richTextNodeSchema).default([]),
+});
+/**
+ * A stored rich-text value. Every value carries the schema {@link version} it was
+ * written under so old content stays readable across format changes (brief §7.6).
+ */
+export const richTextValueSchema = z.object({
+    /** Schema version this value was written under. */
+    version: z.number().int().nonnegative(),
+    doc: richTextDocSchema,
+});
+/** Wrap a document tree in a versioned value, stamping the current schema version. */
+export function createRichTextValue(doc) {
+    return { version: RICH_TEXT_SCHEMA_VERSION, doc };
+}
+/** Convenience constructor for an empty (but valid) versioned value. */
+export function emptyRichTextValue() {
+    return createRichTextValue({ type: 'doc', content: [] });
+}
+/**
+ * Parse a rich-text value from a JSON string or already-parsed object. Never throws
+ * on invalid input — returns a structured failure instead (validation is
+ * first-class; see AGENTS.md).
+ */
+export function parseRichTextValue(input) {
+    let json;
+    try {
+        json = typeof input === 'string' ? JSON.parse(input) : input;
+    }
+    catch {
+        json = undefined;
+    }
+    const result = richTextValueSchema.safeParse(json);
+    return result.success ? { ok: true, value: result.data } : { ok: false, error: result.error };
+}
+/** Serialize a rich-text value to JSON, parsing first so output is always valid. */
+export function serializeRichTextValue(value) {
+    return JSON.stringify(richTextValueSchema.parse(value));
+}
+/** True when a value's stored version matches the version this build understands. */
+export function isCompatibleRichTextVersion(value) {
+    return value.version === RICH_TEXT_SCHEMA_VERSION;
+}
+//# sourceMappingURL=schema.js.map

package/dist/rich-text/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/rich-text/schema.ts"],"names":[],"mappings":"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"}

package/dist/rich-text/test-support.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Test-only helper: render a React element to static HTML markup.
+ *
+ * The read-only renderer in `render.tsx` is server-safe and imports only `react`;
+ * `react-dom` is a devDependency used solely by tests to assert on emitted markup.
+ */
+export { renderToStaticMarkup } from 'react-dom/server';

package/dist/rich-text/test-support.js

@@ -0,0 +1,8 @@
+/**
+ * Test-only helper: render a React element to static HTML markup.
+ *
+ * The read-only renderer in `render.tsx` is server-safe and imports only `react`;
+ * `react-dom` is a devDependency used solely by tests to assert on emitted markup.
+ */
+export { renderToStaticMarkup } from 'react-dom/server';
+//# sourceMappingURL=test-support.js.map

package/dist/rich-text/test-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-support.js","sourceRoot":"","sources":["../../src/rich-text/test-support.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/runtime-renderer/client.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @elytracms/core/runtime-renderer/client — the two CLIENT-boundary modules, as a
+ * lean barrel (EC-201). Both depend on `react` alone, so importing the island
+ * surface from here (instead of the package index) keeps a downstream client
+ * bundle free of the server closure (rich-text, zod, the registry).
+ *
+ * Used by `@elytracms/next/client` to assemble the host's published client
+ * island entry; the `'use client'` directive here marks the boundary in source
+ * (the published `@elytracms/next` re-inserts it post-bundle — see that
+ * package's `tsup.config.ts`).
+ */
+export { ContentClientProvider, useContentClient, createFixtureContentClient, } from './content-client';
+export type { ContentClient, ContentDocumentView, ContentAssetView, ContentQuery, } from './content-client';
+export { RenderErrorBoundary, RenderErrorFallback } from './fallback';

package/dist/runtime-renderer/client.js

@@ -0,0 +1,15 @@
+'use client';
+/**
+ * @elytracms/core/runtime-renderer/client — the two CLIENT-boundary modules, as a
+ * lean barrel (EC-201). Both depend on `react` alone, so importing the island
+ * surface from here (instead of the package index) keeps a downstream client
+ * bundle free of the server closure (rich-text, zod, the registry).
+ *
+ * Used by `@elytracms/next/client` to assemble the host's published client
+ * island entry; the `'use client'` directive here marks the boundary in source
+ * (the published `@elytracms/next` re-inserts it post-bundle — see that
+ * package's `tsup.config.ts`).
+ */
+export { ContentClientProvider, useContentClient, createFixtureContentClient, } from './content-client';
+export { RenderErrorBoundary, RenderErrorFallback } from './fallback';
+//# sourceMappingURL=client.js.map

package/dist/runtime-renderer/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/runtime-renderer/client.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;;;GAUG;AAEH,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAA;AAQzB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA"}

package/dist/runtime-renderer/condition.d.ts

@@ -0,0 +1,8 @@
+import type { Condition } from '@elytracms/core/project-graph';
+import type { ItemContext, ResolveBinding } from './context';
+/**
+ * Evaluate a node's render condition. The left operand is resolved from the condition's
+ * binding source; the operator is applied against `condition.value`. A thrown resolver
+ * error is treated as a failed condition (node renders nothing) rather than a crash.
+ */
+export declare function evaluateCondition(condition: Condition, resolveBinding: ResolveBinding, item?: ItemContext): boolean;

package/dist/runtime-renderer/condition.js

@@ -0,0 +1,48 @@
+/**
+ * Evaluate a node's render condition. The left operand is resolved from the condition's
+ * binding source; the operator is applied against `condition.value`. A thrown resolver
+ * error is treated as a failed condition (node renders nothing) rather than a crash.
+ */
+export function evaluateCondition(condition, resolveBinding, item) {
+    let left;
+    try {
+        left = resolveBinding(condition.source, item);
+    }
+    catch {
+        return false;
+    }
+    switch (condition.operator) {
+        case 'truthy':
+            return Boolean(left);
+        case 'exists':
+            return left !== undefined && left !== null;
+        case 'eq':
+            return left === condition.value;
+        case 'neq':
+            return left !== condition.value;
+        case 'gt':
+            return compare(left, condition.value, (a, b) => a > b);
+        case 'gte':
+            return compare(left, condition.value, (a, b) => a >= b);
+        case 'lt':
+            return compare(left, condition.value, (a, b) => a < b);
+        case 'lte':
+            return compare(left, condition.value, (a, b) => a <= b);
+        default: {
+            // Exhaustiveness guard: unknown operators never render.
+            const _never = condition.operator;
+            return Boolean(_never);
+        }
+    }
+}
+/**
+ * Numeric ordering comparison. Ordering operators are numeric-only: a non-number operand yields
+ * `false`. This matches `@elytracms/core/data-binding`'s `resolveCondition`, so the canvas and the
+ * Builder's inspector/page-tree previews evaluate identically (one canonical model).
+ */
+function compare(left, right, op) {
+    if (typeof left !== 'number' || typeof right !== 'number')
+        return false;
+    return op(left, right);
+}
+//# sourceMappingURL=condition.js.map

package/dist/runtime-renderer/condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.js","sourceRoot":"","sources":["../../src/runtime-renderer/condition.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAoB,EACpB,cAA8B,EAC9B,IAAkB;IAElB,IAAI,IAAa,CAAA;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;IAED,QAAQ,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC3B,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;QACtB,KAAK,QAAQ;YACX,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAA;QAC5C,KAAK,IAAI;YACP,OAAO,IAAI,KAAK,SAAS,CAAC,KAAK,CAAA;QACjC,KAAK,KAAK;YACR,OAAO,IAAI,KAAK,SAAS,CAAC,KAAK,CAAA;QACjC,KAAK,IAAI;YACP,OAAO,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACxD,KAAK,KAAK;YACR,OAAO,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QACzD,KAAK,IAAI;YACP,OAAO,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACxD,KAAK,KAAK;YACR,OAAO,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QACzD,OAAO,CAAC,CAAC,CAAC;YACR,wDAAwD;YACxD,MAAM,MAAM,GAAU,SAAS,CAAC,QAAQ,CAAA;YACxC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAA;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,OAAO,CAAC,IAAa,EAAE,KAAc,EAAE,EAAqC;IACnF,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACvE,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AACxB,CAAC"}

package/dist/runtime-renderer/content-client.d.ts

@@ -0,0 +1,62 @@
+import type { ReactNode } from 'react';
+/**
+ * Read-only content access for self-fetching components (EC-191). With editor
+ * bindings gone (EC-190), dynamic data lives INSIDE dev components: a component
+ * reads what it needs from the injected client and renders it. The host provides a
+ * live client (Convex-backed), the studio a read client, tests a fixture-backed
+ * deterministic one — so the SAME component renders real data on the canvas, at
+ * delivery, and in tests (the AGENTS.md determinism rule).
+ *
+ * The client is **synchronous**: it reads already-loaded content (the host fetches
+ * for delivery, the studio pre-loads for preview, the test holds fixtures), which
+ * keeps render deterministic and Suspense-free. A component may ALSO fetch arbitrary
+ * external content through its own async hooks — the client is one source, not the
+ * only one.
+ */
+export interface ContentDocumentView {
+    collection: string;
+    id: string;
+    values: Record<string, unknown>;
+}
+/** A resolved asset (EC-191) — id plus delivery-shape url/alt when known. */
+export interface ContentAssetView {
+    id: string;
+    url?: string;
+    alt?: string;
+}
+/** A minimal list query (EC-191). Kept deliberately small for v1. */
+export interface ContentQuery {
+    collection: string;
+    /** Cap the number of returned documents. */
+    limit?: number;
+}
+/** The read-content contract injected into the render context (EC-191). */
+export interface ContentClient {
+    getDocument(collection: string, id: string): ContentDocumentView | undefined;
+    listDocuments(query: ContentQuery): ContentDocumentView[];
+    resolveAsset(id: string): ContentAssetView | undefined;
+}
+/**
+ * Provide a `ContentClient` to the rendered subtree. The renderer wraps its public
+ * composite entry points (page/composition) in this when `ctx.content` is set; a
+ * host rendering nodes directly can wrap manually.
+ */
+export declare function ContentClientProvider({ client, children, }: {
+    client: ContentClient;
+    children: ReactNode;
+}): ReactNode;
+/**
+ * Read the injected `ContentClient` inside a component implementation (EC-191).
+ * Returns `null` when none is provided (e.g. a pure-static render) — a self-fetching
+ * component must degrade visibly, never crash, when content access is absent.
+ */
+export declare function useContentClient(): ContentClient | null;
+/**
+ * A deterministic, in-memory `ContentClient` over fixed documents + assets (EC-191).
+ * The studio preview and tests use it so a self-fetching component renders the same
+ * content every time. `limit` is the only query knob in v1.
+ */
+export declare function createFixtureContentClient(fixtures: {
+    documents?: readonly ContentDocumentView[];
+    assets?: readonly ContentAssetView[];
+}): ContentClient;