@derive-to/artifacts 0.0.0-stage → 0.6.1

package/dist/protocol/source-video-edits.js

@@ -0,0 +1,85 @@
+import { copyIdentitiesOf, copyWithFreshIdentities } from "./source-copy-identities.js";
+import { EditError } from "./source-edits.js";
+import { setAttribute } from "./source-layout.js";
+import { escapeSourceAttribute } from "./source-stamp.js";
+import { sliceScenes, VIDEO_TRANSITIONS } from "./source-video.js";
+import { nextVideoSceneId } from "./source-video-id.js";
+const boundedInteger = (value, min, max, label) => {
+    if (typeof value !== "number" || !Number.isInteger(value) || value < min || value > max)
+        throw new EditError(`${label} must be a whole number between ${min} and ${max}.`);
+    return value;
+};
+const setSceneAttribute = (tag, name, value) => setAttribute(tag, name, escapeSourceAttribute(value).replaceAll("'", "&#39;"));
+const updateScene = (html, scene, edit) => {
+    let opening = html.slice(scene.openStart, scene.openEnd);
+    if (edit.duration_ms !== undefined)
+        opening = setSceneAttribute(opening, "data-duration-ms", String(boundedInteger(edit.duration_ms, 1000, 30000, "Scene duration")));
+    if (edit.transition !== undefined) {
+        if (!VIDEO_TRANSITIONS.has(edit.transition))
+            throw new EditError(`Unknown scene transition "${edit.transition}".`);
+        opening = setSceneAttribute(opening, "data-transition", edit.transition);
+    }
+    if (edit.transition_ms !== undefined)
+        opening = setSceneAttribute(opening, "data-transition-ms", String(boundedInteger(edit.transition_ms, 100, 2000, "Transition duration")));
+    if (edit.caption !== undefined) {
+        if (typeof edit.caption !== "string" || edit.caption.length > 500)
+            throw new EditError("Scene caption must be at most 500 characters.");
+        opening = setSceneAttribute(opening, "data-derive-caption", edit.caption);
+    }
+    return html.slice(0, scene.openStart) + opening + html.slice(scene.openEnd);
+};
+const moveScene = (html, scenes, at, direction) => {
+    if (direction !== "previous" && direction !== "next")
+        throw new EditError(`Scene move direction ${JSON.stringify(direction)} is invalid — use "previous" or "next".`);
+    const to = direction === "previous" ? at - 1 : at + 1;
+    if (to < 0 || to >= scenes.length)
+        return html;
+    const scene = scenes[at], other = scenes[to];
+    const first = direction === "previous" ? other : scene, second = direction === "previous" ? scene : other;
+    const between = html.slice(first.end, second.start);
+    if (between.trim())
+        throw new EditError("Content between scenes prevents a safe reorder.");
+    return (html.slice(0, first.start) +
+        html.slice(second.start, second.end) +
+        between +
+        html.slice(first.start, first.end) +
+        html.slice(second.end));
+};
+const applySceneEdit = (html, edit) => {
+    const scenes = sliceScenes(html), at = scenes.findIndex((s) => s.id === edit.id);
+    if (at < 0)
+        throw new EditError(`Scene "${edit.id}" no longer exists.`);
+    const scene = scenes[at];
+    switch (edit.op) {
+        case "scene-update":
+            return updateScene(html, scene, edit);
+        case "scene-delete": {
+            if (scenes.length === 1)
+                throw new EditError("A video must keep at least one scene.");
+            return html.slice(0, scene.start) + html.slice(scene.end);
+        }
+        case "scene-duplicate": {
+            const copied = copyWithFreshIdentities(html.slice(scene.start, scene.end), copyIdentitiesOf(html));
+            const copy = setSceneAttribute(copied, "data-derive-scene", nextVideoSceneId(new Set(scenes.map((s) => s.id))));
+            return `${html.slice(0, scene.end)}\n${copy}${html.slice(scene.end)}`;
+        }
+        case "scene-move":
+            return moveScene(html, scenes, at, edit.direction);
+        default:
+            throw new EditError(`Unknown scene operation ${JSON.stringify(edit.op)}.`);
+    }
+};
+/** Source scene changes are atomic. New copies cannot share DOM or structural identities. */
+export const applySceneEdits = (html, edits) => {
+    if (!Array.isArray(edits) || edits.length === 0)
+        throw new EditError("`edits` contains no scene operations.");
+    if (edits.length > 200)
+        throw new EditError("A video edit can contain at most 200 scene operations.");
+    let out = html;
+    for (const edit of edits)
+        out = applySceneEdit(out, edit);
+    if (out === html)
+        throw new EditError("Those scene edits leave the video exactly as it is; nothing to publish.");
+    return out;
+};
+//# sourceMappingURL=source-video-edits.js.map

