@derive-to/artifacts 0.0.0-stage → 0.6.1

package/dist/protocol/source-markdown-projection.d.ts

@@ -0,0 +1,30 @@
+import type { MarkdownInlineWrapper, MarkdownTextParts, MarkdownTextSegment, MarkdownToken } from "./source-markdown-types.js";
+/** Keep the rendered text and its original source ranges together. */
+export declare class MarkdownProjection {
+    readonly parts: string[];
+    readonly segments: MarkdownTextSegment[];
+    readonly wrappers: MarkdownInlineWrapper[];
+    private tLen;
+    readonly source: string;
+    constructor(source: string);
+    pushGap: ([rStart, rEnd]: readonly [number, number], block: number, boundary?: "inline" | "html" | "structural", projectSpace?: boolean) => void;
+    pushEntity: (text: string, rStart: number, rEnd: number, block: number) => void;
+    pushText: (rStart: number, rEnd: number, block: number) => void;
+    pushHtml: (raw: string, rStart: number, block: number) => void;
+    locate: (raw: string, from: number, limit: number) => number;
+    firstAuthoredLine: (raw: string) => {
+        text: string;
+        offset: number;
+    } | null;
+    /** A normalized container's full raw value may not occur anywhere in authored
+     *  source. Anchor on its first real line before checking the one plausible exact
+     *  start, avoiding a failed suffix-wide search for every sibling. */
+    exactStartAtAnchor: (raw: string, anchor: number, from: number, limit: number) => number;
+    /** Find a stable authored foothold for a normalized container token. Marked
+     *  removes a blockquote/list prefix from every line, so the whole `raw` often is
+     *  absent while its first non-empty authored line is still exact. Descendants
+     *  are the fallback for wrapper tokens whose own first line is only structure. */
+    firstSourceAnchor: (token: MarkdownToken, from: number, limit: number) => number;
+    result: () => MarkdownTextParts;
+}
+//# sourceMappingURL=source-markdown-projection.d.ts.map

package/dist/protocol/source-markdown-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-markdown-projection.d.ts","sourceRoot":"","sources":["../../src/protocol/source-markdown-projection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACd,MAAM,4BAA4B,CAAA;AAGnC,sEAAsE;AACtE,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAK;IAC7B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAK;IAC7C,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,EAAE,CAAK;IAC/C,OAAO,CAAC,IAAI,CAAI;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,YAAY,MAAM,EAAE,MAAM,EAEzB;IAED,OAAO,mBACW,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,SAClC,MAAM,aACH,QAAQ,GAAG,MAAM,GAAG,YAAY,6BAEzC,IAAI,CAeN;IAED,UAAU,SAAU,MAAM,UAAU,MAAM,QAAQ,MAAM,SAAS,MAAM,KAAG,IAAI,CAY7E;IAED,QAAQ,WAAY,MAAM,QAAQ,MAAM,SAAS,MAAM,KAAG,IAAI,CAkC7D;IAED,QAAQ,QAAS,MAAM,UAAU,MAAM,SAAS,MAAM,KAAG,IAAI,CAe5D;IAED,MAAM,QAAS,MAAM,QAAQ,MAAM,SAAS,MAAM,KAAG,MAAM,CAI1D;IAED,iBAAiB,QAAS,MAAM,KAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAYzE;IAED;;yEAEqE;IACrE,kBAAkB,QAAS,MAAM,UAAU,MAAM,QAAQ,MAAM,SAAS,MAAM,KAAG,MAAM,CAYtF;IAED;;;sFAGkF;IAClF,iBAAiB,UAAW,aAAa,QAAQ,MAAM,SAAS,MAAM,KAAG,MAAM,CAa9E;IAED,MAAM,QAAO,iBAAiB,CAI5B;CACH"}

package/dist/protocol/source-markdown-projection.js

