@elytracms/core 0.0.6

package/dist/rich-text/dom-editor.js

@@ -0,0 +1,482 @@
+/**
+ * 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 const PRESERVE_NODE_ATTR = 'data-ec-rt-preserve';
+// ---------------------------------------------------------------------------
+// Structural DOM slice (real DOM nodes satisfy these).
+// ---------------------------------------------------------------------------
+export const RT_ELEMENT_NODE = 1;
+export const RT_TEXT_NODE = 3;
+export function isRtElement(node) {
+    return node.nodeType === RT_ELEMENT_NODE;
+}
+export function isRtText(node) {
+    return node.nodeType === RT_TEXT_NODE;
+}
+function children(node) {
+    const out = [];
+    for (let i = 0; i < node.childNodes.length; i++)
+        out.push(node.childNodes[i]);
+    return out;
+}
+function tag(el) {
+    return el.tagName.toLowerCase();
+}
+// ---------------------------------------------------------------------------
+// Invertibility: which storage node types the markup parser can reconstruct.
+// ---------------------------------------------------------------------------
+const INVERTIBLE_NODE_TYPES = new Set([
+    'doc',
+    'text',
+    'paragraph',
+    'heading',
+    'bulletList',
+    'orderedList',
+    'listItem',
+    'blockquote',
+    'codeBlock',
+    'hardBreak',
+    'horizontalRule',
+]);
+/**
+ * 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 function isInvertibleRichTextNodeType(type) {
+    return INVERTIBLE_NODE_TYPES.has(type);
+}
+/**
+ * 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 function collectPreservedPairs(doc, host) {
+    const pairs = [];
+    return pairChildren(doc.content ?? [], children(host), pairs) ? pairs : null;
+}
+/** Pair an ordered storage child list against an ordered DOM child list. */
+function pairChildren(nodes, dom, out) {
+    if (nodes.length !== dom.length)
+        return false;
+    for (let i = 0; i < nodes.length; i++) {
+        if (!pairNode(nodes[i], dom[i], out))
+            return false;
+    }
+    return true;
+}
+function pairNode(node, dom, out) {
+    if (node.type === 'text') {
+        // Renders as a bare text node, or as a chain of mark wrappers around one.
+        return pairTextNode(node, dom);
+    }
+    if (!isRtElement(dom))
+        return false;
+    if (!isInvertibleRichTextNodeType(node.type)) {
+        out.push({ node, element: dom });
+        return true;
+    }
+    switch (node.type) {
+        case 'paragraph':
+        case 'heading':
+        case 'bulletList':
+        case 'orderedList':
+        case 'listItem':
+        case 'blockquote':
+            return pairChildren(node.content ?? [], children(dom), out);
+        case 'codeBlock': {
+            // pre > code > text — nothing preservable inside a code block.
+            return tag(dom) === 'pre';
+        }
+        case 'hardBreak':
+            return tag(dom) === 'br';
+        case 'horizontalRule':
+            return tag(dom) === 'hr';
+        default:
+            return true;
+    }
+}
+/** A text node renders as marks-nested wrappers ending in exactly one text node. */
+function pairTextNode(node, dom) {
+    let current = dom;
+    let depth = 0;
+    const markCount = node.marks?.length ?? 0;
+    while (isRtElement(current)) {
+        const kids = children(current);
+        if (kids.length !== 1)
+            return false;
+        current = kids[0];
+        depth++;
+        if (depth > markCount + 4)
+            return false;
+    }
+    return isRtText(current) && current.data === (node.text ?? '');
+}
+const HEADING_LEVELS = { h1: 1, h2: 2, h3: 3, h4: 4, h5: 5, h6: 6 };
+const MARK_BY_TAG = {
+    strong: 'bold',
+    b: 'bold',
+    em: 'italic',
+    i: 'italic',
+    code: 'code',
+    s: 'strike',
+    strike: 'strike',
+    del: 'strike',
+    u: 'underline',
+};
+const BLOCK_TAGS = new Set([
+    'p',
+    'h1',
+    'h2',
+    'h3',
+    'h4',
+    'h5',
+    'h6',
+    'ul',
+    'ol',
+    'li',
+    'blockquote',
+    'pre',
+    'hr',
+    'div',
+    'section',
+    'article',
+    'aside',
+    'figure',
+]);
+/** Restore a stamped element's original storage node ({@link PRESERVE_NODE_ATTR}). */
+function preservedNodeOf(el) {
+    const raw = el.getAttribute(PRESERVE_NODE_ATTR);
+    if (raw === null)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed === 'object' && parsed !== null && typeof parsed.type === 'string') {
+            return parsed;
+        }
+    }
+    catch {
+        // fall through to lossy handling
+    }
+    return null;
+}
+function textNodeOf(text, marks) {
+    return marks.length > 0 ? { type: 'text', text, marks: [...marks] } : { type: 'text', text };
+}
+/** Parse inline content. `outerMarks` is ordered outermost→innermost. */
+function parseInline(nodes, outerMarks, ctx) {
+    const out = [];
+    for (const node of nodes) {
+        if (isRtText(node)) {
+            if (node.data.length > 0) {
+                // `outerMarks` is built by prepending on descent, so it already sits in
+                // storage order: innermost-first (render wraps marks[0] innermost).
+                out.push(textNodeOf(node.data, outerMarks));
+            }
+            continue;
+        }
+        if (!isRtElement(node))
+            continue;
+        const preserved = preservedNodeOf(node);
+        if (preserved) {
+            out.push(preserved);
+            continue;
+        }
+        const t = tag(node);
+        if (t === 'br') {
+            out.push({ type: 'hardBreak' });
+            continue;
+        }
+        if (t === 'img') {
+            out.push(imageNodeOf(node));
+            continue;
+        }
+        const mark = inlineMarkOf(node, ctx);
+        if (mark) {
+            out.push(...parseInline(children(node), [mark, ...outerMarks], ctx));
+            continue;
+        }
+        // Unknown inline wrapper (e.g. an editor-inserted span): descend transparently.
+        out.push(...parseInline(children(node), outerMarks, ctx));
+    }
+    return out;
+}
+/** The mark an inline wrapper element represents, if any. */
+function inlineMarkOf(el, ctx) {
+    const t = tag(el);
+    const builtin = MARK_BY_TAG[t];
+    if (builtin)
+        return { type: builtin };
+    if (t === 'a') {
+        const attrs = { href: el.getAttribute('href') ?? '#' };
+        const target = el.getAttribute('target');
+        if (target)
+            attrs.target = target;
+        const rel = el.getAttribute('rel');
+        // The renderer synthesizes rel="noopener noreferrer" for target=_blank; do
+        // not read that synthesis back into storage attrs.
+        if (rel && !(target === '_blank' && rel === 'noopener noreferrer'))
+            attrs.rel = rel;
+        return { type: 'link', attrs };
+    }
+    const unknownMark = el.getAttribute('data-unknown-mark');
+    if (unknownMark) {
+        ctx.issues.push({
+            code: 'lossy-node',
+            message: `Unknown mark "${unknownMark}" was reconstructed without its attributes.`,
+            detail: unknownMark,
+        });
+        return { type: unknownMark };
+    }
+    return null;
+}
+function imageNodeOf(el) {
+    const attrs = {
+        src: el.getAttribute('src') ?? '',
+        alt: el.getAttribute('alt') ?? '',
+    };
+    const title = el.getAttribute('title');
+    if (title)
+        attrs.title = title;
+    return { type: 'image', attrs };
+}
+function embedNodeOf(el) {
+    const attrs = {
+        src: el.getAttribute('src') ?? '',
+        title: el.getAttribute('title') ?? 'Embedded content',
+    };
+    const provider = el.getAttribute('data-embed-provider');
+    if (provider)
+        attrs.provider = provider;
+    return { type: 'embed', attrs };
+}
+/** Whether a DOM child list contains block-level elements. */
+function hasBlockChildren(nodes) {
+    return nodes.some((n) => isRtElement(n) && BLOCK_TAGS.has(tag(n)));
+}
+function parseBlocks(nodes, ctx) {
+    const out = [];
+    let looseInline = [];
+    const flushLoose = () => {
+        if (looseInline.length === 0)
+            return;
+        const inline = parseInline(looseInline, [], ctx);
+        looseInline = [];
+        if (inline.some((n) => n.type !== 'text' || (n.text ?? '').trim().length > 0)) {
+            out.push({ type: 'paragraph', content: inline });
+        }
+    };
+    for (const node of nodes) {
+        if (isRtText(node)) {
+            looseInline.push(node);
+            continue;
+        }
+        if (!isRtElement(node))
+            continue;
+        const preserved = preservedNodeOf(node);
+        if (preserved) {
+            flushLoose();
+            out.push(preserved);
+            continue;
+        }
+        const t = tag(node);
+        const block = parseBlockElement(node, t, ctx);
+        if (block === 'inline') {
+            looseInline.push(node);
+            continue;
+        }
+        flushLoose();
+        if (block !== null)
+            out.push(...block);
+    }
+    flushLoose();
+    return out;
+}
+/**
+ * Parse one block-level element. Returns the storage nodes it maps to, `null`
+ * to drop it, or `'inline'` when the element belongs to inline flow.
+ */
+function parseBlockElement(el, t, ctx) {
+    const level = HEADING_LEVELS[t];
+    if (level !== undefined) {
+        return [{ type: 'heading', attrs: { level }, content: parseInline(children(el), [], ctx) }];
+    }
+    switch (t) {
+        case 'p':
+            return [{ type: 'paragraph', content: parseInline(children(el), [], ctx) }];
+        case 'ul':
+            return [{ type: 'bulletList', content: parseListItems(el, ctx) }];
+        case 'ol':
+            return [{ type: 'orderedList', content: parseListItems(el, ctx) }];
+        case 'blockquote':
+            return [{ type: 'blockquote', content: parseBlocks(children(el), ctx) }];
+        case 'pre':
+            return [parseCodeBlock(el)];
+        case 'hr':
+            return [{ type: 'horizontalRule' }];
+        case 'img':
+            return [imageNodeOf(el)];
+        case 'iframe':
+            return [embedNodeOf(el)];
+        case 'br':
+            return [{ type: 'paragraph', content: [{ type: 'hardBreak' }] }];
+        case 'style':
+            return null;
+        default: {
+            const unknownType = el.getAttribute('data-unknown-node');
+            if (unknownType) {
+                // An unknown-node fallback that was not stamped: keep the type visible,
+                // but its attrs/content cannot be reconstructed from the fallback text.
+                ctx.issues.push({
+                    code: 'lossy-node',
+                    message: `Unknown rich-text node "${unknownType}" was reconstructed without its attributes.`,
+                    detail: unknownType,
+                });
+                return [{ type: unknownType }];
+            }
+            if (!BLOCK_TAGS.has(t))
+                return 'inline';
+            // Editor-inserted generic containers (e.g. Chrome's contenteditable
+            // `<div>` lines): blocks descend, inline runs become a paragraph.
+            const kids = children(el);
+            if (hasBlockChildren(kids))
+                return parseBlocks(kids, ctx);
+            return [{ type: 'paragraph', content: parseInline(kids, [], ctx) }];
+        }
+    }
+}
+function parseListItems(list, ctx) {
+    const items = [];
+    for (const node of children(list)) {
+        if (!isRtElement(node))
+            continue;
+        if (tag(node) !== 'li')
+            continue;
+        const kids = children(node);
+        const content = hasBlockChildren(kids)
+            ? parseBlocks(kids, ctx)
+            : [{ type: 'paragraph', content: parseInline(kids, [], ctx) }];
+        items.push({ type: 'listItem', content: content.length > 0 ? content : [{ type: 'paragraph', content: [] }] });
+    }
+    return items;
+}
+function parseCodeBlock(pre) {
+    // pre > optional code wrapper > text. Language from `language-*` className.
+    let host = pre;
+    const kids = children(pre);
+    const codeEl = kids.find((n) => isRtElement(n) && tag(n) === 'code');
+    if (codeEl)
+        host = codeEl;
+    const language = (host.getAttribute('class') ?? '').match(/language-([\w-]+)/)?.[1];
+    const text = collectText(host);
+    return {
+        type: 'codeBlock',
+        ...(language ? { attrs: { language } } : {}),
+        content: text.length > 0 ? [{ type: 'text', text }] : [],
+    };
+}
+function collectText(el) {
+    let out = '';
+    for (const node of children(el)) {
+        if (isRtText(node))
+            out += node.data;
+        else if (isRtElement(node))
+            out += tag(node) === 'br' ? '\n' : collectText(node);
+    }
+    return out;
+}
+/**
+ * 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 function richTextDocFromDom(host) {
+    const ctx = { issues: [] };
+    const content = parseBlocks(children(host), ctx);
+    return { doc: { type: 'doc', content }, issues: ctx.issues };
+}
+// ---------------------------------------------------------------------------
+// Equivalence: did the session actually change the document?
+// ---------------------------------------------------------------------------
+function sameMarks(a, b) {
+    return canonicalJson(a ?? []) === canonicalJson(b ?? []);
+}
+/**
+ * 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 function normalizeForComparison(nodes) {
+    const out = [];
+    for (const node of nodes) {
+        const normalized = node.content
+            ? { ...node, content: normalizeForComparison(node.content) }
+            : { ...node };
+        if (normalized.type === 'text') {
+            if ((normalized.text ?? '') === '')
+                continue;
+            const prev = out[out.length - 1];
+            if (prev && prev.type === 'text' && sameMarks(prev.marks, normalized.marks)) {
+                out[out.length - 1] = { ...prev, text: (prev.text ?? '') + (normalized.text ?? '') };
+                continue;
+            }
+        }
+        out.push(normalized);
+    }
+    return out;
+}
+/** Key-order-insensitive canonical JSON (object keys sorted recursively). */
+function canonicalJson(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value) ?? 'null';
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(',')}]`;
+    const entries = Object.entries(value)
+        .filter(([, v]) => v !== undefined)
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+        .map(([k, v]) => `${JSON.stringify(k)}:${canonicalJson(v)}`);
+    return `{${entries.join(',')}}`;
+}
+/**
+ * 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 function richTextDocsEquivalent(a, b) {
+    return (canonicalJson({ type: 'doc', content: normalizeForComparison(a.content ?? []) }) ===
+        canonicalJson({ type: 'doc', content: normalizeForComparison(b.content ?? []) }));
+}
+//# sourceMappingURL=dom-editor.js.map

package/dist/rich-text/dom-editor.js.map

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

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

@@ -0,0 +1,70 @@
+import type { ComponentNode } from '@elytracms/core/project-graph';
+import type { JsonValue } from '@elytracms/core/project-graph';
+import type { RichTextDoc, RichTextNode } from './schema';
+/**
+ * Rich-text component embeds (EC-189, AD-12).
+ *
+ * A `componentEmbed` is a custom *block* node in the rich-text storage format
+ * whose single `attrs.node` holds a composition value — one `ComponentNode` (an
+ * embedded registry component plus its static field-value props). It is the third
+ * place constrained composition lives (after the page collection and `blocks`
+ * fields): a registry component embedded in long-form prose, Portable-Text-style.
+ *
+ * The embed serializes through the EXISTING storage format with no schema change:
+ * `richTextNodeSchema` keeps `type` an open string and `attrs` a plain-JSON bag, a
+ * `ComponentNode` is plain JSON (Zod-validated, no runtime handles), so an embed
+ * round-trips byte-for-byte through `parseRichTextValue`/`serializeRichTextValue`.
+ * The helpers below give the embed a named type, a typed accessor, and a
+ * constructor so consumers (renderer, extractor, validator) never reach into the
+ * raw `attrs` bag. An embed whose `attrs.node` is missing or malformed degrades to
+ * the renderer's visible fallback — never a crash, never silent (AGENTS.md).
+ */
+/** The storage `node.type` for an embedded registry component. */
+export declare const COMPONENT_EMBED_NODE_TYPE = "componentEmbed";
+/**
+ * A rich-text embed node, narrowed: a `componentEmbed` whose `attrs.node` is the
+ * embedded composition value. `attrs.node` is typed `JsonValue` at the storage
+ * layer (the format never carries runtime handles); read it through
+ * {@link embeddedComponentNode}, which validates it as a `ComponentNode`.
+ */
+export interface ComponentEmbedNode extends RichTextNode {
+    type: typeof COMPONENT_EMBED_NODE_TYPE;
+    attrs?: {
+        node?: JsonValue;
+    } & Record<string, JsonValue>;
+}
+/** Structural test for a `componentEmbed` node (by `node.type`). */
+export declare function isComponentEmbedNode(node: RichTextNode): node is ComponentEmbedNode;
+/**
+ * Read the embedded composition value (a single `ComponentNode`) from a
+ * `componentEmbed` node, validating it via `componentNodeSchema`. Returns
+ * `undefined` for an embed with no/malformed `attrs.node` (the renderer shows its
+ * visible fallback; validation reports the structured issue). Never throws.
+ */
+export declare function embeddedComponentNode(node: RichTextNode): ComponentNode | undefined;
+/**
+ * Build a `componentEmbed` storage node wrapping a single composition root. The
+ * node carries no `content` (an embed is an atom — the embedded component owns its
+ * own children through the composition's slots, not the rich-text tree).
+ */
+export declare function componentEmbedNode(node: ComponentNode): ComponentEmbedNode;
+/**
+ * One `componentEmbed` occurrence found while walking a rich-text document: the
+ * raw storage node, the embedded composition value (or `undefined` when malformed),
+ * and the `/`-joined content-index node path within the document tree (e.g.
+ * `doc/content/2`). The path mirrors the reference-extraction encoding so validation
+ * findings and where-used entries key the same location. Walks arbitrary depth.
+ */
+export interface RichTextEmbedOccurrence {
+    node: ComponentEmbedNode;
+    embedded: ComponentNode | undefined;
+    nodePath: string;
+}
+/**
+ * Collect every `componentEmbed` in a rich-text document, at any nesting depth.
+ * Pure + structural; never throws. The returned `nodePath` is `doc`-rooted and
+ * `/`-joined (`doc/content/<i>/content/<j>/...`), matching the persistence
+ * reference-extraction path convention so a validation finding's `nodePath` lines
+ * up with the where-used entry for the same embed.
+ */
+export declare function collectComponentEmbeds(doc: RichTextDoc): RichTextEmbedOccurrence[];

package/dist/rich-text/embed.js

@@ -0,0 +1,70 @@
+import { componentNodeSchema } from '@elytracms/core/project-graph';
+/**
+ * Rich-text component embeds (EC-189, AD-12).
+ *
+ * A `componentEmbed` is a custom *block* node in the rich-text storage format
+ * whose single `attrs.node` holds a composition value — one `ComponentNode` (an
+ * embedded registry component plus its static field-value props). It is the third
+ * place constrained composition lives (after the page collection and `blocks`
+ * fields): a registry component embedded in long-form prose, Portable-Text-style.
+ *
+ * The embed serializes through the EXISTING storage format with no schema change:
+ * `richTextNodeSchema` keeps `type` an open string and `attrs` a plain-JSON bag, a
+ * `ComponentNode` is plain JSON (Zod-validated, no runtime handles), so an embed
+ * round-trips byte-for-byte through `parseRichTextValue`/`serializeRichTextValue`.
+ * The helpers below give the embed a named type, a typed accessor, and a
+ * constructor so consumers (renderer, extractor, validator) never reach into the
+ * raw `attrs` bag. An embed whose `attrs.node` is missing or malformed degrades to
+ * the renderer's visible fallback — never a crash, never silent (AGENTS.md).
+ */
+/** The storage `node.type` for an embedded registry component. */
+export const COMPONENT_EMBED_NODE_TYPE = 'componentEmbed';
+/** Structural test for a `componentEmbed` node (by `node.type`). */
+export function isComponentEmbedNode(node) {
+    return node.type === COMPONENT_EMBED_NODE_TYPE;
+}
+/**
+ * Read the embedded composition value (a single `ComponentNode`) from a
+ * `componentEmbed` node, validating it via `componentNodeSchema`. Returns
+ * `undefined` for an embed with no/malformed `attrs.node` (the renderer shows its
+ * visible fallback; validation reports the structured issue). Never throws.
+ */
+export function embeddedComponentNode(node) {
+    if (!isComponentEmbedNode(node))
+        return undefined;
+    const raw = node.attrs?.node;
+    const parsed = componentNodeSchema.safeParse(raw);
+    return parsed.success ? parsed.data : undefined;
+}
+/**
+ * Build a `componentEmbed` storage node wrapping a single composition root. The
+ * node carries no `content` (an embed is an atom — the embedded component owns its
+ * own children through the composition's slots, not the rich-text tree).
+ */
+export function componentEmbedNode(node) {
+    return { type: COMPONENT_EMBED_NODE_TYPE, attrs: { node: node } };
+}
+/**
+ * Collect every `componentEmbed` in a rich-text document, at any nesting depth.
+ * Pure + structural; never throws. The returned `nodePath` is `doc`-rooted and
+ * `/`-joined (`doc/content/<i>/content/<j>/...`), matching the persistence
+ * reference-extraction path convention so a validation finding's `nodePath` lines
+ * up with the where-used entry for the same embed.
+ */
+export function collectComponentEmbeds(doc) {
+    const out = [];
+    const walk = (nodes, path) => {
+        if (!nodes)
+            return;
+        nodes.forEach((node, i) => {
+            const here = `${path}/content/${i}`;
+            if (isComponentEmbedNode(node)) {
+                out.push({ node, embedded: embeddedComponentNode(node), nodePath: here });
+            }
+            walk(node.content, here);
+        });
+    };
+    walk(doc.content, 'doc');
+    return out;
+}
+//# sourceMappingURL=embed.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../../src/rich-text/embed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAKnE;;;;;;;;;;;;;;;;;GAiBG;AAEH,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAA;AAazD,oEAAoE;AACpE,MAAM,UAAU,oBAAoB,CAAC,IAAkB;IACrD,OAAO,IAAI,CAAC,IAAI,KAAK,yBAAyB,CAAA;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAkB;IACtD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAA;IAC5B,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IACjD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAmB;IACpD,OAAO,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAA4B,EAAE,EAAE,CAAA;AAC3F,CAAC;AAeD;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAgB;IACrD,MAAM,GAAG,GAA8B,EAAE,CAAA;IACzC,MAAM,IAAI,GAAG,CAAC,KAA0C,EAAE,IAAY,EAAQ,EAAE;QAC9E,IAAI,CAAC,KAAK;YAAE,OAAM;QAClB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACxB,MAAM,IAAI,GAAG,GAAG,IAAI,YAAY,CAAC,EAAE,CAAA;YACnC,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,qBAAqB,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;YAC3E,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAC1B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IACD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACxB,OAAO,GAAG,CAAA;AACZ,CAAC"}