package/dist/protocol/source-video-edits.js.map

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

package/dist/protocol/source-video-id.d.ts

@@ -0,0 +1,4 @@
+export declare const VIDEO_SCENE_ID: RegExp;
+/** Source edits and frame previews mint the same next scene identity. */
+export declare const nextVideoSceneId: (used: ReadonlySet<string>) => string;
+//# sourceMappingURL=source-video-id.d.ts.map

package/dist/protocol/source-video-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-video-id.d.ts","sourceRoot":"","sources":["../../src/protocol/source-video-id.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,EAAE,MAAwC,CAAA;AAErE,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,SAAU,WAAW,CAAC,MAAM,CAAC,KAAG,MAI5D,CAAA"}

package/dist/protocol/source-video-id.js

@@ -0,0 +1,9 @@
+export const VIDEO_SCENE_ID = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
+/** Source edits and frame previews mint the same next scene identity. */
+export const nextVideoSceneId = (used) => {
+    let n = used.size + 1;
+    while (used.has(`scene-${n}`))
+        n++;
+    return `scene-${n}`;
+};
+//# sourceMappingURL=source-video-id.js.map

package/dist/protocol/source-video-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-video-id.js","sourceRoot":"","sources":["../../src/protocol/source-video-id.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAW,+BAA+B,CAAA;AAErE,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAyB,EAAU,EAAE;IACpE,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;IACrB,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAAE,CAAC,EAAE,CAAA;IAClC,OAAO,SAAS,CAAC,EAAE,CAAA;AACrB,CAAC,CAAA"}

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

@@ -0,0 +1,38 @@
+export declare const VIDEO_CONTENT_TYPE = "text/x-derive-video";
+export declare const VIDEO_TRANSITIONS: Set<string>;
+export interface VideoScene {
+    position: number;
+    start: number;
+    end: number;
+    openStart: number;
+    openEnd: number;
+    id: string;
+    durationMs: number;
+    transition: string;
+    transitionMs: number;
+    title?: string;
+    caption?: string;
+}
+export type SceneEdit = {
+    op: "scene-update";
+    id: string;
+    duration_ms?: number;
+    transition?: "cut" | "fade" | "dissolve" | "slide";
+    transition_ms?: number;
+    caption?: string;
+} | {
+    op: "scene-move";
+    id: string;
+    direction: "previous" | "next";
+} | {
+    op: "scene-duplicate";
+    id: string;
+} | {
+    op: "scene-delete";
+    id: string;
+};
+export declare const isSceneEdit: (value: unknown) => value is SceneEdit;
+/** Real source attributes identify video roots and scenes. Quoted examples stay inert. */
+export declare const sliceScenes: (html: string) => VideoScene[];
+export declare const isVideoDocument: (html: string) => boolean;
+//# sourceMappingURL=source-video.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-video.d.ts","sourceRoot":"","sources":["../../src/protocol/source-video.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,kBAAkB,wBAAwB,CAAA;AAEvD,eAAO,MAAM,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAiD,CAAA;AAC3F,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AACD,MAAM,MAAM,SAAS,GACjB;IACE,EAAE,EAAE,cAAc,CAAA;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAA;IAClD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GACD;IAAE,EAAE,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAAA;CAAE,GAChE;IAAE,EAAE,EAAE,iBAAiB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AACtC,eAAO,MAAM,WAAW,UAAW,OAAO,KAAG,KAAK,IAAI,SAIO,CAAA;AA0F7D,0FAA0F;AAC1F,eAAO,MAAM,WAAW,SAAU,MAAM,KAAG,UAAU,EAgBpD,CAAA;AACD,eAAO,MAAM,eAAe,SAAU,MAAM,KAAG,OAO9C,CAAA"}

