webml-kit 0.3.0 → 0.4.1

package/dist/gpu-recovery.d.ts

@@ -1,61 +0,0 @@
-/**
- * GPU device-lost recovery handler.
- *
- * WebGPU devices can be lost due to TDR resets, VRAM exhaustion, driver
- * updates, or mobile browsers reclaiming resources. This module provides
- * automatic recovery with exponential backoff.
- */
-export type RecoveryState = 'idle' | 'lost' | 'recovering' | 'recovered' | 'failed';
-export interface GPURecoveryEvents {
-    'state-change': RecoveryState;
-    'lost': {
-        reason: string;
-    };
-    'recovered': {
-        adapter: GPUAdapter;
-    };
-    'failed': {
-        attempts: number;
-        lastError: string;
-    };
-}
-export type GPURecoveryListener<K extends keyof GPURecoveryEvents> = (data: GPURecoveryEvents[K]) => void;
-/**
- * Monitors a GPU device for loss and attempts automatic recovery.
- *
- * ```ts
- * const recovery = new GPURecovery();
- * recovery.on('lost', ({ reason }) => showBanner('GPU lost: ' + reason));
- * recovery.on('recovered', ({ adapter }) => reinitPipeline(adapter));
- * recovery.on('failed', () => showFallbackUI());
- *
- * const device = await recovery.watchDevice(existingDevice);
- * ```
- */
-export declare class GPURecovery {
-    private state;
-    private listeners;
-    private maxRetries;
-    private baseDelay;
-    constructor(options?: {
-        maxRetries?: number;
-        baseDelayMs?: number;
-    });
-    /** Current recovery state. */
-    getState(): RecoveryState;
-    /** Register a listener for recovery events. */
-    on<K extends keyof GPURecoveryEvents>(event: K, listener: GPURecoveryListener<K>): void;
-    /** Remove a listener. */
-    off<K extends keyof GPURecoveryEvents>(event: K, listener: GPURecoveryListener<K>): void;
-    private emit;
-    private setState;
-    /**
-     * Watch a GPU device for loss. When the device is lost, automatically
-     * attempt to re-acquire an adapter.
-     *
-     * @returns The same device (for chaining)
-     */
-    watchDevice(device: GPUDevice): GPUDevice;
-    private attemptRecovery;
-}
-//# sourceMappingURL=gpu-recovery.d.ts.map

package/dist/gpu-recovery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gpu-recovery.d.ts","sourceRoot":"","sources":["../src/gpu-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEpF,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,aAAa,CAAC;IAC9B,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,WAAW,EAAE;QAAE,OAAO,EAAE,UAAU,CAAA;KAAE,CAAC;IACrC,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,iBAAiB,IAC/D,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAEvC;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAKnE,8BAA8B;IAC9B,QAAQ,IAAI,aAAa;IAIzB,+CAA+C;IAC/C,EAAE,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAClC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,IAAI;IAOP,yBAAyB;IACzB,GAAG,CAAC,CAAC,SAAS,MAAM,iBAAiB,EACnC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,IAAI;IAIP,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,QAAQ;IAKhB;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS;YAmB3B,eAAe;CAqC9B"}

package/dist/gpu-recovery.js

