illutions 0.21.9 → 0.22.1

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.22.1
+
+### Added
+
+- Added `cfg.render.params` for renderer-specific runtime parameters.
+- Added `render.api` output to the infobox.
+- Added `.blend` source files to the public example apps.
+
+### Changed
+
+- Renamed `cfg.webgl` and `cfg.webgpu` parameter groups to `params`.
+
+## 0.22.0
+
+### Changed
+
+- Updated the framework to Three.js r185.
+- Changed the default renderer selection to `render.api = 'auto'`.
+- Added `envCtrls.dataType` to configure environment texture data handling.
+- Replaced `SsrWebGpuCfg.opacity` with `SsrWebGpuCfg.intensity`.
+
+### Fixed
+
+- Clarified the WebGL/WebGPU renderer switch behavior.
+- Enabled WebGPU renderer loading even when post-processing is disabled.
+
 ## 0.21.9
 
 ### Changed

package/dist/main.d.ts

@@ -1,10 +1,13 @@
 import { AnyEventObject } from 'xstate';
 import { AnyStateMachine } from 'xstate';
+import { ao } from 'three/addons/tsl/display/GTAONode.js';
+import { createBrowserInspector } from '@statelyai/inspect';
 import { default as default_2 } from 'three/addons/tsl/display/GTAONode.js';
 import { default as default_3 } from 'three/addons/tsl/display/SSRNode.js';
 import { DRACOLoader } from 'three/addons/loaders/DRACOLoader.js';
 import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
 import { EXRLoader } from 'three/addons/loaders/EXRLoader.js';
+import { FXAAShader } from 'three/addons/shaders/FXAAShader.js';
 import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
 import { HDRLoader } from 'three/addons/loaders/HDRLoader.js';
 import { KTX2Loader } from 'three/addons/loaders/KTX2Loader.js';
@@ -12,16 +15,21 @@ import { MeshoptDecoder } from 'three/addons/libs/meshopt_decoder.module.js';
 import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
 import { OrbitControls as OrbitControls_2 } from 'three/examples/jsm/controls/OrbitControls.js';
 import { OutputPass } from 'three/addons/postprocessing/OutputPass.js';
+import { Pane } from 'tweakpane';
 import { PointerLockControls } from 'three/addons/controls/PointerLockControls.js';
 import { PointerLockControls as PointerLockControls_2 } from 'three/examples/jsm/controls/PointerLockControls.js';
 import { ReflectorForSSRPass } from 'three/addons/objects/ReflectorForSSRPass.js';
 import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
 import { ShaderPass } from 'three/addons/postprocessing/ShaderPass.js';
+import { smaa } from 'three/addons/tsl/display/SMAANode.js';
+import { SMAAPass } from 'three/addons/postprocessing/SMAAPass.js';
 import { SSAOPass } from 'three/addons/postprocessing/SSAOPass.js';
+import { ssr } from 'three/addons/tsl/display/SSRNode.js';
 import { SSRPass } from 'three/addons/postprocessing/SSRPass.js';
 import type * as THREE_TYPE from 'three';
 import type * as THREE_WEBGPU_TYPE from 'three/webgpu';
 import type * as THREE_WEBTSL_TYPE from 'three/tsl';
+import { TierResult } from 'detect-gpu';
 
 /**
  * Defines the shared anti-aliasing settings.
@@ -500,6 +508,8 @@ export declare interface ClipFadeEvent {
     action?: THREE_TYPE.AnimationAction;
 }
 
+declare type ColorNode = THREE_WEBGPU_TYPE.Node<'vec4'>;
+
 /**
  * Represents a reusable web-component logic unit bound to a custom element that participates in the scene lifecycle.
  * @category Components
@@ -999,6 +1009,11 @@ export declare interface EnvCtrlsCfg {
      * @default 0
      */
     backgroundIntensity: number;
