@smoothbricks/lmao 0.2.2 → 0.3.0

package/dist/lib/wasm/wasmAllocator.d.ts

@@ -13,16 +13,24 @@
  *
  * Spec link (88): realizes specs/lmao/01q_wasm_memory_architecture.md#smoo/lmao!n/wasm-mem (TS allocator wrapper).
  */
+export interface WasmMemoryEpochPin {
+    readonly buffer: ArrayBuffer;
+    readonly version: number;
+    readonly released: boolean;
+    release(): void;
+}
+export declare const WASM_SPAN_IDENTITY_ROOT = 0;
+export declare const WASM_SPAN_IDENTITY_CHILD = 1;
+export declare const WASM_NO_LAYOUT_OFFSET = 4294967295;
 export interface WasmAllocator {
     /** The underlying WASM memory */
     readonly memory: WebAssembly.Memory;
-    /** WASM exports for direct function calls (hot path optimization) */
-    readonly exports: {
-        write_col_f64: (colOffset: number, rowIdx: number, value: number, capacity: number) => number;
-        write_col_u32: (colOffset: number, rowIdx: number, value: number, capacity: number) => number;
-        write_col_u8: (colOffset: number, rowIdx: number, value: number, capacity: number) => number;
-        write_log_entry: (systemPtr: number, identityPtr: number, traceRootPtr: number, entryType: number, capacity: number) => number;
-    };
+    /** Monotonic version of the current linear-memory ArrayBuffer. */
+    readonly memoryVersion: number;
+    /** Refresh canonical allocator views after growth and return memoryVersion. */
+    refreshViews(): number;
+    /** Pin the current linear-memory backing epoch for borrowed Arrow views. */
+    pinMemoryEpoch(): WasmMemoryEpochPin;
     /** Cached views (recreated after grow, but pre-sized to avoid grow for benchmarks) */
     readonly u8: Uint8Array;
     readonly u32: Uint32Array;
@@ -34,30 +42,27 @@ export interface WasmAllocator {
     init(): void;
     /** Reset all freelists (for testing/benchmarking) */
     reset(): void;
-    allocSpanSystem(capacity?: number): number;
-    alloc1B(capacity?: number): number;
-    alloc4B(capacity?: number): number;
-    alloc8B(capacity?: number): number;
-    freeSpanSystem(offset: number, capacity?: number): void;
-    free1B(offset: number, capacity?: number): void;
-    free4B(offset: number, capacity?: number): void;
-    free8B(offset: number, capacity?: number): void;
+    /** Allocate and release an exact logical byte extent with explicit alignment. */
+    allocExact(byteLength: number, alignment: number): number;
+    freeExact(offset: number, byteLength: number, alignment: number): void;
+    /**
+     * Allocate one root/child superblock and pre-arm its lifecycle rows in one
+     * WASM call. All offsets are immutable compile/startup layout constants.
+     */
+    createAndStartSpan(identityMode: typeof WASM_SPAN_IDENTITY_ROOT | typeof WASM_SPAN_IDENTITY_CHILD, traceIdLength: number, superblockByteLength: number, systemOffset: number, entryTypeOffset: number, rowHeaderOffset: number, traceRootPtr: number): number;
+    /** Allocate one storage-only overflow superblock in one WASM call. */
+    createOverflowSpan(superblockByteLength: number): number;
+    /** Release one root, child, or overflow superblock. */
+    freeSpanSuperblock(offset: number, byteLength: number): void;
     spanStart(systemPtr: number, identityPtr: number, traceRootPtr: number, capacity?: number): void;
     spanEndOk(systemPtr: number, traceRootPtr: number, capacity?: number): void;
     spanEndErr(systemPtr: number, traceRootPtr: number, capacity?: number): void;
     /** Write log entry, bump writeIndex, return idx written to */
     writeLogEntry(systemPtr: number, identityPtr: number, traceRootPtr: number, entryType: number, capacity?: number): number;
-    writeColF64(colOffset: number, rowIdx: number, value: number, capacity?: number): number;
-    writeColU32(colOffset: number, rowIdx: number, value: number, capacity?: number): number;
-    writeColU8(colOffset: number, rowIdx: number, value: number, capacity?: number): number;
     initTraceRoot(traceRootPtr: number): void;
     getBumpPtr(): number;
     getAllocCount(): number;
     getFreeCount(): number;
-    getSpanSystemSize(capacity?: number): number;
-    getCol1BSize(capacity?: number): number;
-    getCol4BSize(capacity?: number): number;
-    getCol8BSize(capacity?: number): number;
     readTimestamp(systemPtr: number, rowIdx: number): bigint;
     readEntryType(systemPtr: number, rowIdx: number, capacity?: number): number;
     readWriteIndex(identityPtr: number): number;

package/dist/lib/wasm/wasmAllocator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wasmAllocator.d.ts","sourceRoot":"","sources":["../../../src/lib/wasm/wasmAllocator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;IAEpC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE;QAChB,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;QAC9F,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;QAC9F,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;QAC7F,eAAe,EAAE,CACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,KACb,MAAM,CAAC;KACb,CAAC;IAEF,sFAAsF;IACtF,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAE3B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,8CAA8C;IAC9C,IAAI,IAAI,IAAI,CAAC;IAEb,qDAAqD;IACrD,KAAK,IAAI,IAAI,CAAC;IAGd,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAGnC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGhD,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5E,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7E,8DAA8D;IAC9D,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAAC;IAGV,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzF,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzF,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAGxF,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAG1C,UAAU,IAAI,MAAM,CAAC;IACrB,aAAa,IAAI,MAAM,CAAC;IACxB,YAAY,IAAI,MAAM,CAAC;IACvB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAGxC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACzD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5E,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5C,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzE,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAG1D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,eAAe,IAAI,MAAM,CAAC;IAC1B,cAAc,IAAI,MAAM,CAAC;IACzB,aAAa,IAAI,MAAM,CAAC;IACxB,gBAAgB,IAAI,MAAM,CAAC;IAG3B,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IACxD,kBAAkB,IAAI,MAAM,CAAC;IAC7B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAChD,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IACpD,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAGnD,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChE,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvE,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvE,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxE;AAED;;GAEG;AACH,oBAAY,SAAS;IACnB,UAAU,IAAI;IACd,KAAK,IAAI;IACT,KAAK,IAAI;IACT,KAAK,IAAI;IACT,QAAQ,IAAI;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA0RD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmBhG;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAgBrH"}
+{"version":3,"file":"wasmAllocator.d.ts","sourceRoot":"","sources":["../../../src/lib/wasm/wasmAllocator.ts"],"names":[],"mappings":"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"}

package/dist/lib/wasm/wasmAllocator.js

@@ -13,6 +13,9 @@
  *
  * Spec link (88): realizes specs/lmao/01q_wasm_memory_architecture.md#smoo/lmao!n/wasm-mem (TS allocator wrapper).
  */
+export const WASM_SPAN_IDENTITY_ROOT = 0;
+export const WASM_SPAN_IDENTITY_CHILD = 1;
+export const WASM_NO_LAYOUT_OFFSET = 0xffffffff;
 /**
  * Size class enum matching Zig's SizeClass
  */
@@ -28,7 +31,11 @@ function isWasmExports(value) {
     if (typeof value !== 'object' || value === null) {
         return false;
     }
-    return (typeof Reflect.get(value, 'init') === 'function' && typeof Reflect.get(value, 'alloc_span_system') === 'function');
+    return (typeof Reflect.get(value, 'init') === 'function' &&
+        typeof Reflect.get(value, 'alloc_exact') === 'function' &&
+        typeof Reflect.get(value, 'create_and_start_span') === 'function' &&
+        typeof Reflect.get(value, 'create_overflow_span') === 'function' &&
+        typeof Reflect.get(value, 'free_span_superblock') === 'function');
 }
 // =============================================================================
 // Implementation
@@ -58,75 +65,87 @@ function wrapWasmInstance(instance, memory, capacity) {
     const exports = instance.exports;
     let views = createViews(memory);
     let currentBuffer = memory.buffer;
+    let memoryVersion = 1;
+    let memoryEpochPins = 0;
+    const refreshViews = () => {
+        if (memory.buffer !== currentBuffer) {
+            if (memoryEpochPins !== 0) {
+                throw new Error('WASM memory grew while an Arrow lease pinned the previous epoch');
+            }
+            currentBuffer = memory.buffer;
+            views = createViews(memory);
+            memoryVersion++;
+        }
+        return memoryVersion;
+    };
     // Initialize the allocator header
     exports.init();
     return {
         memory,
         capacity,
-        exports: {
-            write_col_f64: exports.write_col_f64,
-            write_col_u32: exports.write_col_u32,
-            write_col_u8: exports.write_col_u8,
-            write_log_entry: exports.write_log_entry,
+        get memoryVersion() {
+            return refreshViews();
+        },
+        refreshViews,
+        pinMemoryEpoch() {
+            const version = refreshViews();
+            const buffer = currentBuffer;
+            memoryEpochPins++;
+            let released = false;
+            return {
+                buffer,
+                version,
+                get released() {
+                    return released;
+                },
+                release() {
+                    if (released)
+                        return;
+                    released = true;
+                    memoryEpochPins--;
+                },
+            };
         },
         get u8() {
-            // Check if memory grew since last access
-            if (memory.buffer !== currentBuffer) {
-                currentBuffer = memory.buffer;
-                views = createViews(memory);
-            }
+            refreshViews();
             return views.u8;
         },
         get u32() {
-            if (memory.buffer !== currentBuffer) {
-                currentBuffer = memory.buffer;
-                views = createViews(memory);
-            }
+            refreshViews();
             return views.u32;
         },
         get i64() {
-            if (memory.buffer !== currentBuffer) {
-                currentBuffer = memory.buffer;
-                views = createViews(memory);
-            }
+            refreshViews();
             return views.i64;
         },
         get f64() {
-            if (memory.buffer !== currentBuffer) {
-                currentBuffer = memory.buffer;
-                views = createViews(memory);
-            }
+            refreshViews();
             return views.f64;
         },
         init: exports.init,
         reset: exports.reset,
-        // Allocation with optional capacity (defaults to instance capacity)
-        allocSpanSystem: (cap = capacity) => exports.alloc_span_system(cap),
-        alloc1B: (cap = capacity) => exports.alloc_col_1b(cap),
-        alloc4B: (cap = capacity) => exports.alloc_col_4b(cap),
-        alloc8B: (cap = capacity) => exports.alloc_col_8b(cap),
-        // Deallocation with optional capacity
-        freeSpanSystem: (offset, cap = capacity) => exports.free_span_system(offset, cap),
-        free1B: (offset, cap = capacity) => exports.free_col_1b(offset, cap),
-        free4B: (offset, cap = capacity) => exports.free_col_4b(offset, cap),
-        free8B: (offset, cap = capacity) => exports.free_col_8b(offset, cap),
+        allocExact: exports.alloc_exact,
+        freeExact: exports.free_exact,
+        createAndStartSpan: (identityMode, traceIdLength, superblockByteLength, systemOffset, entryTypeOffset, rowHeaderOffset, traceRootPtr) => {
+            const offset = exports.create_and_start_span(identityMode, traceIdLength, superblockByteLength, systemOffset, entryTypeOffset, rowHeaderOffset, traceRootPtr);
+            refreshViews();
+            return offset;
+        },
+        createOverflowSpan: (superblockByteLength) => {
+            const offset = exports.create_overflow_span(superblockByteLength);
+            refreshViews();
+            return offset;
+        },
+        freeSpanSuperblock: exports.free_span_superblock,
         // Span lifecycle with optional capacity
         spanStart: (systemPtr, identityPtr, traceRootPtr, cap = capacity) => exports.span_start(systemPtr, identityPtr, traceRootPtr, cap),
         spanEndOk: (systemPtr, traceRootPtr, cap = capacity) => exports.span_end_ok(systemPtr, traceRootPtr, cap),
         spanEndErr: (systemPtr, traceRootPtr, cap = capacity) => exports.span_end_err(systemPtr, traceRootPtr, cap),
-        writeLogEntry: (systemPtr, traceRootPtr, idx, entryType, cap = capacity) => exports.write_log_entry(systemPtr, traceRootPtr, idx, entryType, cap),
-        // Column writes with optional capacity
-        writeColF64: (colOffset, rowIdx, value, cap = capacity) => exports.write_col_f64(colOffset, rowIdx, value, cap),
-        writeColU32: (colOffset, rowIdx, value, cap = capacity) => exports.write_col_u32(colOffset, rowIdx, value, cap),
-        writeColU8: (colOffset, rowIdx, value, cap = capacity) => exports.write_col_u8(colOffset, rowIdx, value, cap),
+        writeLogEntry: (systemPtr, identityPtr, traceRootPtr, entryType, cap = capacity) => exports.write_log_entry(systemPtr, identityPtr, traceRootPtr, entryType, cap),
         initTraceRoot: exports.init_trace_root,
         getBumpPtr: exports.get_bump_ptr,
         getAllocCount: exports.get_alloc_count,
         getFreeCount: exports.get_free_count,
-        getSpanSystemSize: (cap = capacity) => exports.get_span_system_size(cap),
-        getCol1BSize: (cap = capacity) => exports.get_col_1b_size(cap),
-        getCol4BSize: (cap = capacity) => exports.get_col_4b_size(cap),
-        getCol8BSize: (cap = capacity) => exports.get_col_8b_size(cap),
         readTimestamp: exports.read_timestamp,
         readEntryType: (systemPtr, rowIdx, cap = capacity) => exports.read_entry_type(systemPtr, rowIdx, cap),
         readWriteIndex: exports.read_write_index,
@@ -167,6 +186,9 @@ function createImports(memory) {
 // Cache for compiled WASM module (shared across all allocators)
 // This eliminates recompilation cost in benchmarks and production
 let cachedWasmModule = null;
+// The shipped Rust allocator is the only supported artifact. Node and browser loading
+// deliberately share this fixed path so runtime selection cannot drift by environment.
+const WASM_ARTIFACT_NAME = 'allocator.wasm';
 /**
  * Load WASM bytes - handles both Node.js and browser environments.
  */
@@ -179,7 +201,7 @@ async function loadWasmBytes() {
         // __dirname equivalent for ESM
         const currentFile = fileURLToPath(import.meta.url);
         const currentDir = dirname(currentFile);
-        const wasmPath = join(currentDir, '../../../dist/allocator.wasm');
+        const wasmPath = join(currentDir, '../../../dist', WASM_ARTIFACT_NAME);
         const buffer = await readFile(wasmPath);
         // Create a proper ArrayBuffer from the Node.js Buffer
         const arrayBuffer = new ArrayBuffer(buffer.byteLength);
@@ -187,7 +209,7 @@ async function loadWasmBytes() {
         return arrayBuffer;
     }
     // Browser: fetch from relative path
-    const response = await fetch(new URL('../../../dist/allocator.wasm', import.meta.url));
+    const response = await fetch(new URL(`../../../dist/${WASM_ARTIFACT_NAME}`, import.meta.url));
     return response.arrayBuffer();
 }
 /**

package/dist/lib/wasm/wasmPhysicalLayout.d.ts

@@ -0,0 +1,67 @@
+import type { EagerColumnDescriptor } from '../physicalLayoutPlan.js';
+import type { MessageLayoutFamily, MessagePhysicalLayout } from '../runtimeHint.js';
+import type { LogSchema } from '../schema/LogSchema.js';
+export type WasmNumericFamily = 'u8' | 'u32' | 'f64';
+export type WasmArrayType = 'Uint8Array' | 'Uint32Array' | 'Float64Array' | 'BigUint64Array';
+export interface WasmColumnLayoutTemplate {
+    readonly name: string;
+    readonly columnIndex: number;
+    readonly family: WasmNumericFamily;
+    readonly arrayType: WasmArrayType;
+    readonly byteWidth: 1 | 4 | 8;
+    readonly alignment: 1 | 4 | 8;
+    readonly eager: boolean;
+}
+export interface WasmColumnLayoutDescriptor extends WasmColumnLayoutTemplate {
+    readonly nullOffset: number;
+    readonly nullByteLength: number;
+    readonly valueOffset: number;
+    readonly valueLength: number;
+}
+export interface WasmNumericSlabLayoutDescriptor {
+    readonly family: WasmNumericFamily;
+    readonly byteLength: number;
+    readonly alignment: 1 | 4 | 8;
+}
+export interface WasmSystemSlabLayoutDescriptor {
+    readonly family: 'system';
+    readonly byteLength: number;
+    readonly alignment: 8;
+    readonly timestampOffset: 0;
+    readonly entryTypeOffset: number | null;
+    readonly messageIdOffset: number | null;
+    readonly messageDenseIndexOffset: number | null;
+    readonly rowHeaderOffset: number | null;
+    /** Logical row offset into the JS raw-message sidecar; contributes no WASM bytes. */
+    readonly messageValueOffset: 0 | null;
+}
+export type WasmSlabLayoutDescriptor = WasmSystemSlabLayoutDescriptor | WasmNumericSlabLayoutDescriptor;
+export interface WasmSuperblockLayoutDescriptor {
+    readonly byteLength: number;
+    /** Bytes consumed by the previous separate-allocation shape from an 8-byte-aligned start. */
+    readonly legacyByteLength: number;
+    readonly identityOffset: 0 | null;
+    readonly systemOffset: number;
+    readonly familyOffsets: Readonly<Record<WasmNumericFamily, number>>;
+}
+export interface WasmPhysicalLayoutDescriptor {
+    readonly capacity: number;
+    readonly messageLayoutFamily: MessageLayoutFamily;
+    readonly messagePhysicalLayout: MessagePhysicalLayout;
+    readonly eagerColumns: EagerColumnDescriptor;
+    readonly system: WasmSystemSlabLayoutDescriptor;
+    readonly slabs: Readonly<Record<WasmNumericFamily, WasmNumericSlabLayoutDescriptor | null>>;
+    readonly columns: readonly WasmColumnLayoutDescriptor[];
+    readonly spanSuperblock: WasmSuperblockLayoutDescriptor;
+    readonly overflowSuperblock: WasmSuperblockLayoutDescriptor;
+}
+export interface WasmLayoutTemplate {
+    readonly messageLayoutFamily: MessageLayoutFamily;
+    readonly messagePhysicalLayout: MessagePhysicalLayout;
+    readonly eagerColumns: EagerColumnDescriptor;
+    readonly columns: readonly WasmColumnLayoutTemplate[];
+    forCapacity(capacity: number): WasmPhysicalLayoutDescriptor;
+}
+export declare function createWasmLayoutTemplate(schema: LogSchema, messageLayoutFamily?: MessageLayoutFamily, messagePhysicalLayout?: MessagePhysicalLayout, eagerColumns?: EagerColumnDescriptor): WasmLayoutTemplate;
+export declare function getWasmPhysicalLayout(schema: LogSchema, capacity: number, messageLayoutFamily?: MessageLayoutFamily, messagePhysicalLayout?: MessagePhysicalLayout, eagerColumns?: EagerColumnDescriptor): WasmPhysicalLayoutDescriptor;
+//# sourceMappingURL=wasmPhysicalLayout.d.ts.map

package/dist/lib/wasm/wasmPhysicalLayout.d.ts.map

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

package/dist/lib/wasm/wasmPhysicalLayout.js

@@ -0,0 +1,179 @@
+import { getSchemaType } from '@smoothbricks/arrow-builder';
+const WASM_IDENTITY_BYTE_LENGTH = 128;
+const EXACT_FREELIST_METADATA_BYTE_LENGTH = 16;
+const EMPTY_EAGER_COLUMNS = Object.freeze({
+    names: Object.freeze([]),
+    words: Object.freeze([]),
+    key: '',
+});
+function align(value, alignment) {
+    return (value + alignment - 1) & ~(alignment - 1);
+}
+function freezeSuperblockLayout(system, slabs, includesIdentity) {
+    let byteLength = includesIdentity ? WASM_IDENTITY_BYTE_LENGTH : 0;
+    let legacyByteLength = byteLength;
+    const systemAlignment = Math.max(system.alignment, 4);
+    const systemOffset = align(byteLength, systemAlignment);
+    byteLength = systemOffset + system.byteLength;
+    legacyByteLength =
+        align(legacyByteLength, systemAlignment) + Math.max(system.byteLength, EXACT_FREELIST_METADATA_BYTE_LENGTH);
+    const familyOffsets = { u8: 0, u32: 0, f64: 0 };
+    for (const family of ['u8', 'u32', 'f64']) {
+        const slab = slabs[family];
+        if (slab === null)
+            continue;
+        const storageAlignment = Math.max(slab.alignment, 4);
+        const offset = align(byteLength, storageAlignment);
+        familyOffsets[family] = offset;
+        byteLength = offset + slab.byteLength;
+        legacyByteLength =
+            align(legacyByteLength, storageAlignment) + Math.max(slab.byteLength, EXACT_FREELIST_METADATA_BYTE_LENGTH);
+    }
+    if (byteLength > legacyByteLength) {
+        throw new Error('WASM superblock exceeded its separate-allocation footprint');
+    }
+    return Object.freeze({
+        byteLength,
+        legacyByteLength,
+        identityOffset: includesIdentity ? 0 : null,
+        systemOffset,
+        familyOffsets: Object.freeze(familyOffsets),
+    });
+}
+function freezeExactLayout(capacity, messageLayoutFamily, messagePhysicalLayout, templates, eagerColumns) {
+    if (!Number.isSafeInteger(capacity) || capacity <= 0) {
+        throw new RangeError(`WASM layout capacity must be a positive safe integer, received ${capacity}`);
+    }
+    const nullByteLength = Math.ceil(capacity / 8);
+    const familyOffsets = { u8: 0, u32: 0, f64: 0 };
+    const columns = [];
+    for (const template of templates) {
+        const nullOffset = familyOffsets[template.family];
+        const valueOffset = align(nullOffset + nullByteLength, template.alignment);
+        const valueLength = capacity * template.byteWidth;
+        familyOffsets[template.family] = valueOffset + valueLength;
+        columns.push(Object.freeze({
+            ...template,
+            nullOffset,
+            nullByteLength,
+            valueOffset,
+            valueLength,
+        }));
+    }
+    const slab = (family, alignment) => {
+        const byteLength = familyOffsets[family];
+        return byteLength === 0 ? null : Object.freeze({ family, byteLength, alignment });
+    };
+    const hasStaticMessages = messageLayoutFamily !== 'dynamic-only';
+    const messageValueOffset = messageLayoutFamily === 'static-only' ? null : 0;
+    let systemByteLength = capacity * 8;
+    let entryTypeOffset = null;
+    let messageIdOffset = null;
+    let messageDenseIndexOffset = null;
+    let rowHeaderOffset = null;
+    if (messagePhysicalLayout === 'packed') {
+        rowHeaderOffset = align(systemByteLength, 4);
+        systemByteLength = rowHeaderOffset + capacity * 4;
+    }
+    else {
+        entryTypeOffset = systemByteLength;
+        systemByteLength = entryTypeOffset + capacity;
+        if (hasStaticMessages) {
+            if (messagePhysicalLayout === 'current') {
+                messageIdOffset = align(systemByteLength, 2);
+                systemByteLength = messageIdOffset + capacity * 2;
+            }
+            else {
+                messageDenseIndexOffset = align(systemByteLength, 4);
+                systemByteLength = messageDenseIndexOffset + capacity * 4;
+            }
+        }
+    }
+    const system = Object.freeze({
+        family: 'system',
+        byteLength: align(systemByteLength, 8),
+        alignment: 8,
+        timestampOffset: 0,
+        entryTypeOffset,
+        messageIdOffset,
+        messageDenseIndexOffset,
+        rowHeaderOffset,
+        messageValueOffset,
+    });
+    const slabs = Object.freeze({
+        u8: slab('u8', 1),
+        u32: slab('u32', 4),
+        f64: slab('f64', 8),
+    });
+    return Object.freeze({
+        capacity,
+        messageLayoutFamily,
+        messagePhysicalLayout,
+        eagerColumns,
+        system,
+        slabs,
+        spanSuperblock: freezeSuperblockLayout(system, slabs, true),
+        overflowSuperblock: freezeSuperblockLayout(system, slabs, false),
+        columns: Object.freeze(columns),
+    });
+}
+function buildWasmLayoutTemplate(schema, messageLayoutFamily, messagePhysicalLayout, eagerColumns) {
+    const columns = [];
+    const preallocatedColumns = new Set(eagerColumns.names);
+    let columnIndex = 0;
+    for (const name of schema._columnNames) {
+        const field = schema.fields[name];
+        const schemaType = getSchemaType(field);
+        const eager = preallocatedColumns.has(name) ||
+            (typeof field === 'object' && field !== null && Reflect.get(field, '__eager') === true);
+        let storage = null;
+        switch (schemaType) {
+            case 'enum':
+            case 'boolean':
+                storage = { family: 'u8', arrayType: 'Uint8Array', byteWidth: 1, alignment: 1 };
+                break;
+            case 'number':
+                storage = { family: 'f64', arrayType: 'Float64Array', byteWidth: 8, alignment: 8 };
+                break;
+            case 'bigUint64':
+                storage = { family: 'f64', arrayType: 'BigUint64Array', byteWidth: 8, alignment: 8 };
+                break;
+        }
+        if (storage !== null && name !== 'message') {
+            columns.push(Object.freeze({ name, columnIndex, eager, ...storage }));
+        }
+        columnIndex++;
+    }
+    const frozenColumns = Object.freeze(columns);
+    const descriptors = new Map();
+    return Object.freeze({
+        messageLayoutFamily,
+        messagePhysicalLayout,
+        eagerColumns,
+        columns: frozenColumns,
+        forCapacity(capacity) {
+            let descriptor = descriptors.get(capacity);
+            if (descriptor === undefined) {
+                descriptor = freezeExactLayout(capacity, messageLayoutFamily, messagePhysicalLayout, frozenColumns, eagerColumns);
+                descriptors.set(capacity, descriptor);
+            }
+            return descriptor;
+        },
+    });
+}
+const templates = new WeakMap();
+export function createWasmLayoutTemplate(schema, messageLayoutFamily = 'mixed', messagePhysicalLayout = 'current', eagerColumns = EMPTY_EAGER_COLUMNS) {
+    const cacheKey = `${messageLayoutFamily}:${messagePhysicalLayout}:${eagerColumns.key}`;
+    let familyTemplates = templates.get(schema);
+    let template = familyTemplates?.get(cacheKey);
+    if (template === undefined) {
+        template = buildWasmLayoutTemplate(schema, messageLayoutFamily, messagePhysicalLayout, eagerColumns);
+        familyTemplates ??= new Map();
+        familyTemplates.set(cacheKey, template);
+        templates.set(schema, familyTemplates);
+    }
+    return template;
+}
+export function getWasmPhysicalLayout(schema, capacity, messageLayoutFamily = 'mixed', messagePhysicalLayout = 'current', eagerColumns = EMPTY_EAGER_COLUMNS) {
+    return createWasmLayoutTemplate(schema, messageLayoutFamily, messagePhysicalLayout, eagerColumns).forCapacity(capacity);
+}