@@ -1,105 +0,0 @@
-/**
- * GPU device-lost recovery handler.
- *
- * WebGPU devices can be lost due to TDR resets, VRAM exhaustion, driver
- * updates, or mobile browsers reclaiming resources. This module provides
- * automatic recovery with exponential backoff.
- */
-/**
- * Monitors a GPU device for loss and attempts automatic recovery.
- *
- * ```ts
- * const recovery = new GPURecovery();
- * recovery.on('lost', ({ reason }) => showBanner('GPU lost: ' + reason));
- * recovery.on('recovered', ({ adapter }) => reinitPipeline(adapter));
- * recovery.on('failed', () => showFallbackUI());
- *
- * const device = await recovery.watchDevice(existingDevice);
- * ```
- */
-export class GPURecovery {
-    state = 'idle';
-    listeners = new Map();
-    maxRetries;
-    baseDelay;
-    constructor(options) {
-        this.maxRetries = options?.maxRetries ?? 3;
-        this.baseDelay = options?.baseDelayMs ?? 1000;
-    }
-    /** Current recovery state. */
-    getState() {
-        return this.state;
-    }
-    /** Register a listener for recovery events. */
-    on(event, listener) {
-        if (!this.listeners.has(event)) {
-            this.listeners.set(event, new Set());
-        }
-        this.listeners.get(event).add(listener);
-    }
-    /** Remove a listener. */
-    off(event, listener) {
-        this.listeners.get(event)?.delete(listener);
-    }
-    emit(event, data) {
-        this.listeners.get(event)?.forEach(fn => fn(data));
-    }
-    setState(state) {
-        this.state = state;
-        this.emit('state-change', state);
-    }
-    /**
-     * Watch a GPU device for loss. When the device is lost, automatically
-     * attempt to re-acquire an adapter.
-     *
-     * @returns The same device (for chaining)
-     */
-    watchDevice(device) {
-        device.lost.then((info) => {
-            const reason = info.message || 'unknown';
-            // If the device was intentionally destroyed, don't recover
-            if (info.reason === 'destroyed') {
-                this.setState('idle');
-                return;
-            }
-            this.setState('lost');
-            this.emit('lost', { reason });
-            this.attemptRecovery(0);
-        });
-        this.setState('idle');
-        return device;
-    }
-    async attemptRecovery(attempt) {
-        if (attempt >= this.maxRetries) {
-            this.setState('failed');
-            this.emit('failed', {
-                attempts: attempt,
-                lastError: 'Max retries exceeded',
-            });
-            return;
-        }
-        this.setState('recovering');
-        // Exponential backoff: 1s, 2s, 4s
-        const delay = this.baseDelay * 2 ** attempt;
-        await new Promise(r => setTimeout(r, delay));
-        try {
-            if (typeof navigator === 'undefined' || !('gpu' in navigator)) {
-                throw new Error('WebGPU not available');
-            }
-            const adapter = await navigator.gpu.requestAdapter({
-                powerPreference: 'high-performance',
-            });
-            if (!adapter) {
-                throw new Error('No GPU adapter available');
-            }
-            this.setState('recovered');
-            this.emit('recovered', { adapter });
-        }
-        catch (e) {
-            const msg = e instanceof Error ? e.message : String(e);
-            // Retry
-            this.attemptRecovery(attempt + 1);
-        }
-    }
-}
-//# sourceMappingURL=gpu-recovery.js.map

package/dist/gpu-recovery.js.map

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

package/dist/hub.d.ts

