@gadgetinc/substrate 0.1.0-rc.1

package/dist/node/zlib.d.ts

@@ -0,0 +1,328 @@
+/**
+ * Node.js zlib module implementation for Substrate
+ *
+ * Uses fflate for compression/decompression with proper streaming support.
+ *
+ * Key insight: Node.js zlib streams process data incrementally via Transform
+ * streams. fflate provides streaming classes (Gunzip, Inflate, etc.) with
+ * push(chunk, final) that handle incremental data properly.
+ */
+import { Buffer } from "./buffer.js";
+import { Transform } from "./stream.js";
+export declare const constants: {
+    Z_NO_FLUSH: number;
+    Z_PARTIAL_FLUSH: number;
+    Z_SYNC_FLUSH: number;
+    Z_FULL_FLUSH: number;
+    Z_FINISH: number;
+    Z_BLOCK: number;
+    Z_TREES: number;
+    Z_OK: number;
+    Z_STREAM_END: number;
+    Z_NEED_DICT: number;
+    Z_ERRNO: number;
+    Z_STREAM_ERROR: number;
+    Z_DATA_ERROR: number;
+    Z_MEM_ERROR: number;
+    Z_BUF_ERROR: number;
+    Z_VERSION_ERROR: number;
+    Z_NO_COMPRESSION: number;
+    Z_BEST_SPEED: number;
+    Z_BEST_COMPRESSION: number;
+    Z_DEFAULT_COMPRESSION: number;
+    Z_FILTERED: number;
+    Z_HUFFMAN_ONLY: number;
+    Z_RLE: number;
+    Z_FIXED: number;
+    Z_DEFAULT_STRATEGY: number;
+    DEFLATE: number;
+    INFLATE: number;
+    GZIP: number;
+    GUNZIP: number;
+    DEFLATERAW: number;
+    INFLATERAW: number;
+    UNZIP: number;
+    BROTLI_DECODE: number;
+    BROTLI_ENCODE: number;
+    Z_MIN_WINDOWBITS: number;
+    Z_MAX_WINDOWBITS: number;
+    Z_DEFAULT_WINDOWBITS: number;
+    Z_MIN_CHUNK: number;
+    Z_MAX_CHUNK: number;
+    Z_DEFAULT_CHUNK: number;
+    Z_MIN_MEMLEVEL: number;
+    Z_MAX_MEMLEVEL: number;
+    Z_DEFAULT_MEMLEVEL: number;
+    Z_MIN_LEVEL: number;
+    Z_MAX_LEVEL: number;
+    Z_DEFAULT_LEVEL: number;
+};
+export interface ZlibOptions {
+    level?: number;
+    windowBits?: number;
+    memLevel?: number;
+    strategy?: number;
+    dictionary?: Buffer | Uint8Array;
+    flush?: number;
+    finishFlush?: number;
+    chunkSize?: number;
+    info?: boolean;
+}
+export declare function deflateSync(buf: Buffer | Uint8Array | string, options?: ZlibOptions): Buffer;
+export declare function inflateSync(buf: Buffer | Uint8Array, _options?: ZlibOptions): Buffer;
+export declare function gzipSync(buf: Buffer | Uint8Array | string, options?: ZlibOptions): Buffer;
+export declare function gunzipSync(buf: Buffer | Uint8Array, _options?: ZlibOptions): Buffer;
+export declare function deflateRawSync(buf: Buffer | Uint8Array | string, options?: ZlibOptions): Buffer;
+export declare function inflateRawSync(buf: Buffer | Uint8Array, _options?: ZlibOptions): Buffer;
+export declare function unzipSync(buf: Buffer | Uint8Array, _options?: ZlibOptions): Buffer;
+type ZlibCallback = (error: Error | null, result?: Buffer) => void;
+export declare function deflate(buf: Buffer | Uint8Array | string, optionsOrCallback: ZlibOptions | ZlibCallback, callback?: ZlibCallback): void;
+export declare function inflate(buf: Buffer | Uint8Array, optionsOrCallback: ZlibOptions | ZlibCallback, callback?: ZlibCallback): void;
+export declare function gzip(buf: Buffer | Uint8Array | string, optionsOrCallback: ZlibOptions | ZlibCallback, callback?: ZlibCallback): void;
+export declare function gunzip(buf: Buffer | Uint8Array, optionsOrCallback: ZlibOptions | ZlibCallback, callback?: ZlibCallback): void;
+export declare function deflateRaw(buf: Buffer | Uint8Array | string, optionsOrCallback: ZlibOptions | ZlibCallback, callback?: ZlibCallback): void;
+export declare function inflateRaw(buf: Buffer | Uint8Array, optionsOrCallback: ZlibOptions | ZlibCallback, callback?: ZlibCallback): void;
+export declare function unzip(buf: Buffer | Uint8Array, optionsOrCallback: ZlibOptions | ZlibCallback, callback?: ZlibCallback): void;
+export declare function brotliCompressSync(): Buffer;
+export declare function brotliDecompressSync(): Buffer;
+export declare function brotliCompress(): void;
+export declare function brotliDecompress(): void;
+/**
+ * Mock native handle that minizlib expects.
+ * minizlib accesses this._handle and calls methods on it.
+ *
+ * Key method: _processChunk(chunk, flushFlag) - minizlib calls this directly
+ * to perform synchronous compression/decompression.
+ */
+declare class NativeZlibHandle {
+    private _parent;
+    private _closed;
+    constructor(parent: ZlibTransform);
+    close(): void;
+    reset(): void;
+    /**
+     * Process a chunk synchronously - this is what minizlib calls directly.
+     * Returns an array of result buffers (can be multiple chunks).
+     */
+    _processChunk(chunk: Buffer | Uint8Array, flushFlag: number): Buffer[] | undefined;
+}
+interface FflateStreamingCompressor {
+    push(chunk: Uint8Array, final?: boolean): void;
+    flush?(): void;
+    ondata: (data: Uint8Array, final: boolean) => void;
+}
+interface FflateStreamingDecompressor {
+    push(chunk: Uint8Array, final?: boolean): void;
+    ondata: (data: Uint8Array, final: boolean) => void;
+}
+/**
+ * Base class for zlib transform streams using fflate's streaming API.
+ *
+ * This properly handles incremental data by using fflate's streaming classes
+ * (Gunzip, Inflate, etc.) which have a push(chunk, final) method and ondata callback.
+ */
+declare abstract class ZlibTransform extends Transform {
+    protected _zlibOptions: ZlibOptions;
+    protected _closed: boolean;
+    protected _finished: boolean;
+    protected _errorEmitted: boolean;
+    _handle: NativeZlibHandle;
+    _outBuffer: Buffer;
+    protected _fflateStream: FflateStreamingCompressor | FflateStreamingDecompressor | null;
+    constructor(options?: ZlibOptions);
+    /**
+     * Initialize the fflate streaming instance. Override in subclasses.
+     */
+    protected abstract _initFflateStream(): void;
+    _transform(chunk: Buffer | Uint8Array, _encoding: string, callback: (error?: Error | null, data?: Buffer) => void): void;
+    _flush(callback: (error?: Error | null, data?: Buffer) => void): void;
+    protected _emitError(err: Error, callback?: (error: Error) => void): void;
+    /**
+     * Collected output chunks from fflate (used by _processChunkInternal)
+     */
+    protected _pendingOutput: Buffer[];
+    /**
+     * Handle data from fflate ondata callback
+     */
+    protected _onFflateData: (data: Uint8Array<ArrayBufferLike>, _final: boolean) => void;
+    /**
+     * Process a chunk synchronously - minizlib calls this directly on the stream.
+     * This is THE key method that minizlib uses for synchronous processing.
+     *
+     * minizlib does: result = this.#handle._processChunk(chunk, flushFlag)
+     * where this.#handle is the zlib stream instance itself.
+     */
+    _processChunk(chunk: Buffer | Uint8Array, flushFlag: number): Buffer[] | undefined;
+    /**
+     * Internal implementation of chunk processing.
+     */
+    _processChunkInternal(chunk: Buffer | Uint8Array, flushFlag: number): Buffer[] | undefined;
+    write(chunk: unknown, encodingOrFlush?: BufferEncoding | number | ((error: Error | null | undefined) => void), callback?: (error: Error | null | undefined) => void): boolean;
+    close(callback?: () => void): void;
+    params(_level: number, _strategy: number, callback?: () => void): void;
+    reset(): void;
+    flush(kind?: number | (() => void), callback?: () => void): void;
+}
+declare class DeflateImpl extends ZlibTransform {
+    protected _initFflateStream(): void;
+}
+declare class InflateImpl extends ZlibTransform {
+    protected _initFflateStream(): void;
+}
+declare class GzipImpl extends ZlibTransform {
+    protected _initFflateStream(): void;
+}
+declare class GunzipImpl extends ZlibTransform {
+    protected _initFflateStream(): void;
+}
+declare class DeflateRawImpl extends ZlibTransform {
+    protected _initFflateStream(): void;
+}
+declare class InflateRawImpl extends ZlibTransform {
+    protected _initFflateStream(): void;
+}
+/**
+ * Unzip auto-detects gzip vs zlib format.
+ * We check the first bytes to determine which decompressor to use.
+ */
+declare class UnzipImpl extends ZlibTransform {
+    private _headerBytes;
+    private _detectedFormat;
+    protected _initFflateStream(): void;
+    private _detectAndInit;
+    _transform(chunk: Buffer | Uint8Array, _encoding: string, callback: (error?: Error | null, data?: Buffer) => void): void;
+    _flush(callback: (error?: Error | null, data?: Buffer) => void): void;
+    /**
+     * Override _processChunkInternal for Unzip to handle format detection
+     */
+    _processChunkInternal(chunk: Buffer | Uint8Array, flushFlag: number): Buffer[] | undefined;
+    write(chunk: unknown, encodingOrFlush?: BufferEncoding | number | ((error: Error | null | undefined) => void), callback?: (error: Error | null | undefined) => void): boolean;
+}
+declare class BrotliCompressImpl extends ZlibTransform {
+    protected _initFflateStream(): void;
+    _transform(_chunk: Buffer | Uint8Array, _encoding: string, callback: (error?: Error | null) => void): void;
+}
+declare class BrotliDecompressImpl extends ZlibTransform {
+    protected _initFflateStream(): void;
+    _transform(_chunk: Buffer | Uint8Array, _encoding: string, callback: (error?: Error | null) => void): void;
+}
+type ZlibClass<T extends ZlibTransform> = {
+    new (options?: ZlibOptions): T;
+    (options?: ZlibOptions): T;
+    prototype: T;
+};
+export declare const Deflate: ZlibClass<DeflateImpl>;
+export declare const Inflate: ZlibClass<InflateImpl>;
+export declare const Gzip: ZlibClass<GzipImpl>;
+export declare const Gunzip: ZlibClass<GunzipImpl>;
+export declare const DeflateRaw: ZlibClass<DeflateRawImpl>;
+export declare const InflateRaw: ZlibClass<InflateRawImpl>;
+export declare const Unzip: ZlibClass<UnzipImpl>;
+export declare const BrotliCompress: ZlibClass<BrotliCompressImpl>;
+export declare const BrotliDecompress: ZlibClass<BrotliDecompressImpl>;
+export type Deflate = DeflateImpl;
+export type Inflate = InflateImpl;
+export type Gzip = GzipImpl;
+export type Gunzip = GunzipImpl;
+export type DeflateRaw = DeflateRawImpl;
+export type InflateRaw = InflateRawImpl;
+export type Unzip = UnzipImpl;
+export type BrotliCompress = BrotliCompressImpl;
+export type BrotliDecompress = BrotliDecompressImpl;
+export declare function createDeflate(options?: ZlibOptions): Deflate;
+export declare function createInflate(options?: ZlibOptions): Inflate;
+export declare function createGzip(options?: ZlibOptions): Gzip;
+export declare function createGunzip(options?: ZlibOptions): Gunzip;
+export declare function createDeflateRaw(options?: ZlibOptions): DeflateRaw;
+export declare function createInflateRaw(options?: ZlibOptions): InflateRaw;
+export declare function createUnzip(options?: ZlibOptions): Unzip;
+export declare function createBrotliCompress(): BrotliCompress;
+export declare function createBrotliDecompress(): BrotliDecompress;
+declare const _default: {
+    constants: {
+        Z_NO_FLUSH: number;
+        Z_PARTIAL_FLUSH: number;
+        Z_SYNC_FLUSH: number;
+        Z_FULL_FLUSH: number;
+        Z_FINISH: number;
+        Z_BLOCK: number;
+        Z_TREES: number;
+        Z_OK: number;
+        Z_STREAM_END: number;
+        Z_NEED_DICT: number;
+        Z_ERRNO: number;
+        Z_STREAM_ERROR: number;
+        Z_DATA_ERROR: number;
+        Z_MEM_ERROR: number;
+        Z_BUF_ERROR: number;
+        Z_VERSION_ERROR: number;
+        Z_NO_COMPRESSION: number;
+        Z_BEST_SPEED: number;
+        Z_BEST_COMPRESSION: number;
+        Z_DEFAULT_COMPRESSION: number;
+        Z_FILTERED: number;
+        Z_HUFFMAN_ONLY: number;
+        Z_RLE: number;
+        Z_FIXED: number;
+        Z_DEFAULT_STRATEGY: number;
+        DEFLATE: number;
+        INFLATE: number;
+        GZIP: number;
+        GUNZIP: number;
+        DEFLATERAW: number;
+        INFLATERAW: number;
+        UNZIP: number;
+        BROTLI_DECODE: number;
+        BROTLI_ENCODE: number;
+        Z_MIN_WINDOWBITS: number;
+        Z_MAX_WINDOWBITS: number;
+        Z_DEFAULT_WINDOWBITS: number;
+        Z_MIN_CHUNK: number;
+        Z_MAX_CHUNK: number;
+        Z_DEFAULT_CHUNK: number;
+        Z_MIN_MEMLEVEL: number;
+        Z_MAX_MEMLEVEL: number;
+        Z_DEFAULT_MEMLEVEL: number;
+        Z_MIN_LEVEL: number;
+        Z_MAX_LEVEL: number;
+        Z_DEFAULT_LEVEL: number;
+    };
+    deflate: typeof deflate;
+    deflateSync: typeof deflateSync;
+    inflate: typeof inflate;
+    inflateSync: typeof inflateSync;
+    gzip: typeof gzip;
+    gzipSync: typeof gzipSync;
+    gunzip: typeof gunzip;
+    gunzipSync: typeof gunzipSync;
+    deflateRaw: typeof deflateRaw;
+    deflateRawSync: typeof deflateRawSync;
+    inflateRaw: typeof inflateRaw;
+    inflateRawSync: typeof inflateRawSync;
+    unzip: typeof unzip;
+    unzipSync: typeof unzipSync;
+    brotliCompress: typeof brotliCompress;
+    brotliCompressSync: typeof brotliCompressSync;
+    brotliDecompress: typeof brotliDecompress;
+    brotliDecompressSync: typeof brotliDecompressSync;
+    Deflate: ZlibClass<DeflateImpl>;
+    Inflate: ZlibClass<InflateImpl>;
+    Gzip: ZlibClass<GzipImpl>;
+    Gunzip: ZlibClass<GunzipImpl>;
+    DeflateRaw: ZlibClass<DeflateRawImpl>;
+    InflateRaw: ZlibClass<InflateRawImpl>;
+    Unzip: ZlibClass<UnzipImpl>;
+    BrotliCompress: ZlibClass<BrotliCompressImpl>;
+    BrotliDecompress: ZlibClass<BrotliDecompressImpl>;
+    createDeflate: typeof createDeflate;
+    createInflate: typeof createInflate;
+    createGzip: typeof createGzip;
+    createGunzip: typeof createGunzip;
+    createDeflateRaw: typeof createDeflateRaw;
+    createInflateRaw: typeof createInflateRaw;
+    createUnzip: typeof createUnzip;
+    createBrotliCompress: typeof createBrotliCompress;
+    createBrotliDecompress: typeof createBrotliDecompress;
+};
+export default _default;
+//# sourceMappingURL=zlib.d.ts.map

