@hology/core 0.0.273 → 0.0.274

package/dist/rendering.d.ts

@@ -7,6 +7,8 @@ import { Camera, Object3D, WebGLRenderer, WebGLRenderTarget, Texture } from 'thr
 import { ShaderPass } from "three-stdlib";
 import { IRgbNode, RgbaNode } from 'three-shader-graph';
 import { CSM } from "three/examples/jsm/csm/CSM.js";
+import { type RenderingStatsStyle } from './utils/three/frame-stats.js';
+export type { RenderingStatsStyle } from './utils/three/frame-stats.js';
 import { GTAOPass } from "three/examples/jsm/postprocessing/GTAOPass.js";
 import { OutlinePass } from './utils/three/outline-pass.js';
 import { type PostProcessSettings, type PostProcessVolume } from "./gameplay/actors/builtin/post-process-volume-actor.js";
@@ -16,13 +18,13 @@ import { Cluster } from "./rendering/cluster-generator.js";
 import { LightVolume } from "./rendering/light-probes/light-volume-capture.js";
 import { type PostProcessMaterialSource } from "./shader/post-process-shader.js";
 import { type UpscalingOptions } from "./rendering/upscaling-pass.js";
-import { type AntiAliasingMode, type ExperimentalWebGpuPostProcessingOptions, type GTAOOptions, type GTAOQuality, type MotionBlurOptions, type MotionBlurOverride, type MotionBlurOverrideHandle, type RendererFrameProfile, type ExperimentalWebGpuRenderGraphExtension, type WebGpuPresentationExtension, type VolumetricFogOptions, type VolumetricFogQuality } from './rendering/webgpu-experimental-backend.js';
+import { type AntiAliasingMode, type ExperimentalWebGpuPostProcessingOptions, type GTAOOptions, type GTAOQuality, type MotionBlurOptions, type MotionBlurOverride, type MotionBlurOverrideHandle, type RendererFrameProfile, type ExperimentalWebGpuRenderGraphExtension, type WebGpuPresentationExtension, type RendererSceneCapture, type VolumetricFogOptions, type VolumetricFogQuality } from './rendering/webgpu-experimental-backend.js';
 import type { WorldEnvironmentState } from './rendering/environment.js';
 import type { VfxBackendPreference } from './effects/vfx/gpu-sprite-compiler.js';
 import { type GraphicsRuntime } from './rendering/graphics-runtime.js';
 export { GraphicsRuntime } from './rendering/graphics-runtime.js';
 export type { UpscalingOptions } from "./rendering/upscaling-pass.js";
-export type { AntiAliasingMode, ExperimentalWebGpuPostProcessingOptions, ExperimentalWebGpuRenderGraphExtension, WebGpuPresentationExtension, WebGpuPresentationExtensionContext } from './rendering/webgpu-experimental-backend.js';
+export type { AntiAliasingMode, ExperimentalWebGpuPostProcessingOptions, ExperimentalWebGpuRenderGraphExtension, WebGpuPresentationExtension, WebGpuPresentationExtensionContext, RendererSceneCapture, RendererSceneCaptureOptions, RendererSceneCapturePostProcessContext } from './rendering/webgpu-experimental-backend.js';
 export type { GTAOOptions, GTAOQuality, MotionBlurOptions, MotionBlurOverride, MotionBlurOverrideHandle, VolumetricFogOptions, VolumetricFogQuality } from './rendering/webgpu-experimental-backend.js';
 /** Renderer requested by a view. `webgpu-experimental` is a deprecated alias. */
 export type RenderingBackend = 'webgl' | 'webgpu' | 'webgpu-experimental';
@@ -72,6 +74,8 @@ export type DynamicResolutionOptions = {
 export type RenderingViewOptions = {
     /** Shared device/backend/cache owner. Views in one application should use the same instance. */
     graphicsRuntime?: GraphicsRuntime;
+    /** Defaults to detailed. Simple shows FPS/frame interval without enabling GPU profiling. */
+    statsStyle?: RenderingStatsStyle;
     /** Retain an unused WebGPU backend briefly for fast scene tab reopening. Defaults to 0. */
     webGpuBackendIdleRetentionMs?: number;
     backend?: RenderingBackend;
@@ -147,6 +151,10 @@ export declare class RenderingView {
     private outlinesEnabled;
     private selectedOutlineObjects;
     private experimentalStaticDrawSetRegistrations;
+    private readonly staticSpatialObjects;
+    /** Register a static render subtree while preserving authored object identity. */
+    registerStaticSpatialObject(root: THREE.Object3D): () => void;
+    refreshStaticSpatialObjects(root: THREE.Object3D, editing?: boolean): void;
     private experimentalWebGpuRenderGraphExtensions;
     private webGpuPresentationExtensions;
     private worldEnvironment;
@@ -320,6 +328,8 @@ export declare class RenderingView {
     setEnableOutlines(enabled: boolean): void;
     registerWebGpuPresentationExtension(extension: WebGpuPresentationExtension): () => void;
     get sharedGraphicsRuntime(): GraphicsRuntime;
+    /** Independent camera capture. Pass null for a persistent sampleable texture output. */
+    createSceneCapture(canvas: HTMLCanvasElement | null, width?: number, height?: number): RendererSceneCapture;
     setCamera(camera: Camera): void;
     setSelectedObjects(obj: Object3D[]): void;
     setExperimentalWebGpuTiledLightingEnabled(enabled: boolean): void;
@@ -372,12 +382,17 @@ export declare class RenderingView {
     removeOnLoop(onFrame: (deltaTime: number) => any): void;
     private stats;
     private readonly webGpuPassStatsDom;
+    private readonly webGpuResolutionStatsDom;
     private readonly webGpuVisibilityStatsDom;
     private webGpuPassStatsRows;
     private _showStats;
     private _profilingEnabled;
     set showStats(value: boolean);
     get showStats(): boolean;
+    /** Simple is intended for players; detailed retains engine diagnostics and GPU timings. */
+    set statsStyle(value: RenderingStatsStyle);
+    get statsStyle(): RenderingStatsStyle;
+    private get detailedStatsEnabled();
     /** Latest renderer profile. Profiling data is only collected when explicitly enabled. */
     getLastFrameProfile(): RendererFrameProfile | null;
     /** Collect renderer timings without showing the built-in renderer panels. */