@aura3d/engine 4.0.3 → 4.0.4

package/dist/engine/agent-api/nodes/sprites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprites.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/sprites.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,+EAA+E;AAC/E,yCAAyC;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAwB/C,mFAAmF;AACnF,MAAM,UAAU,MAAM,CAAC,UAA6B,EAAE;IACpD,MAAM,MAAM,GAA8B,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACvE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,4EAA4E;IAC5E,0DAA0D;IAC1D,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,CAAC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACvH,IAAI,cAAc,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,8EAA8E;IAC9E,yDAAyD;IACzD,MAAM,KAAK,GACT,OAAO,CAAC,KAAK,KAAK,SAAS;QACzB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YACjC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YACnC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,OAAO,IAAI,eAAe,CAAiB;QACzC,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,MAAM;QACN,cAAc;QACd,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAoB,CAAC,CAAC,CAAC,SAAS;QACpF,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,OAAO,GAAG,EAAE,MAAM,EAAW,CAAC"}

package/dist/engine/agent-api/nodes/surfaces.d.ts

@@ -0,0 +1,48 @@
+/**
+ * threejs-parity L7/AD-15: `surfaces.mirror` — three's `Reflector`.
+ *
+ * Emits an additive `"surface"` scene node (same builder-cast pattern as
+ * `probes.ts`). The production runtime captures the scene through the mirror
+ * camera into a renderer-owned target (`PlanarReflectionCapture`, oblique
+ * near-plane clip) and submits a reflector item sampling that texture.
+ *
+ * Mirrors are horizontal planes (`y = position[1]`), matching the engine's
+ * planar-reflection capture contract.
+ */
+import type { AuraColor, AuraSceneNode, AuraTransformSpec, AuraVec3 } from "./types.js";
+import { AuraNodeBuilder } from "./builder.js";
+export interface AuraMirrorOptions {
+    readonly name?: string;
+    /** Mirror surface size `[width, depth]` in world units (default [4, 4]). */
+    readonly size?: readonly [number, number];
+    /** Mirror capture resolution in pixels (default 256). */
+    readonly resolution?: number;
+    /** Reflector tint multiplied over the captured texture (default white). */
+    readonly tint?: AuraColor;
+    /** Mirror plane center; `position[1]` is the reflection plane height. */
+    readonly position?: AuraVec3;
+    readonly runtime?: import("./types.js").AuraRuntimeNodeSpec;
+}
+export interface AuraMirrorSurfaceNode extends AuraTransformSpec {
+    readonly kind: "surface";
+    readonly surface: "mirror";
+    readonly name?: string;
+    /** Mirror extent `[width, depth]` — note: 2 elements, not a bounds vec3. */
+    readonly size: readonly [number, number];
+    readonly resolution: number;
+    readonly tint?: AuraColor;
+    readonly runtime?: import("./types.js").AuraRuntimeNodeSpec;
+}
+export declare function isAuraMirrorSurfaceNode(node: {
+    readonly kind: string;
+}): node is AuraMirrorSurfaceNode & {
+    readonly kind: "surface";
+};
+export declare const surfaces: {
+    /**
+     * three's `new Reflector(geometry, { textureWidth, color })` — horizontal
+     * mirror at `position[1]` sampling a live planar-reflection render target.
+     */
+    readonly mirror: (options?: AuraMirrorOptions) => AuraNodeBuilder<AuraSceneNode>;
+};
+//# sourceMappingURL=surfaces.d.ts.map

package/dist/engine/agent-api/nodes/surfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/surfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,YAAY,EAAE,mBAAmB,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,YAAY,EAAE,mBAAmB,CAAC;CAC7D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,IAAI,qBAAqB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAErI;AAED,eAAO,MAAM,QAAQ;IACnB;;;OAGG;gCACe,iBAAiB;CAW3B,CAAC"}

package/dist/engine/agent-api/nodes/surfaces.js

@@ -0,0 +1,32 @@
+/**
+ * threejs-parity L7/AD-15: `surfaces.mirror` — three's `Reflector`.
+ *
+ * Emits an additive `"surface"` scene node (same builder-cast pattern as
+ * `probes.ts`). The production runtime captures the scene through the mirror
+ * camera into a renderer-owned target (`PlanarReflectionCapture`, oblique
+ * near-plane clip) and submits a reflector item sampling that texture.
+ *
+ * Mirrors are horizontal planes (`y = position[1]`), matching the engine's
+ * planar-reflection capture contract.
+ */
+import { AuraNodeBuilder } from "./builder.js";
+export function isAuraMirrorSurfaceNode(node) {
+    return node.kind === "surface" && node.surface === "mirror";
+}
+export const surfaces = {
+    /**
+     * three's `new Reflector(geometry, { textureWidth, color })` — horizontal
+     * mirror at `position[1]` sampling a live planar-reflection render target.
+     */
+    mirror: (options = {}) => new AuraNodeBuilder({
+        kind: "surface",
+        surface: "mirror",
+        name: options.name ?? "mirror",
+        position: options.position ?? [0, 0, 0],
+        size: options.size ?? [4, 4],
+        resolution: options.resolution ?? 256,
+        ...(options.tint !== undefined ? { tint: options.tint } : {}),
+        ...(options.runtime ? { runtime: options.runtime } : {})
+    })
+};
+//# sourceMappingURL=surfaces.js.map