@@ -1,97 +0,0 @@
-/**
- * Search and list WebGPU/ONNX-compatible models from the Hugging Face Hub.
- *
- * Uses the public HF Hub API — no auth token needed for public models.
- */
-import type { PipelineTask } from './types.js';
-export interface HubModel {
-    /** Model ID (e.g. 'onnx-community/Bonsai-1.7B-ONNX') */
-    modelId: string;
-    /** Pipeline task (e.g. 'text-generation') */
-    task: PipelineTask | string;
-    /** Author or organization */
-    author: string;
-    /** Number of downloads in the last month */
-    downloads: number;
-    /** Number of likes */
-    likes: number;
-    /** Last modified date */
-    lastModified: string;
-    /** Tags on the model (e.g. ['onnx', 'webgpu']) */
-    tags: string[];
-    /** Whether it's likely WebGPU-compatible (has ONNX weights) */
-    webgpuCompatible: boolean;
-}
-export interface SearchOptions {
-    /** Filter by pipeline task */
-    task?: PipelineTask | string;
-    /** Free-text search query */
-    query?: string;
-    /** Sort by: 'downloads' | 'likes' | 'modified' | 'trending' */
-    sort?: 'downloads' | 'likes' | 'modified' | 'trending';
-    /** Sort direction */
-    direction?: 'asc' | 'desc';
-    /** Max results to return (default: 20, max: 100) */
-    limit?: number;
-    /** Filter by author/org (e.g. 'onnx-community', 'Xenova') */
-    author?: string;
-}
-/** Known orgs that publish ONNX/WebGPU-ready models */
-export declare const WEBGPU_ORGS: readonly ["onnx-community", "Xenova", "webml-community"];
-/**
- * Search for models compatible with transformers.js (and thus WebGPU/WASM).
- *
- * ```ts
- * import { searchModels } from 'webml-kit';
- *
- * const models = await searchModels({ task: 'text-generation', limit: 5 });
- * for (const m of models) {
- *   console.log(`${m.modelId} — ${m.downloads} downloads`);
- * }
- * ```
- */
-export declare function searchModels(options?: SearchOptions): Promise<HubModel[]>;
-/**
- * List popular models for a specific task, sorted by downloads.
- *
- * ```ts
- * import { listModelsForTask } from 'webml-kit';
- *
- * const models = await listModelsForTask('automatic-speech-recognition');
- * // [{ modelId: 'onnx-community/whisper-tiny.en', downloads: 12345, ... }]
- * ```
- */
-export declare function listModelsForTask(task: PipelineTask | string, limit?: number): Promise<HubModel[]>;
-/**
- * List trending transformers.js models right now.
- *
- * ```ts
- * import { trendingModels } from 'webml-kit';
- *
- * const hot = await trendingModels(5);
- * ```
- */
-export declare function trendingModels(limit?: number): Promise<HubModel[]>;
-/**
- * List all models from known WebGPU-friendly orgs
- * (onnx-community, Xenova, webml-community).
- *
- * ```ts
- * import { listWebGPUModels } from 'webml-kit';
- *
- * const models = await listWebGPUModels({ task: 'text-generation' });
- * ```
- */
-export declare function listWebGPUModels(options?: Omit<SearchOptions, 'author'>): Promise<HubModel[]>;
-/**
- * Get detailed info about a specific model.
- *
- * ```ts
- * import { getModelInfo } from 'webml-kit';
- *
- * const info = await getModelInfo('onnx-community/Bonsai-1.7B-ONNX');
- * console.log(info.task, info.downloads, info.webgpuCompatible);
- * ```
- */
-export declare function getModelInfo(modelId: string): Promise<HubModel>;
-//# sourceMappingURL=hub.d.ts.map

package/dist/hub.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hub.d.ts","sourceRoot":"","sources":["../src/hub.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,WAAW,QAAQ;IACvB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+DAA+D;IAC/D,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAC7B,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IACvD,qBAAqB;IACrB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,uDAAuD;AACvD,eAAO,MAAM,WAAW,0DAId,CAAC;AAIX;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA8BnF;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,YAAY,GAAG,MAAM,EAC3B,KAAK,SAAK,GACT,OAAO,CAAC,QAAQ,EAAE,CAAC,CAErB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAEpE;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAM,GAC1C,OAAO,CAAC,QAAQ,EAAE,CAAC,CAiBrB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQrE"}

package/dist/hub.js