package/dist/protocol/source-video.js

@@ -0,0 +1,116 @@
+import { DecodingMode, decodeHTML } from "entities/decode";
+import { EditError } from "./source-edits.js";
+import { attrValue, attrValues, elementEnd, hasAttr } from "./source-html.js";
+import { tags } from "./source-tags.js";
+import { VIDEO_SCENE_ID } from "./source-video-id.js";
+export const VIDEO_CONTENT_TYPE = "text/x-derive-video";
+const SCENE_TAGS = new Set(["section", "div", "article"]);
+export const VIDEO_TRANSITIONS = new Set(["cut", "fade", "dissolve", "slide"]);
+export const isSceneEdit = (value) => !!value &&
+    typeof value === "object" &&
+    typeof value.op === "string" &&
+    String(value.op).startsWith("scene-");
+const videoRoot = (all) => {
+    const roots = all
+        .map((tag, i) => ({ tag, i }))
+        .filter(({ tag }) => !tag.closing && hasAttr(tag.attrs, "data-derive-video"));
+    if (roots.length !== 1)
+        throw new EditError("An HTML video needs exactly one data-derive-video root.");
+    const root = roots[0];
+    const end = elementEnd(all, root.i);
+    if (end < 0)
+        throw new EditError("The data-derive-video root is never closed.");
+    return { tag: root.tag, end };
+};
+const readTiming = (attrs, name, rule) => {
+    const raw = attrValue(attrs, name);
+    const value = raw === null ? rule.fallback : Number(raw);
+    if (!Number.isInteger(value) || value < rule.min || value > rule.max)
+        throw new EditError(rule.error);
+    return value;
+};
+const sceneTiming = (open, id) => {
+    const durationMs = readTiming(open.attrs, "data-duration-ms", {
+        fallback: 5000,
+        min: 1000,
+        max: 30000,
+        error: `Scene "${id}" duration must be a whole number from 1000 to 30000 ms.`,
+    });
+    const transition = attrValue(open.attrs, "data-transition") || "cut";
+    if (!VIDEO_TRANSITIONS.has(transition))
+        throw new EditError(`Scene "${id}" has unknown transition "${transition}".`);
+    const transitionMs = readTiming(open.attrs, "data-transition-ms", {
+        fallback: 300,
+        min: 100,
+        max: 2000,
+        error: `Scene "${id}" transition duration must be 100 to 2000 ms.`,
+    });
+    return { durationMs, transition, transitionMs };
+};
+const sceneOf = (html, all, index) => {
+    const open = all[index];
+    const sceneIds = attrValues(open.attrs, "data-derive-scene");
+    if (sceneIds.length > 1)
+        throw new EditError("A video scene has more than one data-derive-scene attribute, so its identity is ambiguous.");
+    const id = sceneIds[0] ?? null;
+    if (!id)
+        return null;
+    if (!VIDEO_SCENE_ID.test(id))
+        throw new EditError(`Scene "${id}" needs a short stable id beginning with a letter and using only letters, numbers, - or _.`);
+    const end = elementEnd(all, index);
+    if (end < 0)
+        throw new EditError(`Scene "${id}" is never closed, so the video cannot be edited safely.`);
+    const timing = sceneTiming(open, id);
+    const source = html.slice(open.start, end);
+    const heading = /<h[1-6]\b[^>]*>([\s\S]*?)<\/h[1-6]>/i.exec(source)?.[1];
+    const title = attrValue(open.attrs, "data-derive-scene-title") ||
+        heading
+            ?.replace(/<[^<>]+>/g, " ")
+            .replace(/\s+/g, " ")
+            .trim();
+    const encodedCaption = attrValue(open.attrs, "data-derive-caption");
+    const caption = encodedCaption === null ? null : decodeHTML(encodedCaption, DecodingMode.Attribute);
+    return {
+        position: 0,
+        start: open.start,
+        end,
+        openStart: open.start,
+        openEnd: open.end,
+        id,
+        ...timing,
+        ...(title ? { title } : {}),
+        ...(caption ? { caption } : {}),
+    };
+};
+const sceneStart = (open, root) => !open.closing && SCENE_TAGS.has(open.name) && open.start > root.tag.start && open.start < root.end;
+/** Real source attributes identify video roots and scenes. Quoted examples stay inert. */
+export const sliceScenes = (html) => {
+    const all = tags(html);
+    const root = videoRoot(all);
+    const spans = [];
+    for (const [index, open] of all.entries()) {
+        if (!sceneStart(open, root))
+            continue;
+        const scene = sceneOf(html, all, index);
+        if (scene)
+            spans.push(scene);
+    }
+    for (let i = 1; i < spans.length; i++)
+        if (spans[i].start < spans[i - 1].end)
+            throw new EditError("A video scene is nested inside another scene. Edit the source directly.");
+    const ids = spans.map((s) => s.id);
+    if (new Set(ids).size !== ids.length)
+        throw new EditError("Every video scene needs a unique data-derive-scene value.");
+    return spans.map((s, i) => ({ ...s, position: i + 1 }));
+};
+export const isVideoDocument = (html) => {
+    if (!/data-derive-video(?:\s|=|>)/i.test(html))
+        return false;
+    try {
+        return sliceScenes(html).length > 0;
+    }
+    catch {
+        return false;
+    }
+};
+//# sourceMappingURL=source-video.js.map

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

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

