@aura3d/assets 3.0.0 → 4.0.0

package/dist/KTX2TranscodeDriver.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Shared KTX2/Basis transcode driver (PRD-05 §7.4). Consumes an initialised
+ * Basis Universal `BASIS` module — the same instance shape in a worker
+ * (`importScripts` + `wasmBinary`) and on the main thread (node, vendored
+ * UMD evaluated as CJS). Never touches the network itself: the wasm binary
+ * and module are provided by the caller.
+ */
+/** TranscoderFormat enum from the Basis Universal transcoder (three r185 table). */
+export declare const BASIS_TRANSCODER_FORMAT: {
+    readonly ETC1: 0;
+    readonly ETC2: 1;
+    readonly BC1: 2;
+    readonly BC3: 3;
+    readonly BC7_M6_OPAQUE_ONLY: 6;
+    readonly BC7_M5: 7;
+    readonly ASTC_4x4: 10;
+    readonly RGBA32: 13;
+};
+import type { KTX2BasisTargetFormat } from "./KTX2TargetSelection.js";
+export declare function basisTranscoderFormat(target: KTX2BasisTargetFormat): number;
+export interface BasisKTX2FileLike {
+    isValid(): boolean;
+    isUASTC(): boolean;
+    isETC1S(): boolean;
+    isHDR?(): boolean;
+    getWidth(): number;
+    getHeight(): number;
+    getLayers(): number;
+    getLevels(): number;
+    getFaces(): number;
+    getHasAlpha(): boolean;
+    getDFDFlags?(): number;
+    getImageLevelInfo(level: number, layer: number, face: number): {
+        readonly width: number;
+        readonly height: number;
+        readonly origWidth: number;
+        readonly origHeight: number;
+        readonly numBlocksX?: number;
+        readonly numBlocksY?: number;
+    };
+    getImageTranscodedSizeInBytes(level: number, layer: number, face: number, format: number): number;
+    startTranscoding(): boolean;
+    transcodeImage(dst: Uint8Array, level: number, layer: number, face: number, format: number, unused0: number, unused1: number, unused2: number): boolean;
+    close(): void;
+    delete(): void;
+}
+export interface BasisModuleLike {
+    initializeBasis(): void;
+    readonly KTX2File: new (data: Uint8Array) => BasisKTX2FileLike;
+}
+export interface KTX2TranscodedLevel {
+    readonly width: number;
+    readonly height: number;
+    readonly data: Uint8Array;
+}
+export interface KTX2TranscodeResult {
+    readonly width: number;
+    readonly height: number;
+    readonly isUASTC: boolean;
+    readonly hasAlpha: boolean;
+    readonly levels: readonly KTX2TranscodedLevel[];
+}
+/**
+ * Transcodes every mip level (largest first) of a KTX2 container to
+ * `transcoderFormat` (a `BASIS_TRANSCODER_FORMAT` value). Levels whose true
+ * dimensions exceed `maxDimension` are skipped — `startTranscoding` avoids
+ * touching their payloads entirely.
+ */
+export declare function transcodeKTX2Levels(basis: BasisModuleLike, bytes: Uint8Array, transcoderFormat: number, maxDimension?: number): KTX2TranscodeResult;
+//# sourceMappingURL=KTX2TranscodeDriver.d.ts.map

package/dist/KTX2TranscodeDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KTX2TranscodeDriver.d.ts","sourceRoot":"","sources":["../../../../packages/assets/src/KTX2TranscodeDriver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oFAAoF;AACpF,eAAO,MAAM,uBAAuB;;;;;;;;;CAS1B,CAAC;AAEX,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAW3E;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,IAAI,OAAO,CAAC;IACnB,OAAO,IAAI,OAAO,CAAC;IACnB,OAAO,IAAI,OAAO,CAAC;IACnB,KAAK,CAAC,IAAI,OAAO,CAAC;IAClB,QAAQ,IAAI,MAAM,CAAC;IACnB,SAAS,IAAI,MAAM,CAAC;IACpB,SAAS,IAAI,MAAM,CAAC;IACpB,SAAS,IAAI,MAAM,CAAC;IACpB,QAAQ,IAAI,MAAM,CAAC;IACnB,WAAW,IAAI,OAAO,CAAC;IACvB,WAAW,CAAC,IAAI,MAAM,CAAC;IACvB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxO,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAClG,gBAAgB,IAAI,OAAO,CAAC;IAC5B,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACxJ,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,IAAI,IAAI,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,UAAU,KAAK,iBAAiB,CAAC;CAChE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACjD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,UAAU,EACjB,gBAAgB,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,mBAAmB,CAuDrB"}