@@ -0,0 +1,164 @@
+import { decodedEntitiesIn } from "./source-entities.js";
+import { pageTextParts } from "./source-text.js";
+/** Keep the rendered text and its original source ranges together. */
+export class MarkdownProjection {
+    parts = [];
+    segments = [];
+    wrappers = [];
+    tLen = 0;
+    source;
+    constructor(source) {
+        this.source = source;
+    }
+    pushGap = ([rStart, rEnd], block, boundary = "inline", projectSpace = true) => {
+        if (rEnd <= rStart)
+            return;
+        this.segments.push({
+            kind: "gap",
+            tStart: this.tLen,
+            tEnd: this.tLen + (projectSpace ? 1 : 0),
+            rStart,
+            rEnd,
+            block,
+            boundary,
+        });
+        if (projectSpace) {
+            this.parts.push(" ");
+            this.tLen++;
+        }
+    };
+    pushEntity = (text, rStart, rEnd, block) => {
+        if (!text)
+            return;
+        this.segments.push({
+            kind: "entity",
+            tStart: this.tLen,
+            tEnd: this.tLen + text.length,
+            rStart,
+            rEnd,
+            block,
+        });
+        this.parts.push(text);
+        this.tLen += text.length;
+    };
+    pushText = (rStart, rEnd, block) => {
+        const raw = this.source.slice(rStart, rEnd);
+        let last = 0;
+        for (const entity of decodedEntitiesIn(this.source, rStart, rEnd)) {
+            const localStart = entity.start - rStart;
+            const localEnd = entity.end - rStart;
+            if (localStart > last) {
+                const plain = raw.slice(last, localStart);
+                this.segments.push({
+                    kind: "text",
+                    tStart: this.tLen,
+                    tEnd: this.tLen + plain.length,
+                    rStart: rStart + last,
+                    rEnd: entity.start,
+                    block,
+                });
+                this.parts.push(plain);
+                this.tLen += plain.length;
+            }
+            this.pushEntity(entity.text, entity.start, entity.end, block);
+            last = localEnd;
+        }
+        if (last >= raw.length)
+            return;
+        const plain = raw.slice(last);
+        this.segments.push({
+            kind: "text",
+            tStart: this.tLen,
+            tEnd: this.tLen + plain.length,
+            rStart: rStart + last,
+            rEnd,
+            block,
+        });
+        this.parts.push(plain);
+        this.tLen += plain.length;
+    };
+    pushHtml = (raw, rStart, block) => {
+        const mapped = pageTextParts(raw);
+        for (const segment of mapped.segments) {
+            this.segments.push({
+                ...segment,
+                tStart: this.tLen + segment.tStart,
+                tEnd: this.tLen + segment.tEnd,
+                rStart: rStart + segment.rStart,
+                rEnd: rStart + segment.rEnd,
+                block,
+                ...(segment.kind === "gap" ? { boundary: "html" } : {}),
+            });
+        }
+        this.parts.push(mapped.text);
+        this.tLen += mapped.text.length;
+    };
+    locate = (raw, from, limit) => {
+        if (!raw)
+            return -1;
+        const at = this.source.indexOf(raw, from);
+        return at >= from && at + raw.length <= limit ? at : -1;
+    };
+    firstAuthoredLine = (raw) => {
+        let lineStart = 0;
+        while (lineStart < raw.length) {
+            const lineEnd = raw.indexOf("\n", lineStart);
+            const end = lineEnd < 0 ? raw.length : lineEnd;
+            const line = raw.slice(lineStart, end);
+            const text = line.trimStart();
+            if (text)
+                return { text, offset: lineStart + line.length - text.length };
+            if (lineEnd < 0)
+                break;
+            lineStart = lineEnd + 1;
+        }
+        return null;
+    };
+    /** A normalized container's full raw value may not occur anywhere in authored
+     *  source. Anchor on its first real line before checking the one plausible exact
+     *  start, avoiding a failed suffix-wide search for every sibling. */
+    exactStartAtAnchor = (raw, anchor, from, limit) => {
+        if (!raw)
+            return -1;
+        if (this.source.startsWith(raw, from) && from + raw.length <= limit)
+            return from;
+        if (anchor < 0)
+            return -1;
+        const first = this.firstAuthoredLine(raw);
+        if (!first)
+            return -1;
+        const candidate = anchor - first.offset;
+        return candidate >= from &&
+            candidate + raw.length <= limit &&
+            this.source.startsWith(raw, candidate)
+            ? candidate
+            : -1;
+    };
+    /** Find a stable authored foothold for a normalized container token. Marked
+     *  removes a blockquote/list prefix from every line, so the whole `raw` often is
+     *  absent while its first non-empty authored line is still exact. Descendants
+     *  are the fallback for wrapper tokens whose own first line is only structure. */
+    firstSourceAnchor = (token, from, limit) => {
+        const raw = token.raw ?? "";
+        if (raw && this.source.startsWith(raw, from) && from + raw.length <= limit)
+            return from;
+        const first = this.firstAuthoredLine(raw);
+        if (first) {
+            const at = this.locate(first.text, from, limit);
+            if (at >= 0)
+                return at;
+        }
+        for (const child of [...(token.tokens ?? []), ...(token.items ?? [])]) {
+            const at = this.firstSourceAnchor(child, from, limit);
+            if (at >= 0)
+                return at;
+        }
+        return -1;
+    };
+    result = () => ({
+        text: this.parts.join(""),
+        segments: this.segments,
+        wrappers: this.wrappers,
+    });
+}
+//# sourceMappingURL=source-markdown-projection.js.map

