@zephyr3d/scene 0.9.0 → 0.9.2

package/dist/index.d.ts

@@ -243,6 +243,11 @@ declare function fetchSampler(type: SamplerType): TextureSampler<unknown> | null
  * @public
  */
 type PropertyType = string;
+/**
+ * Maps a property type discriminator to the corresponding value lane key.
+ *
+ * @public
+ */
 type PropertyToType<T extends string> = T extends 'float' | 'vec2' | 'vec3' | 'vec4' | 'int' | 'int2' | 'int3' | 'int4' | 'rgb' | 'rgba' ? 'num' : T extends 'bool' ? 'bool' : T extends 'string' ? 'str' : T extends 'object' | 'object_array' ? 'object' : 'num' | 'bool' | 'str' | 'object';
 /**
  * Container for a serializable property's value.
@@ -278,6 +283,11 @@ type PropertyValue = {
  * @public
  */
 type PropEdit = 'aabb' | 'quaternion' | 'proptrack';
+/**
+ * Extra scene-node picker hints for a property.
+ *
+ * @public
+ */
 type PropertySceneNodeOptions = {
     kind?: 'node' | 'mesh';
 };
@@ -321,6 +331,11 @@ type PropertyAccessorOptions = {
         values: unknown[];
     };
 };
+/**
+ * Returns the property accessor list unchanged while preserving typing.
+ *
+ * @public
+ */
 declare function defineProps(accessors: PropertyAccessor<any, 'DUMMY'>[]): PropertyAccessor[];
 /**
  * Descriptor for a serializable property of a class/type.
@@ -342,6 +357,8 @@ type PropertyAccessor<T = object, U extends string = ''> = {
     type: PropertyType;
     /** Unique property name (stable identifier for tooling/serialization). */
     name: string;
+    /** Description of this property */
+    description?: string;
     /**
      * Optional evaluation phase/order hint (lower runs earlier).
      * Useful for staged initialization or batched updates in editors.
@@ -513,6 +530,11 @@ type SerializableClass = {
  * @public
  */
 type ShadowMode = 'hard' | 'vsm' | 'esm' | 'pcf-pd' | 'pcf-opt';
+/**
+ * Preset shadow quality profiles.
+ *
+ * @public
+ */
 type ShadowQualityPreset = 'character-small' | 'outdoor-large';
 /**
  * The shadow map generator
@@ -1718,6 +1740,13 @@ declare class Material extends Disposable implements Clonable<Material>, IDispos
      * Base returns `null`. Subclasses that support instancing can return a lightweight instance.
      */
     createInstance(): this;
+    /**
+     * Returns the core material that owns GPU state.
+     *
+     * Instances may delegate to a shared core to reuse compiled programs and caches.
+     * @public
+     */
+    get coreMaterial(): this;
     /**
      * Prepare the material for drawing across all passes for the given draw context.
      *
@@ -2413,9 +2442,7 @@ declare class ClipmapTerrainMaterial extends ClipmapTerrainMaterial_base {
     static get MAX_DETAIL_MAP_COUNT(): number;
     get debugMode(): TerrainDebugMode;
     set debugMode(mode: TerrainDebugMode);
-    set region(val: Vector4);
     setClipmapGridInfo(gridScale: number, gridOffsetX: number, gridOffsetY: number): void;
-    set terrainScale(val: Vector3);
     get numDetailMaps(): number;
     set numDetailMaps(val: number);
     getSplatMap(): Texture2D<unknown> | Texture2DArray<unknown> | null;
@@ -3461,6 +3488,11 @@ type IMixinLight = {
  */
 declare function mixinLight<T extends typeof MeshMaterial>(BaseCls: T): T & (new (...args: any[]) => IMixinLight);
 
+/**
+ * Reflection model used by the PBR metallic-roughness material.
+ *
+ * @public
+ */
 type PBRReflectionMode = 'none' | 'ggx' | 'anisotropic' | 'glint';
 /**
  * Interface for PBRMetallicRoughness lighting model mixin
@@ -3659,9 +3691,9 @@ declare class PBRBluePrintMaterial extends PBRBluePrintMaterial_base implements
  * using UV information and an anchor point to control how the sprite
  * is positioned and textured.
  *
- * Derived classes can override {@link internalSetupUniforms},
- * {@link internalApplyUniforms} and
- * {@link calcFragmentColor} to provide custom
+ * Derived classes can override `internalSetupUniforms()`,
+ * `internalApplyUniforms()`, and
+ * `calcFragmentColor()` to provide custom
  * uniforms and shading logic (e.g. sampling a texture).
  *
  * @public
@@ -3769,9 +3801,9 @@ declare class SpriteMaterial extends MeshMaterial implements Clonable<SpriteMate
      * @remarks
      * This method:
      * - Calls the base implementation.
-     * - Invokes {@link SpriteMaterial.internalSetupUniforms} for
+     * - Invokes `internalSetupUniforms()` for
      *   fragment-stage specific uniform declarations.
-     * - Computes fragment color by calling {@link SpriteMaterial.calcFragmentColor}
+     * - Computes fragment color by calling `calcFragmentColor()`
      *   if fragment color is needed.
      * - Outputs the final fragment color via {@link MeshMaterial.outputFragmentColor}.
      *
@@ -3789,7 +3821,7 @@ declare class SpriteMaterial extends MeshMaterial implements Clonable<SpriteMate
      * for non-instanced rendering. For instanced rendering, these values
      * are expected to be provided as per-instance uniforms instead.
      *
-     * It also calls {@link SpriteMaterial.internalApplyUniforms} to allow
+     * It also calls `internalApplyUniforms()` to allow
      * derived classes to bind additional resources (e.g. textures).
      *
      * @param bindGroup - The bind group to which uniforms and resources are bound.
@@ -4507,8 +4539,6 @@ declare class SkyRenderer extends Disposable {
     /** Which type of the sky should be rendered */
     get skyType(): SkyType;
     set skyType(val: SkyType);
-    set panoramaTextureAsset(id: string);
-    set skyboxTextureSize(size: number);
     /** Baked sky texture */
     getBakedSkyTexture(ctx: DrawContext): TextureCube<unknown>;
     /**
@@ -4619,11 +4649,9 @@ declare class SkyRenderer extends Disposable {
      */
     get skyboxRotation(): Immutable<Vector3>;
     set skyboxRotation(val: Immutable<Vector3>);
-    set skyWorldMatrix(val: Immutable<Matrix4x4>);
     /** Current fog type */
     get fogType(): FogType;
     set fogType(val: FogType);
-    set aerialPerspectiveDebug(val: number);
     /**
      * Force the radiance map and irradiance map to be regenerated.
      */
@@ -6256,6 +6284,11 @@ declare class FBMWaveGenerator extends Disposable implements WaveGenerator {
     getHash(): string;
 }
 