package/dist/node/zlib.d.ts.map

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

package/dist/persistence/opfs-store.d.ts

@@ -0,0 +1,93 @@
+/**
+ * OPFS Persistence Store
+ *
+ * Primary storage for all file data. The WASM kernel never stores file bytes
+ * in linear memory — every read/write goes through host imports backed by this store.
+ *
+ * Uses FileSystemSyncAccessHandle for synchronous I/O in Workers.
+ * New inodes are buffered in JS memory until flushPending() creates OPFS handles.
+ *
+ * OPFS layout:
+ *   opfs-root/substrate-stores/{name}/
+ *     .meta      — msgpack VFS metadata snapshot
+ *     inodes/
+ *       1, 2, …  — one file per inode
+ */
+export declare class OpfsStore {
+    private rootDir;
+    private inodesDir;
+    private metaHandle;
+    private inodeHandles;
+    private pendingInodes;
+    private pendingDeletes;
+    private getMemory;
+    private constructor();
+    /**
+     * Open or create an OPFS store. Pre-opens sync access handles for all existing
+     * inode files and the metadata file.
+     *
+     * @param name - Store name (used as OPFS directory name)
+     * @param getMemory - Lazy getter for the WASM Memory object (must be valid at call time, not capture time)
+     */
+    static create(name: string, getMemory: () => WebAssembly.Memory): Promise<OpfsStore>;
+    /**
+     * Read `count` bytes from inode at `offset` into WASM memory at `bufPtr`.
+     * @returns bytes read (>= 0), or -1 if inode not found
+     */
+    readFile(inode: number, offset: number, bufPtr: number, count: number): number;
+    /**
+     * Write `count` bytes from WASM memory at `bufPtr` to inode at `offset`.
+     * @returns bytes written (>= 0), or -1 if inode not found
+     */
+    writeFile(inode: number, offset: number, bufPtr: number, count: number): number;
+    /**
+     * Set file size. If smaller, truncates. If larger, extends with zeros.
+     * @returns 0 on success, -1 if inode not found
+     */
+    truncateFile(inode: number, size: number): number;
+    /**
+     * Get file size in bytes.
+     * @returns size (>= 0), or -1 if inode not found
+     */
+    fileSize(inode: number): number;
+    /**
+     * Create a new file backing for an inode.
+     * Buffered in memory until flushPending() creates the OPFS handle.
+     * @returns 0 on success
+     */
+    createFile(inode: number): number;
+    /**
+     * Delete file backing for an inode.
+     * Closes the sync handle and queues for async removal.
+     * @returns 0 on success
+     */
+    deleteFile(inode: number): number;
+    /**
+     * Read VFS metadata snapshot into WASM memory at bufPtr.
+     * @returns bytes read, or -1 if no metadata exists (empty store)
+     */
+    readMetadata(bufPtr: number, bufCap: number): number;
+    /**
+     * Write VFS metadata snapshot from WASM memory at bufPtr.
+     * @returns 0 on success
+     */
+    writeMetadata(bufPtr: number, bufLen: number): number;
+    /**
+     * Materialize pending inodes to OPFS and process pending deletes.
+     * Creates OPFS file handles for new inodes that were buffered in memory.
+     */
+    flushPending(): Promise<void>;
+    /**
+     * Close all sync access handles. Call on shutdown.
+     */
+    close(): Promise<void>;
+    /**
+     * List all available store names.
+     */
+    static list(): Promise<string[]>;
+    /**
+     * Delete a store and all its data.
+     */
+    static delete(name: string): Promise<void>;
+}
+//# sourceMappingURL=opfs-store.d.ts.map