package/dist/engine/agent-api/nodes/surfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/surfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AA0B/C,MAAM,UAAU,uBAAuB,CAAC,IAA+B;IACrE,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,IAAK,IAA6B,CAAC,OAAO,KAAK,QAAQ,CAAC;AACxF,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB;;;OAGG;IACH,MAAM,EAAE,CAAC,UAA6B,EAAE,EAAE,EAAE,CAC1C,IAAI,eAAe,CAAgB;QACjC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,QAAQ;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5B,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;QACrC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7B,CAAC;CACxB,CAAC"}

package/dist/engine/agent-api/nodes/texture.d.ts

@@ -0,0 +1,114 @@
+/**
+ * threejs-parity §6 Lane L4 (docs/workflows/threejs-parity-gaps.md):
+ * ST-01 `texture.*` factories, ST-02 handle semantics (three's `Texture`
+ * field surface), ST-03 runtime upload (revision-driven), ST-07 real
+ * `texture.load` over `@aura3d/assets`.
+ *
+ * Every factory returns a `TextureHandle` — an `AuraTextureRef` — wrapping a
+ * live `R/Texture.ts` `Texture`. Material texture slots accept the handle
+ * through the frozen `AuraMaterialTextureInput` union; `AA/compiler/
+ * textures.ts` resolves it to `{ texture, sampler, transform }` bindings.
+ *
+ * Defaults follow three's per-kind conventions: `flipY`/`generateMipmaps`/
+ * color space mirror `THREE.Texture`, `CanvasTexture`, `VideoTexture`,
+ * `DataTexture`, `CompressedTexture`, `DepthTexture`, `CubeTexture` and
+ * `TextureLoader` output respectively.
+ */
+import { Texture } from "../../../rendering/index.js";
+import { AssetManager } from "../../../assets/browser-index.js";
+import type { AuraTextureCanvasOptions, AuraTextureColorSpace, AuraTextureCompressedOptions, AuraTextureCubeOptions, AuraTextureDataArrayOptions, AuraTextureDataOptions, AuraTextureDepthOptions, AuraTextureLoadOptions, AuraTextureMagFilter, AuraTextureMinFilter, AuraTextureRef, AuraTextureVideoOptions, AuraTextureWrapMode } from "./types.js";
+/** Internal bridge (compiler/textures.ts): the live `Texture` behind a ref. */
+export declare function auraTextureRefTexture(ref: AuraTextureRef | null | undefined): Texture | null;
+/**
+ * ST-02: live handle for a user-created texture — three's `Texture` field
+ * surface (`wrapS/T`, `repeat`, `offset`, `rotation`, `center`, filters,
+ * `anisotropy`, `generateMipmaps`, `colorSpace`, `flipY`, `needsUpdate`,
+ * `dispose`). `AuraTextureRef` (frozen, `nodes/types.ts`) is what material
+ * texture slots and `AuraUniformValue` accept.
+ *
+ * Upload-facing fields (`colorSpace`, `flipY`, `generateMipmaps`,
+ * `needsUpdate`) write through to the backing `Texture` and mark it dirty;
+ * sampling/transform fields are compiled into the slot's sampler and
+ * `AuraTextureTransform` by `resolveAuraTextureRef`.
+ */
+export declare class TextureHandle implements AuraTextureRef {
+    readonly kind: "aura-texture-ref";
+    readonly id: string;
+    wrapS: AuraTextureWrapMode;
+    wrapT: AuraTextureWrapMode;
+    repeat: readonly [number, number];
+    offset: readonly [number, number];
+    rotation: number;
+    center: readonly [number, number];
+    anisotropy: number;
+    minFilter: AuraTextureMinFilter;
+    magFilter: AuraTextureMagFilter;
+    /** The backing device texture — do not mutate it from user code. */
+    readonly texture: Texture;
+    constructor(texture: Texture, defaults?: {
+        readonly wrapS?: AuraTextureWrapMode;
+        readonly wrapT?: AuraTextureWrapMode;
+        readonly anisotropy?: number;
+        readonly minFilter?: AuraTextureMinFilter;
+        readonly magFilter?: AuraTextureMagFilter;
+    });
+    get colorSpace(): AuraTextureColorSpace;
+    set colorSpace(value: AuraTextureColorSpace);
+    get flipY(): boolean;
+    set flipY(value: boolean);
+    get generateMipmaps(): boolean;
+    set generateMipmaps(value: boolean);
+    /**
+     * ST-03: set after mutating pixels/source. Bumps the device revision
+     * exactly once per dirty cycle; the device clears it once the revision
+     * has been uploaded.
+     */
+    get needsUpdate(): boolean;
+    set needsUpdate(value: boolean);
+    dispose(): void;
+}
+/** Test hook: replace the shared manager (custom loaders/baseUrl). */
+export declare function setTextureAssetManager(manager: AssetManager | null): void;
+/**
+ * ST-01: the `texture.*` namespace. Every factory returns a live
+ * `TextureHandle`; `load` is the async three `TextureLoader` parity path.
+ */
+export declare const texture: {
+    /**
+     * `new THREE.DataTexture(data, width, height)` — raw pixel data. `format`
+     * accepts the frozen option strings; `rgb8`/`r8` expand to RGBA8 (the
+     * device's supported format family).
+     */
+    data(options: AuraTextureDataOptions): TextureHandle;
+    /**
+     * `new THREE.CanvasTexture(canvas)` — a live 2D canvas. `needsUpdate`
+     * re-uploads on the next bind (ST-03).
+     */
+    canvas(options: AuraTextureCanvasOptions): TextureHandle;
+    /**
+     * `new THREE.VideoTexture(video)` — per-frame upload: the device polls the
+     * source each bind and re-uploads when `currentTime` advanced (ST-03). Like
+     * three's VideoTexture, mipmaps are off and filtering is linear.
+     */
+    video(options: AuraTextureVideoOptions): TextureHandle;
+    /** `new THREE.CompressedTexture(mipmaps, w, h, format)` — device-ready blocks. */
+    compressed(options: AuraTextureCompressedOptions): TextureHandle;
+    /** `new THREE.DepthTexture(w, h)` — a depth24 attachment texture. */
+    depth(options: AuraTextureDepthOptions): TextureHandle;
+    /**
+     * `new THREE.CubeTexture(images)` — six faces in WebGPU/cube order
+     * px, nx, py, ny, pz, nz. Each face is a typed pixel array (square size
+     * inferred), `{ width, height, data, format? }`, or an image source
+     * (canvas/ImageBitmap/image — read back through a 2D canvas).
+     */
+    cube(facesOrOptions: readonly unknown[] | AuraTextureCubeOptions): TextureHandle;
+    /** `new THREE.DataArrayTexture(data, w, h, depth)` — layer-stacked 2D data. */
+    dataArray(options: AuraTextureDataArrayOptions): TextureHandle;
+    /**
+     * `new THREE.TextureLoader().load(url)` — real async decode over
+     * `@aura3d/assets` (`ImageLoader` → `TextureLoader`). Progress/error events
+     * flow to `createAuraApp({ onAssetProgress, onAssetError })` (ST-06).
+     */
+    load(url: string, options?: AuraTextureLoadOptions): Promise<TextureHandle>;
+};
+//# sourceMappingURL=texture.d.ts.map

