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

package/dist/js/core/components/functional/webgpu/webgpu.js

@@ -0,0 +1,667 @@
+/// <reference types="@webgpu/types" />
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { css, html, LitElement } from "lit";
+import { customElement, property, state } from "lit/decorators.js";
+import { Canvas2dFallbackRuntime } from "./canvas2d-fallback";
+import { formBind } from "./form-bind";
+import { WebGl2FallbackRuntime } from "./gl-fallback";
+import { WebGpuRuntime } from "./gpu-runtime";
+import { CHANNEL_FORM_KEYS, LOG_PREFIX, prefersReducedMotion } from "./helpers";
+import { outFrame } from "./out-frame";
+import { ParticlesRuntime } from "./particles-runtime";
+import { pointer } from "./pointer";
+import { parseBackendPrefer, parseKernel, WebGpuCompileError } from "./types";
+const tagName = "sonic-webgpu";
+/**
+ * Renderer WebGPU (passe fullscreen WGSL / kernel particles), fallback WebGL2 puis Canvas2D.
+ * Opt-in: import `@supersoniks/concorde/webgpu`.
+ *
+ * Glue : `dataProvider` → `channel0…3` + `param0…3` (string | SonicMediaRef).
+ * Snapshot DP (`frameUrl` / `snapshot`) uniquement si `frame-out` (3d accepte aussi un listener seul).
+ * Défaut `backend="auto"` : WGSL custom → WebGPU puis WebGL2 ; sinon WebGL2 puis WebGPU ; Canvas2D en dernier.
+ */
+let SonicWebGpu = class SonicWebGpu extends LitElement {
+    constructor() {
+        super(...arguments);
+        /** Corps WGSL avec `fn mainImage(uv, fragCoord) -> vec4f` (kernel image). */
+        this.shader = "";
+        /**
+         * `particles` — simulation compute (démarque de sonic-shader).
+         * `image` / vide — fullscreen + canaux.
+         */
+        this.kernel = "";
+        /**
+         * `auto` (défaut) | `webgpu` | `webgl2`.
+         * En `auto`, fallback WebGL2 si adapter WebGPU absent.
+         */
+        this.backendPrefer = "auto";
+        /** Backend réellement utilisé (reflect). */
+        this.activeBackend = "";
+        this.channel0 = "";
+        this.channel1 = "";
+        this.channel2 = "";
+        this.channel3 = "";
+        this.play = true;
+        this.mouse = true;
+        this.releaseOffscreen = false;
+        this.dprMax = 2;
+        this.param0 = 0;
+        this.param1 = 0;
+        this.param2 = 0;
+        this.param3 = 0;
+        this.dataProvider = "";
+        this.outDataProvider = "";
+        this.outInterval = 80;
+        /** Publie `frameUrl` + `snapshot` (SonicMediaRef) vers le out-DP. */
+        this.frameOut = false;
+        this.aspectRatio = "";
+        this.errorMessage = "";
+        this.fallbackNotice = "";
+        /** Canvas hors template Lit — évite destroy/recreate du contexte GL. */
+        this.canvasEl = null;
+        /** État partagé avec form-bind / out-frame / pointer (pattern sonic-3d). */
+        this.runtime = null;
+        this.raf = 0;
+        this.startTime = 0;
+        this.frame = 0;
+        this.mouseVec = [0, 0, 0, 0];
+        /** Cible normalisée (0–1, origine haut-gauche) depuis dataProvider — tracking / DP. */
+        this.remoteTarget = null;
+        this.hovering = false;
+        this.outEventListeners = 0;
+        this.releasing = false;
+        this.inView = true;
+        this.resizeObserver = null;
+        this.intersectionObserver = null;
+        this.rebuildToken = 0;
+        this.ready = false;
+        /** Évite deux boots concurrents (IO + rAF) qui disposent le fallback. */
+        this.boot = null;
+        this.formPublisher = null;
+        this.outPublisher = null;
+        this.lastOutAt = 0;
+        this.lastFrameUrl = "";
+        this.frameOutBusy = false;
+        this.frameOutSeq = 0;
+        this.onFormMutation = () => {
+            const data = (this.formPublisher?.get() ?? {});
+            formBind.applyFormParams(this, data);
+        };
+        this.onPointerMove = (e) => pointer.onMove(this, e);
+        this.onPointerDown = (e) => pointer.onDown(this, e);
+        this.onPointerUp = () => pointer.onUp(this);
+        this.onPointerEnter = () => pointer.onEnter(this);
+        this.onPointerLeave = () => pointer.onLeave(this);
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.addEventListener("pointermove", this.onPointerMove);
+        this.addEventListener("pointerdown", this.onPointerDown);
+        this.addEventListener("pointerup", this.onPointerUp);
+        this.addEventListener("pointerleave", this.onPointerLeave);
+        this.addEventListener("pointerenter", this.onPointerEnter);
+        this.bindFormProvider();
+        this.bindOutPublisher();
+    }
+    addEventListener(type, listener, options) {
+        if (type === "out" && listener)
+            this.outEventListeners++;
+        super.addEventListener(type, listener, options);
+    }
+    removeEventListener(type, listener, options) {
+        if (type === "out" && listener) {
+            this.outEventListeners = Math.max(0, this.outEventListeners - 1);
+        }
+        super.removeEventListener(type, listener, options);
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.removeEventListener("pointermove", this.onPointerMove);
+        this.removeEventListener("pointerdown", this.onPointerDown);
+        this.removeEventListener("pointerup", this.onPointerUp);
+        this.removeEventListener("pointerleave", this.onPointerLeave);
+        this.removeEventListener("pointerenter", this.onPointerEnter);
+        this.unbindFormProvider();
+        this.revokeFrameUrl();
+        this.frameOutSeq++;
+        this.frameOutBusy = false;
+        this.resizeObserver?.disconnect();
+        this.intersectionObserver?.disconnect();
+        this.rebuildToken++;
+        this.releasing = true;
+        this.releaseRuntime();
+        this.outPublisher = null;
+        this.releasing = false;
+    }
+    firstUpdated() {
+        this.ensureCanvas();
+        this.resizeObserver = new ResizeObserver(() => {
+            this.syncSize();
+            // Taille souvent 0 au premier layout docs — relancer la boucle dès que OK
+            if (this.ready && this.runtime)
+                this.syncPlayback();
+        });
+        this.resizeObserver.observe(this);
+        this.intersectionObserver = new IntersectionObserver((entries) => {
+            this.inView = entries.some((e) => e.isIntersecting);
+            this.syncVisibility();
+        }, 
+        // Anticiper un peu le viewport docs (évite écran noir avant le 1er pixel visible)
+        { threshold: 0, rootMargin: "80px 0px" });
+        this.intersectionObserver.observe(this);
+        this.bindFormProvider();
+        this.bindOutPublisher();
+        // Toujours booter : la boucle RAF attend inView, pas le device
+        requestAnimationFrame(() => {
+            void this.ensureRuntime();
+        });
+    }
+    updated(changed) {
+        if ((changed.has("backendPrefer") || changed.has("kernel")) &&
+            (this.runtime || this.boot)) {
+            this.releaseRuntime();
+            this.activeBackend = "";
+            void this.ensureRuntime();
+            return;
+        }
+        if (!this.runtime)
+            return;
+        const keys = ["shader", ...CHANNEL_FORM_KEYS];
+        if (keys.some((k) => changed.has(k))) {
+            if (changed.has("shader") && this.runtime.backend === "webgl2") {
+                this.fallbackNotice = this.shader.trim()
+                    ? "WebGL2 (fallback) — WGSL ignoré, canaux/params OK"
+                    : "WebGL2 (fallback)";
+            }
+            void this.rebuild();
+        }
+        if (changed.has("play"))
+            this.syncPlayback();
+        if (changed.has("dataProvider") || changed.has("outDataProvider")) {
+            this.bindFormProvider();
+            this.bindOutPublisher();
+        }
+        if (changed.has("aspectRatio"))
+            this.applyAspectRatio();
+    }
+    applyAspectRatio(textureUrl) {
+        const forced = this.aspectRatio.trim();
+        if (forced) {
+            this.style.setProperty("--sonic-webgpu-ar", forced.includes("/") ? forced : forced.replace(":", " / "));
+            return;
+        }
+        const url = textureUrl || this.channel0;
+        const size = url ? this.runtime?.getTextureSize(url) : null;
+        if (size) {
+            this.style.setProperty("--sonic-webgpu-ar", `${size.width} / ${size.height}`);
+            return;
+        }
+        this.style.removeProperty("--sonic-webgpu-ar");
+    }
+    unbindFormProvider() {
+        formBind.unbindFormProvider(this);
+    }
+    bindFormProvider() {
+        formBind.bindFormProvider(this);
+    }
+    bindOutPublisher() {
+        formBind.bindOutPublisher(this);
+    }
+    applyRemoteMouse() {
+        formBind.applyRemoteMouse(this);
+    }
+    ensureRuntime() {
+        if (this.runtime || this.releasing)
+            return this.boot ?? Promise.resolve();
+        if (!this.boot) {
+            this.boot = this.bootRuntime().finally(() => {
+                this.boot = null;
+            });
+        }
+        return this.boot;
+    }
+    async bootRuntime() {
+        this.ensureCanvas();
+        const prefer = parseBackendPrefer(this.backendPrefer);
+        const kernel = parseKernel(this.kernel);
+        const log = [];
+        try {
+            let runtime = null;
+            if (kernel === "particles") {
+                try {
+                    runtime = await ParticlesRuntime.create(this.ensureCanvas());
+                    log.push(`particles:${runtime.backend}`);
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    throw new Error(`particles:${msg}`);
+                }
+            }
+            else {
+                const tryWebgl2 = () => {
+                    try {
+                        runtime = WebGl2FallbackRuntime.create(this.ensureCanvas());
+                        log.push("webgl2:ok");
+                        return true;
+                    }
+                    catch (e) {
+                        const msg = e instanceof Error ? e.message : String(e);
+                        log.push(`webgl2:${msg}`);
+                        console.warn(`${LOG_PREFIX} WebGL2 failed:`, msg);
+                        this.replaceCanvas();
+                        return false;
+                    }
+                };
+                const tryWebgpu = async () => {
+                    if (typeof navigator.gpu === "undefined") {
+                        log.push("webgpu:no-navigator.gpu");
+                        return false;
+                    }
+                    const probe = await WebGpuRuntime.probe();
+                    if (probe) {
+                        log.push(`webgpu:probe:${probe}`);
+                        return false;
+                    }
+                    try {
+                        runtime = await WebGpuRuntime.create(this.ensureCanvas());
+                        log.push("webgpu:ok");
+                        return true;
+                    }
+                    catch (e) {
+                        const msg = e instanceof Error ? e.message : String(e);
+                        log.push(`webgpu:create:${msg}`);
+                        console.warn(`${LOG_PREFIX} WebGPU failed:`, msg);
+                        this.replaceCanvas();
+                        return false;
+                    }
+                };
+                if (prefer === "webgpu") {
+                    if (!(await tryWebgpu())) {
+                        throw new Error(log.join(" → ") || "WebGPU indisponible");
+                    }
+                }
+                else if (prefer === "webgl2") {
+                    if (!tryWebgl2()) {
+                        throw new Error(log.join(" → ") || "WebGL2 indisponible");
+                    }
+                }
+                else {
+                    // auto : WGSL custom → WebGPU d’abord (sinon fallback GLSL ignore le shader)
+                    const preferWgpuFirst = !!this.shader.trim();
+                    const ok = preferWgpuFirst
+                        ? (await tryWebgpu()) || tryWebgl2()
+                        : tryWebgl2() || (await tryWebgpu());
+                    if (!ok) {
+                        try {
+                            runtime = Canvas2dFallbackRuntime.create(this.ensureCanvas());
+                            log.push("canvas2d:ok");
+                        }
+                        catch (e) {
+                            const msg = e instanceof Error ? e.message : String(e);
+                            throw new Error([...log, `canvas2d:${msg}`].join(" → "));
+                        }
+                    }
+                }
+            }
+            if (!runtime) {
+                throw new Error(log.join(" → ") || "Aucun backend GPU");
+            }
+            if (this.releasing) {
+                runtime.dispose(true);
+                return;
+            }
+            this.runtime = runtime;
+            const backend = runtime.backend;
+            this.activeBackend = backend;
+            let notice = "";
+            if (kernel === "particles") {
+                notice =
+                    backend === "webgpu"
+                        ? "Compute particles (WebGPU)"
+                        : "Particles (Canvas2D fallback)";
+            }
+            else if (backend === "webgl2" && this.shader.trim()) {
+                notice = "WebGL2 — WGSL ignoré (canaux/params OK)";
+            }
+            else if (backend === "canvas2d") {
+                notice = `Canvas2D — ${log.filter((l) => !l.endsWith(":ok")).join(" · ") || "GPU indisponible"}`;
+            }
+            this.fallbackNotice = notice;
+            this.errorMessage = "";
+            console.info(`${LOG_PREFIX} backend:`, backend, "kernel:", kernel, log);
+            this.dispatchEvent(new CustomEvent("backend", {
+                detail: { backend, prefer, kernel, log },
+                bubbles: true,
+                composed: true,
+            }));
+            await this.rebuild();
+        }
+        catch (e) {
+            this.errorMessage = e instanceof Error ? e.message : String(e);
+            this.activeBackend = "";
+            this.fallbackNotice = "";
+            console.error(`${LOG_PREFIX} boot failed:`, this.errorMessage, log);
+            this.dispatchEvent(new CustomEvent("error", {
+                detail: { message: this.errorMessage, log },
+                bubbles: true,
+                composed: true,
+            }));
+        }
+    }
+    ensureCanvas() {
+        if (this.canvasEl?.isConnected)
+            return this.canvasEl;
+        const stage = this.renderRoot.querySelector(".stage") ??
+            this.renderRoot;
+        let canvas = stage.querySelector?.("canvas");
+        if (!canvas) {
+            canvas = document.createElement("canvas");
+            canvas.setAttribute("part", "canvas");
+            stage.appendChild(canvas);
+        }
+        canvas.style.touchAction = "none";
+        canvas.style.cursor = this.mouse ? "crosshair" : "default";
+        this.canvasEl = canvas;
+        return canvas;
+    }
+    /** Jette le canvas (verrouillé webgpu/webgl) et en crée un neuf. */
+    replaceCanvas() {
+        const stage = this.renderRoot.querySelector(".stage") ??
+            this.renderRoot;
+        if (this.canvasEl?.parentNode) {
+            this.canvasEl.parentNode.removeChild(this.canvasEl);
+        }
+        const canvas = document.createElement("canvas");
+        canvas.setAttribute("part", "canvas");
+        stage.appendChild(canvas);
+        this.canvasEl = canvas;
+        return canvas;
+    }
+    releaseRuntime() {
+        this.stopLoop();
+        this.ready = false;
+        this.runtime?.dispose(true);
+        this.runtime = null;
+        if (this.canvasEl?.parentNode) {
+            this.canvasEl.parentNode.removeChild(this.canvasEl);
+        }
+        this.canvasEl = null;
+    }
+    async rebuild() {
+        if (!this.runtime)
+            return;
+        const token = ++this.rebuildToken;
+        this.ready = false;
+        try {
+            await this.runtime.setShader(this.shader);
+            if (token !== this.rebuildToken)
+                return;
+            if (this.runtime instanceof WebGl2FallbackRuntime) {
+                await this.runtime.setChannels([
+                    this.channel0,
+                    this.channel1,
+                    this.channel2,
+                    this.channel3,
+                ]);
+            }
+            else {
+                await Promise.all([
+                    this.runtime.setChannel(0, this.channel0),
+                    this.runtime.setChannel(1, this.channel1),
+                    this.runtime.setChannel(2, this.channel2),
+                    this.runtime.setChannel(3, this.channel3),
+                ]);
+            }
+            if (token !== this.rebuildToken)
+                return;
+            this.errorMessage = "";
+            this.ready = true;
+            this.syncSize();
+            this.applyAspectRatio(this.channel0);
+            this.startTime = performance.now();
+            this.frame = 0;
+            this.syncPlayback();
+        }
+        catch (e) {
+            const message = e instanceof WebGpuCompileError
+                ? e.infoLog
+                    ? `${e.message}\n${e.infoLog}`
+                    : e.message
+                : e instanceof Error
+                    ? e.message
+                    : String(e);
+            this.errorMessage = message;
+            this.dispatchEvent(new CustomEvent("error", {
+                detail: { message, infoLog: e instanceof WebGpuCompileError ? e.infoLog : undefined },
+                bubbles: true,
+                composed: true,
+            }));
+        }
+    }
+    syncSize() {
+        if (!this.runtime)
+            return;
+        const rect = this.getBoundingClientRect();
+        const dpr = Math.min(typeof devicePixelRatio === "number" ? devicePixelRatio : 1, Number.isFinite(this.dprMax) && this.dprMax > 0 ? this.dprMax : 2);
+        this.runtime.resize(rect.width * dpr, rect.height * dpr);
+    }
+    syncVisibility() {
+        if (!this.inView && this.releaseOffscreen) {
+            this.stopLoop();
+            return;
+        }
+        if (!this.runtime) {
+            void this.ensureRuntime();
+            return;
+        }
+        this.syncSize();
+        this.syncPlayback();
+    }
+    shouldPlay() {
+        return (!!this.play &&
+            !!this.runtime &&
+            this.ready &&
+            !this.errorMessage &&
+            !prefersReducedMotion() &&
+            (this.inView || !this.releaseOffscreen));
+    }
+    syncPlayback() {
+        if (!this.ready || !this.runtime)
+            return;
+        if (this.shouldPlay())
+            this.startLoop();
+        else
+            this.stopLoop();
+    }
+    startLoop() {
+        if (this.raf)
+            return;
+        const tick = (now) => {
+            this.raf = 0;
+            if (this.runtime && this.ready) {
+                this.syncSize();
+                const w = this.runtime.canvas.width;
+                const h = this.runtime.canvas.height;
+                if (w >= 2 && h >= 2) {
+                    try {
+                        if (!this.startTime)
+                            this.startTime = now;
+                        const time = (now - this.startTime) / 1000;
+                        this.applyRemoteMouse();
+                        this.runtime.draw({
+                            width: w,
+                            height: h,
+                            time,
+                            frame: this.frame,
+                            mouse: this.mouseVec,
+                            params: [this.param0, this.param1, this.param2, this.param3],
+                        });
+                        this.frame++;
+                        this.maybePublishOut(now, time);
+                    }
+                    catch (e) {
+                        console.warn(`${LOG_PREFIX} frame skip:`, e);
+                    }
+                }
+            }
+            if (this.shouldPlay()) {
+                this.raf = requestAnimationFrame(tick);
+            }
+        };
+        this.raf = requestAnimationFrame(tick);
+    }
+    stopLoop() {
+        if (this.raf) {
+            cancelAnimationFrame(this.raf);
+            this.raf = 0;
+        }
+    }
+    maybePublishOut(now, time) {
+        outFrame.maybePublishOut(this, now, time);
+    }
+    revokeFrameUrl() {
+        outFrame.revokeFrameUrl(this);
+    }
+    render() {
+        return html `
+      <div class="stage" part="stage"></div>
+      ${this.errorMessage
+            ? html `<div class="err" part="error">${this.errorMessage}</div>`
+            : this.fallbackNotice
+                ? html `<div class="notice" part="notice">${this.fallbackNotice}</div>`
+                : null}
+    `;
+    }
+};
+SonicWebGpu.styles = css `
+    :host {
+      display: block;
+      position: relative;
+      width: 100%;
+      max-width: 100%;
+      height: auto;
+      aspect-ratio: var(--sonic-webgpu-ar, 16 / 9);
+      overflow: hidden;
+      background: #0a0a0a;
+      color: #f87171;
+      font: 12px/1.4 ui-monospace, monospace;
+    }
+    canvas {
+      position: absolute;
+      inset: 0;
+      width: 100%;
+      height: 100%;
+      display: block;
+      touch-action: none;
+    }
+    .stage {
+      position: absolute;
+      inset: 0;
+    }
+    .err {
+      position: absolute;
+      inset: 0;
+      z-index: 1;
+      padding: 0.75rem;
+      background: rgba(0, 0, 0, 0.85);
+      white-space: pre-wrap;
+      overflow: auto;
+    }
+    .notice {
+      position: absolute;
+      left: 0.5rem;
+      bottom: 0.5rem;
+      z-index: 1;
+      padding: 0.25rem 0.5rem;
+      border-radius: 0.25rem;
+      background: rgba(0, 0, 0, 0.65);
+      color: #fbbf24;
+      font-size: 11px;
+      pointer-events: none;
+    }
+  `;
+__decorate([
+    property()
+], SonicWebGpu.prototype, "shader", void 0);
+__decorate([
+    property({ type: String })
+], SonicWebGpu.prototype, "kernel", void 0);
+__decorate([
+    property({ type: String, attribute: "backend" })
+], SonicWebGpu.prototype, "backendPrefer", void 0);
+__decorate([
+    property({ type: String, reflect: true, attribute: "active-backend" })
+], SonicWebGpu.prototype, "activeBackend", void 0);
+__decorate([
+    property()
+], SonicWebGpu.prototype, "channel0", void 0);
+__decorate([
+    property()
+], SonicWebGpu.prototype, "channel1", void 0);
+__decorate([
+    property()
+], SonicWebGpu.prototype, "channel2", void 0);
+__decorate([
+    property()
+], SonicWebGpu.prototype, "channel3", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], SonicWebGpu.prototype, "play", void 0);
+__decorate([
+    property({ type: Boolean })
+], SonicWebGpu.prototype, "mouse", void 0);
+__decorate([
+    property({ type: Boolean, attribute: "release-offscreen" })
+], SonicWebGpu.prototype, "releaseOffscreen", void 0);
+__decorate([
+    property({ type: Number, attribute: "dpr-max" })
+], SonicWebGpu.prototype, "dprMax", void 0);
+__decorate([
+    property({ type: Number, attribute: "param0" })
+], SonicWebGpu.prototype, "param0", void 0);
+__decorate([
+    property({ type: Number, attribute: "param1" })
+], SonicWebGpu.prototype, "param1", void 0);
+__decorate([
+    property({ type: Number, attribute: "param2" })
+], SonicWebGpu.prototype, "param2", void 0);
+__decorate([
+    property({ type: Number, attribute: "param3" })
+], SonicWebGpu.prototype, "param3", void 0);
+__decorate([
+    property({ type: String })
+], SonicWebGpu.prototype, "dataProvider", void 0);
+__decorate([
+    property({ type: String, attribute: "out-data-provider" })
+], SonicWebGpu.prototype, "outDataProvider", void 0);
+__decorate([
+    property({ type: Number, attribute: "out-interval" })
+], SonicWebGpu.prototype, "outInterval", void 0);
+__decorate([
+    property({ type: Boolean, attribute: "frame-out" })
+], SonicWebGpu.prototype, "frameOut", void 0);
+__decorate([
+    property({ type: String, attribute: "aspect-ratio" })
+], SonicWebGpu.prototype, "aspectRatio", void 0);
+__decorate([
+    state()
+], SonicWebGpu.prototype, "errorMessage", void 0);
+__decorate([
+    state()
+], SonicWebGpu.prototype, "fallbackNotice", void 0);
+SonicWebGpu = __decorate([
+    customElement(tagName)
+], SonicWebGpu);
+export { SonicWebGpu };
+export { parseBackendPrefer, parseKernel, WebGpuCompileError } from "./types";
+export { buildWgslSource, DEFAULT_MAIN_IMAGE } from "./wgsl-prelude";
+export { WebGpuRuntime } from "./gpu-runtime";
+export { WebGl2FallbackRuntime } from "./gl-fallback";
+export { Canvas2dFallbackRuntime } from "./canvas2d-fallback";
+export { ParticlesRuntime } from "./particles-runtime";
+//# sourceMappingURL=webgpu.js.map