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

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * Code exécuté DANS le worker. C'est le seul endroit qui touche Transformers.js.
+ *
+ * `hfWorkerMain` est volontairement autonome (aucune référence à un import ni
+ * à une variable extérieure) : il est sérialisé tel quel (`toString()`) pour
+ * construire le worker « blob » du mode `cdn`. Ne pas y utiliser d'import,
+ * de helper externe ni de variable de module.
+ *
+ * Pour un worker construit par l'application (mode `worker`), utiliser
+ * `serveHuggingFaceWorker` :
+ *
+ * ```ts
+ * // hf.worker.ts (dans l'application)
+ * import * as transformers from "@huggingface/transformers";
+ * import { serveHuggingFaceWorker } from "@supersoniks/concorde/core/components/functional/infer/hugging-face/hf-worker-runtime";
+ * serveHuggingFaceWorker(transformers);
+ * ```
+ */
+/** Sous-ensemble de Transformers.js utilisé par le worker (typage structurel, sans import). */
+export type HfLibrary = {
+    pipeline: (task: string, model: string, options?: Record<string, unknown>) => Promise<unknown>;
+    env: Record<string, unknown> & {
+        backends?: {
+            onnx?: {
+                wasm?: Record<string, unknown>;
+            };
+        };
+    };
+    ModelRegistry?: {
+        get_pipeline_files?: (task: string, model: string, options?: Record<string, unknown>) => Promise<string[]>;
+        get_file_metadata?: (model: string, file: string, options?: Record<string, unknown>) => Promise<{
+            exists: boolean;
+            size?: number;
+            fromCache?: boolean;
+        }>;
+        is_pipeline_cached?: (task: string, model: string, options?: Record<string, unknown>) => Promise<boolean>;
+        clear_pipeline_cache?: (task: string, model: string, options?: Record<string, unknown>) => Promise<unknown>;
+    };
+    LogLevel?: Record<string, unknown>;
+};
+/** Portée minimale d'un worker (évite de dépendre de la lib TS « webworker »). */
+export type HfWorkerScope = {
+    postMessage: (message: unknown, transfer?: Transferable[]) => void;
+    addEventListener: (type: "message", listener: (event: {
+        data: unknown;
+    }) => void) => void;
+};
+export declare function hfWorkerMain(lib: HfLibrary, scope: HfWorkerScope): void;
+/** À appeler dans un worker construit par l'application (mode `runtime.source = "worker"`). */
+export declare function serveHuggingFaceWorker(lib: HfLibrary): void;
+/**
+ * Source d'un worker module autonome qui importe Transformers.js depuis une
+ * URL figée (mode `runtime.source = "cdn"`).
+ */
+export declare function buildHfWorkerSource(libraryUrl: string): string;
+//# sourceMappingURL=hf-worker-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hf-worker-runtime.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/components/functional/infer/hugging-face/hf-worker-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,+FAA+F;AAC/F,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAC7B,QAAQ,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE;gBAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;aAAE,CAAA;SAAE,CAAC;KAC1D,CAAC;IACF,aAAa,CAAC,EAAE;QACd,kBAAkB,CAAC,EAAE,CACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACvB,iBAAiB,CAAC,EAAE,CAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC;YAAE,MAAM,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACtE,kBAAkB,CAAC,EAAE,CACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC,OAAO,CAAC,CAAC;QACtB,oBAAoB,CAAC,EAAE,CACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC,OAAO,CAAC,CAAC;KACvB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IACnE,gBAAgB,EAAE,CAChB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,KACzC,IAAI,CAAC;CACX,CAAC;AAGF,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAyRvE;AAGD,+FAA+F;AAC/F,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAuB9D"}

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

