@aura3d/assets 4.0.3 → 4.0.5

package/dist/DataTextureLoader.d.ts

@@ -0,0 +1,16 @@
+/**
+ * threejs-parity ST-04 (§6 lane L4): `THREE.DataTextureLoader` — the abstract
+ * binary-format loader base. `EXRLoader`/`HDRLoader`-family subclasses decode
+ * fetched bytes via `parse`; the public surface mirrors three:
+ * `load(url, onLoad?, onProgress?, onError?)` + `loadAsync`.
+ */
+import { type AuraLoaderProgress } from "./LoaderFetch.js";
+export declare abstract class DataTextureLoader<TData = unknown> {
+    path: string;
+    setPath(value: string): this;
+    /** Subclasses decode the fetched bytes (async allowed — EXR ZIP/PIZ inflate). */
+    abstract parse(buffer: ArrayBuffer): Promise<TData> | TData;
+    load(url: string, onLoad?: (data: TData) => void, onProgress?: (progress: AuraLoaderProgress) => void, onError?: (error: unknown) => void): Promise<TData>;
+    loadAsync(url: string, onProgress?: (progress: AuraLoaderProgress) => void): Promise<TData>;
+}
+//# sourceMappingURL=DataTextureLoader.d.ts.map

package/dist/DataTextureLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTextureLoader.d.ts","sourceRoot":"","sources":["../../../../packages/assets/src/DataTextureLoader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,8BAAsB,iBAAiB,CAAC,KAAK,GAAG,OAAO;IACrD,IAAI,SAAM;IAEV,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK5B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK;IAE3D,IAAI,CACF,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,EAC9B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,EACnD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACjC,OAAO,CAAC,KAAK,CAAC;IASX,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;CAKlG"}

package/dist/DataTextureLoader.js

@@ -0,0 +1,29 @@
+/**
+ * threejs-parity ST-04 (§6 lane L4): `THREE.DataTextureLoader` — the abstract
+ * binary-format loader base. `EXRLoader`/`HDRLoader`-family subclasses decode
+ * fetched bytes via `parse`; the public surface mirrors three:
+ * `load(url, onLoad?, onProgress?, onError?)` + `loadAsync`.
+ */
+import { fetchBytes } from "./LoaderFetch.js";
+export class DataTextureLoader {
+    path = "";
+    setPath(value) {
+        this.path = value;
+        return this;
+    }
+    load(url, onLoad, onProgress, onError) {
+        const pending = this.loadAsync(url, onProgress).then((data) => {
+            onLoad?.(data);
+            return data;
+        });
+        if (onError)
+            pending.catch(onError);
+        return pending;
+    }
+    async loadAsync(url, onProgress) {
+        const resolved = this.path ? `${this.path}${url}` : url;
+        const buffer = await fetchBytes(resolved, undefined, onProgress);
+        return this.parse(buffer);
+    }
+}
+//# sourceMappingURL=DataTextureLoader.js.map

package/dist/DataTextureLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTextureLoader.js","sourceRoot":"","sources":["../../../../packages/assets/src/DataTextureLoader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAA2B,MAAM,kBAAkB,CAAC;AAEvE,MAAM,OAAgB,iBAAiB;IACrC,IAAI,GAAG,EAAE,CAAC;IAEV,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,IAAI,CACF,GAAW,EACX,MAA8B,EAC9B,UAAmD,EACnD,OAAkC;QAElC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YAC5D,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,OAAO;YAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,UAAmD;QAC9E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/EXRLoader.d.ts