package/dist/protocol/source.d.ts

@@ -0,0 +1,47 @@
+export * from "./source-anchors.js";
+export * from "./source-assets.js";
+export { lastOf, Recent } from "./source-cache.js";
+export { type CopyIdentities, copyIdentitiesOf, copyWithFreshIdentities, STRUCTURAL_ID, } from "./source-copy-identities.js";
+export * from "./source-deck.js";
+export { isSlideAttrs, nextUnusedSlideId, type SlideSpan, sliceSlides, } from "./source-deck-elements.js";
+export { applySlideOps, MAX_SLIDE_OPS, type SlideOp } from "./source-deck-ops.js";
+export * from "./source-edits.js";
+export * from "./source-element-edits.js";
+export * from "./source-elements.js";
+export * from "./source-hash.js";
+export * from "./source-head.js";
+export * from "./source-html.js";
+export { StructuralEditError, setLayoutAttributes } from "./source-layout.js";
+export { type MarkdownInlineWrapper, type MarkdownTextParts, type MarkdownTextSegment, type MarkdownToken, projectMarkdownText, } from "./source-markdown.js";
+export { hydrateMarkdownHistory, type MarkdownHistoryInput, markdownHistoryEdge, markdownHistoryGap, } from "./source-markdown-history.js";
+export * from "./source-markdown-model.js";
+export { type AppliedMarkdownSourceOps, applyMarkdownSourceOps, type MarkdownSourceCodec, } from "./source-markdown-ops.js";
+export { type AppliedSourceOps, applySourceOps } from "./source-op-apply.js";
+export { hashSource, sourceMap, sourceSha } from "./source-op-hash.js";
+export { parseSourceOps, SourceConflictError, staleSourceIds } from "./source-op-parse.js";
+export { removedSourceIn, type SourceNodeRange } from "./source-op-preservation.js";
+export type * from "./source-op-types.js";
+export { parseSourceQuoteSelector, type SourceQuoteSelector } from "./source-quote-selector.js";
+export { type SourceElement, sourceElements } from "./source-ranges.js";
+export { docOutline, htmlBodyEnd, htmlHeadings, htmlSectionSpans, sectionSlice, } from "./source-read-html-navigation.js";
+export { LANDMARK_TAGS, type LandmarkRegion, type LandmarkSpan, labelledLandmarks, landmarkMap, landmarkSlice, landmarkSpans, } from "./source-read-landmarks.js";
+export { htmlToMarkdown } from "./source-read-markdown.js";
+export { enclosingMarker, headingSlug, headingSlugger, markdownHeadings, markersFromOffsets, type OutlineSection, type SectionMarker, type SectionSpan, type SourceHeading, spansFromHeadings, } from "./source-read-spine.js";
+export * from "./source-reflow.js";
+export { hostMarker, stampSourceIds, withHostMarker } from "./source-stamp.js";
+export { syncStamped } from "./source-stamped-sync.js";
+export { applyStructuralEdits } from "./source-structural-apply.js";
+export { backfillLegacyDeckStructure } from "./source-structural-backfill.js";
+export { inspectStructuralDocument } from "./source-structural-inspect.js";
+export { isStructuralEdit, isStructuralUserEdit } from "./source-structural-targets.js";
+export type { StructuralAlignEdit, StructuralBackfillResult, StructuralBackfillSkip, StructuralDimensionsEdit, StructuralEdit, StructuralEditReceipt, StructuralEditResult, StructuralGapEdit, StructuralLayout, StructuralNodeInspection, StructuralOpeningRestoreEdit, StructuralOrderEdit, StructuralRegionInspection, StructuralRegionOpeningRestoreEdit, StructuralRemoveEdit, StructuralRestoreEdit, StructuralSize, StructuralSizeEdit, StructuralUserEdit, StructuralWidthEdit, } from "./source-structural-types.js";
+export { STRUCTURAL_EDIT_SCHEMA, STRUCTURAL_RECEIPT_SCHEMA } from "./source-structural-types.js";
+export * from "./source-style.js";
+export { tags } from "./source-tags.js";
+export * from "./source-text.js";
+export * from "./source-text-range.js";
+export { isSceneEdit, isVideoDocument, type SceneEdit, sliceScenes, VIDEO_CONTENT_TYPE, type VideoScene, } from "./source-video.js";
+export { setVideoSceneAttributes, VIDEO_SCENE_ATTRIBUTES } from "./source-video-attributes.js";
+export { applySceneEdits } from "./source-video-edits.js";
+export { nextVideoSceneId } from "./source-video-id.js";
+//# sourceMappingURL=source.d.ts.map

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

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