@@ -1,142 +0,0 @@
-/**
- * Search and list WebGPU/ONNX-compatible models from the Hugging Face Hub.
- *
- * Uses the public HF Hub API — no auth token needed for public models.
- */
-// ─── Constants ───
-const HF_API = 'https://huggingface.co/api';
-/** Known orgs that publish ONNX/WebGPU-ready models */
-export const WEBGPU_ORGS = [
-    'onnx-community',
-    'Xenova',
-    'webml-community',
-];
-// ─── Core functions ───
-/**
- * Search for models compatible with transformers.js (and thus WebGPU/WASM).
- *
- * ```ts
- * import { searchModels } from 'webml-kit';
- *
- * const models = await searchModels({ task: 'text-generation', limit: 5 });
- * for (const m of models) {
- *   console.log(`${m.modelId} — ${m.downloads} downloads`);
- * }
- * ```
- */
-export async function searchModels(options = {}) {
-    const params = new URLSearchParams();
-    // Only show models that work with transformers.js
-    params.set('library', 'transformers.js');
-    if (options.task)
-        params.set('pipeline_tag', options.task);
-    if (options.query)
-        params.set('search', options.query);
-    if (options.author)
-        params.set('author', options.author);
-    if (options.sort === 'trending') {
-        params.set('sort', 'trending');
-    }
-    else if (options.sort) {
-        params.set('sort', options.sort === 'modified' ? 'lastModified' : options.sort);
-        params.set('direction', options.direction === 'asc' ? '1' : '-1');
-    }
-    else {
-        params.set('sort', 'downloads');
-        params.set('direction', '-1');
-    }
-    params.set('limit', String(Math.min(options.limit ?? 20, 100)));
-    const url = `${HF_API}/models?${params.toString()}`;
-    const response = await fetch(url);
-    if (!response.ok) {
-        throw new Error(`HF Hub API error: ${response.status} ${response.statusText}`);
-    }
-    const data = await response.json();
-    return data.map(normalizeModel);
-}
-/**
- * List popular models for a specific task, sorted by downloads.
- *
- * ```ts
- * import { listModelsForTask } from 'webml-kit';
- *
- * const models = await listModelsForTask('automatic-speech-recognition');
- * // [{ modelId: 'onnx-community/whisper-tiny.en', downloads: 12345, ... }]
- * ```
- */
-export async function listModelsForTask(task, limit = 10) {
-    return searchModels({ task, sort: 'downloads', limit });
-}
-/**
- * List trending transformers.js models right now.
- *
- * ```ts
- * import { trendingModels } from 'webml-kit';
- *
- * const hot = await trendingModels(5);
- * ```
- */
-export async function trendingModels(limit = 10) {
-    return searchModels({ sort: 'trending', limit });
-}
-/**
- * List all models from known WebGPU-friendly orgs
- * (onnx-community, Xenova, webml-community).
- *
- * ```ts
- * import { listWebGPUModels } from 'webml-kit';
- *
- * const models = await listWebGPUModels({ task: 'text-generation' });
- * ```
- */
-export async function listWebGPUModels(options = {}) {
-    const results = [];
-    for (const org of WEBGPU_ORGS) {
-        const models = await searchModels({ ...options, author: org });
-        results.push(...models);
-    }
-    // Deduplicate by modelId and sort by downloads
-    const seen = new Set();
-    return results
-        .filter((m) => {
-        if (seen.has(m.modelId))
-            return false;
-        seen.add(m.modelId);
-        return true;
-    })
-        .sort((a, b) => b.downloads - a.downloads);
-}
-/**
- * Get detailed info about a specific model.
- *
- * ```ts
- * import { getModelInfo } from 'webml-kit';
- *
- * const info = await getModelInfo('onnx-community/Bonsai-1.7B-ONNX');
- * console.log(info.task, info.downloads, info.webgpuCompatible);
- * ```
- */
-export async function getModelInfo(modelId) {
-    const response = await fetch(`${HF_API}/models/${modelId}`);
-    if (!response.ok) {
-        throw new Error(`Model not found: ${modelId} (${response.status})`);
-    }
-    const data = await response.json();
-    return normalizeModel(data);
-}
-function normalizeModel(raw) {
-    const id = raw.modelId ?? raw.id ?? 'unknown';
-    const tags = raw.tags ?? [];
-    const author = raw.author ?? id.split('/')[0] ?? 'unknown';
-    return {
-        modelId: id,
-        task: (raw.pipeline_tag ?? 'unknown'),
-        author,
-        downloads: raw.downloads ?? 0,
-        likes: raw.likes ?? 0,
-        lastModified: raw.lastModified ?? '',
-        tags,
-        webgpuCompatible: tags.includes('onnx') || WEBGPU_ORGS.some((org) => id.startsWith(org)),
-    };
-}
-//# sourceMappingURL=hub.js.map

package/dist/hub.js.map

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

package/dist/index.d.ts