@@ -0,0 +1,67 @@
+import { LitElement } from "lit";
+import { type HfLoadPolicy, type HfTrigger } from "./hf-config";
+type ElementOptions = {
+    /** Champs à concaténer quand l'entrée est une liste d'objets : `"label + edito.sub_title"`. */
+    text?: string | string[];
+    /** Options d'appel du pipeline (validées selon la tâche du modèle). */
+    call?: Record<string, unknown>;
+};
+/**
+ * `sonic-hugging-face-infer` : 1 entrée → modèle Hugging Face (Transformers.js,
+ * dans un worker) → 1 sortie (readonly).
+ *
+ * Le composant ne contient pas le moteur : Transformers.js n'est chargé qu'au
+ * premier besoin, dans un worker, depuis une version figée (voir
+ * `configureHuggingFace`). Le modèle doit figurer dans la liste blanche de
+ * l'application (attribut `model` = alias).
+ */
+export default class SonicHuggingFaceInfer extends LitElement {
+    static styles: import("lit").CSSResult[];
+    /** Alias du modèle (liste blanche de l'application). */
+    model: string;
+    /** DataProvider d'entrée : texte, liste de textes, liste d'objets (+ `options.text`), image, audio. */
+    inputProvider: string;
+    /** DataProvider de sortie (readonly). */
+    outputProvider: string;
+    /** DataProvider optionnel où publier le statut détaillé (taille, progression, backend…). */
+    statusProvider: string;
+    /** Mode `demand` : chaque changement de ce DataProvider lance un calcul. */
+    triggerProvider: string;
+    /** DataProvider (ex. case à cocher d'un formulaire) qui donne le consentement. */
+    consentProvider: string;
+    /** `{"text": …, "call": {…}}` */
+    options: ElementOptions | null;
+    /** `auto` | `idle` | `visible` | `first-use` | `consent` | `manual` */
+    load: HfLoadPolicy | "";
+    /** `mutation` | `demand` */
+    trigger: HfTrigger | "";
+    debounce: number | null;
+    /** Valeur publiée quand l'entrée est vide (JSON). Défaut : `null`. */
+    emptyValue: unknown;
+    /** Entrée invalide : garder le dernier résultat (`keep`) ou vider (`clear`). */
+    onInvalid: "keep" | "clear";
+    maxItems: number | null;
+    maxChars: number | null;
+    timeoutMs: number | null;
+    /** Mémoriser les résultats en IndexedDB (ex. embeddings d'un catalogue stable). */
+    persistResults: boolean;
+    /** Durée de validité des résultats mémorisés (ms). */
+    resultsTtl: number | null;
+    private handle;
+    private offConfig;
+    private visible;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(changed: Map<string | number | symbol, unknown>): void;
+    /** Calcule maintenant sur l'entrée courante. */
+    run(): Promise<void>;
+    /** Charge le modèle maintenant. */
+    loadModel(): Promise<void>;
+    accept(): void;
+    decline(): void;
+    private whenVisible;
+    private restart;
+    render(): import("lit-html").TemplateResult<1>;
+}
+export {};
+//# sourceMappingURL=hugging-face-infer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hugging-face-infer.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/components/functional/infer/hugging-face/hugging-face-infer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,MAAM,KAAK,CAAC;AAE5C,OAAO,EAAuB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAQrF,KAAK,cAAc,GAAG;IACpB,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF;;;;;;;;GAQG;AAEH,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,UAAU;IAC3D,MAAM,CAAC,MAAM,4BAMX;IAEF,wDAAwD;IAExD,KAAK,SAAM;IAEX,uGAAuG;IAEvG,aAAa,SAAM;IAEnB,yCAAyC;IAEzC,cAAc,SAAM;IAEpB,4FAA4F;IAE5F,cAAc,SAAM;IAEpB,4EAA4E;IAE5E,eAAe,SAAM;IAErB,kFAAkF;IAElF,eAAe,SAAM;IAErB,iCAAiC;IAEjC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAQ;IAEtC,uEAAuE;IAEvE,IAAI,EAAE,YAAY,GAAG,EAAE,CAAM;IAE7B,4BAA4B;IAE5B,OAAO,EAAE,SAAS,GAAG,EAAE,CAAM;IAG7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,sEAAsE;IAEtE,UAAU,EAAE,OAAO,CAAQ;IAE3B,gFAAgF;IAEhF,SAAS,EAAE,MAAM,GAAG,OAAO,CAAU;IAGrC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEhC,mFAAmF;IAEnF,cAAc,UAAS;IAEvB,sDAAsD;IAEtD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEjC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,OAAO,CAA8B;IAE7C,iBAAiB,IAAI,IAAI;IAOzB,oBAAoB,IAAI,IAAI;IAQ5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIxE,gDAAgD;IAChD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpB,mCAAmC;IACnC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,WAAW,CAgBjB;IAEF,OAAO,CAAC,OAAO;IAuCf,MAAM;CAGP"}

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