package/dist/protocol/source.js

@@ -0,0 +1,45 @@
+export * from "./source-anchors.js";
+export * from "./source-assets.js";
+export { lastOf, Recent } from "./source-cache.js";
+export { copyIdentitiesOf, copyWithFreshIdentities, STRUCTURAL_ID, } from "./source-copy-identities.js";
+export * from "./source-deck.js";
+export { isSlideAttrs, nextUnusedSlideId, sliceSlides, } from "./source-deck-elements.js";
+export { applySlideOps, MAX_SLIDE_OPS } from "./source-deck-ops.js";
+export * from "./source-edits.js";
+export * from "./source-element-edits.js";
+export * from "./source-elements.js";
+export * from "./source-hash.js";
+export * from "./source-head.js";
+export * from "./source-html.js";
+export { StructuralEditError, setLayoutAttributes } from "./source-layout.js";
+export { projectMarkdownText, } from "./source-markdown.js";
+export { hydrateMarkdownHistory, markdownHistoryEdge, markdownHistoryGap, } from "./source-markdown-history.js";
+export * from "./source-markdown-model.js";
+export { applyMarkdownSourceOps, } from "./source-markdown-ops.js";
+export { applySourceOps } from "./source-op-apply.js";
+export { hashSource, sourceMap, sourceSha } from "./source-op-hash.js";
+export { parseSourceOps, SourceConflictError, staleSourceIds } from "./source-op-parse.js";
+export { removedSourceIn } from "./source-op-preservation.js";
+export { parseSourceQuoteSelector } from "./source-quote-selector.js";
+export { sourceElements } from "./source-ranges.js";
+export { docOutline, htmlBodyEnd, htmlHeadings, htmlSectionSpans, sectionSlice, } from "./source-read-html-navigation.js";
+export { LANDMARK_TAGS, labelledLandmarks, landmarkMap, landmarkSlice, landmarkSpans, } from "./source-read-landmarks.js";
+export { htmlToMarkdown } from "./source-read-markdown.js";
+export { enclosingMarker, headingSlug, headingSlugger, markdownHeadings, markersFromOffsets, spansFromHeadings, } from "./source-read-spine.js";
+export * from "./source-reflow.js";
+export { hostMarker, stampSourceIds, withHostMarker } from "./source-stamp.js";
+export { syncStamped } from "./source-stamped-sync.js";
+export { applyStructuralEdits } from "./source-structural-apply.js";
+export { backfillLegacyDeckStructure } from "./source-structural-backfill.js";
+export { inspectStructuralDocument } from "./source-structural-inspect.js";
+export { isStructuralEdit, isStructuralUserEdit } from "./source-structural-targets.js";
+export { STRUCTURAL_EDIT_SCHEMA, STRUCTURAL_RECEIPT_SCHEMA } from "./source-structural-types.js";
+export * from "./source-style.js";
+export { tags } from "./source-tags.js";
+export * from "./source-text.js";
+export * from "./source-text-range.js";
+export { isSceneEdit, isVideoDocument, sliceScenes, VIDEO_CONTENT_TYPE, } from "./source-video.js";
+export { setVideoSceneAttributes, VIDEO_SCENE_ATTRIBUTES } from "./source-video-attributes.js";
+export { applySceneEdits } from "./source-video-edits.js";
+export { nextVideoSceneId } from "./source-video-id.js";
+//# sourceMappingURL=source.js.map

