pca-web 0.1.0

package/dist/worker/handler.js

@@ -0,0 +1,404 @@
+/**
+ * Worker-side request handler: a multi-instance estimator registry with a
+ * strict global FIFO execution queue. Fits run through `fitAsync` — the
+ * yield points are what let abort messages (handled out-of-band, straight
+ * from the listener) take effect mid-fit; a synchronous fit would block the
+ * worker's queue and make cancellation impossible.
+ *
+ * The WebGPU backend is loaded through a cached dynamic import only when an
+ * estimator requests it, so CPU-only worker bundles stay lean.
+ */
+import { IncrementalPCA } from '../incremental-pca.js';
+import { PCA } from '../pca.js';
+import { isWorkerRequest, matrixToWire, modelTransferList, PCA_WORKER_PROTOCOL_VERSION, tightArray, toWireError, wireToMatrix, } from './protocol.js';
+let webgpuModulePromise = null;
+function webgpuModule() {
+    webgpuModulePromise ??= import('../webgpu/index.js').catch((err) => {
+        webgpuModulePromise = null;
+        throw new Error(`pca-web worker: failed to load the WebGPU backend (${String(err)}). ` +
+            'If this worker was bundled as a classic script (iife), dynamic import is unavailable — ' +
+            "configure the bundler to emit an ES-module worker (Vite: worker: { format: 'es' }) " +
+            "or create the estimator with backend: 'cpu'.");
+    });
+    return webgpuModulePromise;
+}
+function hasWebGPU() {
+    const nav = globalThis.navigator;
+    return typeof nav?.gpu === 'object' && nav.gpu !== null;
+}
+function progressToWire(e) {
+    const transfer = [];
+    const event = {
+        estimator: e.estimator,
+        solver: e.solver,
+        phase: e.phase,
+        step: e.step,
+        totalSteps: e.totalSteps,
+        fraction: e.fraction,
+    };
+    if (e.detail !== undefined) {
+        event.detail = e.detail;
+    }
+    if (e.snapshot !== undefined) {
+        // Snapshot arrays are fresh copies by the reporter contract — they
+        // double as the transfer list.
+        const snap = {
+            components: matrixToWire(e.snapshot.components),
+            singularValues: tightArray(e.snapshot.singularValues),
+            explainedVariance: tightArray(e.snapshot.explainedVariance),
+        };
+        transfer.push(snap.components.data.buffer, snap.singularValues.buffer, snap.explainedVariance.buffer);
+        if (e.snapshot.scores !== undefined) {
+            snap.scores = matrixToWire(e.snapshot.scores);
+            transfer.push(snap.scores.data.buffer);
+        }
+        event.snapshot = snap;
+    }
+    return { event, transfer };
+}
+/**
+ * Timer-less progress throttle: latest-wins coalescing within a phase,
+ * phase-boundary and finalize events always delivered, pending events
+ * dropped when the terminal result supersedes them.
+ */
+class ProgressThrottle {
+    post;
+    callId;
+    minIntervalMs;
+    pending = null;
+    lastPhase = null;
+    lastSentAt = Number.NEGATIVE_INFINITY;
+    seq = 0;
+    constructor(post, callId, minIntervalMs) {
+        this.post = post;
+        this.callId = callId;
+        this.minIntervalMs = minIntervalMs;
+    }
+    onProgress = (e) => {
+        const now = Date.now();
+        const boundary = this.lastPhase !== null && e.phase !== this.lastPhase;
+        this.lastPhase = e.phase;
+        if (boundary && this.pending !== null) {
+            // Deliver the previous phase's final coalesced event before moving on.
+            this.send(this.pending);
+        }
+        this.pending = null;
+        if (boundary || e.phase === 'finalize' || now - this.lastSentAt >= this.minIntervalMs) {
+            this.send(e);
+        }
+        else {
+            this.pending = e;
+        }
+    };
+    /** The terminal result/error supersedes any pending event. */
+    settle() {
+        this.pending = null;
+    }
+    send(e) {
+        const { event, transfer } = progressToWire(e);
+        this.lastSentAt = Date.now();
+        this.post({ t: 'progress', id: this.callId, seq: this.seq++, event }, transfer);
+    }
+}
+function requireX(x, method) {
+    if (x === null) {
+        throw new Error(`'${method}' requires input data X`);
+    }
+    return x;
+}
+function requireInst(entry) {
+    // Poisoned entries (createError) are rejected before dispatch.
+    return entry.inst;
+}
+async function dispatchFit(entry, x, opts) {
+    const inst = requireInst(entry);
+    if (entry.isGpu) {
+        await inst.fit(x, opts);
+    }
+    else if (entry.estimator === 'pca') {
+        await inst.fitAsync(x, opts);
+    }
+    else {
+        await inst.fitAsync(x, opts);
+    }
+}
+async function dispatchFitTransform(entry, x, opts) {
+    const inst = requireInst(entry);
+    if (entry.isGpu) {
+        return inst.fitTransform(x, opts);
+    }
+    if (entry.estimator === 'pca') {
+        return inst.fitTransformAsync(x, opts);
+    }
+    return inst.fitTransformAsync(x, opts);
+}
+async function rebuildFromModel(entry, model) {
+    if (entry.isGpu) {
+        const mod = await webgpuModule();
+        return mod.WebGPUPCA.fromModel(model, entry.deviceOptions);
+    }
+    if (entry.estimator === 'pca') {
+        return PCA.fromModel(model);
+    }
+    return IncrementalPCA.fromModel(model);
+}
+/**
+ * Attaches the pca-web protocol to a message port (a dedicated worker's
+ * global scope, a MessagePort, or Node's worker_threads port). Returns a
+ * detach function. Posts `{t: 'ready'}` immediately so clients can await
+ * the handshake.
+ */
+export function attachPCAWorker(port, options = {}) {
+    const budgetMs = options.budgetMs ?? 50;
+    const registry = new Map();
+    const queue = [];
+    let running = null;
+    let pumping = false;
+    let detached = false;
+    const post = (msg, transfer) => {
+        port.postMessage(msg, transfer ?? []);
+    };
+    const abortError = () => ({
+        name: 'AbortError',
+        message: 'The operation was aborted',
+    });
+    function handleAbort(targetId) {
+        if (running !== null && running.msg.id === targetId) {
+            if (running.signal !== null) {
+                running.signal.aborted = true;
+            }
+            return;
+        }
+        const idx = queue.findIndex((item) => item.msg.id === targetId);
+        if (idx >= 0) {
+            const [item] = queue.splice(idx, 1);
+            post({ t: 'error', id: item.msg.id, error: abortError() });
+        }
+    }
+    async function createEntry(msg) {
+        const opts = msg.options;
+        const { powerPreference, minGpuElements, ...pcaOptions } = opts;
+        const entry = {
+            estimator: msg.estimator,
+            requestedBackend: msg.backend,
+            isGpu: msg.backend === 'webgpu',
+            deviceOptions: { powerPreference, minGpuElements },
+            inst: null,
+        };
+        if (msg.backend === 'webgpu') {
+            if (msg.estimator === 'ipca') {
+                throw new Error("IncrementalPCA has no WebGPU backend; create it with backend: 'cpu'");
+            }
+            const mod = await webgpuModule();
+            entry.inst = msg.model
+                ? mod.WebGPUPCA.fromModel(msg.model, entry.deviceOptions)
+                : new mod.WebGPUPCA({ ...pcaOptions, powerPreference, minGpuElements });
+            return entry;
+        }
+        if (msg.estimator === 'pca') {
+            entry.inst = msg.model
+                ? PCA.fromModel(msg.model)
+                : new PCA(pcaOptions);
+            return entry;
+        }
+        entry.inst = msg.model
+            ? IncrementalPCA.fromModel(msg.model)
+            : new IncrementalPCA(msg.options);
+        return entry;
+    }
+    function buildInfo(entry) {
+        const gpu = entry.isGpu ? requireInst(entry) : null;
+        return {
+            kind: 'info',
+            estimator: entry.estimator,
+            requestedBackend: entry.requestedBackend,
+            backend: gpu !== null ? gpu.backend : 'cpu',
+            gpuAdapterInfo: gpu !== null ? gpu.gpuAdapterInfo : null,
+            webgpuAvailable: hasWebGPU(),
+        };
+    }
+    async function runCall(entry, msg, throttle, signal) {
+        const inst = requireInst(entry);
+        const x = msg.x !== undefined ? wireToMatrix(msg.x) : null;
+        const fitOptions = { budgetMs, signal };
+        if (throttle !== null) {
+            fitOptions.onProgress = throttle.onProgress;
+            if (msg.progress?.snapshot !== undefined) {
+                fitOptions.snapshot = msg.progress.snapshot;
+            }
+        }
+        const withModel = (outcome) => {
+            if (msg.returnModel === true) {
+                outcome.model = inst.toModel();
+            }
+            return outcome;
+        };
+        switch (msg.method) {
+            case 'fit': {
+                await dispatchFit(entry, requireX(x, msg.method), fitOptions);
+                return withModel({ value: null, transfer: [] });
+            }
+            case 'fitTransform': {
+                const out = await dispatchFitTransform(entry, requireX(x, msg.method), fitOptions);
+                const wire = matrixToWire(out);
+                return withModel({ value: wire, transfer: [wire.data.buffer] });
+            }
+            case 'partialFit': {
+                if (entry.estimator !== 'ipca') {
+                    throw new Error("partialFit requires an estimator created with estimator: 'ipca'");
+                }
+                inst.partialFit(requireX(x, msg.method));
+                return withModel({ value: null, transfer: [] });
+            }
+            case 'transform': {
+                const xm = requireX(x, msg.method);
+                const out = entry.isGpu
+                    ? await inst.transform(xm)
+                    : inst.transform(xm);
+                const wire = matrixToWire(out);
+                return { value: wire, transfer: [wire.data.buffer] };
+            }
+            case 'inverseTransform': {
+                const wire = matrixToWire(inst.inverseTransform(requireX(x, msg.method)));
+                return { value: wire, transfer: [wire.data.buffer] };
+            }
+            case 'scoreSamples': {
+                if (entry.estimator !== 'pca') {
+                    throw new Error('scoreSamples is only available on PCA (like sklearn)');
+                }
+                const out = tightArray(inst.scoreSamples(requireX(x, msg.method)));
+                return { value: { kind: 'array', data: out }, transfer: [out.buffer] };
+            }
+            case 'score': {
+                if (entry.estimator !== 'pca') {
+                    throw new Error('score is only available on PCA (like sklearn)');
+                }
+                return { value: inst.score(requireX(x, msg.method)), transfer: [] };
+            }
+            case 'getCovariance': {
+                const wire = matrixToWire(inst.getCovariance());
+                return { value: wire, transfer: [wire.data.buffer] };
+            }
+            case 'getPrecision': {
+                const wire = matrixToWire(inst.getPrecision());
+                return { value: wire, transfer: [wire.data.buffer] };
+            }
+            case 'importModel': {
+                if (msg.model === undefined) {
+                    throw new Error('importModel requires a model payload');
+                }
+                entry.inst = await rebuildFromModel(entry, msg.model);
+                return { value: null, transfer: [] };
+            }
+            case 'info': {
+                return { value: buildInfo(entry), transfer: [] };
+            }
+            default: {
+                throw new Error(`Unknown method '${String(msg.method)}'`);
+            }
+        }
+    }
+    async function executeItem(item) {
+        const msg = item.msg;
+        if (msg.t === 'create') {
+            try {
+                registry.set(msg.est, await createEntry(msg));
+                post({ t: 'result', id: msg.id, value: null });
+            }
+            catch (err) {
+                const error = toWireError(err);
+                // Poison the id so pipelined follow-up calls report the root cause.
+                registry.set(msg.est, {
+                    estimator: msg.estimator,
+                    requestedBackend: msg.backend,
+                    isGpu: msg.backend === 'webgpu',
+                    deviceOptions: {},
+                    inst: null,
+                    createError: error,
+                });
+                post({ t: 'error', id: msg.id, error });
+            }
+            return;
+        }
+        if (msg.t === 'dispose') {
+            const entry = registry.get(msg.est);
+            registry.delete(msg.est);
+            if (entry?.isGpu && entry.inst !== null) {
+                entry.inst.dispose();
+            }
+            post({ t: 'result', id: msg.id, value: null });
+            return;
+        }
+        const entry = registry.get(msg.est);
+        if (entry === undefined) {
+            post({
+                t: 'error',
+                id: msg.id,
+                error: { name: 'Error', message: `Unknown estimator id '${msg.est}' (send create first)` },
+            });
+            return;
+        }
+        if (entry.createError !== undefined) {
+            post({ t: 'error', id: msg.id, error: entry.createError });
+            return;
+        }
+        const signal = { aborted: false };
+        item.signal = signal;
+        const throttle = msg.progress !== undefined
+            ? new ProgressThrottle(post, msg.id, msg.progress.minIntervalMs ?? 33)
+            : null;
+        try {
+            const outcome = await runCall(entry, msg, throttle, signal);
+            throttle?.settle();
+            const response = { t: 'result', id: msg.id, value: outcome.value };
+            if (outcome.model !== undefined) {
+                response.model = outcome.model;
+                outcome.transfer.push(...modelTransferList(outcome.model));
+            }
+            post(response, outcome.transfer);
+        }
+        catch (err) {
+            throttle?.settle();
+            post({ t: 'error', id: msg.id, error: toWireError(err) });
+        }
+    }
+    async function pump() {
+        if (pumping) {
+            return;
+        }
+        pumping = true;
+        try {
+            while (queue.length > 0 && !detached) {
+                const item = queue.shift();
+                running = item;
+                await executeItem(item);
+                running = null;
+            }
+        }
+        finally {
+            running = null;
+            pumping = false;
+        }
+    }
+    const listener = (ev) => {
+        const msg = ev.data;
+        if (!isWorkerRequest(msg)) {
+            return;
+        }
+        if (msg.t === 'abort') {
+            // Out-of-band: never queued, takes effect immediately.
+            handleAbort(msg.targetId);
+            return;
+        }
+        queue.push({ msg, signal: null });
+        void pump();
+    };
+    port.addEventListener('message', listener);
+    port.start?.();
+    post({ t: 'ready', protocolVersion: PCA_WORKER_PROTOCOL_VERSION });
+    return () => {
+        detached = true;
+        port.removeEventListener('message', listener);
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/worker/handler.js.map

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

package/dist/worker/protocol.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Wire protocol shared by the worker handler (`pca-web/worker`) and the
+ * client proxies (`pca-web/client`).
+ *
+ * Import discipline: this module (and everything the client pulls in) must
+ * stay free of solver code — value imports are limited to matrix/types/
+ * model/validation; estimator and progress types appear type-only (erased
+ * at build time). This is what keeps `pca-web/client` a ~few-KB proxy while
+ * `pca-web/worker` carries the estimators.
+ */
+import { Matrix } from '../matrix.js';
+import type { AnyPCAModel } from '../model.js';
+import type { PowerIterationNormalizer, SvdSolver } from '../pca.js';
+import type { FitPhase, FitSolverId, SnapshotOptions } from '../progress.js';
+import type { FloatArray } from '../types.js';
+export declare const PCA_WORKER_PROTOCOL_VERSION = 1;
+/**
+ * The message-port surface the protocol needs. Satisfied by a browser
+ * `Worker` or `MessagePort` and by Node's `worker_threads` `MessagePort`
+ * (an EventTarget since Node 15) — which is what the vitest suites use.
+ * `transfer` is required (pass `[]`) so the signature matches the DOM
+ * overload sets structurally.
+ */
+export interface PCAWorkerPort {
+    postMessage(message: unknown, transfer: ArrayBufferLike[]): void;
+    addEventListener(type: 'message', listener: (ev: {
+        data: unknown;
+    }) => void): void;
+    removeEventListener(type: 'message', listener: (ev: {
+        data: unknown;
+    }) => void): void;
+    /** MessagePorts need an explicit start() when using addEventListener. */
+    start?(): void;
+}
+/** A port that may also be a terminatable/closable endpoint. */
+export interface PCAWorkerLike extends PCAWorkerPort {
+    terminate?(): unknown;
+    close?(): void;
+}
+export type WorkerFactory = () => PCAWorkerLike;
+export interface WireMatrix {
+    kind: 'matrix';
+    data: FloatArray;
+    rows: number;
+    cols: number;
+}
+/** A typed array that owns its entire buffer (safe to clone or transfer). */
+export declare function tightArray<T extends FloatArray>(a: T): T;
+/**
+ * Encodes a Matrix for the wire. The data is tight-sliced when it is a
+ * view — cloning or transferring a subarray view would otherwise serialize
+ * (or detach) its entire parent buffer.
+ */
+export declare function matrixToWire(m: Matrix): WireMatrix;
+export declare function wireToMatrix(w: WireMatrix): Matrix;
+export declare function isWireMatrix(v: unknown): v is WireMatrix;
+/** Marshalled error (Error instances do not structured-clone with names pre-ES2022 hosts). */
+export interface WireError {
+    name: string;
+    message: string;
+    stack?: string;
+}
+export declare function toWireError(err: unknown): WireError;
+/** Snapshot payload with matrices in wire form (always transferred). */
+export interface WireSnapshot {
+    components: WireMatrix;
+    singularValues: Float64Array;
+    explainedVariance: Float64Array;
+    scores?: WireMatrix;
+}
+/** `PCAFitProgress` as it crosses the thread boundary. */
+export interface WireProgress {
+    estimator: 'PCA' | 'IncrementalPCA';
+    solver: FitSolverId;
+    phase: FitPhase;
+    step: number;
+    totalSteps: number | null;
+    fraction: number | null;
+    snapshot?: WireSnapshot;
+    detail?: Readonly<Record<string, number>>;
+}
+/** Client-side progress subscription options for a fit call. */
+export interface ProgressOptions {
+    /**
+     * Worker-side throttle: at most one event per interval, latest-wins
+     * within a phase; phase boundaries and finalize are never coalesced.
+     * Default 33 ms; 0 delivers every event.
+     */
+    minIntervalMs?: number;
+    snapshot?: SnapshotOptions;
+}
+/** PCA options as they cross the wire — randomState must be a numeric seed. */
+export interface WirePCAOptions {
+    nComponents?: number | 'mle' | null;
+    copy?: boolean;
+    whiten?: boolean;
+    svdSolver?: SvdSolver;
+    tol?: number;
+    iteratedPower?: number | 'auto';
+    nOversamples?: number;
+    powerIterationNormalizer?: PowerIterationNormalizer;
+    randomState?: number | null;
+    /** WebGPU backend knobs (ignored on the CPU backend). */
+    powerPreference?: 'low-power' | 'high-performance';
+    minGpuElements?: number;
+}
+export interface WireIPCAOptions {
+    nComponents?: number | null;
+    whiten?: boolean;
+    copy?: boolean;
+    batchSize?: number | null;
+}
+export type WorkerMethod = 'fit' | 'fitTransform' | 'partialFit' | 'transform' | 'inverseTransform' | 'scoreSamples' | 'score' | 'getCovariance' | 'getPrecision' | 'importModel' | 'info';
+export interface CreateRequest {
+    t: 'create';
+    /** Request id (responded to like any call, enabling pipelining). */
+    id: number;
+    /** Client-chosen estimator id for all subsequent calls. */
+    est: string;
+    estimator: 'pca' | 'ipca';
+    backend: 'cpu' | 'webgpu';
+    options: WirePCAOptions | WireIPCAOptions;
+    /** Hydrate the new estimator from a serialized model. */
+    model?: AnyPCAModel;
+}
+export interface CallRequest {
+    t: 'call';
+    id: number;
+    est: string;
+    method: WorkerMethod;
+    x?: WireMatrix;
+    model?: AnyPCAModel;
+    /** Subscribe this call to progress events. */
+    progress?: ProgressOptions;
+    /** Piggyback the fitted model on the result (keeps the client mirror fresh). */
+    returnModel?: boolean;
+}
+/** Out-of-band: never enters the execution queue. */
+export interface AbortRequest {
+    t: 'abort';
+    targetId: number;
+}
+export interface DisposeRequest {
+    t: 'dispose';
+    id: number;
+    est: string;
+}
+export type PCAWorkerRequest = CreateRequest | CallRequest | AbortRequest | DisposeRequest;
+/** Requests that enter the FIFO queue (abort is handled out-of-band). */
+export type QueueableRequest = CreateRequest | CallRequest | DisposeRequest;
+export interface ReadyResponse {
+    t: 'ready';
+    protocolVersion: number;
+}
+export type WireValue = null | number | string[] | WireMatrix | {
+    kind: 'array';
+    data: FloatArray;
+} | WorkerEstimatorInfo;
+export interface ResultResponse {
+    t: 'result';
+    id: number;
+    value: WireValue;
+    /** Piggybacked model (fit/partialFit with returnModel). */
+    model?: AnyPCAModel;
+}
+export interface ProgressResponse {
+    t: 'progress';
+    id: number;
+    /** Monotonic per call — receivers may assert ordering. */
+    seq: number;
+    event: WireProgress;
+}
+export interface ErrorResponse {
+    t: 'error';
+    id: number;
+    error: WireError;
+}
+export type PCAWorkerResponse = ReadyResponse | ResultResponse | ProgressResponse | ErrorResponse;
+export interface WorkerEstimatorInfo {
+    kind: 'info';
+    estimator: 'pca' | 'ipca';
+    requestedBackend: 'cpu' | 'webgpu';
+    /** Backend the last fit actually ran on ('cpu' until a GPU fit happens). */
+    backend: 'cpu' | 'webgpu';
+    gpuAdapterInfo: string | null;
+    webgpuAvailable: boolean;
+}
+export declare function isWorkerRequest(v: unknown): v is PCAWorkerRequest;
+export declare function isWorkerResponse(v: unknown): v is PCAWorkerResponse;
+/** Buffers of a model's typed arrays (all tight by `toModel` contract). */
+export declare function modelTransferList(model: AnyPCAModel): ArrayBufferLike[];
+//# sourceMappingURL=protocol.d.ts.map

package/dist/worker/protocol.d.ts.map

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