package/dist/protocol/source-markdown-projection.js.map

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

package/dist/protocol/source-markdown-types.d.ts

@@ -0,0 +1,32 @@
+import type { PageTextSegment } from "./source-text-segments.js";
+/** A page-text run projected from Markdown. `block` is the rendered editable block
+ *  that owns the text; an edit may cross inline syntax inside one block, but never
+ *  a paragraph/list/table boundary. */
+export interface MarkdownTextSegment extends PageTextSegment {
+    block: number;
+    boundary?: "inline" | "html" | "structural";
+}
+export interface MarkdownInlineWrapper {
+    kind: "strong" | "em" | "del" | "link" | "code";
+    at: number;
+    end: number;
+    contentStart: number;
+    contentEnd: number;
+    open: string;
+    close: string;
+}
+export interface MarkdownTextParts {
+    text: string;
+    segments: MarkdownTextSegment[];
+    wrappers: MarkdownInlineWrapper[];
+}
+export interface MarkdownToken {
+    type: string;
+    raw?: string;
+    text?: string;
+    tokens?: MarkdownToken[];
+    items?: MarkdownToken[];
+    header?: MarkdownToken[];
+    rows?: MarkdownToken[][];
+}
+//# sourceMappingURL=source-markdown-types.d.ts.map

package/dist/protocol/source-markdown-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-markdown-types.d.ts","sourceRoot":"","sources":["../../src/protocol/source-markdown-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhE;;uCAEuC;AACvC,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAA;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;IAC/C,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,mBAAmB,EAAE,CAAA;IAC/B,QAAQ,EAAE,qBAAqB,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAA;IACvB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE,aAAa,EAAE,EAAE,CAAA;CACzB"}

package/dist/protocol/source-markdown-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=source-markdown-types.js.map

package/dist/protocol/source-markdown-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-markdown-types.js","sourceRoot":"","sources":["../../src/protocol/source-markdown-types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,5 @@
+import type { MarkdownTextParts, MarkdownToken } from "./source-markdown-types.js";
+export type { MarkdownInlineWrapper, MarkdownTextParts, MarkdownTextSegment, MarkdownToken, } from "./source-markdown-types.js";
+/** Map rendered Markdown text to exact source ranges. The host supplies its renderer tokens. */
+export declare const projectMarkdownText: (source: string, tokens: readonly MarkdownToken[]) => MarkdownTextParts;
+//# sourceMappingURL=source-markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-markdown.d.ts","sourceRoot":"","sources":["../../src/protocol/source-markdown.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAElF,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,GACd,MAAM,4BAA4B,CAAA;AAEnC,gGAAgG;AAChG,eAAO,MAAM,mBAAmB,WACtB,MAAM,UACN,SAAS,aAAa,EAAE,KAC/B,iBAIF,CAAA"}

package/dist/protocol/source-markdown.js

@@ -0,0 +1,9 @@
+import { mapMarkdownBlocks } from "./source-markdown-blocks.js";
+import { MarkdownProjection } from "./source-markdown-projection.js";
+/** Map rendered Markdown text to exact source ranges. The host supplies its renderer tokens. */
+export const projectMarkdownText = (source, tokens) => {
+    const scan = new MarkdownProjection(source);
+    mapMarkdownBlocks(scan, tokens);
+    return scan.result();
+};
+//# sourceMappingURL=source-markdown.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-markdown.js","sourceRoot":"","sources":["../../src/protocol/source-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAUpE,gGAAgG;AAChG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,MAAc,EACd,MAAgC,EACb,EAAE;IACrB,MAAM,IAAI,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAA;IAC3C,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC/B,OAAO,IAAI,CAAC,MAAM,EAAE,CAAA;AACtB,CAAC,CAAA"}

