@vune-ui/execution 0.1.20

package/dist/resident-worker.d.ts

@@ -0,0 +1,145 @@
+import { ExecutionTelemetry, FrameBudgetSignal, type ExecutionAggregate } from "./index.js";
+import { type ResidentNativeDecisionReason, type ResidentWasmBinding, type ResidentWasmExecutionOptions, type ResidentWasmVariant } from "./resident-wasm.js";
+export interface ResidentWorkerLike {
+    postMessage(message: unknown): void;
+    addEventListener?(type: "message" | "error", listener: (event: unknown) => void): void;
+    removeEventListener?(type: "message" | "error", listener: (event: unknown) => void): void;
+    on?(type: "message" | "error", listener: (value: unknown) => void): void;
+    off?(type: "message" | "error", listener: (value: unknown) => void): void;
+    terminate?(): void | Promise<number>;
+}
+export type ResidentWorkerFactory = (binding: ResidentWasmBinding) => ResidentWorkerLike | Promise<ResidentWorkerLike>;
+export interface ResidentWorkerInitMessage {
+    readonly type: "init";
+    readonly memory: WebAssembly.Memory;
+    readonly variant: ResidentWasmVariant;
+    readonly programPointer: number;
+    readonly programWords: number;
+    readonly columnPointersPointer: number;
+    readonly columnCount: number;
+    readonly rangesPointer: number;
+    readonly capturesPointer: number;
+    readonly captureCount: number;
+    readonly controlPointer: number;
+    readonly directSimdModuleBytes?: Uint8Array;
+    readonly directSimdEntrypoint?: "resident_execute_direct_simd";
+}
+export type ResidentWorkerControlMessage = Readonly<{
+    type: "ready";
+    variant: ResidentWasmVariant;
+}> | Readonly<{
+    type: "done";
+    sequence: number;
+}> | Readonly<{
+    type: "error";
+    message: string;
+    sequence?: number;
+}> | Readonly<{
+    type: "stopped";
+}>;
+export interface ResidentWorkerExecutionMetrics {
+    readonly backend: "shared-worker-wasm";
+    readonly computeMs: number;
+    readonly transferBytes: 0;
+    readonly transferMs: 0;
+    readonly materializationBytes: 0;
+    readonly materializationMs: 0;
+    readonly readbackBytes: 0;
+    readonly readbackMs: 0;
+    readonly synchronizationBytes: number;
+    readonly synchronizationMs: number;
+    readonly totalMs: number;
+    readonly wasmCalls: 1;
+    readonly sequence: number;
+}
+/** Deterministic URL of the Worker entry copied into the published package. */
+export declare function residentWorkerAssetUrl(): string;
+/** Reject row-bearing messages at the thread boundary. */
+export declare function validateResidentWorkerControlMessage(value: unknown): asserts value is ResidentWorkerControlMessage;
+/** One shared-memory worker. Requests are atomic sequence changes, not row messages. */
+export declare class ResidentSharedWorkerExecutor {
+    #private;
+    readonly binding: ResidentWasmBinding;
+    readonly worker: ResidentWorkerLike;
+    constructor(binding: ResidentWasmBinding, worker: ResidentWorkerLike);
+    execute(options?: ResidentWasmExecutionOptions): Promise<ResidentWorkerExecutionMetrics>;
+    close(): Promise<void>;
+}
+export interface ResidentSharedWorkerPoolSnapshot {
+    readonly size: number;
+    readonly maxWorkers: number;
+    readonly queuedJobs: number;
+    readonly activeBindings: number;
+    readonly createdWorkers: number;
+    readonly evictedWorkers: number;
+}
+/**
+ * Bound the number of persistent shared-memory resident Workers. A hot binding
+ * retains its initialized Worker and authoritative memory; cold idle bindings
+ * are evicted LRU when a new region needs capacity. Jobs for the same binding
+ * are serialized while different pool entries may execute concurrently.
+ *
+ * The pool intentionally does not choose Worker execution itself. Callers must
+ * still use `ResidentSharedWorkerPromotion`, which requires measured frame
+ * pressure and an end-to-end win over packed JavaScript.
+ */
+export declare class ResidentSharedWorkerPool {
+    #private;
+    readonly maxWorkers: number;
+    readonly workerFactory: ResidentWorkerFactory;
+    constructor(options: Readonly<{
+        workerFactory: ResidentWorkerFactory;
+        maxWorkers?: number;
+    }>);
+    execute(binding: ResidentWasmBinding, options?: ResidentWasmExecutionOptions): Promise<ResidentWorkerExecutionMetrics>;
+    snapshot(): ResidentSharedWorkerPoolSnapshot;
+    close(): Promise<void>;
+}
+export interface ResidentWorkerPromotionSnapshot {
+    readonly decision: "benchmarking" | "worker" | "packed-js";
+    readonly reason: ResidentNativeDecisionReason;
+    readonly baseline: ExecutionAggregate | null;
+    readonly candidate: ExecutionAggregate | null;
+    readonly measuredRatio: number | null;
+    readonly framePressure: number;
+    readonly frameSamples: number;
+    readonly executions: number;
+    readonly transferBytes: 0;
+    readonly materializationBytes: 0;
+    readonly readbackBytes: 0;
+    readonly synchronizationBytes: number;
+}
+/** Worker promotion requires both a measured win and live main-thread pressure. */
+export declare class ResidentSharedWorkerPromotion {
+    #private;
+    readonly executor: ResidentSharedWorkerExecutor;
+    readonly packedJs: () => void;
+    readonly frameBudget: FrameBudgetSignal;
+    readonly telemetry: ExecutionTelemetry;
+    readonly minimumSamples: number;
+    readonly minimumMargin: number;
+    readonly experimental: boolean;
+    constructor(options: Readonly<{
+        executor: ResidentSharedWorkerExecutor;
+        packedJs: () => void;
+        frameBudget: FrameBudgetSignal;
+        telemetry?: ExecutionTelemetry;
+        minimumSamples?: number;
+        minimumMargin?: number;
+        /** Explicit opt-in; omitted means this experimental backend is disabled. */
+        experimental?: boolean;
+    }>);
+    execute(options?: ResidentWasmExecutionOptions): Promise<"packed-js" | "shared-worker-wasm">;
+    snapshot(): ResidentWorkerPromotionSnapshot;
+}
+export declare const residentWorkerControlSlots: Readonly<{
+    requestSequence: 0;
+    doneSequence: 1;
+    status: 2;
+    stop: 3;
+    rangeCount: 4;
+    errorCode: 5;
+    computeMicros: 6;
+    wasmCalls: 7;
+}>;
+//# sourceMappingURL=resident-worker.d.ts.map

