@elytracms/core 0.0.6

package/dist/project-graph/validate.js

@@ -0,0 +1,158 @@
+import { isValidComponentId } from './ids';
+import { collectContainerIssues } from './container';
+function issue(code, severity, message, path, nodeId, meta) {
+    return { code, severity, message, path: [...path], ...(nodeId ? { nodeId } : {}), ...(meta ? { meta } : {}) };
+}
+function checkBinding(prop, opts, path, nodeId, issues) {
+    if (prop.kind !== 'binding')
+        return;
+    const { knownSourceIds } = opts;
+    if (knownSourceIds && !knownSourceIds.has(prop.binding.sourceId)) {
+        issues.push(issue('unresolved-binding', 'error', `Binding references unknown data source "${prop.binding.sourceId}".`, path, nodeId, { sourceId: prop.binding.sourceId }));
+    }
+}
+function walkNode(node, path, opts, seenIds, issues) {
+    // duplicate node id detection (graph-wide)
+    const prior = seenIds.get(node.id);
+    if (prior) {
+        issues.push(issue('duplicate-node-id', 'error', `Duplicate node id "${node.id}".`, path, node.id, {
+            firstSeenAt: [...prior],
+        }));
+    }
+    else {
+        seenIds.set(node.id, path);
+    }
+    // component name well-formedness
+    if (!isValidComponentId(node.componentId)) {
+        issues.push(issue('invalid-component-name', 'error', `Component id "${node.componentId}" is not namespaced under base.primitives.* or project.*.`, [...path, 'componentId'], node.id));
+    }
+    // Layout containers (EC-161): Stack/Grid canonical props (direction, gap,
+    // alignment, columns) are graph semantics — checked intrinsically, with or
+    // without a registry. Malformed values are explicit issues, never crashes.
+    issues.push(...collectContainerIssues(node, path));
+    const manifest = opts.components?.get(node.componentId);
+    if (opts.components && !manifest) {
+        issues.push(issue('unknown-component', 'error', `No registered component "${node.componentId}".`, path, node.id));
+    }
+    // Canvas-eligibility (EC-191): a server-only component cannot live in a
+    // client-rendered editor composition. Only enforced when requested.
+    if (opts.requireCanvasEligible && manifest && manifest.clientRenderable === false) {
+        issues.push(issue('server-only-component', 'error', `Component "${node.componentId}" is server-only (not client-renderable) and can't be placed in the canvas; use it in a dev frame (page.tsx / layout.tsx).`, path, node.id));
+    }
+    // condition source binding
+    if (node.condition && opts.knownSourceIds) {
+        const sid = node.condition.source.sourceId;
+        if (!opts.knownSourceIds.has(sid)) {
+            issues.push(issue('unresolved-binding', 'error', `Condition references unknown data source "${sid}".`, [...path, 'condition'], node.id, { sourceId: sid }));
+        }
+    }
+    // props
+    if (node.props) {
+        for (const [name, value] of Object.entries(node.props)) {
+            const propPath = [...path, 'props', name];
+            checkBinding(value, opts, propPath, node.id, issues);
+            if (manifest) {
+                const spec = manifest.props?.[name];
+                if (!spec) {
+                    issues.push(issue('unknown-prop', 'warning', `Unknown prop "${name}" on "${node.componentId}".`, propPath, node.id));
+                    continue;
+                }
+                if (value.kind === 'binding' && spec.bindable === false) {
+                    issues.push(issue('binding-not-allowed', 'error', `Prop "${name}" on "${node.componentId}" does not accept bindings.`, propPath, node.id));
+                }
+                if (value.kind === 'static' && spec.validate && !spec.validate(value.value)) {
+                    issues.push(issue('invalid-prop', 'error', `Invalid value for prop "${name}" on "${node.componentId}".`, propPath, node.id));
+                }
+            }
+        }
+    }
+    // slots
+    const slots = node.slots ?? {};
+    if (manifest) {
+        const declared = new Map((manifest.slots ?? []).map((s) => [s.name, s]));
+        for (const slot of manifest.slots ?? []) {
+            const children = slots[slot.name];
+            if (slot.required && (!children || children.length === 0)) {
+                issues.push(issue('missing-required-slot', 'error', `Missing required slot "${slot.name}" on "${node.componentId}".`, [...path, 'slots', slot.name], node.id));
+            }
+        }
+        for (const name of Object.keys(slots)) {
+            if (!declared.has(name)) {
+                issues.push(issue('unknown-slot', 'warning', `Unknown slot "${name}" on "${node.componentId}".`, [...path, 'slots', name], node.id));
+            }
+        }
+        // Slot placement vocabulary (EC-186): a slot's `allow` restricts which
+        // component ids may be inserted; a child outside the set is forbidden.
+        for (const slot of manifest.slots ?? []) {
+            const allow = slot.allow;
+            if (!allow || allow.length === 0)
+                continue;
+            const allowed = new Set(allow);
+            (slots[slot.name] ?? []).forEach((child, i) => {
+                if (!allowed.has(child.componentId)) {
+                    issues.push(issue('forbidden-component', 'error', `Component "${child.componentId}" is not allowed in slot "${slot.name}" of "${node.componentId}".`, [...path, 'slots', slot.name, i, 'componentId'], child.id, { slot: slot.name, allow: [...allow] }));
+                }
+            });
+        }
+    }
+    for (const [slotName, children] of Object.entries(slots)) {
+        children.forEach((child, i) => walkNode(child, [...path, 'slots', slotName, i], opts, seenIds, issues));
+    }
+}
+/** Validate a project graph, returning structured issues (never throws on a parsed graph). */
+export function validateProjectGraph(graph, opts = {}) {
+    const issues = [];
+    const seenIds = new Map();
+    // EC-187: the graph is LAYOUTS-ONLY — pages moved into the `page` collection
+    // (their `body` is a composition field value validated by
+    // `validateCompositionValue`). Layout-ref and route-conflict checks that used
+    // to walk `graph.pages` no longer apply here; route conflicts are detected by
+    // the CMS router (`createRouter`) over the `routes` collection.
+    graph.layouts.forEach((layout, i) => {
+        walkNode(layout.root, ['layouts', i, 'root'], opts, seenIds, issues);
+    });
+    return issues;
+}
+/**
+ * Validate a single component-node tree (EC-186, AD-12) — a composition **field
+ * value**, not a whole graph. Reuses the exact node-tree walk
+ * {@link validateProjectGraph} uses (component/prop/slot/container/binding rules
+ * + slot `allow` placement), but applies none of the graph-level invariants
+ * (layout refs, route conflicts). Node ids are checked for duplicates within
+ * this tree only.
+ */
+export function validateComponentNode(node, opts = {}) {
+    const issues = [];
+    walkNode(node, ['root'], opts, new Map(), issues);
+    return issues;
+}
+/**
+ * Validate a composition **field value** (EC-186, AD-12): one root node
+ * (`cardinality: 'one'`) or an ordered list (`'many'`). Each root is validated as
+ * a component-node tree; the field's `allow` restricts the top-level vocabulary;
+ * duplicate node ids are checked across the whole value. The registry + `allow`
+ * are code (the leash); the tree is data.
+ */
+export function validateCompositionValue(value, opts = {}) {
+    const roots = Array.isArray(value) ? value : [value];
+    const issues = [];
+    const seenIds = new Map();
+    const allowList = opts.allow ?? [];
+    const allowed = allowList.length > 0 ? new Set(allowList) : undefined;
+    // A composition value is edited + rendered on the client canvas (EC-191), so
+    // every node must be canvas-eligible — enforced regardless of the caller's opts.
+    const walkOpts = { ...opts, requireCanvasEligible: true };
+    roots.forEach((root, i) => {
+        const path = ['root', i];
+        if (allowed && !allowed.has(root.componentId)) {
+            issues.push(issue('forbidden-component', 'error', `Component "${root.componentId}" is not in this field's allowed vocabulary.`, [...path, 'componentId'], root.id, { allow: [...allowList] }));
+        }
+        walkNode(root, path, walkOpts, seenIds, issues);
+    });
+    return issues;
+}
+/** True if the graph has no error-severity issues. */
+export function isGraphValid(issues) {
+    return !issues.some((i) => i.severity === 'error');
+}
+//# sourceMappingURL=validate.js.map