package/dist/protocol/source.js.map

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

package/dist/protocol/state-apply.d.ts

@@ -0,0 +1,22 @@
+import type { Mutation, Snapshot, StateItem } from "./state.js";
+/** Ownership fields stay private. The default kit and its offline runtime share these rules. */
+export type StoredItem = StateItem & {
+    __actor?: string | undefined;
+    __slot?: string | undefined;
+};
+export interface Applied {
+    items: StoredItem[];
+    itemId: string;
+    changed: boolean;
+}
+type Outcome = Applied | {
+    error: string;
+};
+export declare const isWithinInteract: (mutation: Mutation) => boolean;
+export declare const applyMutation: (items: StoredItem[], mutation: Mutation, actorId: string, newItemId: string) => Outcome;
+export declare const seedItems: (initial: Record<string, unknown>[], mintId: () => string) => StoredItem[] | {
+    error: string;
+};
+export declare const snapshotFor: (items: StoredItem[] | null, version: number, actorId: string | null) => Snapshot;
+export {};
+//# sourceMappingURL=state-apply.d.ts.map

package/dist/protocol/state-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-apply.d.ts","sourceRoot":"","sources":["../../src/protocol/state-apply.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE/D,gGAAgG;AAChG,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAClG,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;CACjB;AACD,KAAK,OAAO,GAAG,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAI1C,eAAO,MAAM,gBAAgB,aAAc,QAAQ,KAAG,OAAyC,CAAA;AAE/F,eAAO,MAAM,aAAa,UACjB,UAAU,EAAE,YACT,QAAQ,WACT,MAAM,aACJ,MAAM,KAChB,OAGF,CAAA;AAED,eAAO,MAAM,SAAS,YACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAC1B,MAAM,MAAM,KACnB,UAAU,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAGhC,CAAA;AAED,eAAO,MAAM,WAAW,UACf,UAAU,EAAE,GAAG,IAAI,WACjB,MAAM,WACN,MAAM,GAAG,IAAI,KACrB,QAAmD,CAAA"}

package/dist/protocol/state-apply.js

@@ -0,0 +1,13 @@
+import { createCollectionRules, DEFAULT_COLLECTION_DIALECT } from "./collection.js";
+const rules = createCollectionRules(DEFAULT_COLLECTION_DIALECT);
+export const isWithinInteract = (mutation) => rules.withinInteract(mutation);
+export const applyMutation = (items, mutation, actorId, newItemId) => {
+    const outcome = rules.apply(items, mutation, actorId, newItemId);
+    return "error" in outcome ? { error: outcome.error } : outcome;
+};
+export const seedItems = (initial, mintId) => {
+    const outcome = rules.read(initial, { mintId });
+    return "error" in outcome ? { error: outcome.error } : outcome;
+};
+export const snapshotFor = (items, version, actorId) => rules.snapshot(items, version, actorId);
+//# sourceMappingURL=state-apply.js.map

package/dist/protocol/state-apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-apply.js","sourceRoot":"","sources":["../../src/protocol/state-apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAYnF,MAAM,KAAK,GAAG,qBAAqB,CAAC,0BAA0B,CAAC,CAAA;AAE/D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAkB,EAAW,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAA;AAE/F,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,KAAmB,EACnB,QAAkB,EAClB,OAAe,EACf,SAAiB,EACR,EAAE;IACX,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;IAChE,OAAO,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;AAChE,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,OAAkC,EAClC,MAAoB,EACc,EAAE;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/C,OAAO,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;AAChE,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,KAA0B,EAC1B,OAAe,EACf,OAAsB,EACZ,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA"}