package/dist/engine/agent-api/nodes/texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/texture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,OAAO,EAOR,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAqH,MAAM,wBAAwB,CAAC;AAIzK,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAyBpB,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAG5F;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAU;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,mBAAmB,CAAW;IACrC,KAAK,EAAE,mBAAmB,CAAW;IACrC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAU;IAC3C,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAU;IAC3C,QAAQ,SAAK;IACb,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAU;IAC3C,UAAU,SAAK;IACf,SAAS,EAAE,oBAAoB,CAA0B;IACzD,SAAS,EAAE,oBAAoB,CAAY;IAE3C,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAGxB,OAAO,EAAE,OAAO,EAChB,QAAQ,GAAE;QACR,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;QACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;QACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;QAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;KACtC;IAYR,IAAI,UAAU,IAAI,qBAAqB,CAEtC;IAED,IAAI,UAAU,CAAC,KAAK,EAAE,qBAAqB,EAI1C;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,EAIvB;IAED,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,IAAI,eAAe,CAAC,KAAK,EAAE,OAAO,EAIjC;IAED;;;;OAIG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,WAAW,CAAC,KAAK,EAAE,OAAO,EAE7B;IAED,OAAO,IAAI,IAAI;CAGhB;AAkQD,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAEzE;AAED;;;GAGG;AAKH,eAAO,MAAM,OAAO;IAClB;;;;OAIG;kBACW,sBAAsB,GAAG,aAAa;IAepD;;;OAGG;oBACa,wBAAwB,GAAG,aAAa;IAkBxD;;;;OAIG;mBACY,uBAAuB,GAAG,aAAa;IAoBtD,kFAAkF;wBAC9D,4BAA4B,GAAG,aAAa;IAiBhE,qEAAqE;mBACtD,uBAAuB,GAAG,aAAa;IActD;;;;;OAKG;yBACkB,SAAS,OAAO,EAAE,GAAG,sBAAsB,GAAG,aAAa;IAiChF,+EAA+E;uBAC5D,2BAA2B,GAAG,aAAa;IAwC9D;;;;OAIG;cACa,MAAM,YAAW,sBAAsB,GAAQ,OAAO,CAAC,aAAa,CAAC;CAgDpF,CAAC"}