@@ -0,0 +1,116 @@
+/**
+ * API publique de l'inférence Hugging Face dans Concorde.
+ *
+ * ```ts
+ * import { configureHuggingFace, defineHuggingFaceModels } from "@supersoniks/concorde/hugging-face";
+ *
+ * export const hf = configureHuggingFace({
+ *   runtime: { source: "cdn", version: "4.3.0", url: "https://cdn…/hf-transformers/4.3.0/transformers.min.js" },
+ *   models: defineHuggingFaceModels({
+ *     "multilingual-mini": {
+ *       task: "feature-extraction",
+ *       repo: "Xenova/paraphrase-multilingual-MiniLM-L12-v2",
+ *       revision: "<sha>",
+ *       options: { dtype: "q8" },
+ *       defaults: { pooling: "mean", normalize: true },
+ *     },
+ *   }),
+ * });
+ *
+ * hf.infer({ model: "multilingual-mini", input: events, text: (e) => e.label, output: eventVectors });
+ * ```
+ *
+ * Ce module ne contient pas Transformers.js (uniquement des `import type`).
+ */
+import type { DataProviderKey } from "@supersoniks/concorde/core/utils/dataProviderKey";
+import { type HfLoadPolicy, type HfModels, type HfTrigger, type HuggingFaceConfig } from "./hf-config";
+import { type HfInferHandle, type HfInferStatus } from "./hf-controller";
+import { type HfTextExtractor } from "./hf-input";
+import { type HfModelState, type HuggingFaceRegistry } from "./hf-registry";
+import type { HF_CALL_OPTION_SCHEMAS } from "./hf-schema";
+import { HF_TASK_INPUT_KIND, type HfCallOptions, type HfExact, type HfOutput, type HfSingleInput, type HfTask } from "./types";
+export type HfAlias<M extends HfModels> = Extract<keyof M, string>;
+export type HfTaskOf<M extends HfModels, A extends HfAlias<M>> = M[A]["task"];
+type DefaultsOf<M extends HfModels, A extends HfAlias<M>> = M[A] extends {
+    defaults: infer D;
+} ? D : unknown;
+/** Options effectives = défauts du modèle, surchargés par ceux de l'appel. */
+export type HfMergedOptions<D, C> = Omit<D, keyof C> & C;
+/** Entrée acceptée pour une tâche : un élément, une liste, ou (texte) des objets + `text`. */
+export type HfAcceptedInput<T extends HfTask> = HfSingleInput<T> | readonly HfSingleInput<T>[] | (T extends HfTask ? (typeof HF_TASK_INPUT_KIND)[T] extends "text" ? object | readonly object[] : never : never) | null | undefined;
+/**
+ * Clés d'options d'une tâche, lues sur la table de schémas (identique aux
+ * clés de `HfCallOptions<T>`, garanti à la compilation par `hf-schema.ts`) :
+ * beaucoup moins coûteux à évaluer pour le compilateur.
+ */
+type HfCallKeys<T extends HfTask> = Record<keyof (typeof HF_CALL_OPTION_SCHEMAS)[T], unknown>;
+type ItemOf<In> = In extends readonly (infer E)[] ? E : In;
+type IsMany<In> = [NonNullable<In>] extends [readonly unknown[]] ? true : false;
+/** Sortie publiée pour un alias, des options d'appel et un type d'entrée. */
+export type HfResult<M extends HfModels, A extends HfAlias<M>, C, In> = HfOutput<HfTaskOf<M, A>, HfMergedOptions<DefaultsOf<M, A>, C>, IsMany<In>>;
+export type HfInferOptions<M extends HfModels, A extends HfAlias<M>, In, C> = {
+    model: A;
+    input: DataProviderKey<In> | string;
+    output: DataProviderKey<HfResult<M, A, C, In> | null> | string;
+    status?: DataProviderKey<HfInferStatus | null> | string;
+    triggerProvider?: DataProviderKey<unknown> | string;
+    consentProvider?: DataProviderKey<unknown> | string;
+    /** Pour une entrée faite d'objets : chemins (`"label + edito.sub_title"`) ou fonction typée. */
+    text?: HfTextExtractor<NonNullable<ItemOf<In>>>;
+    /** Options d'appel de la tâche du modèle (surchargent `defaults`). */
+    call?: HfExact<C, HfCallKeys<HfTaskOf<M, A>>>;
+    load?: HfLoadPolicy;
+    trigger?: HfTrigger;
+    debounceMs?: number;
+    emptyValue?: HfResult<M, A, C, In> | null;
+    onInvalid?: "keep" | "clear";
+    maxItems?: number;
+    maxChars?: number;
+    timeoutMs?: number;
+    persistResults?: boolean;
+    resultsTtlMs?: number;
+};
+export type HuggingFace<M extends HfModels> = {
+    readonly models: M;
+    /** Relie des DataProviders à un modèle (équivalent TypeScript de l'élément). */
+    infer<A extends HfAlias<M>, In extends HfAcceptedInput<HfTaskOf<M, A>>, const C extends HfCallOptions<HfTaskOf<M, A>> = Record<never, never>>(options: HfInferOptions<M, A, In, C>): HfInferHandle;
+    /**
+     * Calcul ponctuel (sans DataProvider). À utiliser comme `compute` de
+     * `derive()` pour des dérivations à plusieurs entrées.
+     * Résout `null` si l'entrée est vide.
+     */
+    run<A extends HfAlias<M>, In extends HfAcceptedInput<HfTaskOf<M, A>>, const C extends HfCallOptions<HfTaskOf<M, A>> = Record<never, never>>(model: A, input: In, call?: HfExact<C, HfCallKeys<HfTaskOf<M, A>>>, options?: {
+        text?: HfTextExtractor<NonNullable<ItemOf<In>>>;
+        load?: HfLoadPolicy;
+        timeoutMs?: number;
+    }): Promise<HfResult<M, A, C, In> | null>;
+    /** Charge un modèle maintenant (préchargement, politique `manual`). */
+    load(model: HfAlias<M>): Promise<void>;
+    state(model: HfAlias<M>): HfModelState;
+    subscribe(model: HfAlias<M>, listener: (state: HfModelState) => void): () => void;
+    accept(model: HfAlias<M>): void;
+    decline(model: HfAlias<M>): void;
+    revokeConsent(model: HfAlias<M>): void;
+    /** Supprime un modèle du cache du navigateur. */
+    clearModel(model: HfAlias<M>): Promise<void>;
+    /** Supprime tous les modèles, le WASM et les résultats mémorisés. */
+    clearAll(): Promise<void>;
+    readonly registry: HuggingFaceRegistry;
+};
+/**
+ * Configure l'inférence pour la page (à appeler une fois, au démarrage).
+ * Rend une API typée par la liste blanche de modèles.
+ */
+export declare function configureHuggingFace<const M extends HfModels>(config: HuggingFaceConfig<M>): HuggingFace<M>;
+export { defineHuggingFaceModels, HF_DEFAULTS } from "./hf-config";
+export type { HfDefaults, HfLoadPolicy, HfModelDefinition, HfModels, HfRuntime, HfTrigger, HuggingFaceConfig, } from "./hf-config";
+export type { HfInferHandle, HfInferState, HfInferStatus } from "./hf-controller";
+export type { HfModelPhase, HfModelState } from "./hf-registry";
+export { HfError } from "./hf-registry";
+export type { HfEngine } from "./hf-engine";
+export { HfWorkerEngine, HfEngineError } from "./hf-engine";
+export { hfCallOptionsJsonSchema, validateCallOptions, HF_CALL_OPTION_SCHEMAS } from "./hf-schema";
+export { HF_TASKS } from "./types";
+export type { HfCallOptions, HfEmbedding, HfItemOutput, HfOutput, HfSingleInput, HfTask, } from "./types";
+export { cosine, rankBySimilarity } from "@supersoniks/concorde/core/utils/similarity";
+//# sourceMappingURL=hugging-face.d.ts.map

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

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

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

