@supersoniks/concorde 4.9.96 → 4.9.98-visual-stack.0

package/dist/types/core/components/functional/infer/hugging-face/hf-controller.d.ts

@@ -0,0 +1,79 @@
+import { type PublisherPathInput } from "@supersoniks/concorde/core/utils/dataProviderKey";
+import type { HfLoadPolicy, HfTrigger } from "./hf-config";
+import { type HfTextExtractor } from "./hf-input";
+import type { HfErrorCode, HfProgress } from "./hf-protocol";
+import { type HuggingFaceRegistry } from "./hf-registry";
+import { type HfDevice, type HfTask } from "./types";
+export type HfInferState = "idle" | "empty" | "awaiting-consent" | "declined" | "downloading" | "loading" | "ready" | "running" | "done" | "invalid-input" | "error" | "unsupported";
+export type HfInferStatus = {
+    state: HfInferState;
+    model: {
+        alias: string;
+        task: HfTask;
+        repo: string;
+        revision: string;
+        label?: string;
+        description?: string;
+    };
+    /** Connue AVANT le téléchargement ; `fromCache` = rien à télécharger. */
+    size: {
+        totalBytes: number | null;
+        /** Arrondi, pour l'affichage (« 118 Mo »). */
+        totalMB: number | null;
+        fromCache: boolean;
+    };
+    progress?: HfProgress;
+    backend?: HfDevice;
+    persisted?: boolean;
+    /** Éléments d'entrée ignorés (sortie alignée : `null` à leur place). */
+    skipped?: number;
+    warnings?: string[];
+    timings?: {
+        loadMs?: number;
+        lastRunMs?: number;
+    };
+    /** Vrai quand le résultat vient du cache (mémoire ou IndexedDB). */
+    fromResultsCache?: boolean;
+    error?: {
+        code: HfErrorCode | "invalid-input" | "too-large";
+        message: string;
+    };
+};
+export type HfInferControllerOptions = {
+    model: string;
+    input: PublisherPathInput;
+    output: PublisherPathInput;
+    status?: PublisherPathInput;
+    /** Mode `demand` : chaque changement de valeur de ce DataProvider lance un calcul. */
+    triggerProvider?: PublisherPathInput;
+    /** Valeur vraie (`true`, `"accepted"`) = consentement donné ; `"declined"` = refus. */
+    consentProvider?: PublisherPathInput;
+    text?: HfTextExtractor;
+    call?: Record<string, unknown>;
+    /** Les options viennent d'un attribut / descripteur SDUI : validation stricte. */
+    untrusted?: boolean;
+    load?: HfLoadPolicy;
+    trigger?: HfTrigger;
+    debounceMs?: number;
+    emptyValue?: unknown;
+    onInvalid?: "keep" | "clear";
+    maxItems?: number;
+    maxChars?: number;
+    timeoutMs?: number;
+    persistResults?: boolean;
+    resultsTtlMs?: number;
+    /** Politique `visible` : résout quand l'élément est à l'écran. */
+    whenVisible?: () => Promise<void>;
+};
+export type HfInferHandle = {
+    /** Arrête les abonnements (le modèle reste chargé pour les autres instances). */
+    stop(): void;
+    /** Calcule maintenant sur l'entrée courante (mode `demand`). */
+    run(): Promise<void>;
+    /** Charge le modèle maintenant (politique `manual`, ou préchargement). */
+    load(): Promise<void>;
+    accept(): void;
+    decline(): void;
+};
+export declare function createHfInferController(options: HfInferControllerOptions, registryOverride?: HuggingFaceRegistry): HfInferHandle;
+//# sourceMappingURL=hf-controller.d.ts.map

package/dist/types/core/components/functional/infer/hugging-face/hf-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf-controller.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/components/functional/infer/hugging-face/hf-controller.ts"],"names":[],"mappings":"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"}