package/dist/protocol/source-op-apply.d.ts

@@ -0,0 +1,14 @@
+export interface AppliedSourceOps {
+    html: string;
+    changes: {
+        before: string;
+        after: string;
+    }[];
+    /** Preserve the source version before a deletion so session Undo can read it. */
+    removedSource: boolean;
+}
+/** All operations apply, or none apply. Conflicts never overwrite changed source. */
+export declare const applySourceOps: (html: string, raw: unknown, 
+/** The host resolves only immutable versions of the authorized artifact. */
+historySource?: (version: number) => Promise<string | null>) => Promise<AppliedSourceOps>;
+//# sourceMappingURL=source-op-apply.d.ts.map

package/dist/protocol/source-op-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-op-apply.d.ts","sourceRoot":"","sources":["../../src/protocol/source-op-apply.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC5C,iFAAiF;IACjF,aAAa,EAAE,OAAO,CAAA;CACvB;AAyBD,qFAAqF;AACrF,eAAO,MAAM,cAAc,SACnB,MAAM,OACP,OAAO;AACZ,4EAA4E;gBAC5D,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAC1D,OAAO,CAAC,gBAAgB,CAkD1B,CAAA"}

package/dist/protocol/source-op-apply.js

@@ -0,0 +1,77 @@
+import { EditError } from "./source-edits.js";
+import { contains, sourceContentOps, sourceOverrides, sourcePlace, sourceVerbatim, spliceSource, } from "./source-op-context.js";
+import { disjoint, elementDigests, elementHashes, madeBy } from "./source-op-hash.js";
+import { loadSourceHistory, verifyRestoredIdentities } from "./source-op-history.js";
+import { indexElements } from "./source-op-index.js";
+import { parseSourceOps, SourceConflictError, staleSourceIds } from "./source-op-parse.js";
+import { removedSourceIn } from "./source-op-preservation.js";
+import { renderSourceTokens } from "./source-op-render.js";
+import { isVideoDocument, sliceScenes } from "./source-video.js";
+const verifySourceHashes = async (context, ops) => {
+    const hashes = elementHashes(context.html);
+    const conflicts = await staleSourceIds(ops, async (n) => hashes[n] ?? "", context.place);
+    if (conflicts.length)
+        throw new SourceConflictError(`${conflicts.length === 1 ? "An element" : `${conflicts.length} elements`} changed since this page was loaded: ${conflicts.map(context.place).join(", ")}. Reload to see the latest version, then redo ${conflicts.length === 1 ? "that edit" : "those edits"}.`, conflicts);
+};
+const replacementSource = (context, changes) => {
+    const links = context.els.filter((el) => el.tag.name === "a" && el.end >= 0);
+    return context.contentOps.map(({ op, el }) => {
+        const inLink = links.some((a) => a !== el && contains(a, el));
+        const text = renderSourceTokens(context, op.children, {
+            chain: [el],
+            inLink: inLink || el.tag.name === "a",
+        });
+        changes.push({ before: context.html.slice(el.tag.end, el.innerEnd), after: text });
+        return { start: el.tag.end, end: el.innerEnd, text };
+    });
+};
+/** All operations apply, or none apply. Conflicts never overwrite changed source. */
+export const applySourceOps = async (html, raw, 
+/** The host resolves only immutable versions of the authorized artifact. */
+historySource) => {
+    const ops = parseSourceOps(raw);
+    const els = indexElements(html);
+    const context = {
+        html,
+        els,
+        place: sourcePlace(html, els),
+        contentOps: [],
+        overrides: [],
+        verbatim: new Set(),
+        emitted: new Set(),
+        identities: null,
+        budget: 100 * 1024 * 1024,
+        history: new Map(),
+    };
+    context.history = await loadSourceHistory(ops, historySource);
+    await verifySourceHashes(context, ops);
+    context.contentOps = sourceContentOps(context, ops);
+    context.overrides = sourceOverrides(context, ops);
+    for (const { op } of context.contentOps)
+        sourceVerbatim(context, op.children);
+    const changes = [];
+    const segments = [...context.overrides, ...replacementSource(context, changes)].toSorted((a, b) => a.start - b.start || b.end - a.end);
+    const out = spliceSource(html, { start: 0, end: html.length }, segments);
+    if (context.history.size)
+        verifyRestoredIdentities(html, out);
+    if (isVideoDocument(html) && sliceScenes(out).length === 0)
+        throw new EditError("A video must keep at least one scene.");
+    if (out === html)
+        throw new EditError("These ops leave the document exactly as it is, so there is nothing to save.");
+    if (elementDigests.peek(html) && out.length >= 32_768)
+        madeBy.set(out, { from: html, segments: disjoint(segments) });
+    return {
+        html: out,
+        changes,
+        removedSource: removedSourceIn(ops, els
+            .filter((node) => node.stamped)
+            .map((node) => ({
+            src: node.n,
+            start: node.tag.start,
+            end: node.end,
+            contentStart: node.tag.end,
+            contentEnd: node.innerEnd,
+        }))),
+    };
+};
+//# sourceMappingURL=source-op-apply.js.map