package/dist/KTX2TranscodeDriver.js

@@ -0,0 +1,104 @@
+/**
+ * Shared KTX2/Basis transcode driver (PRD-05 §7.4). Consumes an initialised
+ * Basis Universal `BASIS` module — the same instance shape in a worker
+ * (`importScripts` + `wasmBinary`) and on the main thread (node, vendored
+ * UMD evaluated as CJS). Never touches the network itself: the wasm binary
+ * and module are provided by the caller.
+ */
+/** TranscoderFormat enum from the Basis Universal transcoder (three r185 table). */
+export const BASIS_TRANSCODER_FORMAT = {
+    ETC1: 0,
+    ETC2: 1,
+    BC1: 2,
+    BC3: 3,
+    BC7_M6_OPAQUE_ONLY: 6,
+    BC7_M5: 7,
+    ASTC_4x4: 10,
+    RGBA32: 13
+};
+export function basisTranscoderFormat(target) {
+    switch (target) {
+        case "astc-4x4-rgba-unorm": return BASIS_TRANSCODER_FORMAT.ASTC_4x4;
+        case "bc7-rgba-unorm": return BASIS_TRANSCODER_FORMAT.BC7_M5;
+        case "etc2-rgba8unorm": return BASIS_TRANSCODER_FORMAT.ETC2;
+        case "etc2-rgb8unorm": return BASIS_TRANSCODER_FORMAT.ETC2;
+        case "bc3-rgba-unorm": return BASIS_TRANSCODER_FORMAT.BC3;
+        case "bc1-rgb-unorm": return BASIS_TRANSCODER_FORMAT.BC1;
+        case "rgba8": return BASIS_TRANSCODER_FORMAT.RGBA32;
+        default: throw new Error(`KTX2/Basis target format ${String(target)} is unsupported`);
+    }
+}
+/**
+ * Transcodes every mip level (largest first) of a KTX2 container to
+ * `transcoderFormat` (a `BASIS_TRANSCODER_FORMAT` value). Levels whose true
+ * dimensions exceed `maxDimension` are skipped — `startTranscoding` avoids
+ * touching their payloads entirely.
+ */
+export function transcodeKTX2Levels(basis, bytes, transcoderFormat, maxDimension) {
+    const file = new basis.KTX2File(bytes);
+    const cleanup = () => { file.close(); file.delete(); };
+    try {
+        if (!file.isValid()) {
+            throw new Error("Invalid or unsupported .ktx2 file");
+        }
+        if (!file.isUASTC() && !file.isETC1S() && !(file.isHDR?.() ?? false)) {
+            throw new Error("Unknown Basis encoding (expected UASTC or ETC1S)");
+        }
+        const width = file.getWidth();
+        const height = file.getHeight();
+        const layerCount = file.getLayers() || 1;
+        const levelCount = file.getLevels();
+        const faceCount = file.getFaces();
+        const hasAlpha = file.getHasAlpha();
+        if (!width || !height || !levelCount) {
+            throw new Error("Invalid texture");
+        }
+        if (!file.startTranscoding()) {
+            throw new Error(".startTranscoding failed");
+        }
+        const levels = [];
+        let skipped = 0;
+        for (let face = 0; face < faceCount; face += 1) {
+            for (let level = 0; level < levelCount; level += 1) {
+                const levelInfo = file.getImageLevelInfo(level, 0, face);
+                if (maxDimension !== undefined && Math.max(levelInfo.origWidth, levelInfo.origHeight) > maxDimension) {
+                    skipped += 1;
+                    continue;
+                }
+                const layerData = [];
+                for (let layer = 0; layer < layerCount; layer += 1) {
+                    const dst = new Uint8Array(file.getImageTranscodedSizeInBytes(level, layer, face, transcoderFormat));
+                    if (!file.transcodeImage(dst, level, layer, face, transcoderFormat, 0, -1, -1)) {
+                        throw new Error(".transcodeImage failed");
+                    }
+                    layerData.push(dst);
+                }
+                const data = layerData.length === 1 ? layerData[0] : concatBytes(layerData);
+                // Non-multiple-of-four textures without mipmaps report padded
+                // levelInfo.width/height; use origWidth/origHeight when real mips exist
+                // (three r185 KTX2Loader parity).
+                const mipWidth = levelCount - skipped > 1 ? levelInfo.origWidth : levelInfo.width;
+                const mipHeight = levelCount - skipped > 1 ? levelInfo.origHeight : levelInfo.height;
+                levels.push({ width: mipWidth, height: mipHeight, data });
+            }
+        }
+        if (levels.length === 0) {
+            throw new Error(`maxDimension ${maxDimension} skipped every mip level`);
+        }
+        return { width: levels[0].width, height: levels[0].height, isUASTC: file.isUASTC(), hasAlpha, levels };
+    }
+    finally {
+        cleanup();
+    }
+}
+function concatBytes(parts) {
+    const total = parts.reduce((sum, part) => sum + part.byteLength, 0);
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const part of parts) {
+        out.set(part, offset);
+        offset += part.byteLength;
+    }
+    return out;
+}
+//# sourceMappingURL=KTX2TranscodeDriver.js.map

