soonspacejs 3.0.0-alpha.0 → 3.0.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soonspacejs",
-  "version": "3.0.0-alpha.0",
+  "version": "3.0.0-alpha.2",
   "homepage": "https://www.xwbuilders.com/soonspacejs/",
   "description": "SoonSpace.js 3.0 alpha",
   "module": "./dist/index.esm.js",

package/types/Entity/EntityCollection.d.ts

@@ -2,6 +2,7 @@ import { Box3, Matrix4, Object3D, Raycaster, Scene } from 'three';
 import { Entity, EntityChange, EntityOptions } from './Entity';
 import { EntityHit } from './EntityRenderer';
 import { ModelResources, ModelLease, ModelLoadOptions } from './ModelResources';
+import { TransparentSideVariants } from './TransparentSideVariants';
 export declare class EntityCollection {
     private scene;
     private requestRender;
@@ -18,7 +19,8 @@ export declare class EntityCollection {
     private pendingModels;
     private selected;
     private selectionDirty;
-    constructor(scene: Scene, requestRender: () => void, models: ModelResources);
+    private selectionHighlight;
+    constructor(scene: Scene, requestRender: () => void, models: ModelResources, sideVariants?: Pick<TransparentSideVariants, 'register' | 'unregister'>);
     get roots(): readonly Entity[];
     getById(id: string): Entity | undefined;
     parentOf(entity: Entity): Entity | null;
@@ -48,12 +50,17 @@ export declare class EntityCollection {
     getStats(): {
         updatedEntities: number;
         entities: number;
+        sourceParts: number;
+        renderObjects: number;
+        rebuilds: number;
         instancedBatches: number;
         batchedBatches: number;
         independentObjects: number;
-        rebuilds: number;
     };
-    setSelection(entities: readonly Entity[]): void;
+    /** Selection identity is retained even when the optional visual overlay is disabled. */
+    setSelection(entities: readonly Entity[], options?: {
+        highlight?: boolean;
+    }): void;
     getSelection(): readonly Entity[];
     setInstancingEnabled(enabled: boolean): void;
     setBatchedEnabled(enabled: boolean): void;

package/types/Entity/EntityRenderer.d.ts

@@ -1,6 +1,7 @@
 import { Box3, Group, Matrix4, Raycaster, Intersection } from 'three';
 import { Entity } from './Entity';
 import { RegisteredPart } from './ModelResources';
+import { TransparentSideVariants } from './TransparentSideVariants';
 export interface EntityRenderInput {
     entity: Entity;
     parts: readonly RegisteredPart[];
@@ -14,6 +15,7 @@ export interface EntityHit extends Intersection {
     attachment?: boolean;
 }
 export declare class EntityRenderer {
+    private readonly sideVariants?;
     readonly root: Group<import('three').Object3DEventMap>;
     private entries;
     private batches;
@@ -26,11 +28,13 @@ export declare class EntityRenderer {
     private enabled;
     private batchedEnabled;
     private rebuilds;
+    private sourceParts;
+    private batchCounts;
     private selection;
     private selectionDirty;
     private highlights;
     private highlightMaterial;
-    constructor();
+    constructor(sideVariants?: Pick<TransparentSideVariants, "register" | "unregister"> | undefined);
     add(input: EntityRenderInput): void;
     remove(entity: Entity): void;
     setEnabled(enabled: boolean): void;
@@ -46,11 +50,14 @@ export declare class EntityRenderer {
     pick(raycaster: Raycaster): EntityHit[];
     getBounds(entity: Entity): Box3;
     getStats(): {
+        sourceParts: number;
+        renderObjects: number;
+        rebuilds: number;
         instancedBatches: number;
         batchedBatches: number;
         independentObjects: number;
-        rebuilds: number;
     };
+    private countBatch;
     private clearBatches;
     dispose(): void;
 }

package/types/Entity/TransparentSideVariants.d.ts

@@ -0,0 +1,27 @@
+import { Mesh, WebGLRenderer } from 'three';
+/** Reuse immutable side-specific programs for Entity-owned Standard materials.
+ * Only reuse materials with at least two registered supported users. Registration
+ * count is not visible draw count: a hidden/culled second user still enables reuse.
+ * Three still chooses each object's two passes and the complete render-list order.
+ */
+export declare class TransparentSideVariants {
+    private readonly renderer;
+    private readonly objects;
+    private readonly records;
+    private sequence;
+    private epoch;
+    private enabled;
+    private disposed;
+    private readonly render;
+    private readonly direct;
+    private readonly wrappedRender;
+    private readonly wrappedDirect;
+    constructor(renderer: WebGLRenderer);
+    private supported;
+    register(mesh: Mesh): void;
+    unregister(mesh: Mesh): void;
+    private sync;
+    setEnabled(enabled: boolean): void;
+    private release;
+    dispose(): void;
+}

package/types/Viewport/index.d.ts

@@ -38,6 +38,7 @@ declare class Viewport {
     rendererCSS3D: CSS3DRenderer;
     readonly models: ModelResources;
     readonly entities: EntityCollection;
+    private readonly transparentSideVariants;
     pmremGenerator: PMREMGenerator;
     info: Info;
     stats: Stats;

package/types/index.d.ts

@@ -2164,7 +2164,8 @@ export declare class EntityCollection {
     private pendingModels;
     private selected;
     private selectionDirty;
-    constructor(scene: Scene, requestRender: () => void, models: ModelResources);
+    private selectionHighlight;
+    constructor(scene: Scene, requestRender: () => void, models: ModelResources, sideVariants?: Pick<TransparentSideVariants, 'register' | 'unregister'>);
     get roots(): readonly Entity[];
     getById(id: string): Entity | undefined;
     parentOf(entity: Entity): Entity | null;
@@ -2194,12 +2195,17 @@ export declare class EntityCollection {
     getStats(): {
         updatedEntities: number;
         entities: number;
+        sourceParts: number;
+        renderObjects: number;
+        rebuilds: number;
         instancedBatches: number;
         batchedBatches: number;
         independentObjects: number;
-        rebuilds: number;
     };
-    setSelection(entities: readonly Entity[]): void;
+    /** Selection identity is retained even when the optional visual overlay is disabled. */
+    setSelection(entities: readonly Entity[], options?: {
+        highlight?: boolean;
+    }): void;
     getSelection(): readonly Entity[];
     setInstancingEnabled(enabled: boolean): void;
     setBatchedEnabled(enabled: boolean): void;
@@ -6487,6 +6493,33 @@ export declare interface Transition {
     };
 }
 
+/** Reuse immutable side-specific programs for Entity-owned Standard materials.
+ * Only reuse materials with at least two registered supported users. Registration
+ * count is not visible draw count: a hidden/culled second user still enables reuse.
+ * Three still chooses each object's two passes and the complete render-list order.
+ */
+declare class TransparentSideVariants {
+    private readonly renderer;
+    private readonly objects;
+    private readonly records;
+    private sequence;
+    private epoch;
+    private enabled;
+    private disposed;
+    private readonly render;
+    private readonly direct;
+    private readonly wrappedRender;
+    private readonly wrappedDirect;
+    constructor(renderer: WebGLRenderer);
+    private supported;
+    register(mesh: Mesh): void;
+    unregister(mesh: Mesh): void;
+    private sync;
+    setEnabled(enabled: boolean): void;
+    private release;
+    dispose(): void;
+}
+
 export declare interface TwoWaysLink {
     pointAIndex: number;
     pointBIndex: number;
@@ -6565,6 +6598,7 @@ declare class Viewport {
     rendererCSS3D: CSS3DRenderer;
     readonly models: ModelResources;
     readonly entities: EntityCollection;
+    private readonly transparentSideVariants;
     pmremGenerator: PMREMGenerator;
     info: Info;
     stats: default_3;