@opengeni/artifact-kernel-wasm-spreadsheet 0.2.8 → 0.3.4-canary.0

package/dist/artifact-kernel-runtime.json

@@ -5,56 +5,56 @@
     "target": "wasm-web",
     "modality": "spreadsheet",
     "packageName": "@opengeni/artifact-kernel-wasm-spreadsheet",
-    "packageVersion": "0.2.8",
-    "artifactToolVersion": "0.2.8",
-    "buildIdentity": "opengeni-artifact-kernel/0.1.0;abi=1;command=1;query=1;snapshot=1;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=a9194d659991a0910e6f9f47510670b2857b927c2a1b818b13cf480521a986dd;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f",
-    "kernelVersion": "opengeni-artifact-kernel/0.1.0;abi=1;command=1;query=1;snapshot=1;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=a9194d659991a0910e6f9f47510670b2857b927c2a1b818b13cf480521a986dd;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f",
+    "packageVersion": "0.3.4-canary.0",
+    "artifactToolVersion": "0.3.4-canary.0",
+    "buildIdentity": "opengeni-artifact-kernel/0.1.0;abi=1;command=2;query=1;snapshot=2;collaboration-snapshot=2;committed-transaction=2;spreadsheet-model=2;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=c6212bc4b63a1fbd2b974a06d87f2a1f3ddf24466d19940d5025fd128950bce1;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f",
+    "kernelVersion": "opengeni-artifact-kernel/0.1.0;abi=1;command=2;query=1;snapshot=2;collaboration-snapshot=2;committed-transaction=2;spreadsheet-model=2;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=c6212bc4b63a1fbd2b974a06d87f2a1f3ddf24466d19940d5025fd128950bce1;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f",
     "abiVersion": 1,
     "protocolVersion": 1,
-    "modelSchemaVersion": 1,
-    "commandVersion": 1
+    "modelSchemaVersion": 2,
+    "commandVersion": 2
   },
   "capabilities": {
-    "bytes": 1860,
-    "sha256": "sha256:2cf756ab9078f337b58f299f1ebd79512540b4e44234482c52b56a9231039903"
+    "bytes": 1894,
+    "sha256": "sha256:772fd1b63dbb9ead2eadba2431c7fc71c172f8ce46abc5e89afef5a785c27de7"
   },
   "sizeBudget": {
     "wasmBytes": 786432,
     "wasmGzipBytes": 245760,
-    "glueBytes": 32768
+    "glueBytes": 36864
   },
   "files": [
     {
       "path": "artifact_kernel_spreadsheet_bg.wasm",
-      "bytes": 644645,
-      "sha256": "sha256:7284d5161966ae59170a2a738f81c50cb8e455ad55953b032e706443314bd84b",
-      "gzipBytes": 205911
+      "bytes": 733636,
+      "sha256": "sha256:060287f1df208439bfa9d43b5de4568a969ed9650d87829a2a979198f4037dd8",
+      "gzipBytes": 229815
     },
     {
       "path": "artifact_kernel_spreadsheet_bg.wasm.d.ts",
-      "bytes": 1738,
-      "sha256": "sha256:173077b78f0f6d2c8a18a3bdf60acbfb2b99e28c894c9fe1193658c8a22625de"
+      "bytes": 3016,
+      "sha256": "sha256:16c8af7ffd2ae2b1a17f032b497607995408f421137ffef734d52b39b1e6bc75"
     },
     {
       "path": "artifact_kernel_spreadsheet.d.ts",
-      "bytes": 5125,
-      "sha256": "sha256:ccaed56b6a80551a55fc73410f0022a75e238f1c9650b63c331b861ceaa82076"
+      "bytes": 9574,
+      "sha256": "sha256:feefc4a7f3937e8fc54c8046d96abdcc5d35c5fa45d82fdac8999152e1f836e7"
     },
     {
       "path": "artifact_kernel_spreadsheet.js",
-      "bytes": 19333,
-      "sha256": "sha256:473ddbd6869475a33e30b395055c41a7f36f7153ccb035c0de037106d96359ce",
-      "gzipBytes": 3529
+      "bytes": 33434,
+      "sha256": "sha256:ad287e1944b64347d4a196fa554d5b941d2f771c1ffae7c09be3a2ef0d12a0c4",
+      "gzipBytes": 4606
     },
     {
       "path": "index.d.ts",
-      "bytes": 2304,
-      "sha256": "sha256:149f4a5e363f3b44b1870369cc1cbd630c9ead1337beead0b0a39e46f8d17c81"
+      "bytes": 2529,
+      "sha256": "sha256:44726b8a8191991cbb0048071e9d62ef14aaf6b96490efdca2799723adac4d69"
     },
     {
       "path": "index.js",
-      "bytes": 2261,
-      "sha256": "sha256:9f476eb3295c6087e84bed5be7e2e8f08286b65f5cde6e2139263512c437d459"
+      "bytes": 2417,
+      "sha256": "sha256:fb8b494a5d574d4a88f81a54b0ada2d8083a575b3789f77c573b63f20c99f9d0"
     }
   ]
 }

