@caretcms/core 0.1.1 → 0.2.0

package/dist/markdown/satteri.js

@@ -0,0 +1,120 @@
+/**
+ * Sätteri mdast plugin that stamps `data-caret-md` bindings (Astro 7).
+ *
+ * Registered on `markdown.processor.options.mdastPlugins` by the integration
+ * when markdown storage is active. Position tracking is opt-in, so the plugin
+ * declares `options: { position: true }`. Attributes are written through the
+ * per-node `data.hProperties` bag, which Sätteri carries into the rendered
+ * HTML like remark-rehype.
+ *
+ * Type-only imports keep core free of a `satteri` runtime dependency — the
+ * package is present in the user's Astro build, never shipped by us.
+ */
+import { computeStamp, planParagraph } from "./stamp.js";
+// Sätteri (Rust / pulldown-cmark) reports positions as UTF-8 BYTE offsets,
+// while our contracts, hashing, and the server-side splice all work in JS
+// string (UTF-16 code unit) space. Convert once per document. Memoized because
+// a document's blocks are visited consecutively against the same `ctx.source`.
+let byteMapCache = null;
+function byteToStringIndex(source, byteOffset) {
+    if (!byteMapCache || byteMapCache.source !== source) {
+        const prefix = new Uint32Array(source.length + 1);
+        let bytes = 0;
+        for (let i = 0; i < source.length;) {
+            const cp = source.codePointAt(i);
+            const units = cp > 0xffff ? 2 : 1;
+            prefix[i] = bytes;
+            if (units === 2)
+                prefix[i + 1] = bytes; // low surrogate: mid-char
+            bytes += cp < 0x80 ? 1 : cp < 0x800 ? 2 : cp < 0x10000 ? 3 : 4;
+            i += units;
+        }
+        prefix[source.length] = bytes;
+        byteMapCache = { source, prefix };
+    }
+    const { prefix } = byteMapCache;
+    // Smallest string index whose byte-prefix reaches byteOffset.
+    let lo = 0;
+    let hi = source.length;
+    while (lo < hi) {
+        const mid = (lo + hi) >> 1;
+        if (prefix[mid] < byteOffset)
+            lo = mid + 1;
+        else
+            hi = mid;
+    }
+    return lo;
+}
+/** Root-to-node child indexes (`indexOf` returns `undefined` at the root). */
+function pathOf(node, ctx) {
+    const idx = [];
+    let cur = node;
+    while (cur) {
+        const i = ctx.indexOf(cur);
+        if (i === undefined)
+            break;
+        idx.unshift(i);
+        cur = ctx.parent(cur);
+    }
+    return idx;
+}
+/** Ancestor node types, nearest-first, excluding the node itself. */
+function ancestorTypes(node, ctx) {
+    const out = [];
+    let cur = ctx.parent(node);
+    while (cur) {
+        out.push(cur.type);
+        cur = ctx.parent(cur);
+    }
+    return out;
+}
+function stamp(target, ctx, input) {
+    const attrs = computeStamp(input);
+    if (!attrs)
+        return;
+    const data = { ...(target.data ?? {}) };
+    data.hProperties = { ...data.hProperties, ...attrs };
+    ctx.setProperty(target, "data", data);
+}
+export function caretSatteriPlugin(options) {
+    const { contentRoot } = options;
+    const base = (node, ctx) => {
+        const startByte = node.position?.start?.offset;
+        const endByte = node.position?.end?.offset;
+        return {
+            source: ctx.source,
+            fileURL: ctx.fileURL,
+            contentRoot,
+            start: startByte == null ? undefined : byteToStringIndex(ctx.source, startByte),
+            end: endByte == null ? undefined : byteToStringIndex(ctx.source, endByte),
+        };
+    };
+    return {
+        name: "caretcms-stamp",
+        options: { position: true },
+        heading(node, ctx) {
+            const parentType = ctx.parent(node)?.type ?? "root";
+            stamp(node, ctx, {
+                ...base(node, ctx),
+                blockPath: pathOf(node, ctx),
+                ancestorTypes: ancestorTypes(node, ctx),
+                nested: parentType !== "root",
+                blockType: "heading",
+            });
+        },
+        paragraph(node, ctx) {
+            const parent = ctx.parent(node);
+            const plan = planParagraph(parent?.type ?? "root", ctx.indexOf(node));
+            if (plan.action === "skip")
+                return;
+            const target = plan.action === "parent" ? parent : node;
+            stamp(target, ctx, {
+                ...base(node, ctx), // the paragraph's (marker-free) offsets
+                blockPath: pathOf(target, ctx),
+                ancestorTypes: ancestorTypes(target, ctx),
+                nested: plan.action === "parent" ? true : plan.nested,
+            });
+        },
+    };
+}
+//# sourceMappingURL=satteri.js.map