package/dist/KTX2TranscodeDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KTX2TranscodeDriver.js","sourceRoot":"","sources":["../../../../packages/assets/src/KTX2TranscodeDriver.ts"],"names":[],"mappings":"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"}

package/dist/KTX2TranscodeWorker.d.ts

@@ -0,0 +1,30 @@
+/**
+ * KTX2 transcode worker pool (PRD-05 §7.4). Workers are built from the
+ * vendored `basis_transcoder.js` + `.wasm` fetched once from the same-origin
+ * `transcoderUrl` — three r185's blob-worker recipe, so no bundler worker
+ * handling is required and module/wasm URLs stay same-origin.
+ */
+import type { KTX2TranscodedLevel } from "./KTX2TranscodeDriver.js";
+export interface KTX2WorkerTranscodeRequest {
+    readonly bytes: Uint8Array;
+    readonly transcoderFormat: number;
+    readonly maxDimension?: number;
+}
+export interface KTX2WorkerTranscodeResult {
+    readonly width: number;
+    readonly height: number;
+    readonly isUASTC: boolean;
+    readonly hasAlpha: boolean;
+    readonly levels: readonly KTX2TranscodedLevel[];
+}
+export interface KTX2TranscodeWorkerPool {
+    transcode(request: KTX2WorkerTranscodeRequest): Promise<KTX2WorkerTranscodeResult>;
+    dispose(): void;
+}
+/**
+ * Creates a worker pool of `workerCount` transcoding workers. The pool lazily
+ * materialises its blob URL on first `transcode` call — construction is cheap
+ * and synchronous; `dispose()` terminates every worker.
+ */
+export declare function createKTX2TranscodeWorkerPool(transcoderUrl: string, workerCount: number): KTX2TranscodeWorkerPool;
+//# sourceMappingURL=KTX2TranscodeWorker.d.ts.map

package/dist/KTX2TranscodeWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KTX2TranscodeWorker.d.ts","sourceRoot":"","sources":["../../../../packages/assets/src/KTX2TranscodeWorker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAwFpE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACjD;AAiBD,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACnF,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,uBAAuB,CAqHjH"}

package/dist/KTX2TranscodeWorker.js