package/dist/artifact_kernel_spreadsheet.d.ts

@@ -41,7 +41,7 @@ export class ArtifactCollaborationSession {
      */
     isClosed(): boolean;
     /**
-     * Opens one canonical OGACRD01 full-state snapshot.
+     * Opens one canonical OGACRD02 full-state snapshot.
      */
     static open(snapshot: Uint8Array): ArtifactCollaborationSession;
     /**
@@ -53,15 +53,88 @@ export class ArtifactCollaborationSession {
      */
     revision(): bigint;
     /**
-     * Returns the full canonical OGACRD01 snapshot.
+     * Returns the full canonical OGACRD02 snapshot.
      */
     snapshot(): Uint8Array;
     /**
-     * Returns SHA-256 of the exact canonical OGACRD01 snapshot.
+     * Returns SHA-256 of the exact canonical OGACRD02 snapshot.
      */
     stateHash(): string;
 }
 
+/**
+ * Stateful, in-memory kernel handle for interactive editing.
+ *
+ * A session validates/decodes once, applies many command envelopes directly
+ * to the in-memory model, and serializes only when `snapshot()` is requested.
+ * It remains synchronous so one Web Worker observes mutations in program
+ * order without locks or asynchronous re-entrancy.
+ */
+export class ArtifactKernelSession {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Atomically applies a command envelope and returns its canonical receipt.
+     */
+    applyCommands(command_envelope: Uint8Array): Uint8Array;
+    /**
+     * Releases the in-memory workbook while retaining a closed JS handle.
+     *
+     * Calling this method repeatedly is safe. Further model operations return
+     * the stable `ARTIFACT_SESSION_CLOSED` protocol error.
+     */
+    close(): void;
+    /**
+     * Creates an empty in-memory workbook from a canonical namespace envelope.
+     */
+    static create(namespace_envelope: Uint8Array): ArtifactKernelSession;
+    /**
+     * Idempotent lifecycle alias for `close()`.
+     *
+     * JavaScript may call `free()` afterward to release the small Wasm handle
+     * itself; generated explicit-resource-management support does that
+     * automatically for `using` declarations.
+     */
+    dispose(): void;
+    /**
+     * Creates an independent in-memory branch without snapshot round trips.
+     */
+    fork(): ArtifactKernelSession;
+    /**
+     * Reports whether the workbook state has already been released.
+     */
+    isClosed(): boolean;
+    /**
+     * Opens and validates one canonical snapshot into memory.
+     */
+    static open(snapshot: Uint8Array): ArtifactKernelSession;
+    /**
+     * Executes one bounded viewport or workbook-metadata projection.
+     */
+    query(query_envelope: Uint8Array): Uint8Array;
+    /**
+     * Returns the current workbook revision as a JavaScript `bigint`.
+     */
+    revision(): bigint;
+    /**
+     * Serializes the current workbook as a canonical snapshot.
+     */
+    snapshot(): Uint8Array;
+    /**
+     * Returns SHA-256 of the exact canonical snapshot as lowercase text.
+     */
+    stateHash(): string;
+}
+
+/**
+ * Atomically applies an encoded command batch to a canonical snapshot.
+ *
+ * Neither input is mutated. A rejected command leaves the supplied snapshot
+ * untouched and is surfaced as a JavaScript `Error`.
+ */
+export function applyCommands(snapshot: Uint8Array, command_envelope: Uint8Array): Uint8Array;
+
 /**
  * Returns the canonical encoded build-identity envelope.
  *
@@ -71,10 +144,15 @@ export class ArtifactCollaborationSession {
 export function buildIdentity(): Uint8Array;
 
 /**
- * Strictly validates and re-encodes a full OGACRD01 collaboration snapshot.
+ * Strictly validates and re-encodes a full OGACRD02 collaboration snapshot.
  */
 export function canonicalizeCollaborationSnapshot(snapshot: Uint8Array): Uint8Array;
 