package/dist/markdown/satteri.js.map

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

package/dist/markdown/serialize.d.ts

@@ -0,0 +1,60 @@
+/**
+ * DOM-free markdown block serializer.
+ *
+ * Turns the inline content of ONE editable block into markdown source. The
+ * closed set is deliberately tiny — text, `strong`/`b`, `em`/`i`, `a[href]`,
+ * `code`, `br` — so serialization is a small, total, reversible function
+ * rather than a general HTML→markdown converter. Anything outside the set is a
+ * hard error: the browser sanitizes to this set before serializing, so a throw
+ * means a bug or an attack, never normal input.
+ *
+ * Pure and DOM-free by design: it operates on a minimal {@link SNode} tree so
+ * it can be property-tested in Node without a DOM, and the browser editor
+ * (`static/cms/editor/md-serialize.js`) supplies a matching tree from real DOM
+ * nodes. A parity test holds the two implementations to identical output.
+ *
+ * Known limitations (CommonMark/GFM constraints, not corruption — text is
+ * always preserved; only emphasis boundaries or auto-linking may shift):
+ *  - Abutting emphasis whose first span ends in punctuation and is followed by
+ *    a word char: asterisks fuse, underscore can't close (see `emphasisMarker`).
+ *  - Emphasis that starts with punctuation-leading content (e.g. a link) while
+ *    immediately preceded by a word char: the opening `*`/`_` is not
+ *    left-flanking, so the emphasis can't open. Unrepresentable in CommonMark.
+ *  - A bare email/URL in plain text (`a@b.com`, `www.x.com`) is auto-linked by
+ *    GFM on render; a second edit then serializes it as an explicit link.
+ *  - Links normalize to untitled inline form: editing a block rewrites
+ *    reference-style links (`[x][1]`) as inline links and drops link titles
+ *    (`"…"`) — text and destination are preserved, the definition lines
+ *    elsewhere in the document are untouched. Title support needs `title` in
+ *    the shared rich allowlist (v0.4 candidate).
+ * The editor doesn't produce these from normal selection-based formatting, so
+ * they are documented rather than special-cased.
+ */
+/** A minimal, DOM-independent representation of inline content. */
+export type SNode = {
+    type: "text";
+    value: string;
+} | {
+    type: "element";
+    tag: string;
+    attrs: Record<string, string>;
+    children: SNode[];
+};
+/** Which block wraps the inline content — determines markers and break rules. */
+export type BlockContext = {
+    block: "heading";
+    level: number;
+} | {
+    block: "paragraph";
+    nested: boolean;
+};
+/** Thrown when the tree contains anything outside the closed inline set. */
+export declare class SerializeError extends Error {
+    constructor(message: string);
+}
+/**
+ * Serialize the inline children of one block to markdown source, ready to
+ * splice into the block's source range.
+ */
+export declare function serializeBlock(children: readonly SNode[], ctx: BlockContext): string;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/markdown/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/markdown/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,mEAAmE;AACnE,MAAM,MAAM,KAAK,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,KAAK,EAAE,CAAA;CAAE,CAAC;AAEvF,iFAAiF;AACjF,MAAM,MAAM,YAAY,GACpB;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5C,4EAA4E;AAC5E,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AA6ND;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,KAAK,EAAE,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAepF"}