package/dist/project-graph/validate.js.map

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

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

@@ -0,0 +1,43 @@
+import type { ReactElement } from 'react';
+import type { ParseRichTextResult, RichTextDoc, RichTextValue } from './schema';
+import type { RenderRichTextOptions, RichTextRenderIssue } from './render';
+import type { RichTextRegistry } from './registry';
+/**
+ * The project-owned rich-text adapter (brief §7.6, EC-025).
+ *
+ * This interface is the *only* surface consumers (CMS fields, the runtime
+ * renderer, export) should depend on. It hides which editor produced the storage
+ * JSON: the spike implements it over the directly-modelled ProseMirror format, and
+ * a real TipTap-backed adapter can implement the same interface later with no
+ * change to callers. Crucially, none of these methods require the editor bundle —
+ * read, render, and validate are all server-safe.
+ */
+export interface RichTextAdapter {
+    /** Schema version this adapter reads and writes. */
+    readonly version: number;
+    /** An empty but valid versioned value. */
+    empty(): RichTextValue;
+    /** Stamp a document tree with the current schema version. */
+    create(doc: RichTextDoc): RichTextValue;
+    /** Parse/validate stored JSON (string or object). Never throws. */
+    parse(input: string | unknown): ParseRichTextResult;
+    /** Serialize a value to canonical JSON. */
+    serialize(value: RichTextValue): string;
+    /** Whether a value's stored version matches this adapter. */
+    isCompatible(value: RichTextValue): boolean;
+    /** Server-safe read-only render of a value to a React element. */
+    render(value: RichTextValue, options?: RenderRichTextOptions): ReactElement;
+    /** Collect unknown-node issues without rendering (pre-flight validation). */
+    validate(value: RichTextValue): RichTextRenderIssue[];
+}
+export interface CreateAdapterOptions {
+    /** Custom block/inline renderers used by {@link RichTextAdapter.render}. */
+    registry?: RichTextRegistry;
+}
+/**
+ * Build the default, project-owned adapter over the modelled storage format.
+ *
+ * A future TipTap-backed adapter would satisfy the same {@link RichTextAdapter}
+ * interface — only its `render`/editor wiring would differ; storage stays identical.
+ */
+export declare function createRichTextAdapter(options?: CreateAdapterOptions): RichTextAdapter;