package/dist/protocol/state-limits.d.ts

@@ -0,0 +1,10 @@
+export declare const STATE_LIMITS: {
+    readonly keys: 16;
+    readonly items: 2000;
+    readonly bytes: 262144;
+    readonly activity: 50;
+    readonly slotLength: 128;
+};
+export declare const STATE_KEY_PATTERN = "^[A-Za-z][A-Za-z0-9_-]{0,63}$";
+export declare const isStateKey: (key: string) => boolean;
+//# sourceMappingURL=state-limits.d.ts.map

package/dist/protocol/state-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-limits.d.ts","sourceRoot":"","sources":["../../src/protocol/state-limits.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;aACvB,IAAI,EAAE,EAAE;aACR,KAAK,EAAE,IAAK;aACZ,KAAK,EAAE,MAAO;aACd,QAAQ,EAAE,EAAE;aACZ,UAAU,EAAE,GAAG;CACP,CAAA;AAEV,eAAO,MAAM,iBAAiB,kCAAkC,CAAA;AAEhE,eAAO,MAAM,UAAU,QAAS,MAAM,KAAG,OAA8B,CAAA"}

package/dist/protocol/state-limits.js

@@ -0,0 +1,11 @@
+export const STATE_LIMITS = {
+    keys: 16,
+    items: 2_000,
+    bytes: 262_144,
+    activity: 50,
+    slotLength: 128,
+};
+export const STATE_KEY_PATTERN = "^[A-Za-z][A-Za-z0-9_-]{0,63}$";
+const STATE_KEY = new RegExp(STATE_KEY_PATTERN);
+export const isStateKey = (key) => STATE_KEY.test(key);
+//# sourceMappingURL=state-limits.js.map

package/dist/protocol/state-limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-limits.js","sourceRoot":"","sources":["../../src/protocol/state-limits.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,GAAG;CACP,CAAA;AAEV,MAAM,CAAC,MAAM,iBAAiB,GAAG,+BAA+B,CAAA;AAChE,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAA;AAC/C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA"}

package/dist/protocol/state.d.ts

@@ -0,0 +1,60 @@
+import * as z from "zod/mini";
+import { slotMapSchema } from "./slot-map.js";
+export { STATE_LIMITS } from "./state-limits.js";
+import { actorSchema } from "./extension.js";
+/** Shared state is a collection primitive, not an app backend: one key owns one bounded
+ *  array of JSON objects, each with a server-issued `id`. */
+export declare const stateKeySchema: z.ZodMiniString;
+declare const itemId: z.ZodMiniString;
+export declare const stateItemSchema: z.ZodMiniObject<{
+    id: typeof itemId;
+}, z.core.$loose>;
+export type StateItem = z.infer<typeof stateItemSchema>;
+declare const fieldsSchema: z.ZodMiniRecord<z.ZodMiniString, z.ZodMiniUnknown>;
+/** Fields the server owns. Artifact code can never write them. */
+export declare const RESERVED_FIELDS: string[];
+/** `{ field: increment(1) }` in an update patch applies an atomic counter change. */
+export declare const INCREMENT_KEY = "__increment";
+export declare const increment: (by: number) => {
+    __increment: number;
+};
+/** The value an artifact starts a key with. It seeds the key on the first write, so sample
+ *  rows an author ships with the page become real, shared items. */
+export declare const initialSchema: z.ZodMiniArray<typeof fieldsSchema>;
+export declare const mutationSchema: z.ZodMiniDiscriminatedUnion<[
+    z.ZodMiniObject<{
+        op: z.ZodMiniLiteral<"add">;
+        value: typeof fieldsSchema;
+    }>,
+    z.ZodMiniObject<{
+        op: z.ZodMiniLiteral<"update">;
+        id: typeof itemId;
+        patch: typeof fieldsSchema;
+    }>,
+    z.ZodMiniObject<{
+        op: z.ZodMiniLiteral<"setMine">;
+        slot: z.ZodMiniString;
+        value: z.ZodMiniNullable<typeof fieldsSchema>;
+    }>
+], "op">;
+export type Mutation = z.infer<typeof mutationSchema>;
+export declare const snapshotSchema: z.ZodMiniObject<{
+    items: z.ZodMiniNullable<z.ZodMiniArray<typeof stateItemSchema>>;
+    version: z.ZodMiniInt;
+    mine: typeof slotMapSchema;
+    itemId: z.ZodMiniOptional<z.ZodMiniString>;
+}>;
+export type Snapshot = z.infer<typeof snapshotSchema>;
+export declare const activitySchema: z.ZodMiniObject<{
+    action: z.ZodMiniEnum<{
+        add: "add";
+        update: "update";
+        setMine: "setMine";
+    }>;
+    itemId: z.ZodMiniString;
+    version: z.ZodMiniInt;
+    actor: typeof actorSchema;
+    at: z.ZodMiniISODateTime;
+}>;
+export type Activity = z.infer<typeof activitySchema>;
+//# sourceMappingURL=state.d.ts.map