package/dist/types/core/components/functional/infer/hugging-face/hf-engine.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Moteur d'inférence vu du thread principal.
+ *
+ * `HfEngine` est l'interface ; `HfWorkerEngine` la réalise avec un Web Worker
+ * (le seul endroit où Transformers.js est chargé). Les tests, ou une
+ * application qui veut son propre transport, peuvent fournir un autre moteur.
+ */
+import type { HfErrorCode, HfInspectResult, HfLoadResult, HfModelRef, HfProgress, HfRunRequest, HfWorkerEnv } from "./hf-protocol";
+import type { HfDevice } from "./types";
+export interface HfEngine {
+    configure(env: HfWorkerEnv): Promise<void>;
+    inspect(model: HfModelRef): Promise<HfInspectResult>;
+    load(model: HfModelRef, devices: HfDevice[], onProgress: (progress: HfProgress) => void): Promise<HfLoadResult>;
+    run(request: HfRunRequest): Promise<unknown[]>;
+    clear(model?: HfModelRef): Promise<void>;
+    dispose(): void;
+}
+export declare class HfEngineError extends Error {
+    readonly code: HfErrorCode;
+    constructor(code: HfErrorCode, message: string);
+}
+export declare class HfWorkerEngine implements HfEngine {
+    private readonly createWorker;
+    private worker;
+    private nextId;
+    private readonly pending;
+    private readonly progressListeners;
+    private fatal;
+    constructor(createWorker: () => Worker);
+    /** Worker « blob » qui importe Transformers.js depuis une URL figée. */
+    static fromUrl(libraryUrl: string): HfWorkerEngine;
+    private ensureWorker;
+    private onMessage;
+    private failAll;
+    private request;
+    configure(env: HfWorkerEnv): Promise<void>;
+    inspect(model: HfModelRef): Promise<HfInspectResult>;
+    load(model: HfModelRef, devices: HfDevice[], onProgress: (progress: HfProgress) => void): Promise<HfLoadResult>;
+    run(request: HfRunRequest): Promise<unknown[]>;
+    clear(model?: HfModelRef): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=hf-engine.d.ts.map

package/dist/types/core/components/functional/infer/hugging-face/hf-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf-engine.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/components/functional/infer/hugging-face/hf-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,YAAY,EACZ,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EAGZ,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACrD,IAAI,CACF,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,QAAQ,EAAE,EACnB,UAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,KAAK,IAAI,GACzC,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,KAAK,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,qBAAa,aAAc,SAAQ,KAAK;aAEpB,IAAI,EAAE,WAAW;gBAAjB,IAAI,EAAE,WAAW,EACjC,OAAO,EAAE,MAAM;CAKlB;AAaD,qBAAa,cAAe,YAAW,QAAQ;IAUjC,OAAO,CAAC,QAAQ,CAAC,YAAY;IATzC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAG9B;IACJ,OAAO,CAAC,KAAK,CAA8B;gBAEd,YAAY,EAAE,MAAM,MAAM;IAEvD,wEAAwE;IACxE,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc;IAiBlD,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,SAAS;IAgBjB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,OAAO;IAiBT,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC;IAI9C,IAAI,CACR,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,QAAQ,EAAE,EACnB,UAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,KAAK,IAAI,GACzC,OAAO,CAAC,YAAY,CAAC;IASxB,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIxC,KAAK,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,OAAO,IAAI,IAAI;CAKhB"}

package/dist/types/core/components/functional/infer/hugging-face/hf-input.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Normalisation et validation des entrées, AVANT tout téléchargement ou calcul.
+ *
+ * Règles :
+ * - absente / vide → `empty` (pas d'erreur, rien n'est chargé) ;
+ * - mauvais type → `invalid` avec un message précis, pas de coercition silencieuse ;
+ * - liste partiellement valide → les éléments inexploitables deviennent `null`
+ *   à leur position (la sortie reste alignée sur l'entrée) ;
+ * - trop grosse → `invalid` (`too-large`) ; texte trop long → tronqué + averti.
+ */
+import type { HfInputKind } from "./types";
+/** Chemins pointés séparés par `+` (`"label + edito.sub_title"`), liste de chemins, ou fonction. */
+export type HfTextExtractor<Item = unknown> = string | readonly string[] | ((item: Item) => string | null | undefined);
+export type HfNormalizeOptions = {
+    kind: HfInputKind;
+    text?: HfTextExtractor;
+    maxItems: number;
+    maxChars: number;
+};
+export type HfNormalizedInput = {
+    kind: "empty";
+} | {
+    kind: "invalid";
+    code: "invalid-input" | "too-large";
+    message: string;
+} | {
+    kind: "ok";
+    /** L'entrée était une liste : la sortie sera une liste alignée. */
+    many: boolean;
+    /** Longueur de l'entrée d'origine. */
+    length: number;
+    /** Charges utiles valides, dans l'ordre. */
+    payloads: unknown[];
+    /** Position d'origine de chaque charge utile valide. */
+    positions: number[];
+    skipped: number;
+    truncated: number;
+    warnings: string[];
+};
+/** Compile un extracteur de texte (chemins pointés) une fois pour toutes. */
+export declare function compileTextExtractor(text: HfTextExtractor | undefined): ((item: unknown) => string | null) | null;
+export declare function normalizeInput(value: unknown, options: HfNormalizeOptions): HfNormalizedInput;
+/** Replace les résultats à leur position d'origine (`null` pour les éléments ignorés). */
+export declare function realign<T>(input: Extract<HfNormalizedInput, {
+    kind: "ok";
+}>, results: T[]): (T | null)[];
+//# sourceMappingURL=hf-input.d.ts.map

package/dist/types/core/components/functional/infer/hugging-face/hf-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf-input.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/components/functional/infer/hugging-face/hf-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,oGAAoG;AACpG,MAAM,MAAM,eAAe,CAAC,IAAI,GAAG,OAAO,IACtC,MAAM,GACN,SAAS,MAAM,EAAE,GACjB,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEhD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzE;IACE,IAAI,EAAE,IAAI,CAAC;IACX,mEAAmE;IACnE,IAAI,EAAE,OAAO,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,wDAAwD;IACxD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAUN,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,GAAG,SAAS,GAChC,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAkC3C;AA2DD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,kBAAkB,GAC1B,iBAAiB,CAuDnB;AAED,0FAA0F;AAC1F,wBAAgB,OAAO,CAAC,CAAC,EACvB,KAAK,EAAE,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,EACjD,OAAO,EAAE,CAAC,EAAE,GACX,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAMd"}

package/dist/types/core/components/functional/infer/hugging-face/hf-protocol.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Protocole entre le thread principal et le worker qui exécute Transformers.js.
+ * Uniquement des données sérialisables (structured clone).
+ */
+import type { HfDevice, HfLoadOptions, HfTask } from "./types";
+export type HfWorkerEnv = {
+    /** Hôte des modèles (CDN Supersoniks, ou le Hub par défaut). */
+    remoteHost?: string;
+    remotePathTemplate?: string;
+    /** Clé du cache navigateur (Cache API) des modèles et du WASM. */
+    cacheKey: string;
+    /** Emplacement des binaires ONNX Runtime (`.wasm` / `.mjs`) de la version figée. */
+    wasmPaths?: string | {
+        mjs: string;
+        wasm: string;
+    };
+    logLevel?: "error" | "warning" | "info" | "debug";
+};
+export type HfModelRef = {
+    alias: string;
+    task: HfTask;
+    repo: string;
+    revision: string;
+    options: HfLoadOptions;
+};
+export type HfInspectResult = {
+    /** Taille totale à télécharger (octets) si le serveur la donne. */
+    totalBytes: number | null;
+    cached: boolean;
+};
+export type HfLoadResult = {
+    backend: HfDevice;
+    loadMs: number;
+};
+export type HfProgress = {
+    file?: string;
+    loadedBytes: number;
+    totalBytes: number;
+    percent: number;
+};
+export type HfRunRequest = {
+    alias: string;
+    /** Entrées valides uniquement (le thread principal réaligne ensuite). */
+    inputs: unknown[];
+    call: Record<string, unknown>;
+    /** Nom de l'argument positionnel à extraire de `call` (`candidate_labels`, `context`). */
+    positional?: string;
+    /** Regrouper les entrées en un seul appel (embeddings de textes). */
+    batch: boolean;
+};
+export type HfErrorCode = "unsupported" | "network" | "quota" | "timeout" | "not-allowed" | "runtime" | "declined";
+export type HfWorkerRequest = {
+    id: number;
+    type: "configure";
+    env: HfWorkerEnv;
+} | {
+    id: number;
+    type: "inspect";
+    model: HfModelRef;
+} | {
+    id: number;
+    type: "load";
+    model: HfModelRef;
+    devices: HfDevice[];
+} | {
+    id: number;
+    type: "run";
+    request: HfRunRequest;
+} | {
+    id: number;
+    type: "clear";
+    model?: HfModelRef;
+};
+export type HfWorkerResponse = {
+    id: number;
+    ok: true;
+    result: unknown;
+} | {
+    id: number;
+    ok: false;
+    error: {
+        code: HfErrorCode;
+        message: string;
+    };
+} | {
+    type: "progress";
+    alias: string;
+    progress: HfProgress;
+}
+/** Le worker n'a pas pu démarrer (moteur introuvable, CSP…). */
+ | {
+    type: "fatal";
+    message: string;
+};
+//# sourceMappingURL=hf-protocol.d.ts.map

package/dist/types/core/components/functional/infer/hugging-face/hf-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf-protocol.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/components/functional/infer/hugging-face/hf-protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,MAAM,WAAW,GAAG;IACxB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,mEAAmE;IACnE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GACnB,aAAa,GACb,SAAS,GACT,OAAO,GACP,SAAS,GACT,aAAa,GACb,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAClD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,QAAQ,EAAE,CAAA;CAAE,GACpE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,GAClD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAA;CAAE;AAC3D,gEAAgE;GAC9D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/core/components/functional/infer/hugging-face/hf-registry.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Registre des modèles (thread principal, un seul par page).
+ *
+ * - un seul chargement par alias, partagé par toutes les instances ;
+ * - taille et présence en cache connues AVANT téléchargement ;
+ * - consentement (mémorisé par alias + révision, révocable) ;
+ * - garde-fous : économie de données, réseau lent, gros modèle, quota ;
+ * - choix WebGPU / WASM selon le plafond `allowWasmUpToMB`.
+ */
+import { type HfLoadPolicy, type HfResolvedConfig } from "./hf-config";
+import type { HfErrorCode, HfModelRef, HfProgress, HfRunRequest } from "./hf-protocol";
+import type { HfDevice } from "./types";
+export type HfModelPhase = "idle" | "checking" | "awaiting-consent" | "declined" | "downloading" | "loading" | "ready" | "error" | "unsupported";
+export type HfModelState = {
+    phase: HfModelPhase;
+    /** Connue avant téléchargement (serveur, sinon `sizeBytes` déclarée). */
+    size: {
+        totalBytes: number | null;
+        fromCache: boolean;
+    } | null;
+    progress?: HfProgress;
+    backend?: HfDevice;
+    persisted?: boolean;
+    loadMs?: number;
+    error?: {
+        code: HfErrorCode;
+        message: string;
+    };
+};
+export declare class HfError extends Error {
+    readonly code: HfErrorCode;
+    constructor(code: HfErrorCode, message: string);
+}
+export declare class HuggingFaceRegistry {
+    private config;
+    private readonly entries;
+    private engine;
+    private configured;
+    constructor(config: HfResolvedConfig);
+    get resolvedConfig(): HfResolvedConfig;
+    private getEngine;
+    private ready;
+    dispose(): void;
+    hasModel(alias: string): boolean;
+    model(alias: string): HfModelRef & {
+        devices: readonly HfDevice[];
+        sizeBytes?: number;
+        label?: string;
+        description?: string;
+        defaults?: Record<string, unknown>;
+    };
+    private entry;
+    state(alias: string): HfModelState;
+    subscribe(alias: string, listener: (state: HfModelState) => void): () => void;
+    private update;
+    /** Taille et présence en cache, sans rien télécharger d'autre que des en-têtes. */
+    inspect(alias: string): Promise<HfModelState["size"]>;
+    private consentKey;
+    storedConsent(alias: string): "accepted" | "declined" | null;
+    accept(alias: string): void;
+    decline(alias: string): void;
+    revokeConsent(alias: string): void;
+    private askConsent;
+    /**
+     * Charge le modèle selon la politique. Résout quand il est prêt ; rejette
+     * (`HfError`) si refusé, non supporté, quota insuffisant ou erreur.
+     * `policy = "manual"` signifie « appel explicite » : pas de demande de consentement.
+     */
+    ensureLoaded(alias: string, policy: HfLoadPolicy): Promise<void>;
+    private load;
+    run(request: HfRunRequest, timeoutMs: number): Promise<unknown[]>;
+    clearModel(alias: string): Promise<void>;
+    clearAll(): Promise<void>;
+}
+/** Registre de la page (null tant que `configureHuggingFace` n'a pas été appelé). */
+export declare function getHuggingFaceRegistry(): HuggingFaceRegistry | null;
+//# sourceMappingURL=hf-registry.d.ts.map

package/dist/types/core/components/functional/infer/hugging-face/hf-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf-registry.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/components/functional/infer/hugging-face/hf-registry.ts"],"names":[],"mappings":"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"}