@@ -1,61 +0,0 @@
-/**
- * webml-kit — Browser ML Made Easy
- *
- * Framework-agnostic utilities for loading and running ML models
- * in the browser via WebGPU/WASM, powered by @huggingface/transformers.
- *
- * @example
- * ```ts
- * import { ModelClient, detectDevice, isCached } from 'webml-kit';
- *
- * // Check device
- * const device = await detectDevice();
- * console.log(device.backend); // 'webgpu'
- *
- * // Check cache
- * if (await isCached('onnx-community/Bonsai-1.7B-ONNX')) {
- *   console.log('Model already downloaded!');
- * }
- *
- * // Create client
- * const client = new ModelClient(
- *   new URL('./model-worker.js', import.meta.url)
- * );
- *
- * // Load model
- * await client.load({
- *   task: 'text-generation',
- *   modelId: 'onnx-community/Bonsai-1.7B-ONNX',
- *   dtype: 'q4',
- *   onProgress: ({ percent }) => console.log(`${percent}%`),
- * });
- *
- * // Stream tokens
- * for await (const { token, tps } of client.stream('Hello!')) {
- *   process.stdout.write(token);
- * }
- * ```
- *
- * @packageDocumentation
- */
-export { webml, inferTask } from './loader.js';
-export type { WebMLOptions, LoadedModel } from './loader.js';
-import webml from './loader.js';
-export default webml;
-export { coerceAudio, listenMic } from './inputs.js';
-export type { ListenOptions, MicListener } from './inputs.js';
-export { ModelClient } from './model-client.js';
-export type { LoadOptions, ClientEventType } from './model-client.js';
-export { detectDevice, checkWebGPU, checkWASM, getGPUAdapter, getGPUInfo, recommendDtype, canRun, parseSize, formatSize, } from './device.js';
-export { getCacheBackend, isCached, getCacheSize, listCachedModels, clearCache, } from './cache.js';
-export { TokenStream, collectStream } from './streaming.js';
-export { GPURecovery } from './gpu-recovery.js';
-export type { RecoveryState, GPURecoveryEvents } from './gpu-recovery.js';
-export { PIPELINE_REGISTRY, getPipelineDefaults, supportsStreaming, } from './pipelines/index.js';
-export type { PipelineDefaults } from './pipelines/index.js';
-export { createOnnxPipeline, decodeCTC, decodeWavToFloat32, toFloat32Array, } from './onnx-pipeline.js';
-export type { OnnxPipelineInstance } from './onnx-pipeline.js';
-export { searchModels, listModelsForTask, trendingModels, listWebGPUModels, getModelInfo, WEBGPU_ORGS, } from './hub.js';
-export type { HubModel, SearchOptions } from './hub.js';
-export type { DeviceBackend, DeviceInfo, GPUInfo, QuantizationType, PipelineTask, ModelConfig, ProgressEvent, ProgressCallback, TokenEvent, ChatMessage, TextGenerationOptions, TextGenerationResult, ClassificationResult, DetectionResult, TranscriptionResult, EmbeddingResult, CaptionResult, TextResult, CacheBackend, CachedModel, } from './types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,MAAM,aAAa,CAAC;AAChC,eAAe,KAAK,CAAC;AAGrB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGtE,OAAO,EACL,YAAY,EACZ,WAAW,EACX,SAAS,EACT,aAAa,EACb,UAAU,EACV,cAAc,EACd,MAAM,EACN,SAAS,EACT,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG1E,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,kBAAkB,EAClB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG/D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACZ,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGxD,YAAY,EACV,aAAa,EACb,UAAU,EACV,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,63 +0,0 @@
-/**
- * webml-kit — Browser ML Made Easy
- *
- * Framework-agnostic utilities for loading and running ML models
- * in the browser via WebGPU/WASM, powered by @huggingface/transformers.
- *
- * @example
- * ```ts
- * import { ModelClient, detectDevice, isCached } from 'webml-kit';
- *
- * // Check device
- * const device = await detectDevice();
- * console.log(device.backend); // 'webgpu'
- *
- * // Check cache
- * if (await isCached('onnx-community/Bonsai-1.7B-ONNX')) {
- *   console.log('Model already downloaded!');
- * }
- *
- * // Create client
- * const client = new ModelClient(
- *   new URL('./model-worker.js', import.meta.url)
- * );
- *
- * // Load model
- * await client.load({
- *   task: 'text-generation',
- *   modelId: 'onnx-community/Bonsai-1.7B-ONNX',
- *   dtype: 'q4',
- *   onProgress: ({ percent }) => console.log(`${percent}%`),
- * });
- *
- * // Stream tokens
- * for await (const { token, tps } of client.stream('Hello!')) {
- *   process.stdout.write(token);
- * }
- * ```
- *
- * @packageDocumentation
- */
-// ─── Functional API (Default Export) ───
-export { webml, inferTask } from './loader.js';
-import webml from './loader.js';
-export default webml;
-// ─── Input & Media Helpers ───
-export { coerceAudio, listenMic } from './inputs.js';
-// ─── Core ───
-export { ModelClient } from './model-client.js';
-// ─── Device Detection ───
-export { detectDevice, checkWebGPU, checkWASM, getGPUAdapter, getGPUInfo, recommendDtype, canRun, parseSize, formatSize, } from './device.js';
-// ─── Cache ───
-export { getCacheBackend, isCached, getCacheSize, listCachedModels, clearCache, } from './cache.js';
-// ─── Streaming ───
-export { TokenStream, collectStream } from './streaming.js';
-// ─── GPU Recovery ───
-export { GPURecovery } from './gpu-recovery.js';
-// ─── Pipelines ───
-export { PIPELINE_REGISTRY, getPipelineDefaults, supportsStreaming, } from './pipelines/index.js';
-// ─── ONNX Pipelines ───
-export { createOnnxPipeline, decodeCTC, decodeWavToFloat32, toFloat32Array, } from './onnx-pipeline.js';
-// ─── Hub Search ───
-export { searchModels, listModelsForTask, trendingModels, listWebGPUModels, getModelInfo, WEBGPU_ORGS, } from './hub.js';
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,0CAA0C;AAC1C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,MAAM,aAAa,CAAC;AAChC,eAAe,KAAK,CAAC;AAErB,gCAAgC;AAChC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGrD,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,2BAA2B;AAC3B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,SAAS,EACT,aAAa,EACb,UAAU,EACV,cAAc,EACd,MAAM,EACN,SAAS,EACT,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,gBAAgB;AAChB,OAAO,EACL,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE5D,uBAAuB;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,oBAAoB;AACpB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,yBAAyB;AACzB,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,kBAAkB,EAClB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,qBAAqB;AACrB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACZ,MAAM,UAAU,CAAC"}