package/dist/markdown/serialize.js

@@ -0,0 +1,264 @@
+/**
+ * DOM-free markdown block serializer.
+ *
+ * Turns the inline content of ONE editable block into markdown source. The
+ * closed set is deliberately tiny — text, `strong`/`b`, `em`/`i`, `a[href]`,
+ * `code`, `br` — so serialization is a small, total, reversible function
+ * rather than a general HTML→markdown converter. Anything outside the set is a
+ * hard error: the browser sanitizes to this set before serializing, so a throw
+ * means a bug or an attack, never normal input.
+ *
+ * Pure and DOM-free by design: it operates on a minimal {@link SNode} tree so
+ * it can be property-tested in Node without a DOM, and the browser editor
+ * (`static/cms/editor/md-serialize.js`) supplies a matching tree from real DOM
+ * nodes. A parity test holds the two implementations to identical output.
+ *
+ * Known limitations (CommonMark/GFM constraints, not corruption — text is
+ * always preserved; only emphasis boundaries or auto-linking may shift):
+ *  - Abutting emphasis whose first span ends in punctuation and is followed by
+ *    a word char: asterisks fuse, underscore can't close (see `emphasisMarker`).
+ *  - Emphasis that starts with punctuation-leading content (e.g. a link) while
+ *    immediately preceded by a word char: the opening `*`/`_` is not
+ *    left-flanking, so the emphasis can't open. Unrepresentable in CommonMark.
+ *  - A bare email/URL in plain text (`a@b.com`, `www.x.com`) is auto-linked by
+ *    GFM on render; a second edit then serializes it as an explicit link.
+ *  - Links normalize to untitled inline form: editing a block rewrites
+ *    reference-style links (`[x][1]`) as inline links and drops link titles
+ *    (`"…"`) — text and destination are preserved, the definition lines
+ *    elsewhere in the document are untouched. Title support needs `title` in
+ *    the shared rich allowlist (v0.4 candidate).
+ * The editor doesn't produce these from normal selection-based formatting, so
+ * they are documented rather than special-cased.
+ */
+/** Thrown when the tree contains anything outside the closed inline set. */
+export class SerializeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SerializeError";
+    }
+}
+/** ASCII punctuation that CommonMark/GFM lets a backslash escape; we escape the
+ *  subset that can change inline parsing (`~` is GFM strikethrough). */
+const INLINE_ESCAPE_RE = /[\\`*_[\]<&>~]/g;
+function escapeText(value) {
+    // Collapse ASCII whitespace runs to a single space FIRST — this is exactly
+    // what HTML rendering does visually, and it makes `<br>` the serializer's
+    // only newline source. Without it, a raw `\n` in a text node emits a soft
+    // line break whose next line can open a block, and 4+ leading spaces form an
+    // indented code block when spliced. ` ` (nbsp) is deliberately NOT
+    // collapsed — HTML preserves it, so we do too.
+    return value.replace(/[ \t\r\n]+/g, " ").replace(INLINE_ESCAPE_RE, (c) => `\\${c}`);
+}
+/**
+ * Escape a leading block-marker so spliced paragraph text can't open a new
+ * block. Markers act only at line start, and a bullet / ordered marker triggers
+ * even with no following text (`+` alone is an empty list item), so the guard
+ * covers end-of-line too. Ordered markers escape the punctuation, not the digit
+ * (`\1` is not a valid escape; `1\.` is).
+ */
+function escapeLineStart(md) {
+    const ws = /^\s*/.exec(md)[0];
+    const rest = md.slice(ws.length);
+    const ordered = /^(\d{1,9})([.)])(\s|$)/.exec(rest);
+    if (ordered) {
+        return `${ws}${ordered[1]}\\${ordered[2]}${rest.slice(ordered[1].length + 1)}`;
+    }
+    // Dash/equals runs cover three block constructs at once: setext underlines
+    // are ONE-or-more `-`/`=` (a lone `=` after a hard break turns the paragraph
+    // into an <h1>), and thematic breaks allow interior spaces (`-- -`). `*`/`_`
+    // variants are already neutralized by escapeText.
+    const marker = /^(?:#{1,6}(?=\s|$)|>|[-+*](?=\s|$)|-(?:[ \t]*-)*[ \t]*$|=(?:[ \t]*=)*[ \t]*$|~{3,}|`{3,}|\|)/.test(rest);
+    return marker ? `${ws}\\${rest}` : md;
+}
+function tagOf(node) {
+    const t = node.tag.toLowerCase();
+    if (t === "b")
+        return "strong";
+    if (t === "i")
+        return "em";
+    return t;
+}
+/** Concatenated text of a subtree (for code spans, whose content is literal). */
+function rawText(nodes) {
+    let out = "";
+    for (const n of nodes) {
+        if (n.type === "text")
+            out += n.value;
+        else if (n.tag.toLowerCase() === "br")
+            out += " ";
+        else
+            out += rawText(n.children);
+    }
+    return out;
+}
+/** Render a code span with a backtick fence long enough to hold the content. */
+function codeSpan(content) {
+    if (content === "")
+        return "``";
+    let runs = content.match(/`+/g) ?? [];
+    let fenceLen = 1;
+    while (runs.some((r) => r.length === fenceLen))
+        fenceLen++;
+    const fence = "`".repeat(fenceLen);
+    // Pad when the content touches a backtick edge or is all spaces (CommonMark rule).
+    const needsPad = content.startsWith("`") ||
+        content.endsWith("`") ||
+        (content.startsWith(" ") && content.endsWith(" ") && content.trim() !== "");
+    return needsPad ? `${fence} ${content} ${fence}` : `${fence}${content}${fence}`;
+}
+/** Represent a link destination, using the `<...>` form when it isn't bare-safe. */
+function linkDestination(href) {
+    // Control characters (incl. \n, \r) have no representable escape in either
+    // destination form — a newline inside `<...>` terminates the destination and
+    // injects raw markdown structure. Hard-fail, per this file's philosophy.
+    // eslint-disable-next-line no-control-regex
+    if (/[\u0000-\u001f\u007f]/u.test(href)) {
+        throw new SerializeError("control character in link destination");
+    }
+    if (/^[^\s<>()\\]*$/.test(href))
+        return href;
+    return `<${href.replace(/([<>\\])/g, "\\$1")}>`;
+}
+/**
+ * Coalesce adjacent siblings that would otherwise emit colliding markdown:
+ * consecutive text nodes merge, and consecutive elements of the same
+ * (normalized) tag and attributes fuse their children. Without this,
+ * `<strong>a</strong><strong>b</strong>` serializes to `**a****b**`, whose
+ * `****` run CommonMark parses ambiguously. Merging renders identically and
+ * round-trips cleanly.
+ */
+function mergeAdjacent(nodes) {
+    const out = [];
+    for (const node of nodes) {
+        const prev = out[out.length - 1];
+        if (node.type === "text" && prev?.type === "text") {
+            prev.value += node.value;
+            continue;
+        }
+        if (node.type === "element" &&
+            prev?.type === "element" &&
+            tagOf(prev) === tagOf(node) &&
+            tagOf(node) !== "br" &&
+            sameAttrs(prev.attrs, node.attrs)) {
+            prev.children = [...prev.children, ...node.children];
+            continue;
+        }
+        out.push(node.type === "text" ? { ...node } : { ...node, children: [...node.children] });
+    }
+    return out;
+}
+function sameAttrs(a, b) {
+    const ka = Object.keys(a);
+    const kb = Object.keys(b);
+    return ka.length === kb.length && ka.every((k) => a[k] === b[k]);
+}
+/** First raw character of the next sibling, or "" — used to keep an underscore
+ *  emphasis from abutting a word character (CommonMark's intraword rule). */
+function nextLeadChar(nodes, i) {
+    const next = nodes[i + 1];
+    if (!next)
+        return "";
+    if (next.type === "text")
+        return next.value[0] ?? "";
+    return "<"; // an element emits a delimiter/bracket — never a word char
+}
+/**
+ * Emphasis delimiter for the element at `i`. Consecutive `em`/`strong` siblings
+ * abut with no text between, so their `*` delimiters would fuse into an
+ * ambiguous run (CommonMark's rule of three). We alternate `*`↔`_` across such
+ * a run so neighbours never share a delimiter character. Underscore can't close
+ * against a following word character, so we fall back to `*` there (safe for
+ * every realistic case; see the serializer notes for the one excluded shape).
+ */
+function emphasisMarker(nodes, i, prevMarker) {
+    if (prevMarker === null)
+        return "*";
+    const flipped = prevMarker === "*" ? "_" : "*";
+    if (flipped === "_" && /[A-Za-z0-9_]/.test(nextLeadChar(nodes, i)))
+        return "*";
+    return flipped;
+}
+function serializeChildren(rawNodes, opts) {
+    const nodes = mergeAdjacent(rawNodes);
+    let out = "";
+    let prevMarker = null;
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        if (node.type === "text") {
+            out += escapeText(node.value);
+            prevMarker = null;
+            continue;
+        }
+        const tag = tagOf(node);
+        switch (tag) {
+            case "strong": {
+                const inner = serializeChildren(node.children, opts);
+                if (inner === "") {
+                    prevMarker = null;
+                    break;
+                }
+                const m = emphasisMarker(nodes, i, prevMarker);
+                out += `${m}${m}${inner}${m}${m}`;
+                prevMarker = m;
+                break;
+            }
+            case "em": {
+                const inner = serializeChildren(node.children, opts);
+                if (inner === "") {
+                    prevMarker = null;
+                    break;
+                }
+                const m = emphasisMarker(nodes, i, prevMarker);
+                out += `${m}${inner}${m}`;
+                prevMarker = m;
+                break;
+            }
+            case "code": {
+                prevMarker = null;
+                out += codeSpan(rawText(node.children));
+                break;
+            }
+            case "a": {
+                const href = node.attrs.href;
+                if (href === undefined)
+                    throw new SerializeError("<a> without href");
+                prevMarker = null;
+                const inner = serializeChildren(node.children, opts);
+                out += `[${inner}](${linkDestination(href)})`;
+                break;
+            }
+            case "br": {
+                if (!opts.allowBreak) {
+                    throw new SerializeError("hard break not allowed in a nested block");
+                }
+                prevMarker = null;
+                out += "\\\n";
+                break;
+            }
+            default:
+                throw new SerializeError(`unsupported inline element <${node.tag}>`);
+        }
+    }
+    return out;
+}
+/**
+ * Serialize the inline children of one block to markdown source, ready to
+ * splice into the block's source range.
+ */
+export function serializeBlock(children, ctx) {
+    if (ctx.block === "heading") {
+        if (!Number.isInteger(ctx.level) || ctx.level < 1 || ctx.level > 6) {
+            throw new SerializeError(`invalid heading level: ${ctx.level}`);
+        }
+        const inline = serializeChildren(children, { allowBreak: false });
+        return `${"#".repeat(ctx.level)} ${inline}`;
+    }
+    const inline = serializeChildren(children, { allowBreak: !ctx.nested });
+    // Every LINE of a paragraph must be prevented from opening another block —
+    // CommonMark's block scanner runs before inline parsing, so a line after a
+    // hard break that starts with `#`/`>`/`- `/etc. would interrupt the
+    // paragraph. `escapeText` collapses raw newlines, so the hard-break sequence
+    // is the only line boundary the serializer can emit.
+    return inline.split("\\\n").map(escapeLineStart).join("\\\n");
+}
+//# sourceMappingURL=serialize.js.map

