@hyperframes/sdk 0.6.113

package/dist/history.js

@@ -0,0 +1,116 @@
+/**
+ * Optional history module (F5 layering).
+ *
+ * Wires onto a Composition session via on('patch') and implements undo/redo.
+ * Coalesces same-op+same-targets bursts within coalesceMs into one undo entry.
+ *
+ * Usage (standalone / T1):
+ *   const comp = await openComposition(html, { persist });
+ *   // openComposition attaches this automatically in non-embedded mode.
+ *
+ * Usage (manual / custom undo timeline):
+ *   const history = createHistory(comp, { coalesceMs: 500, trackedOrigins: ['local'] });
+ *   // host calls history.undo() / history.redo() instead of comp.undo() / comp.redo()
+ */
+import { ORIGIN_APPLY_PATCHES } from "./types.js";
+export function createHistory(session, opts = {}) {
+    const coalesceMs = opts.coalesceMs ?? 300;
+    const maxEntries = opts.maxEntries ?? 100;
+    const { trackedOrigins } = opts;
+    const undoStack = [];
+    let redoStack = [];
+    function isTracked(origin) {
+        if (origin === ORIGIN_APPLY_PATCHES)
+            return false;
+        if (!trackedOrigins)
+            return true;
+        return trackedOrigins.includes(origin);
+    }
+    function pathsKey(patches) {
+        return patches
+            .map((p) => p.path)
+            .sort()
+            .join("\n");
+    }
+    function opTypesKey(opTypes) {
+        // Sorted: the same op-type SET coalesces regardless of dispatch order.
+        return [...opTypes].sort().join(",");
+    }
+    function shouldCoalesce(entry, incoming) {
+        if (coalesceMs <= 0)
+            return false;
+        if (opTypesKey(entry.opTypes) !== opTypesKey(incoming.opTypes))
+            return false;
+        if (entry.origin !== incoming.origin)
+            return false;
+        // Coalesce only when the SAME paths are touched (e.g. slider drag on one
+        // property). Without this, rapid edits to different elements would merge
+        // into one entry holding the second forward + first inverse — undo would
+        // then revert the wrong element.
+        if (pathsKey(entry.patches) !== pathsKey(incoming.patches))
+            return false;
+        const now = Date.now();
+        return now - entry.timestamp <= coalesceMs;
+    }
+    // fallow-ignore-next-line complexity
+    const unsubscribe = session.on("patch", (event) => {
+        if (!isTracked(event.origin))
+            return;
+        const last = undoStack[undoStack.length - 1];
+        if (last && shouldCoalesce(last, event)) {
+            // Coalesce: keep first inverse (original prev), replace forward with latest value.
+            // Slide timestamp forward so rapid-fire edits keep coalescing.
+            const coalesced = {
+                patches: event.patches,
+                inversePatches: last.inversePatches,
+                opTypes: last.opTypes,
+                origin: last.origin,
+                timestamp: Date.now(),
+            };
+            undoStack[undoStack.length - 1] = coalesced;
+        }
+        else {
+            undoStack.push({
+                patches: event.patches,
+                inversePatches: event.inversePatches,
+                opTypes: event.opTypes,
+                origin: event.origin,
+                timestamp: Date.now(),
+            });
+            if (undoStack.length > maxEntries)
+                undoStack.shift();
+        }
+        // Any new op clears the redo stack.
+        redoStack = [];
+    });
+    return {
+        undo() {
+            const entry = undoStack.pop();
+            if (!entry)
+                return false;
+            session.applyPatches(entry.inversePatches, { origin: ORIGIN_APPLY_PATCHES });
+            redoStack.push(entry);
+            return true;
+        },
+        redo() {
+            const entry = redoStack.pop();
+            if (!entry)
+                return false;
+            session.applyPatches(entry.patches, { origin: ORIGIN_APPLY_PATCHES });
+            undoStack.push(entry);
+            return true;
+        },
+        canUndo() {
+            return undoStack.length > 0;
+        },
+        canRedo() {
+            return redoStack.length > 0;
+        },
+        dispose() {
+            unsubscribe();
+            undoStack.length = 0;
+            redoStack.length = 0;
+        },
+    };
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA2BlD,MAAM,UAAU,aAAa,CAAC,OAAoB,EAAE,OAAuB,EAAE;IAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC;IAC1C,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAEhC,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,IAAI,SAAS,GAAmB,EAAE,CAAC;IAEnC,SAAS,SAAS,CAAC,MAAe;QAChC,IAAI,MAAM,KAAK,oBAAoB;YAAE,OAAO,KAAK,CAAC;QAClD,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC;QACjC,OAAO,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,SAAS,QAAQ,CAAC,OAA+B;QAC/C,OAAO,OAAO;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,EAAE;aACN,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,SAAS,UAAU,CAAC,OAA0B;QAC5C,uEAAuE;QACvE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,SAAS,cAAc,CAAC,KAAmB,EAAE,QAAoB;QAC/D,IAAI,UAAU,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7E,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACnD,yEAAyE;QACzE,yEAAyE;QACzE,yEAAyE;QACzE,iCAAiC;QACjC,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,OAAO,GAAG,GAAG,KAAK,CAAC,SAAS,IAAI,UAAU,CAAC;IAC7C,CAAC;IAED,qCAAqC;IACrC,MAAM,WAAW,GAAG,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAiB,EAAE,EAAE;QAC5D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;YAAE,OAAO;QAErC,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,IAAI,IAAI,IAAI,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YACxC,mFAAmF;YACnF,+DAA+D;YAC/D,MAAM,SAAS,GAAiB;gBAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YACF,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC;gBACb,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC;YACH,IAAI,SAAS,CAAC,MAAM,GAAG,UAAU;gBAAE,SAAS,CAAC,KAAK,EAAE,CAAC;QACvD,CAAC;QAED,oCAAoC;QACpC,SAAS,GAAG,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,IAAI;YACF,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YACzB,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;YAC7E,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI;YACF,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YACzB,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;YACtE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO;YACL,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO;YACL,WAAW,EAAE,CAAC;YACd,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;YACrB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export type { HyperFramesElement, SdkDocument, OverrideSet, EditOp, ElasticHold, FontValue, ImageValue, GsapTweenSpec, HfId, JsonPatchOp, PatchEvent, PersistErrorEvent, ElementSnapshot, ElementTimingSnapshot, FindQuery, SelectionProxy, ElementHandle, Composition, CanResult, } from "./types.js";
+export { ORIGIN_APPLY_PATCHES, ORIGIN_LOCAL } from "./types.js";
+export { UnsupportedOpError } from "./engine/mutate.js";
+export { buildDocument, buildRoots, flatElements } from "./document.js";
+export { openComposition } from "./session.js";
+export type { OpenCompositionOptions } from "./session.js";
+export { createHistory } from "./history.js";
+export type { HistoryModule, HistoryOptions, HistoryEntry } from "./history.js";
+export { createPersistQueue } from "./persist-queue.js";
+export type { PersistQueueModule, PersistQueueOptions } from "./persist-queue.js";
+export type { PersistAdapter, PreviewAdapter, PersistVersionEntry } from "./adapters/types.js";
+export { createMemoryAdapter } from "./adapters/memory.js";
+export { createHeadlessAdapter } from "./adapters/headless.js";
+export { createIframePreviewAdapter, resolveNearestHfElement } from "./adapters/iframe.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,MAAM,EACN,WAAW,EACX,SAAS,EACT,UAAU,EACV,aAAa,EACb,IAAI,EACJ,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,aAAa,EACb,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { ORIGIN_APPLY_PATCHES, ORIGIN_LOCAL } from "./types.js";
+export { UnsupportedOpError } from "./engine/mutate.js";
+export { buildDocument, buildRoots, flatElements } from "./document.js";
+export { openComposition } from "./session.js";
+export { createHistory } from "./history.js";
+export { createPersistQueue } from "./persist-queue.js";
+// Concrete adapter factories (browser-safe — Node-only fs adapter: @hyperframes/sdk/adapters/fs).
+export { createMemoryAdapter } from "./adapters/memory.js";
+export { createHeadlessAdapter } from "./adapters/headless.js";
+export { createIframePreviewAdapter, resolveNearestHfElement } from "./adapters/iframe.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAKxD,kGAAkG;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/persist-queue.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Optional persist queue module (F5 layering).
+ *
+ * Subscribes to 'change' events and schedules async writes via a PersistAdapter.
+ * One in-flight write at a time; latest state always wins (last-write-wins coalescing).
+ *
+ * Wired automatically by openComposition() in standalone (T1/T2) mode.
+ * T3 (embedded) hosts own persistence — do not use this module.
+ */
+import type { Composition, PersistErrorEvent } from "./types.js";
+import type { PersistAdapter } from "./adapters/types.js";
+export interface PersistQueueModule {
+    /** Force an immediate write (e.g. before app close). */
+    flush(): Promise<void>;
+    dispose(): void;
+}
+export interface PersistQueueOptions {
+    /** Adapter path to write to. Default: "composition.html" */
+    path?: string;
+    /** Called when adapter.write() rejects. */
+    onError?: (e: PersistErrorEvent) => void;
+}
+export declare function createPersistQueue(session: Composition, adapter: PersistAdapter, opts?: PersistQueueOptions): PersistQueueModule;
+//# sourceMappingURL=persist-queue.d.ts.map

package/dist/persist-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist-queue.d.ts","sourceRoot":"","sources":["../src/persist-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC1C;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,mBAAwB,GAC7B,kBAAkB,CAoDpB"}

package/dist/persist-queue.js

@@ -0,0 +1,62 @@
+/**
+ * Optional persist queue module (F5 layering).
+ *
+ * Subscribes to 'change' events and schedules async writes via a PersistAdapter.
+ * One in-flight write at a time; latest state always wins (last-write-wins coalescing).
+ *
+ * Wired automatically by openComposition() in standalone (T1/T2) mode.
+ * T3 (embedded) hosts own persistence — do not use this module.
+ */
+export function createPersistQueue(session, adapter, opts = {}) {
+    const path = opts.path ?? "composition.html";
+    let pendingWrite = null;
+    // Promise-chain mutex: each write chains onto the prior, preventing concurrent writes.
+    let writeChain = Promise.resolve();
+    let disposed = false;
+    function scheduleWrite() {
+        if (pendingWrite !== null)
+            clearTimeout(pendingWrite);
+        pendingWrite = setTimeout(() => {
+            pendingWrite = null;
+            void doWrite();
+        }, 0);
+    }
+    function doWrite() {
+        if (disposed)
+            return Promise.resolve();
+        const content = session.serialize();
+        writeChain = writeChain.then(async () => {
+            if (disposed)
+                return;
+            try {
+                await adapter.write(path, content);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                opts.onError?.({ error: { message, cause: err } });
+            }
+        });
+        return writeChain;
+    }
+    const unsubscribe = session.on("change", () => {
+        scheduleWrite();
+    });
+    return {
+        async flush() {
+            if (pendingWrite !== null) {
+                clearTimeout(pendingWrite);
+                pendingWrite = null;
+            }
+            await doWrite();
+        },
+        dispose() {
+            disposed = true;
+            if (pendingWrite !== null) {
+                clearTimeout(pendingWrite);
+                pendingWrite = null;
+            }
+            unsubscribe();
+        },
+    };
+}
+//# sourceMappingURL=persist-queue.js.map

package/dist/persist-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist-queue.js","sourceRoot":"","sources":["../src/persist-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,MAAM,UAAU,kBAAkB,CAChC,OAAoB,EACpB,OAAuB,EACvB,OAA4B,EAAE;IAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,kBAAkB,CAAC;IAC7C,IAAI,YAAY,GAAyC,IAAI,CAAC;IAC9D,uFAAuF;IACvF,IAAI,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAClD,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,SAAS,aAAa;QACpB,IAAI,YAAY,KAAK,IAAI;YAAE,YAAY,CAAC,YAAY,CAAC,CAAC;QACtD,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YAC7B,YAAY,GAAG,IAAI,CAAC;YACpB,KAAK,OAAO,EAAE,CAAC;QACjB,CAAC,EAAE,CAAC,CAAC,CAAC;IACR,CAAC;IAED,SAAS,OAAO;QACd,IAAI,QAAQ;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACpC,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YACtC,IAAI,QAAQ;gBAAE,OAAO;YACrB,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YACrD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QAC5C,aAAa,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,CAAC,KAAK;YACT,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC1B,YAAY,CAAC,YAAY,CAAC,CAAC;gBAC3B,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC;YACD,MAAM,OAAO,EAAE,CAAC;QAClB,CAAC;QAED,OAAO;YACL,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC1B,YAAY,CAAC,YAAY,CAAC,CAAC;gBAC3B,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC;YACD,WAAW,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Phase 3a — real editing session.
+ *
+ * CompositionImpl: live linkedom document, real dispatch, RFC 6902 patch emission,
+ * override-set accumulation, batch, can(), serialize(), applyPatches().
+ *
+ * openComposition() wires history + persist queue for standalone (T1/T2) mode.
+ * T3 (embedded) callers supply overrides; SDK emits patches only — host owns state.
+ */
+import type { Composition, OverrideSet } from "./types.js";
+import type { PersistAdapter, PreviewAdapter } from "./adapters/types.js";
+export interface OpenCompositionOptions {
+    persist?: PersistAdapter;
+    /** Adapter path the persist queue writes to. Default: "composition.html". Immutable for the session lifetime. */
+    persistPath?: string;
+    preview?: PreviewAdapter;
+    /** T3 embedded mode: override-set applied on top of the base template. */
+    overrides?: OverrideSet;
+    /** Origins whose mutations enter the undo stack. Default: all non-applyPatches. */
+    trackedOrigins?: unknown[];
+    /** Auto-coalesce window for history entries (ms). Default: 300. */
+    coalesceMs?: number;
+    /**
+     * Pass `false` to skip attaching the history module (undo/redo).
+     * Default: history is attached in standalone (non-embedded) mode.
+     * Use when the host owns the undo stack and SDK undo is dead weight.
+     */
+    history?: false;
+}
+/**
+ * Open a composition for editing.
+ *
+ * Standalone (T1/T2): supply persist adapter — SDK owns history + auto-save.
+ * Embedded (T3): supply overrides — SDK emits patches; host owns history + persistence.
+ * Headless (agents): omit both — SDK is a stateless transform + serializer.
+ */
+export declare function openComposition(html: string, opts?: OpenCompositionOptions): Promise<Composition>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAEV,WAAW,EAYX,WAAW,EAKZ,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAc1E,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,iHAAiH;IACjH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,mFAAmF;IACnF,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB;AA+iBD;;;;;;GAMG;AAEH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,sBAAsB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAmCtB"}