package/dist/protocol/source-op-apply.js.map

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

package/dist/protocol/source-op-context.d.ts

@@ -0,0 +1,35 @@
+import type { CopyIdentities } from "./source-copy-identities.js";
+import type { Segment } from "./source-op-hash.js";
+import type { SourceNode } from "./source-op-index.js";
+import type { SourceOp, SourceToken } from "./source-op-types.js";
+export interface SourceContentOp {
+    op: Extract<SourceOp, {
+        op: "content";
+    }>;
+    el: SourceNode;
+}
+export interface SourceApplyContext {
+    html: string;
+    els: readonly SourceNode[];
+    place: (n: number) => string;
+    contentOps: SourceContentOp[];
+    overrides: Segment[];
+    verbatim: Set<SourceNode>;
+    emitted: Set<SourceNode>;
+    identities: CopyIdentities | null;
+    budget: number;
+    history: ReadonlyMap<number, SourceApplyContext>;
+}
+export declare const sourcePlace: (html: string, els: readonly SourceNode[]) => ((n: number) => string);
+export declare const sourceFail: (message: string) => never;
+export declare const sourceAt: (context: SourceApplyContext, n: number) => SourceNode;
+export declare const contains: (outer: SourceNode, inner: SourceNode) => boolean;
+export declare const holdsSourceChildren: (context: SourceApplyContext, el: SourceNode, role: string) => void;
+export declare const sourceContentOps: (context: SourceApplyContext, ops: SourceOp[]) => SourceContentOp[];
+export declare const sourceOverrides: (context: SourceApplyContext, ops: SourceOp[]) => Segment[];
+export declare const sourceVerbatim: (context: SourceApplyContext, list: SourceToken[]) => void;
+export declare const spliceSource: (html: string, range: {
+    start: number;
+    end: number;
+}, segments: Segment[]) => string;
+//# sourceMappingURL=source-op-context.d.ts.map

package/dist/protocol/source-op-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-op-context.d.ts","sourceRoot":"","sources":["../../src/protocol/source-op-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAKjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAMjE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE;QAAE,EAAE,EAAE,SAAS,CAAA;KAAE,CAAC,CAAA;IACxC,EAAE,EAAE,UAAU,CAAA;CACf;AACD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,SAAS,UAAU,EAAE,CAAA;IAC1B,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IAC5B,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,SAAS,EAAE,OAAO,EAAE,CAAA;IACpB,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,CAAA;IACzB,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC,CAAA;IACxB,UAAU,EAAE,cAAc,GAAG,IAAI,CAAA;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;CACjD;AACD,eAAO,MAAM,WAAW,SAAU,MAAM,OAAO,SAAS,UAAU,EAAE,KAAG,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAc5F,CAAA;AACD,eAAO,MAAM,UAAU,YAAa,MAAM,KAAG,KAE5C,CAAA;AACD,eAAO,MAAM,QAAQ,YAAa,kBAAkB,KAAK,MAAM,KAAG,UACpC,CAAA;AAC9B,eAAO,MAAM,QAAQ,UAAW,UAAU,SAAS,UAAU,KAAG,OACF,CAAA;AAE9D,eAAO,MAAM,mBAAmB,YACrB,kBAAkB,MACvB,UAAU,QACR,MAAM,KACX,IAcF,CAAA;AACD,eAAO,MAAM,gBAAgB,YAClB,kBAAkB,OACtB,QAAQ,EAAE,KACd,eAAe,EAajB,CAAA;AACD,eAAO,MAAM,eAAe,YAAa,kBAAkB,OAAO,QAAQ,EAAE,KAAG,OAAO,EA4BrF,CAAA;AACD,eAAO,MAAM,cAAc,YAAa,kBAAkB,QAAQ,WAAW,EAAE,KAAG,IAMjF,CAAA;AACD,eAAO,MAAM,YAAY,SACjB,MAAM,SACL;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,YAC3B,OAAO,EAAE,KAClB,MAUF,CAAA"}