+/**
+ * Strictly validates and re-encodes a snapshot in canonical form.
+ */
+export function canonicalizeSnapshot(snapshot: Uint8Array): Uint8Array;
+
 /**
  * Returns the canonical encoded capability envelope.
  *
@@ -83,11 +161,27 @@ export function canonicalizeCollaborationSnapshot(snapshot: Uint8Array): Uint8Ar
  */
 export function capabilities(): Uint8Array;
 
+/**
+ * Creates a new workbook from an encoded replica namespace.
+ *
+ * On success JavaScript receives the workbook's canonical snapshot as a
+ * `Uint8Array`. Invalid or non-canonical inputs throw a JavaScript `Error`
+ * whose message retains the protocol's stable error code.
+ */
+export function createWorkbook(namespace_envelope: Uint8Array): Uint8Array;
+
+/**
+ * Executes one bounded OGAKQ001 read against a canonical snapshot.
+ */
+export function query(snapshot: Uint8Array, query_envelope: Uint8Array): Uint8Array;
+
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly __wbg_artifactcollaborationsession_free: (a: number, b: number) => void;
+    readonly __wbg_artifactkernelsession_free: (a: number, b: number) => void;
+    readonly applyCommands: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly artifactcollaborationsession_applyCommitted: (a: number, b: number, c: number, d: number) => void;
     readonly artifactcollaborationsession_authorTransaction: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly artifactcollaborationsession_close: (a: number) => void;
