soonspacejs 3.0.0-alpha.1 → 3.0.0-alpha.3

package/package.json

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

package/types/Entity/EntityCollection.d.ts

@@ -19,6 +19,7 @@ export declare class EntityCollection {
     private pendingModels;
     private selected;
     private selectionDirty;
+    private selectionHighlight;
     constructor(scene: Scene, requestRender: () => void, models: ModelResources, sideVariants?: Pick<TransparentSideVariants, 'register' | 'unregister'>);
     get roots(): readonly Entity[];
     getById(id: string): Entity | undefined;
@@ -49,12 +50,18 @@ export declare class EntityCollection {
     getStats(): {
         updatedEntities: number;
         entities: number;
+        sourceParts: number;
+        renderObjects: number;
+        rebuilds: number;
         instancedBatches: number;
         batchedBatches: number;
         independentObjects: number;
-        rebuilds: number;
+        lineBatches: 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

@@ -28,10 +28,13 @@ export declare class EntityRenderer {
     private enabled;
     private batchedEnabled;
     private rebuilds;
+    private sourceParts;
+    private batchCounts;
     private selection;
     private selectionDirty;
     private highlights;
     private highlightMaterial;
+    private highlightLineMaterial;
     constructor(sideVariants?: Pick<TransparentSideVariants, "register" | "unregister"> | undefined);
     add(input: EntityRenderInput): void;
     remove(entity: Entity): void;
@@ -44,15 +47,22 @@ export declare class EntityRenderer {
     private assignGroup;
     private rebuildGroup;
     private createBatch;
+    private createLineBatch;
+    private updateLineBatch;
+    private sortLineBatch;
     private updateBatch;
     pick(raycaster: Raycaster): EntityHit[];
     getBounds(entity: Entity): Box3;
     getStats(): {
+        sourceParts: number;
+        renderObjects: number;
+        rebuilds: number;
         instancedBatches: number;
         batchedBatches: number;
         independentObjects: number;
-        rebuilds: number;
+        lineBatches: number;
     };
+    private countBatch;
     private clearBatches;
     dispose(): void;
 }

package/types/Entity/ModelResources.d.ts

@@ -1,6 +1,9 @@
 import { BufferGeometry, Material, Matrix4, Texture } from 'three';
 import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 export interface ModelPart {
+    /** Omitted for triangle meshes. Basic line segments share the Entity lifecycle. */
+    kind?: 'mesh' | 'line-segments';
+    pickable?: boolean;
     geometry: BufferGeometry;
     material: Material | MaterialLease;
     matrix: Matrix4;

package/types/Entity/StaticModelPool.d.ts

@@ -0,0 +1,28 @@
+import { Object3D } from 'three';
+import { ModelLease, ModelResources } from './ModelResources';
+export interface StaticModelSnapshot {
+    object: Object3D;
+    model?: ModelLease;
+    empty?: boolean;
+    release: () => void;
+}
+export interface StaticModelExtraction extends StaticModelSnapshot {
+    restore: () => void;
+}
+/** Load-session cache. It owns snapshots, never resources borrowed from procedural factories. */
+export declare class StaticModelPool {
+    private resources;
+    private options;
+    private materials;
+    private models;
+    private disposed;
+    constructor(resources: ModelResources, options?: {
+        pickableLines?: boolean;
+        ignoreRootVisibility?: boolean;
+    });
+    extract(root: Object3D): StaticModelExtraction;
+    /** Copy an immutable render snapshot without retaining/moving the source tree.
+     * The returned native remainder is owned by the snapshot, never the factory. */
+    snapshot(root: Object3D): StaticModelSnapshot;
+    dispose(): void;
+}

package/types/Entity/index.d.ts

@@ -1,4 +1,6 @@
 export { Entity, } from './Entity';
+export { StaticModelPool, } from './StaticModelPool';
+export type { StaticModelSnapshot, StaticModelExtraction, } from './StaticModelPool';
 export type { EntityOptions, EntityChange, } from './Entity';
 export { EntityCollection, } from './EntityCollection';
 export { ModelResources, ResourceLease, ModelResourceUnsupportedError, } from './ModelResources';

package/types/index.d.ts

@@ -2164,6 +2164,7 @@ export declare class EntityCollection {
     private pendingModels;
     private selected;
     private selectionDirty;
+    private selectionHighlight;
     constructor(scene: Scene, requestRender: () => void, models: ModelResources, sideVariants?: Pick<TransparentSideVariants, 'register' | 'unregister'>);
     get roots(): readonly Entity[];
     getById(id: string): Entity | undefined;
@@ -2194,12 +2195,18 @@ export declare class EntityCollection {
     getStats(): {
         updatedEntities: number;
         entities: number;
+        sourceParts: number;
+        renderObjects: number;
+        rebuilds: number;
         instancedBatches: number;
         batchedBatches: number;
         independentObjects: number;
-        rebuilds: number;
+        lineBatches: 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;
@@ -3617,6 +3624,9 @@ declare class ModelManage extends DefaultManage {
 }
 
 export declare interface ModelPart {
+    /** Omitted for triangle meshes. Basic line segments share the Entity lifecycle. */
+    kind?: 'mesh' | 'line-segments';
+    pickable?: boolean;
     geometry: BufferGeometry;
     material: Material | MaterialLease;
     matrix: Matrix4;
@@ -6108,6 +6118,35 @@ export declare interface State {
     };
 }
 
+export declare interface StaticModelExtraction extends StaticModelSnapshot {
+    restore: () => void;
+}
+
+/** Load-session cache. It owns snapshots, never resources borrowed from procedural factories. */
+export declare class StaticModelPool {
+    private resources;
+    private options;
+    private materials;
+    private models;
+    private disposed;
+    constructor(resources: ModelResources, options?: {
+        pickableLines?: boolean;
+        ignoreRootVisibility?: boolean;
+    });
+    extract(root: Object3D): StaticModelExtraction;
+    /** Copy an immutable render snapshot without retaining/moving the source tree.
+     * The returned native remainder is owned by the snapshot, never the factory. */
+    snapshot(root: Object3D): StaticModelSnapshot;
+    dispose(): void;
+}
+
+export declare interface StaticModelSnapshot {
+    object: Object3D;
+    model?: ModelLease;
+    empty?: boolean;
+    release: () => void;
+}
+
 export declare interface StrokeSelectOptions extends BaseSelectOptions {
     isOpacityShow?: boolean;
     edgeColor?: IColor;