ngx-transformers 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# NgxTransformers
+
+This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 22.1.0.
+
+## Code scaffolding
+
+Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
+
+```bash
+ng generate component component-name
+```
+
+For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
+
+```bash
+ng generate --help
+```
+
+## Building
+
+To build the library, run:
+
+```bash
+ng build ngx-transformers
+```
+
+This command will compile your project, and the build artifacts will be placed in the `dist/` directory.
+
+### Publishing the Library
+
+Once the project is built, you can publish your library by following these steps:
+
+1. Navigate to the `dist` directory:
+
+   ```bash
+   cd dist/ngx-transformers
+   ```
+
+2. Run the `npm publish` command to publish your library to the npm registry:
+   ```bash
+   npm publish
+   ```
+
+## Running unit tests
+
+To execute unit tests with the [Vitest](https://vitest.dev/) test runner, use the following command:
+
+```bash
+ng test
+```
+
+## Running end-to-end tests
+
+For end-to-end (e2e) testing, run:
+
+```bash
+ng e2e
+```
+
+Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
+
+## Additional Resources
+
+For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.

package/fesm2022/ngx-transformers.mjs

@@ -0,0 +1,290 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, makeEnvironmentProviders, signal, computed, inject, DestroyRef, input, ChangeDetectionStrategy, Component } from '@angular/core';
+
+const defaultPipelineFactory = async (task, model, options) => {
+    const { pipeline } = await import('@huggingface/transformers');
+    const pipe = await pipeline(task, model, options);
+    return pipe;
+};
+const PIPELINE_FACTORY = new InjectionToken('ngx-transformers.pipeline-factory', {
+    providedIn: 'root',
+    factory: () => defaultPipelineFactory,
+});
+const NGX_TRANSFORMERS_CONFIG = new InjectionToken('ngx-transformers.config', {
+    providedIn: 'root',
+    factory: () => ({}),
+});
+/**
+ * Sets workspace-wide defaults (device, dtype, extra pipeline options):
+ *
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideTransformers({ device: 'webgpu', dtype: 'q8' })],
+ * });
+ * ```
+ */
+function provideTransformers(config) {
+    return makeEnvironmentProviders([{ provide: NGX_TRANSFORMERS_CONFIG, useValue: config }]);
+}
+
+/**
+ * A lazily-loaded Transformers.js pipeline wrapped in signals.
+ *
+ * The model is not downloaded until load() or the first run() call, so
+ * creating handles is free. All state is exposed as signals and safe to
+ * bind in zoneless apps.
+ */
+class PipelineHandle {
+    request;
+    factory;
+    config;
+    /** idle -> loading -> ready <-> busy; error only on load failure. */
+    status = signal('idle', /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "status" }] : /* istanbul ignore next */ []));
+    /** Download progress for the file currently transferring, else null. */
+    progress = signal(null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "progress" }] : /* istanbul ignore next */ []));
+    error = signal(null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "error" }] : /* istanbul ignore next */ []));
+    /** True once the model is usable (including while a run is in flight). */
+    ready = computed(() => this.status() === 'ready' || this.status() === 'busy', /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "ready" }] : /* istanbul ignore next */ []));
+    busy = computed(() => this.status() === 'busy' || this.status() === 'loading', /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "busy" }] : /* istanbul ignore next */ []));
+    pipe = null;
+    loading = null;
+    constructor(request, factory, config) {
+        this.request = request;
+        this.factory = factory;
+        this.config = config;
+    }
+    /** Downloads and initializes the model. Idempotent; retries after error. */
+    load() {
+        if (this.pipe)
+            return Promise.resolve();
+        this.loading ??= this.doLoad().finally(() => (this.loading = null));
+        return this.loading;
+    }
+    /** Runs the pipeline, loading the model first if needed. */
+    async run(input, runOptions) {
+        await this.load();
+        this.status.set('busy');
+        try {
+            return (await this.pipe(input, runOptions));
+        }
+        finally {
+            // A failed run leaves the model intact - back to ready either way.
+            this.status.set('ready');
+        }
+    }
+    /** Frees the model. The handle can be loaded again afterwards. */
+    async dispose() {
+        const pipe = this.pipe;
+        this.pipe = null;
+        this.status.set('idle');
+        this.progress.set(null);
+        await pipe?.dispose?.();
+    }
+    async doLoad() {
+        this.status.set('loading');
+        this.error.set(null);
+        const options = {
+            ...this.config.pipelineOptions,
+            ...this.request.options,
+            progress_callback: (event) => this.onProgress(event),
+        };
+        const device = this.request.device ?? this.config.device;
+        const dtype = this.request.dtype ?? this.config.dtype;
+        if (device && device !== 'auto')
+            options['device'] = device;
+        if (dtype)
+            options['dtype'] = dtype;
+        try {
+            this.pipe = await this.factory(this.request.task, this.request.model, options);
+            this.progress.set(null);
+            this.status.set('ready');
+        }
+        catch (err) {
+            this.error.set(err);
+            this.status.set('error');
+            throw err;
+        }
+    }
+    onProgress(event) {
+        if (event.status !== 'progress' || !event.file)
+            return;
+        this.progress.set({
+            file: event.file,
+            progress: Math.round(event.progress ?? 0),
+            loadedBytes: event.loaded ?? 0,
+            totalBytes: event.total ?? 0,
+        });
+    }
+}
+/**
+ * Creates a PipelineHandle in an injection context (constructor, field
+ * initializer, or runInInjectionContext). The handle is disposed with the
+ * surrounding component/injector.
+ */
+function createPipeline(request) {
+    const handle = new PipelineHandle(request, inject(PIPELINE_FACTORY), inject(NGX_TRANSFORMERS_CONFIG));
+    inject(DestroyRef, { optional: true })?.onDestroy(() => void handle.dispose());
+    return handle;
+}
+
+const DEFAULT_TEXT_CLASSIFICATION_MODEL = 'Xenova/distilbert-base-uncased-finetuned-sst-2-english';
+/**
+ * Text classification (sentiment by default). The default model is
+ * DistilBERT SST-2 (~65 MB, q8) - swap `model` for any Transformers.js
+ * compatible text-classification checkpoint.
+ */
+class TextClassifier extends PipelineHandle {
+    /** Classifies one text; resolves to labels sorted by score (top first). */
+    async classify(text, topK = 1) {
+        const out = await this.run(text, { top_k: topK });
+        // Single input: transformers.js returns a flat array of {label, score}.
+        const flat = (Array.isArray(out[0]) ? out[0] : out);
+        return [...flat].sort((a, b) => b.score - a.score);
+    }
+}
+/** Creates a TextClassifier in an injection context. */
+function createTextClassifier(options = {}) {
+    const classifier = new TextClassifier({ task: 'text-classification', model: DEFAULT_TEXT_CLASSIFICATION_MODEL, ...options }, inject(PIPELINE_FACTORY), inject(NGX_TRANSFORMERS_CONFIG));
+    inject(DestroyRef, { optional: true })?.onDestroy(() => void classifier.dispose());
+    return classifier;
+}
+
+const DEFAULT_EMBEDDING_MODEL = 'Xenova/all-MiniLM-L6-v2';
+/** Cosine similarity of two vectors. For normalized vectors this is the dot product. */
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length || a.length === 0) {
+        throw new Error(`cosineSimilarity: incompatible lengths ${a.length} and ${b.length}`);
+    }
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+/**
+ * Sentence embeddings via feature-extraction (all-MiniLM-L6-v2 by default,
+ * ~23 MB q8). Outputs mean-pooled, L2-normalized vectors ready for cosine
+ * similarity / semantic search.
+ */
+class TextEmbedder extends PipelineHandle {
+    /** Embeds one or many texts; always resolves to one vector per text. */
+    async embed(texts) {
+        const input = Array.isArray(texts) ? texts : [texts];
+        if (input.length === 0)
+            return [];
+        const out = await this.run(input, { pooling: 'mean', normalize: true });
+        return toRows(out);
+    }
+    /** Cosine similarity of two texts in [-1, 1]. */
+    async similarity(a, b) {
+        const [va, vb] = await this.embed([a, b]);
+        return cosineSimilarity(va, vb);
+    }
+    /** Ranks documents against a query, most similar first. */
+    async rank(query, documents) {
+        if (documents.length === 0)
+            return [];
+        const [queryVec, ...docVecs] = await this.embed([query, ...documents]);
+        return docVecs
+            .map((vec, index) => ({ text: documents[index], score: cosineSimilarity(queryVec, vec), index }))
+            .sort((a, b) => b.score - a.score);
+    }
+}
+function toRows(out) {
+    if (typeof out.tolist === 'function')
+        return out.tolist();
+    const [rows, cols] = out.dims.length === 2 ? out.dims : [1, out.dims[out.dims.length - 1]];
+    const data = out.data;
+    const result = [];
+    for (let r = 0; r < rows; r++) {
+        result.push(Array.from({ length: cols }, (_, c) => data[r * cols + c]));
+    }
+    return result;
+}
+/** Creates a TextEmbedder in an injection context. */
+function createTextEmbedder(options = {}) {
+    const embedder = new TextEmbedder({ task: 'feature-extraction', model: DEFAULT_EMBEDDING_MODEL, ...options }, inject(PIPELINE_FACTORY), inject(NGX_TRANSFORMERS_CONFIG));
+    inject(DestroyRef, { optional: true })?.onDestroy(() => void embedder.dispose());
+    return embedder;
+}
+
+/**
+ * Drop-in status line for a PipelineHandle: shows model download progress
+ * while loading, then the ready/busy/error state. Themeable via CSS custom
+ * properties (--nt-accent, --nt-ink, --nt-muted, --nt-track).
+ *
+ * ```html
+ * <ngx-model-progress [status]="classifier.status()" [progress]="classifier.progress()" />
+ * ```
+ */
+class ModelProgressComponent {
+    status = input.required(/* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "status" }] : /* istanbul ignore next */ []));
+    progress = input(null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "progress" }] : /* istanbul ignore next */ []));
+    /** Labels per status; override to localize. */
+    labels = input({}, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "labels" }] : /* istanbul ignore next */ []));
+    label = computed(() => {
+        const defaults = {
+            idle: 'Model not loaded',
+            loading: 'Downloading model',
+            ready: 'Model ready',
+            busy: 'Running',
+            error: 'Failed to load model',
+        };
+        return this.labels()[this.status()] ?? defaults[this.status()];
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: ModelProgressComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.1.5", type: ModelProgressComponent, isStandalone: true, selector: "ngx-model-progress", inputs: { status: { classPropertyName: "status", publicName: "status", isSignal: true, isRequired: true, transformFunction: null }, progress: { classPropertyName: "progress", publicName: "progress", isSignal: true, isRequired: false, transformFunction: null }, labels: { classPropertyName: "labels", publicName: "labels", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: `
+    <div class="nt-row" [class.nt-error]="status() === 'error'" role="status">
+      <span class="nt-dot" [attr.data-status]="status()"></span>
+      <span class="nt-label">{{ label() }}</span>
+      @if (status() === 'loading' && progress(); as p) {
+        <span class="nt-file">{{ p.file }}</span>
+        <div class="nt-track" role="progressbar" [attr.aria-valuenow]="p.progress" aria-valuemin="0" aria-valuemax="100">
+          <div class="nt-fill" [style.width.%]="p.progress"></div>
+        </div>
+        <span class="nt-pct">{{ p.progress }}%</span>
+      }
+    </div>
+  `, isInline: true, styles: [":host{--nt-accent: #f59e0b;--nt-ink: #1e293b;--nt-muted: #64748b;--nt-track: #e2e8f0;display:block;font-size:12.5px;color:var(--nt-ink)}.nt-row{display:flex;align-items:center;gap:8px}.nt-dot{width:8px;height:8px;border-radius:50%;flex:none;background:var(--nt-muted)}.nt-dot[data-status=loading]{background:var(--nt-accent);animation:nt-blink 1s ease-in-out infinite}.nt-dot[data-status=ready]{background:#22c55e}.nt-dot[data-status=busy]{background:#3b82f6;animation:nt-blink .7s ease-in-out infinite}.nt-dot[data-status=error]{background:#dc2626}.nt-label{font-weight:600}.nt-file{color:var(--nt-muted);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:180px}.nt-track{flex:1;min-width:60px;height:6px;border-radius:3px;background:var(--nt-track);overflow:hidden}.nt-fill{height:100%;background:var(--nt-accent);border-radius:3px;transition:width .12s linear}.nt-pct{font-variant-numeric:tabular-nums;color:var(--nt-muted)}.nt-error .nt-label{color:#dc2626}@keyframes nt-blink{0%,to{opacity:1}50%{opacity:.35}}@media(prefers-reduced-motion:reduce){.nt-dot{animation:none}.nt-fill{transition:none}}\n"], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: ModelProgressComponent, decorators: [{
+            type: Component,
+            args: [{ selector: 'ngx-model-progress', changeDetection: ChangeDetectionStrategy.OnPush, template: `
+    <div class="nt-row" [class.nt-error]="status() === 'error'" role="status">
+      <span class="nt-dot" [attr.data-status]="status()"></span>
+      <span class="nt-label">{{ label() }}</span>
+      @if (status() === 'loading' && progress(); as p) {
+        <span class="nt-file">{{ p.file }}</span>
+        <div class="nt-track" role="progressbar" [attr.aria-valuenow]="p.progress" aria-valuemin="0" aria-valuemax="100">
+          <div class="nt-fill" [style.width.%]="p.progress"></div>
+        </div>
+        <span class="nt-pct">{{ p.progress }}%</span>
+      }
+    </div>
+  `, styles: [":host{--nt-accent: #f59e0b;--nt-ink: #1e293b;--nt-muted: #64748b;--nt-track: #e2e8f0;display:block;font-size:12.5px;color:var(--nt-ink)}.nt-row{display:flex;align-items:center;gap:8px}.nt-dot{width:8px;height:8px;border-radius:50%;flex:none;background:var(--nt-muted)}.nt-dot[data-status=loading]{background:var(--nt-accent);animation:nt-blink 1s ease-in-out infinite}.nt-dot[data-status=ready]{background:#22c55e}.nt-dot[data-status=busy]{background:#3b82f6;animation:nt-blink .7s ease-in-out infinite}.nt-dot[data-status=error]{background:#dc2626}.nt-label{font-weight:600}.nt-file{color:var(--nt-muted);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:180px}.nt-track{flex:1;min-width:60px;height:6px;border-radius:3px;background:var(--nt-track);overflow:hidden}.nt-fill{height:100%;background:var(--nt-accent);border-radius:3px;transition:width .12s linear}.nt-pct{font-variant-numeric:tabular-nums;color:var(--nt-muted)}.nt-error .nt-label{color:#dc2626}@keyframes nt-blink{0%,to{opacity:1}50%{opacity:.35}}@media(prefers-reduced-motion:reduce){.nt-dot{animation:none}.nt-fill{transition:none}}\n"] }]
+        }], propDecorators: { status: [{ type: i0.Input, args: [{ isSignal: true, alias: "status", required: true }] }], progress: [{ type: i0.Input, args: [{ isSignal: true, alias: "progress", required: false }] }], labels: [{ type: i0.Input, args: [{ isSignal: true, alias: "labels", required: false }] }] } });
+
+/*
+ * Public API Surface of ngx-transformers
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { DEFAULT_EMBEDDING_MODEL, DEFAULT_TEXT_CLASSIFICATION_MODEL, ModelProgressComponent, NGX_TRANSFORMERS_CONFIG, PIPELINE_FACTORY, PipelineHandle, TextClassifier, TextEmbedder, cosineSimilarity, createPipeline, createTextClassifier, createTextEmbedder, provideTransformers };
+//# sourceMappingURL=ngx-transformers.mjs.map

package/fesm2022/ngx-transformers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngx-transformers.mjs","sources":["../../../projects/ngx-transformers/src/lib/transformers.providers.ts","../../../projects/ngx-transformers/src/lib/pipeline.ts","../../../projects/ngx-transformers/src/lib/text-classifier.ts","../../../projects/ngx-transformers/src/lib/text-embedder.ts","../../../projects/ngx-transformers/src/lib/model-progress.component.ts","../../../projects/ngx-transformers/src/public-api.ts","../../../projects/ngx-transformers/src/ngx-transformers.ts"],"sourcesContent":["import { EnvironmentProviders, InjectionToken, makeEnvironmentProviders } from '@angular/core';\nimport type { NgxTransformersConfig } from './transformers.models';\n\n/**\n * The callable returned by Transformers.js pipeline(), reduced to the\n * surface this library relies on.\n */\nexport type PipelineLike = ((input: unknown, options?: Record<string, unknown>) => Promise<unknown>) & {\n  dispose?: () => Promise<void>;\n};\n\n/**\n * Creates a pipeline for a task. The default implementation lazy-imports\n * @huggingface/transformers; tests and SSR shims can provide their own.\n */\nexport type PipelineFactory = (\n  task: string,\n  model: string | undefined,\n  options: Record<string, unknown>,\n) => Promise<PipelineLike>;\n\nconst defaultPipelineFactory: PipelineFactory = async (task, model, options) => {\n  const { pipeline } = await import('@huggingface/transformers');\n  const pipe = await (pipeline as (t: string, m?: string, o?: object) => Promise<unknown>)(\n    task,\n    model,\n    options,\n  );\n  return pipe as PipelineLike;\n};\n\nexport const PIPELINE_FACTORY = new InjectionToken<PipelineFactory>('ngx-transformers.pipeline-factory', {\n  providedIn: 'root',\n  factory: () => defaultPipelineFactory,\n});\n\nexport const NGX_TRANSFORMERS_CONFIG = new InjectionToken<NgxTransformersConfig>('ngx-transformers.config', {\n  providedIn: 'root',\n  factory: () => ({}),\n});\n\n/**\n * Sets workspace-wide defaults (device, dtype, extra pipeline options):\n *\n * ```ts\n * bootstrapApplication(App, {\n *   providers: [provideTransformers({ device: 'webgpu', dtype: 'q8' })],\n * });\n * ```\n */\nexport function provideTransformers(config: NgxTransformersConfig): EnvironmentProviders {\n  return makeEnvironmentProviders([{ provide: NGX_TRANSFORMERS_CONFIG, useValue: config }]);\n}\n","import { DestroyRef, computed, inject, signal } from '@angular/core';\nimport type { ModelProgress, NgxTransformersConfig, PipelineRequest, PipelineStatus } from './transformers.models';\nimport { NGX_TRANSFORMERS_CONFIG, PIPELINE_FACTORY, type PipelineFactory, type PipelineLike } from './transformers.providers';\n\n/** Shape of Transformers.js progress_callback events (subset we consume). */\ninterface RawProgressEvent {\n  status?: string;\n  file?: string;\n  progress?: number;\n  loaded?: number;\n  total?: number;\n}\n\n/**\n * A lazily-loaded Transformers.js pipeline wrapped in signals.\n *\n * The model is not downloaded until load() or the first run() call, so\n * creating handles is free. All state is exposed as signals and safe to\n * bind in zoneless apps.\n */\nexport class PipelineHandle<TIn = unknown, TOut = unknown> {\n  /** idle -> loading -> ready <-> busy; error only on load failure. */\n  readonly status = signal<PipelineStatus>('idle');\n  /** Download progress for the file currently transferring, else null. */\n  readonly progress = signal<ModelProgress | null>(null);\n  readonly error = signal<unknown>(null);\n  /** True once the model is usable (including while a run is in flight). */\n  readonly ready = computed(() => this.status() === 'ready' || this.status() === 'busy');\n  readonly busy = computed(() => this.status() === 'busy' || this.status() === 'loading');\n\n  private pipe: PipelineLike | null = null;\n  private loading: Promise<void> | null = null;\n\n  constructor(\n    private readonly request: PipelineRequest,\n    private readonly factory: PipelineFactory,\n    private readonly config: NgxTransformersConfig,\n  ) {}\n\n  /** Downloads and initializes the model. Idempotent; retries after error. */\n  load(): Promise<void> {\n    if (this.pipe) return Promise.resolve();\n    this.loading ??= this.doLoad().finally(() => (this.loading = null));\n    return this.loading;\n  }\n\n  /** Runs the pipeline, loading the model first if needed. */\n  async run(input: TIn, runOptions?: Record<string, unknown>): Promise<TOut> {\n    await this.load();\n    this.status.set('busy');\n    try {\n      return (await this.pipe!(input, runOptions)) as TOut;\n    } finally {\n      // A failed run leaves the model intact - back to ready either way.\n      this.status.set('ready');\n    }\n  }\n\n  /** Frees the model. The handle can be loaded again afterwards. */\n  async dispose(): Promise<void> {\n    const pipe = this.pipe;\n    this.pipe = null;\n    this.status.set('idle');\n    this.progress.set(null);\n    await pipe?.dispose?.();\n  }\n\n  private async doLoad(): Promise<void> {\n    this.status.set('loading');\n    this.error.set(null);\n    const options: Record<string, unknown> = {\n      ...this.config.pipelineOptions,\n      ...this.request.options,\n      progress_callback: (event: RawProgressEvent) => this.onProgress(event),\n    };\n    const device = this.request.device ?? this.config.device;\n    const dtype = this.request.dtype ?? this.config.dtype;\n    if (device && device !== 'auto') options['device'] = device;\n    if (dtype) options['dtype'] = dtype;\n\n    try {\n      this.pipe = await this.factory(this.request.task, this.request.model, options);\n      this.progress.set(null);\n      this.status.set('ready');\n    } catch (err) {\n      this.error.set(err);\n      this.status.set('error');\n      throw err;\n    }\n  }\n\n  private onProgress(event: RawProgressEvent): void {\n    if (event.status !== 'progress' || !event.file) return;\n    this.progress.set({\n      file: event.file,\n      progress: Math.round(event.progress ?? 0),\n      loadedBytes: event.loaded ?? 0,\n      totalBytes: event.total ?? 0,\n    });\n  }\n}\n\n/**\n * Creates a PipelineHandle in an injection context (constructor, field\n * initializer, or runInInjectionContext). The handle is disposed with the\n * surrounding component/injector.\n */\nexport function createPipeline<TIn = unknown, TOut = unknown>(request: PipelineRequest): PipelineHandle<TIn, TOut> {\n  const handle = new PipelineHandle<TIn, TOut>(\n    request,\n    inject(PIPELINE_FACTORY),\n    inject(NGX_TRANSFORMERS_CONFIG),\n  );\n  inject(DestroyRef, { optional: true })?.onDestroy(() => void handle.dispose());\n  return handle;\n}\n","import { DestroyRef, inject } from '@angular/core';\nimport { PipelineHandle } from './pipeline';\nimport type { ClassificationResult, PipelineRequest } from './transformers.models';\nimport { NGX_TRANSFORMERS_CONFIG, PIPELINE_FACTORY } from './transformers.providers';\n\nexport const DEFAULT_TEXT_CLASSIFICATION_MODEL = 'Xenova/distilbert-base-uncased-finetuned-sst-2-english';\n\n/**\n * Text classification (sentiment by default). The default model is\n * DistilBERT SST-2 (~65 MB, q8) - swap `model` for any Transformers.js\n * compatible text-classification checkpoint.\n */\nexport class TextClassifier extends PipelineHandle<string, ClassificationResult[] | ClassificationResult[][]> {\n  /** Classifies one text; resolves to labels sorted by score (top first). */\n  async classify(text: string, topK = 1): Promise<ClassificationResult[]> {\n    const out = await this.run(text, { top_k: topK });\n    // Single input: transformers.js returns a flat array of {label, score}.\n    const flat = (Array.isArray(out[0]) ? out[0] : out) as ClassificationResult[];\n    return [...flat].sort((a, b) => b.score - a.score);\n  }\n}\n\n/** Creates a TextClassifier in an injection context. */\nexport function createTextClassifier(options: Partial<Omit<PipelineRequest, 'task'>> = {}): TextClassifier {\n  const classifier = new TextClassifier(\n    { task: 'text-classification', model: DEFAULT_TEXT_CLASSIFICATION_MODEL, ...options },\n    inject(PIPELINE_FACTORY),\n    inject(NGX_TRANSFORMERS_CONFIG),\n  );\n  inject(DestroyRef, { optional: true })?.onDestroy(() => void classifier.dispose());\n  return classifier;\n}\n","import { DestroyRef, inject } from '@angular/core';\nimport { PipelineHandle } from './pipeline';\nimport type { PipelineRequest, RankedResult } from './transformers.models';\nimport { NGX_TRANSFORMERS_CONFIG, PIPELINE_FACTORY } from './transformers.providers';\n\nexport const DEFAULT_EMBEDDING_MODEL = 'Xenova/all-MiniLM-L6-v2';\n\n/** Tensor-ish output of feature-extraction: enough shape to read rows. */\ninterface TensorLike {\n  dims: number[];\n  data: ArrayLike<number>;\n  tolist?: () => number[][];\n}\n\n/** Cosine similarity of two vectors. For normalized vectors this is the dot product. */\nexport function cosineSimilarity(a: readonly number[], b: readonly number[]): number {\n  if (a.length !== b.length || a.length === 0) {\n    throw new Error(`cosineSimilarity: incompatible lengths ${a.length} and ${b.length}`);\n  }\n  let dot = 0;\n  let normA = 0;\n  let normB = 0;\n  for (let i = 0; i < a.length; i++) {\n    dot += a[i] * b[i];\n    normA += a[i] * a[i];\n    normB += b[i] * b[i];\n  }\n  const denom = Math.sqrt(normA) * Math.sqrt(normB);\n  return denom === 0 ? 0 : dot / denom;\n}\n\n/**\n * Sentence embeddings via feature-extraction (all-MiniLM-L6-v2 by default,\n * ~23 MB q8). Outputs mean-pooled, L2-normalized vectors ready for cosine\n * similarity / semantic search.\n */\nexport class TextEmbedder extends PipelineHandle<string | string[], TensorLike> {\n  /** Embeds one or many texts; always resolves to one vector per text. */\n  async embed(texts: string | string[]): Promise<number[][]> {\n    const input = Array.isArray(texts) ? texts : [texts];\n    if (input.length === 0) return [];\n    const out = await this.run(input, { pooling: 'mean', normalize: true });\n    return toRows(out);\n  }\n\n  /** Cosine similarity of two texts in [-1, 1]. */\n  async similarity(a: string, b: string): Promise<number> {\n    const [va, vb] = await this.embed([a, b]);\n    return cosineSimilarity(va, vb);\n  }\n\n  /** Ranks documents against a query, most similar first. */\n  async rank(query: string, documents: string[]): Promise<RankedResult[]> {\n    if (documents.length === 0) return [];\n    const [queryVec, ...docVecs] = await this.embed([query, ...documents]);\n    return docVecs\n      .map((vec, index) => ({ text: documents[index], score: cosineSimilarity(queryVec, vec), index }))\n      .sort((a, b) => b.score - a.score);\n  }\n}\n\nfunction toRows(out: TensorLike): number[][] {\n  if (typeof out.tolist === 'function') return out.tolist();\n  const [rows, cols] = out.dims.length === 2 ? out.dims : [1, out.dims[out.dims.length - 1]];\n  const data = out.data;\n  const result: number[][] = [];\n  for (let r = 0; r < rows; r++) {\n    result.push(Array.from({ length: cols }, (_, c) => data[r * cols + c]));\n  }\n  return result;\n}\n\n/** Creates a TextEmbedder in an injection context. */\nexport function createTextEmbedder(options: Partial<Omit<PipelineRequest, 'task'>> = {}): TextEmbedder {\n  const embedder = new TextEmbedder(\n    { task: 'feature-extraction', model: DEFAULT_EMBEDDING_MODEL, ...options },\n    inject(PIPELINE_FACTORY),\n    inject(NGX_TRANSFORMERS_CONFIG),\n  );\n  inject(DestroyRef, { optional: true })?.onDestroy(() => void embedder.dispose());\n  return embedder;\n}\n","import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';\nimport type { ModelProgress, PipelineStatus } from './transformers.models';\n\n/**\n * Drop-in status line for a PipelineHandle: shows model download progress\n * while loading, then the ready/busy/error state. Themeable via CSS custom\n * properties (--nt-accent, --nt-ink, --nt-muted, --nt-track).\n *\n * ```html\n * <ngx-model-progress [status]=\"classifier.status()\" [progress]=\"classifier.progress()\" />\n * ```\n */\n@Component({\n  selector: 'ngx-model-progress',\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  template: `\n    <div class=\"nt-row\" [class.nt-error]=\"status() === 'error'\" role=\"status\">\n      <span class=\"nt-dot\" [attr.data-status]=\"status()\"></span>\n      <span class=\"nt-label\">{{ label() }}</span>\n      @if (status() === 'loading' && progress(); as p) {\n        <span class=\"nt-file\">{{ p.file }}</span>\n        <div class=\"nt-track\" role=\"progressbar\" [attr.aria-valuenow]=\"p.progress\" aria-valuemin=\"0\" aria-valuemax=\"100\">\n          <div class=\"nt-fill\" [style.width.%]=\"p.progress\"></div>\n        </div>\n        <span class=\"nt-pct\">{{ p.progress }}%</span>\n      }\n    </div>\n  `,\n  styles: `\n    :host {\n      --nt-accent: #f59e0b;\n      --nt-ink: #1e293b;\n      --nt-muted: #64748b;\n      --nt-track: #e2e8f0;\n      display: block;\n      font-size: 12.5px;\n      color: var(--nt-ink);\n    }\n    .nt-row { display: flex; align-items: center; gap: 8px; }\n    .nt-dot {\n      width: 8px; height: 8px; border-radius: 50%; flex: none;\n      background: var(--nt-muted);\n    }\n    .nt-dot[data-status='loading'] { background: var(--nt-accent); animation: nt-blink 1s ease-in-out infinite; }\n    .nt-dot[data-status='ready'] { background: #22c55e; }\n    .nt-dot[data-status='busy'] { background: #3b82f6; animation: nt-blink 0.7s ease-in-out infinite; }\n    .nt-dot[data-status='error'] { background: #dc2626; }\n    .nt-label { font-weight: 600; }\n    .nt-file { color: var(--nt-muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; max-width: 180px; }\n    .nt-track {\n      flex: 1; min-width: 60px; height: 6px; border-radius: 3px;\n      background: var(--nt-track); overflow: hidden;\n    }\n    .nt-fill { height: 100%; background: var(--nt-accent); border-radius: 3px; transition: width 120ms linear; }\n    .nt-pct { font-variant-numeric: tabular-nums; color: var(--nt-muted); }\n    .nt-error .nt-label { color: #dc2626; }\n    @keyframes nt-blink { 0%, 100% { opacity: 1; } 50% { opacity: 0.35; } }\n    @media (prefers-reduced-motion: reduce) {\n      .nt-dot { animation: none; }\n      .nt-fill { transition: none; }\n    }\n  `,\n})\nexport class ModelProgressComponent {\n  status = input.required<PipelineStatus>();\n  progress = input<ModelProgress | null>(null);\n  /** Labels per status; override to localize. */\n  labels = input<Partial<Record<PipelineStatus, string>>>({});\n\n  readonly label = computed(() => {\n    const defaults: Record<PipelineStatus, string> = {\n      idle: 'Model not loaded',\n      loading: 'Downloading model',\n      ready: 'Model ready',\n      busy: 'Running',\n      error: 'Failed to load model',\n    };\n    return this.labels()[this.status()] ?? defaults[this.status()];\n  });\n}\n","/*\n * Public API Surface of ngx-transformers\n */\n\nexport * from './lib/transformers.models';\nexport * from './lib/transformers.providers';\nexport * from './lib/pipeline';\nexport * from './lib/text-classifier';\nexport * from './lib/text-embedder';\nexport * from './lib/model-progress.component';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "ngx-transformers",
+  "version": "0.1.0",
+  "description": "Run Hugging Face Transformers.js models in Angular - on-device ML with a signals API: text classification, embeddings, semantic similarity. No server, no API key.",
+  "keywords": [
+    "angular",
+    "transformers",
+    "transformers.js",
+    "machine-learning",
+    "onnx",
+    "webgpu",
+    "wasm",
+    "huggingface",
+    "embeddings",
+    "sentiment-analysis",
+    "on-device",
+    "signals"
+  ],
+  "license": "MIT",
+  "author": "Muzaffar Qosimov",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/qwertymuzaffar/ngx-transformers.git"
+  },
+  "peerDependencies": {
+    "@angular/common": "^22.1.0",
+    "@angular/core": "^22.1.0",
+    "@huggingface/transformers": "^4.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/ngx-transformers.mjs",
+  "typings": "types/ngx-transformers.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/ngx-transformers.d.ts",
+      "default": "./fesm2022/ngx-transformers.mjs"
+    }
+  },
+  "type": "module"
+}