@@ -100,9 +194,23 @@ export interface InitOutput {
     readonly artifactcollaborationsession_revision: (a: number, b: number) => void;
     readonly artifactcollaborationsession_snapshot: (a: number, b: number) => void;
     readonly artifactcollaborationsession_stateHash: (a: number, b: number) => void;
+    readonly artifactkernelsession_applyCommands: (a: number, b: number, c: number, d: number) => void;
+    readonly artifactkernelsession_close: (a: number) => void;
+    readonly artifactkernelsession_create: (a: number, b: number, c: number) => void;
+    readonly artifactkernelsession_fork: (a: number, b: number) => void;
+    readonly artifactkernelsession_isClosed: (a: number) => number;
+    readonly artifactkernelsession_open: (a: number, b: number, c: number) => void;
+    readonly artifactkernelsession_query: (a: number, b: number, c: number, d: number) => void;
+    readonly artifactkernelsession_revision: (a: number, b: number) => void;
+    readonly artifactkernelsession_snapshot: (a: number, b: number) => void;
+    readonly artifactkernelsession_stateHash: (a: number, b: number) => void;
     readonly buildIdentity: (a: number) => void;
     readonly canonicalizeCollaborationSnapshot: (a: number, b: number, c: number) => void;
+    readonly canonicalizeSnapshot: (a: number, b: number, c: number) => void;
     readonly capabilities: (a: number) => void;
+    readonly createWorkbook: (a: number, b: number, c: number) => void;
+    readonly query: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly artifactkernelsession_dispose: (a: number) => void;
     readonly artifactcollaborationsession_dispose: (a: number) => void;
     readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
     readonly __wbindgen_export: (a: number, b: number) => number;

package/dist/artifact_kernel_spreadsheet.js

@@ -151,7 +151,7 @@ export class ArtifactCollaborationSession {
         return ret !== 0;
     }
     /**
-     * Opens one canonical OGACRD01 full-state snapshot.
+     * Opens one canonical OGACRD02 full-state snapshot.
      * @param {Uint8Array} snapshot
      * @returns {ArtifactCollaborationSession}
      */
@@ -217,7 +217,7 @@ export class ArtifactCollaborationSession {
         }
     }
     /**
-     * Returns the full canonical OGACRD01 snapshot.
+     * Returns the full canonical OGACRD02 snapshot.
      * @returns {Uint8Array}
      */
     snapshot() {
@@ -239,7 +239,7 @@ export class ArtifactCollaborationSession {
         }
     }
     /**
-     * Returns SHA-256 of the exact canonical OGACRD01 snapshot.
+     * Returns SHA-256 of the exact canonical OGACRD02 snapshot.
      * @returns {string}
      */
     stateHash() {
@@ -269,6 +269,275 @@ export class ArtifactCollaborationSession {
 }
 if (Symbol.dispose) ArtifactCollaborationSession.prototype[Symbol.dispose] = ArtifactCollaborationSession.prototype.free;
 
+/**
+ * Stateful, in-memory kernel handle for interactive editing.
+ *
+ * A session validates/decodes once, applies many command envelopes directly
+ * to the in-memory model, and serializes only when `snapshot()` is requested.
+ * It remains synchronous so one Web Worker observes mutations in program
+ * order without locks or asynchronous re-entrancy.
+ */
+export class ArtifactKernelSession {
+    static __wrap(ptr) {
+        const obj = Object.create(ArtifactKernelSession.prototype);
+        obj.__wbg_ptr = ptr;
+        ArtifactKernelSessionFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        ArtifactKernelSessionFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_artifactkernelsession_free(ptr, 0);
+    }
+    /**
+     * Atomically applies a command envelope and returns its canonical receipt.
+     * @param {Uint8Array} command_envelope
+     * @returns {Uint8Array}
+     */
+    applyCommands(command_envelope) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(command_envelope, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.artifactkernelsession_applyCommands(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v2 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export2(r0, r1 * 1, 1);
+            return v2;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Releases the in-memory workbook while retaining a closed JS handle.
+     *
+     * Calling this method repeatedly is safe. Further model operations return
+     * the stable `ARTIFACT_SESSION_CLOSED` protocol error.
+     */
+    close() {
+        wasm.artifactkernelsession_close(this.__wbg_ptr);
+    }
+    /**
+     * Creates an empty in-memory workbook from a canonical namespace envelope.
+     * @param {Uint8Array} namespace_envelope
+     * @returns {ArtifactKernelSession}
+     */
+    static create(namespace_envelope) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(namespace_envelope, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.artifactkernelsession_create(retptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return ArtifactKernelSession.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Idempotent lifecycle alias for `close()`.
+     *
+     * JavaScript may call `free()` afterward to release the small Wasm handle
+     * itself; generated explicit-resource-management support does that
+     * automatically for `using` declarations.
+     */
+    dispose() {
+        wasm.artifactkernelsession_dispose(this.__wbg_ptr);
+    }
+    /**
+     * Creates an independent in-memory branch without snapshot round trips.
+     * @returns {ArtifactKernelSession}
+     */
+    fork() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.artifactkernelsession_fork(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return ArtifactKernelSession.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Reports whether the workbook state has already been released.
+     * @returns {boolean}
+     */
+    isClosed() {
+        const ret = wasm.artifactkernelsession_isClosed(this.__wbg_ptr);
+        return ret !== 0;
+    }
+    /**
+     * Opens and validates one canonical snapshot into memory.
+     * @param {Uint8Array} snapshot
+     * @returns {ArtifactKernelSession}
+     */
+    static open(snapshot) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(snapshot, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.artifactkernelsession_open(retptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return ArtifactKernelSession.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Executes one bounded viewport or workbook-metadata projection.
+     * @param {Uint8Array} query_envelope
+     * @returns {Uint8Array}
+     */
+    query(query_envelope) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(query_envelope, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.artifactkernelsession_query(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v2 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export2(r0, r1 * 1, 1);
+            return v2;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Returns the current workbook revision as a JavaScript `bigint`.
+     * @returns {bigint}
+     */
+    revision() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.artifactkernelsession_revision(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getBigInt64(retptr + 8 * 0, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            return BigInt.asUintN(64, r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Serializes the current workbook as a canonical snapshot.
+     * @returns {Uint8Array}
+     */
+    snapshot() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.artifactkernelsession_snapshot(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v1 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export2(r0, r1 * 1, 1);
+            return v1;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Returns SHA-256 of the exact canonical snapshot as lowercase text.
+     * @returns {string}
+     */
+    stateHash() {
+        let deferred2_0;
+        let deferred2_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.artifactkernelsession_stateHash(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            var ptr1 = r0;
+            var len1 = r1;
+            if (r3) {
+                ptr1 = 0; len1 = 0;
+                throw takeObject(r2);
+            }
+            deferred2_0 = ptr1;
+            deferred2_1 = len1;
+            return getStringFromWasm0(ptr1, len1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export2(deferred2_0, deferred2_1, 1);
+        }
+    }
+}
+if (Symbol.dispose) ArtifactKernelSession.prototype[Symbol.dispose] = ArtifactKernelSession.prototype.free;
+
+/**
+ * Atomically applies an encoded command batch to a canonical snapshot.
+ *
+ * Neither input is mutated. A rejected command leaves the supplied snapshot
+ * untouched and is surfaced as a JavaScript `Error`.
+ * @param {Uint8Array} snapshot
+ * @param {Uint8Array} command_envelope
+ * @returns {Uint8Array}
+ */
+export function applyCommands(snapshot, command_envelope) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passArray8ToWasm0(snapshot, wasm.__wbindgen_export);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArray8ToWasm0(command_envelope, wasm.__wbindgen_export);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.applyCommands(retptr, ptr0, len0, ptr1, len1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        if (r3) {
+            throw takeObject(r2);
+        }
+        var v3 = getArrayU8FromWasm0(r0, r1).slice();
+        wasm.__wbindgen_export2(r0, r1 * 1, 1);
+        return v3;
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
 /**
  * Returns the canonical encoded build-identity envelope.
  *
@@ -291,7 +560,7 @@ export function buildIdentity() {
 }
 
 /**
- * Strictly validates and re-encodes a full OGACRD01 collaboration snapshot.
+ * Strictly validates and re-encodes a full OGACRD02 collaboration snapshot.
  * @param {Uint8Array} snapshot
  * @returns {Uint8Array}
  */
@@ -316,6 +585,32 @@ export function canonicalizeCollaborationSnapshot(snapshot) {
     }
 }
 
+/**
+ * Strictly validates and re-encodes a snapshot in canonical form.
+ * @param {Uint8Array} snapshot
+ * @returns {Uint8Array}
+ */
+export function canonicalizeSnapshot(snapshot) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passArray8ToWasm0(snapshot, wasm.__wbindgen_export);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.canonicalizeSnapshot(retptr, ptr0, len0);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        if (r3) {
+            throw takeObject(r2);
+        }
+        var v2 = getArrayU8FromWasm0(r0, r1).slice();
+        wasm.__wbindgen_export2(r0, r1 * 1, 1);
+        return v2;
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
 /**
  * Returns the canonical encoded capability envelope.
  *
@@ -336,6 +631,65 @@ export function capabilities() {
         wasm.__wbindgen_add_to_stack_pointer(16);
     }
 }
+
+/**
+ * Creates a new workbook from an encoded replica namespace.
+ *
+ * On success JavaScript receives the workbook's canonical snapshot as a
+ * `Uint8Array`. Invalid or non-canonical inputs throw a JavaScript `Error`
+ * whose message retains the protocol's stable error code.
+ * @param {Uint8Array} namespace_envelope
+ * @returns {Uint8Array}
+ */
+export function createWorkbook(namespace_envelope) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passArray8ToWasm0(namespace_envelope, wasm.__wbindgen_export);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.createWorkbook(retptr, ptr0, len0);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        if (r3) {
+            throw takeObject(r2);
+        }
+        var v2 = getArrayU8FromWasm0(r0, r1).slice();
+        wasm.__wbindgen_export2(r0, r1 * 1, 1);
+        return v2;
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
+/**
+ * Executes one bounded OGAKQ001 read against a canonical snapshot.
+ * @param {Uint8Array} snapshot
+ * @param {Uint8Array} query_envelope
+ * @returns {Uint8Array}
+ */
+export function query(snapshot, query_envelope) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passArray8ToWasm0(snapshot, wasm.__wbindgen_export);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArray8ToWasm0(query_envelope, wasm.__wbindgen_export);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.query(retptr, ptr0, len0, ptr1, len1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        if (r3) {
+            throw takeObject(r2);
+        }
+        var v3 = getArrayU8FromWasm0(r0, r1).slice();
+        wasm.__wbindgen_export2(r0, r1 * 1, 1);
+        return v3;
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
@@ -356,6 +710,9 @@ function __wbg_get_imports() {
 const ArtifactCollaborationSessionFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_artifactcollaborationsession_free(ptr, 1));
+const ArtifactKernelSessionFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_artifactkernelsession_free(ptr, 1));
 
 function addHeapObject(obj) {
     if (heap_next === heap.length) heap.push(heap.length + 1);

package/dist/artifact_kernel_spreadsheet_bg.wasm.d.ts

@@ -2,6 +2,8 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const __wbg_artifactcollaborationsession_free: (a: number, b: number) => void;
+export const __wbg_artifactkernelsession_free: (a: number, b: number) => void;
+export const applyCommands: (a: number, b: number, c: number, d: number, e: number) => void;
 export const artifactcollaborationsession_applyCommitted: (a: number, b: number, c: number, d: number) => void;
 export const artifactcollaborationsession_authorTransaction: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const artifactcollaborationsession_close: (a: number) => void;
@@ -14,9 +16,23 @@ export const artifactcollaborationsession_query: (a: number, b: number, c: numbe
 export const artifactcollaborationsession_revision: (a: number, b: number) => void;
 export const artifactcollaborationsession_snapshot: (a: number, b: number) => void;
 export const artifactcollaborationsession_stateHash: (a: number, b: number) => void;
+export const artifactkernelsession_applyCommands: (a: number, b: number, c: number, d: number) => void;
+export const artifactkernelsession_close: (a: number) => void;
+export const artifactkernelsession_create: (a: number, b: number, c: number) => void;
+export const artifactkernelsession_fork: (a: number, b: number) => void;
+export const artifactkernelsession_isClosed: (a: number) => number;
+export const artifactkernelsession_open: (a: number, b: number, c: number) => void;
+export const artifactkernelsession_query: (a: number, b: number, c: number, d: number) => void;
+export const artifactkernelsession_revision: (a: number, b: number) => void;
+export const artifactkernelsession_snapshot: (a: number, b: number) => void;
+export const artifactkernelsession_stateHash: (a: number, b: number) => void;
 export const buildIdentity: (a: number) => void;
 export const canonicalizeCollaborationSnapshot: (a: number, b: number, c: number) => void;
+export const canonicalizeSnapshot: (a: number, b: number, c: number) => void;
 export const capabilities: (a: number) => void;
+export const createWorkbook: (a: number, b: number, c: number) => void;
+export const query: (a: number, b: number, c: number, d: number, e: number) => void;
+export const artifactkernelsession_dispose: (a: number) => void;
 export const artifactcollaborationsession_dispose: (a: number) => void;
 export const __wbindgen_add_to_stack_pointer: (a: number) => number;
 export const __wbindgen_export: (a: number, b: number) => number;

package/dist/index.d.ts

@@ -3,14 +3,14 @@ export type ArtifactKernelRuntimeIdentity = Readonly<{
   target: "wasm-web";
   modality: "spreadsheet";
   packageName: "@opengeni/artifact-kernel-wasm-spreadsheet";
-  packageVersion: "0.2.8";
-  artifactToolVersion: "0.2.8";
-  buildIdentity: "opengeni-artifact-kernel/0.1.0;abi=1;command=1;query=1;snapshot=1;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=a9194d659991a0910e6f9f47510670b2857b927c2a1b818b13cf480521a986dd;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f";
-  kernelVersion: "opengeni-artifact-kernel/0.1.0;abi=1;command=1;query=1;snapshot=1;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=a9194d659991a0910e6f9f47510670b2857b927c2a1b818b13cf480521a986dd;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f";
+  packageVersion: "0.3.4-canary.0";
+  artifactToolVersion: "0.3.4-canary.0";
+  buildIdentity: "opengeni-artifact-kernel/0.1.0;abi=1;command=2;query=1;snapshot=2;collaboration-snapshot=2;committed-transaction=2;spreadsheet-model=2;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=c6212bc4b63a1fbd2b974a06d87f2a1f3ddf24466d19940d5025fd128950bce1;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f";
+  kernelVersion: "opengeni-artifact-kernel/0.1.0;abi=1;command=2;query=1;snapshot=2;collaboration-snapshot=2;committed-transaction=2;spreadsheet-model=2;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=c6212bc4b63a1fbd2b974a06d87f2a1f3ddf24466d19940d5025fd128950bce1;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f";
   abiVersion: 1;
   protocolVersion: 1;
-  modelSchemaVersion: 1;
-  commandVersion: 1;
+  modelSchemaVersion: 2;
+  commandVersion: 2;
 }>;
 export declare const artifactKernelRuntimeIdentity: ArtifactKernelRuntimeIdentity;
 export declare const artifactKernelPackageIdentity: ArtifactKernelRuntimeIdentity;
@@ -23,9 +23,9 @@ export declare const editableArtifactKernelRuntime: Readonly<{
   modality: "spreadsheet";
   wasmGlueUrl: URL;
   wasmBinaryUrl: URL;
-  kernelVersion: "opengeni-artifact-kernel/0.1.0;abi=1;command=1;query=1;snapshot=1;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=a9194d659991a0910e6f9f47510670b2857b927c2a1b818b13cf480521a986dd;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f";
+  kernelVersion: "opengeni-artifact-kernel/0.1.0;abi=1;command=2;query=1;snapshot=2;collaboration-snapshot=2;committed-transaction=2;spreadsheet-model=2;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=c6212bc4b63a1fbd2b974a06d87f2a1f3ddf24466d19940d5025fd128950bce1;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f";
   protocolVersion: 1;
-  modelSchemaVersion: 1;
-  commandVersion: 1;
+  modelSchemaVersion: 2;
+  commandVersion: 2;
 }>;
 export declare function loadArtifactKernelBinding(): Promise<typeof import("./artifact_kernel_spreadsheet.js")>;

package/dist/index.js

@@ -1,4 +1,4 @@
-export const artifactKernelRuntimeIdentity = Object.freeze({"schemaVersion":1,"target":"wasm-web","modality":"spreadsheet","packageName":"@opengeni/artifact-kernel-wasm-spreadsheet","packageVersion":"0.2.8","artifactToolVersion":"0.2.8","buildIdentity":"opengeni-artifact-kernel/0.1.0;abi=1;command=1;query=1;snapshot=1;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=a9194d659991a0910e6f9f47510670b2857b927c2a1b818b13cf480521a986dd;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f","kernelVersion":"opengeni-artifact-kernel/0.1.0;abi=1;command=1;query=1;snapshot=1;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=a9194d659991a0910e6f9f47510670b2857b927c2a1b818b13cf480521a986dd;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f","abiVersion":1,"protocolVersion":1,"modelSchemaVersion":1,"commandVersion":1});
+export const artifactKernelRuntimeIdentity = Object.freeze({"schemaVersion":1,"target":"wasm-web","modality":"spreadsheet","packageName":"@opengeni/artifact-kernel-wasm-spreadsheet","packageVersion":"0.3.4-canary.0","artifactToolVersion":"0.3.4-canary.0","buildIdentity":"opengeni-artifact-kernel/0.1.0;abi=1;command=2;query=1;snapshot=2;collaboration-snapshot=2;committed-transaction=2;spreadsheet-model=2;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=c6212bc4b63a1fbd2b974a06d87f2a1f3ddf24466d19940d5025fd128950bce1;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f","kernelVersion":"opengeni-artifact-kernel/0.1.0;abi=1;command=2;query=1;snapshot=2;collaboration-snapshot=2;committed-transaction=2;spreadsheet-model=2;document-snapshot=1;document-command=1;document-query=1;presentation-snapshot=1;presentation-command=1;presentation-query=1;text-layout-fonts=1;text-layout-request=1;text-layout-response=1;render-tile=1;render-patch=1;source=c6212bc4b63a1fbd2b974a06d87f2a1f3ddf24466d19940d5025fd128950bce1;toolchain=1367261bf04dd2fc4b2c6aa0ef397c21659ee1c973a9d98dcb8d84b46d68b06f","abiVersion":1,"protocolVersion":1,"modelSchemaVersion":2,"commandVersion":2});
 export const artifactKernelPackageIdentity = artifactKernelRuntimeIdentity;
 export const editableArtifactKernelAssets = Object.freeze({
   modality: "spreadsheet",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/artifact-kernel-wasm-spreadsheet",
-  "version": "0.2.8",
+  "version": "0.3.4-canary.0",
   "description": "Exact lazy WebAssembly runtime for OpenGeni spreadsheet editing.",
   "license": "Apache-2.0",
   "repository": {