package/dist/markdown/serialize.js.map

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

package/dist/markdown/splice.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Publish-time body splice: apply drafted block edits to a markdown source
+ * file. This is the ONLY code that rewrites user prose in place, so it is
+ * all-or-nothing by construction — every block's range is re-verified against
+ * the CURRENT file (hash + bounds + overlap) before a single byte moves, and
+ * any failure leaves the file untouched.
+ *
+ * Pure (string -> string) so it can be property-tested without a filesystem;
+ * `MarkdownAdapter.spliceBodyBlocks` wraps it with read + atomic write.
+ */
+import { type MdSrc } from "./contracts.js";
+export interface BodySplice {
+    /** Server-derived markdown to put in the block's place. */
+    md: string;
+    /** The verified source range the draft was made against. */
+    src: MdSrc;
+}
+export type SpliceResult = {
+    ok: true;
+    content: string;
+} | {
+    ok: false;
+    reason: "stale" | "overlap";
+};
+/**
+ * Splice `blocks` into `fileSource`. Returns the new file content, or a
+ * failure (`stale` = a range no longer hashes, the file changed since the
+ * draft; `overlap` = two drafts claim intersecting ranges, which can only
+ * happen through a corrupted draft store — never write through it).
+ */
+export declare function spliceBodyBlocks(fileSource: string, blocks: readonly BodySplice[]): SpliceResult;
+//# sourceMappingURL=splice.d.ts.map