package/types/ngx-transformers.d.ts

@@ -0,0 +1,167 @@
+import * as _angular_core from '@angular/core';
+import { InjectionToken, EnvironmentProviders } from '@angular/core';
+
+/** Lifecycle of a model pipeline. `error` is terminal until load() is retried. */
+type PipelineStatus = 'idle' | 'loading' | 'ready' | 'busy' | 'error';
+/** Download progress for one model file, mapped from Transformers.js callbacks. */
+interface ModelProgress {
+    /** File currently downloading, e.g. "onnx/model_quantized.onnx". */
+    file: string;
+    /** 0-100 for the current file. */
+    progress: number;
+    loadedBytes: number;
+    totalBytes: number;
+}
+type TransformersDevice = 'wasm' | 'webgpu' | 'auto';
+type TransformersDtype = 'fp32' | 'fp16' | 'q8' | 'q4';
+/** Global defaults applied to every pipeline; see provideTransformers(). */
+interface NgxTransformersConfig {
+    device?: TransformersDevice;
+    dtype?: TransformersDtype;
+    /** Extra options forwarded verbatim to every pipeline() call. */
+    pipelineOptions?: Record<string, unknown>;
+}
+/** Per-pipeline request; wins over the global config where both are set. */
+interface PipelineRequest {
+    task: string;
+    /** Hugging Face model id; each task wrapper provides a sensible default. */
+    model?: string;
+    device?: TransformersDevice;
+    dtype?: TransformersDtype;
+    options?: Record<string, unknown>;
+}
+interface ClassificationResult {
+    label: string;
+    score: number;
+}
+/** One scored document from TextEmbedder.rank(). */
+interface RankedResult {
+    text: string;
+    /** Cosine similarity in [-1, 1]; higher is more similar. */
+    score: number;
+    /** Index of the document in the input list. */
+    index: number;
+}
+
+/**
+ * The callable returned by Transformers.js pipeline(), reduced to the
+ * surface this library relies on.
+ */
+type PipelineLike = ((input: unknown, options?: Record<string, unknown>) => Promise<unknown>) & {
+    dispose?: () => Promise<void>;
+};
+/**
+ * Creates a pipeline for a task. The default implementation lazy-imports
+ * @huggingface/transformers; tests and SSR shims can provide their own.
+ */
+type PipelineFactory = (task: string, model: string | undefined, options: Record<string, unknown>) => Promise<PipelineLike>;
+declare const PIPELINE_FACTORY: InjectionToken<PipelineFactory>;
+declare const NGX_TRANSFORMERS_CONFIG: InjectionToken<NgxTransformersConfig>;
+/**
+ * Sets workspace-wide defaults (device, dtype, extra pipeline options):
+ *
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideTransformers({ device: 'webgpu', dtype: 'q8' })],
+ * });
+ * ```
+ */
+declare function provideTransformers(config: NgxTransformersConfig): EnvironmentProviders;
+
+/**
+ * A lazily-loaded Transformers.js pipeline wrapped in signals.
+ *
+ * The model is not downloaded until load() or the first run() call, so
+ * creating handles is free. All state is exposed as signals and safe to
+ * bind in zoneless apps.
+ */
+declare class PipelineHandle<TIn = unknown, TOut = unknown> {
+    private readonly request;
+    private readonly factory;
+    private readonly config;
+    /** idle -> loading -> ready <-> busy; error only on load failure. */
+    readonly status: _angular_core.WritableSignal<PipelineStatus>;
+    /** Download progress for the file currently transferring, else null. */
+    readonly progress: _angular_core.WritableSignal<ModelProgress | null>;
+    readonly error: _angular_core.WritableSignal<unknown>;
+    /** True once the model is usable (including while a run is in flight). */
+    readonly ready: _angular_core.Signal<boolean>;
+    readonly busy: _angular_core.Signal<boolean>;
+    private pipe;
+    private loading;
+    constructor(request: PipelineRequest, factory: PipelineFactory, config: NgxTransformersConfig);
+    /** Downloads and initializes the model. Idempotent; retries after error. */
+    load(): Promise<void>;
+    /** Runs the pipeline, loading the model first if needed. */
+    run(input: TIn, runOptions?: Record<string, unknown>): Promise<TOut>;
+    /** Frees the model. The handle can be loaded again afterwards. */
+    dispose(): Promise<void>;
+    private doLoad;
+    private onProgress;
+}
+/**
+ * Creates a PipelineHandle in an injection context (constructor, field
+ * initializer, or runInInjectionContext). The handle is disposed with the
+ * surrounding component/injector.
+ */
+declare function createPipeline<TIn = unknown, TOut = unknown>(request: PipelineRequest): PipelineHandle<TIn, TOut>;
+
+declare const DEFAULT_TEXT_CLASSIFICATION_MODEL = "Xenova/distilbert-base-uncased-finetuned-sst-2-english";
+/**
+ * Text classification (sentiment by default). The default model is
+ * DistilBERT SST-2 (~65 MB, q8) - swap `model` for any Transformers.js
+ * compatible text-classification checkpoint.
+ */
+declare class TextClassifier extends PipelineHandle<string, ClassificationResult[] | ClassificationResult[][]> {
+    /** Classifies one text; resolves to labels sorted by score (top first). */
+    classify(text: string, topK?: number): Promise<ClassificationResult[]>;
+}
+/** Creates a TextClassifier in an injection context. */
+declare function createTextClassifier(options?: Partial<Omit<PipelineRequest, 'task'>>): TextClassifier;
+
+declare const DEFAULT_EMBEDDING_MODEL = "Xenova/all-MiniLM-L6-v2";
+/** Tensor-ish output of feature-extraction: enough shape to read rows. */
+interface TensorLike {
+    dims: number[];
+    data: ArrayLike<number>;
+    tolist?: () => number[][];
+}
+/** Cosine similarity of two vectors. For normalized vectors this is the dot product. */
+declare function cosineSimilarity(a: readonly number[], b: readonly number[]): number;
+/**
+ * Sentence embeddings via feature-extraction (all-MiniLM-L6-v2 by default,
+ * ~23 MB q8). Outputs mean-pooled, L2-normalized vectors ready for cosine
+ * similarity / semantic search.
+ */
+declare class TextEmbedder extends PipelineHandle<string | string[], TensorLike> {
+    /** Embeds one or many texts; always resolves to one vector per text. */
+    embed(texts: string | string[]): Promise<number[][]>;
+    /** Cosine similarity of two texts in [-1, 1]. */
+    similarity(a: string, b: string): Promise<number>;
+    /** Ranks documents against a query, most similar first. */
+    rank(query: string, documents: string[]): Promise<RankedResult[]>;
+}
+/** Creates a TextEmbedder in an injection context. */
+declare function createTextEmbedder(options?: Partial<Omit<PipelineRequest, 'task'>>): TextEmbedder;
+
+/**
+ * Drop-in status line for a PipelineHandle: shows model download progress
+ * while loading, then the ready/busy/error state. Themeable via CSS custom
+ * properties (--nt-accent, --nt-ink, --nt-muted, --nt-track).
+ *
+ * ```html
+ * <ngx-model-progress [status]="classifier.status()" [progress]="classifier.progress()" />
+ * ```
+ */
+declare class ModelProgressComponent {
+    status: _angular_core.InputSignal<PipelineStatus>;
+    progress: _angular_core.InputSignal<ModelProgress | null>;
+    /** Labels per status; override to localize. */
+    labels: _angular_core.InputSignal<Partial<Record<PipelineStatus, string>>>;
+    readonly label: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModelProgressComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModelProgressComponent, "ngx-model-progress", never, { "status": { "alias": "status"; "required": true; "isSignal": true; }; "progress": { "alias": "progress"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { DEFAULT_EMBEDDING_MODEL, DEFAULT_TEXT_CLASSIFICATION_MODEL, ModelProgressComponent, NGX_TRANSFORMERS_CONFIG, PIPELINE_FACTORY, PipelineHandle, TextClassifier, TextEmbedder, cosineSimilarity, createPipeline, createTextClassifier, createTextEmbedder, provideTransformers };
+export type { ClassificationResult, ModelProgress, NgxTransformersConfig, PipelineFactory, PipelineLike, PipelineRequest, PipelineStatus, RankedResult, TransformersDevice, TransformersDtype };