@@ -0,0 +1,167 @@
+/**
+ * Types de `sonic-hugging-face-infer`, dérivés des types publiés par
+ * Transformers.js (`@huggingface/transformers`).
+ *
+ * Rien n'est recopié à la main : entrées, options d'appel et sorties sont
+ * calculées à partir des signatures des pipelines de la version figée de la
+ * bibliothèque. Une montée de version qui change une signature fait échouer la
+ * compilation ici (et dans `schema.ts`), pas en production.
+ *
+ * Uniquement des `import type` : ce fichier n'ajoute aucun octet au bundle.
+ */
+import type { AllTasks, DataType, DeviceType, PretrainedModelOptions, RawImage, Tensor } from "@huggingface/transformers";
+/**
+ * Tâches autorisées. Volontairement sans LLM libre (`text-generation`,
+ * `summarization`, `text2text-generation`, `text-to-audio`) : trop lourd /
+ * peu fiable dans un navigateur. `image-to-text` (légende) est autorisé :
+ * modèles vision→texte courts et bornés (`max_new_tokens`).
+ */
+export declare const HF_TASKS: readonly ["feature-extraction", "text-classification", "zero-shot-classification", "translation", "token-classification", "fill-mask", "question-answering", "image-classification", "zero-shot-image-classification", "object-detection", "zero-shot-object-detection", "image-feature-extraction", "image-segmentation", "depth-estimation", "background-removal", "image-to-text", "audio-classification", "automatic-speech-recognition"];
+export type HfTask = (typeof HF_TASKS)[number];
+/**
+ * Arguments positionnels supplémentaires (entre l'entrée et les options) que
+ * certains pipelines exigent. Côté Concorde, ils sont passés dans les options
+ * d'appel sous ce nom, puis replacés à la bonne position par le worker.
+ */
+export declare const HF_POSITIONAL_ARGS: {
+    readonly "zero-shot-classification": "candidate_labels";
+    readonly "zero-shot-image-classification": "candidate_labels";
+    readonly "zero-shot-object-detection": "candidate_labels";
+    readonly "question-answering": "context";
+};
+type PositionalTask = keyof typeof HF_POSITIONAL_ARGS;
+/** Famille de l'entrée, utile pour la validation à l'exécution. */
+export declare const HF_TASK_INPUT_KIND: {
+    readonly "feature-extraction": "text";
+    readonly "text-classification": "text";
+    readonly "zero-shot-classification": "text";
+    readonly translation: "text";
+    readonly "token-classification": "text";
+    readonly "fill-mask": "text";
+    readonly "question-answering": "text";
+    readonly "image-classification": "image";
+    readonly "zero-shot-image-classification": "image";
+    readonly "object-detection": "image";
+    readonly "zero-shot-object-detection": "image";
+    readonly "image-feature-extraction": "image";
+    readonly "image-segmentation": "image";
+    readonly "depth-estimation": "image";
+    readonly "background-removal": "image";
+    readonly "image-to-text": "image";
+    readonly "audio-classification": "audio";
+    readonly "automatic-speech-recognition": "audio";
+};
+export type HfInputKind = (typeof HF_TASK_INPUT_KIND)[HfTask];
+type IsAny<T> = 0 extends 1 & T ? true : false;
+/** Appelle (au niveau des types) un pipeline générique avec des arguments donnés. */
+type CallWith<F, A extends unknown[]> = F extends (...args: A) => infer R ? R : never;
+/**
+ * Retire la variante « lot » d'une union `X | X[]` renvoyée par les pipelines
+ * (qui acceptent une entrée seule ou un tableau).
+ */
+type DropBatch<M, All> = M extends readonly (infer E)[] ? [E] extends [All] ? never : M : M;
+type Single<R> = DropBatch<R, R>;
+/** Retire les signatures d'index (`[key: string]: unknown`). */
+type RemoveIndex<T> = {
+    [K in keyof T as string extends K ? never : number extends K ? never : symbol extends K ? never : K]: T[K];
+};
+type JsonPrimitive = string | number | boolean | null | undefined;
+/**
+ * Vrai si la valeur peut traverser `postMessage` ET être stockée dans un
+ * DataProvider sans perte : primitives, tableaux et objets simples. Les classes
+ * (Tensor, streamers, caches…) portent des méthodes et sont exclues ; `any`
+ * aussi (non typable, donc non validable).
+ */
+type IsJsonSafe<V> = IsAny<V> extends true ? false : false extends (V extends unknown ? IsJsonSafeOne<V> : never) ? false : true;
+type IsJsonSafeOne<V> = [V] extends [JsonPrimitive] ? true : [V] extends [readonly (infer E)[]] ? IsJsonSafe<E> : [V] extends [object] ? [V] extends [(...args: never[]) => unknown] ? false : HasMethod<V> extends true ? false : AllJsonSafe<V> : false;
+type HasMethod<V> = true extends {
+    [K in keyof V]-?: NonNullable<V[K]> extends (...args: never[]) => unknown ? true : false;
+}[keyof V] ? true : false;
+type AllJsonSafe<V> = false extends {
+    [K in keyof V]-?: IsJsonSafe<Exclude<V[K], undefined>>;
+}[keyof V] ? false : true;
+/** Ne garde que les options sérialisables. */
+export type JsonSafeOptions<O> = {
+    [K in keyof RemoveIndex<O> as IsJsonSafe<Exclude<RemoveIndex<O>[K], undefined>> extends true ? K : never]?: Exclude<RemoveIndex<O>[K], undefined>;
+};
+/**
+ * Refuse les clés en trop même quand `C` est inféré (paramètre générique) :
+ * les clés absentes de `O` deviennent `never`.
+ */
+export type HfExact<C, O> = {
+    [K in keyof C]: K extends keyof O ? C[K] : never;
+};
+type Pipe<T extends HfTask> = AllTasks[T];
+type PipeParams<T extends HfTask> = Parameters<Pipe<T>>;
+/** Types d'entrée transférables vers un worker (pas de canvas, pas de RawImage). */
+type Transferable = string | Blob | Float32Array | Float64Array;
+/**
+ * Entrée d'UN élément pour une tâche (texte, URL/Blob d'image, audio),
+ * dérivée du premier paramètre du pipeline.
+ */
+export type HfSingleInput<T extends HfTask> = Extract<Single<PipeParams<T>[0]>, Transferable>;
+/** Dernier paramètre (options) du pipeline, brut. */
+type RawCallOptions<T extends HfTask> = T extends PositionalTask ? NonNullable<PipeParams<T>[2]> : NonNullable<PipeParams<T>[1]>;
+/** Argument positionnel supplémentaire, replié dans les options. */
+type PositionalOptions<T extends HfTask> = T extends PositionalTask ? {
+    [K in (typeof HF_POSITIONAL_ARGS)[T]]: Extract<PipeParams<T>[1], string | readonly string[]>;
+} : unknown;
+/**
+ * Options d'appel d'une tâche : options sérialisables du pipeline, plus
+ * l'argument positionnel éventuel (`candidate_labels`, `context`).
+ */
+export type HfCallOptions<T extends HfTask> = JsonSafeOptions<RawCallOptions<T>> & Partial<PositionalOptions<T>>;
+/** Options d'appel nécessaires (l'argument positionnel est requis au moment de l'appel). */
+export type HfRequiredCallKeys<T extends HfTask> = T extends PositionalTask ? (typeof HF_POSITIONAL_ARGS)[T] : never;
+/** Tableaux imbriqués de nombres, forme `tolist()` d'un Tensor. */
+export type HfNumberTree = number | HfNumberTree[];
+/** Image produite par un pipeline, transportée hors du worker. */
+export type HfSerializedImage = {
+    width: number;
+    height: number;
+    channels: number;
+    /** PNG encodé dans le worker (`RawImage.toBlob()`). */
+    blob: Blob;
+    /**
+     * ObjectURL créé côté main thread à la publication (`attachMediaUrls`).
+     * Chaînable vers `sonic-shader` / `sonic-webgpu` / `sonic-jsonata` (`$mediaUrl`) sans colle JS.
+     */
+    url?: string;
+};
+/** Conversion des valeurs non sérialisables (Tensor, RawImage) en données simples. */
+export type HfSerialized<V> = V extends Tensor ? HfNumberTree : V extends RawImage ? HfSerializedImage : V extends readonly (infer E)[] ? HfSerialized<E>[] : V extends Blob ? V : V extends object ? {
+    [K in keyof V]: HfSerialized<V[K]>;
+} : V;
+/** Sortie brute du pipeline pour UNE entrée, avec des options données. */
+type RawItemOutput<T extends HfTask, O> = Single<Awaited<T extends PositionalTask ? CallWith<Pipe<T>, [HfSingleInput<T>, PipeParams<T>[1], O]> : CallWith<Pipe<T>, [HfSingleInput<T>, O]>>>;
+/**
+ * Un embedding : vecteur quand un `pooling` est demandé, matrice
+ * jetons × dimensions sinon (défaut de Transformers.js : `pooling: "none"`).
+ */
+export type HfEmbedding<O> = O extends {
+    pooling: infer P;
+} ? [P] extends ["none" | undefined] ? number[][] : number[] : number[][];
+/**
+ * Sortie pour UNE entrée. `feature-extraction` et `image-feature-extraction`
+ * renvoient un Tensor : il est aplati pour l'élément (première dimension
+ * « lot » retirée).
+ */
+export type HfItemOutput<T extends HfTask, O = HfCallOptions<T>> = T extends "feature-extraction" ? HfEmbedding<O> : T extends "image-feature-extraction" ? number[] : HfSerialized<RawItemOutput<T, O>>;
+/**
+ * Sortie publiée : un résultat pour une entrée seule, une liste ALIGNÉE sur
+ * l'entrée (avec `null` pour les éléments inexploitables) pour une liste.
+ */
+export type HfOutput<T extends HfTask, O, Many extends boolean> = Many extends true ? (HfItemOutput<T, O> | null)[] : HfItemOutput<T, O>;
+/** Exécution demandée. `webgpu` et `wasm` sont les seuls pertinents dans un navigateur. */
+export type HfDevice = Extract<DeviceType, "webgpu" | "wasm">;
+export type HfDataType = DataType;
+/**
+ * Options passées à `pipeline(task, repo, options)`, dérivées de
+ * `PretrainedModelOptions`. `progress_callback` est géré par Concorde,
+ * `revision` est obligatoire au niveau du modèle, `device` est remplacé par
+ * la liste ordonnée `devices`, `cache_dir` / `local_files_only` n'ont pas de
+ * sens dans un navigateur.
+ */
+export type HfLoadOptions = Omit<PretrainedModelOptions, "progress_callback" | "revision" | "device" | "cache_dir" | "local_files_only">;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/types/core/components/functional/jsonata/jsonata.d.ts

