@aura3d/engine 4.6.2 → 4.7.0

package/dist/engine/contracts/looks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"looks.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/looks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"looks.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/looks.ts"],"names":[],"mappings":"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"}

package/dist/engine/contracts/looks.js.map

@@ -1 +1 @@
-{"version":3,"file":"looks.js","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/looks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,MAAM,aAAa,GAAG,IAAI,GAAG,EAA4B,CAAC;AAC1D,iFAAiF;AACjF,gFAAgF;AAChF,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;AAC/C,6EAA6E;AAC7E,4EAA4E;AAC5E,6DAA6D;AAC7D,IAAI,wBAAkD,CAAC;AACvD,IAAI,yBAAyB,GAAG,KAAK,CAAC;AAEtC,MAAM,UAAU,QAAQ,CAAC,CAAoB,EAAE,CAAsB;IACnE,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC/B,yBAAyB,GAAG,IAAI,CAAC;QACjC,wBAAwB,EAAE,EAAE,CAAC;IAC/B,CAAC;IACD,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAsB;IACzD,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;8EAC8E;AAC9E,MAAM,UAAU,wBAAwB,CAAC,KAAkC;IACzE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACnC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,2BAA2B,CAAC,QAAoB;IAC9D,wBAAwB,GAAG,QAAQ,CAAC;AACtC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,uBAAuB;IACrC,OAAO,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC;AAGD,sHAAsH"}
+{"version":3,"file":"looks.js","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/looks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwDH,MAAM,aAAa,GAAG,IAAI,GAAG,EAA4B,CAAC;AAC1D,iFAAiF;AACjF,gFAAgF;AAChF,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;AAC/C,6EAA6E;AAC7E,4EAA4E;AAC5E,6DAA6D;AAC7D,IAAI,wBAAkD,CAAC;AACvD,IAAI,yBAAyB,GAAG,KAAK,CAAC;AAEtC,MAAM,UAAU,QAAQ,CAAC,CAAoB,EAAE,CAAsB;IACnE,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC/B,yBAAyB,GAAG,IAAI,CAAC;QACjC,wBAAwB,EAAE,EAAE,CAAC;IAC/B,CAAC;IACD,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAsB;IACzD,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;8EAC8E;AAC9E,MAAM,UAAU,wBAAwB,CAAC,KAAkC;IACzE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACnC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,2BAA2B,CAAC,QAAoB;IAC9D,wBAAwB,GAAG,QAAQ,CAAC;AACtC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,uBAAuB;IACrC,OAAO,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC;AAGD,sHAAsH"}

package/dist/engine/contracts/materials.d.ts

@@ -3,6 +3,7 @@
  * Provider: PRD 04. Flag: A3D_QR_MATERIALS.
  */
 import type { AuraColor, AuraRuntimeNodeHandle } from "../agent-api/index.js";
