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

package/src/addons/shader.ts

@@ -1,5 +0,0 @@
-/**
- * Entrée CDN / IIFE pour `sonic-shader` (hors bundle core).
- * Charger après `concorde-core.bundle.js`.
- */
-import "../core/components/functional/shader/shader";

package/src/addons/webgpu.ts

@@ -1,15 +0,0 @@
-/**
- * Entrée CDN / IIFE pour `sonic-webgpu` (hors bundle core).
- * Charger après `concorde-core.bundle.js`.
- */
-import "../core/components/functional/webgpu/webgpu";
-
-export {
-  buildWgslSource,
-  DEFAULT_MAIN_IMAGE,
-  parseBackendPrefer,
-  WebGl2FallbackRuntime,
-  WebGpuCompileError,
-  WebGpuRuntime,
-  SonicWebGpu,
-} from "../core/components/functional/webgpu/webgpu";

package/src/core/components/functional/3d/3d.md

@@ -1,161 +0,0 @@
-# 3D
-
-`sonic-3d` — viewer **Three.js** (glTF / GLB), caméra orbit / perspective / ortho, outputs dataProvider paresseux.
-
-Import opt-in (hors bundle `functional`) :
-
-<sonic-code language="javascript">
-  <template>
-import "@supersoniks/concorde/3d";
-import type {
-  Sonic3dConfig,
-  Sonic3dOutput,
-  Sonic3dAsset,
-  Sonic3dCameraMode,
-} from "@supersoniks/concorde/3d";
-  </template>
-</sonic-code>
-
-CDN (after the core): `concorde-3d.bundle.js` — see [CDN addons](#docs/_getting-started/cdn-addons.md/cdn-addons).
-
-## Démo (modèle CDN)
-
-`DamagedHelmet` (Khronos, jsDelivr). Orbit · zoom · pan · survol highlight · pick · double-clic = recentrer. Sans `src` : cube de démo. Molette : zoom tant qu’il reste de la marge ; aux bornes `minDistance` / `maxDistance`, le scroll page reprend.
-
-<docs-lit-demo for="docs-3d-orbit-demo"></docs-lit-demo>
-
-## Form auto-bind (`formDataProvider`)
-
-Comme `sonic-shader` : si `dataProvider` (ou un ancêtre `formDataProvider`) contient des champs aux **mêmes noms** que l’API, ils pilotent le viewer sans JS.
-
-| Champ form | Effet |
-|------------|--------|
-| `src` / `asset` | charge le modèle |
-| `camera` | mode caméra |
-| `fov` / `exposure` | optique |
-| `autoRotate` | rotation orbit |
-| `minDistance` / `maxDistance` | bornes zoom orbit |
-| `minPolar` / `maxPolar` | bornes verticale (degrés) |
-| `yaw` / `pitch` / `distance` | position orbit sphérique |
-
-Conseil : séparer `out-data-provider` du form. Les entrées pures (`fov`, `exposure`, `autoRotate`, `src`…) ne sont jamais réécrites en out sur un DP partagé. `yaw` / `distance` / `pitch` restent publiables ; un changement manuel d’orbit coupe `autoRotate`.
-
-Gate paresseuse : un `sonic-input name="yaw"` **ne** déclenche **pas** la publication out (seul un lecteur sur `ready` / `frame` / `cam*` / `hit*`… le fait).
-
-<docs-lit-demo for="docs-3d-form-demo"></docs-lit-demo>
-
-## Sortie / dataProvider
-
-Entrée : champs ci-dessus. Sortie (`Sonic3dOutput`) : `cam*` / `target*` / `distance` / `yaw` / `pitch` / `pointer*` / `ready` / `hit*`… With `frame-out` (or a listener on `frameUrl` / `snapshot`): lazy JPEG canvas capture → `frameUrl` + `snapshot` (`SonicMediaRef`). Event `out`. Publication **paresseuse**.
-
-<docs-lit-demo for="docs-3d-out-demo"></docs-lit-demo>
-
-## Caméras
-
-| `camera` | Usage |
-|----------|--------|
-| `orbit` (défaut) | Produit / modèle isolé — orbit + pan, polar limité |
-| `perspective` | Scène libre + pan |
-| `ortho` | Plans techniques / UI 3D |
-
-## Asset neutre (HF plus tard)
-
-```ts
-type Sonic3dAsset = {
-  kind?: "gltf" | "glb" | "obj" | "ply" | "url";
-  url?: string;
-  blob?: Blob;
-};
-```
-
-Le viewer lit `asset` ou `src` depuis le DP — la source (fetch, upload, HF) n’est pas couplée.
-
-## Attributs
-
-| Attribut | Rôle |
-|----------|------|
-| `src` | URL glTF / GLB (vide → démo) |
-| `camera` | `orbit` \| `perspective` \| `ortho` |
-| `fov` | FOV perspective (défaut 45) |
-| `exposure` | Tone mapping (défaut 1) |
-| `min-distance` | Zoom orbit mini (défaut 0.5) |
-| `max-distance` | Zoom orbit maxi (défaut 50 ; `0` = ∞) |
-| `min-polar` / `max-polar` | Angle vertical en **degrés** (défaut 8–172) |
-| `auto-rotate` | Rotation orbit |
-| `fit` | Fit bbox après load (défaut true) |
-| `pick` | Survol highlight + clic → event `pick` + `hit*` ; double-clic = fit |
-| `play` / `play-on-hover` | Boucle RAF |
-| `play-offscreen` | Garde RAF / runtime hors viewport (pont live `#id`) |
-| `release-offscreen` | Dispose renderer hors viewport (défaut true) sauf si `play-offscreen` / consommateur live |
-| `damping` | Inertie OrbitControls (défaut `0.08`, `0` = off) |
-| `dpr-max` | Cap devicePixelRatio (défaut 2) |
-| `dataProvider` / `out-data-provider` | Entrée / sortie |
-| `out-interval` | Throttle publication ms (défaut 80) |
-| `frame-out` | Publishes `frameUrl` + `snapshot` (canvas JPEG) for shader chaining |
-| `snapshot-interval` | Canvas capture throttle ms (default 250) |
-
-## Markup
-
-<sonic-code language="html">
-  <template>
-&lt;sonic-3d
-  src="https://cdn.jsdelivr.net/gh/KhronosGroup/glTF-Sample-Assets@main/Models/DamagedHelmet/glTF-Binary/DamagedHelmet.glb"
-  camera="orbit"
-  auto-rotate
-  pick
-  min-distance="1"
-  max-distance="10"
-&gt;&lt;/sonic-3d&gt;
-  </template>
-</sonic-code>
-
-## Shader bridging
-
-No shared WebGL context between `sonic-3d` and `sonic-shader`.
-
-| Need | Bridge |
-|------|--------|
-| **Live post** | `channel0="#plateau"` on `sonic-shader` (or DP `{ element }`) — canvas copy each frame via `SonicFrameSource` |
-| **Export / HF / freeze** | `frame-out` → `frameUrl` + `snapshot` (`SonicMediaRef` JPEG). Clone with `cloneMediaRef` before holding a frame |
-
-```html
-<!-- Live -->
-<sonic-3d id="plateau" play auto-rotate …></sonic-3d>
-<sonic-shader channel0="#plateau" image="…" play></sonic-shader>
-
-<!-- Export / freeze -->
-<sonic-3d frame-out out-data-provider="view3d" snapshot-interval="250" …></sonic-3d>
-```
-
-Demo: [Visual stack — 3D → shader live](#docs/_misc/visual-stack.md/visual-stack).
-
-Un `sonic-shader` / `sonic-webgpu` qui pointe `#id` s’enregistre via `registerFrameConsumer` : le 3D **continue hors viewport** (pas de dispose). Option explicite : `play-offscreen`.
-
-### Arrêt net
-
-`el.stopMotion()` coupe `autoRotate` et l’inertie OrbitControls. Quand la caméra est immobile depuis ~8 frames : event `rest` + champ out `moving: 0|1`. Attribut `damping` (défaut `0.08`, `0` = off).
-
-## Post FX (in-viewer)
-
-When `post-image` is set, the scene renders to an offscreen target with a **depth texture**, then ShaderToy-style passes run inside the same Three context (`post-buffer-a`…`post-image`). Same GLSL as `sonic-shader` (`mainImage`, `iChannel0–3`, `uParam0–3`, `sonicLinearDepth`).
-
-| Channel token | Source |
-|---------------|--------|
-| `scene` (default ch0) | Color render target |
-| `depth` | Depth texture from the scene pass |
-| `buffer-a`…`d` | Ping-pong buffers |
-| URL / `#id` | External texture (same as shader live bridge) |
-
-```html
-<sonic-3d
-  post-image="…GLSL…"
-  post-image-ch0="scene"
-  post-image-ch1="depth"
-  param0="0.5"
-  post-scale="1"
-></sonic-3d>
-```
-
-Demo: [Visual stack — post depth edges](#docs/_misc/visual-stack.md/visual-stack).
-
-Pick / orbit still use scene geometry; `frame-out` captures the **final** canvas after post.

package/src/core/components/functional/3d/3d.spec.ts

@@ -1,213 +0,0 @@
-import { expect, describe, it, afterEach, beforeAll } from "vitest";
-import TestUtils from "@supersoniks/concorde/test-utils/TestUtils";
-import type { OrbitControls } from "three/addons/controls/OrbitControls.js";
-import { Sonic3dCameraMode } from "./constants";
-import { orbit } from "./orbit";
-import { parse } from "./parse";
-import "./3d";
-import { Sonic3d } from "./3d";
-
-describe("parseCameraMode", () => {
-  it("accepte orbit / perspective / ortho", () => {
-    expect(parse.cameraMode("orbit")).toBe(Sonic3dCameraMode.Orbit);
-    expect(parse.cameraMode("PERSPECTIVE")).toBe(Sonic3dCameraMode.Perspective);
-    expect(parse.cameraMode("ortho")).toBe(Sonic3dCameraMode.Ortho);
-    expect(parse.cameraMode("nope")).toBe(Sonic3dCameraMode.Orbit);
-    expect(parse.cameraMode("")).toBe(Sonic3dCameraMode.Orbit);
-  });
-});
-
-describe("guessKind / parseAsset", () => {
-  it("détecte l’extension", () => {
-    expect(parse.guessKind("/a/model.glb")).toBe("glb");
-    expect(parse.guessKind("https://x/y.gltf?v=1")).toBe("gltf");
-    expect(parse.guessKind("/mesh.obj")).toBe("obj");
-    expect(parse.guessKind("/x.bin")).toBe("url");
-  });
-
-  it("parse string et objet", () => {
-    expect(parse.asset("/m.glb")).toEqual({ kind: "glb", url: "/m.glb" });
-    expect(parse.asset({ url: "/a.gltf", kind: "gltf" })).toEqual({
-      kind: "gltf",
-      url: "/a.gltf",
-    });
-    expect(parse.asset(null)).toBeNull();
-    expect(parse.asset({})).toBeNull();
-  });
-
-  it("accepte un Blob", () => {
-    const blob = new Blob([new Uint8Array([1, 2, 3])], {
-      type: "model/gltf-binary",
-    });
-    const a = parse.asset({ blob, kind: "glb" });
-    expect(a?.blob).toBe(blob);
-    expect(a?.kind).toBe("glb");
-  });
-});
-
-describe("toNum / isFormFlagOn", () => {
-  it("coerce nombre / string", () => {
-    expect(parse.toNum(3, 0)).toBe(3);
-    expect(parse.toNum("2.5", 0)).toBe(2.5);
-    expect(parse.toNum("x", 7)).toBe(7);
-  });
-
-  it("flag form checkbox unique", () => {
-    expect(parse.isFormFlagOn("true")).toBe(true);
-    expect(parse.isFormFlagOn(null)).toBe(false);
-    expect(parse.isFormFlagOn("false")).toBe(false);
-    expect(parse.isFormFlagOn(1)).toBe(true);
-    expect(parse.isFormFlagOn("on")).toBe(true);
-  });
-});
-
-describe("Sonic3d", () => {
-  afterEach(() => {
-    document.body.innerHTML = "";
-  });
-
-  beforeAll(() => {
-    if (typeof globalThis.ResizeObserver === "undefined") {
-      globalThis.ResizeObserver = class {
-        observe() {}
-        unobserve() {}
-        disconnect() {}
-      } as typeof ResizeObserver;
-    }
-    if (typeof globalThis.IntersectionObserver === "undefined") {
-      globalThis.IntersectionObserver = class {
-        observe() {}
-        unobserve() {}
-        disconnect() {}
-        takeRecords() {
-          return [];
-        }
-        root = null;
-        rootMargin = "";
-        thresholds = [];
-      } as typeof IntersectionObserver;
-    }
-  });
-
-  it("enregistre le custom element", () => {
-    expect(customElements.get("sonic-3d")).toBe(Sonic3d);
-  });
-
-  it("monte sans src (cube démo) et expose les attributs", async () => {
-    const el = TestUtils.bootstrap(
-      `<sonic-3d camera="perspective" fov="50" aspect-ratio="1"></sonic-3d>`,
-    )[0] as Sonic3d;
-    expect(el.camera).toBe(Sonic3dCameraMode.Perspective);
-    expect(el.fov).toBe(50);
-    expect(el.tagName.toLowerCase()).toBe("sonic-3d");
-    await el.updateComplete;
-  });
-
-  it("reste stable sans WebGL (jsdom)", async () => {
-    const el = TestUtils.bootstrap(
-      `<sonic-3d style="width:64px;height:64px"></sonic-3d>`,
-    )[0] as Sonic3d;
-    await new Promise((r) => setTimeout(r, 50));
-    await el.updateComplete;
-    expect(el).toBeInstanceOf(Sonic3d);
-  });
-});
-
-describe("orbit.wheelAffectsZoom", () => {
-  const mockControls = (opts: {
-    distance: number;
-    minDistance?: number;
-    maxDistance?: number;
-    orthographic?: boolean;
-    zoom?: number;
-    minZoom?: number;
-    maxZoom?: number;
-  }) =>
-    ({
-      minDistance: opts.minDistance ?? 1,
-      maxDistance: opts.maxDistance ?? 10,
-      minZoom: opts.minZoom ?? 0,
-      maxZoom: opts.maxZoom ?? Infinity,
-      getDistance: () => opts.distance,
-      object: opts.orthographic
-        ? { isOrthographicCamera: true, zoom: opts.zoom ?? 1 }
-        : { isPerspectiveCamera: true },
-    }) as unknown as OrbitControls;
-
-  it("perspective : bloque aux bornes dans le sens demandé", () => {
-    const atMin = mockControls({ distance: 1, minDistance: 1, maxDistance: 10 });
-    expect(orbit.wheelAffectsZoom(atMin, -1)).toBe(false);
-    expect(orbit.wheelAffectsZoom(atMin, 1)).toBe(true);
-
-    const atMax = mockControls({
-      distance: 10,
-      minDistance: 1,
-      maxDistance: 10,
-    });
-    expect(orbit.wheelAffectsZoom(atMax, 1)).toBe(false);
-    expect(orbit.wheelAffectsZoom(atMax, -1)).toBe(true);
-  });
-
-  it("perspective : maxDistance infini laisse zoom out", () => {
-    const c = mockControls({
-      distance: 1000,
-      minDistance: 1,
-      maxDistance: Infinity,
-    });
-    expect(orbit.wheelAffectsZoom(c, 1)).toBe(true);
-  });
-
-  it("ortho : bornes minZoom / maxZoom", () => {
-    const atMaxZoom = mockControls({
-      distance: 5,
-      orthographic: true,
-      zoom: 4,
-      maxZoom: 4,
-      minZoom: 0.5,
-    });
-    expect(orbit.wheelAffectsZoom(atMaxZoom, -1)).toBe(false);
-    expect(orbit.wheelAffectsZoom(atMaxZoom, 1)).toBe(true);
-  });
-});
-
-describe("wantsOffscreenPlay / frame consumers", () => {
-  it("playOffscreen ou consumers → true", async () => {
-    const { wantsOffscreenPlay } = await import("./playback");
-    expect(wantsOffscreenPlay({ playOffscreen: false, frameConsumerCount: 0 })).toBe(
-      false,
-    );
-    expect(wantsOffscreenPlay({ playOffscreen: true, frameConsumerCount: 0 })).toBe(
-      true,
-    );
-    expect(wantsOffscreenPlay({ playOffscreen: false, frameConsumerCount: 1 })).toBe(
-      true,
-    );
-  });
-
-  it("registerFrameConsumer incrémente le compteur", async () => {
-    const el = TestUtils.bootstrap(
-      `<sonic-3d style="width:64px;height:64px"></sonic-3d>`,
-      true,
-    )[0] as Sonic3d;
-    await el.updateComplete;
-    expect(el.frameConsumerCount).toBe(0);
-    const token = {};
-    el.registerFrameConsumer(token);
-    expect(el.frameConsumerCount).toBe(1);
-    expect(el.playOffscreen).toBe(false);
-    el.unregisterFrameConsumer(token);
-    expect(el.frameConsumerCount).toBe(0);
-  });
-
-  it("stopMotion coupe autoRotate", async () => {
-    const el = TestUtils.bootstrap(
-      `<sonic-3d auto-rotate style="width:64px;height:64px"></sonic-3d>`,
-      true,
-    )[0] as Sonic3d;
-    await el.updateComplete;
-    expect(el.autoRotate).toBe(true);
-    el.stopMotion();
-    expect(el.autoRotate).toBe(false);
-    expect(el.moving).toBe(0);
-  });
-});

package/src/core/components/functional/3d/3d.ts

@@ -1,284 +0,0 @@
-import { html } from "lit";
-import { customElement, state } from "lit/decorators.js";
-import { PublisherManager } from "@supersoniks/concorde/utils";
-import { ensure } from "./ensure";
-import { formBind, type FormOrbit } from "./form-bind";
-import { life } from "./life";
-import { outPublish } from "./out-publish";
-import { postBind } from "./post-bind";
-import type { SceneHit } from "./pick";
-import { playback } from "./playback";
-import { pointer } from "./pointer";
-import { Sonic3dProps } from "./props";
-import type { SceneRuntime } from "./scene-runtime";
-import { sonic3dStyles } from "./styles";
-import { propUpdate } from "./updated";
-import { wire } from "./wire";
-
-/** Frames sans mouvement avant `rest` / `moving=0`. */
-const REST_STILL_FRAMES = 8;
-/**
- * Viewer 3D Concorde (Three.js) — glTF/GLB, caméra orbit/perspective/ortho,
- * outputs dataProvider paresseux. Opt-in : `@supersoniks/concorde/3d`.
- */
-@customElement("sonic-3d")
-export class Sonic3d extends Sonic3dProps {
-  static styles = sonic3dStyles;
-
-  @state() errorMessage = "";
-
-  /** État runtime partagé avec les helpers (lu ici pour noUnusedLocals). */
-  runtime: SceneRuntime | null = null;
-  raf = 0;
-  startTime = 0;
-  frame = 0;
-  hovering = false;
-  pointerX = 0.5;
-  pointerY = 0.5;
-  lastHit: SceneHit | null = null;
-  outEventListeners = 0;
-  inView = true;
-  ready = false;
-  releasing = false;
-  loadToken = 0;
-  resizeObserver: ResizeObserver | null = null;
-  intersectionObserver: IntersectionObserver | null = null;
-  formPublisher: ReturnType<typeof PublisherManager.get> | null = null;
-  outPublisher: ReturnType<typeof PublisherManager.get> | null = null;
-  lastOutAt = 0;
-  lastSnapshotAt = 0;
-  snapshotBusy = false;
-  frameUrls: string[] = [];
-  snapshotSeq = 0;
-  /** Contrat SonicFrameSource — incrémenté après chaque render. */
-  frameSeq = 0;
-  lastDrawAt = 0;
-  lastFormOrbit: FormOrbit | null = null;
-  /** Consommateurs live (`registerFrameConsumer`). */
-  private frameConsumers = new Set<object>();
-  /** 1 si caméra en mouvement, 0 sinon (publié en out). */
-  moving = 0;
-  private stillFrames = 0;
-  private lastMotionYaw = NaN;
-  private lastMotionPitch = NaN;
-  private lastMotionDist = NaN;
-
-  get frameConsumerCount() {
-    return this.frameConsumers.size;
-  }
-
-  onFormMutation = () => {
-    const data = (this.formPublisher?.get() ?? {}) as Record<string, unknown>;
-    formBind.formParams.applyFormParams(this as never, data);
-  };
-
-  connectedCallback() {
-    super.connectedCallback();
-    // Lectures groupées : champs mutés via helpers (noUnusedLocals).
-    void [
-      this.pointerX,
-      this.pointerY,
-      this.lastHit,
-      this.inView,
-      this.releasing,
-      this.loadToken,
-      this.resizeObserver,
-      this.intersectionObserver,
-      this.formPublisher,
-      this.outPublisher,
-      this.lastOutAt,
-      this.lastSnapshotAt,
-      this.snapshotBusy,
-      this.frameUrls,
-      this.snapshotSeq,
-      this.lastFormOrbit,
-      this.syncAutoRotate,
-      this.syncPlayback,
-      this.bindOutPublisher,
-      this.onPointerMove,
-      this.onPointerDown,
-      this.onDblClick,
-      this.onPointerEnter,
-      this.onPointerLeave,
-      this.onFormMutation,
-      this.errorMessage,
-    ];
-    wire.connect(this as never);
-  }
-
-  override addEventListener(
-    type: string,
-    listener: EventListenerOrEventListenerObject | null,
-    options?: boolean | AddEventListenerOptions,
-  ): void {
-    if (type === "out" && listener) this.outEventListeners++;
-    super.addEventListener(type, listener as never, options);
-  }
-
-  override removeEventListener(
-    type: string,
-    listener: EventListenerOrEventListenerObject | null,
-    options?: boolean | EventListenerOptions,
-  ): void {
-    if (type === "out" && listener) {
-      this.outEventListeners = Math.max(0, this.outEventListeners - 1);
-    }
-    super.removeEventListener(type, listener as never, options);
-  }
-
-  disconnectedCallback() {
-    super.disconnectedCallback();
-    wire.disconnect(this as never);
-  }
-
-  protected firstUpdated() {
-    life.firstUpdated(this as never);
-  }
-
-  protected updated(changed: Map<string | number | symbol, unknown>) {
-    propUpdate.updated(this as never, changed);
-  }
-
-  syncAutoRotate = () => playback.syncAutoRotate(this as never);
-  syncPlayback = () => playback.syncPlayback(this as never, this.loop);
-  bindOutPublisher = () => life.bindOutPublisher(this as never);
-
-  private loop = () => {
-    this.raf = requestAnimationFrame(this.loop);
-    this.drawFrame(performance.now());
-    if (this.playOnHover && !this.hovering && !this.autoRotate) {
-      playback.stopLoop(this as never);
-    }
-  };
-
-  private drawFrame(now: number) {
-    if (!this.runtime || !this.ready) return;
-    this.frame++;
-    const time = (now - this.startTime) / 1000;
-    const timeDelta = Math.max(0, (now - this.lastDrawAt) / 1000);
-    this.lastDrawAt = now;
-    postBind.syncFrame(this as never, time, timeDelta, this.frame);
-    this.runtime.render();
-    this.frameSeq++;
-    this.trackMotion(time);
-    outPublish.maybePublish(this as never, now, time);
-  }
-
-  /**
-   * Enregistre un consommateur live (`sonic-shader` / `sonic-webgpu` via `#id`).
-   * Garde le RAF hors viewport tant qu’il reste au moins un token.
-   */
-  registerFrameConsumer(token: object = {}) {
-    this.frameConsumers.add(token);
-    ensure.syncVisibility(this as never);
-  }
-
-  unregisterFrameConsumer(token: object = {}) {
-    this.frameConsumers.delete(token);
-    ensure.syncVisibility(this as never);
-  }
-
-  /**
-   * Coupe `autoRotate` + inertie OrbitControls.
-   * Émet `rest` si la caméra était en mouvement.
-   */
-  stopMotion() {
-    this.autoRotate = false;
-    this.runtime?.stopMotion();
-    this.stillFrames = REST_STILL_FRAMES;
-    if (this.moving !== 0) {
-      this.moving = 0;
-      this.dispatchEvent(
-        new CustomEvent("rest", {
-          detail: { moving: 0 },
-          bubbles: true,
-          composed: true,
-        }),
-      );
-    }
-    this.syncPlayback();
-  }
-
-  private trackMotion(time: number) {
-    if (!this.runtime) return;
-    const snap = this.runtime.snapshot({
-      time,
-      frame: this.frame,
-      hovering: this.hovering ? 1 : 0,
-      pointerX: this.pointerX,
-      pointerY: this.pointerY,
-      hit: this.lastHit,
-    });
-    const eps = 1e-5;
-    const still =
-      Number.isFinite(this.lastMotionYaw) &&
-      Math.abs(snap.yaw - this.lastMotionYaw) < eps &&
-      Math.abs(snap.pitch - this.lastMotionPitch) < eps &&
-      Math.abs(snap.distance - this.lastMotionDist) < eps &&
-      !this.autoRotate;
-    this.lastMotionYaw = snap.yaw;
-    this.lastMotionPitch = snap.pitch;
-    this.lastMotionDist = snap.distance;
-    if (still) {
-      this.stillFrames++;
-      if (this.stillFrames >= REST_STILL_FRAMES && this.moving !== 0) {
-        this.moving = 0;
-        this.dispatchEvent(
-          new CustomEvent("rest", {
-            detail: { moving: 0, yaw: snap.yaw, pitch: snap.pitch },
-            bubbles: true,
-            composed: true,
-          }),
-        );
-      }
-    } else {
-      this.stillFrames = 0;
-      this.moving = 1;
-    }
-  }
-
-  /** Contrat SonicFrameSource — canvas Three (preserveDrawingBuffer). */
-  getFrameCanvas(): HTMLCanvasElement | null {
-    if (!this.runtime || !this.ready) return null;
-    return this.runtime.renderer.domElement;
-  }
-
-  onPointerMove = (e: PointerEvent) => pointer.onMove(this as never, e);
-  onPointerDown = (e: PointerEvent) => pointer.onDown(this as never, e);
-  onDblClick = () => pointer.onDblClick(this as never);
-  onPointerEnter = () => pointer.onEnter(this as never);
-  onPointerLeave = () => pointer.onLeave(this as never);
-
-  render() {
-    return html`
-      <canvas part="canvas"></canvas>
-      ${this.errorMessage
-        ? html`<div class="err" part="error">${this.errorMessage}</div>`
-        : null}
-    `;
-  }
-}
-
-export { Sonic3dCameraMode } from "./constants";
-export type {
-  Sonic3dAsset,
-  Sonic3dConfig,
-  Sonic3dOutput,
-} from "./types";
-export type { SonicMediaRef, SonicFrameSource, SonicFrameConsumerHost } from "@supersoniks/concorde/core/utils/mediaRef";
-export {
-  toMediaUrl,
-  cloneMediaRef,
-  isFrameSource,
-  isFrameConsumerHost,
-  FrameConsumerRegistry,
-} from "@supersoniks/concorde/core/utils/mediaRef";
-export { wantsOffscreenPlay } from "./playback";
-export { frameCapture } from "./frame-capture";
-export { frameSource } from "./frame-source";
-
-declare global {
-  interface HTMLElementTagNameMap {
-    "sonic-3d": Sonic3d;
-  }
-}

package/src/core/components/functional/3d/asset.ts

@@ -1,22 +0,0 @@
-import { PublisherManager } from "@supersoniks/concorde/utils";
-import { parse } from "./parse";
-import type { Sonic3dAsset } from "./types";
-
-/** Résout asset prioritaire : prop → src → DP. */
-function resolve(
-  host: { asset: Sonic3dAsset | null; src: string },
-  formPublisher: ReturnType<typeof PublisherManager.get> | null,
-): Sonic3dAsset | null {
-  if (host.asset?.url || host.asset?.blob) return host.asset;
-  const fromSrc = parse.asset(host.src);
-  if (fromSrc) return fromSrc;
-  const data = (formPublisher?.get() ?? {}) as Record<string, unknown>;
-  if ("asset" in data) {
-    const a = parse.asset(data.asset);
-    if (a) return a;
-  }
-  if ("src" in data) return parse.asset(data.src);
-  return null;
-}
-
-export const asset = { resolve } as const;