package/dist/protocol/source-op-context.js

@@ -0,0 +1,97 @@
+import { sliceSlides } from "./source-deck-elements.js";
+import { EditError } from "./source-edits.js";
+import { RAW_TEXT_ELEMENTS, RCDATA_ELEMENTS } from "./source-html.js";
+import { setLayoutAttributes } from "./source-layout.js";
+import { escapeSourceAttribute } from "./source-stamp.js";
+import { setOpeningTagStyle } from "./source-style.js";
+import { setVideoSceneAttributes, VIDEO_SCENE_ATTRIBUTES } from "./source-video-attributes.js";
+const OPAQUE = new Set([...RAW_TEXT_ELEMENTS, ...RCDATA_ELEMENTS, "template", "noscript"]);
+export const sourcePlace = (html, els) => {
+    let slides = null;
+    return (n) => {
+        if (slides === null) {
+            try {
+                slides = sliceSlides(html);
+            }
+            catch {
+                slides = [];
+            }
+        }
+        const el = els[n];
+        const slide = el && slides.find((s) => s.start <= el.tag.start && el.tag.start < s.end);
+        return slide ? `slide ${slide.position} (element ${n})` : `element ${n}`;
+    };
+};
+export const sourceFail = (message) => {
+    throw new EditError(message);
+};
+export const sourceAt = (context, n) => context.els[n];
+export const contains = (outer, inner) => outer.tag.start <= inner.tag.start && inner.end <= outer.end;
+export const holdsSourceChildren = (context, el, role) => {
+    if (el.tag.selfClosing || OPAQUE.has(el.tag.name))
+        sourceFail(`${context.place(el.n)} is a <${el.tag.name}>, whose content can't be ${role}.`);
+    for (let k = el.n + 1; k < context.els.length && context.els[k].tag.start < el.innerEnd; k++) {
+        const child = context.els[k];
+        if (child.stamped && child.end < 0)
+            sourceFail(`${context.place(el.n)} can't be ${role}: ${context.place(k)} inside it has markup whose end the source doesn't state. Edit the source directly.`);
+    }
+};
+export const sourceContentOps = (context, ops) => {
+    const contentOps = ops
+        .flatMap((op) => (op.op === "content" ? [{ op, el: sourceAt(context, op.src) }] : []))
+        .toSorted((a, b) => a.el.tag.start - b.el.tag.start);
+    for (const [i, { el }] of contentOps.entries()) {
+        const prev = contentOps[i - 1]?.el;
+        if (prev && el.tag.start < prev.end)
+            sourceFail(`${context.place(el.n)} is inside ${context.place(prev.n)}, which the same save also edits — express the inner change with keep+children.`);
+        holdsSourceChildren(context, el, "edited");
+    }
+    return contentOps;
+};
+export const sourceOverrides = (context, ops) => {
+    const overrides = [];
+    for (const op of ops) {
+        if (op.op !== "attrs")
+            continue;
+        const el = sourceAt(context, op.src);
+        if (overrides.some((s) => s.start === el.tag.start))
+            sourceFail(`${context.place(el.n)} has two attrs ops in one save.`);
+        let text = context.html.slice(el.tag.start, el.tag.end);
+        if (op.style !== undefined)
+            text = setOpeningTagStyle(text, op.style === null ? null : escapeSourceAttribute(op.style).replaceAll("'", "&#39;"));
+        if (op.attrs) {
+            const label = context.place(el.n);
+            const entries = Object.entries(op.attrs);
+            const video = Object.fromEntries(entries.filter(([name]) => VIDEO_SCENE_ATTRIBUTES.has(name)));
+            const layout = Object.fromEntries(entries.filter(([name]) => !VIDEO_SCENE_ATTRIBUTES.has(name)));
+            if (Object.keys(video).length)
+                text = setVideoSceneAttributes(context.html, el.tag, text, video);
+            if (Object.keys(layout).length)
+                text = setLayoutAttributes(text, layout, label[0]?.toUpperCase() + label.slice(1));
+        }
+        overrides.push({ start: el.tag.start, end: el.tag.end, text });
+    }
+    return overrides.toSorted((a, b) => a.start - b.start);
+};
+export const sourceVerbatim = (context, list) => {
+    for (const t of list) {
+        if ("keep" in t && !t.children && t.version === undefined)
+            context.verbatim.add(sourceAt(context, t.keep));
+        else if ("children" in t && t.children)
+            sourceVerbatim(context, t.children);
+    }
+};
+export const spliceSource = (html, range, segments) => {
+    let out = "";
+    let cursor = range.start;
+    for (const s of segments) {
+        if (s.start >= range.end)
+            break;
+        if (s.start < cursor)
+            continue;
+        out += html.slice(cursor, s.start) + s.text;
+        cursor = s.end;
+    }
+    return out + html.slice(cursor, range.end);
+};
+//# sourceMappingURL=source-op-context.js.map

