@supersoniks/concorde 4.9.98-visual-stack.1 → 5.0.0

package/src/core/components/functional/webgpu/wgsl-prelude.ts

@@ -1,81 +0,0 @@
-/**
- * Prelude WGSL pour `sonic-webgpu`.
- * L’utilisateur fournit `fn mainImage(uv: vec2f, fragCoord: vec2f) -> vec4f`.
- */
-
-export const DEFAULT_MAIN_IMAGE = `
-fn mainImage(uv: vec2f, fragCoord: vec2f) -> vec4f {
-  _ = fragCoord;
-  let c = iChannel0(uv);
-  if (c.a > 0.001 || c.r + c.g + c.b > 0.001) {
-    return c;
-  }
-  let g = 0.15 + 0.25 * uv.y;
-  return vec4f(g, g * 0.85 + 0.08 * u.params.x, 0.35 + 0.4 * uv.x, 1.0);
-}
-`.trim();
-
-const PRELUDE = `
-struct SonicUniforms {
-  resolution: vec2f,
-  time: f32,
-  frame: f32,
-  mouse: vec4f,
-  params: vec4f,
-}
-
-@group(0) @binding(0) var<uniform> u: SonicUniforms;
-@group(0) @binding(1) var channel0Tex: texture_2d<f32>;
-@group(0) @binding(2) var channel1Tex: texture_2d<f32>;
-@group(0) @binding(3) var channel2Tex: texture_2d<f32>;
-@group(0) @binding(4) var channel3Tex: texture_2d<f32>;
-@group(0) @binding(5) var texSampler: sampler;
-
-fn iChannel0(uv: vec2f) -> vec4f {
-  return textureSample(channel0Tex, texSampler, uv);
-}
-fn iChannel1(uv: vec2f) -> vec4f {
-  return textureSample(channel1Tex, texSampler, uv);
-}
-fn iChannel2(uv: vec2f) -> vec4f {
-  return textureSample(channel2Tex, texSampler, uv);
-}
-fn iChannel3(uv: vec2f) -> vec4f {
-  return textureSample(channel3Tex, texSampler, uv);
-}
-
-struct VsOut {
-  @builtin(position) position: vec4f,
-  @location(0) uv: vec2f,
-}
-
-@vertex
-fn vs_main(@builtin(vertex_index) vi: u32) -> VsOut {
-  var pos = array<vec2f, 3>(
-    vec2f(-1.0, -1.0),
-    vec2f(3.0, -1.0),
-    vec2f(-1.0, 3.0),
-  );
-  var out: VsOut;
-  out.position = vec4f(pos[vi], 0.0, 1.0);
-  out.uv = pos[vi] * 0.5 + vec2f(0.5);
-  return out;
-}
-
-@fragment
-fn fs_main(in: VsOut) -> @location(0) vec4f {
-  let fragCoord = vec2f(in.uv.x * u.resolution.x, in.uv.y * u.resolution.y);
-  return mainImage(in.uv, fragCoord);
-}
-`.trim();
-
-/** Assemble prelude + corps utilisateur (ou défaut). */
-export function buildWgslSource(userBody: string): string {
-  const body = userBody.trim() || DEFAULT_MAIN_IMAGE;
-  if (!/\bfn\s+mainImage\s*\(/.test(body)) {
-    throw new Error(
-      "WGSL invalide : définir `fn mainImage(uv: vec2f, fragCoord: vec2f) -> vec4f`.",
-    );
-  }
-  return `${PRELUDE}\n\n${body}\n`;
-}

package/src/core/utils/mediaRef.spec.ts

@@ -1,146 +0,0 @@
-import { describe, expect, it, vi, beforeEach } from "vitest";
-import {
-  attachMediaUrls,
-  cloneMediaRef,
-  isFrameSource,
-  isMediaBlobObject,
-  mediaElementKey,
-  registerLiveElement,
-  revokeMediaUrls,
-  toMediaUrl,
-} from "./mediaRef";
-
-describe("toMediaUrl", () => {
-  it("accepte string / url / blobUrl", () => {
-    expect(toMediaUrl(" https://x/a.png ")).toBe("https://x/a.png");
-    expect(toMediaUrl({ url: "blob:abc" })).toBe("blob:abc");
-    expect(toMediaUrl({ blobUrl: "blob:xyz" })).toBe("blob:xyz");
-    expect(toMediaUrl(null)).toBeNull();
-    expect(toMediaUrl({ blob: new Blob() })).toBeNull();
-  });
-
-  it("ignore element (pas d’URL)", () => {
-    expect(toMediaUrl({ element: "#plateau" })).toBeNull();
-  });
-});
-
-describe("isFrameSource / mediaElementKey", () => {
-  it("détecte SonicFrameSource", () => {
-    expect(
-      isFrameSource({
-        getFrameCanvas: () => null,
-        frameSeq: 0,
-      }),
-    ).toBe(true);
-    expect(isFrameSource({})).toBe(false);
-    expect(isFrameSource(null)).toBe(false);
-  });
-
-  it("FrameConsumerRegistry register / unregister", async () => {
-    const { FrameConsumerRegistry, isFrameConsumerHost } = await import(
-      "./mediaRef"
-    );
-    const tokens: object[] = [];
-    const host = {
-      registerFrameConsumer(t: object = {}) {
-        tokens.push(t);
-      },
-      unregisterFrameConsumer(t: object = {}) {
-        const i = tokens.indexOf(t);
-        if (i >= 0) tokens.splice(i, 1);
-      },
-      getFrameCanvas: () => null,
-      frameSeq: 0,
-    };
-    expect(isFrameConsumerHost(host)).toBe(true);
-    const reg = new FrameConsumerRegistry();
-    // FrameConsumerRegistry expects Element — cast for unit test
-    reg.sync([host as unknown as Element]);
-    expect(tokens.length).toBe(1);
-    reg.clear();
-    expect(tokens.length).toBe(0);
-  });
-
-  it("normalise element string / Element avec id", () => {
-    expect(mediaElementKey("#plateau")).toBe("#plateau");
-    expect(mediaElementKey("plateau")).toBe("#plateau");
-    expect(mediaElementKey("")).toBeNull();
-    const el = document.createElement("div");
-    el.id = "scene";
-    expect(mediaElementKey(el)).toBe("#scene");
-  });
-
-  it("enregistre un Element sans id", () => {
-    const el = document.createElement("div");
-    const key = registerLiveElement(el);
-    expect(key.startsWith("#__sonic_frame_")).toBe(true);
-    expect(mediaElementKey(el)).toBe(key);
-  });
-});
-
-describe("attachMediaUrls / revokeMediaUrls", () => {
-  const createSpy = vi.fn(() => "blob:mock-1");
-  const revokeSpy = vi.fn();
-
-  beforeEach(() => {
-    createSpy.mockClear();
-    revokeSpy.mockClear();
-    URL.createObjectURL = createSpy as typeof URL.createObjectURL;
-    URL.revokeObjectURL = revokeSpy as typeof URL.revokeObjectURL;
-  });
-
-  it("ajoute url sur les images Blob et collectes les ObjectURL", () => {
-    const blob = new Blob([new Uint8Array([1])], { type: "image/png" });
-    const depth: {
-      width: number;
-      height: number;
-      channels: number;
-      blob: Blob;
-      url?: string;
-    } = { width: 2, height: 2, channels: 1, blob };
-    const tree = { depth, other: 1 };
-    const created: string[] = [];
-    attachMediaUrls(tree, created);
-    expect(depth.url).toBe("blob:mock-1");
-    expect(created).toEqual(["blob:mock-1"]);
-    expect(isMediaBlobObject(depth)).toBe(true);
-    expect(createSpy).toHaveBeenCalledOnce();
-  });
-
-  it("conserve une url déjà présente (pas de nouvel ObjectURL)", () => {
-    const blob = new Blob([new Uint8Array([1])], { type: "image/png" });
-    const depth = {
-      width: 2,
-      height: 2,
-      blob,
-      url: "https://cdn.example/depth.png",
-    };
-    const created: string[] = [];
-    attachMediaUrls(depth, created);
-    expect(depth.url).toBe("https://cdn.example/depth.png");
-    expect(created).toEqual([]);
-    expect(createSpy).not.toHaveBeenCalled();
-  });
-
-  it("appelle revokeObjectURL", () => {
-    revokeMediaUrls(["blob:a", "blob:b"]);
-    expect(revokeSpy).toHaveBeenCalledTimes(2);
-  });
-});
-
-describe("cloneMediaRef", () => {
-  it("recrée un ObjectURL depuis un blob", async () => {
-    URL.createObjectURL = vi.fn(
-      () => "blob:cloned",
-    ) as typeof URL.createObjectURL;
-    const blob = new Blob([new Uint8Array([1, 2])], { type: "image/jpeg" });
-    const out = await cloneMediaRef({
-      url: "blob:old",
-      blob,
-      width: 2,
-      height: 2,
-    });
-    expect(out?.url).toBe("blob:cloned");
-    expect(out?.blob).toBe(blob);
-  });
-});

package/src/core/utils/mediaRef.ts

@@ -1,238 +0,0 @@
-/**
- * Jeton média neutre pour chaîner HF → jsonata → shader / 3d via DataProvider.
- *
- * - `url` : http(s) | blob: | data: (préféré pour les canaux shader)
- * - `blob` : binaire (HF, upload) — le producteur publie aussi `url` quand possible
- * - `blobUrl` : alias historique (extract shader)
- * - `element` : sélecteur `#id` ou Element (pont live → canaux shader, ignoré par toMediaUrl)
- */
-
-export type SonicMediaRef = {
-  url?: string;
-  blobUrl?: string;
-  blob?: Blob;
-  width?: number;
-  height?: number;
-  mime?: string;
-  /** Sélecteur `#id` ou référence Element (upload live, pas d’URL). */
-  element?: string | Element;
-};
-
-/**
- * Contrat minimal pour qu’un composant Concorde alimente un canal shader
- * sans JPEG / blob (`channel0="#plateau"` ou `{ element }`).
- */
-export type SonicFrameSource = {
-  /** Canvas lisible (preserveDrawingBuffer ou 2D). `null` tant que pas prêt. */
-  getFrameCanvas(): HTMLCanvasElement | null;
-  /** Incrémenté après chaque rendu effectif. */
-  readonly frameSeq: number;
-};
-
-/**
- * Producteur de frames live qui peut rester actif hors viewport
- * tant qu’un consommateur est enregistré (`sonic-3d` Lot 9).
- */
-export type SonicFrameConsumerHost = {
-  registerFrameConsumer(token?: object): void;
-  unregisterFrameConsumer(token?: object): void;
-};
-
-export function isFrameSource(el: unknown): el is SonicFrameSource {
-  if (!el || typeof el !== "object") return false;
-  const o = el as SonicFrameSource;
-  return (
-    typeof o.getFrameCanvas === "function" && typeof o.frameSeq === "number"
-  );
-}
-
-export function isFrameConsumerHost(el: unknown): el is SonicFrameConsumerHost {
-  if (!el || typeof el !== "object") return false;
-  const o = el as SonicFrameConsumerHost;
-  return (
-    typeof o.registerFrameConsumer === "function" &&
-    typeof o.unregisterFrameConsumer === "function"
-  );
-}
-
-/** Suit les `#id` résolus → register/unregister auprès du producteur. */
-export class FrameConsumerRegistry {
-  private tokens = new Map<Element, object>();
-
-  sync(elements: Iterable<Element | null | undefined>) {
-    const next = new Set<Element>();
-    for (const el of elements) {
-      if (el && isFrameConsumerHost(el)) next.add(el);
-    }
-    for (const [el, token] of [...this.tokens]) {
-      if (next.has(el)) continue;
-      if (isFrameConsumerHost(el)) el.unregisterFrameConsumer(token);
-      this.tokens.delete(el);
-    }
-    for (const el of next) {
-      if (this.tokens.has(el)) continue;
-      const token = {};
-      (el as unknown as SonicFrameConsumerHost).registerFrameConsumer(token);
-      this.tokens.set(el, token);
-    }
-  }
-
-  clear() {
-    this.sync([]);
-  }
-}
-
-/** Clés synthétiques pour Elements DP sans `id` (`#__sonic_frame_N`). */
-const LIVE_PREFIX = "#__sonic_frame_";
-let liveSeq = 0;
-const liveByKey = new Map<string, Element>();
-const keyByLive = new WeakMap<Element, string>();
-
-/** Enregistre un Element sans id → clé `#__sonic_frame_N` (réutilisée). */
-export function registerLiveElement(el: Element): string {
-  const existing = keyByLive.get(el);
-  if (existing) return existing;
-  const key = `${LIVE_PREFIX}${++liveSeq}`;
-  liveByKey.set(key, el);
-  keyByLive.set(el, key);
-  return key;
-}
-
-export function lookupLiveElement(key: string): Element | null {
-  if (!key.startsWith(LIVE_PREFIX)) return null;
-  const el = liveByKey.get(key) ?? null;
-  if (el && !el.isConnected) {
-    liveByKey.delete(key);
-    return null;
-  }
-  return el;
-}
-
-/** Normalise `element` DP → clé canal (`#id` ou live). */
-export function mediaElementKey(value: unknown): string | null {
-  if (value == null) return null;
-  if (typeof value === "string") {
-    const s = value.trim();
-    if (!s) return null;
-    return s.startsWith("#") ? s : `#${s}`;
-  }
-  if (typeof Element !== "undefined" && value instanceof Element) {
-    if (value.id) return `#${value.id}`;
-    return registerLiveElement(value);
-  }
-  return null;
-}
-
-/** Objet image sérialisé (sortie HF / extract) : Blob + dimensions. */
-export function isMediaBlobObject(
-  value: unknown,
-): value is SonicMediaRef & { blob: Blob } {
-  if (!value || typeof value !== "object") return false;
-  const o = value as Record<string, unknown>;
-  return (
-    o.blob instanceof Blob &&
-    (typeof o.width === "number" ||
-      typeof o.height === "number" ||
-      typeof o.channels === "number" ||
-      typeof o.url === "string" ||
-      typeof o.blobUrl === "string")
-  );
-}
-
-/**
- * Résout une URL affichable / chargeable sans créer d’ObjectURL.
- * Accepte : string | objet avec `url` / `blobUrl` | null.
- * Ne matérialise pas un `blob` seul — utiliser `attachMediaUrls` / `cloneMediaRef`.
- */
-function nonEmptyTrimmed(value: unknown): string | null {
-  if (typeof value !== "string") return null;
-  const trimmed = value.trim();
-  return trimmed || null;
-}
-
-export function toMediaUrl(value: unknown): string | null {
-  if (value == null || value === "") return null;
-  if (typeof value === "string") return nonEmptyTrimmed(value);
-  if (typeof value !== "object") return null;
-  const o = value as Record<string, unknown>;
-  return nonEmptyTrimmed(o.url) ?? nonEmptyTrimmed(o.blobUrl);
-}
-
-/**
- * Attache un `url` (ObjectURL) à chaque nœud image `{ blob, width?, height? }`
- * dans une arborescence. Mutates in place. Les URLs créées sont poussées dans
- * `created` pour revoke ultérieur.
- */
-export function attachMediaUrls(
-  value: unknown,
-  created: string[],
-): unknown {
-  if (Array.isArray(value)) {
-    for (let i = 0; i < value.length; i++) {
-      value[i] = attachMediaUrls(value[i], created);
-    }
-    return value;
-  }
-  if (!value || typeof value !== "object") return value;
-  const o = value as Record<string, unknown>;
-  if (isMediaBlobObject(o)) {
-    // Ne pas écraser une url http(s)/blob déjà fournie par le producteur.
-    if (toMediaUrl(o)) return value;
-    const url = URL.createObjectURL(o.blob);
-    created.push(url);
-    o.url = url;
-    return value;
-  }
-  for (const key of Object.keys(o)) {
-    o[key] = attachMediaUrls(o[key], created);
-  }
-  return value;
-}
-
-/** Révoque une liste d’ObjectURL (ignore les erreurs). */
-export function revokeMediaUrls(urls: Iterable<string>): void {
-  for (const url of urls) {
-    try {
-      URL.revokeObjectURL(url);
-    } catch {
-      /* ignore */
-    }
-  }
-}
-
-/**
- * Copie durable d’un média : nouvel ObjectURL depuis `blob` (ou fetch de `url`).
- * À utiliser quand on fige un `frameUrl` 3d — le producteur révoque sinon au frame suivant.
- */
-export async function cloneMediaRef(
-  value: unknown,
-): Promise<SonicMediaRef | null> {
-  if (value == null) return null;
-  if (typeof value === "string") {
-    const url = value.trim();
-    if (!url) return null;
-    try {
-      const res = await fetch(url);
-      const blob = await res.blob();
-      const cloned = URL.createObjectURL(blob);
-      return { url: cloned, blob, mime: blob.type || undefined };
-    } catch {
-      return null;
-    }
-  }
-  if (typeof value !== "object") return null;
-  const o = value as SonicMediaRef;
-  if (o.blob instanceof Blob) {
-    const url = URL.createObjectURL(o.blob);
-    return {
-      url,
-      blob: o.blob,
-      width: o.width,
-      height: o.height,
-      mime: o.mime || o.blob.type || undefined,
-    };
-  }
-  const existing = toMediaUrl(o);
-  if (!existing) return null;
-  return cloneMediaRef(existing);
-}

package/src/core/utils/similarity.spec.ts

@@ -1,34 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { cosine, rankBySimilarity } from "@supersoniks/concorde/core/utils/similarity";
-import { compileJsonata } from "@supersoniks/concorde/core/utils/jsonataRuntime";
-
-describe("similarity", () => {
-  it("cosine", () => {
-    expect(cosine([1, 0], [1, 0])).toBe(1);
-    expect(cosine([1, 0], [0, 1])).toBe(0);
-    expect(cosine([1, 0], [1, 0, 0])).toBeNull();
-    expect(cosine(null, [1])).toBeNull();
-  });
-
-  it("rankBySimilarity : classe, ignore les vecteurs absents, coupe au top N", () => {
-    const items = [{ id: "a" }, { id: "b" }, { id: "c" }];
-    const vectors = [[0, 1], null, [1, 0.1]];
-    const ranked = rankBySimilarity(items, vectors, [1, 0], 5);
-    expect(ranked.map((r) => r.id)).toEqual(["c", "a"]);
-    expect(ranked[0]._score).toBeGreaterThan(0.99);
-    expect(rankBySimilarity(items, vectors, [1, 0], 1)).toHaveLength(1);
-  });
-
-  it("disponible en JSONata ($rankBySimilarity, $cosine)", async () => {
-    const expr = compileJsonata(
-      "$rankBySimilarity($input.items, $input.vectors, $input.query, 1).id",
-    );
-    const result = await expr.evaluate(
-      {},
-      { input: { items: [{ id: "x" }, { id: "y" }], vectors: [[1, 0], [0, 1]], query: [0, 1] } },
-    );
-    expect(result).toBe("y");
-    const cos = await compileJsonata("$cosine([1,0],[1,0])").evaluate({}, {});
-    expect(cos).toBe(1);
-  });
-});

package/src/core/utils/similarity.ts

@@ -1,54 +0,0 @@
-/**
- * Similarité entre vecteurs (embeddings). Fonctions pures, sans dépendance :
- * utilisables en TypeScript et exposées à JSONata (`$cosine`, `$rankBySimilarity`).
- */
-
-function isVector(value: unknown): value is number[] {
-  return (
-    Array.isArray(value) &&
-    value.length > 0 &&
-    value.every((v) => typeof v === "number" && Number.isFinite(v))
-  );
-}
-
-/** Similarité cosinus dans [-1, 1] ; `null` si les vecteurs sont absents ou incompatibles. */
-export function cosine(a: unknown, b: unknown): number | null {
-  if (!isVector(a) || !isVector(b) || a.length !== b.length) return null;
-  let dot = 0;
-  let na = 0;
-  let nb = 0;
-  for (let i = 0; i < a.length; i++) {
-    dot += a[i] * b[i];
-    na += a[i] * a[i];
-    nb += b[i] * b[i];
-  }
-  if (!na || !nb) return null;
-  return dot / Math.sqrt(na * nb);
-}
-
-export type Ranked<T> = T & { _score: number };
-
-/**
- * Classe `items` par similarité entre leur vecteur (`vectors[i]`, aligné sur
- * `items`) et `query`. Les éléments sans vecteur sont ignorés.
- */
-export function rankBySimilarity<T>(
-  items: readonly T[] | null | undefined,
-  vectors: readonly (readonly number[] | null)[] | null | undefined,
-  query: readonly number[] | null | undefined,
-  topN = 10,
-  minScore = -1,
-): Ranked<T>[] {
-  if (!Array.isArray(items) || !Array.isArray(vectors) || !isVector(query))
-    return [];
-  const scored: Ranked<T>[] = [];
-  items.forEach((item, i) => {
-    const score = cosine(vectors[i], query);
-    if (score === null || score < minScore) return;
-    const base =
-      item && typeof item === "object" ? item : ({ value: item } as unknown as T);
-    scored.push({ ...(base as T), _score: Math.round(score * 10_000) / 10_000 });
-  });
-  scored.sort((a, b) => b._score - a._score);
-  return scored.slice(0, Math.max(0, topN));
-}

package/src/docs/_getting-started/cdn-addons.md

@@ -1,73 +0,0 @@
-# CDN addons
-
-Heavy opt-in features stay **out of** `concorde-core.bundle.js`. Load the core bundle first, then the addon you need.
-
-| Addon | Bundle | Custom element | Notes |
-|-------|--------|----------------|-------|
-| 3D | `concorde-3d.bundle.js` | `sonic-3d` | Includes Three.js |
-| Shader | `concorde-shader.bundle.js` | `sonic-shader` | WebGL2 / ShaderToy |
-| WebGPU | `concorde-webgpu.bundle.js` | `sonic-webgpu` | Compute (`particles`) + image WGSL; DP / MediaRef glue same as shader |
-| Hugging Face | `concorde-hugging-face-infer.bundle.js` | `sonic-hugging-face-infer` | Exposes `ConcordeHF` for config |
-
-npm: `@supersoniks/concorde/bundle/3d`, `…/bundle/shader`, `…/bundle/webgpu`, `…/bundle/hugging-face-infer` (IIFE). ESM twins: `…/bundle/3d/es`, etc.
-
-## Script tags
-
-<sonic-code language="html">
-  <template>
-&lt;script src="https://cdn.example.org/concorde/concorde-core.bundle.js"&gt;&lt;/script&gt;
-&lt;script src="https://cdn.example.org/concorde/concorde-shader.bundle.js"&gt;&lt;/script&gt;
-&lt;sonic-shader image-ch0="/photo.jpg" image-shader="…"&gt;&lt;/sonic-shader&gt;
-  </template>
-</sonic-code>
-
-## SDUI (`js[]`)
-
-Scripts in the descriptor are **awaited** before nodes are created. A failed `loadJS` **throws** (no UI parse without deps). Prefer the IIFE `.bundle.js` files. Descriptors (`js[]`, `markup`, `innerHTML`) must be **trusted**.
-
-<sonic-code language="html">
-  <template>
-&lt;sonic-sdui props='{
-  "js": ["https://cdn.example.org/concorde/concorde-3d.bundle.js"],
-  "nodes": [{
-    "tagName": "sonic-3d",
-    "attributes": { "src": "https://cdn.jsdelivr.net/gh/KhronosGroup/glTF-Sample-Models@master/2.0/DamagedHelmet/glTF-Binary/DamagedHelmet.glb" }
-  }]
-}'&gt;&lt;/sonic-sdui&gt;
-  </template>
-</sonic-code>
-
-## Hugging Face — minimal bootstrap
-
-The CE alone is not enough: configure runtime + allowlist once (page script or app entry). The IIFE exposes `window.ConcordeHF`.
-
-<sonic-code language="html">
-  <template>
-&lt;script src="…/concorde-core.bundle.js"&gt;&lt;/script&gt;
-&lt;script src="…/concorde-hugging-face-infer.bundle.js"&gt;&lt;/script&gt;
-&lt;script&gt;
-  ConcordeHF.configureHuggingFace({
-    runtime: {
-      source: "cdn",
-      version: "4.3.0",
-      url: "https://cdn.example.org/vendor/hf-transformers/4.3.0/transformers.min.js",
-    },
-    models: ConcordeHF.defineHuggingFaceModels({
-      "multilingual-mini": {
-        task: "feature-extraction",
-        repo: "Xenova/paraphrase-multilingual-MiniLM-L12-v2",
-        revision: "&lt;sha&gt;",
-        options: { dtype: "q8" },
-      },
-    }),
-  });
-&lt;/script&gt;
-&lt;sonic-hugging-face-infer
-  model="multilingual-mini"
-  inputProvider="events"
-  outputProvider="search.vectors"
-&gt;&lt;/sonic-hugging-face-infer&gt;
-  </template>
-</sonic-code>
-
-Peer deps (npm, optional): `three@0.180.0`, `@huggingface/transformers@4.3.0`. Not needed when using the CDN IIFE addons (Three is inlined in `concorde-3d`; Transformers.js stays on its own CDN via `configureHuggingFace`).