package/dist/persistence/opfs-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opfs-store.d.ts","sourceRoot":"","sources":["../../src/persistence/opfs-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoBH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,SAAS,CAA2B;IAE5C,OAAO,eAcN;IAED;;;;;;OAMG;IACH,OAAa,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA2BzF;IAMD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAqB7E;IAED;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAwB9E;IAED;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBhD;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS9B;IAED;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAahC;IAED;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAahC;IAED;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CASnD;IAED;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQpD;IAMD;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAiClC;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ3B;IAED;;OAEG;IACH,OAAa,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAcrC;IAED;;OAEG;IACH,OAAa,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/C;CACF"}

package/dist/runtime/async-function-shim.d.ts

@@ -0,0 +1,27 @@
+/**
+ * AsyncFunction Shim
+ *
+ * Creates a patched Function constructor that supports `await` in dynamically
+ * created function bodies. This is needed because Substrate's async transform
+ * converts `async function(){}` to generator wrappers, which means:
+ *
+ *   const AsyncFunction = async function(){}.constructor;
+ *
+ * ...yields `Function` instead of `AsyncFunction`. Code like Vite's module
+ * runner that does `new AsyncFunction(code_with_await)` would fail with
+ * "await is only valid in async functions".
+ *
+ * The patched Function is installed as a process global (via _globals in
+ * ProcessEventLoop), so it only applies inside guest code running through
+ * runWithGlobals — not on the browser's global scope.
+ */
+/**
+ * Create a patched Function constructor that handles `await` in the body.
+ *
+ * When code contains `await` (which would always fail in a regular Function),
+ * we apply the async transform to make it work through SubstratePromise.
+ *
+ * Returns the patched Function to be installed as a process global.
+ */
+export declare function createPatchedFunction(): typeof Function;
+//# sourceMappingURL=async-function-shim.d.ts.map

