@aura3d/engine 3.0.0 → 3.0.1

package/dist/engine/agent-api/index.d.ts

@@ -1,5 +1,8 @@
+import { type AuraPerformanceQuality } from "./RootRuntimeSupport.js";
+export type { AuraPerformanceQuality } from "./RootRuntimeSupport.js";
 import type { Collider, ColliderDescriptor, CollisionEvent, Constraint, ConstraintDescriptor, Contact, DebugLine, PhysicsBackendSelection, PhysicsContinuousCollisionDescriptor, PhysicsShape, PhysicsSnapshot, PhysicsWorldDescriptor, RaycastHit, RaycastOptions, RigidBody, RigidBodyDescriptor, RigidBodyType, ScenePhysicsNode, SphereCastHit } from "../../physics/index.js";
-import { type SdfTextOcclusionPolicy, type SdfTextStyle, sampleOceanFixture, Geometry, InstancedPBRMaterial, PBRMaterial, TexturedPBRMaterial, type DayNightSkyOptions, type EnvironmentLightingOptions, type WaterSurfaceBoat, type WaterSurfacePreset, type WeatherType, type RenderDeviceDiagnostics, type RendererPostprocessExecutionMode } from "../../rendering/index.js";
+import { type SdfTextOcclusionPolicy, type SdfTextStyle, sampleOceanFixture, Geometry, InstancedPBRMaterial, PBRMaterial, TexturedPBRMaterial, type CollectedLight, type DayNightSkyOptions, type EnvironmentLightingOptions, type WaterSurfaceBoat, type WaterSurfacePreset, type WeatherType, type RenderDeviceDiagnostics, type RendererPostprocessExecutionMode } from "../../rendering/index.js";
+import type { TypedGLBActorEvidence } from "../production-runtime/TypedGLBActor.js";
 import { type LabelTelemetry, type TextBucketSummary } from "./LabelTelemetry.js";
 import { type ProjectedLabel } from "./WorldLabelRenderer.js";
 import { defineAuraCustomGeometry, type AuraCustomGeometrySpec, type AuraText3DGeometry, type AuraText3DOptions } from "./RootGeometry.js";