@@ -0,0 +1,230 @@
+/**
+ * KTX2 transcode worker pool (PRD-05 §7.4). Workers are built from the
+ * vendored `basis_transcoder.js` + `.wasm` fetched once from the same-origin
+ * `transcoderUrl` — three r185's blob-worker recipe, so no bundler worker
+ * handling is required and module/wasm URLs stay same-origin.
+ */
+import { AssetDecoderUnavailable, looksLikeWasmBinary, withDecoderTimeout } from "./decoderLoad.js";
+const WORKER_SOURCE = `
+let basisModule = null;
+let readyPromise = null;
+self.addEventListener("message", function (e) {
+  const message = e.data;
+  if (message.type === "init") {
+    const mod = { wasmBinary: message.wasmBinary, onRuntimeInitialized: null, onAbort: null };
+    readyPromise = new Promise(function (resolve, reject) {
+      mod.onRuntimeInitialized = resolve;
+      // A corrupt/short wasmBinary aborts emscripten through onAbort — without
+      // this the worker never answered and every queued transcode hung.
+      mod.onAbort = function (reason) { reject(new Error("basis_transcoder aborted: " + reason)); };
+      BASIS(mod);
+    }).then(function () {
+      basisModule = mod;
+      basisModule.initializeBasis();
+    });
+    readyPromise.then(function () {
+      self.postMessage({ type: "ready", id: message.id });
+    }, function (error) {
+      self.postMessage({ type: "error", id: message.id, error: error && error.message ? error.message : String(error) });
+    });
+    return;
+  }
+  if (message.type === "transcode") {
+    readyPromise.then(function () {
+      try {
+        const result = __transcode(basisModule, new Uint8Array(message.buffer), message.transcoderFormat, message.maxDimension);
+        self.postMessage({ type: "transcode", id: message.id, result: result }, result.levels.map(function (l) { return l.data.buffer; }));
+      } catch (error) {
+        self.postMessage({ type: "error", id: message.id, error: error && error.message ? error.message : String(error) });
+      }
+    }, function (error) {
+      self.postMessage({ type: "error", id: message.id, error: error && error.message ? error.message : String(error) });
+    });
+  }
+});
+`;
+const DRIVER_SOURCE = `
+function __transcode(basis, bytes, transcoderFormat, maxDimension) {
+  const file = new basis.KTX2File(bytes);
+  function cleanup() { file.close(); file.delete(); }
+  try {
+    if (!file.isValid()) throw new Error("Invalid or unsupported .ktx2 file");
+    if (!file.isUASTC() && !file.isETC1S() && !(file.isHDR && file.isHDR())) throw new Error("Unknown Basis encoding");
+    const width = file.getWidth();
+    const height = file.getHeight();
+    const layerCount = file.getLayers() || 1;
+    const levelCount = file.getLevels();
+    const faceCount = file.getFaces();
+    const hasAlpha = file.getHasAlpha();
+    if (!width || !height || !levelCount) throw new Error("Invalid texture");
+    if (!file.startTranscoding()) throw new Error(".startTranscoding failed");
+    const levels = [];
+    let remaining = levelCount;
+    for (let face = 0; face < faceCount; face += 1) {
+      for (let level = 0; level < levelCount; level += 1) {
+        const levelInfo = file.getImageLevelInfo(level, 0, face);
+        if (maxDimension !== undefined && Math.max(levelInfo.origWidth, levelInfo.origHeight) > maxDimension) { remaining -= 1; continue; }
+        const layerData = [];
+        for (let layer = 0; layer < layerCount; layer += 1) {
+          const dst = new Uint8Array(file.getImageTranscodedSizeInBytes(level, layer, face, transcoderFormat));
+          if (!file.transcodeImage(dst, level, layer, face, transcoderFormat, 0, -1, -1)) throw new Error(".transcodeImage failed");
+          layerData.push(dst);
+        }
+        let data = layerData[0];
+        if (layerData.length > 1) {
+          let total = 0; for (const p of layerData) total += p.byteLength;
+          data = new Uint8Array(total);
+          let off = 0; for (const p of layerData) { data.set(p, off); off += p.byteLength; }
+        }
+        const mipWidth = remaining > 1 ? levelInfo.origWidth : levelInfo.width;
+        const mipHeight = remaining > 1 ? levelInfo.origHeight : levelInfo.height;
+        levels.push({ width: mipWidth, height: mipHeight, data: data });
+        remaining -= 1;
+      }
+    }
+    if (levels.length === 0) throw new Error("maxDimension skipped every mip level");
+    return { width: levels[0].width, height: levels[0].height, isUASTC: file.isUASTC(), hasAlpha: hasAlpha, levels: levels };
+  } finally {
+    cleanup();
+  }
+}
+`;
+/**
+ * Creates a worker pool of `workerCount` transcoding workers. The pool lazily
+ * materialises its blob URL on first `transcode` call — construction is cheap
+ * and synchronous; `dispose()` terminates every worker.
+ */
+export function createKTX2TranscodeWorkerPool(transcoderUrl, workerCount) {
+    const base = transcoderUrl.endsWith("/") ? transcoderUrl : `${transcoderUrl}/`;
+    const size = Math.max(1, workerCount | 0);
+    let initPromise;
+    const queue = [];
+    const jobIds = new Map();
+    let nextJobId = 1;
+    let disposed = false;
+    const init = async () => {
+        initPromise ??= withDecoderTimeout((async () => {
+            const jsUrl = `${base}basis_transcoder.js`;
+            const wasmUrl = `${base}basis_transcoder.wasm`;
+            const [jsText, wasmBinary] = await Promise.all([
+                fetch(jsUrl).then((response) => {
+                    if (!response.ok)
+                        throw new AssetDecoderUnavailable("ktx2", jsUrl);
+                    return response.text();
+                }),
+                fetch(wasmUrl).then(async (response) => {
+                    if (!response.ok)
+                        throw new AssetDecoderUnavailable("ktx2", wasmUrl);
+                    const buffer = await response.arrayBuffer();
+                    // An SPA index.html fallback answers 200 with HTML — reject here,
+                    // feeding it to the worker aborts emscripten without a listener.
+                    if (!looksLikeWasmBinary(buffer))
+                        throw new AssetDecoderUnavailable("ktx2", wasmUrl);
+                    return buffer;
+                })
+            ]);
+            if (jsText.trimStart().startsWith("<"))
+                throw new AssetDecoderUnavailable("ktx2", jsUrl);
+            const blob = new Blob([WORKER_SOURCE, "\n", jsText, "\n", DRIVER_SOURCE], { type: "text/javascript" });
+            const workerUrl = URL.createObjectURL(blob);
+            const workers = [];
+            for (let index = 0; index < size; index += 1) {
+                const worker = new Worker(workerUrl);
+                worker.onmessage = (event) => onWorkerMessage(workers[index], event);
+                worker.onerror = () => killWorker(workers[index], "ktx2 transcode worker error");
+                worker.onmessageerror = () => killWorker(workers[index], "ktx2 transcode worker message error");
+                workers.push({ worker, busy: false, dead: false });
+                worker.postMessage({ type: "init", id: 0, wasmBinary: wasmBinary.slice(0) }, [wasmBinary.slice(0)]);
+            }
+            return workers;
+        })(), "ktx2 worker init");
+        return initPromise;
+    };
+    const killWorker = (slot, reason) => {
+        if (slot.dead)
+            return;
+        slot.dead = true;
+        if (slot.currentJobId !== undefined) {
+            const job = jobIds.get(slot.currentJobId);
+            if (job) {
+                jobIds.delete(slot.currentJobId);
+                job.reject(new Error(reason));
+            }
+            slot.currentJobId = undefined;
+        }
+        // With every worker dead the queue can never drain — reject it now.
+        void initPromise?.then((workers) => {
+            if (workers.every((w) => w.dead)) {
+                for (const job of queue.splice(0))
+                    job.reject(new Error(reason));
+            }
+        }).catch(() => { });
+    };
+    const onWorkerMessage = (slot, event) => {
+        const message = event.data;
+        if (message.type === "ready") {
+            slot.busy = false;
+            slot.currentJobId = undefined;
+            pump(slot);
+            return;
+        }
+        if (message.type === "error" && message.id === 0) {
+            // init abort — the worker can never transcode; fail its jobs fast.
+            killWorker(slot, message.error ?? "ktx2 transcode worker init failed");
+            return;
+        }
+        const job = message.id !== undefined ? jobIds.get(message.id) : undefined;
+        if (job) {
+            jobIds.delete(message.id);
+            slot.busy = false;
+            slot.currentJobId = undefined;
+            if (message.type === "transcode")
+                job.resolve(message.result);
+            else
+                job.reject(new Error(message.error ?? "KTX2 transcode failed"));
+        }
+        pump(slot);
+    };
+    const pump = (slot) => {
+        if (slot.busy || slot.dead || disposed)
+            return;
+        const job = queue.shift();
+        if (!job)
+            return;
+        slot.busy = true;
+        const id = nextJobId++;
+        slot.currentJobId = id;
+        jobIds.set(id, job);
+        const payload = { type: "transcode", id, buffer: job.request.bytes.buffer.slice(0), transcoderFormat: job.request.transcoderFormat, maxDimension: job.request.maxDimension };
+        slot.worker.postMessage(payload, [payload.buffer]);
+    };
+    return {
+        async transcode(request) {
+            if (disposed)
+                throw new Error("KTX2 worker pool is disposed");
+            const workers = await init();
+            if (workers.every((slot) => slot.dead))
+                throw new AssetDecoderUnavailable("ktx2", `${base}basis_transcoder.wasm`);
+            return new Promise((resolve, reject) => {
+                const job = { request, resolve, reject };
+                const free = workers.find((slot) => !slot.busy && !slot.dead);
+                if (free) {
+                    queue.push(job);
+                    pump(free);
+                }
+                else
+                    queue.push(job);
+            });
+        },
+        dispose() {
+            disposed = true;
+            for (const job of queue.splice(0))
+                job.reject(new Error("KTX2 worker pool disposed"));
+            for (const job of [...jobIds.values()])
+                job.reject(new Error("KTX2 worker pool disposed"));
+            jobIds.clear();
+            initPromise?.then((workers) => workers.forEach((slot) => slot.worker.terminate())).catch(() => { });
+        }
+    };
+}
+//# sourceMappingURL=KTX2TranscodeWorker.js.map