package/dist/resident-worker.d.ts.map

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

package/dist/resident-worker.js

@@ -0,0 +1,441 @@
+import { ExecutionTelemetry, FrameBudgetSignal, } from "./index.js";
+import { markResidentWasmRanges, prepareResidentWasmExecution, } from "./resident-wasm.js";
+const CONTROL_REQUEST_SEQUENCE = 0;
+const CONTROL_DONE_SEQUENCE = 1;
+const CONTROL_STATUS = 2;
+const CONTROL_STOP = 3;
+const CONTROL_RANGE_COUNT = 4;
+const CONTROL_ERROR_CODE = 5;
+const CONTROL_COMPUTE_MICROS = 6;
+const CONTROL_WASM_CALLS = 7;
+function now() {
+    const clock = globalThis.performance;
+    return clock?.now() ?? Date.now();
+}
+/** Deterministic URL of the Worker entry copied into the published package. */
+export function residentWorkerAssetUrl() {
+    const URLConstructor = globalThis.URL;
+    return new URLConstructor("./wasm/resident-worker.mjs", import.meta.url).href;
+}
+function messageData(value) {
+    if (typeof value === "object" && value !== null && "data" in value)
+        return value.data;
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+/** Reject row-bearing messages at the thread boundary. */
+export function validateResidentWorkerControlMessage(value) {
+    if (!isRecord(value) || typeof value.type !== "string")
+        throw new TypeError("worker-control-payload-invalid");
+    for (const forbidden of ["rows", "values", "buffers", "columns", "payload"]) {
+        if (forbidden in value)
+            throw new TypeError(`worker-control-payload-invalid: ${forbidden}`);
+    }
+    if (value.type === "ready") {
+        if (value.variant !== "simd" && value.variant !== "scalar")
+            throw new TypeError("worker-control-payload-invalid");
+        return;
+    }
+    if (value.type === "done") {
+        if (!Number.isSafeInteger(value.sequence))
+            throw new TypeError("worker-control-payload-invalid");
+        return;
+    }
+    if (value.type === "error") {
+        if (typeof value.message !== "string")
+            throw new TypeError("worker-control-payload-invalid");
+        return;
+    }
+    if (value.type !== "stopped")
+        throw new TypeError("worker-control-payload-invalid");
+}
+function initMessage(binding) {
+    return Object.freeze({
+        type: "init",
+        memory: binding.runtime.memory,
+        variant: binding.runtime.variant,
+        programPointer: binding.programPointer,
+        programWords: binding.program.words.length,
+        columnPointersPointer: binding.columnPointersPointer,
+        columnCount: binding.columnPointers.length,
+        rangesPointer: binding.rangesPointer,
+        capturesPointer: binding.capturesPointer,
+        captureCount: binding.program.captureNames.length,
+        controlPointer: binding.controlPointer,
+        ...(binding.program.directSharedSimdModuleBytes && binding.program.directSharedSimdEntrypoint ? {
+            directSimdModuleBytes: binding.program.directSharedSimdModuleBytes,
+            directSimdEntrypoint: binding.program.directSharedSimdEntrypoint,
+        } : {}),
+    });
+}
+function listen(worker, handler) {
+    const browserHandler = (event) => handler(messageData(event));
+    if (worker.addEventListener) {
+        worker.addEventListener("message", browserHandler);
+        return () => worker.removeEventListener?.("message", browserHandler);
+    }
+    if (worker.on) {
+        worker.on("message", handler);
+        return () => worker.off?.("message", handler);
+    }
+    throw new TypeError("resident Worker transport cannot receive control messages");
+}
+/** One shared-memory worker. Requests are atomic sequence changes, not row messages. */
+export class ResidentSharedWorkerExecutor {
+    binding;
+    worker;
+    #ready;
+    #readyResolve;
+    #readyReject;
+    #pending = new Map();
+    #removeListener;
+    #closed = false;
+    constructor(binding, worker) {
+        if (!binding.runtime.shared || binding.buffer.kind !== "shared-wasm")
+            throw new TypeError("shared-memory-unavailable");
+        this.binding = binding;
+        this.worker = worker;
+        this.#ready = new Promise((resolve, reject) => {
+            this.#readyResolve = resolve;
+            this.#readyReject = reject;
+        });
+        this.#removeListener = listen(worker, message => this.#handleMessage(message));
+        worker.postMessage(initMessage(binding));
+    }
+    #handleMessage(message) {
+        try {
+            validateResidentWorkerControlMessage(message);
+        }
+        catch (error) {
+            this.#readyReject(error);
+            for (const pending of this.#pending.values())
+                pending.reject(error);
+            this.#pending.clear();
+            return;
+        }
+        if (message.type === "ready") {
+            if (message.variant !== this.binding.runtime.variant)
+                this.#readyReject(new Error("worker WASM variant differs from the authoritative runtime"));
+            else
+                this.#readyResolve();
+            return;
+        }
+        if (message.type === "error") {
+            const error = new Error(message.message);
+            if (message.sequence !== undefined) {
+                this.#pending.get(message.sequence)?.reject(error);
+                this.#pending.delete(message.sequence);
+            }
+            else {
+                this.#readyReject(error);
+                for (const pending of this.#pending.values())
+                    pending.reject(error);
+                this.#pending.clear();
+            }
+            return;
+        }
+        if (message.type !== "done")
+            return;
+        const pending = this.#pending.get(message.sequence);
+        if (!pending)
+            return;
+        this.#pending.delete(message.sequence);
+        const result = Atomics.load(this.binding.control, CONTROL_ERROR_CODE);
+        if (result !== 0) {
+            pending.reject(new Error(`shared resident WASM execution failed (${result})`));
+            return;
+        }
+        markResidentWasmRanges(this.binding, pending.ranges);
+        const totalMs = now() - pending.started;
+        const computeMs = Atomics.load(this.binding.control, CONTROL_COMPUTE_MICROS) / 1000;
+        pending.resolve(Object.freeze({
+            backend: "shared-worker-wasm",
+            computeMs,
+            transferBytes: 0,
+            transferMs: 0,
+            materializationBytes: 0,
+            materializationMs: 0,
+            readbackBytes: 0,
+            readbackMs: 0,
+            synchronizationBytes: pending.synchronizationBytes,
+            synchronizationMs: Math.max(0, totalMs - computeMs),
+            totalMs,
+            wasmCalls: 1,
+            sequence: message.sequence,
+        }));
+    }
+    async execute(options = {}) {
+        if (this.#closed)
+            throw new Error("resident shared Worker is closed");
+        await this.#ready;
+        if (this.#pending.size !== 0)
+            throw new Error("resident shared Worker execution is already in flight");
+        const metadata = prepareResidentWasmExecution(this.binding, options);
+        const sequence = Atomics.load(this.binding.control, CONTROL_REQUEST_SEQUENCE) + 1;
+        Atomics.store(this.binding.control, CONTROL_RANGE_COUNT, metadata.rangeCount);
+        Atomics.store(this.binding.control, CONTROL_STATUS, 1);
+        Atomics.store(this.binding.control, CONTROL_ERROR_CODE, 0);
+        const started = now();
+        const result = new Promise((resolve, reject) => {
+            this.#pending.set(sequence, {
+                started,
+                synchronizationBytes: metadata.synchronizationBytes + 4,
+                ranges: Object.freeze((options.ranges ?? [{ start: 0, end: this.binding.length }]).map(range => Object.freeze({ ...range }))),
+                resolve,
+                reject,
+            });
+        });
+        Atomics.store(this.binding.control, CONTROL_REQUEST_SEQUENCE, sequence);
+        Atomics.notify(this.binding.control, CONTROL_REQUEST_SEQUENCE, 1);
+        return result;
+    }
+    async close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        Atomics.store(this.binding.control, CONTROL_STOP, 1);
+        Atomics.notify(this.binding.control, CONTROL_REQUEST_SEQUENCE, 1);
+        this.#removeListener();
+        await this.worker.terminate?.();
+        for (const pending of this.#pending.values())
+            pending.reject(new Error("resident shared Worker closed"));
+        this.#pending.clear();
+    }
+}
+/**
+ * Bound the number of persistent shared-memory resident Workers. A hot binding
+ * retains its initialized Worker and authoritative memory; cold idle bindings
+ * are evicted LRU when a new region needs capacity. Jobs for the same binding
+ * are serialized while different pool entries may execute concurrently.
+ *
+ * The pool intentionally does not choose Worker execution itself. Callers must
+ * still use `ResidentSharedWorkerPromotion`, which requires measured frame
+ * pressure and an end-to-end win over packed JavaScript.
+ */
+export class ResidentSharedWorkerPool {
+    maxWorkers;
+    workerFactory;
+    #entries = new Map();
+    #clock = 0;
+    #closed = false;
+    #createdWorkers = 0;
+    #evictedWorkers = 0;
+    #queuedJobs = 0;
+    #activeBindings = 0;
+    constructor(options) {
+        if (typeof options.workerFactory !== "function")
+            throw new TypeError("resident Worker pool requires a workerFactory");
+        const maxWorkers = Math.floor(options.maxWorkers ?? 2);
+        if (!Number.isSafeInteger(maxWorkers) || maxWorkers < 1 || maxWorkers > 16) {
+            throw new RangeError("resident Worker pool maxWorkers must be an integer in 1...16");
+        }
+        this.workerFactory = options.workerFactory;
+        this.maxWorkers = maxWorkers;
+    }
+    async #createEntry(binding) {
+        const worker = await this.workerFactory(binding);
+        this.#createdWorkers += 1;
+        return {
+            binding,
+            executor: new ResidentSharedWorkerExecutor(binding, worker),
+            tail: Promise.resolve(),
+            pending: 0,
+            lastUsed: ++this.#clock,
+            idle: Promise.resolve(),
+        };
+    }
+    #reserve(entry) {
+        if (entry.pending === 0) {
+            entry.idle = new Promise(resolve => { entry.resolveIdle = resolve; });
+            this.#activeBindings += 1;
+        }
+        entry.pending += 1;
+        this.#queuedJobs += 1;
+        entry.lastUsed = ++this.#clock;
+        return entry;
+    }
+    #release(entry) {
+        entry.pending = Math.max(0, entry.pending - 1);
+        this.#queuedJobs = Math.max(0, this.#queuedJobs - 1);
+        entry.lastUsed = ++this.#clock;
+        if (entry.pending === 0) {
+            this.#activeBindings = Math.max(0, this.#activeBindings - 1);
+            entry.resolveIdle?.();
+            entry.resolveIdle = undefined;
+        }
+    }
+    async #acquire(binding) {
+        if (this.#closed)
+            throw new Error("resident shared Worker pool is closed");
+        while (true) {
+            const existing = this.#entries.get(binding);
+            if (existing)
+                return this.#reserve(await existing);
+            if (this.#entries.size < this.maxWorkers) {
+                const pending = this.#createEntry(binding);
+                this.#entries.set(binding, pending);
+                try {
+                    return this.#reserve(await pending);
+                }
+                catch (error) {
+                    if (this.#entries.get(binding) === pending)
+                        this.#entries.delete(binding);
+                    throw error;
+                }
+            }
+            const entries = await Promise.all(this.#entries.values());
+            const idle = entries.filter(entry => entry.pending === 0).sort((left, right) => left.lastUsed - right.lastUsed)[0];
+            if (idle) {
+                const current = this.#entries.get(idle.binding);
+                if (current && await current === idle)
+                    this.#entries.delete(idle.binding);
+                await idle.executor.close();
+                this.#evictedWorkers += 1;
+                continue;
+            }
+            await Promise.race(entries.map(entry => entry.idle));
+        }
+    }
+    async execute(binding, options = {}) {
+        const entry = await this.#acquire(binding);
+        const run = entry.tail.then(() => entry.executor.execute(options));
+        entry.tail = run.then(() => undefined, () => undefined);
+        try {
+            return await run;
+        }
+        finally {
+            this.#release(entry);
+        }
+    }
+    snapshot() {
+        return Object.freeze({
+            size: this.#entries.size,
+            maxWorkers: this.maxWorkers,
+            queuedJobs: this.#queuedJobs,
+            activeBindings: this.#activeBindings,
+            createdWorkers: this.#createdWorkers,
+            evictedWorkers: this.#evictedWorkers,
+        });
+    }
+    async close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        const entries = await Promise.all(this.#entries.values());
+        this.#entries.clear();
+        await Promise.all(entries.map(async (entry) => {
+            await entry.tail;
+            await entry.executor.close();
+        }));
+    }
+}
+/** Worker promotion requires both a measured win and live main-thread pressure. */
+export class ResidentSharedWorkerPromotion {
+    executor;
+    packedJs;
+    frameBudget;
+    telemetry;
+    minimumSamples;
+    minimumMargin;
+    experimental;
+    #decision = "benchmarking";
+    #reason = "worker-frame-pressure-required";
+    #executions = 0;
+    #synchronizationBytes = 0;
+    constructor(options) {
+        if (typeof options.packedJs !== "function")
+            throw new TypeError("packed-js-baseline-required");
+        this.executor = options.executor;
+        this.packedJs = options.packedJs;
+        this.frameBudget = options.frameBudget;
+        this.telemetry = options.telemetry ?? new ExecutionTelemetry();
+        this.minimumSamples = Math.max(1, Math.floor(options.minimumSamples ?? 5));
+        this.minimumMargin = Math.min(0.9, Math.max(0, options.minimumMargin ?? 0.10));
+        this.experimental = options.experimental === true;
+        if (!this.experimental)
+            this.#reason = "experimental-disabled";
+    }
+    async execute(options = {}) {
+        this.#executions += 1;
+        if (!this.experimental)
+            return this.#runPackedJs(options);
+        const frame = this.frameBudget.snapshot();
+        if (frame.samples === 0 || frame.pressure < 1) {
+            this.#reason = "worker-frame-pressure-required";
+            return this.#runPackedJs(options);
+        }
+        if (this.#decision === "worker")
+            return this.#runWorker(options);
+        if (this.#decision === "packed-js")
+            return this.#runPackedJs(options);
+        const baseline = this.telemetry.recentPackedJsBaseline();
+        const candidate = this.telemetry.recentAggregate("shared-worker-wasm");
+        const backend = !baseline || (candidate !== null && baseline.samples <= candidate.samples)
+            ? this.#runPackedJs(options)
+            : await this.#runWorker(options);
+        this.#updateDecision();
+        return backend;
+    }
+    #runPackedJs(options) {
+        const started = now();
+        this.packedJs();
+        const elapsed = now() - started;
+        markResidentWasmRanges(this.executor.binding, options.ranges);
+        this.telemetry.record({ backend: "packed-js", computeMs: elapsed, totalMs: elapsed });
+        return "packed-js";
+    }
+    async #runWorker(options) {
+        const metrics = await this.executor.execute(options);
+        this.#synchronizationBytes += metrics.synchronizationBytes;
+        this.telemetry.record(metrics);
+        return "shared-worker-wasm";
+    }
+    #updateDecision() {
+        const baseline = this.telemetry.recentPackedJsBaseline();
+        const candidate = this.telemetry.recentAggregate("shared-worker-wasm");
+        if (!baseline || !candidate || baseline.samples < this.minimumSamples || candidate.samples < this.minimumSamples) {
+            this.#reason = "insufficient-measured-samples";
+            return;
+        }
+        const comparison = this.telemetry.compareRecentWithPackedJs("shared-worker-wasm");
+        if (comparison.wins && (comparison.ratio ?? Number.POSITIVE_INFINITY) <= 1 - this.minimumMargin) {
+            this.#decision = "worker";
+            this.#reason = "measured-win";
+        }
+        else {
+            this.#decision = "packed-js";
+            this.#reason = "no-measured-win";
+        }
+    }
+    snapshot() {
+        const frame = this.frameBudget.snapshot();
+        const comparison = this.telemetry.compareRecentWithPackedJs("shared-worker-wasm");
+        return Object.freeze({
+            decision: this.#decision,
+            reason: this.#reason,
+            baseline: this.telemetry.recentPackedJsBaseline(),
+            candidate: this.telemetry.recentAggregate("shared-worker-wasm"),
+            measuredRatio: comparison.ratio,
+            framePressure: frame.pressure,
+            frameSamples: frame.samples,
+            executions: this.#executions,
+            transferBytes: 0,
+            materializationBytes: 0,
+            readbackBytes: 0,
+            synchronizationBytes: this.#synchronizationBytes,
+        });
+    }
+}
+export const residentWorkerControlSlots = Object.freeze({
+    requestSequence: CONTROL_REQUEST_SEQUENCE,
+    doneSequence: CONTROL_DONE_SEQUENCE,
+    status: CONTROL_STATUS,
+    stop: CONTROL_STOP,
+    rangeCount: CONTROL_RANGE_COUNT,
+    errorCode: CONTROL_ERROR_CODE,
+    computeMicros: CONTROL_COMPUTE_MICROS,
+    wasmCalls: CONTROL_WASM_CALLS,
+});
+//# sourceMappingURL=resident-worker.js.map

package/dist/resident-worker.js.map

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