@@ -0,0 +1,29 @@
+import { LitElement } from "lit";
+/**
+ * Adaptateur JSONata de `derive` : 1 entrée → expression → 1 sortie (readonly).
+ *
+ * Contexte d’évaluation :
+ * - `$input` = contenu de `inputProvider`
+ * - champs du `formDataProvider` optionnel = `$top`, `$roast`, …
+ */
+export default class SonicJsonata extends LitElement {
+    static styles: import("lit").CSSResult[];
+    /** DataProvider d’entrée (source). */
+    inputProvider: string;
+    /** DataProvider de sortie (agrégat, readonly). */
+    outputProvider: string;
+    /**
+     * Form / variables optionnelles (`$top`, `$roast`, …).
+     * Même id que le `formDataProvider` du formulaire — recalcule sans refetch.
+     */
+    formDataProvider: string;
+    expression: string;
+    outputSchema: Record<string, unknown> | null;
+    private handle;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(changed: Map<string | number | symbol, unknown>): void;
+    private restart;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=jsonata.d.ts.map

package/dist/types/core/components/functional/jsonata/jsonata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonata.d.ts","sourceRoot":"","sources":["../../../../../../src/core/components/functional/jsonata/jsonata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,MAAM,KAAK,CAAC;AAY5C;;;;;;GAMG;AAEH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,UAAU;IAClD,MAAM,CAAC,MAAM,4BAMX;IAEF,sCAAsC;IAEtC,aAAa,SAAM;IAEnB,kDAAkD;IAElD,cAAc,SAAM;IAEpB;;;OAGG;IAEH,gBAAgB,SAAM;IAGtB,UAAU,SAAM;IAGhB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAQ;IAEpD,OAAO,CAAC,MAAM,CAA6B;IAE3C,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAM5B,SAAS,CAAC,OAAO,CACf,OAAO,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,GAC9C,IAAI;IAYP,OAAO,CAAC,OAAO;IAmCf,MAAM;CAGP"}

package/dist/types/core/components/functional/list/list.d.ts

@@ -0,0 +1,149 @@
+import { LitElement, nothing, PropertyValues } from "lit";
+import "@supersoniks/concorde/core/components/ui/loader/loader";
+import "@supersoniks/concorde/core/components/functional/subscriber/subscriber";
+import { DirectiveResult } from "lit/directive.js";
+import { TemplateContentDirective } from "lit/directives/template-content.js";
+import { TemplateResult } from "lit";
+import { LoaderMode } from "@supersoniks/concorde/core/components/ui/loader/loader";
+/**
+ *  ### List boucle sur sa propriété "props" et crée des éléments a partir des données en bouclant également sur ses templates.
+ *
+ * Extends mixins : Fetcher, [Subscriber](./?path=/docs/miscallenous-🔔-subscriber--page)
+ *
+ * * Si le composant possède un attribut *fetch*, il charge un contenu via un appel d'api web.<br>
+ * Voir [fetcher](./?path=/docs/core-components-functional-fetch--basic) pour la configuration des autres attributs.
+ * * Chaque élément créé est englobé dans un objet [Subscriber](./?path=/docs/miscallenous-🔔-subscriber--page).<br>
+ *  Un dataProvider y est associé a l'adresse suivante *dataProvider-de-la-liste$/*index-de-la-ligne-courante*
+ *  Les données de la ligne sont donc disponible pour les élements internes (subscribers)
+ *  * Lors du chargement un objet loader inline est affiché.
+ *  * Si le résultat de la requête est un objet, il est imbriqué dans un tableau pour garantir le fonctionnement.<br>
+ * Cependant, si l'attribut `extractValues` est présent, les valeurs des propriétés de l'objet sont mises dans  dans un tableau pour le rendu.
+ * * La propriété _metadata_ est ajoutés à la donnée de chaque item. Elle contient les informations suivantes :
+ * * key : l'index de l'item dans la liste
+ * * even : true si l'index est pair
+ * * odd : true si l'index est impair
+ * * onlyChild : true si la liste ne contient qu'un seul item
+ * * firstChild : true si l'item est le premier de la liste
+ * * lastChild : true si l'item est le dernier de la liste
+ * * Si la liste ne contient aucun item, le template "no-item" est utilisé si il est défini.
+ * * On peut appler la methode invalidate() sur son publishe pour declencher le rechargement des données
+ * *
+ */
+export type ListItemMetadata = {
+    key?: string | number;
+    even?: boolean;
+    odd?: boolean;
+    onlyChild?: boolean;
+    firstChild?: boolean;
+    lastChild?: boolean;
+};
+export type ListItems = (item: any, metadata: ListItemMetadata) => DirectiveResult;
+declare const List_base: {
+    new (...args: import("../../../_types/types").MixinArgsType[]): {
+        api: import("../../../utils/api").default | null;
+        key: string;
+        isFirstLoad: boolean;
+        isLoading: boolean;
+        lazyLoad?: boolean;
+        iObserver: IntersectionObserver | null;
+        isFetchEnabled: boolean;
+        fetchedData: any;
+        _endPoint: string;
+        noErrorsRecordings: boolean;
+        get props(): import("../../../utils/api").ResultTypeInterface | null;
+        set props(value: import("../../../utils/api").ResultTypeInterface | null);
+        get endPoint(): string;
+        set endPoint(value: string);
+        requestId: number;
+        refetchEveryMs: number;
+        refetchTimeOutId?: ReturnType<typeof setTimeout>;
+        _isFetching: boolean;
+        _mustRefetch: boolean;
+        handleStartFetching(): "fetching" | "okToFetch";
+        handleEndFetching(): void;
+        refetch(): Promise<void>;
+        _fetchData(): Promise<void>;
+        onInvalidate?: (() => void) | undefined;
+        disconnectedCallback(): void;
+        connectedCallback(): void;
+        lazyLoadPlaceHolder?: HTMLSpanElement;
+        handleLazyLoad(): void;
+        onIntersection(entries: IntersectionObserverEntry[]): void;
+        propertyMap: object;
+        isConnected: boolean;
+        children: HTMLCollection;
+        appendChild(node: Node): Node;
+        getAncestorAttributeValue(attributeName: string): string;
+        hasAncestorAttribute(attributeName: string): boolean;
+        querySelectorAll(selector: string): NodeListOf<Element>;
+        publisher: import("../../../_types/types").TypeAndRecordOfType<import("../../../_types/types").PublisherInterface<PropsType>>;
+        dataProvider: string | null;
+        noShadowDom: string | null;
+        debug: HTMLElement | null;
+        defferedDebug: boolean | null;
+        displayContents: boolean;
+        shadowRoot?: ShadowRoot;
+        shouldRenderLazy: boolean;
+        dispatchEvent(event: Event): void;
+        setAttribute(name: string, value: string): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+        removeAttribute(name: string): void;
+        initPublisher(): void;
+        getApiConfiguration(): import("../../../utils/api").APIConfiguration;
+        requestUpdate(): void;
+        getAttribute(name: string): string;
+        hasAttribute(attributeName: string): boolean;
+        getBoundingClientRect(): DOMRect;
+    };
+} & (new (...args: import("../../../_types/types").MixinArgsType[]) => import("@supersoniks/concorde/core/mixins/Subscriber").SubscriberInterface<import("../../../_types/types").CoreJSType>) & (new (...args: import("../../../_types/types").MixinArgsType[]) => import("@supersoniks/concorde/core/mixins/TemplatesContainer").TemplatesContainerInterface) & typeof LitElement;
+export declare class List extends List_base {
+    itemPropertyMap?: object;
+    /**
+     * La propriété templateKey contient le nom de la propriété qui sera utilisé pour identifier le template à utiliser dans la donnée de la ligne.
+     * Par exemple si templateIdentifier = "name" et que la donnée de la ligne est {name: "myTemplate" ... }, alors le template possédant l'attribut data-value="myTemplate" sera utilisé.
+     */
+    templateKey: string;
+    /**
+     * La propriété idKey est utilisé repérer les lignes de manière unique si pour les item de la liste item[this.idKey] n'existe pas, alors l'index est utilisé
+     */
+    idKey: string;
+    loader?: LoaderMode | true | "";
+    limit: number;
+    offset: number;
+    _items?: ListItems;
+    get items(): ListItems | undefined;
+    set items(value: ListItems);
+    noItems?: () => DirectiveResult;
+    skeleton?: () => DirectiveResult;
+    separator?: () => DirectiveResult;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    renderLoader(): typeof nothing | TemplateResult<1>;
+    renderSkeleton(): DirectiveResult<import("lit-html/directive.js").DirectiveClass>;
+    renderSeparator(): DirectiveResult<import("lit-html/directive.js").DirectiveClass>;
+    renderLoadingState(): DirectiveResult<typeof TemplateContentDirective> | TemplateResult;
+    renderNoResultState(): TemplateResult<1>;
+    formatProps(): (import("../../../_types/types").CoreJSType[] & {
+        _sonic_http_response_?: Response;
+        text?: string;
+    }) | null;
+    protected updated(_changedProperties: PropertyValues): void;
+    getAllRenderableElements(root: any): any[];
+    getDisplayContentsSize(element: any): {
+        width: number;
+        height: number;
+    };
+    /**
+     * loadingsize is computed after rendering a loading / doesnt require one but will be used on other renderings
+     */
+    loadingSize: {
+        width: number;
+        height: number;
+    };
+    render(): TemplateResult<1>;
+    private handleProgrammaticTemplates;
+    renderContent(): DirectiveResult<import("lit-html/directive.js").DirectiveClass>;
+}
+export {};
+//# sourceMappingURL=list.d.ts.map