@derive-to/artifacts 0.0.0-stage → 0.6.1

package/dist/protocol/source-anchors.js

@@ -0,0 +1,250 @@
+/**
+ * Isomorphic anchoring primitives — the code that MUST produce byte-identical results
+ * in the browser (against a live DOM, inside the sandboxed iframe client) and on the
+ * server (against parsed HTML descriptors). Both `anchor-client.ts` (the injected
+ * client) and `element-anchor.ts` (the server resolver) import from here, so a content
+ * fingerprint made in one place equals one made in the other BY CONSTRUCTION — not by
+ * hand-copying a vanilla-JS transcription and hoping it stays in lockstep (which drifted
+ * once: a different join separator silently broke every browser-made element anchor).
+ *
+ * Keep this file dependency-free and DOM-free so it bundles cleanly into the browser
+ * client and runs untouched on the server.
+ */
+/** Field separator inside a content fingerprint, so a value ending and the next
+ *  beginning can't blur into a collision (src "…a" + alt "b" vs src "…" + alt "ab").
+ *  A control char (U+0001) that never appears in real content. */
+export const FP_SEP = "\u0001";
+/** Cap on the text slice that feeds a fingerprint — enough to identify, bounded so a
+ *  huge block doesn't dominate the hash. */
+export const FP_TEXT_CAP = 120;
+/**
+ * FNV-1a (32-bit) → base36. A tiny, fast, dependency-free hash — we only need a stable
+ * content fingerprint, not cryptographic strength.
+ */
+export function fnv1a(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0;
+    }
+    return h.toString(36);
+}
+/** Collapse runs of whitespace and trim. Used everywhere a value feeds matching. */
+export function normWs(s) {
+    return s.replace(/\s+/g, " ").trim();
+}
+/** Ellipsis-truncate to `n` chars. The one copy of the convention (cut at n-1, "…"),
+ *  shared by anchor labels, edit error copy, and version messages. */
+export const clip = (s, n) => (s.length > n ? `${s.slice(0, n - 1)}…` : s);
+/**
+ * The canonical content fingerprint over the four identifying fields. Each side pulls
+ * {tag, src, alt, text} from its own environment — a live DOM node in the browser, a
+ * parsed descriptor on the server — then calls this, so the hash ASSEMBLY (the field
+ * order, the separator, the text normalization + cap) lives in exactly one place.
+ */
+export function fingerprintFrom(tag, src, alt, text) {
+    return fnv1a([tag, src, alt, normWs(text).slice(0, FP_TEXT_CAP)].join(FP_SEP));
+}
+/** Escape a string for literal use inside a RegExp. */
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/** Whitespace-flexible regex source for a literal string: escape to a literal pattern
+ *  (never introduces whitespace), then let every whitespace run flex to `\s+`. */
+const flexPattern = (s) => escapeRe(s).replace(/\s+/g, "\\s+");
+/** The one context pattern both the lenient (highlight) and strict (edit) matchers
+ *  compile: prefix + (exact) + suffix, whitespace-flexible, exact captured so the
+ *  `d` (indices) flag exposes its span directly. Prefix and suffix are adjacent
+ *  source slices, so their own whitespace supplies any flexible separator; adding
+ *  whitespace at the seams would make punctuation-adjacent context impossible to
+ *  match. Null when there is no context at all, or the pattern fails to compile. */
+const contextPattern = (q, pre, suf, flags) => {
+    if (!pre && !suf)
+        return null;
+    try {
+        return new RegExp(`${flexPattern(pre)}(${flexPattern(q)})${flexPattern(suf)}`, flags);
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Locate `exact` in `text` whitespace-flexibly, using `prefix`/`suffix` as CONTEXT to
+ * disambiguate a quote that repeats — then return the span of `exact` itself (not the
+ * context). An `exact` that also appears inside the prefix can't hijack the result
+ * (the capture group's own indices are read). When the context no longer matches, falls
+ * back to the bare exact only where it occurs once: a comment whose words now repeat is
+ * left unanchored rather than pinned to the wrong occurrence. Whitespace in the quote
+ * matches any run of whitespace in the text, because a selection, DOM text and HTML source
+ * each serialize the gaps between blocks differently. The one resolver every reader uses
+ * (`findQuote` in the protocol entry delegates here). Returns null if unfound or ambiguous.
+ */
+export function findQuoteWithContext(text, exact, prefix, suffix) {
+    const q = exact.trim();
+    if (!q)
+        return null;
+    const pre = prefix ?? "";
+    const suf = suffix ?? "";
+    // A DOM selection may drop or add whitespace at the seams between its context and the
+    // quote; the selection grammar, tried second, allows that.
+    const inContext = adjacentContextSpan(text, q, pre, suf) ?? findSelectionWithContext(text, exact, pre, suf);
+    if (inContext)
+        return inContext;
+    // No context, or it no longer matches: the bare exact, only where it is unique.
+    const found = findQuoteMatches(text, q, 2);
+    return found.length === 1 ? (found[0] ?? null) : null;
+}
+/** The span of `q` where it sits right between its prefix and suffix, if it does. */
+const adjacentContextSpan = (text, q, pre, suf) => {
+    const m = contextPattern(q, pre, suf, "d")?.exec(text);
+    const gi = m?.indices?.[1];
+    return gi ? { start: gi[0], end: gi[1] } : null;
+};
+/**
+ * The STRICT context matcher for destructive callers: the context must match
+ * exactly ONCE. Two identical repeated cards produce two identical context
+ * windows — a lenient matcher would silently act on the first card when the user
+ * touched the second, so `matches > 1` reports the ambiguity for the caller to
+ * refuse. `span` is null on a miss (no context given, pattern failed, or zero
+ * matches) — pair with {@link findQuoteMatches} to accept a miss only when the
+ * exact is globally unambiguous.
+ *
+ * When the adjacent-context pattern finds nothing, one retry lets the seams between
+ * prefix|exact|suffix hold optional whitespace. A capture path can drop the space at a
+ * block edge ("Slack" + suffix "Ask in a channel" for `<h3>Slack</h3><p>Ask…`). The
+ * retry only runs on a miss and must also match exactly once, so it never changes a
+ * result the adjacent pattern already decided.
+ */
+export function findQuoteContextUnique(text, exact, prefix, suffix) {
+    const q = exact.trim();
+    if (!q)
+        return { span: null, matches: 0 };
+    const adjacent = uniqueCapture(text, contextPattern(q, prefix ?? "", suffix ?? "", "dg"));
+    if (adjacent.matches)
+        return adjacent;
+    return uniqueCapture(text, seamContextPattern(q, prefix ?? "", suffix ?? ""));
+}
+/** The context pattern with optional whitespace at both seams. Context that is only
+ *  whitespace pins nothing once the seam is optional, so it is dropped. */
+const seamContextPattern = (q, pre, suf) => {
+    const p = pre.trimEnd();
+    const s = suf.trimStart();
+    if (!p && !s)
+        return null;
+    try {
+        return new RegExp(`${p ? `${flexPattern(p)}\\s*` : ""}(${flexPattern(q)})${s ? `\\s*${flexPattern(s)}` : ""}`, "dg");
+    }
+    catch {
+        return null;
+    }
+};
+/** The capture span of `re` in `text` when it matches exactly once. */
+const uniqueCapture = (text, re) => {
+    if (!re)
+        return { span: null, matches: 0 };
+    const first = re.exec(text);
+    const gi = first?.indices?.[1];
+    if (!first || !gi)
+        return { span: null, matches: 0 };
+    // One more probe decides unique-vs-ambiguous; the exact count past 2 is unneeded.
+    if (first.index === re.lastIndex)
+        re.lastIndex++; // zero-width safety
+    const second = re.exec(text);
+    return { span: second ? null : { start: gi[0], end: gi[1] }, matches: second ? 2 : 1 };
+};
+const selectionContextPattern = (exact, prefix, suffix, flags) => {
+    const q = exact.trim();
+    if (!q || (!prefix && !suffix))
+        return null;
+    const lead = exact.length > exact.trimStart().length ? "\\s*" : "";
+    const trail = exact.length > exact.trimEnd().length ? "\\s*" : "";
+    const pattern = `${flexPattern(prefix.trim())}\\s*?(${lead}${flexPattern(q)}${trail})\\s*?${flexPattern(suffix.trim())}`;
+    return new RegExp(pattern, flags);
+};
+/** A DOM selection uses one context grammar for display and destructive writes. */
+export const findSelectionWithContext = (text, exact, prefix, suffix) => {
+    const match = selectionContextPattern(exact, prefix, suffix, "d")?.exec(text);
+    const span = match?.indices?.[1];
+    return span ? { start: span[0], end: span[1] } : null;
+};
+/** Count with the exact display pattern. Never use a second, looser lookup for a write. */
+export const findSelectionContextUnique = (text, exact, prefix, suffix) => uniqueCapture(text, selectionContextPattern(exact, prefix, suffix, "dg"));
+/**
+ * Every whitespace-flexible match of `quote` in `text` (capped so a degenerate quote
+ * on a huge document stays bounded). Lets a destructive caller distinguish "matches
+ * once — safe to act on" from "matches many — ambiguous, refuse".
+ */
+export function findQuoteMatches(text, quote, cap = 20) {
+    const q = quote.trim();
+    if (!q)
+        return [];
+    const out = [];
+    try {
+        const re = new RegExp(flexPattern(q), "g");
+        for (let m = re.exec(text); m && out.length < cap; m = re.exec(text)) {
+            out.push({ start: m.index, end: m.index + m[0].length });
+            // A zero-width match can't happen (q is non-empty), but never trust lastIndex
+            // to advance on its own with pathological inputs.
+            if (re.lastIndex <= m.index)
+                re.lastIndex = m.index + 1;
+        }
+    }
+    catch {
+        let i = text.indexOf(q);
+        while (i >= 0 && out.length < cap) {
+            out.push({ start: i, end: i + q.length });
+            i = text.indexOf(q, i + 1);
+        }
+    }
+    return out;
+}
+/** The elements whose boundaries the server's page-text projection renders as
+ *  whitespace (everything else, an inline seam, renders as nothing). Shared by
+ *  anchor.ts (pageText), latex-emit.ts (which pins its mirror equal in a test) and the
+ *  in-frame client, whose edit snapshot must put a seam exactly where pageText does. */
+export const BLOCK_TEXT_ELEMENTS = new Set([
+    "address",
+    "article",
+    "aside",
+    "blockquote",
+    "body",
+    "br",
+    "caption",
+    "dd",
+    "div",
+    "dl",
+    "dt",
+    "fieldset",
+    "figcaption",
+    "figure",
+    "footer",
+    "form",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "header",
+    "hgroup",
+    "hr",
+    "html",
+    "li",
+    "listing",
+    "main",
+    "nav",
+    "ol",
+    "p",
+    "pre",
+    "section",
+    "table",
+    "tbody",
+    "td",
+    "tfoot",
+    "th",
+    "thead",
+    "tr",
+    "ul",
+    "xmp",
+]);
+//# sourceMappingURL=source-anchors.js.map

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

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

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

@@ -0,0 +1,15 @@
+/** Native source assets preserve the host's non-executable upload policy. */
+export declare const SOURCE_ASSET_MAX_BYTES: number;
+export declare const SOURCE_ASSET_TYPES: readonly ["image/png", "image/jpeg", "image/gif", "image/webp", "font/woff2", "font/woff"];
+export type SourceImageType = "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+/** Identify a supported raster image by its magic bytes, or null if unsupported. */
+export declare const sourceImageType: (b: Uint8Array) => SourceImageType | null;
+export type SourceAssetType = SourceImageType | "font/woff2" | "font/woff";
+/**
+ * Identify a supported standalone asset — a raster image or a packaged web font —
+ * by its magic bytes. Fonts share the rasters' stored-XSS posture (non-executable
+ * bytes served under a fixed content-type + nosniff); SVG/HTML stay out. Avatars
+ * are stricter and keep using sourceImageType directly.
+ */
+export declare const sourceAssetType: (b: Uint8Array) => SourceAssetType | null;
+//# sourceMappingURL=source-assets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-assets.d.ts","sourceRoot":"","sources":["../../src/protocol/source-assets.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,EAAE,MAAyB,CAAA;AAC9D,eAAO,MAAM,kBAAkB,YAC7B,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,CACH,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAA;AAQrF,oFAAoF;AACpF,eAAO,MAAM,eAAe,MAAO,UAAU,KAAG,eAAe,GAAG,IAyCjE,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,YAAY,GAAG,WAAW,CAAA;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,eAAe,MAAO,UAAU,KAAG,eAAe,GAAG,IASjE,CAAA"}

package/dist/protocol/source-assets.js

@@ -0,0 +1,66 @@
+/** Native source assets preserve the host's non-executable upload policy. */
+export const SOURCE_ASSET_MAX_BYTES = 25 * 1024 * 1024;
+export const SOURCE_ASSET_TYPES = [
+    "image/png",
+    "image/jpeg",
+    "image/gif",
+    "image/webp",
+    "font/woff2",
+    "font/woff",
+];
+const hasBytes = (bytes, minimum, signature) => bytes.length >= minimum && signature.every(([index, value]) => bytes[index] === value);
+/** Identify a supported raster image by its magic bytes, or null if unsupported. */
+export const sourceImageType = (b) => {
+    if (hasBytes(b, 8, [
+        [0, 0x89],
+        [1, 0x50],
+        [2, 0x4e],
+        [3, 0x47],
+    ]))
+        return "image/png";
+    if (hasBytes(b, 3, [
+        [0, 0xff],
+        [1, 0xd8],
+        [2, 0xff],
+    ]))
+        return "image/jpeg";
+    if (hasBytes(b, 6, [
+        [0, 0x47],
+        [1, 0x49],
+        [2, 0x46],
+        [3, 0x38],
+    ]))
+        return "image/gif";
+    if (hasBytes(b, 12, [
+        [0, 0x52],
+        [1, 0x49],
+        [2, 0x46],
+        [3, 0x46],
+        [8, 0x57],
+        [9, 0x45],
+        [10, 0x42],
+        [11, 0x50],
+    ]))
+        return "image/webp";
+    return null;
+};
+/**
+ * Identify a supported standalone asset — a raster image or a packaged web font —
+ * by its magic bytes. Fonts share the rasters' stored-XSS posture (non-executable
+ * bytes served under a fixed content-type + nosniff); SVG/HTML stay out. Avatars
+ * are stricter and keep using sourceImageType directly.
+ */
+export const sourceAssetType = (b) => {
+    const image = sourceImageType(b);
+    if (image)
+        return image;
+    // wOF2 / wOFF
+    if (b.length >= 4 && b[0] === 0x77 && b[1] === 0x4f && b[2] === 0x46) {
+        if (b[3] === 0x32)
+            return "font/woff2";
+        if (b[3] === 0x46)
+            return "font/woff";
+    }
+    return null;
+};
+//# sourceMappingURL=source-assets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-assets.js","sourceRoot":"","sources":["../../src/protocol/source-assets.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,sBAAsB,GAAW,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,WAAW;IACX,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,WAAW;CACH,CAAA;AAIV,MAAM,QAAQ,GAAG,CACf,KAAiB,EACjB,OAAe,EACf,SAAiD,EACxC,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAA;AAEpG,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAa,EAA0B,EAAE;IACvE,IACE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE;QACb,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;KACV,CAAC;QAEF,OAAO,WAAW,CAAA;IACpB,IACE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE;QACb,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;KACV,CAAC;QAEF,OAAO,YAAY,CAAA;IACrB,IACE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE;QACb,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;KACV,CAAC;QAEF,OAAO,WAAW,CAAA;IACpB,IACE,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE;QACd,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,CAAC,EAAE,IAAI,CAAC;QACT,CAAC,EAAE,EAAE,IAAI,CAAC;QACV,CAAC,EAAE,EAAE,IAAI,CAAC;KACX,CAAC;QAEF,OAAO,YAAY,CAAA;IACrB,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAID;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAa,EAA0B,EAAE;IACvE,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,CAAC,CAAA;IAChC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAA;IACvB,cAAc;IACd,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,YAAY,CAAA;QACtC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,WAAW,CAAA;IACvC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

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

@@ -0,0 +1,23 @@
+/**
+ * Small memory for hot paths: what was computed or read a moment ago, kept for the next
+ * request in the same process. A save and its sync walk the same multi-megabyte document
+ * several times; an editing session saves the same version over and over.
+ */
+/** A Map holding its `size` most recently used entries. */
+export declare class Recent<K, V> {
+    private readonly size;
+    private readonly entries;
+    constructor(size: number);
+    get(key: K): V | undefined;
+    /** The entry, without counting it as used. */
+    peek(key: K): V | undefined;
+    set(key: K, value: V): void;
+    delete(key: K): void;
+}
+/** A function of one large string, remembered for the last few strings it was given.
+ *  Strings below `min` characters are cheaper to walk again than to key. What it returns
+ *  is shared: callers treat it as read-only. */
+export declare const lastOf: <T>(size: number, min: number, fn: (text: string) => T) => ((text: string) => T) & {
+    peek: (text: string) => T | undefined;
+};
+//# sourceMappingURL=source-cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-cache.d.ts","sourceRoot":"","sources":["../../src/protocol/source-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2DAA2D;AAC3D,qBAAa,MAAM,CAAC,CAAC,EAAE,CAAC;IAEV,OAAO,CAAC,QAAQ,CAAC,IAAI;IADjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,YAA6B,IAAI,EAAE,MAAM,EAAI;IAE7C,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAIzB;IACD,8CAA8C;IAC9C,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAE1B;IACD,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAI1B;IACD,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAEnB;CACF;AAED;;gDAEgD;AAChD,eAAO,MAAM,MAAM,GAAI,CAAC,QAChB,MAAM,OACP,MAAM,MACP,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,KACtB,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC,GAAG;IAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAA;CAajE,CAAA"}

package/dist/protocol/source-cache.js

@@ -0,0 +1,52 @@
+/**
+ * Small memory for hot paths: what was computed or read a moment ago, kept for the next
+ * request in the same process. A save and its sync walk the same multi-megabyte document
+ * several times; an editing session saves the same version over and over.
+ */
+/** A Map holding its `size` most recently used entries. */
+export class Recent {
+    size;
+    entries = new Map();
+    constructor(size) {
+        this.size = size;
+    }
+    get(key) {
+        const hit = this.entries.get(key);
+        if (hit !== undefined)
+            this.set(key, hit);
+        return hit;
+    }
+    /** The entry, without counting it as used. */
+    peek(key) {
+        return this.entries.get(key);
+    }
+    set(key, value) {
+        this.entries.delete(key);
+        this.entries.set(key, value);
+        if (this.entries.size > this.size)
+            this.entries.delete(this.entries.keys().next().value);
+    }
+    delete(key) {
+        this.entries.delete(key);
+    }
+}
+/** A function of one large string, remembered for the last few strings it was given.
+ *  Strings below `min` characters are cheaper to walk again than to key. What it returns
+ *  is shared: callers treat it as read-only. */
+export const lastOf = (size, min, fn) => {
+    const seen = new Recent(size);
+    const get = (text) => {
+        if (text.length < min)
+            return fn(text);
+        const hit = seen.get(text);
+        if (hit !== undefined)
+            return hit;
+        const value = fn(text);
+        seen.set(text, value);
+        return value;
+    };
+    /** What is remembered for `text`, without computing it. */
+    get.peek = (text) => seen.peek(text);
+    return get;
+};
+//# sourceMappingURL=source-cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-cache.js","sourceRoot":"","sources":["../../src/protocol/source-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2DAA2D;AAC3D,MAAM,OAAO,MAAM;IAEY,IAAI;IADhB,OAAO,GAAG,IAAI,GAAG,EAAQ,CAAA;IAC1C,YAA6B,IAAY;oBAAZ,IAAI;IAAW,CAAC;IAE7C,GAAG,CAAC,GAAM;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,GAAG,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QACzC,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,8CAA8C;IAC9C,IAAI,CAAC,GAAM;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC;IACD,GAAG,CAAC,GAAM,EAAE,KAAQ;QAClB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACxB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC5B,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAU,CAAC,CAAA;IAC/F,CAAC;IACD,MAAM,CAAC,GAAM;QACX,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;CACF;AAED;;gDAEgD;AAChD,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,IAAY,EACZ,GAAW,EACX,EAAuB,EAC4C,EAAE;IACrE,MAAM,IAAI,GAAG,IAAI,MAAM,CAAY,IAAI,CAAC,CAAA;IACxC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAK,EAAE;QAC9B,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;YAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC1B,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,GAAG,CAAA;QACjC,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QACtB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACrB,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;IACD,2DAA2D;IAC3D,GAAG,CAAC,IAAI,GAAG,CAAC,IAAY,EAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3D,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA"}

package/dist/protocol/source-copy-dom.d.ts

@@ -0,0 +1,11 @@
+export declare const domIds: (html: string) => string[];
+/** Rewrite attribute values in every opening tag. The name=value tokenizer consumes
+ *  quoted values whole, so text that merely looks like an attribute inside one is never
+ *  rewritten; attribute spelling and quote style stay unchanged. */
+export declare const rewriteAttrs: (html: string, rewrite: (name: string, value: string) => string) => string;
+/** A duplicated slide is a new DOM subtree, so authored IDs inside it must also be
+ *  new. Rewrite the IDREF attributes browsers and assistive technology resolve,
+ *  plus fragment/url references used by SVG. Attribute spelling and quote style
+ *  stay unchanged; only values that point at an ID from this slide move. */
+export declare const rewriteCopiedDomIds: (html: string, slideId: number, used: Set<string>) => string;
+//# sourceMappingURL=source-copy-dom.d.ts.map

package/dist/protocol/source-copy-dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-copy-dom.d.ts","sourceRoot":"","sources":["../../src/protocol/source-copy-dom.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,MAAM,SAAU,MAAM,KAAG,MAAM,EACmC,CAAA;AAE/E;;oEAEoE;AACpE,eAAO,MAAM,YAAY,SACjB,MAAM,WACH,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,KAC/C,MAkCF,CAAA;AAED;;;4EAG4E;AAC5E,eAAO,MAAM,mBAAmB,SAAU,MAAM,WAAW,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,KAAG,MA+CtF,CAAA"}

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

@@ -0,0 +1,103 @@
+import { EditError } from "./source-edits.js";
+import { attrValues } from "./source-html.js";
+import { tags } from "./source-tags.js";
+const IDREF_LIST_ATTRS = new Set([
+    "aria-controls",
+    "aria-describedby",
+    "aria-details",
+    "aria-errormessage",
+    "aria-flowto",
+    "aria-labelledby",
+    "aria-owns",
+    "headers",
+    "itemref",
+]);
+const IDREF_ATTRS = new Set(["aria-activedescendant", "contextmenu", "for", "form", "list"]);
+const FRAGMENT_ATTRS = new Set(["href", "usemap", "xlink:href"]);
+const SVG_TIMING_ATTRS = new Set(["begin", "end"]);
+const cssUnescapeIdentifier = (value) => value.replace(/\\(?:([0-9a-f]{1,6})(?:\r\n|[ \n\r\t\f])?|(\r\n|[\n\r\f])|(.))/gis, (_whole, hex, newline, escaped) => {
+    if (hex) {
+        const cp = Number.parseInt(hex, 16);
+        return cp === 0 || cp > 0x10ffff || (cp >= 0xd800 && cp <= 0xdfff)
+            ? "�"
+            : String.fromCodePoint(cp);
+    }
+    return newline ? "" : (escaped ?? "");
+});
+export const domIds = (html) => tags(html).flatMap((tag) => (tag.closing ? [] : attrValues(tag.attrs, "id")));
+/** Rewrite attribute values in every opening tag. The name=value tokenizer consumes
+ *  quoted values whole, so text that merely looks like an attribute inside one is never
+ *  rewritten; attribute spelling and quote style stay unchanged. */
+export const rewriteAttrs = (html, rewrite) => {
+    const attr = /([^\s"'<>/=]+)(\s*=\s*)(?:"([^"]*)"|'([^']*)'|([^\s"'=<>`]+))/g;
+    let out = "";
+    let cursor = 0;
+    for (const tag of tags(html)) {
+        if (tag.closing)
+            continue;
+        out += html.slice(cursor, tag.start);
+        out += html
+            .slice(tag.start, tag.end)
+            .replace(attr, (whole, ...captures) => {
+            const [name, equals, double, single, bare] = captures;
+            const value = double ?? single ?? bare ?? "";
+            const next = rewrite(name, value);
+            if (next === value)
+                return whole;
+            if (double !== undefined)
+                return `${name}${equals}"${next}"`;
+            if (single !== undefined)
+                return `${name}${equals}'${next}'`;
+            return `${name}${equals}${next}`;
+        });
+        cursor = tag.end;
+    }
+    return out + html.slice(cursor);
+};
+/** A duplicated slide is a new DOM subtree, so authored IDs inside it must also be
+ *  new. Rewrite the IDREF attributes browsers and assistive technology resolve,
+ *  plus fragment/url references used by SVG. Attribute spelling and quote style
+ *  stay unchanged; only values that point at an ID from this slide move. */
+export const rewriteCopiedDomIds = (html, slideId, used) => {
+    const originals = domIds(html);
+    if (new Set(originals).size !== originals.length)
+        throw new EditError("This slide repeats a DOM id inside itself, so duplicating it would leave ambiguous references. Give its elements unique ids first.");
+    const rewritten = new Map();
+    for (const original of originals) {
+        let candidate = `${original}--derive-copy-${slideId}`;
+        let n = 2;
+        while (used.has(candidate))
+            candidate = `${original}--derive-copy-${slideId}-${n++}`;
+        rewritten.set(original, candidate);
+        used.add(candidate);
+    }
+    if (!rewritten.size)
+        return html;
+    const rewriteValue = (name, value) => {
+        const lower = name.toLowerCase();
+        if (lower === "id")
+            return rewritten.get(value) ?? value;
+        if (IDREF_ATTRS.has(lower))
+            return rewritten.get(value) ?? value;
+        if (IDREF_LIST_ATTRS.has(lower))
+            return value.replace(/\S+/g, (token) => rewritten.get(token) ?? token);
+        if (FRAGMENT_ATTRS.has(lower) && value.startsWith("#"))
+            return `#${rewritten.get(value.slice(1)) ?? value.slice(1)}`;
+        if (SVG_TIMING_ATTRS.has(lower)) {
+            let nextValue = value;
+            for (const [original, next] of rewritten) {
+                const escaped = original.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+                nextValue = nextValue.replace(new RegExp(`(^|;)(\\s*)${escaped}(?=\\.)`, "g"), (_whole, boundary, space) => `${boundary}${space}${next}`);
+            }
+            return nextValue;
+        }
+        return value.replace(/url\(\s*((?:["'])|(?:&(?:quot|apos|#(?:34|39)|#x(?:22|27));))?#([^\s)"']+?)\1\s*\)/gi, (whole, _quote, ref) => {
+            const decoded = cssUnescapeIdentifier(ref);
+            const next = rewritten.get(decoded);
+            const encoded = next?.startsWith(decoded) ? ref + next.slice(decoded.length) : next;
+            return encoded ? whole.replace(`#${ref}`, `#${encoded}`) : whole;
+        });
+    };
+    return rewriteAttrs(html, rewriteValue);
+};
+//# sourceMappingURL=source-copy-dom.js.map

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

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

package/dist/protocol/source-copy-identities.d.ts

@@ -0,0 +1,19 @@
+export declare const inactiveClasses: (classes: string[]) => string[];
+export declare const STRUCTURAL_ID: RegExp;
+/** The identities a document already uses, which every copy made from it must avoid.
+ *  `copies` names non-slide copies (`id--derive-copy-N`), so repeated copies stay unique. */
+export interface CopyIdentities {
+    slides: Set<number>;
+    dom: Set<string>;
+    structural: Set<string>;
+    scenes: Set<string>;
+    copies: number;
+}
+export declare const copyIdentitiesOf: (html: string) => CopyIdentities;
+/** 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 declare const copyWithFreshIdentities: (text: string, used: CopyIdentities) => string;
+//# sourceMappingURL=source-copy-identities.d.ts.map

package/dist/protocol/source-copy-identities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-copy-identities.d.ts","sourceRoot":"","sources":["../../src/protocol/source-copy-identities.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,eAAe,YAAa,MAAM,EAAE,KAAG,MAAM,EACwC,CAAA;AAElG,eAAO,MAAM,aAAa,EAAE,MAAyC,CAAA;AAsFrE;6FAC6F;AAC7F,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACnB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAChB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACvB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,eAAO,MAAM,gBAAgB,SAAU,MAAM,KAAG,cAgB9C,CAAA;AAEF;;;;+DAI+D;AAC/D,eAAO,MAAM,uBAAuB,SAAU,MAAM,QAAQ,cAAc,KAAG,MAuB5E,CAAA"}