soonspacejs 3.0.0-alpha.2 → 3.0.0-alpha.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soonspacejs",
-  "version": "3.0.0-alpha.2",
+  "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

@@ -56,6 +56,7 @@ export declare class EntityCollection {
         instancedBatches: number;
         batchedBatches: number;
         independentObjects: number;
+        lineBatches: number;
     };
     /** Selection identity is retained even when the optional visual overlay is disabled. */
     setSelection(entities: readonly Entity[], options?: {

package/types/Entity/EntityRenderer.d.ts

@@ -34,6 +34,7 @@ export declare class EntityRenderer {
     private selectionDirty;
     private highlights;
     private highlightMaterial;
+    private highlightLineMaterial;
     constructor(sideVariants?: Pick<TransparentSideVariants, "register" | "unregister"> | undefined);
     add(input: EntityRenderInput): void;
     remove(entity: Entity): void;
@@ -46,6 +47,9 @@ 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;
@@ -56,6 +60,7 @@ export declare class EntityRenderer {
         instancedBatches: number;
         batchedBatches: number;
         independentObjects: number;
+        lineBatches: number;
     };
     private countBatch;
     private clearBatches;

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

@@ -2201,6 +2201,7 @@ export declare class EntityCollection {
         instancedBatches: number;
         batchedBatches: number;
         independentObjects: number;
+        lineBatches: number;
     };
     /** Selection identity is retained even when the optional visual overlay is disabled. */
     setSelection(entities: readonly Entity[], options?: {
@@ -3623,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;
@@ -6114,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;