tabulark 0.1.0 → 0.2.1

package/dist/model.d.ts

@@ -9,14 +9,17 @@ export declare const MAX_ACTIVE_RANGES = 2;
 export declare const MAX_RANGE_WAITERS = 8;
 export interface MemoryBudgetLimits {
     readonly memoryBudgetBytes: number;
+    /** Cross-thread accounting slices used by RangeSource brokers. */
+    readonly workerBudgetBytes: number;
+    readonly mainThreadSourceBytes: number;
+    readonly mainThreadRetainedBytes: number;
+    readonly sourceRangeCacheBytes: number;
     /** Shared retained capacity allocated among the adapters actually registered. */
     readonly adapterRuntimePoolBytes: number;
     /** Maximum transient/decoded budget retained by one active adapter operation. */
     readonly operationBudgetBytes: number;
     readonly indexBudgetBytes: number;
     readonly adapterTileCacheBudgetBytes: number;
-    readonly workerRangeCacheBytes: number;
-    readonly workerDatasetRangeCacheBytes: number;
     readonly mainThreadRangeCacheBytes: number;
     readonly maxFieldBytes: number;
     readonly maxBatchBytes: number;
@@ -27,7 +30,7 @@ export interface MemoryBudgetLimits {
 }
 /** Derives every bounded runtime allocation from one engine-wide budget. */
 export declare function deriveMemoryBudgetLimits(memoryBudgetBytes: number): MemoryBudgetLimits;
-export type MemoryResourceKind = "adapter-runtime" | "source-staging" | "compressed-page" | "decompression" | "opened-worksheet" | "batch" | "range-cache";
+export type MemoryResourceKind = "adapter-runtime" | "source-staging" | "compressed-page" | "decompression" | "batch";
 export interface MemoryReservation {
     readonly resource: MemoryResourceKind;
     readonly bytes: number;

package/dist/protocol.d.ts

@@ -1,7 +1,7 @@
-/** Version 3 introduces multi-table presentation and discriminated adapter steps. */
-export declare const PROTOCOL_VERSION: 3;
+/** Version 4 introduces resumable, revisioned operations and main-thread batch ownership. */
+export declare const PROTOCOL_VERSION: 4;
 /** Version of the private, built-in Rust adapter contract. */
-export declare const ADAPTER_API_VERSION: 2;
+export declare const ADAPTER_API_VERSION: 3;
 /** Version of the descriptor + deduplicated-buffer batch transport. */
 export declare const BATCH_LAYOUT_VERSION: 1;
 export type ProtocolVersion = typeof PROTOCOL_VERSION;

package/dist/range-cache.d.ts

@@ -1,4 +1,4 @@
-import type { RangeRequest, WireTableBatch } from "./model.js";
+import type { RangeRequest, WireTableBatch, WireTableBatchColumn } from "./model.js";
 export declare class PermitQueueFullError extends Error {
     readonly maxWaiters: number;
     constructor(maxWaiters: number);
@@ -14,15 +14,34 @@ export declare class AsyncPermitQueue {
 export declare class ByteLruCache<T> {
     #private;
     constructor(maxBytes: number, options?: Readonly<{
+        maxEntries?: number;
+        minimumEntryBytes?: number;
         onRemove?: (key: string, value: T, byteLength: number) => void;
     }>);
     get maxBytes(): number;
+    get maxEntries(): number;
     get(key: string): T | undefined;
-    set(key: string, value: T, byteLength: number): void;
+    set(key: string, value: T, byteLength: number, maxBytes?: number): void;
+    /** Evicts least-recently-used entries until the requested live cap is met. */
+    trimTo(maxBytes: number): void;
     deleteWhere(predicate: (key: string, value: T) => boolean): void;
     clear(): void;
 }
-export declare function rangeCacheKey(owner: string, revision: number, schemaVersion: number, range: RangeRequest): string;
-export declare function rangeCacheKeyBelongsTo(key: string, owner: string): boolean;
-export declare function cloneWireTableBatch(batch: WireTableBatch): WireTableBatch;
+export declare function rangeCacheKey(datasetHandle: string, tableId: string, revision: number, schemaVersion: number, range: RangeRequest): string;
+export declare function rangeCacheKeyBelongsToDataset(key: string, datasetHandle: string): boolean;
+export declare function rangeCacheKeyBelongsToTable(key: string, datasetHandle: string, tableId: string): boolean;
+export declare function rangeCacheKeyMatchesVersion(key: string, revision: number, schemaVersion: number): boolean;
+/**
+ * Main-thread-owned immutable backing for a logical batch.
+ *
+ * The ArrayBuffers arrive as independently transferable Worker output and are
+ * intentionally not cloned here. They remain unreachable through the public
+ * batch facade; binary getters perform their own defensive copy.
+ */
+export type BatchBacking = Omit<WireTableBatch, "buffers" | "columns" | "range"> & Readonly<{
+    range: Readonly<WireTableBatch["range"]>;
+    buffers: readonly ArrayBuffer[];
+    columns: readonly WireTableBatchColumn[];
+}>;
+export declare function createBatchBacking(batch: WireTableBatch): BatchBacking;
 export declare function wireBatchByteLength(batch: WireTableBatch): number;

package/dist/range-source.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Bounded, repeatable byte-range sources.
+ *
+ * A RangeSource is intentionally a very small host-side capability.  The
+ * worker never receives the implementation (or a URL); it is given an opaque
+ * reader handle by the client and asks the host for bounded byte ranges.
+ */
+/** The largest addressable source (2^32 - 1 bytes). */
+export declare const MAX_RANGE_SOURCE_BYTES = 4294967295;
+/** A half-open byte interval [offset, offset + length). */
+export interface ByteRange {
+    readonly offset: number;
+    readonly length: number;
+}
+/** A stable identity for one opened view of a source. */
+export interface RangeSourceSnapshot {
+    readonly id: string;
+    readonly strength: "strong" | "weak";
+}
+/** Options supplied to every reader operation. */
+export interface RangeSourceReadOptions {
+    readonly signal: AbortSignal;
+}
+/** A reader returned by a RangeSource.open() call. */
+export interface RangeSourceReader {
+    /** Exact source size in bytes. */
+    readonly size: number;
+    /** Validator captured while opening the source. */
+    readonly snapshot: RangeSourceSnapshot;
+    /** Maximum number of provider reads that may run concurrently. Defaults to 1. */
+    readonly maxConcurrency?: number;
+    /** Reads exactly range.length bytes, or rejects. */
+    read(range: ByteRange, options: RangeSourceReadOptions): Promise<ArrayBuffer | ArrayBufferView>;
+    /** Releases all resources. Calling close more than once is harmless. */
+    close(): Promise<void> | void;
+}
+/** Open-time limits owned by the engine. */
+export interface RangeSourceOpenOptions {
+    readonly signal: AbortSignal;
+    readonly maxSourceBytes: number;
+    readonly maxStagingBytes: number;
+}
+/** A repeatably openable source addressed by bounded byte ranges. */
+export interface RangeSource {
+    readonly kind: "range";
+    readonly name?: string;
+    open(options: RangeSourceOpenOptions): Promise<RangeSourceReader>;
+}
+/** Runtime check used at the public engine boundary. */
+export declare function isRangeSource(value: unknown): value is RangeSource;
+/**
+ * Validates a byte range without coercing values.  Keeping this check in one
+ * place prevents unsafe floating-point arithmetic at both HTTP and Worker
+ * boundaries.
+ */
+export declare function validateByteRange(range: unknown, size: number): asserts range is ByteRange;
+/** Validates and freezes a reader snapshot. */
+export declare function normalizeRangeSourceSnapshot(value: unknown): RangeSourceSnapshot;
+/** Validates a reader object returned by an adapter/broker. */
+export declare function validateRangeSourceReader(value: unknown): value is RangeSourceReader;
+/** Converts an ArrayBuffer or view to a fresh, exact-length ArrayBuffer. */
+export declare function copyRangeBytes(value: ArrayBuffer | ArrayBufferView): ArrayBuffer;
+/** Returns whether a value is a safe non-negative integer. */
+export declare function isSafeNonNegativeInteger(value: unknown): value is number;

package/dist/rpc-client.d.ts

@@ -2,17 +2,30 @@ import { TabularkError } from "./errors.js";
 import { type Operation, type ProtocolEvent, type ResponseKind } from "./protocol.js";
 type EventListener = (event: ProtocolEvent) => void;
 type FailureListener = (error: TabularkError) => void;
+/** Private messages exchanged by the Worker source-byte broker. */
+export type SourceBrokerListener = (value: unknown) => void;
 interface RequestOptions {
     readonly transfer?: Transferable[];
     readonly signal?: AbortSignal;
     readonly timeoutMs?: number;
+    /** Private opt-in operation telemetry callback. */
+    readonly measure?: boolean;
+    readonly onTelemetry?: (telemetry: OperationTelemetry | undefined) => void;
+}
+export interface OperationTelemetry {
+    readonly bytesRead: number;
+    readonly peakReservationBytes: number;
+    readonly sourceReads: number;
+    readonly sourceCacheHitBytes: number;
 }
 /** Main-thread request multiplexer for one dedicated Worker. */
 export declare class WorkerRpcClient {
     #private;
-    constructor(worker: Worker, onEvent: EventListener, onFailure?: FailureListener);
+    constructor(worker: Worker, onEvent: EventListener, onFailure?: FailureListener, onSourceMessage?: SourceBrokerListener);
+    /** Sends one private broker response without exposing the Worker object. */
+    postMessage(value: unknown, transfer?: Transferable[]): void;
     request<T>(op: Operation, payload: unknown, expectedKind: ResponseKind, options?: RequestOptions): Promise<T>;
-    shutdown(timeoutMs?: number): Promise<void>;
+    shutdown(timeoutMs?: number, options?: Pick<RequestOptions, "measure" | "onTelemetry">): Promise<void>;
     terminate(error?: TabularkError, notifyFailure?: boolean): void;
 }
 export {};

package/dist/source.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Host-side source policy shared by the stable client and its Worker.
+ *
+ * This is deliberately a binary constant (rather than a decimal "2G" value):
+ * the large-source contract is exactly 2 * 1024^3 bytes.  Keeping the value
+ * in one module prevents the client and Worker from drifting at the boundary.
+ */
+export declare const MAX_LARGE_SOURCE_BYTES: number;
+export { MAX_RANGE_SOURCE_BYTES, isRangeSource, validateByteRange, validateRangeSourceReader, copyRangeBytes, } from "./range-source.js";
+export type { ByteRange, RangeSource, RangeSourceOpenOptions, RangeSourceReader, RangeSourceReadOptions, RangeSourceSnapshot, } from "./range-source.js";
+/** Selects the bounded default path or the large local-Blob path. */
+export type SourceMode = "auto" | "large";
+export declare function isSourceMode(value: unknown): value is SourceMode;

package/dist/view/canvas-table-view-public.d.ts

@@ -35,6 +35,12 @@ export interface CanvasTableViewOptions {
     readonly container: HTMLElement;
     readonly table: TableHandle;
     readonly controllerOptions?: CanvasTableViewControllerOptions;
+    /**
+     * Selects the table palette. `light` is the compatibility default;
+     * `auto` follows the browser's `prefers-color-scheme` media query.
+     * Forced-colors mode always takes precedence over this setting.
+     */
+    readonly colorScheme?: "auto" | "light" | "dark";
     /**
      * Applies static spreadsheet presentation metadata when available.
      * Workbook colors never override the system palette in forced-colors mode.

package/dist/view/canvas-table-view.d.ts

@@ -2,6 +2,7 @@ import type { TableHandle } from "../client.js";
 import { type CanvasTableTheme } from "./canvas-painter.js";
 import { type TableViewController } from "./controller.js";
 import type { TableControllerOptions } from "./types.js";
+type CanvasColorScheme = "auto" | "light" | "dark";
 export interface CanvasTableViewOptions {
     readonly container: HTMLElement;
     /** Provide either a table or a preconfigured controller, never both. */
@@ -9,6 +10,12 @@ export interface CanvasTableViewOptions {
     /** Provide either a controller or a table, never both. */
     readonly controller?: TableViewController;
     readonly controllerOptions?: TableControllerOptions;
+    /**
+     * Selects the table palette. `light` is the compatibility default;
+     * `auto` follows the browser's `prefers-color-scheme` media query.
+     * Forced-colors mode always takes precedence over this setting.
+     */
+    readonly colorScheme?: CanvasColorScheme;
     /**
      * Applies static spreadsheet sizing metadata when a TableHandle provides it.
      * Workbook colors never override the system palette in forced-colors mode.
@@ -30,3 +37,4 @@ export interface CanvasTableView {
 }
 /** Mounts an accessible, viewport-driven Canvas preview. */
 export declare function createCanvasTableView(options: CanvasTableViewOptions): CanvasTableView;
+export {};

package/dist/wasm/arrow/tabulark_arrow.d.ts

@@ -1,7 +1,7 @@
 /* tslint:disable */
 /* eslint-disable */
 /**
- * Dedicated Arrow IPC runtime artifact implementing adapter ABI v2.
+ * Dedicated Arrow IPC runtime artifact implementing adapter ABI v3.
  */
 export class WasmRuntime {
   free(): void;
@@ -12,7 +12,8 @@ export class WasmRuntime {
   /**
    * Begins an open without copying the full source into WebAssembly.
    *
-   * IPC Files request only their trailer, footer, and record metadata here.
+   * IPC Files request only their trailer, footer, and batched dictionary/
+   * record metadata here.
    * IPC Streams request bounded sequential chunks.
    */
   beginOpen(options: any, source_length: number): any;
@@ -37,6 +38,15 @@ export class WasmRuntime {
    * Returns no static presentation for Arrow IPC tables.
    */
   presentation(table_handle: number): any;
+  /**
+   * Starts and synchronously completes a metadata operation.
+   */
+  beginMetadata(table_handle: number): any;
+  /**
+   * Starts and synchronously completes an open-table operation using the
+   * common ABI-v3 step envelope.
+   */
+  beginOpenTable(source_handle: number, table_id: string): any;
   /**
    * Cancels and releases a pending adapter operation.
    */
@@ -46,10 +56,18 @@ export class WasmRuntime {
    */
   protocolVersion(): number;
   /**
-   * Supplies exactly one requested source byte range and advances an open
-   * or File range-read operation.
+   * Returns the private adapter-owned resource ledger snapshot.
+   */
+  resourceSnapshot(): any;
+  /**
+   * Starts and synchronously completes a static-presentation operation.
+   */
+  beginPresentation(table_handle: number): any;
+  /**
+   * Supplies one complete revision-matched source result set and advances
+   * an open or File range-read operation.
    */
-  continueOperation(operation_handle: number, absolute_offset: number, bytes: Uint8Array, eof: boolean): any;
+  continueOperation(operation_handle: number, operation_revision: number, results: Array<any>): any;
   /**
    * Returns the official adapter ABI version.
    */
@@ -62,6 +80,10 @@ export class WasmRuntime {
    * Returns no range presentation for Arrow IPC tables.
    */
   readPresentationRange(table_handle: number, request: any): any;
+  /**
+   * Starts and synchronously completes a range-presentation operation.
+   */
+  beginPresentationRange(table_handle: number, request: any): any;
   /**
    * Creates an empty Arrow adapter runtime.
    */
@@ -84,18 +106,23 @@ export interface InitOutput {
   readonly wasmruntime_adapterApiVersion: (a: number) => number;
   readonly wasmruntime_adapterId: (a: number, b: number) => void;
   readonly wasmruntime_batchLayoutVersion: (a: number) => number;
+  readonly wasmruntime_beginMetadata: (a: number, b: number, c: number) => void;
   readonly wasmruntime_beginOpen: (a: number, b: number, c: number, d: number) => void;
+  readonly wasmruntime_beginOpenTable: (a: number, b: number, c: number, d: number, e: number) => void;
+  readonly wasmruntime_beginPresentation: (a: number, b: number, c: number) => void;
+  readonly wasmruntime_beginPresentationRange: (a: number, b: number, c: number, d: number) => void;
   readonly wasmruntime_beginRead: (a: number, b: number, c: number, d: number) => void;
   readonly wasmruntime_cancelOperation: (a: number, b: number) => number;
   readonly wasmruntime_closeSource: (a: number, b: number) => number;
   readonly wasmruntime_closeTable: (a: number, b: number) => number;
-  readonly wasmruntime_continueOperation: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+  readonly wasmruntime_continueOperation: (a: number, b: number, c: number, d: number, e: number) => void;
   readonly wasmruntime_metadata: (a: number, b: number, c: number) => void;
   readonly wasmruntime_new: (a: number, b: number) => void;
   readonly wasmruntime_openTable: (a: number, b: number, c: number, d: number, e: number) => void;
   readonly wasmruntime_presentation: (a: number, b: number, c: number) => void;
   readonly wasmruntime_protocolVersion: (a: number) => number;
   readonly wasmruntime_readPresentationRange: (a: number, b: number, c: number, d: number) => void;
+  readonly wasmruntime_resourceSnapshot: (a: number, b: number) => void;
   readonly wasmruntime_shutdown: (a: number) => void;
   readonly __wbindgen_export_0: (a: number, b: number) => number;
   readonly __wbindgen_export_1: (a: number, b: number, c: number, d: number) => number;

package/dist/wasm/arrow/tabulark_arrow.js

@@ -91,6 +91,14 @@ function addHeapObject(obj) {
     return idx;
 }
 
+function handleError(f, args) {
+    try {
+        return f.apply(this, args);
+    } catch (e) {
+        wasm.__wbindgen_export_2(addHeapObject(e));
+    }
+}
+
 function dropObject(idx) {
     if (idx < 132) return;
     heap[idx] = heap_next;
@@ -103,14 +111,6 @@ function takeObject(idx) {
     return ret;
 }
 
-function handleError(f, args) {
-    try {
-        return f.apply(this, args);
-    } catch (e) {
-        wasm.__wbindgen_export_2(addHeapObject(e));
-    }
-}
-
 function isLikeNone(x) {
     return x === undefined || x === null;
 }
@@ -193,7 +193,7 @@ const WasmRuntimeFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_wasmruntime_free(ptr >>> 0, 1));
 /**
- * Dedicated Arrow IPC runtime artifact implementing adapter ABI v2.
+ * Dedicated Arrow IPC runtime artifact implementing adapter ABI v3.
  */
 export class WasmRuntime {
 
@@ -231,7 +231,8 @@ export class WasmRuntime {
     /**
      * Begins an open without copying the full source into WebAssembly.
      *
-     * IPC Files request only their trailer, footer, and record metadata here.
+     * IPC Files request only their trailer, footer, and batched dictionary/
+     * record metadata here.
      * IPC Streams request bounded sequential chunks.
      * @param {any} options
      * @param {number} source_length
@@ -335,6 +336,50 @@ export class WasmRuntime {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Starts and synchronously completes a metadata operation.
+     * @param {number} table_handle
+     * @returns {any}
+     */
+    beginMetadata(table_handle) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmruntime_beginMetadata(retptr, this.__wbg_ptr, table_handle);
+            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 takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Starts and synchronously completes an open-table operation using the
+     * common ABI-v3 step envelope.
+     * @param {number} source_handle
+     * @param {string} table_id
+     * @returns {any}
+     */
+    beginOpenTable(source_handle, table_id) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(table_id, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.wasmruntime_beginOpenTable(retptr, this.__wbg_ptr, source_handle, 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 takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Cancels and releases a pending adapter operation.
      * @param {number} operation_handle
@@ -353,18 +398,56 @@ export class WasmRuntime {
         return ret >>> 0;
     }
     /**
-     * Supplies exactly one requested source byte range and advances an open
-     * or File range-read operation.
+     * Returns the private adapter-owned resource ledger snapshot.
+     * @returns {any}
+     */
+    resourceSnapshot() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmruntime_resourceSnapshot(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 takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Starts and synchronously completes a static-presentation operation.
+     * @param {number} table_handle
+     * @returns {any}
+     */
+    beginPresentation(table_handle) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmruntime_beginPresentation(retptr, this.__wbg_ptr, table_handle);
+            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 takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Supplies one complete revision-matched source result set and advances
+     * an open or File range-read operation.
      * @param {number} operation_handle
-     * @param {number} absolute_offset
-     * @param {Uint8Array} bytes
-     * @param {boolean} eof
+     * @param {number} operation_revision
+     * @param {Array<any>} results
      * @returns {any}
      */
-    continueOperation(operation_handle, absolute_offset, bytes, eof) {
+    continueOperation(operation_handle, operation_revision, results) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.wasmruntime_continueOperation(retptr, this.__wbg_ptr, operation_handle, absolute_offset, addHeapObject(bytes), eof);
+            wasm.wasmruntime_continueOperation(retptr, this.__wbg_ptr, operation_handle, operation_revision, addHeapObject(results));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -413,6 +496,27 @@ export class WasmRuntime {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Starts and synchronously completes a range-presentation operation.
+     * @param {number} table_handle
+     * @param {any} request
+     * @returns {any}
+     */
+    beginPresentationRange(table_handle, request) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmruntime_beginPresentationRange(retptr, this.__wbg_ptr, table_handle, addHeapObject(request));
+            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 takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Creates an empty Arrow adapter runtime.
      * @param {any} config
@@ -507,10 +611,18 @@ function __wbg_get_imports() {
         const ret = getObject(arg0).buffer;
         return addHeapObject(ret);
     };
+    imports.wbg.__wbg_byteLength_ea52ac3de882b483 = function(arg0) {
+        const ret = getObject(arg0).byteLength;
+        return ret;
+    };
     imports.wbg.__wbg_entries_3265d4158b33e5dc = function(arg0) {
         const ret = Object.entries(getObject(arg0));
         return addHeapObject(ret);
     };
+    imports.wbg.__wbg_get_67b2ba62fc30de12 = function() { return handleError(function (arg0, arg1) {
+        const ret = Reflect.get(getObject(arg0), getObject(arg1));
+        return addHeapObject(ret);
+    }, arguments) };
     imports.wbg.__wbg_get_b9b93047fe3cf45b = function(arg0, arg1) {
         const ret = getObject(arg0)[arg1 >>> 0];
         return addHeapObject(ret);

package/dist/wasm/arrow/tabulark_arrow_bg.wasm.d.ts

@@ -5,18 +5,23 @@ export const __wbg_wasmruntime_free: (a: number, b: number) => void;
 export const wasmruntime_adapterApiVersion: (a: number) => number;
 export const wasmruntime_adapterId: (a: number, b: number) => void;
 export const wasmruntime_batchLayoutVersion: (a: number) => number;
+export const wasmruntime_beginMetadata: (a: number, b: number, c: number) => void;
 export const wasmruntime_beginOpen: (a: number, b: number, c: number, d: number) => void;
+export const wasmruntime_beginOpenTable: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wasmruntime_beginPresentation: (a: number, b: number, c: number) => void;
+export const wasmruntime_beginPresentationRange: (a: number, b: number, c: number, d: number) => void;
 export const wasmruntime_beginRead: (a: number, b: number, c: number, d: number) => void;
 export const wasmruntime_cancelOperation: (a: number, b: number) => number;
 export const wasmruntime_closeSource: (a: number, b: number) => number;
 export const wasmruntime_closeTable: (a: number, b: number) => number;
-export const wasmruntime_continueOperation: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmruntime_continueOperation: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmruntime_metadata: (a: number, b: number, c: number) => void;
 export const wasmruntime_new: (a: number, b: number) => void;
 export const wasmruntime_openTable: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmruntime_presentation: (a: number, b: number, c: number) => void;
 export const wasmruntime_protocolVersion: (a: number) => number;
 export const wasmruntime_readPresentationRange: (a: number, b: number, c: number, d: number) => void;
+export const wasmruntime_resourceSnapshot: (a: number, b: number) => void;
 export const wasmruntime_shutdown: (a: number) => void;
 export const __wbindgen_export_0: (a: number, b: number) => number;
 export const __wbindgen_export_1: (a: number, b: number, c: number, d: number) => number;

package/dist/wasm/delimited/tabulark_delimited.d.ts

@@ -41,6 +41,15 @@ export class WasmRuntime {
    * Returns no static presentation for delimited text tables.
    */
   presentation(table_handle: number): any;
+  /**
+   * Starts and synchronously completes a metadata operation.
+   */
+  beginMetadata(table_handle: number): any;
+  /**
+   * Starts and synchronously completes an open-table operation using the
+   * common ABI-v3 step envelope.
+   */
+  beginOpenTable(source_handle: number, table_id: string): any;
   /**
    * Cancels and releases a pending open or read operation.
    */
@@ -50,12 +59,20 @@ export class WasmRuntime {
    */
   protocolVersion(): number;
   /**
-   * Supplies exactly one requested source chunk and advances an open or
-   * range-read operation.
+   * Returns the private adapter-owned resource ledger snapshot.
+   */
+  resourceSnapshot(): any;
+  /**
+   * Starts and synchronously completes a static-presentation operation.
+   */
+  beginPresentation(table_handle: number): any;
+  /**
+   * Supplies a complete, revision-matched result set and advances an open
+   * or range-read operation.
    */
-  continueOperation(operation_handle: number, absolute_offset: number, bytes: Uint8Array, eof: boolean): any;
+  continueOperation(operation_handle: number, operation_revision: number, results: Array<any>): any;
   /**
-   * Returns official adapter ABI version two.
+   * Returns official adapter ABI version three.
    */
   adapterApiVersion(): number;
   /**
@@ -66,6 +83,10 @@ export class WasmRuntime {
    * Returns no range presentation for delimited text tables.
    */
   readPresentationRange(table_handle: number, request: any): any;
+  /**
+   * Starts and synchronously completes a range-presentation operation.
+   */
+  beginPresentationRange(table_handle: number, request: any): any;
   /**
    * Creates a runtime from a camel-case [`RuntimeConfig`] object.
    */
@@ -89,18 +110,23 @@ export interface InitOutput {
   readonly wasmruntime_adapterApiVersion: (a: number) => number;
   readonly wasmruntime_adapterId: (a: number, b: number) => void;
   readonly wasmruntime_batchLayoutVersion: (a: number) => number;
+  readonly wasmruntime_beginMetadata: (a: number, b: number, c: number) => void;
   readonly wasmruntime_beginOpen: (a: number, b: number, c: number, d: number) => void;
+  readonly wasmruntime_beginOpenTable: (a: number, b: number, c: number, d: number, e: number) => void;
+  readonly wasmruntime_beginPresentation: (a: number, b: number, c: number) => void;
+  readonly wasmruntime_beginPresentationRange: (a: number, b: number, c: number, d: number) => void;
   readonly wasmruntime_beginRead: (a: number, b: number, c: number, d: number) => void;
   readonly wasmruntime_cancelOperation: (a: number, b: number) => number;
   readonly wasmruntime_closeSource: (a: number, b: number) => number;
   readonly wasmruntime_closeTable: (a: number, b: number) => number;
-  readonly wasmruntime_continueOperation: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+  readonly wasmruntime_continueOperation: (a: number, b: number, c: number, d: number, e: number) => void;
   readonly wasmruntime_metadata: (a: number, b: number, c: number) => void;
   readonly wasmruntime_new: (a: number, b: number) => void;
   readonly wasmruntime_openTable: (a: number, b: number, c: number, d: number, e: number) => void;
   readonly wasmruntime_presentation: (a: number, b: number, c: number) => void;
   readonly wasmruntime_protocolVersion: (a: number) => number;
   readonly wasmruntime_readPresentationRange: (a: number, b: number, c: number, d: number) => void;
+  readonly wasmruntime_resourceSnapshot: (a: number, b: number) => void;
   readonly wasmruntime_shutdown: (a: number) => void;
   readonly __wbindgen_export_0: (a: number, b: number) => number;
   readonly __wbindgen_export_1: (a: number, b: number, c: number, d: number) => number;