package/dist/rich-text/adapter.js

@@ -0,0 +1,24 @@
+import { RICH_TEXT_SCHEMA_VERSION, createRichTextValue, emptyRichTextValue, isCompatibleRichTextVersion, parseRichTextValue, serializeRichTextValue, } from './schema';
+import { renderRichTextValue } from './render';
+import { findUnknownNodes } from './render';
+import { emptyRichTextRegistry } from './registry';
+/**
+ * Build the default, project-owned adapter over the modelled storage format.
+ *
+ * A future TipTap-backed adapter would satisfy the same {@link RichTextAdapter}
+ * interface — only its `render`/editor wiring would differ; storage stays identical.
+ */
+export function createRichTextAdapter(options = {}) {
+    const registry = options.registry ?? emptyRichTextRegistry;
+    return {
+        version: RICH_TEXT_SCHEMA_VERSION,
+        empty: emptyRichTextValue,
+        create: createRichTextValue,
+        parse: parseRichTextValue,
+        serialize: serializeRichTextValue,
+        isCompatible: isCompatibleRichTextVersion,
+        render: (value, renderOptions = {}) => renderRichTextValue(value, { registry, ...renderOptions }),
+        validate: (value) => findUnknownNodes(value.doc, registry),
+    };
+}
+//# sourceMappingURL=adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/rich-text/adapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AA4ClD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAgC,EAAE;IACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,qBAAqB,CAAA;IAC1D,OAAO;QACL,OAAO,EAAE,wBAAwB;QACjC,KAAK,EAAE,kBAAkB;QACzB,MAAM,EAAE,mBAAmB;QAC3B,KAAK,EAAE,kBAAkB;QACzB,SAAS,EAAE,sBAAsB;QACjC,YAAY,EAAE,2BAA2B;QACzC,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,EAAE,EAAE,EAAE,CACpC,mBAAmB,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,aAAa,EAAE,CAAC;QAC5D,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC;KAC3D,CAAA;AACH,CAAC"}

package/dist/rich-text/dom-editor.d.ts