@@ -0,0 +1,78 @@
+/**
+ * threejs-parity AD-03 (docs/workflows/threejs-parity-gaps.md §6 lane L4):
+ * real OpenEXR decode — the scanline/tile pipeline is a faithful port of
+ * three.js r185 `examples/jsm/loaders/EXRLoader.js` (itself a port of the
+ * TinyEXR/OpenEXR reference implementation), trimmed to the compression
+ * family this lane requires: NO_COMPRESSION, RLE, ZIPS, ZIP and PIZ, with
+ * HALF and FLOAT channel pixel types. PXR24, B44/A, DWA/B and deep data
+ * throw `unsupported-format` rather than silently mis-decoding.
+ *
+ * Output mirrors three's `EXRLoader` result shape: `RGBAFormat` RGBA pixels
+ * as `Uint16Array` half floats (default) or `Float32Array`, `flipY: false`,
+ * `generateMipmaps: false` — feedable straight into `texture.data`.
+ */
+import { type AssetLoader, type AssetLoadRequest } from "./AssetLoader.js";
+import type { LoadContext } from "./LoadContext.js";
+export type AuraEXRDataType = "half" | "float";
+export type AuraEXROutputFormat = "rgba" | "rg" | "r";
+export interface AuraEXRParseOptions {
+    /** Output pixel type — three's `HalfFloatType` (default) vs `FloatType`. */
+    readonly type?: AuraEXRDataType;
+    /** Channel layout — three's `RGBAFormat` (default), `RGFormat`, `RedFormat`. */
+    readonly outputFormat?: AuraEXROutputFormat;
+    /** Part index for multi-part files (three's `setPart`). */
+    readonly part?: number;
+}
+export interface AuraEXRTextureData {
+    readonly width: number;
+    readonly height: number;
+    /** RGBA/RG/R interleaved pixels — `Uint16Array` half bits or `Float32Array`. */
+    readonly data: Uint16Array | Float32Array;
+    /** Pixel channel count — 4 (rgba), 2 (rg) or 1 (r). */
+    readonly channels: 4 | 2 | 1;
+    readonly type: AuraEXRDataType;
+    readonly format: AuraEXROutputFormat;
+    readonly colorSpace: "linear";
+    /** three parity: decoded EXR data is already device-row ordered. */
+    readonly flipY: false;
+    readonly generateMipmaps: false;
+    /** The parsed EXR header attributes (channels, dataWindow, ...). */
+    readonly header: Record<string, unknown>;
+}
+/**
+ * Parse an EXR `ArrayBuffer` into interleaved pixel data — the async sibling
+ * of three's `EXRLoader.parse` (async only because ZIP/ZIPS inflate via
+ * `DecompressionStream` is async).
+ */
+export declare function parseEXR(buffer: ArrayBuffer, options?: AuraEXRParseOptions): Promise<AuraEXRTextureData>;
+/**
+ * `new THREE.EXRLoader()` — real async decode. Works standalone
+ * (`load(url, onLoad?, onProgress?, onError?)` → `Promise<AuraEXRTextureData>`)
+ * and as an `AssetManager` loader (`type: "exr"`).
+ *
+ * `type`/`outputFormat`/`part` mirror three's `setDataType`/`setOutputFormat`/
+ * `setPart` builder methods.
+ */
+export declare class EXRLoader implements AssetLoader<AuraEXRTextureData> {
+    readonly type = "exr";
+    outputType: AuraEXRDataType;
+    outputFormat: AuraEXROutputFormat;
+    part: number;
+    setDataType(value: AuraEXRDataType): this;
+    setOutputFormat(value: AuraEXROutputFormat): this;
+    setPart(value: number): this;
+    canLoad(request: AssetLoadRequest): boolean;
+    /** AssetManager entry — fetches bytes, then `parseEXR`. */
+    load(request: AssetLoadRequest, context: LoadContext): Promise<AuraEXRTextureData>;
+    /** three signature — `load(url, onLoad?, onProgress?, onError?)`. */
+    load(url: string, onLoad?: (data: AuraEXRTextureData) => void, onProgress?: (event: {
+        readonly loaded?: number;
+        readonly total?: number;
+    }) => void, onError?: (error: unknown) => void): Promise<AuraEXRTextureData>;
+    /** `parse(buffer)` — three's synchronous-looking parse; async here for zlib. */
+    parse(buffer: ArrayBuffer): Promise<AuraEXRTextureData>;
+    private loadBytes;
+}
+/** Alias matching three's export name where an explicit class is wanted. */
+export { EXRLoader as EXRLoaderThreeCompat };
+//# sourceMappingURL=EXRLoader.d.ts.map

package/dist/EXRLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EXRLoader.d.ts","sourceRoot":"","sources":["../../../../packages/assets/src/EXRLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC;AAC/C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,IAAI,GAAG,GAAG,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;IAChC,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAC5C,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAAC;IAC1C,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC;IAChC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AA0CD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0zDlH;AAED;;;;;;;GAOG;AACH,qBAAa,SAAU,YAAW,WAAW,CAAC,kBAAkB,CAAC;IAC/D,QAAQ,CAAC,IAAI,SAAS;IACtB,UAAU,EAAE,eAAe,CAAU;IACrC,YAAY,EAAE,mBAAmB,CAAU;IAC3C,IAAI,SAAK;IAET,WAAW,CAAE,KAAK,EAAE,eAAe,GAAI,IAAI;IAK3C,eAAe,CAAE,KAAK,EAAE,mBAAmB,GAAI,IAAI;IAKnD,OAAO,CAAE,KAAK,EAAE,MAAM,GAAI,IAAI;IAK9B,OAAO,CAAE,OAAO,EAAE,gBAAgB,GAAI,OAAO;IAI7C,2DAA2D;IACrD,IAAI,CAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,GAAI,OAAO,CAAC,kBAAkB,CAAC;IAC1F,qEAAqE;IACrE,IAAI,CAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAE,IAAI,EAAE,kBAAkB,KAAM,IAAI,EAAE,UAAU,CAAC,EAAE,CAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAM,IAAI,EAAE,OAAO,CAAC,EAAE,CAAE,KAAK,EAAE,OAAO,KAAM,IAAI,GAAI,OAAO,CAAC,kBAAkB,CAAC;IAsB5N,gFAAgF;IAChF,KAAK,CAAE,MAAM,EAAE,WAAW,GAAI,OAAO,CAAC,kBAAkB,CAAC;YAI3C,SAAS;CAoBxB;AAED,4EAA4E;AAC5E,OAAO,EAAE,SAAS,IAAI,oBAAoB,EAAE,CAAC"}