package/dist/runtime/async-function-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-function-shim.d.ts","sourceRoot":"","sources":["../../src/runtime/async-function-shim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAmCH;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,QAAQ,CAkCvD"}

package/dist/runtime/fs-interface.d.ts

@@ -0,0 +1,60 @@
+import type { DirEntry, StatResult } from "../kernel/types.js";
+/**
+ * Hook called when a file is written that might be a native binding package.
+ * Set by the WASM package interceptor to enable detection.
+ */
+type NativeBindingHook = (path: string) => void;
+/**
+ * Set the hook for detecting native binding writes.
+ * Called by the WASM package interceptor during initialization.
+ */
+export declare function setNativeBindingWriteHook(hook: NativeBindingHook | null): void;
+/** Enable VFS tracking (call this from within the worker) */
+export declare function enableVfsTracking(): void;
+/** Disable VFS tracking */
+export declare function disableVfsTracking(): void;
+/** Track a VFS write and log if tracking is enabled */
+export declare function trackVfsWrite(path: string, size: number): void;
+/** Get VFS tracking stats */
+export declare function getVfsStats(): {
+    totalBytesWritten: number;
+    largeFiles: Array<{
+        path: string;
+        size: number;
+    }>;
+};
+/** Reset VFS tracking stats */
+export declare function resetVfsStats(): void;
+export declare function readFile(path: string): Uint8Array;
+export declare function writeFile(path: string, bytes: Uint8Array, mode?: number): void;
+export declare function writeAt(path: string, bytes: Uint8Array, offset: number): number;
+export declare function appendFile(path: string, bytes: Uint8Array): number;
+export declare function stat(path: string): StatResult;
+export declare function lstat(path: string): StatResult;
+export declare function exists(path: string): boolean;
+export declare function access(path: string, mode?: number): void;
+export declare function readdir(path: string): DirEntry[];
+export declare function mkdir(path: string, recursive: boolean, mode?: number): void;
+export declare function chmod(path: string, mode: number): void;
+export declare function fchmod(pid: number, fd: number, mode: number): void;
+export declare function unlink(path: string): void;
+export declare function rename(oldPath: string, newPath: string): void;
+export declare function link(existingPath: string, newPath: string): void;
+export declare function symlink(target: string, path: string): void;
+export declare function readlink(path: string): string;
+export declare function realpath(path: string): string;
+export declare function open(pid: number, path: string, flags: string, mode?: number): number;
+export declare function close(pid: number, fd: number): void;
+export declare function read(pid: number, fd: number, length: number, position: number | null): {
+    bytes: Uint8Array;
+    bytes_read: number;
+    eof?: boolean;
+};
+export declare function write(pid: number, fd: number, bytes: Uint8Array, position: number | null): number;
+export declare function truncate(pid: number, fd: number, size: number): void;
+export declare function fstat(pid: number, fd: number): StatResult;
+export declare function watch(path: string, recursive: boolean, eqId?: number): number;
+export declare function unwatch(pid: number, watchId: number): void;
+export declare function fsync(pid: number, fd: number): void;
+export {};
+//# sourceMappingURL=fs-interface.d.ts.map

