@needle-tools/engine 4.16.1-next.e45724f → 4.16.2

package/plugins/vite/index.d.ts

@@ -1,29 +1,3 @@
-export { needleAI } from "./ai.js";
-export { needleAsap } from "./asap.js";
-export { needleDefines } from "./defines.js";
-export { needleBuildPipeline } from "./build-pipeline.js";
-export { needleBuild } from "./build.js";
-export { needleMeta } from "./meta.js";
-export { needlePoster } from "./poster.js";
-export { needlePWA } from "./pwa.js";
-export { needleReload } from "./reload.js";
-export { needleDrop } from "./drop.js";
-export { editorConnection } from "./editor-connection.js";
-export { needleCopyFiles } from "./copyfiles.js";
-export { needleViteAlias } from "./alias.js";
-export { needleCustomElementData } from "./custom-element-data.js";
-export { needleTransformCodegen } from "./transform-codegen.js";
-export { needleLicense } from "./license.js";
-export { needlePeerjs } from "./peer.js";
-export { needleDependencyWatcher } from "./dependency-watcher.js";
-export { needleDependencies } from "./dependencies.js";
-export { needleFacebookInstantGames } from "./facebook-instant-games.js";
-export { needleImportsLogger } from "./imports-logger.js";
-export { needleBuildInfo } from "./buildinfo.js";
-export { needleApp } from "./needle-app.js";
-export { needleServer } from "./server.js";
-export * from "./gzip.js";
-export * from "./config.js";
 /** # Needle Engine plugins for Vite
  * Plugins include hot reload support, meta tags, defines, build pipeline, PWA, and more.
  * ## Using PWA
@@ -50,5 +24,31 @@ export * from "./config.js";
  * @param {import('../types/index.js').userSettings} [userSettings]
  * @returns {Promise<import('vite').Plugin[]>}
  */
-export const needlePlugins: any;
+export function needlePlugins(command: "build" | "serve", config?: import("../types/needleConfig").needleMeta | null | undefined, userSettings?: import("../types/index.js").userSettings): Promise<import("vite").Plugin[]>;
+export { needleAI } from "./ai.js";
+export { needleAsap } from "./asap.js";
+export { needleDefines } from "./defines.js";
+export { needleBuildPipeline } from "./build-pipeline.js";
+export { needleBuild } from "./build.js";
+export { needleMeta } from "./meta.js";
+export { needlePoster } from "./poster.js";
+export { needlePWA } from "./pwa.js";
+export { needleReload } from "./reload.js";
+export { needleDrop } from "./drop.js";
+export { editorConnection } from "./editor-connection.js";
+export { needleCopyFiles } from "./copyfiles.js";
+export { needleViteAlias } from "./alias.js";
+export { needleCustomElementData } from "./custom-element-data.js";
+export { needleTransformCodegen } from "./transform-codegen.js";
+export { needleLicense } from "./license.js";
+export { needlePeerjs } from "./peer.js";
+export { needleDependencyWatcher } from "./dependency-watcher.js";
+export { needleDependencies } from "./dependencies.js";
+export { needleFacebookInstantGames } from "./facebook-instant-games.js";
+export { needleImportsLogger } from "./imports-logger.js";
+export { needleBuildInfo } from "./buildinfo.js";
+export { needleApp } from "./needle-app.js";
+export { needleServer } from "./server.js";
+export * from "./gzip.js";
+export * from "./config.js";
 export { needleMakeFilesLocal, needleLocalFilesSceneAnalysis } from "./local-files.js";

package/plugins/vite/index.js