+    /**
+     * Specifies the texture data type used by EXR and HDR loaders.
+     * @default 'halfFloat'
+     */
+    dataType: 'halfFloat' | 'float';
     /**
      * Enables or disables environment and background map handling.
      * @default false
@@ -1249,6 +1264,8 @@ export declare interface FxaaCfg {
     sharpness: number;
 }
 
+declare type FXAAPostNode = (input: ColorNode) => ColorNode;
+
 /**
  * Defines the GUI elements for runtime information, controls and inspection.
  * @category Cfg
@@ -1547,17 +1564,17 @@ export declare interface ModelLoadingEvent {
 }
 
 declare class Modules {
-    gpuTier: any;
-    fxaaNode: any;
-    fxaaShader: any;
-    smaaPassClass: any;
-    smaaNode: any;
-    ssaoPassClass: any;
-    gtaoNodeClass: any;
-    ssrNode: any;
-    ssrPassClass: any;
-    paneClass: any;
-    createBrowserInspector: any;
+    gpuTier: TierResult | null;
+    fxaaNode: FXAAPostNode | null;
+    fxaaShader: typeof FXAAShader | null;
+    smaaPassClass: typeof SMAAPass | null;
+    smaaNode: typeof smaa | null;
+    ssaoPassClass: typeof SSAOPass | null;
+    gtaoNodeClass: typeof ao | null;
+    ssrNode: typeof ssr | null;
+    ssrPassClass: typeof SSRPass | null;
+    paneClass: typeof Pane | null;
+    createBrowserInspector: typeof createBrowserInspector | null;
     effectComposerClass: typeof EffectComposer | null;
     envLoader: EXRLoader | HDRLoader | null;
     dracoLoader: DRACOLoader | null;
@@ -1582,8 +1599,8 @@ declare class Modules {
     tslVec3: typeof THREE_WEBTSL_TYPE.vec3 | null;
     tslVec4: typeof THREE_WEBTSL_TYPE.vec4 | null;
     tslFloat: typeof THREE_WEBTSL_TYPE.float | null;
-    tslDirectionToColor: typeof THREE_WEBTSL_TYPE.directionToColor | null;
-    tslColorToDirection: typeof THREE_WEBTSL_TYPE.colorToDirection | null;
+    packNormalToRGB: typeof THREE_WEBTSL_TYPE.packNormalToRGB | null;
+    unpackRGBToNormal: typeof THREE_WEBTSL_TYPE.unpackRGBToNormal | null;
     private cfg;
     constructor(cfg: Cfg);
     private consoleLog;
@@ -2135,22 +2152,37 @@ export declare interface RenderCfg {
      */
     toneMappingExposure: number;
     /**
-     * WebGL renderer configuration.
+     * Parameters passed to both WebGL and WebGPU renderer constructors.
+     */
+    params: {
+        /**
+         * Whether the renderer canvas uses an alpha buffer.
+         * @default false
+         */
+        alpha: boolean;
+        /**
+         * Whether renderer-level anti-aliasing is enabled.
+         * @default false
+         */
+        aa: boolean;
+    };
+    /**
+     * WebGL-specific renderer configuration.
      */
     webgl: {
         /**
          * Parameters passed to `THREE.WebGLRenderer`.
          */
-        parameters: THREE_TYPE.WebGLRendererParameters;
+        params: THREE_TYPE.WebGLRendererParameters;
     };
     /**
-     * WebGPU renderer configuration.
+     * WebGPU-specific renderer configuration.
      */
     webgpu: {
         /**
          * Parameters passed to `THREE.WebGPURenderer`.
          */
-        parameters: WebGpuRendererParameters;
+        params: WebGpuRendererParameters;
     };
 }
 
@@ -2400,10 +2432,10 @@ export declare interface SsrWebGpuCfg {
      */
     maxDistance: number;
     /**
-     * Reflection opacity value.
+     * Reflection intensity value.
      * @default 0.5
      */
-    opacity: number;
+    intensity: number;
     /**
      * Ray thickness used for SSR intersection tests.
      * @default 0.018
@@ -2475,3 +2507,10 @@ export declare interface WindowResizeEvent {
 }
 
 export { }
+
+
+declare module 'three/addons/postprocessing/SSRPass.js' {
+    interface SSRPassParams {
+        bouncing?: boolean;
+    }
+}