package/dist/runtime/fs-interface.d.ts.map

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

package/dist/runtime/index.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Substrate Runtime
+ *
+ * Orchestrates kernel initialization and Node compatibility setup.
+ */
+import type { KernelBridge, KernelResponse, KernelResponseFor, SyscallArgs, SyscallOp, KernelConfig } from "../kernel/types.js";
+import { ProcessManager } from "./process-manager.js";
+import type { ProcessContext } from "./process-context.js";
+import type { BinaryName, BinarySpec } from "../binaries.js";
+import { type WasmPackageMapping } from "./wasm-package-interceptor.js";
+/**
+ * Interface for the kernel WASM glue exports.
+ */
+interface KernelWasmExports {
+    kernel_init(config_bytes: Uint8Array): Uint8Array;
+    kernel_syscall(req_bytes: Uint8Array): Uint8Array;
+    kernel_deliver(msg_bytes: Uint8Array): Uint8Array;
+}
+/**
+ * Get the current WASM memory usage in bytes.
+ * Returns null if WASM is not initialized.
+ */
+export declare function getWasmMemorySize(): number | null;
+/**
+ * Get formatted WASM memory usage string.
+ */
+export declare function getWasmMemoryInfo(): string;
+/**
+ * Wraps the kernel WASM and provides a MessagePack-based interface.
+ */
+export declare class SubstrateKernel implements KernelBridge {
+    private exports;
+    constructor(exports: KernelWasmExports);
+    /**
+     * Initialize the kernel with configuration.
+     */
+    init(config?: KernelConfig): KernelResponse<{
+        initialized: boolean;
+    }>;
+    syscall<Op extends SyscallOp>(op: Op, args?: SyscallArgs<Op>): KernelResponseFor<Op>;
+    deliver(msg: Record<string, unknown>): KernelResponse<{
+        delivered: boolean;
+    }>;
+    private parseResponse;
+}
+export interface SubstrateOptions {
+    /** URL to fetch the kernel WASM from */
+    kernel: string;
+    /** Initial working directory */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Command-line arguments */
+    argv?: string[];
+    /** Kernel configuration */
+    config?: KernelConfig;
+    /** Install Node globals on globalThis (default: true) */
+    installGlobals?: boolean;
+    /** Binaries to install */
+    binaries?: Partial<Record<BinaryName, BinarySpec>>;
+    /** Custom WASM package mappings */
+    wasmPackages?: WasmPackageMapping[];
+}
+export interface SubstrateRuntime {
+    /** The kernel bridge */
+    kernel: SubstrateKernel;
+    /** Process manager - owns all process contexts */
+    processManager: ProcessManager;
+    /** Root process context (PID 1) */
+    rootProcess: ProcessContext;
+    /** Deliver a message to the kernel */
+    deliver(msg: Record<string, unknown>): boolean;
+    /** Shutdown the runtime */
+    shutdown(): void;
+}
+/**
+ * Create and initialize a Substrate runtime.
+ *
+ * @example
+ * ```ts
+ * import { createSubstrate, fs } from "@gadgetinc/substrate";
+ *
+ * // In production - load from CDN
+ * const runtime = await createSubstrate({
+ *   kernel: "https://assets.gadget.dev/kernel.wasm?v=0.1.0",
+ *   cwd: "/home/user",
+ *   env: { NODE_ENV: "production" },
+ * });
+ *
+ * // In development - load from local dev server
+ * const runtime = await createSubstrate({
+ *   kernel: "/kernel.wasm",
+ *   cwd: "/home/user",
+ * });
+ *
+ * fs.writeFileSync("/test.txt", "hello");
+ * ```
+ */
+export declare function createSubstrate(options: SubstrateOptions): Promise<SubstrateRuntime>;
+/**
+ * Ensure the es-module-lexer WASM is initialized.
+ * Can be called multiple times safely - will only initialize once.
+ */
+export declare function ensureLexerInit(): Promise<void>;
+/**
+ * Register all Node.js builtin modules and WASM package interceptor.
+ * Exported for use by test helpers.
+ */
+export declare function registerBuiltins(wasmPackages?: WasmPackageMapping[]): void;
+export { ProcessManager } from "./process-manager.js";
+export type { ProcessContext, ProcessCreateOptions } from "./process-context.js";
+export type { EventHandler as ProcessEventHandler, EventType as ProcessEventType, } from "./process-event-loop.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

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