package/dist/markdown/splice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splice.d.ts","sourceRoot":"","sources":["../../src/markdown/splice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,GAAG,EAAE,KAAK,CAAC;CACZ;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,UAAU,EAAE,GAC5B,YAAY,CA0Bd"}

package/dist/markdown/splice.js

@@ -0,0 +1,44 @@
+/**
+ * Publish-time body splice: apply drafted block edits to a markdown source
+ * file. This is the ONLY code that rewrites user prose in place, so it is
+ * all-or-nothing by construction — every block's range is re-verified against
+ * the CURRENT file (hash + bounds + overlap) before a single byte moves, and
+ * any failure leaves the file untouched.
+ *
+ * Pure (string -> string) so it can be property-tested without a filesystem;
+ * `MarkdownAdapter.spliceBodyBlocks` wraps it with read + atomic write.
+ */
+import { canonicalBody } from "./canonical-body.js";
+import { fnv1a32 } from "./contracts.js";
+/**
+ * Splice `blocks` into `fileSource`. Returns the new file content, or a
+ * failure (`stale` = a range no longer hashes, the file changed since the
+ * draft; `overlap` = two drafts claim intersecting ranges, which can only
+ * happen through a corrupted draft store — never write through it).
+ */
+export function spliceBodyBlocks(fileSource, blocks) {
+    const { body, fileOffsetOf } = canonicalBody(fileSource);
+    for (const { src } of blocks) {
+        if (src.end > body.length)
+            return { ok: false, reason: "stale" };
+        if (fnv1a32(body.slice(src.start, src.end)) !== src.hash) {
+            return { ok: false, reason: "stale" };
+        }
+    }
+    const ordered = [...blocks].sort((a, b) => b.src.start - a.src.start);
+    for (let i = 1; i < ordered.length; i++) {
+        // Descending by start: the later block in the file comes first. Overlap
+        // exists when the previous (later-in-file) block starts before this one ends.
+        if (ordered[i - 1].src.start < ordered[i].src.end) {
+            return { ok: false, reason: "overlap" };
+        }
+    }
+    let content = fileSource;
+    for (const { md, src } of ordered) {
+        const start = fileOffsetOf(src.start);
+        const end = fileOffsetOf(src.end);
+        content = content.slice(0, start) + md + content.slice(end);
+    }
+    return { ok: true, content };
+}
+//# sourceMappingURL=splice.js.map