+import type { AuraMaterialRimSpec } from "../agent-api/nodes/types.js";
 export type AuraMaterialTextureSlot = "baseColor" | "normal" | "metallicRoughness" | "occlusion" | "emissive" | "clearcoat" | "clearcoatRoughness" | "clearcoatNormal" | "sheenColor" | "sheenRoughness" | "specularIntensity" | "specularColor" | "transmission" | "thickness" | "iridescence" | "iridescenceThickness" | "anisotropy";
 export interface AuraModelMaterialOverride {
     readonly target?: string | RegExp | readonly (string | RegExp)[];
@@ -17,6 +18,20 @@ export interface AuraModelMaterialOverride {
     readonly clearcoatRoughness?: number;
     readonly envMapIntensity?: number;
     readonly opacity?: number;
+    /** Fresnel rim term, same shape as `AuraMaterialSpec.rim`. */
+    readonly rim?: AuraMaterialRimSpec;
+    /** KHR_materials_transmission factor 0..1 (rendered when `A3D_QR_MATERIALS_TRANSMISSION` is on). */
+    readonly transmission?: number;
+    /** KHR_materials_iridescence factor 0..1. */
+    readonly iridescence?: number;
+    /**
+     * GU47 pass 4: KHR_materials_sheen (fabric, fur, felt). `sheen` 0..1 scales `sheenColor` (default white), so
+     * `{ sheen: 0.45 }` alone gives a white sheen at 0.45; `sheenRoughness` 0..1. Written to materials that carry the sheen
+     * parameters (the PBR programs do).
+     */
+    readonly sheen?: number;
+    readonly sheenColor?: AuraColor;
+    readonly sheenRoughness?: number;
 }
 export interface AuraResolvedMaterialInfo {
     readonly name: string;
@@ -33,6 +48,13 @@ export interface AuraModelMaterialHandle {
     setMaterialVariant(name: string | null): void;
     setMaterialOverrides(o: readonly AuraModelMaterialOverride[]): void;
     inspectMaterials(): readonly AuraResolvedMaterialInfo[];
+    /**
+     * GU47 E-D: set the emissive colour and intensity of the materials named `target` (`"*"`: every material of the
+     * model), on the parameters each material carries. A live write with no snapshot re-apply, cheap enough to call every
+     * frame (brake lights, blinking signs, a charging glow). A later `setMaterialOverrides` / `setMaterialVariant`
+     * re-applies from the authored snapshot and replaces it. Flag-off (`A3D_QR_MATERIALS` off) it is recorded only.
+     */
+    setEmissive(target: string, color: string, intensity: number): void;
 }
 export interface AuraRendererMaterialOptions {
     readonly materialStrictness?: "warn" | "strict";
@@ -76,6 +98,9 @@ export declare class StubModelMaterialHandle implements AuraModelMaterialHandle
     materialVariants(): readonly string[];
     setMaterialVariant(name: string | null): void;
     setMaterialOverrides(o: readonly AuraModelMaterialOverride[]): void;
+    /** GU47 E-D: recorded only on the stub (reported as `STUB_MATERIAL_HANDLE` by `inspectMaterials`). */
+    setEmissive(target: string, color: string, intensity: number): void;
+    private emissive;
     inspectMaterials(): readonly AuraResolvedMaterialInfo[];
 }
 //# sourceMappingURL=materials.d.ts.map

package/dist/engine/contracts/materials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/materials.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/materials.ts"],"names":[],"mappings":"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"}

package/dist/engine/contracts/materials.js

@@ -20,6 +20,9 @@ export class StubModelMaterialHandle {
     materialVariants() { return []; }
     setMaterialVariant(name) { this.variant = name; }
     setMaterialOverrides(o) { this.overrides = o; }
+    /** GU47 E-D: recorded only on the stub (reported as `STUB_MATERIAL_HANDLE` by `inspectMaterials`). */
+    setEmissive(target, color, intensity) { this.emissive = { target, color, intensity }; }
+    emissive = null;
     inspectMaterials() {
         return this.names.map((name) => ({
             name,
@@ -28,7 +31,7 @@ export class StubModelMaterialHandle {
             enabledMaps: [],
             extensions: [],
             lightsEvaluated: "uniform-16",
-            warnings: this.overrides.length > 0 || this.variant !== null ? ["STUB_MATERIAL_HANDLE"] : []
+            warnings: this.overrides.length > 0 || this.variant !== null || this.emissive !== null ? ["STUB_MATERIAL_HANDLE"] : []
         }));
     }
 }

package/dist/engine/contracts/materials.js.map

@@ -1 +1 @@
-{"version":3,"file":"materials.js","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/materials.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IAIL;IAA4D;IAHjF,SAAS,GAAyC,EAAE,CAAC;IACrD,OAAO,GAAkB,IAAI,CAAC;IAEtC,YAA6B,MAAyC,EAAmB,QAA2B,EAAE;QAAzF,WAAM,GAAN,MAAM,CAAmC;QAAmB,UAAK,GAAL,KAAK,CAAwB;IAAG,CAAC;IAE1H,aAAa,KAAwB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,gBAAgB,KAAwB,OAAO,EAAE,CAAC,CAAC,CAAC;IACpD,kBAAkB,CAAC,IAAmB,IAAU,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;IACtE,oBAAoB,CAAC,CAAuC,IAAU,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3F,gBAAgB;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI;YACJ,UAAU,EAAE,QAAQ;YACpB,eAAe,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU;YACtC,WAAW,EAAE,EAAE;YACf,UAAU,EAAE,EAAE;YACd,eAAe,EAAE,YAAqB;YACtC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAAE;SAC7F,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}
+{"version":3,"file":"materials.js","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/materials.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4DH;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IAIL;IAA4D;IAHjF,SAAS,GAAyC,EAAE,CAAC;IACrD,OAAO,GAAkB,IAAI,CAAC;IAEtC,YAA6B,MAAyC,EAAmB,QAA2B,EAAE;QAAzF,WAAM,GAAN,MAAM,CAAmC;QAAmB,UAAK,GAAL,KAAK,CAAwB;IAAG,CAAC;IAE1H,aAAa,KAAwB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,gBAAgB,KAAwB,OAAO,EAAE,CAAC,CAAC,CAAC;IACpD,kBAAkB,CAAC,IAAmB,IAAU,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;IACtE,oBAAoB,CAAC,CAAuC,IAAU,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3F,sGAAsG;IACtG,WAAW,CAAC,MAAc,EAAE,KAAa,EAAE,SAAiB,IAAU,IAAI,CAAC,QAAQ,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IAC7G,QAAQ,GAA2F,IAAI,CAAC;IAChH,gBAAgB;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI;YACJ,UAAU,EAAE,QAAQ;YACpB,eAAe,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU;YACtC,WAAW,EAAE,EAAE;YACf,UAAU,EAAE,EAAE;YACd,eAAe,EAAE,YAAqB;YACtC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAAE;SACvH,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/engine/contracts/post.d.ts

@@ -54,6 +54,18 @@ export interface AuraPostSurface {
     setQualityTier(t: AuraQualityTier | "auto"): void;
     /** SH-03: mutate one numeric uniform of a registered custom pass by name; staged onto the live descriptor — no re-registration or shader rebuild. Optional on stub surfaces. */
     setPassUniform?(passName: string, key: string, value: number | readonly number[]): void;
+    /**
+     * GU47 E-C: patch one post effect at runtime — `bloom`, `colorGrade`, `depthOfField`, `motionBlur`,
+     * `chromaticAberration`, `volumetricFog`, `vignette`, `ambientOcclusion`, `filmGrain` or `outline` (`{ targets: [nodeName] }`
+     * retargets the outline, GU47 E-E) (the factory name; the effect id such as
+     * `"color-grade"` works too). `patch` keys are the effect's node fields (`app.post.setEffect("bloom",
+     * { intensity: 1.4 })`); later calls merge over earlier ones. Applied on the next frame, no scene
+     * rebuild. An effect the scene does not declare is added with the patch over its defaults. Unknown
+     * names, fields or non-finite values throw `AuraRuntimeError("POST_FIELD_UNSUPPORTED")`.
+     */
+    setEffect(name: string, patch: Record<string, number | string | boolean | number[] | readonly string[]>): void;
+    /** GU47 E-C: switch one of the `setEffect` effects off (dropped from the chain) or back on (authored node plus patches, or the defaults when the scene declares none). Next frame, no scene rebuild. */
+    setEffectEnabled(name: string, enabled: boolean): void;
 }
 export interface AuraPostDiagnostics {
     readonly tier: AuraQualityTier;
@@ -72,5 +84,7 @@ export interface AuraPostDiagnostics {
 export declare class StubPostSurface implements AuraPostSurface {
     addPostPass(p: AuraCustomPostPass): () => void;
     setQualityTier(_t: AuraQualityTier | "auto"): void;
+    setEffect(_name: string, _patch: Record<string, number | string | boolean | number[]>): void;
+    setEffectEnabled(_name: string, _enabled: boolean): void;
 }
 //# sourceMappingURL=post.d.ts.map

package/dist/engine/contracts/post.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/post.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/post.ts"],"names":[],"mappings":"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"}

package/dist/engine/contracts/post.js

@@ -16,5 +16,7 @@ export class StubPostSurface {
         return () => { /* pass release on the stub chain is a no-op */ void p; };
     }
     setQualityTier(_t) { }
+    setEffect(_name, _patch) { }
+    setEffectEnabled(_name, _enabled) { }
 }
 //# sourceMappingURL=post.js.map

package/dist/engine/contracts/post.js.map

@@ -1 +1 @@
-{"version":3,"file":"post.js","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/post.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,IAAI,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAmB9E,yTAAyT;AAEzT,wFAAwF;AACxF,MAAM,OAAO,eAAe;IAC1B,WAAW,CAAC,CAAqB;QAC/B,OAAO,GAAG,EAAE,GAAG,+CAA+C,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;IACD,cAAc,CAAC,EAA4B,IAA2D,CAAC;CACxG"}
+{"version":3,"file":"post.js","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/post.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,IAAI,WAAW,EAAE,MAAM,6BAA6B,CAAC;AA+B9E,yTAAyT;AAEzT,wFAAwF;AACxF,MAAM,OAAO,eAAe;IAC1B,WAAW,CAAC,CAAqB;QAC/B,OAAO,GAAG,EAAE,GAAG,+CAA+C,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;IACD,cAAc,CAAC,EAA4B,IAA2D,CAAC;IACvG,SAAS,CAAC,KAAa,EAAE,MAA4D,IAA2D,CAAC;IACjJ,gBAAgB,CAAC,KAAa,EAAE,QAAiB,IAA2D,CAAC;CAC9G"}

package/dist/engine/instances-model/CrowdKit.d.ts

@@ -0,0 +1,231 @@
+/**
+ * GU47 E-H (WP-8) — crowd kit: pose-baked instanced crowds.
+ *
+ * A skinned `instances.model` cannot instance (each copy needs its own joint palette), so a
+ * stadium of rigged spectators used to cost one actor and one draw per spectator, or drew a single
+ * copy. The kit bakes a skinned GLB clip into `poses` static meshes on the CPU (linear blend
+ * skinning applied once per pose frame), and draws the crowd as one instanced node per pose:
+ * 480 spectators with 4 poses are 4 draws.
+ *
+ * Every spectator has its own transform, colour (instance colour, multiplied into the baked
+ * per-part vertex colours), clip phase and optional held pose index. Phases are quantised into
+ * `poses` balanced groups; on each frame of the loop every group steps to its next pose, so a
+ * group moves from one pose node to the next instead of each spectator re-sorting. An optional
+ * per-spectator `bob` (its own phase, smooth between pose frames) adds continuous motion.
+ *
+ * `update` writes dense instance matrices and colours through `setInstanceMatrices` with no
+ * allocation in the kit; counts that divide evenly by `poses` keep every node's count constant,
+ * so the node stores are reused too.
+ */
+import type { AuraCustomGeometrySpec } from "../agent-api/RootGeometry.js";
+import type { AuraNodeBuilder } from "../agent-api/nodes/builder.js";
+import type { AuraColor, AuraMaterialSpec, AuraPrimitiveNode, AuraVec3 } from "../agent-api/nodes/types.js";
+type Vec3Tuple = readonly [number, number, number];
+type Vec4Tuple = readonly [number, number, number, number];
+/** One mesh primitive of the source GLB (the shapes `GLTFMeshAsset` already carries). */
+export interface AuraCrowdBakePrimitive {
+    readonly positions: readonly Vec3Tuple[];
+    readonly normals?: readonly Vec3Tuple[];
+    readonly uvs?: readonly (readonly [number, number])[];
+    readonly indices?: readonly number[];
+    /** Skin joint indices (into the palette) and weights, four per vertex. */
+    readonly joints?: readonly Vec4Tuple[];
+    readonly weights?: readonly Vec4Tuple[];
+    /** Linear RGBA multiplied into every vertex (the primitive material's base colour factor). */
+    readonly color?: Vec4Tuple;
+    /** Linear RGBA per vertex (`COLOR_0`). */
+    readonly vertexColors?: readonly Vec4Tuple[];
+}
+/** One sampled pose: per primitive (same order), the mesh node's world matrix and its joint palette. */
+export interface AuraCrowdBakePoseFrame {
+    readonly primitives: readonly {
+        /** Column-major mat4: the mesh node's world matrix in the GLB scene. */
+        readonly world: ArrayLike<number>;
+        /** Column-major mat4 per skin joint (`inverse(meshWorld) · jointWorld · inverseBind`). */
+        readonly palette?: ArrayLike<number>;
+    }[];
+}
+export interface AuraCrowdBakeOptions {
+    /** Scale the baked spectator to this height (world units). Default: the GLB's own size. */
+    readonly targetHeight?: number;
+}
+/**
+ * Bake pose frames into static meshes. All poses share topology, UVs and colours; positions and
+ * normals carry the skinned pose. Baked spectators stand on y = 0, centred on x/z (pose 0 bounds).
+ */
+export declare function bakeCrowdPoses(primitives: readonly AuraCrowdBakePrimitive[], frames: readonly AuraCrowdBakePoseFrame[], options?: AuraCrowdBakeOptions): AuraCustomGeometrySpec[];
+/** Baked poses of one clip, ready for `createCrowd`. */
+export interface AuraCrowdPoseSet {
+    readonly poses: readonly AuraCustomGeometrySpec[];
+    /** Loop length of the baked clip in seconds (1 for a static bake). */
+    readonly clipSeconds: number;
+    /** The clip the poses were sampled from (absent for a static bake). */
+    readonly clip?: string;
+    /** Triangles per spectator. */
+    readonly triangles: number;
+}
+export interface AuraCrowdSampleOptions extends AuraCrowdBakeOptions {
+    /** Clip to bake. Default: the GLB's first clip; a GLB without clips bakes its rest pose. */
+    readonly clip?: string;
+    /** Pose frames sampled evenly over the clip (1..16, default 4). Each pose is one draw. */
+    readonly poses?: number;
+}
+/** The parts of a loaded `TypedGLBActor` the sampler reads. */
+export interface AuraCrowdBakeActor {
+    readonly pipeline: {
+        readonly asset: {
+            readonly meshes: readonly {
+                readonly name: string;
+                readonly topology: "triangles" | "lines" | "points";
+                readonly positions: readonly Vec3Tuple[];
+                readonly normals: readonly Vec3Tuple[];
+                readonly texcoords: readonly (readonly [number, number])[];
+                readonly colors: readonly Vec4Tuple[];
+                readonly joints: readonly Vec4Tuple[];
+                readonly weights: readonly Vec4Tuple[];
+                readonly indices?: readonly number[];
+                readonly materialIndex?: number;
+            }[];
+            readonly materials: readonly {
+                readonly baseColorFactor: Vec4Tuple;
+            }[];
+            readonly animations: readonly {
+                readonly name: string;
+                readonly duration: number;
+            }[];
+        };
+        readonly resources: {
+            readonly scene: {
+                updateWorldTransforms(): void;
+                collectRenderables(): readonly {
+                    readonly node: {
+                        readonly visible: boolean;
+                        readonly transform: {
+                            readonly worldMatrix: ArrayLike<number>;
+                        };
+                    };
+                    readonly renderable: {
+                        readonly geometry: string;
+                        readonly skinning?: {
+                            readonly matrices: Float32Array;
+                        };
+                    };
+                }[];
+            };
+        };
+    };
+    playClip(name: string, time: number): unknown;
+}
+/** Sample `poses` frames of a clip from a loaded GLB actor and bake them. */
+export declare function sampleCrowdPoseSet(actor: AuraCrowdBakeActor, options?: AuraCrowdSampleOptions): AuraCrowdPoseSet;
+/** A GLB asset reference (typed asset tables provide `url` and `hash`). */
+export interface AuraCrowdAsset {
+    readonly url: string;
+    readonly hash?: string;
+    readonly type?: string;
+    readonly format?: string;
+    readonly sizeBytes?: number;
+}
+export interface AuraCrowdLoadOptions extends AuraCrowdSampleOptions {
+    /** Forwarded to the GLB load (`assets.decoders`) for draco / meshopt sources. */
+    readonly decoders?: import("../contracts/assets.js").AuraAssetDecodersOption;
+}
+/**
+ * Load a skinned GLB once, bake `poses` frames of a clip and dispose the actor. Results are
+ * memoised per (asset, clip, poses, targetHeight), so remounting a scene does not bake again; the
+ * GLB itself goes through the shared parse cache and the GLB resource cache.
+ */
+export declare function loadCrowdPoses(asset: AuraCrowdAsset, options?: AuraCrowdLoadOptions): Promise<AuraCrowdPoseSet>;
+/** Drop the memoised bakes (tests, memory pressure). */
+export declare function clearCrowdPoseCache(): void;
+export interface AuraCrowdSpectator {
+    readonly position: AuraVec3;
+    /** Rotation about +Y in radians (0 faces the GLB's own forward). */
+    readonly yaw?: number;
+    readonly scale?: number;
+    /** Instance colour (multiplied into the baked part colours and the material colour). */
+    readonly color?: AuraColor;
+    /** Clip phase in [0, 1): spreads spectators over the loop (quantised into `poses` balanced groups). */
+    readonly phase?: number;
+    /** Hold this pose index instead of playing the loop (for example a seated pose). */
+    readonly pose?: number;
+}
+export interface AuraCrowdOptions {
+    /** Runtime id prefix: pose node `k` gets the id `${id}:pose-${k}`. */
+    readonly id: string;
+    /** Baked poses (`loadCrowdPoses` / `sampleCrowdPoseSet`) or plain pose meshes (loop length 1 s). */
+    readonly poses: AuraCrowdPoseSet | readonly AuraCustomGeometrySpec[];
+    readonly spectators: readonly AuraCrowdSpectator[];
+    /** Shared material. Default: white PBR, roughness 0.85 (part and instance colours show as authored). */
+    readonly material?: AuraMaterialSpec;
+    /** Loop playback rate for the whole crowd (default 1; 0 holds every spectator on its phase's pose). */
+    readonly speed?: number;
+    /** Vertical bob amplitude in world units, per spectator on its own phase (default 0). */
+    readonly bob?: number;
+    readonly castShadow?: boolean;
+    readonly receiveShadow?: boolean;
+    /** Node name prefix (default: `id`). */
+    readonly name?: string;
+}
+/** What `setInstanceMatrices` / `setVisible` need from a runtime node handle. */
+export interface AuraCrowdNodeHandle {
+    setInstanceMatrices(matrices: Float32Array, count: number, rgba?: Float32Array): unknown;
+    setVisible(visible: boolean): unknown;
+}
+/** `app.nodes` (or any registry resolving the crowd's node ids). */
+export interface AuraCrowdTarget {
+    readonly nodes: {
+        get(id: string): AuraCrowdNodeHandle | undefined;
+    };
+}
+export interface AuraCrowdDrawPlan {
+    readonly kind: "aura-crowd-draw-plan";
+    readonly spectators: number;
+    readonly poseNodes: number;
+    /** Loop frame (pose step) the plan was computed for. */
+    readonly frame: number;
+    /** Instanced draws this frame: pose nodes holding at least one spectator. */
+    readonly draws: number;
+    readonly perNode: readonly {
+        readonly id: string;
+        readonly pose: number;
+        readonly count: number;
+        readonly capacity: number;
+    }[];
+    readonly trianglesPerSpectator: number;
+    readonly triangles: number;
+}
+export interface AuraCrowd {
+    readonly id: string;
+    /** Spectator count. */
+    readonly count: number;
+    /** Pose nodes (one instanced draw each). */
+    readonly poseCount: number;
+    /** Scene nodes to add (`scene.add(...crowd.nodes)`). */
+    readonly nodes: readonly AuraNodeBuilder<AuraPrimitiveNode>[];
+    readonly nodeIds: readonly string[];
+    /** Live per-spectator state (xyz per spectator); edit in place, then `markDirty()`. */
+    readonly positions: Float32Array;
+    readonly yaws: Float32Array;
+    readonly scales: Float32Array;
+    /** Linear RGBA per spectator. */
+    readonly colors: Float32Array;
+    setYaw(index: number, yaw: number): void;
+    setPosition(index: number, x: number, y: number, z: number): void;
+    setColor(index: number, color: AuraColor): void;
+    /** Rewrite instance data on the next `update` even if the loop frame did not change. */
+    markDirty(): void;
+    /** Loop frame (0..poseCount-1) at `timeSeconds`. */
+    frameAt(timeSeconds: number): number;
+    /**
+     * Bucket spectators into their pose nodes for `timeSeconds` and write the dense instance data.
+     * Allocation-free; returns the instanced draw count this frame.
+     */
+    update(target: AuraCrowdTarget, timeSeconds: number): number;
+    /** Counts per pose node for `timeSeconds` (diagnostics, receipts). */
+    drawPlan(timeSeconds?: number): AuraCrowdDrawPlan;
+}
+/** Build a pose-baked instanced crowd: one instanced node per pose, spectators bucketed per frame. */
+export declare function createCrowd(options: AuraCrowdOptions): AuraCrowd;
+export {};
+//# sourceMappingURL=CrowdKit.d.ts.map

package/dist/engine/instances-model/CrowdKit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrowdKit.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/instances-model/CrowdKit.ts"],"names":[],"mappings":"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"}