@@ -115,7 +115,7 @@ const defaultUserSettings = {
  * @param {import('../types/index.js').userSettings} [userSettings]
  * @returns {Promise<import('vite').Plugin[]>}
  */
-export const needlePlugins = async (command, config = undefined, userSettings = {}) => {
+export async function needlePlugins(command, config = undefined, userSettings = {}) {
 
     if (!config) config = {}
 

package/plugins/vite/license.d.ts

@@ -1 +1,7 @@
+/** This plugin is used to apply the license to the needle engine.
+ * @param {"build" | "serve"} command
+ * @param {import('../types/needleConfig').needleMeta | null | undefined} config
+ * @param {import('../types/userconfig.js').userSettings} userSettings
+ * @returns {import('vite').Plugin}
+ */
 export function needleLicense(command: "build" | "serve", config: import("../types/needleConfig").needleMeta | null | undefined, userSettings: import("../types/userconfig.js").userSettings): import("vite").Plugin;

package/plugins/vite/license.js

@@ -7,7 +7,7 @@ import { loadConfig } from './config.js';
  * @param {import('../types/userconfig.js').userSettings} userSettings
  * @returns {import('vite').Plugin}
  */
-export const needleLicense = (command, config, userSettings) => {
+export function needleLicense(command, config, userSettings) {
     let license = undefined;
 
     return {
@@ -53,4 +53,4 @@ export const needleLicense = (command, config, userSettings) => {
             }
         }
     }
-};
+}

package/plugins/vite/local-files-core.d.ts

@@ -1,3 +1,10 @@
+/**
+ * @param {"build" | "serve"} command
+ * @param {unknown} _config
+ * @param {import('../types').userSettings} userSettings
+ * @returns {import('vite').Plugin | null}
+ */
+export function needleMakeFilesLocal(command: "build" | "serve", _config: unknown, userSettings: import("../types").userSettings): import("vite").Plugin | null;
 /**
  * @param {LocalizationOptions} options
  * @param {AutoPolicy | null} autoPolicy
@@ -36,7 +43,6 @@ export function getFeatureBasePath(basePath: string, feature: string): string;
  */
 export function handleWebXRProfiles(baseUrl: string, basePath: string, currentDir: string, context: LocalizationContext): Promise<string>;
 export { makeFilesLocalIsEnabled };
-export function needleMakeFilesLocal(command: "build" | "serve", _config: unknown, userSettings: import("../types").userSettings): import("vite").Plugin | null;
 export type LocalizationContext = import("./local-files-types.js").LocalizationContext;
 export type LocalizationOptions = import("./local-files-types.js").LocalizationOptions;
 export type LocalizationStats = import("./local-files-types.js").LocalizationStats;

package/plugins/vite/local-files-core.js

@@ -213,7 +213,7 @@ function recordLocalizedAsset(stats, url, sizeBytes, mimeType) {
  * @param {import('../types').userSettings} userSettings
  * @returns {import('vite').Plugin | null}
  */
-export const needleMakeFilesLocal = (command, _config, userSettings) => {
+export function needleMakeFilesLocal(command, _config, userSettings) {
     if (!makeFilesLocalIsEnabled(userSettings)) {
         return null;
     }
@@ -373,7 +373,7 @@ export const needleMakeFilesLocal = (command, _config, userSettings) => {
         }
     });
     return plugin;
-};
+}
 
 /**
  * @param {LocalizationOptions} options

package/plugins/vite/local-files-internals.d.ts

@@ -0,0 +1,3 @@
+export { getActiveHandlers, getFeatureBasePath, handleWebXRProfiles, makeLocal, makeLocalHtml } from "./local-files-core.js";
+export { analyzeProjectGlbs, buildAutoPolicy, collectAssetGlbs, collectIndexHtmlSkyboxUrls, collectNeedleComponentExtensionBlobs, detectAutoPolicy, getWebXRProfilesForMode, hasAutoFeatureSelection, readGlbJsonChunk, resolveSkyboxSelectionUrls, resolveSkyboxValueToUrl, shouldHandleUrlInAutoMode } from "./local-files-analysis.js";
+export { fixDracoRangeQueryProbe, fixRelativeNewURL, getRelativeToBasePath } from "./local-files-utils.js";

package/plugins/vite/logger.d.ts

@@ -1 +1,8 @@
+/**
+ * write logs to local file
+ * @param {string} command
+ * @param {unknown} _config
+ * @param {import('../types/userconfig.js').userSettings} userSettings
+ * @returns {import('vite').Plugin | null}
+ */
 export function needleLogger(command: string, _config: unknown, userSettings: import("../types/userconfig.js").userSettings): import("vite").Plugin | null;

package/plugins/vite/logger.js

@@ -15,7 +15,7 @@ const __dirname = path.dirname(__filename);
  * @param {import('../types/userconfig.js').userSettings} userSettings
  * @returns {import('vite').Plugin | null}
  */
-export const needleLogger = (command, _config, userSettings) => {
+export function needleLogger(command, _config, userSettings) {
 
     if (userSettings?.disableLogging === true) {
         return null;

package/plugins/vite/meta.d.ts

@@ -1 +1,7 @@
+/**
+ * @param {"build" | "serve"} command
+ * @param {import('../types/needleConfig').needleMeta | null} config
+ * @param {import('../types').userSettings} userSettings
+ * @returns {import('vite').Plugin}
+ */
 export function needleMeta(command: "build" | "serve", config: import("../types/needleConfig").needleMeta | null, userSettings: import("../types").userSettings): import("vite").Plugin;

package/plugins/vite/meta.js

@@ -11,7 +11,7 @@ import { needleGreenBold, needleLog } from './logging.js';
  * @param {import('../types').userSettings} userSettings
  * @returns {import('vite').Plugin}
  */
-export const needleMeta = (command, config, userSettings) => {
+export function needleMeta(command, config, userSettings) {
 
     // we can check if this is a build
     const isBuild = command === 'build';

package/plugins/vite/needle-app.d.ts

@@ -1 +1,7 @@
+/**
+ * @param {'serve' | 'build'} command
+ * @param {{} | undefined | null} config
+ * @param {import('../types').userSettings} userSettings
+ * @returns {import('vite').Plugin[] | null}
+ */
 export function needleApp(command: "serve" | "build", config: {} | undefined | null, userSettings: import("../types").userSettings): import("vite").Plugin[] | null;

package/plugins/vite/needle-app.js

@@ -10,7 +10,7 @@ import { needleLog } from './logging.js';
  * @param {import('../types').userSettings} userSettings
  * @returns {import('vite').Plugin[] | null}
  */
-export const needleApp = (command, config, userSettings) => {
+export function needleApp(command, config, userSettings) {
 
     if (command !== "build") {
         return null;

package/plugins/vite/npm.d.ts

@@ -1 +1,4 @@
+/**
+ * @param {import('../types').userSettings} userSettings
+ */
 export function needleNPM(command: any, config: any, userSettings: import("../types").userSettings): void;

package/plugins/vite/npm.js

@@ -3,6 +3,6 @@ import { ensureNpmDirectoryExists } from '../common/npm.js';
 /**
  * @param {import('../types').userSettings} userSettings
  */
-export const needleNPM = (command, config, userSettings) => {
+export function needleNPM(command, config, userSettings) {
     ensureNpmDirectoryExists();
 }

package/plugins/vite/peer.d.ts

@@ -1 +1,7 @@
+/**
+ * @param {"build" | "serve"} command
+ * @param {import('../types/needleConfig').needleMeta | null | undefined} config
+ * @param {import('../types').userSettings} userSettings
+ * @returns {import("vite").Plugin | undefined}
+ */
 export function needlePeerjs(command: "build" | "serve", config: import("../types/needleConfig").needleMeta | null | undefined, userSettings: import("../types").userSettings): import("vite").Plugin | undefined;

package/plugins/vite/peer.js

@@ -7,7 +7,7 @@ import { needleLog } from './logging.js';
  * @param {import('../types').userSettings} userSettings
  * @returns {import("vite").Plugin | undefined}
  */
-export const needlePeerjs = (command, config, userSettings) => {
+export function needlePeerjs(command, config, userSettings) {
 
     if (userSettings.noPeer === true) return;
 

package/plugins/vite/poster-client.d.ts

@@ -0,0 +1 @@
+export {};

package/plugins/vite/poster.d.ts

@@ -1,2 +1,8 @@
 export function getPosterPath(): string;
+/**
+ * @param {"build" | "serve"} command
+ * @param {import('../types/needleConfig').needleMeta | null | undefined} config
+ * @param {import('../types').userSettings} userSettings
+ * @returns {import('vite').Plugin | undefined}
+ */
 export function needlePoster(command: "build" | "serve", config: import("../types/needleConfig").needleMeta | null | undefined, userSettings: import("../types").userSettings): import("vite").Plugin | undefined;

package/plugins/vite/poster.js

@@ -15,7 +15,7 @@ export function getPosterPath() {
  * @param {import('../types').userSettings} userSettings
  * @returns {import('vite').Plugin | undefined}
  */
-export const needlePoster = (command, config, userSettings) => {
+export function needlePoster(command, config, userSettings) {
     // only relevant for local development
     if (command === 'build') return [];
 
@@ -79,4 +79,4 @@ export const needlePoster = (command, config, userSettings) => {
             },
         },
     }
-};
+}

package/plugins/vite/pwa.d.ts

@@ -1 +1,7 @@
+/** Provides reasonable defaults for a PWA manifest and workbox settings.
+ * @param {"build" | "serve"} command
+ * @param {import("../types/needleConfig").needleMeta | null} config
+ * @param {import('../types').userSettings} userSettings
+ * @returns {import('vite').Plugin | undefined}
+ */
 export function needlePWA(command: "build" | "serve", config: import("../types/needleConfig").needleMeta | null, userSettings: import("../types").userSettings): import("vite").Plugin | undefined;

package/plugins/vite/pwa.js

@@ -13,7 +13,7 @@ const pwaErrorWithInstructions = "It seems that you're trying to build a PWA usi
  * @param {import('../types').userSettings} userSettings
  * @returns {import('vite').Plugin | undefined}
  */
-export const needlePWA = (command, config, userSettings) => {
+export function needlePWA(command, config, userSettings) {
     // @ts-ignore // TODO correctly type the userSettings.pwaOptions object
     /** @type {import("vite-plugin-pwa").VitePWAOptions | false} */
     const pwaOptions = userSettings.pwa === true

package/plugins/vite/reload-client.d.ts

@@ -0,0 +1 @@
+export {};

package/plugins/vite/reload.d.ts

@@ -1 +1,7 @@
+/**
+ * @param {"build" | "serve"} command
+ * @param {import('../types/needleConfig').needleMeta | null} config
+ * @param {import('../types').userSettings} userSettings
+ * @returns {import('vite').Plugin | undefined}
+ */
 export function needleReload(command: "build" | "serve", config: import("../types/needleConfig").needleMeta | null, userSettings: import("../types").userSettings): import("vite").Plugin | undefined;

package/plugins/vite/reload.js

@@ -20,7 +20,7 @@ let assetsDirectory = "";
  * @param {import('../types').userSettings} userSettings
  * @returns {import('vite').Plugin | undefined}
  */
-export const needleReload = (command, config, userSettings) => {
+export function needleReload(command, config, userSettings) {
     if (command === "build") return undefined;
 
     if (userSettings?.noReload === true) return undefined;

package/plugins/vite/server.d.ts

@@ -1 +1,7 @@
+/** Can open the network server in the browser.
+ * @param {"build" | "serve"} command
+ * @param {import('../types').needleMeta | null} config
+ * @param {import('../types').userSettings} userSettings
+ * @returns {import('vite').Plugin}
+ */
 export function needleServer(command: "build" | "serve", config: import("../types").needleMeta | null, userSettings: import("../types").userSettings): import("vite").Plugin;

package/plugins/vite/server.js

@@ -4,7 +4,7 @@
  * @param {import('../types').userSettings} userSettings
  * @returns {import('vite').Plugin}
  */
-export const needleServer = (command, config, userSettings) => {
+export function needleServer(command, config, userSettings) {
 
     const shouldOpenBrowser = userSettings.openBrowser === true;
 
@@ -64,4 +64,4 @@ export const needleServer = (command, config, userSettings) => {
             }
         },
     }
-};
+}

package/plugins/vite/transform-codegen.d.ts

@@ -1 +1,8 @@
+/** Modify the glb load path in codegen files.
+ * This is necessary if the assets directory is not the default (changed by the user in needle.config.json).
+ * @param {"build" | "serve"} command
+ * @param {import('../types/needleConfig').needleMeta | null | undefined} config
+ * @param {import('../types').userSettings} userSettings
+ * @returns {import('vite').Plugin | undefined}
+ */
 export function needleTransformCodegen(command: "build" | "serve", config: import("../types/needleConfig").needleMeta | null | undefined, userSettings: import("../types").userSettings): import("vite").Plugin | undefined;

package/plugins/vite/transform-codegen.js

@@ -7,7 +7,7 @@ import { builtAssetsDirectory, tryLoadProjectConfig } from './config.js';
  * @param {import('../types').userSettings} userSettings
  * @returns {import('vite').Plugin | undefined}
  */
-export const needleTransformCodegen = (command, config, userSettings) => {
+export function needleTransformCodegen(command, config, userSettings) {
 
     if (config?.noCodegenTransform === true || userSettings?.noCodegenTransform === true) {
         return;

package/plugins/vite/transform.d.ts

@@ -1 +1,5 @@
+/**
+ * @param {import('../types').userSettings} userSettings
+ * @returns {import('vite').Plugin[]}
+ */
 export function needleTransformCode(command: any, config: any, userSettings: import("../types").userSettings): import("vite").Plugin[];

package/plugins/vite/transform.js

@@ -5,7 +5,7 @@
  * @param {import('../types').userSettings} userSettings
  * @returns {import('vite').Plugin[]}
  */
-export const needleTransformCode = (command, config, userSettings) => {
+export function needleTransformCode(command, config, userSettings) {
 
     return [
         {

package/plugins/vite/vite-4.4-hack.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Make sure we dont have vite 4.4.x installed when needle engine is used locally
+ * @param {import('../types').userSettings} userSettings
+ */
 export function vite_4_4_hack(command: any, config: any, userSettings: import("../types").userSettings): {
     name: string;
     configureServer(server: any): Promise<void>;

package/plugins/vite/vite-4.4-hack.js

@@ -6,7 +6,7 @@ import { execSync } from 'child_process';
  * Make sure we dont have vite 4.4.x installed when needle engine is used locally
  * @param {import('../types').userSettings} userSettings
  */
-export const vite_4_4_hack = (command, config, userSettings) => {
+export function vite_4_4_hack(command, config, userSettings) {
     if (userSettings.vite44Hack === false) return;
     return {
         name: "needle-vite-4.4-hack",

package/src/engine-components/EventType.ts

@@ -8,16 +8,17 @@ export enum EventType {
     PointerDown = 2,
     PointerUp = 3,
     PointerClick = 4,
-    Drag = 5,
-    Drop = 6,
-    Scroll = 7,
-    UpdateSelected = 8,
-    Select = 9,
-    Deselect = 10,
-    Move = 11,
-    InitializePotentialDrag = 12,
-    BeginDrag = 13,
-    EndDrag = 14,
-    Submit = 15,
-    Cancel = 16
+    // Unity Events, not currently supported:
+    //Drag = 5,
+    //Drop = 6,
+    //Scroll = 7,
+    //UpdateSelected = 8,
+    //Select = 9,
+    //Deselect = 10,
+    //Move = 11,
+    //InitializePotentialDrag = 12,
+    //BeginDrag = 13,
+    //EndDrag = 14,
+    //Submit = 15,
+    //Cancel = 16
 }

package/src/engine-components/ReflectionProbe.ts

@@ -1,19 +1,21 @@
 import { Box3, Color, CubeTexture, EquirectangularReflectionMapping, LinearSRGBColorSpace, LineSegments, Material, Object3D, Quaternion, Texture, Vector3 } from "three";
 
+import { CreateWireCube } from "../engine/engine_gizmos.js";
 import { MaterialPropertyBlock } from "../engine/engine_materialpropertyblock.js";
 import { loadPMREM } from "../engine/engine_pmrem.js";
 import { serializable } from "../engine/engine_serialization.js";
 import { Context } from "../engine/engine_setup.js";
+import { getBoundingBox, getWorldPosition } from "../engine/engine_three_utils.js";
 import { getParam, resolveUrl } from "../engine/engine_utils.js";
-import { BoxHelperComponent } from "./BoxHelperComponent.js";
 import { Behaviour } from "./Component.js";
 import { EventList } from "./EventList.js";
-import { getBoundingBox, getWorldPosition } from "../engine/engine_three_utils.js";
-import { CreateWireCube } from "../engine/engine_gizmos.js";
 
 export const debug = getParam("debugreflectionprobe");
 const disable = getParam("noreflectionprobe");
 
+let box: Box3 | null = null;
+const _identityRotation = new Quaternion();
+
 const $reflectionProbeKey = Symbol("reflectionProbeKey");
 /**
  * The [ReflectionProbe](https://engine.needle.tools/docs/api/ReflectionProbe) provides environment reflection data to materials within its defined area.
@@ -42,13 +44,11 @@ const $reflectionProbeKey = Symbol("reflectionProbeKey");
 export class ReflectionProbe extends Behaviour {
 
     private static _probes: Map<Context, ReflectionProbe[]> = new Map();
-    /** The bounding box for this component */
-    private box: Box3 | null = null;
     private static testBox: Box3 = new Box3();
-    private static _identityRotation: Quaternion = new Quaternion();
 
     /**
-     * Checks if the given material is currently using a reflection probe. This is determined by checking for an override on the material's "envMap" property, which is set by the Renderer component when applying a reflection probe.
+     * Checks if the given material is currently using a reflection probe.  
+     * This is determined by checking for an override on the material's "envMap" property, which is set by the Renderer component when applying a reflection probe.
      */
     static isUsingReflectionProbe(material: Material) {
         return !!(material as any)[$reflectionProbeKey];
@@ -106,14 +106,17 @@ export class ReflectionProbe extends Behaviour {
     private _textureUrlInFlight?: string;
 
     /**
-     * The cubemap or HDR texture used for reflections. Can be assigned directly or via a URL string. When assigning via URL, the texture will be loaded asynchronously and applied once ready.
+     * The cubemap or HDR texture used for reflections. Can be assigned directly or via a URL string.   
+     * When assigning via URL, the texture will be loaded asynchronously and applied once ready.
+     * @param tex The texture or URL to assign to this reflection probe
+     * @default null
      */
     @serializable([Texture, String])
     set texture(tex: Texture | null) {
         if (this._texture === tex) return;
 
         if (typeof tex === "string") {
-            if(debug) console.debug(`[ReflectionProbe] Loading reflection probe texture from URL: ${tex}`);
+            if (debug) console.debug(`[ReflectionProbe] Loading reflection probe texture from URL: ${tex}`);
             this._textureUrlInFlight = tex;
             const textureUrl = resolveUrl(this.sourceId, tex);
             loadPMREM(textureUrl, this.context.renderer).then(loaded => {
@@ -129,7 +132,7 @@ export class ReflectionProbe extends Behaviour {
         // During deserialization / loading of the GLB the deserializer sets an empty DataTexture 
         // But if the texture is serialized as a string (via Blender Reflection Probes) then the async loading above
         // Will abort IF textureInFlight is reset (here). That's why we do NOT reset textureInFlight during initialization (when __didAwake is false). Only after awake, when we are sure that the async loading is done, we reset the in-flight URL to allow new assignments.
-        if(this.__didAwake) this._textureUrlInFlight = undefined;
+        if (this.__didAwake) this._textureUrlInFlight = undefined;
 
         this._texture = tex;
 
@@ -149,17 +152,26 @@ export class ReflectionProbe extends Behaviour {
         return this._texture;
     }
 
+    /**
+     * The intensity of the reflection probe's influence.  
+     *  Higher values will make reflections brighter, while lower values will make them dimmer.  
+     * The default value is 1, which means the reflections will be applied at their original brightness. Adjust this value to achieve the desired look for your scene.
+     * @default 1
+     */
     @serializable()
     intensity: number = 1;
 
     /**
-     * Defines the center and size of the reflection probe's influence area.
+     * Defines the center of the reflection probe's influence area relative to the GameObject's position.   
+     * The probe will affect objects within a box defined by this center and the `size` property.  
+     * Note: The actual influence area is determined by both the `center` and `size` properties. The `center` defines the offset from the GameObject's position, while the `size` defines the dimensions of the box around that center. Objects within this box will be influenced by the reflection probe.
      */
     @serializable(Vector3)
     center: Vector3 = new Vector3();
 
     /**
-     * Defines the size of the reflection probe's influence area. Objects within this box will be affected by the probe's reflections.
+     * Defines the size of the reflection probe's influence area. Objects within this box will be affected by the probe's reflections.  
+     * Note: The actual influence area is determined by both the `center` and `size` properties. The `center` defines the offset from the GameObject's position, while the `size` defines the dimensions of the box around that center. Objects within this box will be influenced by the reflection probe.
      */
     @serializable(Vector3)
     size: Vector3 = new Vector3(1, 1, 1);
@@ -172,16 +184,16 @@ export class ReflectionProbe extends Behaviour {
 
     private isInBox(obj: Object3D) {
 
-        this.box ??= new Box3();
-        this.box!.setFromCenterAndSize(this.gameObject.worldPosition.add(this.center), this.gameObject.worldScale.multiply(this.size));
+        box ??= new Box3();
+        box!.setFromCenterAndSize(this.gameObject.worldPosition.add(this.center), this.gameObject.worldScale.multiply(this.size));
 
         getBoundingBox([obj], undefined, undefined, ReflectionProbe.testBox);
 
         if (ReflectionProbe.testBox.isEmpty()) {
-            return this.box.containsPoint(obj.worldPosition);
+            return box.containsPoint(obj.worldPosition);
         }
         else {
-            return this.box?.intersectsBox(ReflectionProbe.testBox);
+            return box?.intersectsBox(ReflectionProbe.testBox);
         }
     }
 
@@ -215,7 +227,7 @@ export class ReflectionProbe extends Behaviour {
         if (this._gizmo) {
             if (this.center) this._gizmo.position.copy(this.center);
             if (this.size) this._gizmo.scale.copy(this.size);
-            this._gizmo.worldQuaternion = ReflectionProbe._identityRotation;
+            this._gizmo.worldQuaternion = _identityRotation.identity();
         }
     }
 
@@ -248,7 +260,10 @@ export class ReflectionProbe extends Behaviour {
     }
 
     /**
-     * Applies this reflection probe to the given object by setting material property overrides for "envMap", "envMapRotation", and "envMapIntensity". This is typically called by the Renderer component when determining which reflection probe to use for a given object.
+     * Applies this reflection probe to the given object by setting material property overrides for "envMap", "envMapRotation", and "envMapIntensity".   
+     * This is typically called by the Renderer component when determining which reflection probe to use for a given object.
+     * @param object The object to apply the reflection probe to
+     * @see {@link unapply} for the corresponding method to remove the probe's influence from an object.
      */
     apply(object: Object3D) {
         if (disable) return;
@@ -267,7 +282,10 @@ export class ReflectionProbe extends Behaviour {
     }
 
     /**
-     * Removes the reflection probe overrides from the given object. This is typically called by the Renderer component when an object is no longer influenced by this probe or when the probe is disabled.
+     * Removes the reflection probe overrides from the given object.   
+     * This is typically called by the Renderer component when an object is no longer influenced by this probe or when the probe is disabled.
+     * @param object The object to remove the reflection probe overrides from
+     * @see {@link apply} for the corresponding method to apply the probe's influence to an object.
      */
     unapply(obj: Object3D) {
         const block = MaterialPropertyBlock.get(obj);