package/dist/KTX2TranscodeWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KTX2TranscodeWorker.js","sourceRoot":"","sources":["../../../../packages/assets/src/KTX2TranscodeWorker.ts"],"names":[],"mappings":"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"}

package/dist/MikkTSpaceTangents.d.ts

@@ -0,0 +1,43 @@
+/**
+ * MikkTSpaceTangents.ts — MikkTSpace tangent generation seam (PRD-04 §7.3,
+ * P1-6; R8). The wasm module is injected (r185's
+ * `examples/jsm/libs/mikktspace.module.js`, vendored by PRD 05 under
+ * `packages/assets/vendor/mikktspace/` — request Q-05-1).
+ *
+ * - `setMikkTSpaceModule` stores the module; `mikkTSpaceAvailable` reports it.
+ * - `generateMikkTSpaceTangents` unwelds indexed input (MikkTSpace requires
+ *   non-indexed streams), runs the module, then flips `.w` — the glTF UV
+ *   convention, matching `computeMikkTSpaceTangents(geometry, mikk, true)`.
+ * - Runs in a module Worker when `Worker` is defined and a worker factory was
+ *   supplied via `setMikkTSpaceWorkerFactory` (PRD-05 vendored wrapper wires
+ *   `new Worker(new URL("./mikktspace.worker.js", import.meta.url))`); falls
+ *   back to the inline call otherwise.
+ */
+export interface MikkTSpaceModule {
+    generateTangents(positions: Float32Array, normals: Float32Array, uvs: Float32Array): Float32Array;
+    /** r185's module exposes a thenable; `await` covers both. */
+    ready?: PromiseLike<void>;
+}
+export interface MikkTSpaceTangentInput {
+    readonly positions: Float32Array;
+    readonly normals: Float32Array;
+    readonly uvs: Float32Array;
+    readonly indices?: Uint32Array | Uint16Array;
+}
+export declare function setMikkTSpaceModule(mod: MikkTSpaceModule): void;
+/**
+ * Optional: supply a factory that returns the MikkTSpace worker
+ * (`new Worker(new URL("...mikktspace.worker.js", import.meta.url), {type:"module"})`).
+ * The worker implements the `{id, positions, normals, uvs}` → `{id, tangents}`
+ * message protocol defined below.
+ */
+export declare function setMikkTSpaceWorkerFactory(factory: (() => Worker) | undefined): void;
+export declare function mikkTSpaceAvailable(): boolean;
+/**
+ * Generate per-vertex tangents (`xyzw`; `w` = handedness sign, glTF
+ * convention). When `indices` are present the stream is unwelded first, so
+ * the returned array is `indices.length` × 4 — matching three's
+ * `computeMikkTSpaceTangents` non-indexed output exactly.
+ */
+export declare function generateMikkTSpaceTangents(input: MikkTSpaceTangentInput): Promise<Float32Array>;
+//# sourceMappingURL=MikkTSpaceTangents.d.ts.map

