@derive-to/artifacts 0.0.0-stage → 0.6.1

package/dist/protocol/source-copy-identities.js

@@ -0,0 +1,119 @@
+import { domIds, rewriteAttrs, rewriteCopiedDomIds } from "./source-copy-dom.js";
+import { idOf, isSlideAttrs, nextUnusedSlideId, SLIDE_TAGS } from "./source-deck-elements.js";
+import { attrValues } from "./source-html.js";
+import { tags } from "./source-tags.js";
+import { nextVideoSceneId, VIDEO_SCENE_ID } from "./source-video-id.js";
+const withId = (text, id) => {
+    if (/data-derive-slide\s*=/i.test(text))
+        return text.replace(/data-derive-slide\s*=\s*["']?-?\d+["']?/i, `data-derive-slide="${id}"`);
+    const m = /^<([a-zA-Z][a-zA-Z0-9-]*)/.exec(text);
+    return m
+        ? `${text.slice(0, m[0].length)} data-derive-slide="${id}"${text.slice(m[0].length)}`
+        : text;
+};
+export const inactiveClasses = (classes) => classes.filter((name) => !["on", "active", "is-active", "current"].includes(name.toLowerCase()));
+export const STRUCTURAL_ID = /^[A-Za-z][A-Za-z0-9_-]{0,127}$/;
+const structuralIds = (html) => tags(html).flatMap((tag) => tag.closing
+    ? []
+    : [
+        ...attrValues(tag.attrs, "data-derive-region"),
+        ...attrValues(tag.attrs, "data-derive-node"),
+    ]);
+/** A duplicated slide's structural identities must be new too, or every later
+ *  structural edit on either copy is refused as ambiguous. A value derived from the
+ *  source slide's identity follows the copy's (`slide-4` → `slide-46`, `s4-title` →
+ *  `s46-title`); anything else gains a `-copy-N` suffix. `data-derive-owner` names a
+ *  node, so it follows the node rename and the copy's hierarchy stays intact. */
+const rewriteCopiedStructuralIds = (html, sourceId, copyId, used) => {
+    const token = sourceId === null ? null : new RegExp(`(?<![0-9])${sourceId}(?![0-9])`);
+    const fresh = (original) => {
+        // An unreadable identity is refused by structural editing either way; leave it be.
+        if (!STRUCTURAL_ID.test(original))
+            return original;
+        const derived = token ? original.replace(token, String(copyId)) : original;
+        const base = derived !== original && STRUCTURAL_ID.test(derived)
+            ? derived
+            : `${original.slice(0, 100)}-copy-${copyId}`;
+        let candidate = base;
+        for (let n = 2; used.has(candidate); n++)
+            candidate = `${base.slice(0, 120)}-${n}`;
+        used.add(candidate);
+        return candidate;
+    };
+    const regions = new Map();
+    const nodes = new Map();
+    for (const tag of tags(html)) {
+        if (tag.closing)
+            continue;
+        for (const value of attrValues(tag.attrs, "data-derive-region"))
+            if (!regions.has(value))
+                regions.set(value, fresh(value));
+        for (const value of attrValues(tag.attrs, "data-derive-node"))
+            if (!nodes.has(value))
+                nodes.set(value, fresh(value));
+    }
+    if (!regions.size && !nodes.size)
+        return html;
+    return rewriteAttrs(html, (name, value) => {
+        const lower = name.toLowerCase();
+        const ids = lower === "data-derive-region"
+            ? regions
+            : lower === "data-derive-node" || lower === "data-derive-owner"
+                ? nodes
+                : null;
+        return ids?.get(value) ?? value;
+    });
+};
+/** A newly-created slide is never the live one merely because its source was. Deck
+ *  runtimes commonly persist `on`/`active` on the first slide in authored source; copying
+ *  that state would paint two slides at once after reload. Only the OUTER slide's class
+ *  list is touched, and content/style classes remain byte-for-byte. */
+const inactiveCopy = (text, sourceId, id, used) => {
+    const copied = rewriteCopiedStructuralIds(rewriteCopiedDomIds(withId(text, id), id, used.dom), sourceId, id, used.structural);
+    const open = tags(copied).find((tag) => !tag.closing && SLIDE_TAGS.has(tag.name));
+    if (!open)
+        return copied;
+    const opening = copied
+        .slice(open.start, open.end)
+        .replace(/class\s*=\s*(["'])(.*?)\1/i, (_all, quote, value) => {
+        const classes = inactiveClasses(value.split(/\s+/).filter(Boolean));
+        return `class=${quote}${classes.join(" ")}${quote}`;
+    });
+    return copied.slice(0, open.start) + opening + copied.slice(open.end);
+};
+export const copyIdentitiesOf = (html) => ({
+    slides: new Set(tags(html).flatMap((tag) => tag.closing
+        ? []
+        : attrValues(tag.attrs, "data-derive-slide").flatMap((v) => /^-?\d+$/.test(v) && Number.isSafeInteger(Number(v)) ? [Number(v)] : []))),
+    dom: new Set(domIds(html)),
+    structural: new Set(structuralIds(html)),
+    scenes: new Set(tags(html).flatMap((tag) => (tag.closing ? [] : attrValues(tag.attrs, "data-derive-scene")))),
+    copies: 0,
+});
+/** A duplicated element's bytes with fresh identities, so the copy never shares comment
+ *  threads, DOM ids, or structural handles with its original. A slide copy gets a new
+ *  slide identity and is made inactive, exactly as a slide_ops duplicate; any other
+ *  element's DOM and structural ids gain a copy suffix, and slides nested inside it get
+ *  new identities. `used` grows with every identity minted. */
+export const copyWithFreshIdentities = (text, used) => {
+    const mint = () => {
+        const id = nextUnusedSlideId(used.slides);
+        used.slides.add(id);
+        return id;
+    };
+    const root = tags(text).find((tag) => !tag.closing);
+    if (root && SLIDE_TAGS.has(root.name) && isSlideAttrs(root.attrs))
+        return inactiveCopy(text, idOf(root.attrs), mint(), used);
+    const copy = ++used.copies;
+    const nested = rewriteAttrs(text, (name, value) => {
+        if (name.toLowerCase() === "data-derive-slide" && /^-?\d+$/.test(value))
+            return String(mint());
+        if (name.toLowerCase() !== "data-derive-scene" || !VIDEO_SCENE_ID.test(value))
+            return value;
+        const id = nextVideoSceneId(used.scenes);
+        used.scenes.add(id);
+        return id;
+    });
+    return rewriteCopiedStructuralIds(rewriteCopiedDomIds(nested, copy, used.dom), null, copy, used.structural);
+};
+//# sourceMappingURL=source-copy-identities.js.map

package/dist/protocol/source-copy-identities.js.map

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

package/dist/protocol/source-deck-elements.d.ts

@@ -0,0 +1,30 @@
+export declare const SLIDE_TAGS: Set<string>;
+/** The `data-derive-slide` value on an opening tag, when it carries a numeric one. */
+export declare const idOf: (attrs: string) => number | null;
+/** Mint a deterministic identity without crossing JavaScript's safe-integer boundary.
+ * Normal decks keep max+1. A deck already using MAX_SAFE_INTEGER wraps to the lowest
+ * unused non-negative identity instead of rounding into a collision. */
+export declare const nextUnusedSlideId: (usedIds: Iterable<number>) => number;
+/** One slide element's exact span in the source. */
+export interface SlideSpan {
+    /** 1-based position in document order — what a person sees on the deck bar. */
+    position: number;
+    /** Offset of the opening `<`. */
+    start: number;
+    /** Offset just past the closing `>`. */
+    end: number;
+    /** The stable `data-derive-slide` value, or null when the deck never stamped one. */
+    id: number | null;
+}
+/** Every slide element's byte span, in document order.
+ *
+ *  Document order, deliberately: a deck's own script reveals slides in DOM order, so
+ *  that is what "slide 3" means to anyone watching. The `data-derive-slide` attribute is
+ *  identity, and after the first reorder the two disagree — sorting by it here would put
+ *  this slicer at odds with the page it is slicing.
+ *
+ *  Throws `EditError` rather than guessing when the structure is ambiguous: a slide that
+ *  never closes, or one nested inside another. Returns [] for a page with no slides. */
+export declare const sliceSlides: (html: string) => SlideSpan[];
+export declare const isSlideAttrs: (attrs: string) => boolean;
+//# sourceMappingURL=source-deck-elements.d.ts.map

package/dist/protocol/source-deck-elements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-deck-elements.d.ts","sourceRoot":"","sources":["../../src/protocol/source-deck-elements.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,EAAE,GAAG,CAAC,MAAM,CAAgD,CAAA;AAEnF,sFAAsF;AACtF,eAAO,MAAM,IAAI,UAAW,MAAM,KAAG,MAAM,GAAG,IAa7C,CAAA;AAED;;wEAEwE;AACxE,eAAO,MAAM,iBAAiB,YAAa,QAAQ,CAAC,MAAM,CAAC,KAAG,MAU7D,CAAA;AAED,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAA;IACX,qFAAqF;IACrF,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAClB;AAED;;;;;;;;wFAQwF;AACxF,eAAO,MAAM,WAAW,SAAU,MAAM,KAAG,SAAS,EAoBnD,CAAA;AAED,eAAO,MAAM,YAAY,UAAW,MAAM,KAAG,OAKgB,CAAA"}

package/dist/protocol/source-deck-elements.js

@@ -0,0 +1,67 @@
+import { EditError } from "./source-edits.js";
+import { attrValues, classTokens, elementEnd } from "./source-html.js";
+import { tags } from "./source-tags.js";
+export const SLIDE_TAGS = new Set(["section", "div", "article", "li"]);
+/** The `data-derive-slide` value on an opening tag, when it carries a numeric one. */
+export const idOf = (attrs) => {
+    const values = attrValues(attrs, "data-derive-slide");
+    if (values.length > 1)
+        throw new EditError("A slide has more than one data-derive-slide attribute, so its identity is ambiguous. Edit the source directly.");
+    const raw = values[0];
+    if (raw === undefined)
+        return null;
+    if (!/^-?\d+$/.test(raw) || !Number.isSafeInteger(Number(raw)))
+        throw new EditError(`Slide identity ${JSON.stringify(raw)} must be one whole, safely representable integer. Edit the source directly.`);
+    return Number(raw);
+};
+/** Mint a deterministic identity without crossing JavaScript's safe-integer boundary.
+ * Normal decks keep max+1. A deck already using MAX_SAFE_INTEGER wraps to the lowest
+ * unused non-negative identity instead of rounding into a collision. */
+export const nextUnusedSlideId = (usedIds) => {
+    const used = new Set(usedIds);
+    let max = -1;
+    for (const id of used)
+        if (id > max)
+            max = id;
+    if (max < Number.MAX_SAFE_INTEGER)
+        return max + 1;
+    let candidate = 0;
+    while (used.has(candidate))
+        candidate++;
+    if (!Number.isSafeInteger(candidate))
+        throw new EditError("This deck has no safely representable slide identity left to allocate.");
+    return candidate;
+};
+/** Every slide element's byte span, in document order.
+ *
+ *  Document order, deliberately: a deck's own script reveals slides in DOM order, so
+ *  that is what "slide 3" means to anyone watching. The `data-derive-slide` attribute is
+ *  identity, and after the first reorder the two disagree — sorting by it here would put
+ *  this slicer at odds with the page it is slicing.
+ *
+ *  Throws `EditError` rather than guessing when the structure is ambiguous: a slide that
+ *  never closes, or one nested inside another. Returns [] for a page with no slides. */
+export const sliceSlides = (html) => {
+    const all = tags(html);
+    const spans = [];
+    for (let t = 0; t < all.length; t++) {
+        const open = all[t];
+        if (open.closing || !SLIDE_TAGS.has(open.name) || !isSlideAttrs(open.attrs))
+            continue;
+        const end = elementEnd(all, t);
+        if (end === -1)
+            throw new EditError(`A slide element (<${open.name}> at character ${open.start}) is never closed — the deck's structure can't be read. Fix the markup, or edit the source directly.`);
+        spans.push({ position: 0, start: open.start, end, id: idOf(open.attrs) });
+    }
+    // A slide inside a slide has no single position, so no op on it could mean one thing.
+    for (let i = 1; i < spans.length; i++)
+        if (spans[i].start < spans[i - 1].end)
+            throw new EditError("This deck nests a slide element inside another one, so slides have no single order. Edit the source directly.");
+    return spans.map((s, i) => ({ ...s, position: i + 1 }));
+};
+export const isSlideAttrs = (attrs) => attrValues(attrs, "data-derive-slide").length > 0 ||
+    // The other common hand-rolled marker: models writing a deck from scratch number their
+    // sections with data-slide="N" and no class at all.
+    attrValues(attrs, "data-slide").length > 0 ||
+    classTokens(attrs).some((t) => t.toLowerCase() === "slide");
+//# sourceMappingURL=source-deck-elements.js.map

package/dist/protocol/source-deck-elements.js.map

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

package/dist/protocol/source-deck-ops.d.ts

@@ -0,0 +1,18 @@
+export type SlideOp = {
+    op: "move";
+    from: number;
+    to: number;
+} | {
+    op: "delete";
+    at: number;
+} | {
+    op: "duplicate";
+    at: number;
+} | {
+    op: "insert";
+    at: number;
+};
+/** Enough for any real rearranging session; a runaway loop is not an edit. */
+export declare const MAX_SLIDE_OPS = 200;
+export declare const applySlideOps: (html: string, ops: SlideOp[]) => string;
+//# sourceMappingURL=source-deck-ops.d.ts.map

package/dist/protocol/source-deck-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-deck-ops.d.ts","sourceRoot":"","sources":["../../src/protocol/source-deck-ops.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,OAAO,GACf;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhC,8EAA8E;AAC9E,eAAO,MAAM,aAAa,MAAM,CAAA;AA+KhC,eAAO,MAAM,aAAa,SAAU,MAAM,OAAO,OAAO,EAAE,KAAG,MAmB5D,CAAA"}

package/dist/protocol/source-deck-ops.js

@@ -0,0 +1,154 @@
+import { domIds } from "./source-copy-dom.js";
+import { copyIdentitiesOf, copyWithFreshIdentities, inactiveClasses, } from "./source-copy-identities.js";
+import { nextUnusedSlideId, SLIDE_TAGS, sliceSlides, } from "./source-deck-elements.js";
+import { EditError } from "./source-edits.js";
+import { attrValue, classTokens } from "./source-html.js";
+import { tags } from "./source-tags.js";
+/** Enough for any real rearranging session; a runaway loop is not an edit. */
+export const MAX_SLIDE_OPS = 200;
+/** Give every slide a stable identity, minting only for the ones that lack it. Existing
+ *  values are never touched: they are what comment threads are pinned to. */
+const stamped = (texts, ids) => {
+    const used = new Set(ids.filter((v) => v !== null));
+    return texts.map((text, i) => {
+        const existing = ids[i];
+        if (existing !== null && existing !== undefined)
+            return { text, id: existing };
+        const id = nextUnusedSlideId(used);
+        used.add(id);
+        // Insert into the opening tag, just past the tag name.
+        const m = /^<([a-zA-Z][a-zA-Z0-9-]*)/.exec(text);
+        return {
+            text: m
+                ? `${text.slice(0, m[0].length)} data-derive-slide="${id}"${text.slice(m[0].length)}`
+                : text,
+            id,
+        };
+    });
+};
+const escapeAttr = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;");
+/** A blank slide inherits only visual/layout attributes. Content identity (`id`), ARIA
+ *  references, and arbitrary data hooks are unique to the source slide and would become
+ *  broken duplicates if copied onto a new one. */
+const blankOpening = (open, id) => {
+    const classes = inactiveClasses(classTokens(open.attrs));
+    const style = attrValue(open.attrs, "style");
+    const role = attrValue(open.attrs, "role");
+    return `<${open.name} data-derive-slide="${id}"${classes.length ? ` class="${escapeAttr(classes.join(" "))}"` : ""}${style ? ` style="${escapeAttr(style)}"` : ""}${role ? ` role="${escapeAttr(role)}"` : ""}>`;
+};
+/** Make a deliberately small blank slide in the deck's own outer shell. Keeping the
+ *  source slide's tag + attributes preserves arbitrary deck layout conventions (a deck
+ *  may use `li.slide`, an inline style, or its own data attributes), while the fresh
+ *  identity keeps comment threads distinct. The interior is intentionally plain HTML:
+ *  it is useful immediately and can be changed with the rendered editor. */
+const blankFrom = (text, id) => {
+    const all = tags(text);
+    const open = all.find((tag) => !tag.closing && SLIDE_TAGS.has(tag.name));
+    if (!open)
+        throw new EditError("The slide used as a template has no readable opening tag.");
+    const close = all.toReversed().find((tag) => tag.closing && tag.name === open.name);
+    const opening = blankOpening(open, id);
+    const closing = close ? text.slice(close.start, close.end) : `</${open.name}>`;
+    return `${opening}\n  <h2>New slide</h2>\n  <p>Add content in Edit mode.</p>\n${closing}`;
+};
+const prepareSlides = (html) => {
+    const spans = sliceSlides(html);
+    if (spans.length === 0)
+        throw new EditError('This document has no slide elements, so there is nothing to arrange. A deck\'s slides are elements carrying class="slide" or data-derive-slide.');
+    // Whatever sits BETWEEN slides travels with neither of them, so reordering would
+    // silently relocate it. Whitespace is safe to normalize; anything else is content,
+    // and losing content is the one outcome worth refusing an edit over.
+    const first = spans[0];
+    const last = spans[spans.length - 1];
+    const gaps = [];
+    for (let i = 1; i < spans.length; i++) {
+        const gap = html.slice(spans[i - 1].end, spans[i].start);
+        if (gap.trim())
+            throw new EditError(`There is content between slides ${i} and ${i + 1} that belongs to neither, so reordering would move it somewhere it doesn't belong. Edit the source directly.`);
+        gaps.push(gap);
+    }
+    const ids = spans.map((s) => s.id);
+    const known = ids.filter((v) => v !== null);
+    if (new Set(known).size !== known.length)
+        throw new EditError("Two slides share the same data-derive-slide value, so their comment threads can't be told apart. Give each slide a distinct value first.");
+    // Identity first: a class-only deck (or one an agent extended by hand) gets stamped on
+    // its first arrange, so every later session — and every comment left in between — has
+    // something stable to hold onto.
+    const items = stamped(spans.map((s) => html.slice(s.start, s.end)), ids);
+    const used = copyIdentitiesOf(html);
+    if (used.dom.size !== domIds(html).length)
+        throw new EditError("This deck repeats a DOM id, so its document-wide references are already ambiguous. Give every element a unique id before arranging slides.");
+    for (const item of items)
+        used.slides.add(item.id);
+    return { first, last, gaps, items, used };
+};
+const slidePosition = (context, n, label, max) => {
+    const { items } = context;
+    if (typeof n !== "number" || !Number.isInteger(n) || n < 1 || n > max) {
+        // An insert may target one past the end, so its range is not the slide count.
+        const count = items.length;
+        const slides = `this deck has ${count} slide${count === 1 ? "" : "s"}`;
+        throw new EditError(max > count
+            ? `slide_ops: ${label} ${JSON.stringify(n)} is out of range — ${slides}, so an insert accepts positions 1–${max}.`
+            : `slide_ops: ${label} ${JSON.stringify(n)} is out of range — ${slides} (positions are 1-based).`);
+    }
+    return n;
+};
+const applySlideOp = (context, op) => {
+    const { items, used } = context;
+    const at = (n, label, max) => slidePosition(context, n, label, max);
+    switch (op?.op) {
+        case "move": {
+            const from = at(op.from, "from", items.length);
+            const to = at(op.to, "to", items.length);
+            if (from === to)
+                return;
+            const [moved] = items.splice(from - 1, 1);
+            if (moved)
+                items.splice(to - 1, 0, moved);
+            return;
+        }
+        case "delete": {
+            const pos = at(op.at, "at", items.length);
+            if (items.length === 1)
+                throw new EditError("That would delete the deck's only slide. Delete the artifact instead, or leave one slide standing.");
+            items.splice(pos - 1, 1);
+            return;
+        }
+        case "duplicate": {
+            const pos = at(op.at, "at", items.length);
+            const src = items[pos - 1];
+            items.splice(pos, 0, { text: copyWithFreshIdentities(src.text, used), id: -1 });
+            return;
+        }
+        case "insert": {
+            const pos = at(op.at, "at", items.length + 1);
+            const templateAt = Math.min(Math.max(pos - 1, 0), items.length - 1);
+            const src = items[templateAt];
+            const nextId = nextUnusedSlideId(used.slides);
+            used.slides.add(nextId);
+            items.splice(pos - 1, 0, { text: blankFrom(src.text, nextId), id: nextId });
+            return;
+        }
+        default:
+            throw new EditError(`slide_ops: unknown op ${JSON.stringify(op?.op)} — use "move", "delete", "duplicate", or "insert".`);
+    }
+};
+export const applySlideOps = (html, ops) => {
+    if (!Array.isArray(ops) || ops.length === 0)
+        throw new EditError("`slide_ops` is empty — provide at least one op.");
+    if (ops.length > MAX_SLIDE_OPS)
+        throw new EditError("`slide_ops` has " +
+            ops.length +
+            " entries — the maximum per request is " +
+            MAX_SLIDE_OPS +
+            ".");
+    const context = prepareSlides(html);
+    for (const op of ops)
+        applySlideOp(context, op);
+    const { first, last, gaps, items } = context;
+    return (html.slice(0, first.start) +
+        items.map((s) => s.text).join(gaps[0] ?? "\n") +
+        html.slice(last.end));
+};
+//# sourceMappingURL=source-deck-ops.js.map

package/dist/protocol/source-deck-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-deck-ops.js","sourceRoot":"","sources":["../../src/protocol/source-deck-ops.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAC7C,OAAO,EAEL,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,GAChB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,iBAAiB,EACjB,UAAU,EAEV,WAAW,GACZ,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAQvC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAA;AAEhC;6EAC6E;AAC7E,MAAM,OAAO,GAAG,CAAC,KAAe,EAAE,GAAsB,EAAkC,EAAE;IAC1F,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAA;IAChE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAA;QAC9E,MAAM,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAClC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACZ,uDAAuD;QACvD,MAAM,CAAC,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChD,OAAO;YACL,IAAI,EAAE,CAAC;gBACL,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,uBAAuB,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;gBACrF,CAAC,CAAC,IAAI;YACR,EAAE;SACH,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAC3C,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;AAE1D;;kDAEkD;AAClD,MAAM,YAAY,GAAG,CAAC,IAAa,EAAE,EAAU,EAAU,EAAE;IACzD,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IACxD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC1C,OAAO,IAAI,IAAI,CAAC,IAAI,uBAAuB,EAAE,IAC3C,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EACjE,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAA;AAChG,CAAC,CAAA;AAED;;;;4EAI4E;AAC5E,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,EAAU,EAAU,EAAE;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IACtB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IACxE,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,2DAA2D,CAAC,CAAA;IAC3F,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAA;IACnF,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,CAAA;IAC9E,OAAO,GAAG,OAAO,+DAA+D,OAAO,EAAE,CAAA;AAC3F,CAAC,CAAA;AAoBD,MAAM,aAAa,GAAG,CAAC,IAAY,EAAkB,EAAE;IACrD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QACpB,MAAM,IAAI,SAAS,CACjB,iJAAiJ,CAClJ,CAAA;IAEH,iFAAiF;IACjF,mFAAmF;IACnF,qEAAqE;IACrE,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAc,CAAA;IACnC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAc,CAAA;IACjD,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAe,CAAC,GAAG,EAAG,KAAK,CAAC,CAAC,CAAe,CAAC,KAAK,CAAC,CAAA;QACtF,IAAI,GAAG,CAAC,IAAI,EAAE;YACZ,MAAM,IAAI,SAAS,CACjB,mCAAmC,CAAC,QAAQ,CAAC,GAAG,CAAC,8GAA8G,CAChK,CAAA;QACH,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAChB,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;IACxD,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM;QACtC,MAAM,IAAI,SAAS,CACjB,0IAA0I,CAC3I,CAAA;IAEH,uFAAuF;IACvF,sFAAsF;IACtF,iCAAiC;IACjC,MAAM,KAAK,GAAG,OAAO,CACnB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAC5C,GAAG,CACJ,CAAA;IACD,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;IACnC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM;QACvC,MAAM,IAAI,SAAS,CACjB,4IAA4I,CAC7I,CAAA;IACH,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAElD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AAC3C,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,OAAqB,EAAE,CAAU,EAAE,KAAa,EAAE,GAAW,EAAU,EAAE;IAC9F,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IACzB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACtE,8EAA8E;QAC9E,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAA;QAC1B,MAAM,MAAM,GAAG,iBAAiB,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;QACtE,MAAM,IAAI,SAAS,CACjB,GAAG,GAAG,KAAK;YACT,CAAC,CAAC,cAAc,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB,MAAM,sCAAsC,GAAG,GAAG;YAClH,CAAC,CAAC,cAAc,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB,MAAM,2BAA2B,CACpG,CAAA;IACH,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,OAAqB,EAAE,EAAW,EAAQ,EAAE;IAChE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAA;IAC/B,MAAM,EAAE,GAAG,CAAC,CAAU,EAAE,KAAa,EAAE,GAAW,EAAU,EAAE,CAC5D,aAAa,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;IACvC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC;QACf,KAAK,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YAC9C,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YACxC,IAAI,IAAI,KAAK,EAAE;gBAAE,OAAM;YACvB,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;YACzC,IAAI,KAAK;gBAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;YACzC,OAAM;QACR,CAAC;QACD,KAAK,QAAQ,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBACpB,MAAM,IAAI,SAAS,CACjB,oGAAoG,CACrG,CAAA;YACH,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;YACxB,OAAM;QACR,CAAC;QACD,KAAK,WAAW,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YACzC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAqB,CAAA;YAC9C,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,uBAAuB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;YAC/E,OAAM;QACR,CAAC;QACD,KAAK,QAAQ,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;YAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;YACnE,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAwC,CAAA;YACpE,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAC7C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACvB,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;YAC3E,OAAM;QACR,CAAC;QACD;YACE,MAAM,IAAI,SAAS,CACjB,yBAAyB,IAAI,CAAC,SAAS,CAAE,EAAuB,EAAE,EAAE,CAAC,oDAAoD,CAC1H,CAAA;IACL,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,GAAc,EAAU,EAAE;IACpE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QACzC,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAA;IACxE,IAAI,GAAG,CAAC,MAAM,GAAG,aAAa;QAC5B,MAAM,IAAI,SAAS,CACjB,kBAAkB;YAChB,GAAG,CAAC,MAAM;YACV,wCAAwC;YACxC,aAAa;YACb,GAAG,CACN,CAAA;IACH,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IACnC,KAAK,MAAM,EAAE,IAAI,GAAG;QAAE,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAC/C,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IAC5C,OAAO,CACL,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;QAC1B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CACrB,CAAA;AACH,CAAC,CAAA"}

package/dist/protocol/source-deck.d.ts

@@ -0,0 +1,20 @@
+/** Is this opening tag a slide? It carries the stable `data-derive-slide` index, or `slide`
+ *  as a WHOLE class token.
+ *
+ *  Whole token, not a substring: `\bslide\b` treats a hyphen as a word boundary, so
+ *  `class="slide-inner"` matched — and real decks are full of `slide-inner`, `slide-chart`,
+ *  `slide-kicker`. That made every such wrapper look like a slide nested inside its own
+ *  slide, which inflated the count and made the slicer refuse the deck outright. Found by
+ *  running this over real published decks rather than fixtures. */
+/** How many slide elements this HTML actually contains. */
+export declare const countSlideElements: (html: string) => number;
+/** Does this page announce itself to the host over the deck protocol? Matches the bare
+ *  protocol name so either quote style (source:'derive-deck' / "derive-deck") is found. */
+export declare const speaksDeckProtocol: (html: string) => boolean;
+/** A deck: it announces itself AND has slides to announce. Both halves are required —
+ *  the protocol name alone appears in any document about decks (this file included), and
+ *  slides alone are just sections. */
+export declare const isDeckDocument: (html: string) => boolean;
+/** True when a page is plainly a deck attempt that never announced itself. */
+export declare const isUnannouncedDeck: (html: string) => boolean;
+//# sourceMappingURL=source-deck.d.ts.map

package/dist/protocol/source-deck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-deck.d.ts","sourceRoot":"","sources":["../../src/protocol/source-deck.ts"],"names":[],"mappings":"AA+CA;;;;;;;mEAOmE;AACnE,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,SAAU,MAAM,KAAG,MAKjD,CAAA;AAED;2FAC2F;AAC3F,eAAO,MAAM,kBAAkB,SAAU,MAAM,KAAG,OACH,CAAA;AAM/C;;sCAEsC;AACtC,eAAO,MAAM,cAAc,SAAU,MAAM,KAAG,OAU7C,CAAA;AAOD,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,OAOhD,CAAA"}

package/dist/protocol/source-deck.js

@@ -0,0 +1,103 @@
+import { isSlideAttrs, SLIDE_TAGS, sliceSlides } from "./source-deck-elements.js";
+import { elementEnd } from "./source-html.js";
+import { tags } from "./source-tags.js";
+const withoutCommentsInText = (html) => {
+    let out = "";
+    let i = 0;
+    for (;;) {
+        const start = html.indexOf("<!--", i);
+        if (start === -1)
+            return out + html.slice(i);
+        out += html.slice(i, start);
+        const ordinary = html.indexOf("-->", start + 4);
+        const legacy = html.indexOf("--!>", start + 4);
+        const end = ordinary < 0 ? legacy : legacy < 0 ? ordinary : Math.min(ordinary, legacy);
+        if (end === -1)
+            return out; // unterminated: the rest of the document is inside it
+        i = end + (html.startsWith("--!>", end) ? 4 : 3);
+    }
+};
+/** Remove real HTML comments while preserving parsed tags and raw script/style
+ *  elements verbatim. In raw text and quoted attributes, `<!--` is data rather
+ *  than an HTML comment opener; treating it as one can hide a valid protocol post. */
+const withoutComments = (html) => {
+    const all = tags(html);
+    const protectedRanges = all.map((tag) => ({
+        start: tag.start,
+        end: tag.end,
+    }));
+    for (let i = 0; i < all.length; i++) {
+        const open = all[i];
+        if (!open || open.closing || (open.name !== "script" && open.name !== "style"))
+            continue;
+        const end = elementEnd(all, i);
+        protectedRanges.push({ start: open.start, end: end < 0 ? html.length : end });
+    }
+    if (!protectedRanges.length)
+        return withoutCommentsInText(html);
+    protectedRanges.sort((a, b) => a.start - b.start || b.end - a.end);
+    let out = "";
+    let cursor = 0;
+    for (const range of protectedRanges) {
+        if (range.start < cursor)
+            continue;
+        out += withoutCommentsInText(html.slice(cursor, range.start));
+        out += html.slice(range.start, range.end);
+        cursor = range.end;
+    }
+    return out + withoutCommentsInText(html.slice(cursor));
+};
+/** Is this opening tag a slide? It carries the stable `data-derive-slide` index, or `slide`
+ *  as a WHOLE class token.
+ *
+ *  Whole token, not a substring: `\bslide\b` treats a hyphen as a word boundary, so
+ *  `class="slide-inner"` matched — and real decks are full of `slide-inner`, `slide-chart`,
+ *  `slide-kicker`. That made every such wrapper look like a slide nested inside its own
+ *  slide, which inflated the count and made the slicer refuse the deck outright. Found by
+ *  running this over real published decks rather than fixtures. */
+/** How many slide elements this HTML actually contains. */
+export const countSlideElements = (html) => {
+    let n = 0;
+    for (const tag of tags(html))
+        if (!tag.closing && SLIDE_TAGS.has(tag.name) && isSlideAttrs(tag.attrs))
+            n++;
+    return n;
+};
+/** Does this page announce itself to the host over the deck protocol? Matches the bare
+ *  protocol name so either quote style (source:'derive-deck' / "derive-deck") is found. */
+export const speaksDeckProtocol = (html) => withoutComments(html).includes("derive-deck");
+/** How many slide elements a page needs before it is read as a deck rather than a page that
+ *  happens to mention the protocol. Two, because a deck has at least two slides. */
+const DECK_MIN_SLIDES = 2;
+/** A deck: it announces itself AND has slides to announce. Both halves are required —
+ *  the protocol name alone appears in any document about decks (this file included), and
+ *  slides alone are just sections. */
+export const isDeckDocument = (html) => {
+    if (!speaksDeckProtocol(html) || countSlideElements(html) < DECK_MIN_SLIDES)
+        return false;
+    // Classification enables structural editing in the UI, so it must not advertise
+    // a deck whose slide structure the organizer will immediately refuse. Keep this
+    // predicate non-throwing because it also runs while sniffing arbitrary uploads.
+    try {
+        return sliceSlides(html).length >= DECK_MIN_SLIDES;
+    }
+    catch {
+        return false;
+    }
+};
+/** Slides built without the protocol: the page paginates itself and silently forfeits the
+ *  deck bar, Present mode, and slide-pinned comments. Three, so an ordinary page with a
+ *  couple of `.slide`-classed elements is never lectured. */
+const ADVISE_MIN_SLIDES = 3;
+/** True when a page is plainly a deck attempt that never announced itself. */
+export const isUnannouncedDeck = (html) => {
+    if (speaksDeckProtocol(html) || countSlideElements(html) < ADVISE_MIN_SLIDES)
+        return false;
+    try {
+        return sliceSlides(html).length >= ADVISE_MIN_SLIDES;
+    }
+    catch {
+        return false;
+    }
+};
+//# sourceMappingURL=source-deck.js.map

package/dist/protocol/source-deck.js.map

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

package/dist/protocol/source-edits.d.ts

@@ -0,0 +1,21 @@
+/** One exact-match replacement (the Edit-tool contract: unique match or error). */
+export interface DocEdit {
+    old_str: string;
+    new_str: string;
+    /** 1-based index of WHICH match to replace, for an `old_str` that is intentionally
+     *  non-unique (a phrase repeated verbatim in several spots). Omit when `old_str`
+     *  already matches exactly once — this only disambiguates a multi-match. */
+    occurrence?: number;
+}
+export declare class EditError extends Error {
+}
+/**
+ * Apply `edits` to `src` in order, each seeing the previous edit's result. Every
+ * `old_str` must match EXACTLY ONCE — unless `occurrence` names which of several
+ * identical matches to replace — or the whole batch is rejected (nothing partial
+ * ever lands). A miss carries a diagnostic (why it didn't match, not just that it
+ * didn't) so the agent fixes it in one round. Same contract as the coding Edit tool,
+ * so agents already know how to recover.
+ */
+export declare function applyEdits(src: string, edits: readonly DocEdit[]): string;
+//# sourceMappingURL=source-edits.d.ts.map

package/dist/protocol/source-edits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-edits.d.ts","sourceRoot":"","sources":["../../src/protocol/source-edits.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf;;gFAE4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,SAAU,SAAQ,KAAK;CAAG;AA6GvC;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAmCzE"}