package/dist/markdown/splice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splice.js","sourceRoot":"","sources":["../../src/markdown/splice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAc,MAAM,gBAAgB,CAAC;AAarD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,MAA6B;IAE7B,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAEzD,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC;QAC7B,IAAI,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACjE,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;YACzD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,wEAAwE;QACxE,8EAA8E;QAC9E,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YAClD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,IAAI,OAAO,GAAG,UAAU,CAAC;IACzB,KAAK,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/markdown/stamp.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Shared, pipeline-independent logic for stamping `data-caret-md` bindings.
+ *
+ * Two frontends drive this — a Sätteri mdast plugin (Astro 7) and a remark
+ * plugin (Astro 6) — walking their own trees but calling the SAME pure
+ * functions here so both emit byte-identical attributes (a parity test holds
+ * them together). Nothing in this module touches a tree or a pipeline type; it
+ * takes already-extracted node facts and returns attributes or `null`.
+ */
+/**
+ * mdast node types that make their subtree non-editable: their inner text is
+ * either structured (tables), reference plumbing (footnote definitions), or
+ * raw/JSX passthrough that markdown block editing can't safely round-trip.
+ */
+export declare const ISLAND_TYPES: ReadonlySet<string>;
+export interface ResolvedEntry {
+    collection: string;
+    id: string;
+}
+/**
+ * Resolve a source file to its `{collection, id}` under the content root, or
+ * `null`. v1 scope: flat `<contentRoot>/<collection>/<id>.md` only — `.mdx`,
+ * nested slugs, and identifiers failing the id grammar are intentionally
+ * unmatched (and so never stamped).
+ */
+export declare function resolveEntry(fileURL: string | URL | undefined, contentRoot: string): ResolvedEntry | null;
+export type ParagraphPlan = {
+    action: "skip";
+} | {
+    action: "self";
+    nested: boolean;
+} | {
+    action: "parent";
+};
+/**
+ * Decide how a paragraph maps to a bound element. A list item renders its text
+ * on the `<li>` (a tight list drops the `<p>` entirely), so we bind the item —
+ * via its FIRST paragraph, using that paragraph's marker-free offsets. Other
+ * paragraphs bind themselves; `nested` marks those inside a container.
+ */
+export declare function planParagraph(parentType: string, indexInParent: number | undefined): ParagraphPlan;
+export interface StampInput {
+    /** The exact source string the pipeline parsed (offsets are relative to it). */
+    source: string;
+    /** The file being rendered. */
+    fileURL: string | URL | undefined;
+    /** Absolute content root the markdown adapter reads from. */
+    contentRoot: string;
+    /** unist offsets of the block whose text the binding edits. */
+    start: number | undefined;
+    end: number | undefined;
+    /** Root-to-element child indexes identifying the bound element. */
+    blockPath: readonly number[];
+    /** Types of the bound node's ancestors (island detection). */
+    ancestorTypes: readonly string[];
+    /** True when the block sits inside a container (blockquote / list item). */
+    nested: boolean;
+    /** mdast node type of the bound block ("heading" | "paragraph" | "listItem"). */
+    blockType?: string;
+}
+/**
+ * Compute the `{data-caret-md, data-caret-md-src}` attributes for one block, or
+ * `null` to leave it unstamped. Offsets are normalized to the canonical body
+ * base (frontmatter-stripped, trimmed) so a `.md` import, a content-collection
+ * entry, and Astro 6 remark all yield the same numbers.
+ */
+export declare function computeStamp(input: StampInput): Record<string, string> | null;
+//# sourceMappingURL=stamp.d.ts.map

package/dist/markdown/stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.d.ts","sourceRoot":"","sources":["../../src/markdown/stamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAS3C,CAAC;AAEH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAyBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,EACjC,WAAW,EAAE,MAAM,GAClB,aAAa,GAAG,IAAI,CAetB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEzB;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,aAAa,CAKf;AAED,MAAM,WAAW,UAAU;IACzB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC;IAClC,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,mEAAmE;IACnE,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,8DAA8D;IAC9D,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,4EAA4E;IAC5E,MAAM,EAAE,OAAO,CAAC;IAChB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAmC7E"}