+/**
+ * Abstract render target used to derive viewports and projection matrices.
+ *
+ * @public
+ */
 declare abstract class RenderTarget {
     abstract getVersion(): number;
     abstract calcViewport(outViewport?: Nullable<number[]>): number[];
@@ -6294,6 +6327,8 @@ type ScreenConfig = {
  *
  *  outX = inX * scaleX + offsetX
  *  outY = inY * scaleY + offsetY
+ *
+ * @public
  */
 type PointTransform = {
     scaleX: number;
@@ -6304,6 +6339,8 @@ type PointTransform = {
 /**
  * Resolution transform information derived from a {@link ScreenConfig}
  * and a concrete viewport rectangle.
+ *
+ * @public
  */
 type ResolutionTransform = {
     /**
@@ -6357,7 +6394,7 @@ declare class ScreenAdapter {
      * Creates a new {@link ScreenAdapter}.
      *
      * @param config - Optional initial screen configuration. If omitted,
-     *   a default of 1280×720 with 'cover' mode is used.
+     *   a default of `1280 x 720` with `cover` mode is used.
      */
     constructor(config?: Immutable<ScreenConfig>);
     /**
@@ -6423,7 +6460,7 @@ declare class ScreenAdapter {
      *
      * @param canvasPos - Point in canvas coordinates (CSS pixels).
      * @param viewportPosOut - Optional output vector. If provided, it will be
-     *   written into and returned; otherwise a new {@link Vector2} is allocated.
+     *   written into and returned; otherwise a new `Vector2` is allocated.
      * @returns The point in viewport-local coordinates.
      */
     canvasPosToViewport(canvasPos: Vector2, viewportPosOut?: Vector2): Vector2;
@@ -6437,7 +6474,7 @@ declare class ScreenAdapter {
      *
      * @param canvasPos - Point in canvas coordinates (CSS pixels).
      * @param logicPosOut - Optional output vector. If provided, it will be
-     *   written into and returned; otherwise a new {@link Vector2} is allocated.
+     *   written into and returned; otherwise a new `Vector2` is allocated.
      * @returns The point in logical (design resolution) coordinates.
      */
     canvasPosToLogic(canvasPos: Vector2, logicPosOut?: Vector2): Vector2;
@@ -6452,7 +6489,7 @@ declare class ScreenAdapter {
      * @param transform - Transform parameters (scale and offset).
      * @param pointIn - Input point.
      * @param pointOut - Optional output vector. If provided, it will be
-     *   written into and returned; otherwise a new {@link Vector2} is allocated.
+     *   written into and returned; otherwise a new `Vector2` is allocated.
      * @returns The transformed point.
      */
     transformPoint(transform: PointTransform, pointIn: Vector2, pointOut?: Vector2): Vector2;
@@ -6463,6 +6500,11 @@ declare class ScreenAdapter {
     private getDefaultConfig;
 }
 
+/**
+ * Render target backed by the engine screen adapter.
+ *
+ * @public
+ */
 declare class ScreenRenderTarget extends RenderTarget {
     private readonly screenAdapter;
     constructor(screenAdapter?: ScreenAdapter);
@@ -6506,9 +6548,9 @@ interface RGTextureDesc {
 /**
  * Opaque handle referencing a resource within the render graph.
  *
- * Handles are obtained from {@link RGPassBuilder.createTexture}, {@link RenderGraph.importTexture},
- * or {@link RGPassBuilder.write}. They are lightweight identifiers used to declare
- * dependencies between passes.
+ * Handles are obtained from {@link RGPassBuilder.createTexture}, {@link RGPassBuilder.createFramebuffer},
+ * {@link RenderGraph.importTexture}, or {@link RGPassBuilder.write}. They are lightweight identifiers
+ * used to declare dependencies between passes.
  *
  * @public
  */
@@ -6517,7 +6559,7 @@ declare class RGHandle {
     get name(): string;
 }
 /** @public */
-type RGResourceKind = 'transient' | 'imported';
+type RGResourceKind = 'transient' | 'imported' | 'token' | 'framebuffer';
 /**
  * Internal bookkeeping for a resource within the render graph.
  * @public
@@ -6526,12 +6568,14 @@ declare class RGResource {
     readonly id: number;
     readonly name: string;
     readonly kind: RGResourceKind;
-    readonly desc: RGTextureDesc | null;
+    readonly desc: RGTextureDesc | RGFramebufferDesc | null;
+    /** Resource ID of the physical backing resource used by imported versions. */
+    readonly physicalId: number;
     /** The pass that creates / writes this resource (null for imported until written). */
     producer: RGPass | null;
     /** Passes that read this resource. */
     readonly consumers: RGPass[];
-    constructor(id: number, name: string, kind: RGResourceKind, desc: RGTextureDesc | null);
+    constructor(id: number, name: string, kind: RGResourceKind, desc: RGTextureDesc | RGFramebufferDesc | null, physicalId?: number);
 }
 /**
  * Context passed to pass execute callbacks during graph execution.
@@ -6546,12 +6590,48 @@ interface RGExecuteContext {
      *
      * For transient resources, this returns the texture allocated by the executor.
      * For imported resources, this returns the texture registered via
-     * {@link RenderGraphExecutor.setImportedTexture}.
+     * {@link RenderGraphExecutor.setImportedTexture}. The handle must be declared
+     * by the current pass with {@link RGPassBuilder.read} or {@link RGPassBuilder.write}.
      *
      * @param handle - Handle of the resource to resolve.
      * @returns The resolved texture object (type depends on the allocator).
      */
     getTexture<TTexture = unknown>(handle: RGHandle): TTexture;
+    /**
+     * Resolve a framebuffer handle to the actual backend framebuffer object.
+     *
+     * The handle must be declared by the current pass with {@link RGPassBuilder.read}
+     * or created by the same pass with {@link RGPassBuilder.createFramebuffer}.
+     *
+     * @param handle - Handle returned from {@link RGPassBuilder.createFramebuffer}.
+     * @returns The resolved framebuffer object (type depends on the allocator).
+     */
+    getFramebuffer<TFramebuffer = unknown>(handle: RGHandle): TFramebuffer;
+    /**
+     * Create a temporary framebuffer managed by the graph executor.
+     *
+     * The framebuffer is released automatically when graph execution finishes or
+     * aborts. Attachments may be actual backend resources or texture formats,
+     * depending on the allocator implementation. If an attachment is an
+     * {@link RGHandle}, the current pass must declare it with
+     * {@link RGPassBuilder.read} or {@link RGPassBuilder.write}.
+     *
+     * @param desc - Framebuffer descriptor.
+     * @returns The allocated framebuffer object (type depends on the allocator).
+     */
+    createFramebuffer<TFramebuffer = unknown>(desc: RGFramebufferDesc): TFramebuffer;
+    /**
+     * Register a cleanup callback to run when graph execution finishes or aborts.
+     *
+     * Callbacks run in reverse registration order. Use this for temporary objects
+     * created inside pass execution that are not graph resources, such as pooled
+     * framebuffers wrapping graph-managed textures. If pass execution throws, the
+     * executor still runs cleanup callbacks and preserves the original pass error
+     * ahead of cleanup errors.
+     *
+     * @param callback - Cleanup function to invoke after execution.
+     */
+    deferCleanup(callback: () => void): void;
 }
 /**
  * Execute callback signature.
@@ -6562,6 +6642,20 @@ interface RGExecuteContext {
  * @public
  */
 type RGExecuteFn<T = void> = (ctx: RGExecuteContext, data: T) => void;
+/**
+ * Ordered execution step inside a render graph pass.
+ *
+ * Subpasses share the parent pass's resource declarations, lifetime, culling,
+ * and access validation. They are intended to make multi-step pass bodies
+ * explicit without splitting graph-level resource dependencies.
+ *
+ * @public
+ */
+declare class RGSubpass<T = unknown> {
+    readonly name: string;
+    readonly executeFn: RGExecuteFn<T>;
+    constructor(name: string, executeFn: RGExecuteFn<T>);
+}
 /**
  * Internal bookkeeping for a pass within the render graph.
  * @public
@@ -6573,12 +6667,16 @@ declare class RGPass<T = unknown> {
     readonly reads: RGResource[];
     /** Resources this pass creates or writes. */
     readonly writes: RGResource[];
+    /** Passes that must complete before this pass due to non-resource hazards. */
+    readonly dependencies: RGPass[];
     /** Whether this pass has side effects and must not be culled. */
     hasSideEffect: boolean;
     /** User data returned from the setup function. */
     data: T | null;
     /** Execute callback. */
     executeFn: RGExecuteFn<T> | null;
+    /** Ordered subpasses for passes with multiple logical execution steps. */
+    readonly subpasses: RGSubpass<T>[];
     /** Set during compilation: true if this pass is needed. */
     alive: boolean;
     constructor(index: number, name: string);
@@ -6599,11 +6697,19 @@ interface RGPassBuilder {
      */
     read(handle: RGHandle): void;
     /**
-     * Declare that this pass writes to an existing resource (typically an imported resource).
+     * Declare that this pass writes a new version of an existing resource.
+     *
+     * The returned handle represents the post-write version. Use it for subsequent
+     * reads and as the graph output passed to {@link RenderGraph.compile}. Passing
+     * an older version of the same resource to `compile()` is rejected because it
+     * usually means the caller ignored the handle returned by `write()`. If the pass
+     * needs the previous contents, call {@link RGPassBuilder.read} on the input handle explicitly
+     * before writing.
      *
      * @param handle - Handle of the resource to write to.
+     * @returns A handle referencing the newly written version.
      */
-    write(handle: RGHandle): void;
+    write(handle: RGHandle): RGHandle;
     /**
      * Create a new transient texture resource that this pass will produce.
      *
@@ -6611,6 +6717,27 @@ interface RGPassBuilder {
      * @returns A handle referencing the newly created resource.
      */
     createTexture(desc: RGTextureDesc): RGHandle;
+    /**
+     * Create a logical dependency token produced by this pass.
+     *
+     * Tokens do not resolve to GPU resources and are not allocated by the executor.
+     * They are useful for ordering passes whose dependencies are side effects rather
+     * than texture reads/writes.
+     *
+     * @param name - Debug label for this token.
+     * @returns A handle referencing the newly created token.
+     */
+    createToken(name?: string): RGHandle;
+    /**
+     * Create a graph-managed framebuffer view.
+     *
+     * The graph compiler infers dependencies from any attachment handles in the
+     * descriptor. The executor creates and releases the framebuffer automatically.
+     *
+     * @param desc - Framebuffer descriptor.
+     * @returns A handle referencing the framebuffer view.
+     */
+    createFramebuffer(desc: RGFramebufferDesc): RGHandle;
     /**
      * Mark this pass as having side effects.
      *
@@ -6619,9 +6746,22 @@ interface RGPassBuilder {
      * debug overlays, etc.
      */
     sideEffect(): void;
+    /**
+     * Add an ordered logical subpass to this pass.
+     *
+     * Subpasses execute in registration order and share the parent pass's declared
+     * reads, writes, framebuffer views, and user data. A pass may use either
+     * subpasses or {@link RGPassBuilder.setExecute}, but not both.
+     *
+     * @param name - Debug label for the subpass.
+     * @param fn - Callback invoked when this subpass executes.
+     */
+    addSubpass<D>(name: string, fn: RGExecuteFn<D>): void;
     /**
      * Set the execution callback for this pass.
      *
+     * A pass may use either this method or {@link RGPassBuilder.addSubpass}, but not both.
+     *
      * @param fn - Callback invoked during graph execution.
      */
     setExecute<D>(fn: RGExecuteFn<D>): void;
@@ -6661,17 +6801,50 @@ interface RGResolvedSize {
     width: number;
     height: number;
 }
+/**
+ * Descriptor for a framebuffer view managed by the graph or created temporarily during pass execution.
+ *
+ * This is intentionally backend-agnostic: graph-managed descriptors may use
+ * {@link RGHandle} attachments, and executor-created descriptors use resolved
+ * resources or texture formats understood by the allocator.
+ *
+ * @public
+ */
+interface RGFramebufferDesc {
+    /** Debug label for this framebuffer. */
+    label?: string;
+    /** Framebuffer width. Required when attachments are formats. */
+    width?: number;
+    /** Framebuffer height. Required when attachments are formats. */
+    height?: number;
+    /** Color attachments or formats. */
+    colorAttachments: unknown | unknown[] | null;
+    /** Depth/stencil attachment or format. */
+    depthAttachment?: unknown | null;
+    /** Whether color attachments created from formats should support mipmapping. */
+    mipmapping?: boolean;
+    /** Framebuffer sample count. */
+    sampleCount?: number;
+    /** Whether to ignore depth/stencil during MSAA resolve. */
+    ignoreDepthStencil?: boolean;
+    /** Attachment mip level. */
+    attachmentMipLevel?: number;
+    /** Attachment cubemap face. */
+    attachmentCubeface?: number;
+    /** Attachment array layer. */
+    attachmentLayer?: number;
+}
 /**
  * Interface for allocating and releasing transient textures.
  *
  * Implement this to bridge the render graph with your GPU device's resource pool.
- * The executor calls {@link allocate} before a resource's first use and
- * {@link release} after its last use.
+ * The executor calls `allocate()` before a resource's first use and
+ * `release()` after its last use.
  *
  * @typeParam TTexture - The concrete texture type (e.g. `Texture2D`).
  * @public
  */
-interface RGTextureAllocator<TTexture = unknown> {
+interface RGTextureAllocator<TTexture = unknown, TFramebuffer = unknown> {
     /**
      * Allocate a transient texture matching the given descriptor and resolved size.
      *
@@ -6686,6 +6859,22 @@ interface RGTextureAllocator<TTexture = unknown> {
      * @param texture - The texture to release.
      */
     release(texture: TTexture): void;
+    /**
+     * Allocate a temporary framebuffer matching the given descriptor.
+     *
+     * Implementations should not auto-release this framebuffer; the graph executor
+     * calls {@link RGTextureAllocator.releaseFramebuffer} when execution completes or aborts.
+     *
+     * @param desc - Framebuffer descriptor.
+     * @returns The allocated framebuffer object.
+     */
+    allocateFramebuffer?(desc: RGFramebufferDesc): TFramebuffer;
+    /**
+     * Release a previously allocated temporary framebuffer.
+     *
+     * @param framebuffer - The framebuffer to release.
+     */
+    releaseFramebuffer?(framebuffer: TFramebuffer): void;
 }
 
 /**
@@ -6694,7 +6883,7 @@ interface RGTextureAllocator<TTexture = unknown> {
  * Usage:
  * ```ts
  * const graph = new RenderGraph();
- * const backbuffer = graph.importTexture('backbuffer');
+ * let backbuffer = graph.importTexture('backbuffer');
  *
  * let linearDepth: RGHandle;
  * graph.addPass('DepthPrepass', (builder) => {
@@ -6704,7 +6893,7 @@ interface RGTextureAllocator<TTexture = unknown> {
  *
  * graph.addPass('LightPass', (builder) => {
  *   builder.read(linearDepth);
- *   builder.write(backbuffer);
+ *   backbuffer = builder.write(backbuffer);
  *   builder.setExecute(() => { ... });
  * });
  *
@@ -6743,6 +6932,8 @@ declare class RenderGraph {
      * Performs dead-pass culling, topological sorting, and resource lifetime analysis.
      *
      * @param outputs - Handles of resources that must be produced (graph sinks).
+     *   If a resource was passed to {@link RGPassBuilder.write}, use the returned
+     *   post-write handle here, not the original handle.
      *   Passes that do not contribute to these outputs (directly or transitively)
      *   are culled, unless marked as side-effect passes.
      * @returns The compiled graph ready for execution.
@@ -6753,7 +6944,7 @@ declare class RenderGraph {
      *
      * For automatic resource allocation/release, use {@link RenderGraphExecutor} instead.
      *
-     * @param compiled - The compiled graph from {@link compile}.
+     * @param compiled - The compiled graph from {@link RenderGraph.compile}.
      */
     execute(compiled: CompiledRenderGraph): void;
     /**
@@ -6781,8 +6972,8 @@ declare class RenderGraph {
  * @typeParam TTexture - The concrete texture type (e.g. `Texture2D`).
  * @public
  */
-declare class RenderGraphExecutor<TTexture = unknown> {
-    constructor(allocator: RGTextureAllocator<TTexture>, backbufferWidth: number, backbufferHeight: number);
+declare class RenderGraphExecutor<TTexture = unknown, TFramebuffer = unknown> {
+    constructor(allocator: RGTextureAllocator<TTexture, TFramebuffer>, backbufferWidth: number, backbufferHeight: number);
     /**
      * Update the backbuffer dimensions used for 'backbuffer-relative' sizing.
      */
@@ -6816,8 +7007,8 @@ declare class RenderGraphExecutor<TTexture = unknown> {
  * Bridges the render graph's {@link RGTextureAllocator} interface to the
  * engine's device resource pool (`device.pool`).
  *
- * Transient textures are fetched from the pool on {@link allocate} and
- * returned to the pool on {@link release}, enabling automatic reuse
+ * Transient textures are fetched from the pool on `allocate()` and
+ * returned to the pool on `release()`, enabling automatic reuse
  * across frames without manual lifecycle management.
  *
  * Usage:
@@ -6828,7 +7019,7 @@ declare class RenderGraphExecutor<TTexture = unknown> {
  *
  * @public
  */
-declare class DevicePoolAllocator implements RGTextureAllocator<Texture2D> {
+declare class DevicePoolAllocator implements RGTextureAllocator<Texture2D, FrameBuffer> {
     /**
      * Allocate a transient texture from the device pool.
      *
@@ -6843,32 +7034,38 @@ declare class DevicePoolAllocator implements RGTextureAllocator<Texture2D> {
      * @param texture - The texture to release.
      */
     release(texture: Texture2D): void;
+    /**
+     * Allocate a temporary framebuffer from the device pool.
+     *
+     * @param desc - Framebuffer descriptor from the render graph pass.
+     * @returns A pooled FrameBuffer instance.
+     */
+    allocateFramebuffer(desc: RGFramebufferDesc): FrameBuffer;
+    /**
+     * Release a temporary framebuffer back to the device pool.
+     *
+     * @param framebuffer - The framebuffer to release.
+     */
+    releaseFramebuffer(framebuffer: FrameBuffer): void;
 }
 
 /**
- * Manages cross-frame history resources with automatic ping-pong buffering.
+ * Manages cross-frame history resources that can be imported into a render graph.
  *
  * History resources are textures that persist across frames for temporal effects
- * like TAA, motion blur, or temporal upscaling. The manager maintains two copies
- * of each resource and automatically swaps them at frame boundaries.
+ * like TAA, motion blur, or temporal upscaling. Previous-frame textures can be
+ * imported into a {@link RenderGraph}, and current-frame textures are committed
+ * only after graph execution succeeds.
  *
  * Usage:
  * ```ts
  * const historyMgr = new HistoryResourceManager(allocator);
- *
- * // Register a history resource (typically once at initialization)
- * historyMgr.register('taaHistory', {
- *   format: TextureFormat.RGBA16F,
- *   width: 1920,
- *   height: 1080
- * }, { width: 1920, height: 1080 });
- *
- * // In your render pass:
- * const prevFrame = historyMgr.getPrevious('taaHistory');  // Read from previous frame
- * const currentFrame = historyMgr.getCurrent('taaHistory'); // Write to current frame
- *
- * // At frame end:
- * historyMgr.swap();  // Swap current and previous
+ * historyMgr.beginFrame();
+ * const prev = historyMgr.importPrevious(graph, 'taaColor');
+ * // declare builder.read(prev) if non-null
+ * historyMgr.bindImportedTextures(executor);
+ * // after successful execution:
+ * historyMgr.commitFrame();
  * ```
  *
  * @typeParam TTexture - The concrete texture type (e.g. `Texture2D`).
@@ -6877,7 +7074,9 @@ declare class DevicePoolAllocator implements RGTextureAllocator<Texture2D> {
 declare class HistoryResourceManager<TTexture = Texture2D> {
     private _resources;
     private _allocator;
-    private _frameIndex;
+    private _pendingImports;
+    private _pendingCommits;
+    private _readScopeStack;
     /**
      * Create a new history resource manager.
      *
@@ -6885,91 +7084,111 @@ declare class HistoryResourceManager<TTexture = Texture2D> {
      */
     constructor(allocator: RGTextureAllocator<TTexture>);
     /**
-     * Register a new history resource with ping-pong buffering.
+     * Get the previous-frame texture resolved by the current render graph pass.
      *
-     * Allocates two textures matching the given descriptor. If a resource
-     * with the same name already exists, this is a no-op.
+     * The resource must have been imported with {@link HistoryResourceManager.importPrevious} or
+     * {@link HistoryResourceManager.importPreviousIfCompatible}, declared as a pass read, and bound with
+     * {@link HistoryResourceManager.beginReadScope} before this method is called.
      *
-     * @param name - Unique identifier for this history resource.
-     * @param desc - Texture descriptor (format, size, etc.).
-     * @param size - Resolved pixel dimensions.
+     * @param name - Name of the history resource.
+     * @returns The graph-resolved previous-frame texture.
+     * @throws If no read scope is active for the resource.
      */
-    register(name: string, desc: RGTextureDesc, size: RGResolvedSize): void;
+    getPrevious(name: string): TTexture;
     /**
-     * Register a new history resource with an existing texture (zero-copy).
+     * Check whether a valid history resource exists and matches the descriptor.
      *
-     * This is more efficient than register() + updateCurrent() for first-frame setup,
-     * as it avoids allocating dummy textures that are immediately replaced.
-     *
-     * @param name - Unique identifier for this history resource.
-     * @param desc - Texture descriptor (format, size, etc.).
-     * @param size - Resolved pixel dimensions.
-     * @param initialTexture - The initial texture to use as current frame.
+     * @param name - Name of the history resource.
+     * @param desc - Expected texture descriptor.
+     * @param size - Expected resolved size.
+     * @returns True if the resource exists, is valid, and matches.
      */
-    registerWithTexture(name: string, desc: RGTextureDesc, size: RGResolvedSize, initialTexture: TTexture): void;
+    isCompatible(name: string, desc: RGTextureDesc, size: RGResolvedSize): boolean;
     /**
-     * Get the current frame's texture for a history resource.
-     *
-     * This is typically used as the write target in render passes.
-     *
-     * @param name - Name of the history resource.
-     * @returns The current frame's texture.
-     * @throws If the resource has not been registered.
+     * Start collecting graph imports and deferred commits for a new frame.
      */
-    getCurrent(name: string): TTexture;
+    beginFrame(): void;
     /**
-     * Get the previous frame's texture for a history resource.
+     * Import the latest committed texture for a history resource into the graph.
      *
-     * This is typically used as a read input in temporal effects like TAA.
+     * Returns null when the resource has no valid previous frame.
      *
-     * @param name - Name of the history resource.
-     * @returns The previous frame's texture.
-     * @throws If the resource has not been registered.
+     * @param graph - Render graph to import into.
+     * @param name - History resource name.
+     * @returns Imported graph handle, or null when no valid previous texture exists.
      */
-    getPrevious(name: string): TTexture;
+    importPrevious(graph: RenderGraph, name: string): RGHandle | null;
     /**
-     * Check if a history resource exists.
+     * Import the latest committed texture only when it matches the expected shape.
      *
-     * @param name - Name of the history resource.
-     * @returns True if the resource has been registered.
+     * This is the preferred API for effects that can declare their history reads
+     * while building the graph: incompatible history is treated as absent, so the
+     * pass does not declare stale reads after resize or format changes.
+     *
+     * @param graph - Render graph to import into.
+     * @param name - History resource name.
+     * @param desc - Expected texture descriptor.
+     * @param size - Expected resolved size.
+     * @returns Imported graph handle, or null when no compatible history exists.
      */
-    has(name: string): boolean;
+    importPreviousIfCompatible(graph: RenderGraph, name: string, desc: RGTextureDesc, size: RGResolvedSize): RGHandle | null;
     /**
-     * Unregister a history resource and release its textures.
+     * Bind all history imports created for this frame to the executor.
      *
-     * @param name - Name of the history resource to remove.
-     * @returns True if the resource was found and removed.
+     * @param executor - Render graph executor for the current frame.
      */
-    unregister(name: string): boolean;
+    bindImportedTextures(executor: Pick<RenderGraphExecutor<TTexture>, 'setImportedTexture'>): void;
     /**
-     * Swap current and previous textures for all history resources.
+     * Make resolved history textures available to code executing inside a pass.
      *
-     * Call this at the end of each frame to advance the ping-pong buffers.
-     * After swapping, what was "current" becomes "previous" for the next frame.
+     * @param bindings - History name to resolved texture bindings.
      */
-    swap(): void;
+    beginReadScope(bindings: Array<{
+        name: string;
+        texture: TTexture;
+    }>): void;
     /**
-     * Release all history resources and clear the manager.
-     *
-     * Call this when disposing the render context or when history is no longer needed.
+     * End the most recent history read scope.
      */
-    dispose(): void;
+    endReadScope(): void;
     /**
-     * Update the current frame's texture with an external texture (for zero-copy workflows).
+     * Queue a current-frame texture to become the next previous-frame history.
      *
-     * This is useful when you want to use the output of a render pass directly as history,
-     * without copying. The manager will release the old texture and use the new one.
+     * The texture is committed only when {@link HistoryResourceManager.commitFrame} is called. If the
+     * frame fails, {@link HistoryResourceManager.discardFrame} releases owned pending textures instead.
      *
-     * @param name - Name of the history resource.
-     * @param texture - The new texture to use as current frame.
+     * @param name - History resource name.
+     * @param desc - Texture descriptor.
+     * @param size - Resolved texture size.
+     * @param texture - Texture produced by the current frame.
+     * @param ownsTexture - Whether this manager should release the texture later.
      */
-    updateCurrent(name: string, texture: TTexture): void;
+    queueCommit(name: string, desc: RGTextureDesc, size: RGResolvedSize, texture: TTexture, ownsTexture?: boolean): void;
     /**
-     * Get the number of registered history resources.
+     * Commit all current-frame history writes.
      */
-    get size(): number;
+    commitFrame(): void;
+    /**
+     * Discard all uncommitted frame history writes.
+     */
+    discardFrame(): void;
+    /**
+     * Release all history resources and clear the manager.
+     *
+     * Call this when disposing the render context or when history is no longer needed.
+     */
+    dispose(): void;
 }
 
+/**
+ * Resource names for render graph history resources.
+ * @public
+ */
+declare const RGHistoryResources: {
+    readonly TAA_COLOR: "taaColor";
+    readonly TAA_MOTION_VECTOR: "taaMotionVector";
+};
+
 /**
  * Options controlling which features are enabled in the forward+ pipeline.
  *
@@ -6998,7 +7217,7 @@ interface ForwardPlusOptions {
  *
  * Each step in the existing `SceneRenderer._renderScene` becomes a graph pass.
  * Execute callbacks delegate to the existing rendering code, sharing a mutable
- * {@link FrameState}.
+ * `FrameState`.
  *
  * @param graph - The render graph to populate.
  * @param ctx - The draw context for this frame.
@@ -7716,7 +7935,7 @@ declare class Camera extends SceneNode {
     /** Whether to allow command buffer reuse optimization */
     get commandBufferReuse(): boolean;
     set commandBufferReuse(val: boolean);
-    /** Whether this camera is adapted to screen settins */
+    /** Whether this camera is adapted to screen settings */
     get adapted(): boolean;
     set adapted(val: boolean);
     /** OIT */
@@ -8203,6 +8422,11 @@ type PickTarget = {
     node: SceneNode;
     label?: string;
 };
+/**
+ * Minimal render context carrying target size and device information.
+ *
+ * @public
+ */
 declare class RenderContext {
     device: AbstractDevice;
     renderWidth: number;
@@ -8420,7 +8644,6 @@ declare class GraphNode extends SceneNode {
      * @param scene - The scene to which the node belongs
      */
     constructor(scene: Scene);
-    set octreeNode(node: Nullable<OctreeNode>);
     /** Gets the name */
     getName(): string;
     /**
@@ -8475,17 +8698,11 @@ declare abstract class SkeletonModifier {
      * Get the blend weight [0-1]
      */
     get weight(): number;
-    /**
-     * Set the blend weight [0-1]
-     */
     set weight(value: number);
     /**
      * Get whether this processor is enabled
      */
     get enabled(): boolean;
-    /**
-     * Set whether this processor is enabled
-     */
     set enabled(value: boolean);
     /**
      * Apply post-processing to skeleton joints.
@@ -8651,7 +8868,9 @@ declare class Skeleton extends Disposable {
     get humanoidJointMapping(): Nullable<HumanoidJointMapping<SceneNode>>;
     /** Root rotation of humanoid hips bone */
     get humanoidRootRotation(): Quaternion;
+    get playing(): boolean;
     set playing(b: boolean);
+    get persistentId(): string;
     set persistentId(val: string);
     /**
      * Texture containing joint matrices for GPU skinning.
@@ -8981,6 +9200,8 @@ declare class AnimationSet extends Disposable implements IDisposable {
      * @param excludeJoint - Optional predicate; joints whose name returns true are excluded from
      *   skeleton structure matching.
      * @returns The newly created AnimationClip, or null on failure.
+     *
+     * @deprecated Use the new {@link AnimationSet.copyHumanoidAnimationFrom} method instead.
      */
     copyAnimationFrom(sourceSet: AnimationSet, animationName: string, targetName?: string, excludeJoint?: (jointName: string) => boolean): AnimationClip | null;
     /**
@@ -9483,29 +9704,71 @@ declare class MorphTargetTrack extends AnimationTrack<MorphState> {
     reset(node: SceneNode): void;
 }
 
+/**
+ * Geometry cache frame data for a single sampled time.
+ *
+ * @public
+ */
 type GeometryCacheFrame = {
     positions: Float32Array;
     normals?: Nullable<Float32Array>;
     boundingBox: BoundingBox;
 };
+/**
+ * Mutable working state used while evaluating geometry cache tracks.
+ *
+ * @public
+ */
 type GeometryCacheState = {
     positions: Float32Array;
     normals?: Nullable<Float32Array>;
     boundingBox: BoundingBox;
 };
+/**
+ * GPU resources bound to a mesh while a geometry cache track is active.
+ *
+ * @public
+ */
 type GeometryCacheMeshBinding = {
     originalPrimitive: Primitive;
     primitive: Primitive;
     positionBuffer: StructuredBuffer;
     normalBuffer: Nullable<StructuredBuffer>;
 };
+/**
+ * Creates a reusable geometry cache state buffer for a frame layout.
+ *
+ * @public
+ */
 declare function createGeometryCacheState(frame: Pick<GeometryCacheFrame, 'positions' | 'normals'>): GeometryCacheState;
+/**
+ * Linearly interpolates two geometry-cache bounding boxes.
+ *
+ * @public
+ */
 declare function mixGeometryCacheBoundingBox(a: BoundingBox, b: BoundingBox, t: number): BoundingBox;
+/**
+ * Ensures the target mesh has GPU buffers compatible with the geometry cache state.
+ *
+ * @public
+ */
 declare function ensureGeometryCacheMeshBinding(meshBindings: WeakMap<Mesh, GeometryCacheMeshBinding>, mesh: Mesh, state: GeometryCacheState, errorPrefix: string): GeometryCacheMeshBinding;
+/**
+ * Restores a mesh primitive after geometry cache playback.
+ *
+ * @public
+ */
 declare function restoreGeometryCacheMeshBinding(mesh: Mesh): Promise<boolean>;
 
+/** @public */
 type FixedGeometryCacheFrame = GeometryCacheFrame;
+/** @public */
 type FixedGeometryCacheState = GeometryCacheState;
+/**
+ * Geometry cache track backed by explicit per-frame vertex data.
+ *
+ * @public
+ */
 declare class FixedGeometryCacheTrack extends AnimationTrack<FixedGeometryCacheState> {
     private _times;
     private _frames;
@@ -9531,6 +9794,11 @@ declare class FixedGeometryCacheTrack extends AnimationTrack<FixedGeometryCacheS
     private ensureMeshBinding;
 }
 
+/**
+ * PCA-compressed geometry cache animation data.
+ *
+ * @public
+ */
 type PCAGeometryCacheTrackData = {
     times: Float32Array;
     bounds: [number, number, number, number, number, number][];
@@ -9542,7 +9810,13 @@ type PCAGeometryCacheTrackData = {
     normalBases?: Nullable<Float32Array[]>;
     normalCoefficients?: Nullable<Float32Array[]>;
 };
+/** @public */
 type PCAGeometryCacheState = GeometryCacheState;
+/**
+ * Geometry cache track reconstructed from PCA bases and coefficients.
+ *
+ * @public
+ */
 declare class PCAGeometryCacheTrack extends AnimationTrack<PCAGeometryCacheState> {
     private _times;
     private _bounds;
@@ -10137,8 +10411,8 @@ interface SpringSystemOptions {
      */
     poseFollowTip?: number;
     /**
-     * Exponent used when interpolating root->tip follow.
-     * 1 = linear, >1 keeps root stiffer and tip looser.
+     * Exponent used when interpolating root-to-tip follow.
+     * `1` is linear; values `\> 1` keep the root stiffer and the tip looser.
      */
     poseFollowExponent?: number;
     /**
@@ -10225,14 +10499,6 @@ declare class SpringSystem {
      * Solves a single spring constraint using XPBD (Extended Position-Based Dynamics).
      *
      * Reference: Müller et al., "Detailed Rigid Body Simulation with Extended Position Based Dynamics", 2020.
-     *
-     * The XPBD correction for a distance constraint C(x) = |x_b - x_a| - L is:
-     *   α̃ = compliance / dt²          (scaled compliance)
-     *   Δλ = (-C - α̃·λ) / (w_a + w_b + α̃)
-     *   λ  += Δλ
-     *   Δx_a = -w_a · Δλ · n̂
-     *   Δx_b = +w_b · Δλ · n̂
-     * where w = 1/mass (0 for fixed particles), n̂ = unit vector from a to b.
      */
     private solveConstraintXPBD;
     /**
@@ -10285,74 +10551,46 @@ declare class SpringSystem {
      * Gets the Coriolis force scale
      */
     get coriolisScale(): number;
-    /**
-     * Sets the Coriolis force scale
-     */
     set coriolisScale(scale: number);
     /**
      * Gets the constraint solver type
      */
     get solver(): 'verlet' | 'xpbd';
-    /**
-     * Sets the constraint solver type.
-     * Switching to 'xpbd' resets all Lagrange multipliers.
-     */
     set solver(type: 'verlet' | 'xpbd');
     /**
      * Gets pose preservation strength [0-1]
      */
     get poseFollow(): number;
-    /**
-     * Sets pose preservation strength [0-1]
-     */
     set poseFollow(value: number);
     /**
      * Gets max allowed deviation from animated pose
      */
     get maxPoseOffset(): number;
-    /**
-     * Sets max allowed deviation from animated pose. 0 disables clamping.
-     */
     set maxPoseOffset(value: number);
     /**
      * Gets root pose follow strength [0-1]
      */
     get poseFollowRoot(): number;
-    /**
-     * Sets root pose follow strength [0-1]
-     */
     set poseFollowRoot(value: number);
     /**
      * Gets tip pose follow strength [0-1]
      */
     get poseFollowTip(): number;
-    /**
-     * Sets tip pose follow strength [0-1]
-     */
     set poseFollowTip(value: number);
     /**
-     * Gets exponent for root->tip interpolation
+     * Gets exponent for root-to-tip interpolation
      */
     get poseFollowExponent(): number;
-    /**
-     * Sets exponent for root->tip interpolation
-     */
     set poseFollowExponent(value: number);
     /**
      * Gets root max allowed deviation from animated pose
      */
     get maxPoseOffsetRoot(): number;
-    /**
-     * Sets root max allowed deviation from animated pose
-     */
     set maxPoseOffsetRoot(value: number);
     /**
      * Gets tip max allowed deviation from animated pose
      */
     get maxPoseOffsetTip(): number;
-    /**
-     * Sets tip max allowed deviation from animated pose
-     */
     set maxPoseOffsetTip(value: number);
     /**
      * Adds a collider to the system
@@ -10626,17 +10864,11 @@ declare class TwoBoneIKSolver extends IKSolver {
      * Get the pole vector position.
      */
     get poleVector(): Vector3 | null;
-    /**
-     * Set the pole vector position.
-     */
     set poleVector(value: Vector3 | null);
     /**
      * Get the pole vector weight.
      */
     get poleWeight(): number;
-    /**
-     * Set the pole vector weight (0-1).
-     */
     set poleWeight(value: number);
     /**
      * Solve the IK chain to reach the target position using Two Bone IK algorithm.
@@ -10845,17 +11077,11 @@ declare class IKAngleConstraint extends IKConstraint {
      * Get the minimum angle in degrees.
      */
     get minAngle(): number;
-    /**
-     * Set the minimum angle in degrees.
-     */
     set minAngle(value: number);
     /**
      * Get the maximum angle in degrees.
      */
     get maxAngle(): number;
-    /**
-     * Set the maximum angle in degrees.
-     */
     set maxAngle(value: number);
     /**
      * Apply the angle constraint to limit joint bending.
@@ -11039,6 +11265,11 @@ declare class MultiChainSpringSystem {
     set solver(type: 'verlet' | 'xpbd');
 }
 
+/**
+ * Options used to construct a GPU cloth simulation system.
+ *
+ * @public
+ */
 type GPUClothSystemOptions = {
     enabled?: boolean;
     device?: Nullable<AbstractDevice>;
@@ -11066,6 +11297,11 @@ type GPUClothSystemOptions = {
     scene?: Nullable<Scene>;
     autoUpdate?: boolean;
 };
+/**
+ * Serialized wrap-binding cache data for GPU cloth attachments.
+ *
+ * @public
+ */
 type GPUClothWrapBindingData = {
     version: 4;
     vertexCount: number;
@@ -11076,6 +11312,11 @@ type GPUClothWrapBindingData = {
     sourceBarycentrics: string;
     targetLocalOffsets: string;
 };
+/**
+ * Target object paired with GPU cloth wrap-binding data.
+ *
+ * @public
+ */
 type GPUClothWrapBindingTarget = {
     target: any;
     data: GPUClothWrapBindingData;
@@ -11084,13 +11325,22 @@ type GPUClothWrapBindingTarget = {
  * Returns whether GPU cloth is supported on the given device.
  *
  * GPU cloth in this engine is WebGPU-only. WebGL backends are explicitly unsupported.
+ *
+ * @public
  */
 declare function isGPUClothSupported(device?: Nullable<AbstractDevice>): boolean;
+/**
+ * Creates wrap-binding cache data between a source cloth mesh and a target mesh.
+ *
+ * @public
+ */
 declare function createGPUClothWrapBindingData(source: any, target: any): Promise<GPUClothWrapBindingData>;
 /**
  * WebGPU-only cloth simulation entry.
  *
  * On non-WebGPU backends (including WebGL), the system is always disabled.
+ *
+ * @public
  */
 declare class GPUClothSystem {
     private _enabled;
@@ -11226,8 +11476,18 @@ declare class GPUClothSystem {
     private restoreTargetSkinning;
 }
 
+/**
+ * Numerical tolerance used by the joint dynamics solver.
+ *
+ * @public
+ */
 declare const EPSILON = 0.001;
 /** Constraint topology type */
+/**
+ * Constraint topology type.
+ *
+ * @public
+ */
 declare const enum ConstraintType {
     /** Parent-child bone pairs along vertical chains */
     Structural_Vertical = 0,
@@ -11241,6 +11501,11 @@ declare const enum ConstraintType {
     Bending_Horizontal = 4
 }
 /** Collider surface force direction (used for surface/triangle collision) */
+/**
+ * Collider surface force direction used for surface and triangle collision.
+ *
+ * @public
+ */
 declare const enum ColliderForce {
     /** No surface force */
     Off = 0,
@@ -11254,6 +11519,11 @@ declare const enum ColliderForce {
  * Set once at initialization, immutable during simulation.
  * Constraint scale values are pre-multiplied by 0.5 (summed between two points in solver).
  */
+/**
+ * Read-only per-point physics parameters.
+ *
+ * @public
+ */
 interface PointR {
     /** Index of parent point in the hierarchy (-1 = root, no parent) */
     parent: number;
@@ -11326,6 +11596,11 @@ interface PointR {
  * Mutable per-point simulation state.
  * Updated every substep during simulation.
  */
+/**
+ * Mutable per-point simulation state.
+ *
+ * @public
+ */
 interface PointRW {
     /** Final output position to write back to the transform */
     positionToTransform: Vector3;
@@ -11349,6 +11624,11 @@ interface PointRW {
     friction: number;
 }
 /** Distance constraint between two points */
+/**
+ * Distance constraint between two points.
+ *
+ * @public
+ */
 interface Constraint {
     /** Whether collision detection runs for this constraint's bone pair (0 or 1) */
     isCollision: number;
@@ -11362,12 +11642,17 @@ interface Constraint {
     length: number;
 }
 /** Read-only collider shape parameters (set at init) */
+/**
+ * Read-only collider shape parameters.
+ *
+ * @public
+ */
 interface ColliderR {
     /** Base radius of the collider sphere (or capsule head) */
     radius: number;
     /** Scale factor for capsule tail radius relative to head (1.0 = uniform) */
     radiusTailScale: number;
-    /** Capsule height. 0 = sphere collider, >0 = capsule collider */
+    /** Capsule height. `0` means a sphere collider; `\> 0` means a capsule collider. */
     height: number;
     /** Friction coefficient applied on collision contact */
     friction: number;
@@ -11377,6 +11662,11 @@ interface ColliderR {
     forceType: ColliderForce;
 }
 /** Mutable collider runtime state (updated each frame) */
+/**
+ * Mutable collider runtime state.
+ *
+ * @public
+ */
 interface ColliderRW {
     /** Current interpolated head position (for this substep) */
     positionCurrent: Vector3;
@@ -11408,6 +11698,11 @@ interface ColliderRW {
     enabled: number;
 }
 /** Read-only grabber parameters (set at init) */
+/**
+ * Read-only grabber parameters.
+ *
+ * @public
+ */
 interface GrabberR {
     /** Grab activation radius — points within this distance can be grabbed */
     radius: number;
@@ -11415,6 +11710,11 @@ interface GrabberR {
     force: number;
 }
 /** Mutable grabber runtime state (updated each frame) */
+/**
+ * Mutable grabber runtime state.
+ *
+ * @public
+ */
 interface GrabberRW {
     /** Whether this grabber is active (0 = disabled, 1 = enabled) */
     enabled: number;
@@ -11422,6 +11722,11 @@ interface GrabberRW {
     position: Vector3;
 }
 /** Angle limiting configuration for post-simulation bone angle clamping */
+/**
+ * Angle limiting configuration for post-simulation bone angle clamping.
+ *
+ * @public
+ */
 interface AngleLimitConfig {
     /** Max angle in degrees between parent and child bone. Negative = disabled */
     angleLimit: number;
@@ -11429,6 +11734,11 @@ interface AngleLimitConfig {
     limitFromRoot: boolean;
 }
 /** Flat plane limiter — infinite plane that points cannot pass through */
+/**
+ * Infinite plane limiter that points cannot pass through.
+ *
+ * @public
+ */
 interface FlatPlane {
     /** Plane normal (points toward the "allowed" side) */
     normal: Vector3;
@@ -11439,6 +11749,11 @@ interface FlatPlane {
  * Input point data for low-level initialization (mirrors C# Point struct).
  * Used when bypassing the Controller and calling the solver directly.
  */
+/**
+ * Input point data for low-level initialization.
+ *
+ * @public
+ */
 interface PointInit {
     /** Parent point index (-1 = no parent) */
     parent: number;
@@ -11505,6 +11820,11 @@ interface PointInit {
  * Engine-agnostic transform read/write interface.
  * Implement this to bridge the solver with any rendering engine (Three.js, Babylon, custom).
  */
+/**
+ * Transform adapter used by the solver to read and write bone state.
+ *
+ * @public
+ */
 interface TransformAccess {
     /** Read world-space position */
     getWorldPosition(): Vector3;
@@ -11533,6 +11853,11 @@ interface TransformAccess {
  * Bone hierarchy node for constraint building.
  * Represents a single bone in the tree structure passed to buildConstraints().
  */
+/**
+ * Bone hierarchy node used to build constraints and simulation points.
+ *
+ * @public
+ */
 interface BoneNode {
     /** Unique index of this bone (must match the position in the pointTransforms array) */
     index: number;
@@ -11550,16 +11875,19 @@ interface BoneNode {
     boneAxis?: Vector3;
 }
 
+/** @public */
 interface CollisionResult {
     hit: boolean;
     point: Vector3;
 }
+/** @public */
 interface LineCollisionResult {
     hit: boolean;
     pointOnLine: Vector3;
     pointOnCollider: Vector3;
     radius: number;
 }
+/** @public */
 interface SurfaceCheckResult {
     hit: boolean;
     intersectionPoint: Vector3;
@@ -11567,6 +11895,7 @@ interface SurfaceCheckResult {
     pointOnCollider: Vector3;
     radius: number;
 }
+/** @public */
 interface NearestPointsResult {
     tP: number;
     tQ: number;
@@ -11574,16 +11903,71 @@ interface NearestPointsResult {
     pointOnQ: Vector3;
     sqrDistance: number;
 }
+/**
+ * Pushes a point out of a sphere collider.
+ *
+ * @public
+ */
 declare function pushoutFromSphere(center: Vector3, radius: number, pointRadius: number, point: Vector3, out?: CollisionResult): CollisionResult;
+/**
+ * Pushes a point out of a collider.
+ *
+ * @public
+ */
 declare function pushoutFromCollider(colR: ColliderR, colRW: ColliderRW, point: Vector3, ptR: PointR, out?: CollisionResult): CollisionResult;
+/**
+ * Pushes a point out of a capsule collider.
+ *
+ * @public
+ */
 declare function pushoutFromCapsule(colR: ColliderR, colRW: ColliderRW, point: Vector3, ptR: PointR, out?: CollisionResult): CollisionResult;
+/**
+ * Pulls a point inside a sphere collider.
+ *
+ * @public
+ */
 declare function pushInFromSphere(center: Vector3, radius: number, point: Vector3, out?: CollisionResult): CollisionResult;
+/**
+ * Pulls a point inside a collider.
+ *
+ * @public
+ */
 declare function pushInFromCollider(colR: ColliderR, colRW: ColliderRW, point: Vector3, out?: CollisionResult): CollisionResult;
+/**
+ * Pulls a point inside a capsule collider.
+ *
+ * @public
+ */
 declare function pushInFromCapsule(colR: ColliderR, colRW: ColliderRW, point: Vector3, out?: CollisionResult): CollisionResult;
+/**
+ * Performs sphere collision detection.
+ *
+ * @public
+ */
 declare function collisionDetectionSphere(center: Vector3, radius: number, point1: Vector3, point2: Vector3, out?: LineCollisionResult): LineCollisionResult;
+/**
+ * Performs capsule collision detection.
+ *
+ * @public
+ */
 declare function collisionDetectionCapsule(colR: ColliderR, colRW: ColliderRW, point1: Vector3, point2: Vector3, out?: LineCollisionResult): LineCollisionResult;
+/**
+ * Performs collision detection against the specified collider.
+ *
+ * @public
+ */
 declare function collisionDetection(colR: ColliderR, colRW: ColliderRW, point1: Vector3, point2: Vector3, out?: LineCollisionResult): LineCollisionResult;
+/**
+ * Performs inward collision detection.
+ *
+ * @public
+ */
 declare function pushInCollisionDetection(colR: ColliderR, colRW: ColliderRW, point1: Vector3, point2: Vector3, out?: LineCollisionResult): LineCollisionResult;
+/**
+ * Computes the nearest points between two segments.
+ *
+ * @public
+ */
 declare function computeNearestPoints(posP: Vector3, dirP: Vector3, posQ: Vector3, dirQ: Vector3, out?: NearestPointsResult): {
     tP: number;
     tQ: number;
@@ -11591,9 +11975,18 @@ declare function computeNearestPoints(posP: Vector3, dirP: Vector3, posQ: Vector
     pointOnQ: Vector3;
     sqrDistance: number;
 };
+/**
+ * Checks triangle-surface collision against a collider.
+ *
+ * @public
+ */
 declare function checkSurfaceCollision(ptA: Vector3, ptB: Vector3, ptC: Vector3, colliderPos: Vector3, colR: ColliderR, colRW: ColliderRW, out?: SurfaceCheckResult): SurfaceCheckResult;
 
-/** Parameters for a single simulation step */
+/**
+ * Parameters for a single simulation step.
+ *
+ * @public
+ */
 interface SimulationParams {
     /** If true, skip force integration (only apply root motion and output positions) */
     isPaused: boolean;
@@ -11617,7 +12010,7 @@ interface SimulationParams {
     windForce: Vector3;
     /** Enable triangle-based surface collision */
     enableSurfaceCollision: boolean;
-    /** Triangle indices for surface collision (6 per quad: 2 triangles 鑴?3 indices) */
+    /** Triangle indices for surface collision (6 per quad: 2 triangles, 3 indices each) */
     surfaceConstraints: number[];
     /** Number of constraint relaxation iterations per substep */
     relaxation: number;
@@ -11639,22 +12032,43 @@ interface SimulationParams {
     enableBroadPhase: boolean;
 }
 /**
- * Run the full simulation step. Mutates pointsRW and collidersRW in place.
- * Returns { positionsToTransform, fakeWaveCounter }.
+ * Run the full simulation step. Mutates `pointsRW` and `collidersRW` in place.
+ * Returns `{ positionsToTransform, fakeWaveCounter }`.
+ *
+ * @public
  */
 declare function simulate(params: SimulationParams, pointsR: readonly PointR[], pointsRW: PointRW[], constraints: readonly Constraint[], collidersR: readonly ColliderR[], collidersRW: ColliderRW[], grabbersR: readonly GrabberR[], grabbersRW: readonly GrabberRW[], movableLimitTargets: readonly Vector3[], flatPlanes: readonly FlatPlane[]): {
     positionsToTransform: Vector3[];
     fakeWaveCounter: number;
 };
+/**
+ * Output of applying the simulated result back to transforms.
+ *
+ * @public
+ */
 interface ApplyResultOutput {
     position: Vector3;
     rotation: Quaternion;
     localRotation: Quaternion;
 }
+/**
+ * Computes transform outputs from the simulated point positions.
+ *
+ * @public
+ */
 declare function applyResult(pointsR: readonly PointR[], pointsRW: PointRW[], positionsToTransform: readonly Vector3[], blendRatio: number, transformRotations: readonly Quaternion[], transformLocalRotations: readonly Quaternion[], preserveTwist: boolean): ApplyResultOutput[];
+/**
+ * Applies post-simulation angle limits to the point state.
+ *
+ * @public
+ */
 declare function applyAngleLimits(pointsR: readonly PointR[], pointsRW: PointRW[], config: AngleLimitConfig): void;
 
-/** Options for constraint generation from bone hierarchy */
+/**
+ * Options for constraint generation from a bone hierarchy.
+ *
+ * @public
+ */
 interface ConstraintBuildOptions {
     /** Generate parent→child vertical constraints */
     structuralVertical: boolean;
@@ -11677,15 +12091,37 @@ interface ConstraintBuildOptions {
     /** Enable surface/triangle collision (overrides per-type collision flags) */
     enableSurfaceCollision: boolean;
 }
+/**
+ * Builds solver constraints from the supplied root chains.
+ *
+ * @public
+ */
 declare function buildConstraints(rootPoints: BoneNode[], options: ConstraintBuildOptions): Constraint[];
+/**
+ * Builds triangle indices used for surface collision.
+ *
+ * @public
+ */
 declare function buildSurfaceFaces(rootPoints: BoneNode[], isLoop: boolean): number[];
+/**
+ * Computes the maximum chain depth among all root points.
+ *
+ * @public
+ */
 declare function computeMaxDepth(rootPoints: BoneNode[]): number;
+/**
+ * Sorts root points by proximity to the supplied reference position.
+ *
+ * @public
+ */
 declare function sortRootPointsByProximity(roots: BoneNode[], ignoreY: boolean, fixedBeginEnd: boolean): BoneNode[];
 
 /**
  * Depth-based physics parameter curves.
  * Each curve is evaluated with t = pointDepth / maxDepth (0 at root, 1 at tip).
  * This allows parameters to vary smoothly along the bone chain.
+ *
+ * @public
  */
 interface PhysicsCurves {
     /** Scales point mass by depth */
@@ -11733,9 +12169,12 @@ interface PhysicsCurves {
     /** Fake wave frequency offset by depth */
     fakeWaveFreq: InterpolatorScalar;
 }
-/** Top-level configuration for the physics controller */
+/**
+ * Top-level configuration for the physics controller
+ * @public
+ **/
 interface ControllerConfig {
-    /** Global gravity vector (e.g. {x:0, y:-9.8, z:0}) */
+    /** Global gravity vector */
     gravity: Vector3;
     /** Global wind force vector applied to all dynamic points */
     windForce: Vector3;
@@ -11772,21 +12211,41 @@ interface ControllerConfig {
     /** Which constraint types to generate and their collision flags */
     constraintOptions: ConstraintBuildOptions;
 }
-/** Stable runtime handle for a JointDynamics collider. */
+/**
+ * Stable runtime handle for a JointDynamics collider.
+ * @public
+ */
 interface JointDynamicsColliderHandle {
     readonly type: 'collider';
     readonly id: number;
 }
-/** Stable runtime handle for a JointDynamics flat plane. */
+/**
+ * Stable runtime handle for a JointDynamics flat plane.
+ * @public
+ */
 interface JointDynamicsFlatPlaneHandle {
     readonly type: 'flatPlane';
     readonly id: number;
 }
-/** Stable runtime handle for a JointDynamics grabber. */
+/**
+ * Stable runtime handle for a JointDynamics grabber.
+ * @public
+ */
 interface JointDynamicsGrabberHandle {
     readonly type: 'grabber';
     readonly id: number;
 }
+/**
+ * High-level controller for joint dynamics simulation.
+ *
+ * This class manages the physics simulation for a hierarchy of bones, including constraints,
+ * colliders, and grabbers. It provides an API for initializing the system with bone data and
+ * transforms, stepping the simulation each frame, and modifying colliders and grabbers at runtime.
+ * The controller handles the internal state and logic for blending between animation and physics,
+ * applying forces, and enforcing constraints.
+ *
+ * @public
+ */
 declare class JointDynamicsSystemController {
     private _config;
     private _pointsR;
@@ -11825,13 +12284,13 @@ declare class JointDynamicsSystemController {
     private _fadeDuration;
     constructor(config: ControllerConfig);
     /**
-     * 初始化物理系统
-     * @param rootTransform 根骨骼的 transform（用于检测根运动）
-     * @param rootPoints 骨骼层级的根节点数组（可以有多个根，如裙子的多条链）
-     * @param pointTransforms 所有物理点的 transform 数组（顺序必须与 BoneNode.index 对应）
-     * @param colliders 碰撞器数组（球体/胶囊体）
-     * @param grabbers 抓取器数组（用于鼠标交互等）
-     * @param flatPlanes 平面限制器数组（如地板，防止穿透）
+     * Initializes the physics system.
+     * @param rootTransform - Root bone transform used to detect root motion.
+     * @param rootPoints - Root nodes of the bone hierarchy. Multiple roots are allowed.
+     * @param pointTransforms - Transform array for all physics points. Order must match `BoneNode.index`.
+     * @param colliders - Collider array (spheres/capsules).
+     * @param grabbers - Grabber array used for interactions such as mouse dragging.
+     * @param flatPlanes - Plane limiters such as the floor to prevent penetration.
      */
     initialize(rootTransform: TransformAccess, rootPoints: BoneNode[], pointTransforms: TransformAccess[], colliders: Array<{
         r: ColliderR;
@@ -11845,155 +12304,193 @@ declare class JointDynamicsSystemController {
         position: Vector3;
     }>): void;
     /**
-     * 执行一帧物理模拟
-     * 内部流程：读取当前 transform → 运行 Verlet 积分和约束求解 → 写回 transform
-     * @param deltaTime 帧间隔时间（秒）。内部会被 subSteps 细分
+     * Advances the simulation by one frame.
+     * Internal flow: read current transforms, run Verlet integration and constraint solving,
+     * then write the result back to the transforms.
+     * @param deltaTime - Frame delta time in seconds. Internally subdivided by `subSteps`.
      */
     step(deltaTime: number): void;
     /**
-     * 获取所有点的模拟结果（世界坐标位置和旋转）
-     * 通常不需要手动调用——step() 已经自动写回 transform。
-     * 适用于需要在不写回 transform 的情况下读取物理结果的场景。
+     * Returns the simulated results for all points as world-space positions and rotations.
+     * Usually this does not need to be called manually because `step()` already writes the
+     * output back to the transforms.
      */
     getResults(): Array<{
         position: Vector3;
         rotation: Quaternion;
     }>;
     /**
-     * 瞬移补偿——在角色传送/瞬移后调用
-     * 将上一帧的根骨骼位置和旋转设为当前值，
-     * 使下一帧的根运动增量为零，避免物理点因巨大位移而弹射。
+     * Compensates for teleportation by resetting the previous root transform to the current one.
+     * Call this after a character warp or teleport to avoid a large root-motion impulse on the
+     * next simulation step.
      */
     warp(): void;
     /**
-     * 重置所有物理状态
-     * 将所有点的模拟位置重置为当前 transform 位置，清除速度和抓取状态。
-     * 适用于场景切换或需要消除所有物理运动的场景。
+     * Resets all physics state.
+     * Each simulated point is snapped back to the current transform position and grab state
+     * is cleared.
      */
     reset(): void;
     /**
-     * 释放固定点为动态点（如脱衣、布料脱落）
-     * 将 weight 从 0 改为 1，同时重置该点的模拟状态避免瞬间弹射。
-     * @param index 点的索引
+     * Releases a fixed point so it becomes dynamic, for example when cloth is detached.
+     * The point state is reset to avoid a sudden impulse.
+     * @param index - Point index.
      */
     releasePoint(index: number): void;
     /**
-     * 将动态点重新固定为跟随动画（如重新穿戴）
-     * 将 weight 从 1 改为 0，清除抓取状态。
-     * @param index 点的索引
+     * Fixes a dynamic point back to the animation pose, for example when an item is reattached.
+     * The point grab state is cleared.
+     * @param index - Point index.
      */
     fixPoint(index: number): void;
     /**
-     * 查询某个点是否为固定状态（weight=0，跟随动画）
-     * @param index 点的索引
+     * Returns whether a point is fixed to animation (`weight = 0`).
+     * @param index - Point index.
      */
     isPointFixed(index: number): boolean;
-    /** 获取物理点总数 */
+    /** Gets the total number of physics points. */
     get pointCount(): number;
     /**
-     * 渐入物理——从动画姿态平滑过渡到物理模拟
-     * blendRatio 从 1（纯动画）渐变到 0（纯物理）
-     * @param seconds 过渡时长（秒）
+     * Fades physics in by blending from animation pose to simulation.
+     * `blendRatio` moves from `1` (animation only) to `0` (physics only).
+     * @param seconds - Transition duration in seconds.
      */
     fadeIn(seconds: number): void;
     /**
-     * 渐出物理——从物理模拟平滑过渡回动画姿态
-     * blendRatio 从 0（纯物理）渐变到 1（纯动画）
-     * @param seconds 过渡时长（秒）
+     * Fades physics out by blending from simulation back to animation pose.
+     * `blendRatio` moves from `0` (physics only) to `1` (animation only).
+     * @param seconds - Transition duration in seconds.
      */
     fadeOut(seconds: number): void;
     /**
-     * 设置全局风力向量
-     * 风力会按每个点的 windForceScale 和质量进行缩放
-     * @param wind 风力向量（世界坐标）
+     * Sets the global wind force vector.
+     * The final wind contribution is still scaled per point by `windForceScale` and mass.
+     * @param wind - Wind vector in world space.
      */
     setWindForce(wind: Vector3): void;
-    /** Enable/disable broad-phase pruning for runtime performance comparison */
+    /**
+     * Enable/disable broad-phase pruning for runtime performance comparison
+     * @param enabled - `true` to enable broad-phase, `false` to disable.
+     */
     setBroadPhaseEnabled(enabled: boolean): void;
     /** The blend ratio for the physics simulation */
     get blendRatio(): number;
     set blendRatio(value: number);
     /**
-     * 暂停/恢复物理模拟
-     * 暂停时仍会跟随根骨骼运动，但不进行力学积分和约束求解
-     * @param paused true=暂停, false=恢复
+     * Pauses or resumes the physics simulation.
+     * While paused, the system still follows root motion but skips force integration and
+     * constraint solving.
+     * @param paused - `true` to pause, `false` to resume.
      */
     setPaused(paused: boolean): void;
     /**
      * Enable or disable a collider by current array index.
      * Transform state is still read from the collider's TransformAccess each frame.
      * Prefer setColliderEnabled(handle, enabled) for runtime-owned colliders.
+     *
+     * @param index - Collider index in the current array. Note that this may change when colliders are added or removed.
+     * @param enabled - `true` to enable the collider, `false` to disable it.
+     *
+     * @returns `true` if the index is valid and the collider was updated, `false` if the index is out of range.
      */
     setColliderEnabledAt(index: number, enabled: boolean): boolean;
     /**
      * Enable or disable a runtime collider by stable handle.
+     *
+     * @param handle - Stable handle for the collider to enable or disable.
+     * @param enabled - `true` to enable the collider, `false` to disable it.
      * @returns true if the handle is still valid.
      */
     setColliderEnabled(handle: JointDynamicsColliderHandle, enabled: boolean): boolean;
     /**
      * Add a collider at runtime.
+     * @param r - Read-only collider data such as shape and size.
+     * @param transform - TransformAccess that provides the collider's position and rotation each frame.
      * @returns A stable handle that remains valid until this collider is removed.
      */
     addCollider(r: ColliderR, transform: TransformAccess): JointDynamicsColliderHandle;
     /**
      * Remove a collider by stable handle.
+     * @param handle - Stable handle for the collider to remove.
      * @returns true if the collider existed and was removed.
      */
     removeCollider(handle: JointDynamicsColliderHandle): boolean;
     /**
      * Remove a collider by current array index.
+     * @param index - Collider index in the current array. Note that this may change when colliders are added or removed.
      * Prefer removeCollider(handle) for runtime-owned colliders.
      */
     removeColliderAt(index: number): boolean;
     /**
      * Enable or disable a flat plane by current array index.
-     * Prefer setFlatPlaneEnabled(handle, enabled) for runtime-owned flat planes.
+     * @param index - Flat plane index in the current array. Note that this may change when flat planes are added or removed.
+     * @param enabled - `true` to enable the flat plane, `false` to disable it.
+     * @returns `true` if the index is valid and the flat plane was updated, `false` if the index is out of range.
      */
     setFlatPlaneEnabledAt(index: number, enabled: boolean): boolean;
     /**
      * Enable or disable a runtime flat plane by stable handle.
+     * @param handle - Stable handle for the flat plane to enable or disable.
+     * @param enabled - `true` to enable the flat plane, `false` to disable it.
      * @returns true if the handle is still valid.
      */
     setFlatPlaneEnabled(handle: JointDynamicsFlatPlaneHandle, enabled: boolean): boolean;
     /**
      * Add a flat plane at runtime.
+     * @param up - Up direction of the plane. The normal is computed as `Vector3.normalize(up)`.
+     * @param position - A point on the plane. The distance is computed as `-Vector3.dot(normal, position)`.
      * @returns A stable handle that remains valid until this flat plane is removed.
      */
     addFlatPlane(up: Vector3, position: Vector3): JointDynamicsFlatPlaneHandle;
     /**
      * Remove a flat plane by stable handle.
+     * @param handle - Stable handle for the flat plane to remove.
      * @returns true if the flat plane existed and was removed.
      */
     removeFlatPlane(handle: JointDynamicsFlatPlaneHandle): boolean;
     /**
      * Remove a flat plane by current array index.
-     * Prefer removeFlatPlane(handle) for runtime-owned flat planes.
+     * @param index - Flat plane index in the current array. Note that this may change when flat planes are added or removed.
+     * @returns true if the index was valid and the flat plane was removed, false if the index was out of range.
      */
     removeFlatPlaneAt(index: number): boolean;
     /**
      * Enable or disable a grabber by current array index.
      * Transform state is still read from the grabber's TransformAccess each frame.
      * Prefer setGrabberEnabled(handle, enabled) for runtime-owned grabbers.
+     *
+     * @param index - Grabber index in the current array. Note that this may change when grabbers are added or removed.
+     * @param enabled - `true` to enable the grabber, `false` to disable it.
+     * @returns `true` if the index is valid and the grabber was updated, `false` if the index is out of range.
      */
     setGrabberEnabledAt(index: number, enabled: boolean): boolean;
     /**
      * Enable or disable a runtime grabber by stable handle.
+     * @param handle - Stable handle for the grabber to enable or disable.
+     * @param enabled - `true` to enable the grabber, `false` to disable it.
      * @returns true if the handle is still valid.
      */
     setGrabberEnabled(handle: JointDynamicsGrabberHandle, enabled: boolean): boolean;
     /**
      * Add a grabber at runtime.
+     * @param r - Read-only grabber data such as interaction radius.
+     * @param transform - TransformAccess that provides the grabber's position each frame.
+     * @param enabled - Whether the grabber starts enabled. The grabber can still be moved by its transform while disabled, but it won't affect any points until enabled.
      * @returns A stable handle that remains valid until this grabber is removed.
      */
     addGrabber(r: GrabberR, transform: TransformAccess, enabled?: boolean): JointDynamicsGrabberHandle;
     /**
      * Remove a grabber by stable handle.
+     * @param handle - Stable handle for the grabber to remove.
      * @returns true if the grabber existed and was removed.
      */
     removeGrabber(handle: JointDynamicsGrabberHandle): boolean;
     /**
      * Remove a grabber by current array index.
      * Prefer removeGrabber(handle) for runtime-owned grabbers.
+     *
+     * @param index - Grabber index in the current array. Note that this may change when grabbers are added or removed.
+     * @returns true if the index was valid and the grabber was removed, false if the index was out of range.
      */
     removeGrabberAt(index: number): boolean;
     /** Gets the number of runtime colliders. */
@@ -12272,6 +12769,11 @@ declare class JointDynamicsModifier extends SkeletonModifier {
     protected _setWeight(value: number): void;
 }
 
+/**
+ * Callback invoked after a mesh finishes its per-frame update.
+ *
+ * @public
+ */
 type MeshUpdateCallback = (frameId: number, elapsedInSeconds: number, deltaInSeconds: number) => void;
 declare const Mesh_base: typeof GraphNode & _zephyr3d_base.GenericConstructor<{
     getNode(): SceneNode;
@@ -12291,11 +12793,11 @@ declare class Mesh extends Mesh_base implements BatchDrawable {
      */
     getName(): string;
     /**
-     * {@inheritDoc BatchDrawable.getInstanceId}
+     * Returns the batch instance ID for the current render pass.
      */
     getInstanceId(_renderPass: RenderPass): string;
     /**
-     * {@inheritDoc BatchDrawable.getInstanceUniforms}
+     * Returns the packed instance-uniform buffer used for batching.
      */
     getInstanceUniforms(): Float32Array<ArrayBuffer>;
     /**
@@ -12305,9 +12807,6 @@ declare class Mesh extends Mesh_base implements BatchDrawable {
     setPickTarget(node: SceneNode, label?: string): void;
     get skeletonName(): string;
     set skeletonName(name: string);
-    set skinAnimation(val: boolean);
-    set suspendSkinning(val: boolean);
-    set morphAnimation(val: boolean);
     /** Wether the mesh node casts shadows */
     get castShadow(): boolean;
     set castShadow(b: boolean);
@@ -12388,7 +12887,7 @@ declare class Mesh extends Mesh_base implements BatchDrawable {
     /**
      * Update morph target weight
      *
-     * @param weight - The weights of the morph targets, the length should be less than or equal to ${MAX_MORPH_TARGETS}
+     * @param weight - The morph target weights. The length must not exceed the mesh's morph target count.
      */
     updateMorphWeights(weight: number[]): void;
     /** {@inheritDoc SceneNode.update} */
@@ -12619,7 +13118,6 @@ declare class ParticleSystem extends ParticleSystem_base implements Drawable {
     /** Whether particles are in world space */
     get worldSpace(): boolean;
     set worldSpace(value: boolean);
-    set flags(value: number);
     private getParticleInitialPosition;
     resizeVertexBuffers(): void;
     update(_frameId: number, elapsedInSeconds: number, deltaInSeconds: number): void;
@@ -12848,6 +13346,11 @@ interface AssetAnimationTrack {
     interpolator: Interpolator;
     defaultMorphWeights?: number[];
 }
+/**
+ * Fixed-frame geometry cache animation track data.
+ *
+ * @public
+ */
 interface AssetFixedGeometryCacheAnimationTrack {
     node: AssetHierarchyNode;
     type: 'geometry-cache';
@@ -12856,6 +13359,11 @@ interface AssetFixedGeometryCacheAnimationTrack {
     times: Float32Array;
     frames: FixedGeometryCacheFrame[];
 }
+/**
+ * PCA-compressed geometry cache animation track data.
+ *
+ * @public
+ */
 interface AssetPCAGeometryCacheAnimationTrack {
     node: AssetHierarchyNode;
     type: 'geometry-cache';
@@ -12871,6 +13379,11 @@ interface AssetPCAGeometryCacheAnimationTrack {
     normalBases?: Nullable<Float32Array[]>;
     normalCoefficients?: Nullable<Float32Array[]>;
 }
+/**
+ * Geometry cache animation track data.
+ *
+ * @public
+ */
 type AssetGeometryCacheAnimationTrack = AssetFixedGeometryCacheAnimationTrack | AssetPCAGeometryCacheAnimationTrack;
 /**
  * Animation data interface for model loading
@@ -14092,9 +14605,6 @@ declare class ClipmapTerrain extends ClipmapTerrain_base implements Drawable {
      * @returns Maximum number of detail maps
      */
     get MAX_DETAIL_MAP_COUNT(): number;
-    set heightMapAssetId(val: string);
-    set splatMapAssetId(val: string);
-    set grassAssetId(val: string);
     /**
      * The current number of active detail maps.
      * Detail maps define different surface materials (grass, rock, etc.).
@@ -14246,11 +14756,11 @@ declare class BaseSprite<M extends SpriteMaterial> extends BaseSprite_base imple
      */
     getName(): string;
     /**
-     * {@inheritDoc BatchDrawable.getInstanceId}
+     * Returns the batch instance ID for the current render pass.
      */
     getInstanceId(_renderPass: RenderPass): string;
     /**
-     * {@inheritDoc BatchDrawable.getInstanceUniforms}
+     * Returns the packed instance-uniform buffer used for batching.
      */
     getInstanceUniforms(): Float32Array<ArrayBuffer>;
     /**
@@ -14342,13 +14852,33 @@ declare class Sprite extends BaseSprite<SpriteMaterial> {
     isSprite(): this is Sprite;
 }
 
+/**
+ * Serializable script attachment configuration payload.
+ *
+ * @public
+ */
 type ScriptAttachmentConfig = Nullable<Record<string, unknown> | unknown[]>;
+/**
+ * Normalizes a script attachment config into a clone-safe serializable shape.
+ *
+ * @public
+ */
 declare function normalizeScriptAttachmentConfig(value: unknown): ScriptAttachmentConfig;
+/**
+ * Describes a script attached to a scene node.
+ *
+ * @public
+ */
 declare class ScriptAttachment {
     script: string;
     config: ScriptAttachmentConfig;
     constructor(script?: string, config?: ScriptAttachmentConfig);
 }
+/**
+ * Normalizes an arbitrary value into an array of script attachments.
+ *
+ * @public
+ */
 declare function normalizeScriptAttachments(value: unknown): ScriptAttachment[];
 
 /**
@@ -15171,7 +15701,7 @@ declare class SceneNode extends SceneNode_base implements IDisposable {
      * Warning: Do not remove children during this iteration. To allow removal, use `iterateBottomToTop`.
      *
      * @param callback - Called for each node; if returns true, iteration stops.
-     * @returns true if iteration was aborted early.
+     * @returns If returns true, the iteration will immediately stop.
      */
     iterate(callback: NodeIterateFunc): boolean;
     /**
@@ -15180,7 +15710,7 @@ declare class SceneNode extends SceneNode_base implements IDisposable {
      * Child nodes can be safely removed during this iteration.
      *
      * @param callback - Called for each node; if returns true, iteration stops.
-     * @returns true if iteration was aborted early.
+     * @returns If returns true, the iteration will immediately stop.
      */
     iterateBottomToTop(callback: NodeIterateFunc): boolean;
     /** Type guard: true if this node is a graph node. */
@@ -15570,6 +16100,15 @@ declare class ScriptRegistry {
      */
     get scriptsRoot(): string;
     set scriptsRoot(path: string);
+    /**
+     * Invalidates cached built module output for one logical module id, or clears the full cache.
+     *
+     * Pass the same logical id shape that callers use with {@link ScriptRegistry.resolveRuntimeUrl},
+     * for example `/assets/scripts/foo.ts`, `/assets/scripts/foo.js`, or `/assets/scripts/foo`.
+     *
+     * @param moduleId - Optional logical module id to invalidate. Omit to clear the entire build cache.
+     */
+    invalidate(moduleId?: string): void;
     /**
      * Fetches raw source for a logical module id by probing known extensions.
      *
@@ -16142,7 +16681,7 @@ declare class Engine {
      */
     get resourceManager(): ResourceManager;
     /**
-     * Exposes the instanceof {@link Screen}
+     * Exposes the active {@link ScreenAdapter}.
      */
     get screen(): ScreenAdapter;
     /**
@@ -16249,7 +16788,11 @@ type appEventMap = {
     dragend: [evt: DragEvent];
     drop: [evt: DragEvent];
 };
-/** Editor Mode */
+/**
+ * Application editor/runtime mode.
+ *
+ * @public
+ */
 type EditorMode = 'editor' | 'editor-preview' | 'none';
 /**
  * Options for Application.
@@ -16271,7 +16814,7 @@ interface AppOptions {
      */
     enableMSAA?: boolean;
     /**
-     * Device pixel ratio used when creating the device. Defaults to `window.devicePixelRatio` or 1.
+     * Device pixel ratio used when creating the device. Defaults to `window.devicePixelRatio` or `1`.
      */
     pixelRatio?: number;
 }
@@ -17116,6 +17659,14 @@ declare class ResourceManager {
      * @returns An array of `PropertyAccessor` entries, or `null` if none.
      */
     getPropertiesByClass(cls: SerializableClass): PropertyAccessor[] | null;
+    /**
+     * Get all properties declared on a given class and its ancestors.
+     *
+     * @param cls - Serializable class metadata.
+     *
+     * @returns An array of `PropertyAccessor` entries, or `null` if none.
+     */
+    getAllPropertiesByClass(cls: Nullable<SerializableClass>): PropertyAccessor[];
     /**
      * Get a property accessor by class and property name.
      *
@@ -20831,7 +21382,7 @@ declare class PixelWorldPositionNode extends BaseGraphNode {
      * Gets the output type for a specific output slot
      *
      * @param id - The output slot ID
-     * @returns 'float' for individual component outputs (id > 1), 'vec3' for full position
+     * @returns 'float' for individual component outputs (id \> 1), 'vec3' for full position
      */
     protected getType(id: number): "float" | "vec3";
 }
@@ -20961,7 +21512,7 @@ declare class PixelNormalNode extends BaseGraphNode {
      * Gets the output type for a specific output slot
      *
      * @param id - The output slot ID
-     * @returns 'float' for individual component outputs (id > 1), 'vec3' for full normal
+     * @returns 'float' for individual component outputs (id \> 1), 'vec3' for full normal
      */
     protected getType(id: number): "float" | "vec3";
 }
@@ -21732,7 +22283,7 @@ declare class CameraVectorNode extends BaseGraphNode {
      * Gets the output type for a specific output slot
      *
      * @param id - The output slot ID
-     * @returns 'float' for individual component outputs (id > 1), 'vec3' for full vector
+     * @returns 'float' for individual component outputs (id \> 1), 'vec3' for full vector
      */
     protected getType(id: number): "float" | "vec3";
 }
@@ -22479,9 +23030,6 @@ declare class CapsuleShape extends Shape<CapsuleCreationOptions> implements Clon
     /** Capsule total height */
     get totalHeight(): number;
     /**
-     * {@inheritDoc Primitive.raycast}
-     * @override
-     *
      * Analytically intersects a ray with a capsule aligned along the Y axis.
      *
      * The capsule consists of:
@@ -22553,9 +23101,6 @@ declare class CylinderShape extends Shape<CylinderCreationOptions> implements Cl
     /** type of the shape */
     get type(): "Cylinder";
     /**
-     * {@inheritDoc Primitive.raycast}
-     * @override
-     *
      * Analytically intersects a ray with a cone frustum (or cylinder when
      * topRadius === bottomRadius) including the optional top and bottom caps.
      *
@@ -22625,9 +23170,6 @@ declare class PlaneShape extends Shape<PlaneCreationOptions> implements Clonable
     /** type of the shape */
     get type(): "Plane";
     /**
-     * {@inheritDoc Primitive.raycast}
-     * @override
-     *
      * Intersects the ray with the finite XZ plane (y = 0) whose bounds are
      * determined by size/anchor options.
      */
@@ -22736,9 +23278,6 @@ declare class TorusShape extends Shape<TorusCreationOptions> implements Clonable
     /** type of the shape */
     get type(): "Torus";
     /**
-     * {@inheritDoc Primitive.raycast}
-     * @override
-     *
      * Analytically intersects a ray with a torus lying in the XZ plane.
      * The torus has major radius R (outerRadius) and minor radius r (innerRadius).
      *
@@ -22784,9 +23323,6 @@ declare class TetrahedronShape extends Shape<TetrahedronCreationOptions> impleme
     clone(): this;
     get type(): string;
     /**
-     * {@inheritDoc Primitive.raycast}
-     * @override
-     *
      * Tests each triangular face of the tetrahedron with the Möller–Trumbore
      * algorithm and returns the smallest non-negative t.
      */
@@ -22813,9 +23349,6 @@ declare class TetrahedronFrameShape extends Shape<TetrahedronCreationOptions> im
     clone(): this;
     get type(): "TetrahedronFrame";
     /**
-     * {@inheritDoc Primitive.raycast}
-     * @override
-     *
      * Tests each triangular face of the tetrahedron with the Möller–Trumbore
      * algorithm and returns the smallest non-negative t.
      * The wireframe has the same overall geometry as the solid version.
@@ -23552,4 +24085,4 @@ declare const ATMOSPHERIC_FOG_BIT: number;
  */
 declare const HEIGHT_FOG_BIT: number;
 
-export { AABBTree, ABufferOIT, ATMOSPHERIC_FOG_BIT, AbsNode, AbstractPostEffect, AllConditionNode, type AngleLimitConfig, AnimationClip, AnimationSet, AnimationTrack, AnyConditionNode, type AppCreationOptions, type AppOptions, Application, type ApplyResultOutput, ArcCosNode, ArcSinNode, ArcTan2Node, ArcTanNode, ArccosineHNode, ArcsineHNode, ArctangentHNode, type AssetAnimationData, type AssetAnimationTrack, type AssetFixedGeometryCacheAnimationTrack, type AssetGeometryCacheAnimationTrack, AssetHierarchyNode, AssetManager, type AssetMaterial, type AssetMaterialClearcoat, type AssetMaterialCommon, type AssetMaterialIridescence, type AssetMaterialSheen, type AssetMaterialTransmission, type AssetMeshData, type AssetPBRMaterialCommon, type AssetPBRMaterialMR, type AssetPBRMaterialSG, type AssetPCAGeometryCacheAnimationTrack, type AssetRotationTrack, type AssetScaleTrack, AssetScene, type AssetSkeletalAnimationTrack, AssetSkeleton, type AssetSubMeshData, type AssetTranslationTrack, type AssetUnlitMaterial, BUILTIN_ASSET_TEST_CUBEMAP, BUILTIN_ASSET_TEXTURE_SHEEN_LUT, BaseCameraController, BaseGraphNode, BaseLight, BaseSprite, BaseTextureNode, type BatchDrawable, BatchGroup, BillboardMatrixNode, type BlendMode, BlinnMaterial, type BlitType, Blitter, Bloom, type BluePrintEditorState, type BluePrintUniformTexture, type BluePrintUniformValue, type BlueprintDAG, type BoneNode, BoundingBox, type BoundingVolume, type BoxCreationOptions, BoxFilterBlitter, BoxFrameShape, BoxShape, CCDSolver, type CachedBindGroup, Camera, CameraNearFarNode, type CameraOITMode, CameraPositionNode, CameraVectorNode, type CapsuleCollider, type CapsuleCreationOptions, CapsuleShape, CeilNode, ClampNode, ClipmapTerrain, ClipmapTerrainMaterial, ColliderForce, type ColliderR, type ColliderRW, type CollisionResult, ColorAdjust, CompAddNode, CompComparisonNode, CompDivNode, CompMulNode, CompSubNode, type ComparisonMode, type CompiledRenderGraph, Compositor, type CompositorContext, ConstantBVec2Node, ConstantBVec3Node, ConstantBVec4Node, ConstantBooleanNode, ConstantScalarNode, ConstantTexture2DArrayNode, ConstantTexture2DNode, ConstantTextureCubeNode, ConstantVec2Node, ConstantVec3Node, ConstantVec4Node, type Constraint, type ConstraintBuildOptions, ConstraintType, type ControllerConfig, CopyBlitter, CosHNode, CosNode, CrossProductNode, CubemapSHProjector, CullVisitor, type CylinderCreationOptions, CylinderShape, DDXNode, DDYNode, Degrees2RadiansNode, DepthPass, DevicePoolAllocator, DirectionalLight, DistanceNode, DotProductNode, DracoMeshDecoder, type DrawContext, type Drawable, type DrawableInstanceInfo, EPSILON, type EditorMode, ElapsedTimeNode, type EmitterBehavior, type EmitterShape, Engine, EnvConstantAmbient, EnvHemisphericAmbient, type EnvLightType, EnvLightWrapper, EnvShIBL, Environment, EnvironmentLighting, EqualNode, Exp2Node, ExpNode, type ExtractMixinReturnType, type ExtractMixinType, FABRIKSolver, FBMWaveGenerator, FFTWaveGenerator, FPSCameraController, type FPSCameraControllerOptions, FWidthNode, FXAA, FaceForwardNode, type FixedGeometryCacheFrame, type FixedGeometryCacheState, FixedGeometryCacheTrack, type FlatPlane, FloorNode, FmaNode, type FogType, type ForwardPlusOptions, FractNode, FunctionCallNode, FunctionInputNode, FunctionOutputNode, GPUClothSystem, type GPUClothSystemOptions, type GPUClothWrapBindingData, type GPUClothWrapBindingTarget, GaussianBlurBlitter, GenericMathNode, type GeometryCacheFrame, type GeometryCacheMeshBinding, type GeometryCacheState, GerstnerWaveGenerator, type GrabberR, type GrabberRW, GraphNode, type GraphNodeInput, type GraphNodeOutput, type GraphStructure, type GrassInstanceInfo, GrassLayer, GrassMaterial, GrassRenderer, Grayscale, HEIGHT_FOG_BIT, Hash1Node, Hash2Node, Hash3Node, HistoryResourceManager, type Host, HumanoidBodyRig, HumanoidHandRig, type HumanoidJointMapping, type IAttachedScript, type IBaseEvent, type IControllerKeyboardEvent, type IControllerKeydownEvent, type IControllerKeypressEvent, type IControllerKeyupEvent, type IControllerMouseEvent, type IControllerPointerCancelEvent, type IControllerPointerDownEvent, type IControllerPointerMoveEvent, type IControllerPointerUpEvent, type IControllerWheelEvent, type IGraphNode, IKAngleConstraint, IKChain, IKConstraint, type IKJoint, IKModifier, IKSolver, type IMixinAlbedoColor, type IMixinBlinnPhong, type IMixinFoliage, type IMixinLambert, type IMixinLight, type IMixinPBRBluePrint, type IMixinPBRCommon, type IMixinPBRMetallicRoughness, type IMixinPBRSpecularGlossiness, type IMixinVertexColor, type IModKey, type IRUniformTexture, type IRUniformValue, type IRenderHook, type IRenderable, type InputEventHandler, InputManager, InstanceBindGroupAllocator, type InstanceData, type InstanceUniformType, type InterChainConstraint, InvProjMatrixNode, InvSqrtNode, InvViewProjMatrixNode, type JointChainConfig, type JointDynamicSystemConfig, type JointDynamicsColliderHandle, type JointDynamicsFlatPlaneHandle, type JointDynamicsGrabberHandle, JointDynamicsModifier, JointDynamicsSystem, JointDynamicsSystemController, LIGHT_TYPE_DIRECTIONAL, LIGHT_TYPE_NONE, LIGHT_TYPE_POINT, LIGHT_TYPE_RECT, LIGHT_TYPE_SPOT, LambertMaterial, LengthNode, type LineCollisionResult, Log2Node, type LogMode, LogNode, LogicallyAndNode, LogicallyOrNode, MAX_CLUSTERED_LIGHTS, MAX_GERSTNER_WAVE_COUNT, MAX_MORPH_ATTRIBUTES, MAX_MORPH_TARGETS, MAX_TERRAIN_MIPMAP_LEVELS, MORPH_ATTRIBUTE_VECTOR_COUNT, MORPH_TARGET_COLOR, MORPH_TARGET_NORMAL, MORPH_TARGET_POSITION, MORPH_TARGET_TANGENT, MORPH_TARGET_TEX0, MORPH_TARGET_TEX1, MORPH_TARGET_TEX2, MORPH_TARGET_TEX3, MORPH_WEIGHTS_VECTOR_COUNT, MakeVectorNode, Material, MaterialBlueprintIR, type MaterialBlueprintIRBehaviors, type MaterialTextureInfo, MaterialVaryingFlags, MaxNode, Mesh, MeshMaterial, type MeshUpdateCallback, type Metadata, MinNode, MixNode, ModNode, type ModelFetchOptions, type ModelInfo, type MorphData, type MorphInfo, type MorphState, MorphTargetTrack, MultiChainSpringSystem, type MultiChainSpringSystemOptions, NamedObject, type NearestPointsResult, type NodeConnection, NodeEulerRotationTrack, type NodeIterateFunc, NodeRotationTrack, NodeScaleTrack, NodeTranslationTrack, NormalizeNode, NotEqualNode, type OIT, Octree, OctreeNode, OctreeNodeChunk, OctreePlacement, OrbitCameraController, type OrbitCameraControllerOptions, OrthoCamera, PBRBlockNode, PBRBluePrintMaterial, PBRMetallicRoughnessMaterial, type PBRReflectionMode, PBRSpecularGlossinessMaterial, type PCAGeometryCacheState, PCAGeometryCacheTrack, type PCAGeometryCacheTrackData, PannerNode, ParticleMaterial, ParticleSystem, PerlinNoise2DNode, PerspectiveCamera, type PhysicsCurves, type PickResult, type PickTarget, PixelNormalNode, PixelWorldPositionNode, type PlaneCollider, type PlaneCreationOptions, PlaneShape, type PlayAnimationOptions, type PointInit, PointLight, type PointR, type PointRW, type PointTransform, PostEffectLayer, PowNode, Primitive, ProjectionMatrixNode, type PropEdit, type PropertyAccessor, type PropertyAccessorOptions, type PropertySceneNodeOptions, type PropertyToType, PropertyTrack, type PropertyType, type PropertyValue, PunctualLight, QUEUE_OPAQUE, QUEUE_TRANSPARENT, RENDER_PASS_TYPE_DEPTH, RENDER_PASS_TYPE_LIGHT, RENDER_PASS_TYPE_OBJECT_COLOR, RENDER_PASS_TYPE_SHADOWMAP, type RGExecuteContext, type RGExecuteFn, RGHandle, type RGPassBuilder, type RGResolvedSize, type RGResourceLifetime, type RGSizeMode, type RGTextureAllocator, type RGTextureDesc, Radians2DegreesNode, RaycastVisitor, RectLight, ReflectNode, RefractNode, RenderContext, RenderGraph, RenderGraphExecutor, type RenderItemList, type RenderItemListBundle, type RenderItemListInfo, RenderPass, RenderQueue, type RenderQueueItem, type RenderQueueRef, RenderTarget, type ResolutionTransform, ResolveVertexNormalNode, ResolveVertexPositionNode, ResolveVertexTangentNode, ResourceManager, RotateAboutAxisNode, RuntimeScript, type RuntimeScriptArrayDeclaration, type RuntimeScriptArrayElementDeclaration, type RuntimeScriptConfig, type RuntimeScriptObjectDeclaration, type RuntimeScriptObjectFieldDeclaration, type RuntimeScriptPropertyDeclaration, type RuntimeScriptPropertyInfo, type RuntimeScriptPropertyOptions, type RuntimeScriptPropertyType, type RuntimeScriptValueDeclaration, type RuntimeScriptValueType, SAO, type SamplerType, SaturateNode, Scene, SceneNode, type SceneNodeVisible, ScreenAdapter, type ScreenConfig, ScreenRenderTarget, type ScreenScaleMode, ScriptAttachment, type ScriptAttachmentConfig, ScriptRegistry, ScriptingSystem, type ScriptingSystemOptions, SelectionNode, type SerializableClass, ShaderHelper, ShadowMapPass, ShadowMapper, type ShadowMode, type ShadowQualityPreset, Shape, type ShapeCreationOptions, type ShapeOptionType, type ShapeType, SharedModel, SignNode, SimplexNoise2DNode, type SimulationParams, SinHNode, SinNode, Skeleton, SkeletonModifier, type SkinnedBoundingBox, SkyEnvTextureNode, SkyRenderer, type SkyType, SmoothStepNode, type SphereCollider, type SphereCreationOptions, SphereShape, SpotLight, SpringChain, type SpringCollider, type SpringConstraint, SpringModifier, type SpringParticle, SpringSystem, type SpringSystemOptions, Sprite, SpriteBlockNode, SpriteBlueprintMaterial, SpriteMaterial, SqrtNode, StandardSpriteMaterial, StepNode, type StopAnimationOptions, type SurfaceCheckResult, SwizzleNode, TanHNode, TanNode, type TerrainDebugMode, type TetrahedronCreationOptions, TetrahedronFrameShape, TetrahedronShape, type TextureFetchOptions, type TextureMixinInstanceTypes, type TextureMixinTypes, type TextureProp, type TexturePropUniforms, TextureSampleGrad, TextureSampleNode, type ToMixedTextureType, Tonemap, type TorusCreationOptions, TorusShape, type TransformAccess, TransformNode, type TwistConstraint, TwoBoneIKSolver, UnlitMaterial, VertexBinormalNode, VertexBlockNode, VertexColorNode, VertexNormalNode, VertexPositionNode, VertexTangentNode, VertexUVNode, ViewMatrixNode, ViewProjMatrixNode, type Visitor, Water, type WaveGenerator, WeightedBlendedOIT, applyAngleLimits, applyMaterialMixins, applyResult, applyRuntimeScriptConfig, buildConstraints, buildForwardPlusGraph, buildSurfaceFaces, checkSurfaceCollision, collisionDetection, collisionDetectionCapsule, collisionDetectionSphere, computeMaxDepth, computeNearestPoints, createCapsuleCollider, createGPUClothWrapBindingData, createGeometryCacheState, createPlaneCollider, createSphereCollider, createSpringConstraint, createSpringParticle, createTransformAccess, decode2HalfFromRGBA, decodeFloatFromRGBA, decodeNormalizedFloatFromRGBA, decodeRGBM, defineProps, encode2HalfToRGBA, encodeFloatToRGBA, encodeNormalizedFloatToRGBA, encodeRGBM, ensureGeometryCacheMeshBinding, executeForwardPlusGraph, fetchSampler, gammaToLinear, getApp, getDevice, getEngine, getInput, getRuntimeScriptProperties, gradient, hash11, hash12, hash13, hash21, hash22, hash23, hash31, hash32, hash33, interleavedGradientNoise, isGPUClothSupported, linearToGamma, mixGeometryCacheBoundingBox, mixinAlbedoColor, mixinBlinnPhong, mixinFoliage, mixinLambert, mixinLight, mixinPBRBluePrint, mixinPBRCommon, mixinPBRMetallicRoughness, mixinPBRSpecularGlossness, mixinTextureProps, mixinVertexColor, noise3D, normalizeRuntimeScriptConfig, normalizeScriptAttachmentConfig, normalizeScriptAttachments, panoramaToCubemap, perlinNoise2D, perlinNoise3D, prefilterCubemap, pushInCollisionDetection, pushInFromCapsule, pushInFromCollider, pushInFromSphere, pushoutFromCapsule, pushoutFromCollider, pushoutFromSphere, resolveCapsuleCollision, resolvePlaneCollision, resolveSphereCollision, restoreGeometryCacheMeshBinding, scriptProp, simulate, smoothNoise3D, sortRootPointsByProximity, temporalResolve, tryGetApp, updateColliderFromNode, valueNoise, whiteNoise, worleyFBM, worleyNoise };
+export { AABBTree, ABufferOIT, ATMOSPHERIC_FOG_BIT, AbsNode, AbstractPostEffect, AllConditionNode, type AngleLimitConfig, AnimationClip, AnimationSet, AnimationTrack, AnyConditionNode, type AppCreationOptions, type AppOptions, Application, type ApplyResultOutput, ArcCosNode, ArcSinNode, ArcTan2Node, ArcTanNode, ArccosineHNode, ArcsineHNode, ArctangentHNode, type AssetAnimationData, type AssetAnimationTrack, type AssetFixedGeometryCacheAnimationTrack, type AssetGeometryCacheAnimationTrack, AssetHierarchyNode, AssetManager, type AssetMaterial, type AssetMaterialClearcoat, type AssetMaterialCommon, type AssetMaterialIridescence, type AssetMaterialSheen, type AssetMaterialTransmission, type AssetMeshData, type AssetPBRMaterialCommon, type AssetPBRMaterialMR, type AssetPBRMaterialSG, type AssetPCAGeometryCacheAnimationTrack, type AssetRotationTrack, type AssetScaleTrack, AssetScene, type AssetSkeletalAnimationTrack, AssetSkeleton, type AssetSubMeshData, type AssetTranslationTrack, type AssetUnlitMaterial, BUILTIN_ASSET_TEST_CUBEMAP, BUILTIN_ASSET_TEXTURE_SHEEN_LUT, BaseCameraController, BaseGraphNode, BaseLight, BaseSprite, BaseTextureNode, type BatchDrawable, BatchGroup, BillboardMatrixNode, type BlendMode, BlinnMaterial, type BlitType, Blitter, Bloom, type BluePrintEditorState, type BluePrintUniformTexture, type BluePrintUniformValue, type BlueprintDAG, type BoneNode, BoundingBox, type BoundingVolume, type BoxCreationOptions, BoxFilterBlitter, BoxFrameShape, BoxShape, CCDSolver, type CachedBindGroup, Camera, CameraNearFarNode, type CameraOITMode, CameraPositionNode, CameraVectorNode, type CapsuleCollider, type CapsuleCreationOptions, CapsuleShape, CeilNode, ClampNode, ClipmapTerrain, ClipmapTerrainMaterial, ColliderForce, type ColliderR, type ColliderRW, type CollisionResult, ColorAdjust, CompAddNode, CompComparisonNode, CompDivNode, CompMulNode, CompSubNode, type ComparisonMode, type CompiledRenderGraph, Compositor, type CompositorContext, ConstantBVec2Node, ConstantBVec3Node, ConstantBVec4Node, ConstantBooleanNode, ConstantScalarNode, ConstantTexture2DArrayNode, ConstantTexture2DNode, ConstantTextureCubeNode, ConstantVec2Node, ConstantVec3Node, ConstantVec4Node, type Constraint, type ConstraintBuildOptions, ConstraintType, type ControllerConfig, CopyBlitter, CosHNode, CosNode, CrossProductNode, CubemapSHProjector, CullVisitor, type CylinderCreationOptions, CylinderShape, DDXNode, DDYNode, Degrees2RadiansNode, DepthPass, DevicePoolAllocator, DirectionalLight, DistanceNode, DotProductNode, DracoMeshDecoder, type DrawContext, type Drawable, type DrawableInstanceInfo, EPSILON, type EditorMode, ElapsedTimeNode, type EmitterBehavior, type EmitterShape, Engine, EnvConstantAmbient, EnvHemisphericAmbient, type EnvLightType, EnvLightWrapper, EnvShIBL, Environment, EnvironmentLighting, EqualNode, Exp2Node, ExpNode, type ExtractMixinReturnType, type ExtractMixinType, FABRIKSolver, FBMWaveGenerator, FFTWaveGenerator, FPSCameraController, type FPSCameraControllerOptions, FWidthNode, FXAA, FaceForwardNode, type FixedGeometryCacheFrame, type FixedGeometryCacheState, FixedGeometryCacheTrack, type FlatPlane, FloorNode, FmaNode, type FogType, type ForwardPlusOptions, FractNode, FunctionCallNode, FunctionInputNode, FunctionOutputNode, GPUClothSystem, type GPUClothSystemOptions, type GPUClothWrapBindingData, type GPUClothWrapBindingTarget, GaussianBlurBlitter, GenericMathNode, type GeometryCacheFrame, type GeometryCacheMeshBinding, type GeometryCacheState, GerstnerWaveGenerator, type GrabberR, type GrabberRW, GraphNode, type GraphNodeInput, type GraphNodeOutput, type GraphStructure, type GrassInstanceInfo, GrassLayer, GrassMaterial, GrassRenderer, Grayscale, HEIGHT_FOG_BIT, Hash1Node, Hash2Node, Hash3Node, HistoryResourceManager, type Host, HumanoidBodyRig, HumanoidHandRig, type HumanoidJointMapping, type IAttachedScript, type IBaseEvent, type IControllerKeyboardEvent, type IControllerKeydownEvent, type IControllerKeypressEvent, type IControllerKeyupEvent, type IControllerMouseEvent, type IControllerPointerCancelEvent, type IControllerPointerDownEvent, type IControllerPointerMoveEvent, type IControllerPointerUpEvent, type IControllerWheelEvent, type IGraphNode, IKAngleConstraint, IKChain, IKConstraint, type IKJoint, IKModifier, IKSolver, type IMixinAlbedoColor, type IMixinBlinnPhong, type IMixinFoliage, type IMixinLambert, type IMixinLight, type IMixinPBRBluePrint, type IMixinPBRCommon, type IMixinPBRMetallicRoughness, type IMixinPBRSpecularGlossiness, type IMixinVertexColor, type IModKey, type IRUniformTexture, type IRUniformValue, type IRenderHook, type IRenderable, type InputEventHandler, InputManager, InstanceBindGroupAllocator, type InstanceData, type InstanceUniformType, type InterChainConstraint, InvProjMatrixNode, InvSqrtNode, InvViewProjMatrixNode, type JointChainConfig, type JointDynamicSystemConfig, type JointDynamicsColliderHandle, type JointDynamicsFlatPlaneHandle, type JointDynamicsGrabberHandle, JointDynamicsModifier, JointDynamicsSystem, JointDynamicsSystemController, LIGHT_TYPE_DIRECTIONAL, LIGHT_TYPE_NONE, LIGHT_TYPE_POINT, LIGHT_TYPE_RECT, LIGHT_TYPE_SPOT, LambertMaterial, LengthNode, type LineCollisionResult, Log2Node, type LogMode, LogNode, LogicallyAndNode, LogicallyOrNode, MAX_CLUSTERED_LIGHTS, MAX_GERSTNER_WAVE_COUNT, MAX_MORPH_ATTRIBUTES, MAX_MORPH_TARGETS, MAX_TERRAIN_MIPMAP_LEVELS, MORPH_ATTRIBUTE_VECTOR_COUNT, MORPH_TARGET_COLOR, MORPH_TARGET_NORMAL, MORPH_TARGET_POSITION, MORPH_TARGET_TANGENT, MORPH_TARGET_TEX0, MORPH_TARGET_TEX1, MORPH_TARGET_TEX2, MORPH_TARGET_TEX3, MORPH_WEIGHTS_VECTOR_COUNT, MakeVectorNode, Material, MaterialBlueprintIR, type MaterialBlueprintIRBehaviors, type MaterialTextureInfo, MaterialVaryingFlags, MaxNode, Mesh, MeshMaterial, type MeshUpdateCallback, type Metadata, MinNode, MixNode, ModNode, type ModelFetchOptions, type ModelInfo, type MorphData, type MorphInfo, type MorphState, MorphTargetTrack, MultiChainSpringSystem, type MultiChainSpringSystemOptions, NamedObject, type NearestPointsResult, type NodeConnection, NodeEulerRotationTrack, type NodeIterateFunc, NodeRotationTrack, NodeScaleTrack, NodeTranslationTrack, NormalizeNode, NotEqualNode, type OIT, Octree, OctreeNode, OctreeNodeChunk, OctreePlacement, OrbitCameraController, type OrbitCameraControllerOptions, OrthoCamera, PBRBlockNode, PBRBluePrintMaterial, PBRMetallicRoughnessMaterial, type PBRReflectionMode, PBRSpecularGlossinessMaterial, type PCAGeometryCacheState, PCAGeometryCacheTrack, type PCAGeometryCacheTrackData, PannerNode, ParticleMaterial, ParticleSystem, PerlinNoise2DNode, PerspectiveCamera, type PhysicsCurves, type PickResult, type PickTarget, PixelNormalNode, PixelWorldPositionNode, type PlaneCollider, type PlaneCreationOptions, PlaneShape, type PlayAnimationOptions, type PointInit, PointLight, type PointR, type PointRW, type PointTransform, PostEffectLayer, PowNode, Primitive, ProjectionMatrixNode, type PropEdit, type PropertyAccessor, type PropertyAccessorOptions, type PropertySceneNodeOptions, type PropertyToType, PropertyTrack, type PropertyType, type PropertyValue, PunctualLight, QUEUE_OPAQUE, QUEUE_TRANSPARENT, RENDER_PASS_TYPE_DEPTH, RENDER_PASS_TYPE_LIGHT, RENDER_PASS_TYPE_OBJECT_COLOR, RENDER_PASS_TYPE_SHADOWMAP, type RGExecuteContext, type RGExecuteFn, type RGFramebufferDesc, RGHandle, RGHistoryResources, type RGPassBuilder, type RGResolvedSize, type RGResourceLifetime, type RGSizeMode, RGSubpass, type RGTextureAllocator, type RGTextureDesc, Radians2DegreesNode, RaycastVisitor, RectLight, ReflectNode, RefractNode, RenderContext, RenderGraph, RenderGraphExecutor, type RenderItemList, type RenderItemListBundle, type RenderItemListInfo, RenderPass, RenderQueue, type RenderQueueItem, type RenderQueueRef, RenderTarget, type ResolutionTransform, ResolveVertexNormalNode, ResolveVertexPositionNode, ResolveVertexTangentNode, ResourceManager, RotateAboutAxisNode, RuntimeScript, type RuntimeScriptArrayDeclaration, type RuntimeScriptArrayElementDeclaration, type RuntimeScriptConfig, type RuntimeScriptObjectDeclaration, type RuntimeScriptObjectFieldDeclaration, type RuntimeScriptPropertyDeclaration, type RuntimeScriptPropertyInfo, type RuntimeScriptPropertyOptions, type RuntimeScriptPropertyType, type RuntimeScriptValueDeclaration, type RuntimeScriptValueType, SAO, type SamplerType, SaturateNode, Scene, SceneNode, type SceneNodeVisible, ScreenAdapter, type ScreenConfig, ScreenRenderTarget, type ScreenScaleMode, ScriptAttachment, type ScriptAttachmentConfig, ScriptRegistry, ScriptingSystem, type ScriptingSystemOptions, SelectionNode, type SerializableClass, ShaderHelper, ShadowMapPass, ShadowMapper, type ShadowMode, type ShadowQualityPreset, Shape, type ShapeCreationOptions, type ShapeOptionType, type ShapeType, SharedModel, SignNode, SimplexNoise2DNode, type SimulationParams, SinHNode, SinNode, Skeleton, SkeletonModifier, type SkinnedBoundingBox, SkyEnvTextureNode, SkyRenderer, type SkyType, SmoothStepNode, type SphereCollider, type SphereCreationOptions, SphereShape, SpotLight, SpringChain, type SpringCollider, type SpringConstraint, SpringModifier, type SpringParticle, SpringSystem, type SpringSystemOptions, Sprite, SpriteBlockNode, SpriteBlueprintMaterial, SpriteMaterial, SqrtNode, StandardSpriteMaterial, StepNode, type StopAnimationOptions, type SurfaceCheckResult, SwizzleNode, TanHNode, TanNode, type TerrainDebugMode, type TetrahedronCreationOptions, TetrahedronFrameShape, TetrahedronShape, type TextureFetchOptions, type TextureMixinInstanceTypes, type TextureMixinTypes, type TextureProp, type TexturePropUniforms, TextureSampleGrad, TextureSampleNode, type ToMixedTextureType, Tonemap, type TorusCreationOptions, TorusShape, type TransformAccess, TransformNode, type TwistConstraint, TwoBoneIKSolver, UnlitMaterial, VertexBinormalNode, VertexBlockNode, VertexColorNode, VertexNormalNode, VertexPositionNode, VertexTangentNode, VertexUVNode, ViewMatrixNode, ViewProjMatrixNode, type Visitor, Water, type WaveGenerator, WeightedBlendedOIT, applyAngleLimits, applyMaterialMixins, applyResult, applyRuntimeScriptConfig, buildConstraints, buildForwardPlusGraph, buildSurfaceFaces, checkSurfaceCollision, collisionDetection, collisionDetectionCapsule, collisionDetectionSphere, computeMaxDepth, computeNearestPoints, createCapsuleCollider, createGPUClothWrapBindingData, createGeometryCacheState, createPlaneCollider, createSphereCollider, createSpringConstraint, createSpringParticle, createTransformAccess, decode2HalfFromRGBA, decodeFloatFromRGBA, decodeNormalizedFloatFromRGBA, decodeRGBM, defineProps, encode2HalfToRGBA, encodeFloatToRGBA, encodeNormalizedFloatToRGBA, encodeRGBM, ensureGeometryCacheMeshBinding, executeForwardPlusGraph, fetchSampler, gammaToLinear, getApp, getDevice, getEngine, getInput, getRuntimeScriptProperties, gradient, hash11, hash12, hash13, hash21, hash22, hash23, hash31, hash32, hash33, interleavedGradientNoise, isGPUClothSupported, linearToGamma, mixGeometryCacheBoundingBox, mixinAlbedoColor, mixinBlinnPhong, mixinFoliage, mixinLambert, mixinLight, mixinPBRBluePrint, mixinPBRCommon, mixinPBRMetallicRoughness, mixinPBRSpecularGlossness, mixinTextureProps, mixinVertexColor, noise3D, normalizeRuntimeScriptConfig, normalizeScriptAttachmentConfig, normalizeScriptAttachments, panoramaToCubemap, perlinNoise2D, perlinNoise3D, prefilterCubemap, pushInCollisionDetection, pushInFromCapsule, pushInFromCollider, pushInFromSphere, pushoutFromCapsule, pushoutFromCollider, pushoutFromSphere, resolveCapsuleCollision, resolvePlaneCollision, resolveSphereCollision, restoreGeometryCacheMeshBinding, scriptProp, simulate, smoothNoise3D, sortRootPointsByProximity, temporalResolve, tryGetApp, updateColliderFromNode, valueNoise, whiteNoise, worleyFBM, worleyNoise };