package/dist/protocol/state.d.ts.map

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

package/dist/protocol/state.js

@@ -0,0 +1,56 @@
+import * as z from "zod/mini";
+import { slotMapSchema } from "./slot-map.js";
+import { STATE_KEY_PATTERN, STATE_LIMITS } from "./state-limits.js";
+export { STATE_LIMITS } from "./state-limits.js";
+import { actorSchema } from "./extension.js";
+/** Shared state is a collection primitive, not an app backend: one key owns one bounded
+ *  array of JSON objects, each with a server-issued `id`. */
+export const stateKeySchema = z
+    .string()
+    .check(z.regex(new RegExp(STATE_KEY_PATTERN)));
+const itemId = z.string().check(z.minLength(1), z.maxLength(128));
+export const stateItemSchema = z.looseObject({ id: itemId });
+const fieldsSchema = z.record(z.string(), z.unknown());
+/** Fields the server owns. Artifact code can never write them. */
+export const RESERVED_FIELDS = [
+    "id",
+    "__actor",
+    "__slot",
+    "__proto__",
+    "constructor",
+    "prototype",
+];
+/** `{ field: increment(1) }` in an update patch applies an atomic counter change. */
+export const INCREMENT_KEY = "__increment";
+export const increment = (by) => ({ [INCREMENT_KEY]: by });
+/** The value an artifact starts a key with. It seeds the key on the first write, so sample
+ *  rows an author ships with the page become real, shared items. */
+export const initialSchema = z
+    .array(fieldsSchema)
+    .check(z.maxLength(STATE_LIMITS.items));
+export const mutationSchema = z.discriminatedUnion("op", [
+    z.object({ op: z.literal("add"), value: fieldsSchema }),
+    z.object({ op: z.literal("update"), id: itemId, patch: fieldsSchema }),
+    z.object({
+        op: z.literal("setMine"),
+        slot: z.string().check(z.minLength(1), z.maxLength(STATE_LIMITS.slotLength)),
+        value: z.nullable(fieldsSchema),
+    }),
+]);
+export const snapshotSchema = z.object({
+    /** Null until anyone has written to this key. */
+    items: z.nullable(z.array(stateItemSchema)),
+    version: z.int().check(z.nonnegative()),
+    /** The caller's own item per slot. Other actors' ownership is never exposed. */
+    mine: slotMapSchema,
+    /** Mutation responses identify the affected item. Reads and pushes omit it. */
+    itemId: z.optional(itemId),
+});
+export const activitySchema = z.object({
+    action: z.enum(["add", "update", "setMine"]),
+    itemId: z.string(),
+    version: z.int(),
+    actor: actorSchema,
+    at: z.iso.datetime(),
+});
+//# sourceMappingURL=state.js.map

package/dist/protocol/state.js.map

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

package/dist/protocol/text.d.ts

@@ -0,0 +1,9 @@
+/** Elements whose boundaries count as a line break when a page is flattened to text. Shared
+ *  so the runtime (live DOM) and a server (parsed HTML) flatten a page the same way. */
+export declare const BLOCK_ELEMENTS: ReadonlySet<string>;
+/** Blocks a person can retype when editing text in place. Shared so the server marks the
+ *  same blocks the runtime offers. */
+export declare const EDITABLE_BLOCKS: readonly string[];
+/** The attribute the editing plugin puts on blocks written in the source. */
+export declare const SOURCE_BLOCK = "data-open-artifact-source";
+//# sourceMappingURL=text.d.ts.map