@smoothbricks/lmao 0.1.3 → 0.1.4

package/src/lib/wasm/WasmBufferStrategy.ts

@@ -30,6 +30,9 @@ import {
   type WasmSpanBufferInstance,
 } from './wasmSpanBuffer.js';
 
+// Spec link (88): realizes specs/lmao/01q_wasm_memory_architecture.md#smoo/lmao!n/wasm-mem (OpContext integration + trace completion).
+//#region smoo/lmao!n/wasm-mem.strategy
+
 function requireWasmSpanBuffer(buffer: AnySpanBuffer): WasmSpanBufferInstance {
   if (!isWasmSpanBufferInstance(buffer)) {
     throw new Error('Expected WASM-backed span buffer');
@@ -217,3 +220,4 @@ export class WasmBufferStrategy<T extends LogSchema = LogSchema> implements Buff
     };
   }
 }
+//#endregion smoo/lmao!n/wasm-mem.strategy

package/src/lib/wasm/allocator.zig

@@ -6,7 +6,7 @@
 //
 // Memory Layout:
 // ┌─────────────────────────────────────────────────────────────────────────────┐
-// │ Header (64 bytes, cache-aligned)                                            │
+// │ Header (192 bytes, 3 cache lines)                                           │
 // ├─────────────────────────────────────────────────────────────────────────────┤
 // │ Allocated Blocks (spans + columns)                                          │
 // ├─────────────────────────────────────────────────────────────────────────────┤
@@ -22,7 +22,9 @@
 //
 // Freelist: Zero-overhead, uses block's memory for next pointer + cascading stats when free.
 //
+// Spec link (88): realizes specs/lmao/01q_wasm_memory_architecture.md#smoo/lmao!n/wasm-mem (the Zig allocator region).
 
+//#region smoo/lmao!n/wasm-mem.allocator
 const std = @import("std");
 
 // =============================================================================
@@ -943,3 +945,4 @@ export fn read_col_is_valid(col_offset: u32, row_idx: u32) u8 {
     const bit: u8 = @as(u8, 1) << @intCast(row_idx & 7);
     return if ((byte & bit) != 0) 1 else 0;
 }
+//#endregion smoo/lmao!n/wasm-mem.allocator

package/src/lib/wasm/wasmAllocator.ts

@@ -10,8 +10,12 @@
  * - Blocks are organized by tier (capacity 8, 16, 32, 64, 128, 256, 512)
  * - When freelist is empty, splits from larger tier
  * - When freeing, merges with adjacent blocks if both are free (address-based buddy merge)
+ *
+ * Spec link (88): realizes specs/lmao/01q_wasm_memory_architecture.md#smoo/lmao!n/wasm-mem (TS allocator wrapper).
  */
 
+//#region smoo/lmao!n/wasm-mem.ts-allocator
+
 // =============================================================================
 // Types
 // =============================================================================
@@ -467,3 +471,4 @@ export function createWasmAllocatorSync(wasmModule: WebAssembly.Module, options?
 
   return wrapWasmInstance(instance, memory, capacity);
 }
+//#endregion smoo/lmao!n/wasm-mem.ts-allocator

package/src/lib/wasm/wasmSpanBuffer.ts

@@ -20,6 +20,9 @@ import type { ITraceRoot } from '../traceRoot.js';
 import type { AnySpanBuffer } from '../types.js';
 import type { WasmAllocator } from './wasmAllocator.js';
 
+// Spec link (88): realizes specs/lmao/01q_wasm_memory_architecture.md#smoo/lmao!n/wasm-mem (SpanBuffer + SpanLogger codegen).
+//#region smoo/lmao!n/wasm-mem.spanbuffer
+
 // =============================================================================
 // Types
 // =============================================================================
@@ -1012,3 +1015,4 @@ export function createWasmOverflowBuffer(
 
   return overflow;
 }
+//#endregion smoo/lmao!n/wasm-mem.spanbuffer

package/src/lib/wasm/wasmTraceRoot.ts

@@ -16,6 +16,9 @@ import type { ITraceRoot, TracerLifecycleHooks } from '../traceRoot.js';
 import type { AnySpanBuffer } from '../types.js';
 import type { WasmAllocator } from './wasmAllocator.js';
 
+// Spec link (88): realizes specs/lmao/01q_wasm_memory_architecture.md#smoo/lmao!n/wasm-mem (span lifecycle writer).
+//#region smoo/lmao!n/wasm-mem.trace-root
+
 // =============================================================================
 // WASM Buffer Detection
 // =============================================================================
@@ -313,3 +316,4 @@ export function createWasmTraceRootFactory(allocator: WasmAllocator) {
     return new WasmTraceRoot(allocator, createTraceId(trace_id), tracer);
   };
 }
+//#endregion smoo/lmao!n/wasm-mem.trace-root

package/src/node.ts

@@ -7,4 +7,6 @@
 export * from './index.js';
 
 // Export Node.js-specific TraceRoot factory for Tracer construction
+//#region smoo/lmao!n/trace-root-timestamps.entry-points #node
 export { createTraceRoot } from './lib/traceRoot.node.js';
+//#endregion smoo/lmao!n/trace-root-timestamps.entry-points