package/dist/protocol/source-op-context.js.map

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

package/dist/protocol/source-op-hash.d.ts

@@ -0,0 +1,36 @@
+import { Recent } from "./source-cache.js";
+import type { SourceHash } from "./source-op-types.js";
+export interface Segment {
+    start: number;
+    end: number;
+    text: string;
+}
+/** The sha256 of stored source text, as the editor's page and source map report it. */
+export declare const sourceSha: (html: string) => Promise<string>;
+/** The hash an op names a source slice by (Markdown's nodes). */
+export declare const hashSource: (text: string) => SourceHash;
+/** A document an op save made from another, and where: `segments` are the old
+ *  document's replaced ranges (sorted, disjoint) with their new text. Lets the new
+ *  document's hashes reuse every digest of an element the save left alone. */
+export declare const madeBy: Recent<string, {
+    from: string;
+    segments: readonly Segment[];
+}>;
+/** The segments a splice applies: sorted, and each one starting past the last. */
+export declare const disjoint: (segments: readonly Segment[]) => Segment[];
+interface Digests {
+    hex: SourceHash[];
+    /** Each element's full digest (32 bytes at 32·N), all zero where it has none. */
+    full: Uint8Array;
+}
+export declare const elementDigests: ((html: string) => Digests) & {
+    peek: (html: string) => Digests | undefined;
+};
+export declare const elementHashes: (html: string) => readonly SourceHash[];
+/** Every source id's hash, and the sha of the whole source (see elementHashes). */
+export declare const sourceMap: (html: string) => Promise<{
+    sha: string;
+    hashes: SourceHash[];
+}>;
+export {};
+//# sourceMappingURL=source-op-hash.d.ts.map

package/dist/protocol/source-op-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-op-hash.d.ts","sourceRoot":"","sources":["../../src/protocol/source-op-hash.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAGlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtD,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb;AAwBD,uFAAuF;AACvF,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,OAAO,CAAC,MAAM,CAA4B,CAAA;AAEnF,iEAAiE;AACjE,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,UAGzC,CAAA;AAMD;;8EAE8E;AAC9E,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,CAAiB,CAAA;AAEnG,kFAAkF;AAClF,eAAO,MAAM,QAAQ,aAAc,SAAS,OAAO,EAAE,KAAG,OAAO,EAS9D,CAAA;AAED,UAAU,OAAO;IACf,GAAG,EAAE,UAAU,EAAE,CAAA;IACjB,iFAAiF;IACjF,IAAI,EAAE,UAAU,CAAA;CACjB;AA0FD,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG;IACzD,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAA;CAwC3C,CAAA;AACF,eAAO,MAAM,aAAa,SAAU,MAAM,KAAG,SAAS,UAAU,EAA8B,CAAA;AAE9F,mFAAmF;AACnF,eAAO,MAAM,SAAS,SAAgB,MAAM,KAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAG1F,CAAA"}