@@ -0,0 +1,101 @@
+import type { RichTextDoc, RichTextNode } from './schema';
+/**
+ * Inline-editing DOM bridge (EC-159).
+ *
+ * The canvas edits rich text by making the *read-only rendered element itself*
+ * contenteditable (the EC-158 approach — typography and layout are identical
+ * between render and edit states by construction). This module owns the two
+ * pure halves of that session:
+ *
+ * - **pairing** ({@link collectPreservedPairs}): before editing starts, walk
+ *   the storage tree and the rendered DOM in parallel (the renderer's mapping
+ *   is deterministic) and find every node that cannot be reconstructed from
+ *   markup — custom registry blocks/inlines, unknown nodes, images, embeds.
+ *   The host stamps those elements with {@link PRESERVE_NODE_ATTR} carrying
+ *   the node's exact JSON and `contenteditable=false`, so they render
+ *   correctly *inside* the live editor and survive the session byte-exact.
+ *
+ * - **parse-back** ({@link richTextDocFromDom}): after editing, invert the
+ *   renderer's markup (`render.tsx`) back into the storage tree. Stamped
+ *   elements restore their original node verbatim; everything else maps
+ *   structurally (p/h1..h6/ul/ol/li/blockquote/pre/br/hr + the built-in mark
+ *   tags). Never throws.
+ *
+ * Both halves work against minimal structural DOM interfaces so they are
+ * unit-testable in a Node environment (this workspace has no DOM test env);
+ * real `Element`/`Text` nodes satisfy them in the browser.
+ *
+ * Storage-format integrity: an untouched session must leave the stored value
+ * byte-identical. The session guarantees that by *comparing*, not rewriting:
+ * {@link richTextDocsEquivalent} checks the parsed-back tree against the
+ * original (normalizing only DOM-induced text-run splits), and an equivalent
+ * tree commits nothing — the stored bytes are never replaced by a re-serialization.
+ */
+/** Attribute carrying a preserved node's exact storage JSON during a session. */
+export declare const PRESERVE_NODE_ATTR = "data-ec-rt-preserve";
+export declare const RT_ELEMENT_NODE = 1;
+export declare const RT_TEXT_NODE = 3;
+export interface RtDomText {
+    readonly nodeType: number;
+    /** CharacterData.data — the exact text content. */
+    readonly data: string;
+}
+export interface RtDomElement {
+    readonly nodeType: number;
+    /** Uppercase in HTML documents; compared case-insensitively here. */
+    readonly tagName: string;
+    readonly childNodes: ArrayLike<RtDomNode>;
+    getAttribute(name: string): string | null;
+}
+export type RtDomNode = RtDomText | RtDomElement;
+export declare function isRtElement(node: RtDomNode): node is RtDomElement;
+export declare function isRtText(node: RtDomNode): node is RtDomText;
+/**
+ * Whether a storage node type can be reconstructed from rendered markup.
+ * Images, embeds, custom registry nodes, and unknown nodes are *not* — they
+ * must be preserved verbatim during an editing session (atoms, not markup).
+ */
+export declare function isInvertibleRichTextNodeType(type: string): boolean;
+/** A non-invertible storage node paired with the element that renders it. */
+export interface PreservedPair {
+    node: RichTextNode;
+    element: RtDomElement;
+}
+/**
+ * Walk a document tree and its rendered DOM in parallel and return every
+ * non-invertible node paired with its element, so the host can stamp them
+ * before the DOM becomes editable. Returns `null` when the DOM does not match
+ * the renderer's deterministic mapping (the session should then refuse to
+ * start rather than risk lossy parsing).
+ */
+export declare function collectPreservedPairs(doc: RichTextDoc, host: RtDomElement): PreservedPair[] | null;
+/** A structured problem found while parsing edited DOM back to storage. */
+export interface DomParseIssue {
+    code: 'lossy-node';
+    message: string;
+    /** The tag or unknown-node type that could not be fully reconstructed. */
+    detail: string;
+}
+export interface DomToDocResult {
+    doc: RichTextDoc;
+    issues: DomParseIssue[];
+}
+/**
+ * Parse an editing host's DOM back into a storage document. Never throws;
+ * anything that could not be fully reconstructed is reported as an issue (and
+ * still yields a visible node, never silent loss).
+ */
+export declare function richTextDocFromDom(host: RtDomElement): DomToDocResult;
+/**
+ * Normalize a tree for comparison only (never for storage): merge adjacent
+ * text nodes carrying identical marks and drop empty text nodes — the splits
+ * and joins a contenteditable session performs without changing content.
+ */
+export declare function normalizeForComparison(nodes: readonly RichTextNode[]): RichTextNode[];
+/**
+ * Whether two documents carry the same content, ignoring object key order and
+ * DOM-induced text-run splits. An equivalent parse-back means the editing
+ * session changed nothing and must not dispatch — leaving the stored value
+ * byte-identical (it is never rewritten).
+ */
+export declare function richTextDocsEquivalent(a: RichTextDoc, b: RichTextDoc): boolean;