@gnsx/three 0.184.17 → 0.184.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gnsx/three",
-  "version": "0.184.17",
+  "version": "0.184.19",
   "description": "JavaScript 3D library",
   "type": "module",
   "main": "./build/three.cjs",
@@ -108,7 +108,7 @@
     "jsdoc": "^4.0.5",
     "magic-string": "^0.30.0",
     "pngjs": "^7.0.0",
-    "puppeteer": "^24.40.0",
+    "puppeteer": "^25.1.0",
     "qunit": "^2.19.4",
     "rollup": "^4.6.0",
     "three": "file:.",

package/src/core/Object3D.js

@@ -290,6 +290,17 @@ class Object3D extends EventDispatcher {
 		 */
 		this.visible = true;
 
+		// WITH_GENESYS
+		/**
+		 * When set to `true`, this object itself is hidden.
+		 * Doesn't affect the visibility of the children.
+		 *
+		 * @type {boolean}
+		 * @default false
+		 */
+		this.selfHidden = false;
+		// !WITH_GENESYS
+
 		/**
 		 * When set to `true`, the 3D object gets rendered into shadow maps.
 		 *
@@ -1303,6 +1314,9 @@ class Object3D extends EventDispatcher {
 		if ( this.castShadow === true ) object.castShadow = true;
 		if ( this.receiveShadow === true ) object.receiveShadow = true;
 		if ( this.visible === false ) object.visible = false;
+		// WITH_GENESYS
+		if ( this.selfHidden === true ) object.selfHidden = true;
+		// !WITH_GENESYS
 		if ( this.frustumCulled === false ) object.frustumCulled = false;
 		if ( this.renderOrder !== 0 ) object.renderOrder = this.renderOrder;
 		if ( this.static !== false ) object.static = this.static;
@@ -1604,6 +1618,9 @@ class Object3D extends EventDispatcher {
 
 		this.layers.mask = source.layers.mask;
 		this.visible = source.visible;
+		// WITH_GENESYS
+		this.selfHidden = source.selfHidden;
+		// !WITH_GENESYS
 
 		this.castShadow = source.castShadow;
 		this.receiveShadow = source.receiveShadow;

package/src/loaders/ObjectLoader.js

@@ -1166,6 +1166,9 @@ class ObjectLoader extends Loader {
 		}
 
 		if ( data.visible !== undefined ) object.visible = data.visible;
+		// WITH_GENESYS
+		if ( data.selfHidden !== undefined ) object.selfHidden = data.selfHidden;
+		// !WITH_GENESYS
 		if ( data.frustumCulled !== undefined ) object.frustumCulled = data.frustumCulled;
 		if ( data.renderOrder !== undefined ) object.renderOrder = data.renderOrder;
 		if ( data.static !== undefined ) object.static = data.static;

package/src/profiler/ProfilerService.js

@@ -24,7 +24,7 @@ class ProfilerServiceClass {
 		this._profile = 'full';
 		this._enabled = false;
 
-		/** @type {Map<string, Float64Array>} */
+		/** @type {Map<string, Float64Array>} Inclusive time ring buffers (one per label). */
 		this.buffers = new Map();
 		/** @type {Map<string, number>} */
 		this.cursors = new Map();
@@ -37,6 +37,20 @@ class ProfilerServiceClass {
 		this.traceStartTime = 0;
 		this._markId = 0;
 
+		/** @type {Map<string, Float64Array>} Exclusive (self) time ring buffers (one per label). */
+		this.selfBuffers = new Map();
+		/** @type {Map<string, number>} */
+		this.selfCursors = new Map();
+		/** @type {Map<string, number>} */
+		this.selfCounts = new Map();
+		/**
+		 * Global call stack tracking nesting across all labels for exclusive-time computation.
+		 * @type {Array<{ label: string, childTime: number }>}
+		 */
+		this.callStack = [];
+		/** @type {Map<string, number>} Total (uncapped) invocation count since last reset, for calls-per-frame. */
+		this.invocations = new Map();
+
 		if ( this._enabled ) {
 
 			this.traceStartTime = performance.now();
@@ -143,6 +157,9 @@ class ProfilerServiceClass {
 		performance.mark( startMark );
 		stack.push( { startTime, startMark, traced } );
 
+		// Push onto the global call stack for exclusive-time tracking.
+		this.callStack.push( { label, childTime: 0 } );
+
 	}
 
 	/**
@@ -178,6 +195,42 @@ class ProfilerServiceClass {
 		this.cursors.set( label, ( cursor + 1 ) % RING_SIZE );
 		this.counts.set( label, Math.min( ( this.counts.get( label ) + 1 ), RING_SIZE ) );
 
+		// Track total invocations (uncapped) for calls-per-frame computation.
+		this.invocations.set( label, ( this.invocations.get( label ) ?? 0 ) + 1 );
+
+		// Exclusive (self) time via the global call stack.
+		const top = this.callStack.length > 0 ? this.callStack[ this.callStack.length - 1 ] : undefined;
+		if ( top !== undefined && top.label === label ) {
+
+			this.callStack.pop();
+			const selfTime = Math.max( 0, duration - top.childTime );
+
+			let selfBuffer = this.selfBuffers.get( label );
+			if ( ! selfBuffer ) {
+
+				selfBuffer = new Float64Array( RING_SIZE );
+				this.selfBuffers.set( label, selfBuffer );
+				this.selfCursors.set( label, 0 );
+				this.selfCounts.set( label, 0 );
+
+			}
+
+			const selfCursor = this.selfCursors.get( label );
+			selfBuffer[ selfCursor ] = selfTime;
+			this.selfCursors.set( label, ( selfCursor + 1 ) % RING_SIZE );
+			this.selfCounts.set( label, Math.min( ( this.selfCounts.get( label ) + 1 ), RING_SIZE ) );
+
+			// Propagate inclusive duration to the parent scope's child accumulator.
+			const parent = this.callStack.length > 0 ? this.callStack[ this.callStack.length - 1 ] : undefined;
+			if ( parent !== undefined ) parent.childTime += duration;
+
+		} else {
+
+			// Label mismatch — likely async interleaving. Reset to avoid corruption.
+			this.callStack.length = 0;
+
+		}
+
 		if ( traced ) {
 
 			this.traceEvents.push( {
@@ -220,6 +273,23 @@ class ProfilerServiceClass {
 		const sorted = [ ...samples ].sort( ( a, b ) => a - b );
 		const avg = sorted.reduce( ( a, b ) => a + b, 0 ) / sorted.length;
 
+		// Exclusive (self) time stats.
+		const selfCount = this.selfCounts.get( label ) ?? 0;
+		let selfAvg, selfMin, selfMax, selfP95, selfFrameBudget;
+		if ( selfCount > 0 ) {
+
+			const selfBuffer = this.selfBuffers.get( label );
+			const selfSamples = [ ...( selfCount < RING_SIZE
+				? selfBuffer.subarray( 0, selfCount )
+				: selfBuffer ) ].sort( ( a, b ) => a - b );
+			selfAvg = selfSamples.reduce( ( a, b ) => a + b, 0 ) / selfSamples.length;
+			selfMin = selfSamples[ 0 ];
+			selfMax = selfSamples[ selfSamples.length - 1 ];
+			selfP95 = selfSamples[ Math.floor( selfSamples.length * 0.95 ) ];
+			selfFrameBudget = ( selfAvg / FRAME_BUDGET_MS ) * 100;
+
+		}
+
 		return {
 			label,
 			samples: samples.length,
@@ -228,6 +298,12 @@ class ProfilerServiceClass {
 			max: sorted[ sorted.length - 1 ],
 			p95: sorted[ Math.floor( sorted.length * 0.95 ) ],
 			frameBudget: ( avg / FRAME_BUDGET_MS ) * 100,
+			totalInvocations: this.invocations.get( label ) ?? 0,
+			selfAvg,
+			selfMin,
+			selfMax,
+			selfP95,
+			selfFrameBudget,
 		};
 
 	}
@@ -350,6 +426,11 @@ class ProfilerServiceClass {
 		this.traceEvents = [];
 		this.traceStartTime = performance.now();
 		this._markId = 0;
+		this.selfBuffers.clear();
+		this.selfCursors.clear();
+		this.selfCounts.clear();
+		this.callStack.length = 0;
+		this.invocations.clear();
 
 	}
 
@@ -371,6 +452,12 @@ class ProfilerServiceClass {
  * @property {number} max
  * @property {number} p95
  * @property {number} frameBudget Percentage of a 60 fps frame budget (16.67 ms)
+ * @property {number} totalInvocations Total (uncapped) call count since last reset, for calls-per-frame computation.
+ * @property {number|undefined} selfAvg Exclusive (self) avg ms — inclusive time minus child scope time.
+ * @property {number|undefined} selfMin
+ * @property {number|undefined} selfMax
+ * @property {number|undefined} selfP95
+ * @property {number|undefined} selfFrameBudget Exclusive time as percentage of a 60 fps frame budget.
  */
 
 /**

package/src/renderers/WebGLRenderer.js

@@ -1895,7 +1895,7 @@ class WebGLRenderer {
 
 			const visible = object.layers.test( camera.layers );
 
-			if ( visible ) {
+			if ( visible && ! object.selfHidden /* WITH_GENESYS */ ) {
 
 				if ( object.isGroup ) {
 

package/src/renderers/common/Renderer.js

@@ -1682,13 +1682,13 @@ class Renderer {
 		renderList.begin();
 
 		// WITH_GENESYS
-		ProfilerService.begin( '_projectObject' );
+		ProfilerService.begin( 'projectObject' );
 		// !WITH_GENESYS
 
 		this._projectObject( scene, camera, 0, renderList, renderContext.clippingContext );
 
 		// WITH_GENESYS
-		ProfilerService.end( '_projectObject' );
+		ProfilerService.end( 'projectObject' );
 		// !WITH_GENESYS
 
 		renderList.finish();
@@ -3142,7 +3142,7 @@ class Renderer {
 
 		const visible = object.layers.test( camera.layers );
 
-		if ( visible ) {
+		if ( visible && ! object.selfHidden /* WITH_GENESYS */ ) {
 
 			if ( object.isGroup ) {