package/dist/MikkTSpaceTangents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MikkTSpaceTangents.d.ts","sourceRoot":"","sources":["../../../../packages/assets/src/MikkTSpaceTangents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,GAAG,YAAY,CAAC;IAClG,6DAA6D;IAC7D,KAAK,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;CAC9C;AAcD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,GAAG,IAAI,CAMpF;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAiGD;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAarG"}

package/dist/MikkTSpaceTangents.js

@@ -0,0 +1,149 @@
+/**
+ * MikkTSpaceTangents.ts — MikkTSpace tangent generation seam (PRD-04 §7.3,
+ * P1-6; R8). The wasm module is injected (r185's
+ * `examples/jsm/libs/mikktspace.module.js`, vendored by PRD 05 under
+ * `packages/assets/vendor/mikktspace/` — request Q-05-1).
+ *
+ * - `setMikkTSpaceModule` stores the module; `mikkTSpaceAvailable` reports it.
+ * - `generateMikkTSpaceTangents` unwelds indexed input (MikkTSpace requires
+ *   non-indexed streams), runs the module, then flips `.w` — the glTF UV
+ *   convention, matching `computeMikkTSpaceTangents(geometry, mikk, true)`.
+ * - Runs in a module Worker when `Worker` is defined and a worker factory was
+ *   supplied via `setMikkTSpaceWorkerFactory` (PRD-05 vendored wrapper wires
+ *   `new Worker(new URL("./mikktspace.worker.js", import.meta.url))`); falls
+ *   back to the inline call otherwise.
+ */
+let module_;
+let workerFactory;
+let worker;
+let requestSeq = 0;
+const pending = new Map();
+export function setMikkTSpaceModule(mod) {
+    module_ = mod;
+}
+/**
+ * Optional: supply a factory that returns the MikkTSpace worker
+ * (`new Worker(new URL("...mikktspace.worker.js", import.meta.url), {type:"module"})`).
+ * The worker implements the `{id, positions, normals, uvs}` → `{id, tangents}`
+ * message protocol defined below.
+ */
+export function setMikkTSpaceWorkerFactory(factory) {
+    workerFactory = factory;
+    if (!factory && worker) {
+        worker.terminate();
+        worker = undefined;
+    }
+}
+export function mikkTSpaceAvailable() {
+    return module_ !== undefined;
+}
+function unweld(input) {
+    const indices = input.indices;
+    if (!indices) {
+        return { positions: input.positions, normals: input.normals, uvs: input.uvs };
+    }
+    const count = indices.length;
+    const positions = new Float32Array(count * 3);
+    const normals = new Float32Array(count * 3);
+    const uvs = new Float32Array(count * 2);
+    for (let i = 0; i < count; i++) {
+        const v = indices[i];
+        positions[i * 3] = input.positions[v * 3];
+        positions[i * 3 + 1] = input.positions[v * 3 + 1];
+        positions[i * 3 + 2] = input.positions[v * 3 + 2];
+        normals[i * 3] = input.normals[v * 3];
+        normals[i * 3 + 1] = input.normals[v * 3 + 1];
+        normals[i * 3 + 2] = input.normals[v * 3 + 2];
+        uvs[i * 2] = input.uvs[v * 2];
+        uvs[i * 2 + 1] = input.uvs[v * 2 + 1];
+    }
+    return { positions, normals, uvs };
+}
+/** glTF UV convention: flip the handedness sign (three's `negateSign = true`). */
+function applyGltfSign(tangents) {
+    for (let i = 3; i < tangents.length; i += 4) {
+        tangents[i] *= -1;
+    }
+    return tangents;
+}
+function acquireWorker() {
+    if (typeof Worker === "undefined" || !workerFactory)
+        return undefined;
+    if (worker)
+        return worker;
+    const instance = workerFactory();
+    instance.onmessage = (event) => {
+        const { id, tangents, error } = event.data;
+        const entry = pending.get(id);
+        if (!entry)
+            return;
+        pending.delete(id);
+        if (error !== undefined)
+            entry.reject(new Error(error));
+        else
+            entry.resolve(new Float32Array(tangents));
+    };
+    instance.onerror = (event) => {
+        for (const entry of pending.values())
+            entry.reject(event);
+        pending.clear();
+    };
+    worker = instance;
+    return worker;
+}
+/**
+ * T0-18(f): bounded waits — a stuck wasm compile or a wedged worker must not
+ * hang the GLB load forever (the caller falls back to the legacy generator on
+ * rejection). 30 s matches the largest corpus fixture's worst-case compile.
+ */
+const MIKK_TSPACE_READY_TIMEOUT_MS = 30_000;
+const MIKK_TSPACE_WORKER_TIMEOUT_MS = 30_000;
+function withTimeout(promise, ms, label, onTimeout) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            onTimeout?.();
+            reject(new Error(`${label} timed out after ${ms} ms`));
+        }, ms);
+        promise.then((value) => { clearTimeout(timer); resolve(value); }, (error) => { clearTimeout(timer); reject(error); });
+    });
+}
+function runInWorker(w, input) {
+    const id = requestSeq++;
+    // Copy into tight buffers: caller arrays may be views into larger buffers.
+    const positions = new Float32Array(input.positions);
+    const normals = new Float32Array(input.normals);
+    const uvs = new Float32Array(input.uvs);
+    const work = new Promise((resolve, reject) => {
+        pending.set(id, { resolve, reject });
+        w.postMessage({ id, positions: positions.buffer, normals: normals.buffer, uvs: uvs.buffer }, [positions.buffer, normals.buffer, uvs.buffer]);
+    });
+    return withTimeout(work, MIKK_TSPACE_WORKER_TIMEOUT_MS, "MikkTSpace worker tangent generation", () => {
+        pending.delete(id);
+        // The worker is wedged; drop it so the next call retries on a fresh one.
+        if (worker === w) {
+            worker = undefined;
+        }
+        w.terminate();
+    });
+}
+/**
+ * Generate per-vertex tangents (`xyzw`; `w` = handedness sign, glTF
+ * convention). When `indices` are present the stream is unwelded first, so
+ * the returned array is `indices.length` × 4 — matching three's
+ * `computeMikkTSpaceTangents` non-indexed output exactly.
+ */
+export async function generateMikkTSpaceTangents(input) {
+    if (!module_) {
+        throw new Error("MikkTSpace module not installed: call setMikkTSpaceModule() first");
+    }
+    await withTimeout(Promise.resolve(module_.ready), MIKK_TSPACE_READY_TIMEOUT_MS, "MikkTSpace module ready");
+    const streams = unweld(input);
+    const w = acquireWorker();
+    if (w) {
+        const tangents = await runInWorker(w, streams);
+        return applyGltfSign(tangents);
+    }
+    const tangents = module_.generateTangents(streams.positions, streams.normals, streams.uvs);
+    return applyGltfSign(tangents);
+}
+//# sourceMappingURL=MikkTSpaceTangents.js.map