@@ -126,7 +129,7 @@ export { createGameAppRuntime, type GameAppRuntime, type GameAppRuntimeEvidence,
 export { FrameLoop, createFrameLoop, type FrameLoopCallback, type FrameLoopFrame, type FrameLoopOptions, type FrameLoopSnapshot, type FrameLoopSource } from "./FrameLoop.js";
 export { createCombatWorld, createGameCameraDirector, createGameEffects, applyGameCombatEventsToRuntime, createGameAccessibilityFocus, createGameAccessibilityLabel, createGameAccessibilityRuntimeSettings, createGameHighContrastSource, createGameHudBindings, createGameHudComboBinding, createGameHudDebugToggleBinding, createGameHudHealthBinding, createGameHudMeterBinding, createGameHudRoundBinding, createGameHudSnapshot, createGameHudTimerBinding, createGameBoxCollider, createGameCapsuleCollider, createGameColliderDebugGeometry, createGameCombatDebugGeometry, createGameDebugOverlayData, createGameDebugSceneNodes, createGameHitboxDebugGeometry, createGameSimulation, createGameInput, createGameInputReplay, createGameInputReplayDriver, createGameJumpAssist, createGameKinematicBody, createGamePauseControlsSource, createGameRectCollider, createGameReducedFlashSource, createGameReducedMotionSource, createGameSphereCollider, createGameTouchControlLayout, gameColliderAabb, gameColliders, gameInputReplayEventsAt, createGameLoopPlan, runGameSimulation, type GameAccessibilityFocusOptions, type GameAccessibilityLabelOptions, type GameAccessibilityPauseControlsOptions, type GameAccessibilityPreferenceOptions, type GameAccessibilityRuntimeSettings, type GameAccessibilityRuntimeSettingsOptions, type GameAccessibilitySource, type GameAccessibilitySourceKind, type GameAabb, type GameBounds3, type GameCameraDirector, type GameCameraDirectorOptions, type GameCameraSnapshot, type GameCameraTarget, type GameCollisionAddBodyOptions, type GameCollisionBodyHandle, type GameCollisionBodyOptions, type GameCollisionBodySnapshot, type GameCollisionBox, type GameCollisionContact, type GameCollisionEvent, type GameCollisionParticipant, type GameCollisionQueryFilter, type GameCollisionSweepHit, type GameCollisionSweepOptions, type GameCollisionWorld, type GameCollisionWorldSnapshot, type GameCombatActorOptions, type GameCombatActorSnapshot, type GameCombatActiveAttackSnapshot, type GameCombatEvent, type GameCombatEventRuntimeBridgeOptions, type GameCombatEventRuntimeBridgeResult, type GameCombatEventType, type GameCombatMove, type GameCombatWorld, type GameCombatWorldSnapshot, type GameBoxCollider, type GameBoxColliderOptions, type GameCapsuleCollider, type GameCapsuleColliderOptions, type GameCollider, type GameColliderAxis, type GameColliderBase, type GameColliderDimension, type GameColliderFactoryOptions, type GameColliderKind, type GameColliderPlane, type GameDebugGeometryNode, type GameDebugGeometryOptions, type GameDebugGeometryPrimitive, type GameDebugOverlayData, type GameDebugOverlayMetric, type GameDebugOverlayOptions, type GameDebugOverlaySection, type GameDebugSceneNode, type GameDebugSceneNodeOptions, type GameDebugScenePrimitive, type GameEffectInstance, type GameEffectAttachment, type GameEffectKind, type GameEffectOptions, type GameEffectsController, type GameEffectsSnapshot, type GameEventInput, type GameEventLog, type GameEventLogOptions, type GameEventLogSnapshot, type GameEventRecord, type GameEventSeverity, type GameHudActorBindingOptions, type GameHudBinding, type GameHudBindingKind, type GameHudComboBindingOptions, type GameHudDebugToggleBindingOptions, type GameHudEventLogBindingOptions, type GameHudObjectiveBindingOptions, type GameHudResolvedValue, type GameHudRoundBindingOptions, type GameHudScoreBindingOptions, type GameHudSourceKind, type GameHudSnapshot, type GameHudSnapshotItem, type GameHudSnapshotOptions, type GameHudTimerBindingOptions, type GameHudValueBindingOptions, type GameHudValueFormat, type GameInputActionState, type GameInputAxisSettings, type GameInputAxisBinding, type GameInputController, type GameInputOptions, type GameInputReplayDriver, type GameInputReplayDriverSnapshot, type GameInputReplayEvent, type GameInputReplayOptions, type GameInputReplayPlan, type GameInputSnapshot, type GameJumpAssistController, type GameJumpAssistOptions, type GameJumpAssistSnapshot, type GameJumpAssistUpdate, type GameKinematicBody, type GameKinematicBodyOptions, type GameKinematicBodySnapshot, type GameLoopPlan, type GamePointerSnapshot, type GameRectCollider, type GameRectColliderOptions, type GameRuntimeSubsystemId, type GameRuntimeSubsystemOwnership, type GameSimulation, type GameSimulationFrame, type GameSimulationOptions, type GameSimulationResult, type GameSimulationStepContext, type GameSimulationStepResult, type GameSphereCollider, type GameSphereColliderOptions, type GameSubsystemOwner, type GameTouchControlAnchor, type GameTouchControlKind, type GameTouchControlLayout, type GameTouchControlLayoutOptions, type GameTouchControlRegion, type GameTouchControlRequest, type GameVec3, type GamepadSnapshot } from "./GameRuntime.js";
 export { collectGameSceneRuntimeNodes, createGameSceneBridge, createRuntimeNodeSpec, type GameSceneBridge, type GameSceneBridgeApp, type GameSceneBridgeBodyLike, type GameSceneBridgeEvidence, type GameSceneBridgeNodeHandle, type GameSceneRuntimeNode } from "./GameSceneBridge.js";
-export { calculateRuntimeNodeBounds, createRuntimeNodeEffectAttachment, runtimeNodeHasTag, type AuraRuntimeNodeAnimationPoseBindingMetadata, type AuraRuntimeNodeAnimationBindingMetadata, type AuraRuntimeNodeBounds, type AuraRuntimeNodeEffectAttachment, type AuraRuntimeNodeEffectKind, type RuntimeNodeAnimationSpecLike, type RuntimeNodeBoundsInput, type RuntimeNodeHandleLike, type RuntimeNodeMorphTargetWeights, type RuntimeNodeVec3 } from "./RuntimeNodeHandle.js";
+export { calculateRuntimeNodeBounds, createRuntimeNodeEffectAttachment, runtimeNodeHasTag, type AuraRuntimeNodeAnimationPoseBindingMetadata, type AuraRootMotionBinding, type AuraRuntimeNodeAnimationBindingMetadata, type AuraRuntimeNodeBounds, type AuraRuntimeNodeEffectAttachment, type AuraRuntimeNodeEffectKind, type RuntimeNodeAnimationSpecLike, type RuntimeNodeBoundsInput, type RuntimeNodeHandleLike, type RuntimeNodeMorphTargetWeights, type RuntimeNodeVec3 } from "./RuntimeNodeHandle.js";
 export { createFightingGameKit, fighting, fighterRuntimeNode, type FightingActorState, type FightingControls, type FightingGameKit, type FightingGameKitOptions, type FightingGameSnapshot, type FightingStageOptions } from "./game-kits/fighting.js";
 export { gameKits } from "./game-kits/index.js";
 export type { GameRuntimeEvidence, GameRuntimeEvidenceApp, GameRuntimeEvidenceOptions, GameRuntimeSourceEvidence } from "./GameEvidence.js";
@@ -280,6 +283,16 @@ export interface AuraMaterialSpec {
     readonly occlusionStrength?: number;
     /** Emissive map slot: multiplied by `emissive` (default white when only the map is set) × `emissiveIntensity`. */
     readonly emissiveMap?: AuraMaterialTextureInput;
+    /** glTF extension maps: data channels are linear; sheen color is sRGB. */
+    readonly clearcoatMap?: AuraAssetRef<"texture">;
+    readonly clearcoatRoughnessMap?: AuraAssetRef<"texture">;
+    readonly clearcoatNormalMap?: AuraAssetRef<"texture">;
+    readonly clearcoatNormalScale?: number;
+    readonly sheenColorMap?: AuraAssetRef<"texture">;
+    readonly sheenRoughnessMap?: AuraAssetRef<"texture">;
+    readonly iridescenceMap?: AuraAssetRef<"texture">;
+    readonly iridescenceThicknessMap?: AuraAssetRef<"texture">;
+    readonly anisotropyMap?: AuraAssetRef<"texture">;
     /**
      * Per-slot UV set selection for the native texCoord selector (muse3jsparity-PRD C1).
      * 0 samples the authored unwrap, 1 the procedural 2x tiling unwrap.
@@ -290,6 +303,14 @@ export interface AuraMaterialSpec {
         readonly metallicRoughness?: 0 | 1;
         readonly occlusion?: 0 | 1;
         readonly emissive?: 0 | 1;
+        readonly clearcoat?: 0 | 1;
+        readonly clearcoatRoughness?: 0 | 1;
+        readonly clearcoatNormal?: 0 | 1;
+        readonly sheenColor?: 0 | 1;
+        readonly sheenRoughness?: 0 | 1;
+        readonly iridescence?: 0 | 1;
+        readonly iridescenceThickness?: 0 | 1;
+        readonly anisotropy?: 0 | 1;
     };
     /** Per-slot UV transforms, passed through to the native per-slot transform uniforms. */
     readonly texTransforms?: {
@@ -298,6 +319,14 @@ export interface AuraMaterialSpec {
         readonly metallicRoughness?: AuraTextureTransform;
         readonly occlusion?: AuraTextureTransform;
         readonly emissive?: AuraTextureTransform;
+        readonly clearcoat?: AuraTextureTransform;
+        readonly clearcoatRoughness?: AuraTextureTransform;
+        readonly clearcoatNormal?: AuraTextureTransform;
+        readonly sheenColor?: AuraTextureTransform;
+        readonly sheenRoughness?: AuraTextureTransform;
+        readonly iridescence?: AuraTextureTransform;
+        readonly iridescenceThickness?: AuraTextureTransform;
+        readonly anisotropy?: AuraTextureTransform;
     };
 }
 export interface AuraEditableMaterialParameters {
@@ -864,6 +893,8 @@ export interface AuraRendererDiagnosticReport {
         readonly label?: string;
         readonly nativeShadowMapBindings: number;
         readonly shadowRenderTargetsAllocated: number;
+        /** Submitted cascade matrices/point atlas state; null before a real shadow frame. */
+        readonly observed: Readonly<Record<string, unknown>> | null;
         readonly contactShadows: number;
         readonly mapType: "pcf-soft";
         /**
@@ -922,6 +953,8 @@ export interface AuraRendererDiagnosticReport {
         readonly passNames: readonly string[];
         readonly warnings: readonly string[];
         readonly nativeInstancedSubmissions: number;
+        readonly nativeTemporalPasses?: number;
+        readonly nativeTemporalBindings?: number;
         readonly submittedObjects: number;
         readonly visibleObjects: number;
         readonly culledObjects: number;
@@ -1245,6 +1278,7 @@ export declare const lights: {
         readonly position?: AuraVec3;
         readonly intensity?: number;
         readonly color?: AuraColor;
+        readonly shadow?: boolean;
     }) => AuraNodeBuilder<AuraLightNode>;
     readonly point: (options?: {
         readonly name?: string;
@@ -1299,6 +1333,10 @@ export interface AuraCameraSpec {
     readonly targetOffset?: AuraVec3;
     readonly offsetMode?: "scene" | "target-yaw";
     readonly fov?: number;
+    /** Positive near clipping distance in world units; defaults to 0.05. */
+    readonly near?: number;
+    /** Far clipping distance in world units, greater than near; defaults to 100. */
+    readonly far?: number;
     readonly distance?: number;
     readonly from?: AuraVec3;
     readonly to?: AuraVec3;
@@ -1443,8 +1481,8 @@ export declare const effects: {
     readonly colorGrade: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
     /**
      * Root anti-alias node (muse3jsparity-PRD A3). `fxaa` executes natively;
-     * `off` submits nothing; `taa` is recorded but withheld (no history binding
-     * at root) with an explicit diagnostic warning.
+     * `off` submits nothing; `taa` uses renderer-owned velocity/history for opaque
+     * rigid triangles. Unsupported deforming/transparent geometry emits a named warning.
      */
     readonly antiAlias: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
     /**
@@ -1464,8 +1502,8 @@ export declare const effects: {
      */
     readonly depthOfField: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
     /**
-     * Root motion-blur node (muse3jsparity-PRD A3): recorded but withheld (no
-     * velocity binding at root) with an explicit diagnostic warning.
+     * Root motion-blur node: renderer-owned GPU velocity for opaque rigid geometry.
+     * Unsupported deforming/transparent/instanced geometry emits a named warning.
      */
     readonly motionBlur: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
     readonly rain: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
@@ -1727,6 +1765,7 @@ interface AuraRendererRuntimeObservation {
         readonly label?: string;
         readonly nativeShadowMapBindings?: number;
         readonly shadowRenderTargetsAllocated?: number;
+        readonly observed?: Readonly<Record<string, unknown>> | null;
         /**
          * N1 authored spot shadow state (muse3jsparity-PRD). `spotPixelBacked`
          * requires the device-observed map signals on a spot caster.
@@ -1763,7 +1802,7 @@ interface AuraRendererRuntimeObservation {
         readonly evictedEntries: readonly string[];
     };
     readonly warnings?: readonly string[];
-    readonly deviceDiagnostics?: Pick<RenderDeviceDiagnostics, "nativeInstancedSubmissions" | "submittedObjects" | "visibleObjects" | "culledObjects" | "frustumTestedObjects" | "bloom" | "samplerAnisotropyUploads" | "maxTextureAnisotropy">;
+    readonly deviceDiagnostics?: Pick<RenderDeviceDiagnostics, "nativeTemporalPasses" | "nativeTemporalBindings" | "nativeInstancedSubmissions" | "submittedObjects" | "visibleObjects" | "culledObjects" | "frustumTestedObjects" | "bloom" | "samplerAnisotropyUploads" | "maxTextureAnisotropy">;
     readonly lodSelections?: readonly {
         readonly nodeName: string;
         readonly levelIndex: number;
@@ -3108,6 +3147,14 @@ export interface AuraRuntimeNodeImportedAssetEvidence {
     readonly lastFootPlantingTargetError?: number | undefined;
     readonly lastFootPlantingHipOffset?: number | undefined;
     readonly lastFootPlantingMissingLegs?: readonly string[] | undefined;
+    readonly lastFootPlantingDeformation?: TypedGLBActorEvidence["lastFootPlantingDeformation"];
+    readonly lastFootPlantingSurfaces?: TypedGLBActorEvidence["lastFootPlantingSurfaces"];
+    readonly lastFootPlantingFeet?: readonly {
+        readonly side: "left" | "right";
+        readonly worldPosition: readonly [number, number, number];
+        readonly contactError: number;
+        readonly locked: boolean;
+    }[] | undefined;
     readonly footPlantingConfigured?: boolean | undefined;
     readonly diagnostics: readonly AuraRuntimeNodeImportedAssetDiagnostic[];
 }
@@ -3140,6 +3187,14 @@ export interface AuraRuntimeNodeImportedAssetEvidenceInput {
     readonly lastFootPlantingTargetError?: number | undefined;
     readonly lastFootPlantingHipOffset?: number | undefined;
     readonly lastFootPlantingMissingLegs?: readonly string[] | undefined;
+    readonly lastFootPlantingDeformation?: TypedGLBActorEvidence["lastFootPlantingDeformation"];
+    readonly lastFootPlantingSurfaces?: TypedGLBActorEvidence["lastFootPlantingSurfaces"];
+    readonly lastFootPlantingFeet?: readonly {
+        readonly side: "left" | "right";
+        readonly worldPosition: readonly [number, number, number];
+        readonly contactError: number;
+        readonly locked: boolean;
+    }[] | undefined;
     readonly footPlantingConfigured?: boolean | undefined;
     readonly requiredClips?: readonly string[] | undefined;
     readonly requiredBones?: readonly string[] | undefined;
@@ -3179,6 +3234,8 @@ export interface AuraApp {
      */
     readonly physics: AuraPhysicsRuntime;
     setScene(scene: AuraSceneBuilder | AuraSceneSnapshot): void;
+    /** Apply native renderer quality between completed frames; rejects unsupported particle owners. */
+    setPerformanceQuality(settings: AuraPerformanceQuality): void;
     onFrame(callback: AuraFrameCallback): () => void;
     offFrame(callback: AuraFrameCallback): void;
     input(options: GameInputOptions): ReturnType<typeof createGameInput>;
@@ -3241,12 +3298,18 @@ export interface AuraApp {
      */
     advance(dt?: number): void;
     step(dt?: number): void;
+    /** Submit a native asynchronous production frame. Rejects unavailable or disposed renderers. */
+    stepAsync(dt?: number): Promise<void>;
+    /** Wait for pending submissions and release renderer resources. */
+    disposeAsync(): Promise<void>;
     diagnostics(): AuraDiagnostics;
     evidence(options?: GameRuntimeEvidenceOptions): ReturnType<typeof collectGameRuntimeEvidenceV105>;
     screenshot(): AuraScreenshot;
     dispose(): void;
 }
 export interface AuraCreateAppOptions {
+    /** Native asynchronous presentation for the automatic loop; synchronous remains the default. */
+    readonly frameMode?: "sync" | "async";
     readonly scene: AuraSceneBuilder | AuraSceneSnapshot;
     /**
      * Configuration for {@link AuraApp.physics}.
@@ -3270,6 +3333,12 @@ export interface AuraCreateAppOptions {
     readonly diagnostics?: boolean | AuraDiagnosticsOptions;
     readonly renderer?: AuraCreateAppRendererOptions;
     readonly pixelRatio?: number;
+    /**
+     * Native renderer quality applied before the first production frame. Use this
+     * when a known device/capture budget must constrain the initial render; later
+     * changes use {@link AuraApp.setPerformanceQuality} between completed frames.
+     */
+    readonly performanceQuality?: AuraPerformanceQuality;
     readonly autoStart?: boolean;
     readonly resize?: boolean;
 }
@@ -3356,6 +3425,8 @@ interface ProductionRuntimePrimitiveResource {
      * once authored texture refs resolve. Reads prefer this slot.
      */
     texturedMaterial: TexturedPBRMaterial | null;
+    /** Owns decoded bitmap and texture resources created by asynchronous upgrade. */
+    textureDisposer?: () => void;
     /** C1 upgrade lifecycle: none (no texture inputs) → pending → textured | fallback. */
     textureStatus: "none" | "pending" | "textured" | "fallback";
     /** Native texture slots bound by the upgrade (subset of baseColor/normal/metallicRoughness). */
@@ -3387,6 +3458,21 @@ interface ProductionRuntimePrimitiveResource {
     /** Coarse-to-fine mip-level bytes for the residency funding walk. */
     textureMipBytes: readonly number[];
 }
+export declare function resolveNativeBloomRadius(authoredRadius: number | undefined): number;
+/**
+ * Shadow bias is compared in normalized light-depth space. Directional maps use
+ * an orthographic projection, so their existing scene-radius/texel heuristic is
+ * world-linear. A spot map is perspective: applying that world-space value at
+ * the far end of its cone erased legitimate caster/receiver separation (Aura
+ * Clash measured 0.00147 normalized depth versus the old 0.004 constant bias),
+ * and the default slope term could erase the remainder on a vertical receiver.
+ * Keep the established directional/point policy intact and use a bounded
+ * fraction of one normalized spot-map texel for both perspective terms.
+ */
+export declare function resolveProductionRuntimeShadowTuning(kind: CollectedLight["kind"] | undefined, size: number, sceneRadius: number): {
+    readonly bias: number;
+    readonly slopeBias?: number;
+};
 /**
  * N1 caster selection (pure, unit-tested): an explicit `shadow: true`
  * request wins the single caster slot over unrequested lights; ties and
@@ -3395,6 +3481,7 @@ interface ProductionRuntimePrimitiveResource {
 export declare function resolveProductionShadowCasterIndex(descriptors: readonly {
     readonly shadowPriority: number;
     readonly shadowRequested: boolean;
+    readonly shadowDisabled?: boolean;
     readonly intensity: number;
 }[]): number;
 /**
@@ -3402,6 +3489,8 @@ export declare function resolveProductionShadowCasterIndex(descriptors: readonly
  * fetchable urls; procedural inputs have no rasterizer and are reported so
  * the caller can warn instead of silently dropping them.
  */
+declare const ROOT_EXTENSION_TEXTURE_SLOTS: readonly ["clearcoat", "clearcoatRoughness", "clearcoatNormal", "sheenColor", "sheenRoughness", "iridescence", "iridescenceThickness", "anisotropy"];
+type RootExtensionTextureSlot = typeof ROOT_EXTENSION_TEXTURE_SLOTS[number];
 export declare function createProductionPrimitiveTextureIntent(materialSpec: AuraMaterialSpec | undefined): {
     readonly baseColorUrl?: string;
     readonly normalUrl?: string;
@@ -3409,6 +3498,12 @@ export declare function createProductionPrimitiveTextureIntent(materialSpec: Aur
     readonly metalnessUrl?: string;
     readonly occlusionUrl?: string;
     readonly emissiveUrl?: string;
+    readonly extensionMaps?: Readonly<Partial<Record<RootExtensionTextureSlot, {
+        readonly url: string;
+        readonly colorSpace: "srgb" | "linear";
+        readonly texCoord: 0 | 1;
+        readonly transform?: AuraTextureTransform;
+    }>>>;
     readonly proceduralInputs: readonly string[];
 };
 /**
@@ -3417,7 +3512,7 @@ export declare function createProductionPrimitiveTextureIntent(materialSpec: Aur
  * textured, fallback, or skipped — is recorded on the resource with warnings.
  * Procedural inputs have no rasterizer: recorded + warned, never faked.
  */
-export declare function upgradeProductionPrimitiveTextures(entries: readonly ProductionRuntimePrimitiveEntry[], warn: (message: string) => void): Promise<void>;
+export declare function upgradeProductionPrimitiveTextures(entries: readonly ProductionRuntimePrimitiveEntry[], warn: (message: string) => void, maxTextureSize?: number): Promise<void>;
 /**
  * B3 post-mount HDRI upgrade (muse3jsparity-PRD). Fetches a Radiance `.hdr`
  * asset, runs the HDR→cubemap→GGX-prefilter→BRDF-LUT chain, and returns the