package/dist/inputs.d.ts

@@ -1,27 +0,0 @@
-/**
- * Universal input coercion and browser media helpers.
- *
- * Automatically converts URLs, Blobs, Files, AudioBuffers, and arrays
- * into the exact formats expected by ML models.
- */
-export interface ListenOptions {
-    /** Target sample rate in Hz (default: 16000) */
-    sampleRate?: number;
-    /** Chunk interval in seconds for streaming callback (default: 3) */
-    intervalSeconds?: number;
-    /** Callback fired for each audio chunk */
-    onChunk?: (pcm: Float32Array) => void;
-}
-export interface MicListener {
-    stop: () => void;
-}
-/**
- * Coerces various audio formats (URL, File, Blob, AudioBuffer, ArrayBuffer, Array)
- * into a standardized 16kHz Float32Array PCM buffer.
- */
-export declare function coerceAudio(input: unknown): Promise<Float32Array>;
-/**
- * Capture microphone audio from browser and invoke callback with Float32Array PCM.
- */
-export declare function listenMic(onChunk: (pcm: Float32Array) => void, options?: ListenOptions): Promise<MicListener>;
-//# sourceMappingURL=inputs.d.ts.map

package/dist/inputs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../src/inputs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAkEvE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,EACpC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAwDtB"}