@shopware-ag/dive 3.0.11 → 3.1.0

package/build/plugins/state/src/actions/index.d.ts

@@ -4,4 +4,5 @@ export * from './media/index.ts';
 export * from './object/index.ts';
 export * from './renderer/index.ts';
 export * from './scene/index.ts';
+export * from './state/index.ts';
 export * from './toolbox/index.ts';

package/build/plugins/state/src/actions/object/addobject.d.ts

@@ -1,7 +1,7 @@
 import { Action } from '../action.ts';
 import { ActionDependencies } from '../../../types/index.ts';
 import { EntitySchema } from '../../../../../index.ts';
-export declare const AddObjectAction: new (payload: EntitySchema, dependencies: Pick<ActionDependencies, "registered" | "engine">) => Action<EntitySchema, Pick<ActionDependencies, "registered" | "engine">, void>;
+export declare const AddObjectAction: new (payload: EntitySchema, dependencies: Pick<ActionDependencies, "registered" | "engine">) => Action<EntitySchema, Pick<ActionDependencies, "registered" | "engine">, Promise<import('../../../../../index.ts').DIVEModel | import('../../../../../index.ts').DIVEGroup | import('../../../../../index.ts').DIVEPrimitive | import('../../../../../index.ts').DIVELight | undefined>>;
 declare global {
     interface ActionTypes {
         ADD_OBJECT: typeof AddObjectAction;

package/build/plugins/state/src/actions/object/updateobject.d.ts

@@ -5,7 +5,7 @@ export declare const UpdateObjectAction: new (payload: Partial<EntitySchema> & {
     id: string;
 }, dependencies: Pick<ActionDependencies, "registered" | "engine">) => Action<Partial<EntitySchema> & {
     id: string;
-}, Pick<ActionDependencies, "registered" | "engine">, void>;
+}, Pick<ActionDependencies, "registered" | "engine">, Promise<void>>;
 declare global {
     interface ActionTypes {
         UPDATE_OBJECT: typeof UpdateObjectAction;

package/build/plugins/state/src/actions/renderer/startrender.d.ts

@@ -1,6 +1,6 @@
 import { Action } from '../action.ts';
 import { ActionDependencies } from '../../../types/index.ts';
-export declare const StartRenderAction: new (payload: void, dependencies: Pick<ActionDependencies, "engine">) => Action<void, Pick<ActionDependencies, "engine">, void>;
+export declare const StartRenderAction: new (payload: void, dependencies: Pick<ActionDependencies, "engine">) => Action<void, Pick<ActionDependencies, "engine">, Promise<void>>;
 declare global {
     interface ActionTypes {
         START_RENDER: typeof StartRenderAction;

package/build/plugins/state/src/actions/scene/getallscenedata.d.ts

@@ -1,7 +1,10 @@
 import { Action } from '../action.ts';
 import { ActionDependencies } from '../../../types/index.ts';
-import { StateSceneData } from '../../../types/StateSceneData.ts';
-export declare const GetAllSceneDataAction: new (payload: object, dependencies: Pick<ActionDependencies, "registered" | "engine" | "controller">) => Action<object, Pick<ActionDependencies, "registered" | "engine" | "controller">, StateSceneData>;
+import { StateData } from '../../../types/StateData.ts';
+/**
+ * @deprecated use [`GetStateAction`](../state/getstate.ts) instead. This action will be removed in next major release.
+ */
+export declare const GetAllSceneDataAction: new (payload: object, dependencies: Pick<ActionDependencies, "registered" | "engine" | "controller">) => Action<object, Pick<ActionDependencies, "registered" | "engine" | "controller">, StateData>;
 declare global {
     interface ActionTypes {
         GET_ALL_SCENE_DATA: typeof GetAllSceneDataAction;

package/build/plugins/state/src/actions/state/getstate.d.ts

@@ -0,0 +1,8 @@
+import { Action } from '../action.ts';
+import { ActionDependencies, StateData } from '../../../types/index.ts';
+export declare const GetStateAction: new (payload: void, dependencies: Pick<ActionDependencies, "registered" | "engine" | "controller">) => Action<void, Pick<ActionDependencies, "registered" | "engine" | "controller">, StateData>;
+declare global {
+    interface ActionTypes {
+        GET_STATE: typeof GetStateAction;
+    }
+}

package/build/plugins/state/src/actions/state/index.d.ts

@@ -0,0 +1,2 @@
+export * from './getstate.ts';
+export * from './setstate.ts';

package/build/plugins/state/src/actions/state/setstate.d.ts

@@ -0,0 +1,8 @@
+import { Action } from '../action.ts';
+import { ActionDependencies, StateData } from '../../../types/index.ts';
+export declare const SetStateAction: new (payload: StateData, dependencies: Pick<ActionDependencies, "registered" | "engine" | "controller">) => Action<StateData, Pick<ActionDependencies, "registered" | "engine" | "controller">, Promise<(import('../../../../../index.ts').DIVEModel | import('../../../../../index.ts').DIVEGroup | import('../../../../../index.ts').DIVEPrimitive | import('../../../../../index.ts').DIVELight)[]>>;
+declare global {
+    interface ActionTypes {
+        SET_STATE: typeof SetStateAction;
+    }
+}

package/build/plugins/state/types/StateData.d.ts

@@ -0,0 +1,18 @@
+import { Vector3Like } from 'three/webgpu';
+import { GroupSchema, LightSchema, ModelSchema, CameraSchema, PrimitiveSchema } from '../../../index.ts';
+export type StateData = {
+    name: string;
+    backgroundColor: string;
+    floorEnabled: boolean;
+    floorColor: string;
+    spotmarks: object[];
+    lights: LightSchema[];
+    objects: ModelSchema[];
+    cameras: CameraSchema[];
+    primitives: PrimitiveSchema[];
+    groups: GroupSchema[];
+    userCamera: {
+        position: Vector3Like;
+        target: Vector3Like;
+    };
+};

package/build/plugins/state/types/StateSceneData.d.ts

@@ -1,19 +1,5 @@
-import { Vector3Like } from 'three/webgpu';
-import { GroupSchema, LightSchema, ModelSchema, PovSchema, PrimitiveSchema } from '../../../index.ts';
-export type StateSceneData = {
-    name: string;
-    mediaItem: null;
-    backgroundColor: string;
-    floorEnabled: boolean;
-    floorColor: string;
-    userCamera: {
-        position: Vector3Like;
-        target: Vector3Like;
-    };
-    spotmarks: object[];
-    lights: LightSchema[];
-    objects: ModelSchema[];
-    cameras: PovSchema[];
-    primitives: PrimitiveSchema[];
-    groups: GroupSchema[];
-};
+import { StateData } from './StateData.ts';
+/**
+ * @deprecated use [`StateData`](./StateData.ts) type instead. This type will be removed in release 4.0.
+ */
+export type StateSceneData = StateData;

package/build/plugins/state/types/index.d.ts

@@ -1,3 +1,4 @@
 export * from './ActionTypes.ts';
 export * from './StateSceneData.ts';
+export * from './StateData.ts';
 export * from './StateExportFileType.ts';

package/build/plugins/toolbox/index.cjs

@@ -1 +1 @@
-"use strict";var y=Object.defineProperty;var S=(n,t,e)=>t in n?y(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e;var r=(n,t,e)=>S(n,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("three/webgpu");require("../../chunks/FileTypes-DMTSUCcK.cjs");const h=require("../../chunks/PerspectiveCamera-DwQUmkDv.cjs");require("three/examples/jsm/loaders/HDRLoader.js");require("three/tsl");const _=require("../../chunks/findInterface-C6mrvf_t.cjs"),T=require("three/examples/jsm/controls/TransformControls.js"),d=require("../../chunks/AxisHelperColors-BrGqktN5.cjs");class m{constructor(){r(this,"_selected",null);r(this,"_listeners",new Set)}get selected(){return this._selected}select(t){var e,s,i;this._selected!==t&&(this._selected&&((s=(e=this._selected).onDeselect)==null||s.call(e)),this._selected=t,(i=t.onSelect)==null||i.call(t),this.notifyListeners())}deselect(){var t,e;this._selected&&((e=(t=this._selected).onDeselect)==null||e.call(t),this._selected=null,this.notifyListeners())}onChange(t){this._listeners.add(t)}offChange(t){this._listeners.delete(t)}dispose(){this._selected=null,this._listeners.clear()}notifyListeners(){for(const t of this._listeners)t(this._selected)}}class b{constructor(){r(this,"name","hover");r(this,"priority",20);r(this,"_hovered",null)}get hovered(){return this._hovered}onActivate(){this._hovered=null}onDeactivate(){var t,e;this._hovered&&((e=(t=this._hovered).onPointerLeave)==null||e.call(t),this._hovered=null)}onPointerMove(t){var i,o,a,l,p,f,v;const e=t.modelIntersects[0],s=_.findInterface(e==null?void 0:e.object,"isHoverable");if(e&&s){if(!this._hovered){(i=s.onPointerEnter)==null||i.call(s,e),this._hovered=s;return}if(this._hovered.uuid!==s.uuid){(a=(o=this._hovered).onPointerLeave)==null||a.call(o),(l=s.onPointerEnter)==null||l.call(s,e),this._hovered=s;return}(p=s.onPointerOver)==null||p.call(s,e);return}this._hovered&&((v=(f=this._hovered).onPointerLeave)==null||v.call(f),this._hovered=null)}}const P=n=>n.name==="select";class g{constructor(t){r(this,"name","select");r(this,"priority",30);r(this,"_selectionState");this._selectionState=t}get selected(){return this._selectionState.selected}onActivate(){}onDeactivate(){}onClick(t){const e=t.modelIntersects[0],s=_.findInterface(e==null?void 0:e.object,"isSelectable");if(!e||!s){this._selectionState.deselect();return}const i=this._selectionState.selected;i&&i.uuid===s.uuid||this._selectionState.select(s)}select(t){this._selectionState.select(t)}deselect(){this._selectionState.deselect()}}const w=n=>n.name==="transform";class u extends c.EventDispatcher{constructor(e,s,i){super();r(this,"name","transform");r(this,"priority",5);r(this,"_scene");r(this,"_controller");r(this,"_selectionState");r(this,"_gizmo");r(this,"_gizmoHelper");r(this,"_scaleLinked",!1);r(this,"_gizmoVisible",!0);r(this,"_selectionChangeHandler");this._scene=e,this._controller=s,this._selectionState=i,this._gizmo=this.initGizmo(),this._gizmoHelper=this._gizmo.getHelper(),this._scene.add(this._gizmoHelper),this._selectionChangeHandler=this.onSelectionChange.bind(this)}get gizmo(){return this._gizmo}get isDragging(){return this._gizmo.dragging}onActivate(){this._selectionState.onChange(this._selectionChangeHandler);const e=this._selectionState.selected;e&&this.attachGizmo(e)}onDeactivate(){this._selectionState.offChange(this._selectionChangeHandler),this._gizmo.detach()}onPointerMove(e){if(this._gizmo.dragging||e.uiIntersects.length>0&&e.uiIntersects.some(i=>this.isGizmoChild(i.object)))return!0}setGizmoMode(e){this._gizmo.mode=e}setGizmoVisible(e){this._gizmoVisible=e;const s=this._scene.children.includes(this._gizmoHelper);e&&!s?(this._scene.add(this._gizmoHelper),this._gizmo.getRaycaster().layers.enableAll()):!e&&s&&(this._scene.remove(this._gizmoHelper),this._gizmo.getRaycaster().layers.disableAll())}setGizmoScaleLinked(e){this._scaleLinked=e}dispose(){this._selectionState.offChange(this._selectionChangeHandler),this._gizmo.detach(),this._scene.remove(this._gizmoHelper),this._gizmo.dispose()}onSelectionChange(e){e&&_.implementsInterface(e,"isMovable")?this.attachGizmo(e):this._gizmo.detach()}attachGizmo(e){_.implementsInterface(e,"isMovable")&&(this._gizmo.attach(e),this.setGizmoVisible(e.visible&&this._gizmoVisible))}isGizmoChild(e){let s=e;for(;s;){if(s===this._gizmoHelper)return!0;s=s.parent}return!1}initGizmo(){const e=new T.TransformControls(this._controller.object,this._controller.domElement);return e.mode="translate",e.getHelper().traverse(i=>{if(!("isMesh"in i))return;const o=i.material;i.name==="X"&&o.color.set(d.AxesColorRed),i.name==="Y"&&o.color.set(d.AxesColorGreen),i.name==="Z"&&o.color.set(d.AxesColorBlue),i.name==="XY"&&o.color.set(d.AxesColorBlue),i.name==="YZ"&&o.color.set(d.AxesColorRed),i.name==="XZ"&&o.color.set(d.AxesColorGreen)}),e.addEventListener("mouseDown",()=>{var i,o;this._controller.enabled=!1,_.implementsInterface(e.object,"isMovable")&&((o=(i=e.object).onMoveStart)==null||o.call(i))}),e.addEventListener("objectChange",()=>{var i,o;if(_.implementsInterface(e.object,"isMovable")){if((o=(i=e.object).onMove)==null||o.call(i),this._scaleLinked&&e.object){const a=e.object.scale,l=(a.x+a.y+a.z)/3;e.object.scale.set(l,l,l)}switch(this.dispatchEvent({type:"object-change",object:e.object}),e.mode){case"translate":this.dispatchEvent({type:"object-position-change",object:e.object});break;case"rotate":this.dispatchEvent({type:"object-rotation-change",object:e.object});break;case"scale":this.dispatchEvent({type:"object-scale-change",object:e.object});break}}}),e.addEventListener("mouseUp",()=>{var i,o;this._controller.enabled=!0,_.implementsInterface(e.object,"isMovable")&&((o=(i=e.object).onMoveEnd)==null||o.call(i))}),e}}const C=.001;class D{constructor(t){r(this,"name","drag");r(this,"priority",10);r(this,"_controller");r(this,"_raycaster");r(this,"_dragging",!1);r(this,"_draggable",null);r(this,"_dragStart",new c.Vector3);r(this,"_dragCurrent",new c.Vector3);r(this,"_dragEnd",new c.Vector3);r(this,"_dragDelta",new c.Vector3);r(this,"_dragRaycastTargets",null);this._controller=t,this._raycaster=new c.Raycaster}get isDragging(){return this._dragging}get draggable(){return this._draggable}onActivate(){this.resetDragState()}onDeactivate(){this._dragging&&this._draggable&&this.endDrag(),this.resetDragState()}onPointerDown(t){var e;t.pointerPrimaryDown&&(this._draggable=_.findInterface((e=t.intersects[0])==null?void 0:e.object,"isDraggable")||null)}onPointerMove(t){if(t.pointerPrimaryDown&&this._draggable&&(this._raycaster.setFromCamera(t.pointer,this._controller.object),this._dragging||t.lastPointerDown.distanceTo(t.pointer)>C&&this.startDrag(t),this._dragging))return this.updateDrag(t),!0}onPointerUp(t){this._dragging&&(this._raycaster.setFromCamera(t.pointer,this._controller.object),this.endDrag()),this._draggable=null}setDragRaycastTargets(t){this._dragRaycastTargets=t}startDrag(t){var s,i;const e=this.getDragIntersect(t);e&&(this._dragStart.copy(e.point),this._dragCurrent.copy(e.point),this._dragEnd.copy(e.point),this._dragDelta.set(0,0,0),(i=(s=this._draggable)==null?void 0:s.onDragStart)==null||i.call(s,this.createDragEvent()),this._dragging=!0,this._controller.enabled=!1)}updateDrag(t){var s,i;const e=this.getDragIntersect(t);e&&(this._dragCurrent.copy(e.point),this._dragEnd.copy(e.point),this._dragDelta.subVectors(this._dragCurrent,this._dragStart),(i=(s=this._draggable)==null?void 0:s.onDrag)==null||i.call(s,this.createDragEvent()))}endDrag(){var e,s;const t=this.createDragEvent();(s=(e=this._draggable)==null?void 0:e.onDragEnd)==null||s.call(e,t),this._dragging=!1,this._controller.enabled=!0,this.resetDragState()}getDragIntersect(t){return this._dragRaycastTargets?this._raycaster.intersectObjects(this._dragRaycastTargets,!0)[0]||null:t.intersects[0]||null}createDragEvent(){return{dragStart:this._dragStart.clone(),dragCurrent:this._dragCurrent.clone(),dragEnd:this._dragEnd.clone(),dragDelta:this._dragDelta.clone()}}resetDragState(){this._dragStart.set(0,0,0),this._dragCurrent.set(0,0,0),this._dragEnd.set(0,0,0),this._dragDelta.set(0,0,0)}}const E=.001;class M{constructor(t,e){r(this,"_scene");r(this,"_controller");r(this,"_canvas");r(this,"_tools");r(this,"_activeTools",new Map);r(this,"_sortedActiveTools",[]);r(this,"_selectionState");r(this,"_raycaster");r(this,"_pointer");r(this,"_productLayerMask");r(this,"_uiLayerMask");r(this,"_pointerPrimaryDown",!1);r(this,"_pointerMiddleDown",!1);r(this,"_pointerSecondaryDown",!1);r(this,"_lastPointerDown");r(this,"_boundPointerMove");r(this,"_boundPointerDown");r(this,"_boundPointerUp");r(this,"_boundWheel");this._scene=t,this._controller=e,this._canvas=e.domElement,this._selectionState=new m,this._raycaster=new c.Raycaster,this._pointer=new c.Vector2,this._lastPointerDown=new c.Vector2,this._productLayerMask=new c.Layers,this._productLayerMask.set(Math.log2(h.PRODUCT_LAYER_MASK)),this._uiLayerMask=new c.Layers,this._uiLayerMask.set(Math.log2(h.UI_LAYER_MASK)),this._tools=new Map([["hover",new b],["select",new g(this._selectionState)],["transform",new u(t,e,this._selectionState)],["drag",new D(e)]]),this._boundPointerMove=this.onPointerMove.bind(this),this._boundPointerDown=this.onPointerDown.bind(this),this._boundPointerUp=this.onPointerUp.bind(this),this._boundWheel=this.onWheel.bind(this),this._canvas.addEventListener("pointermove",this._boundPointerMove),this._canvas.addEventListener("pointerdown",this._boundPointerDown),this._canvas.addEventListener("pointerup",this._boundPointerUp),this._canvas.addEventListener("wheel",this._boundWheel)}get selectionState(){return this._selectionState}enableTool(t){var s;const e=this._tools.get(t);e&&(this._activeTools.has(t)||(this._activeTools.set(t,e),this.updateSortedTools(),(s=e.onActivate)==null||s.call(e)))}disableTool(t){var s;const e=this._activeTools.get(t);e&&((s=e.onDeactivate)==null||s.call(e),this._activeTools.delete(t),this.updateSortedTools())}isToolEnabled(t){return this._activeTools.has(t)}getTool(t){return this._tools.get(t)}getActiveTools(){return[...this._sortedActiveTools]}dispose(){var t;for(const e of this._activeTools.values())(t=e.onDeactivate)==null||t.call(e);this._activeTools.clear(),this._tools.clear(),this._sortedActiveTools=[],this._canvas.removeEventListener("pointermove",this._boundPointerMove),this._canvas.removeEventListener("pointerdown",this._boundPointerDown),this._canvas.removeEventListener("pointerup",this._boundPointerUp),this._canvas.removeEventListener("wheel",this._boundWheel),this._selectionState.dispose()}onPointerMove(t){var s;this.updatePointer(t);const e=this.createPointerContext(t);for(const i of this._sortedActiveTools)if((s=i.onPointerMove)==null?void 0:s.call(i,e))break}onPointerDown(t){var s;this.updatePointerState(t,!0),this.updatePointer(t),this._lastPointerDown.copy(this._pointer);const e=this.createPointerContext(t);for(const i of this._sortedActiveTools)if((s=i.onPointerDown)==null?void 0:s.call(i,e))break}onPointerUp(t){var i,o;this.updatePointer(t);const e=this.createPointerContext(t),s=!this.pointerWasDragged();for(const a of this._sortedActiveTools)if((i=a.onPointerUp)==null?void 0:i.call(a,e))break;if(s){for(const a of this._sortedActiveTools)if((o=a.onClick)==null?void 0:o.call(a,e))break}this.updatePointerState(t,!1)}onWheel(t){var s;const e=this.createWheelContext(t);for(const i of this._sortedActiveTools)if((s=i.onWheel)==null?void 0:s.call(i,e))break}createPointerContext(t){const e=this.raycast();return{event:t,pointer:this._pointer.clone(),intersects:e,modelIntersects:this.filterIntersectsByLayer(e,h.PRODUCT_LAYER_MASK),uiIntersects:this.filterIntersectsByLayer(e,h.UI_LAYER_MASK),pointerPrimaryDown:this._pointerPrimaryDown,pointerMiddleDown:this._pointerMiddleDown,pointerSecondaryDown:this._pointerSecondaryDown,lastPointerDown:this._lastPointerDown.clone()}}createWheelContext(t){const e=this.raycast();return{event:t,pointer:this._pointer.clone(),intersects:e,modelIntersects:this.filterIntersectsByLayer(e,h.PRODUCT_LAYER_MASK),uiIntersects:this.filterIntersectsByLayer(e,h.UI_LAYER_MASK)}}updatePointer(t){this._pointer.x=t.offsetX/this._canvas.clientWidth*2-1,this._pointer.y=-(t.offsetY/this._canvas.clientHeight)*2+1,this._raycaster.setFromCamera(this._pointer,this._controller.object)}updatePointerState(t,e){switch(t.button){case 0:this._pointerPrimaryDown=e;break;case 1:this._pointerMiddleDown=e;break;case 2:this._pointerSecondaryDown=e;break}}raycast(){this._raycaster.layers.mask=h.PRODUCT_LAYER_MASK|h.UI_LAYER_MASK;const t=this._scene.children.filter(e=>e.visible&&"isMesh"in e&&e.isMesh);return this._raycaster.intersectObjects(t,!0)}filterIntersectsByLayer(t,e){return t.filter(s=>(s.object.layers.mask&e)!==0)}updateSortedTools(){this._sortedActiveTools=[...this._activeTools.values()].sort((t,e)=>t.priority-e.priority)}pointerWasDragged(){return this._lastPointerDown.distanceTo(this._pointer)>E}}exports.DIVESelectTool=g;exports.DIVETransformTool=u;exports.DragTool=D;exports.HoverTool=b;exports.SelectTool=g;exports.SelectionState=m;exports.Toolbox=M;exports.TransformTool=u;exports.isSelectTool=P;exports.isTransformTool=w;
+"use strict";var y=Object.defineProperty;var S=(n,t,e)=>t in n?y(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e;var r=(n,t,e)=>S(n,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("three/webgpu");require("../../chunks/FileTypes-Cgyf8ocm.cjs");const h=require("../../chunks/PerspectiveCamera-DwQUmkDv.cjs");require("three/examples/jsm/loaders/HDRLoader.js");require("three/tsl");const _=require("../../chunks/findInterface-C6mrvf_t.cjs"),T=require("three/examples/jsm/controls/TransformControls.js"),d=require("../../chunks/AxisHelperColors-BrGqktN5.cjs");class m{constructor(){r(this,"_selected",null);r(this,"_listeners",new Set)}get selected(){return this._selected}select(t){var e,s,i;this._selected!==t&&(this._selected&&((s=(e=this._selected).onDeselect)==null||s.call(e)),this._selected=t,(i=t.onSelect)==null||i.call(t),this.notifyListeners())}deselect(){var t,e;this._selected&&((e=(t=this._selected).onDeselect)==null||e.call(t),this._selected=null,this.notifyListeners())}onChange(t){this._listeners.add(t)}offChange(t){this._listeners.delete(t)}dispose(){this._selected=null,this._listeners.clear()}notifyListeners(){for(const t of this._listeners)t(this._selected)}}class b{constructor(){r(this,"name","hover");r(this,"priority",20);r(this,"_hovered",null)}get hovered(){return this._hovered}onActivate(){this._hovered=null}onDeactivate(){var t,e;this._hovered&&((e=(t=this._hovered).onPointerLeave)==null||e.call(t),this._hovered=null)}onPointerMove(t){var i,o,a,l,p,f,v;const e=t.modelIntersects[0],s=_.findInterface(e==null?void 0:e.object,"isHoverable");if(e&&s){if(!this._hovered){(i=s.onPointerEnter)==null||i.call(s,e),this._hovered=s;return}if(this._hovered.uuid!==s.uuid){(a=(o=this._hovered).onPointerLeave)==null||a.call(o),(l=s.onPointerEnter)==null||l.call(s,e),this._hovered=s;return}(p=s.onPointerOver)==null||p.call(s,e);return}this._hovered&&((v=(f=this._hovered).onPointerLeave)==null||v.call(f),this._hovered=null)}}const P=n=>n.name==="select";class g{constructor(t){r(this,"name","select");r(this,"priority",30);r(this,"_selectionState");this._selectionState=t}get selected(){return this._selectionState.selected}onActivate(){}onDeactivate(){}onClick(t){const e=t.modelIntersects[0],s=_.findInterface(e==null?void 0:e.object,"isSelectable");if(!e||!s){this._selectionState.deselect();return}const i=this._selectionState.selected;i&&i.uuid===s.uuid||this._selectionState.select(s)}select(t){this._selectionState.select(t)}deselect(){this._selectionState.deselect()}}const w=n=>n.name==="transform";class u extends c.EventDispatcher{constructor(e,s,i){super();r(this,"name","transform");r(this,"priority",5);r(this,"_scene");r(this,"_controller");r(this,"_selectionState");r(this,"_gizmo");r(this,"_gizmoHelper");r(this,"_scaleLinked",!1);r(this,"_gizmoVisible",!0);r(this,"_selectionChangeHandler");this._scene=e,this._controller=s,this._selectionState=i,this._gizmo=this.initGizmo(),this._gizmoHelper=this._gizmo.getHelper(),this._scene.add(this._gizmoHelper),this._selectionChangeHandler=this.onSelectionChange.bind(this)}get gizmo(){return this._gizmo}get isDragging(){return this._gizmo.dragging}onActivate(){this._selectionState.onChange(this._selectionChangeHandler);const e=this._selectionState.selected;e&&this.attachGizmo(e)}onDeactivate(){this._selectionState.offChange(this._selectionChangeHandler),this._gizmo.detach()}onPointerMove(e){if(this._gizmo.dragging||e.uiIntersects.length>0&&e.uiIntersects.some(i=>this.isGizmoChild(i.object)))return!0}setGizmoMode(e){this._gizmo.mode=e}setGizmoVisible(e){this._gizmoVisible=e;const s=this._scene.children.includes(this._gizmoHelper);e&&!s?(this._scene.add(this._gizmoHelper),this._gizmo.getRaycaster().layers.enableAll()):!e&&s&&(this._scene.remove(this._gizmoHelper),this._gizmo.getRaycaster().layers.disableAll())}setGizmoScaleLinked(e){this._scaleLinked=e}dispose(){this._selectionState.offChange(this._selectionChangeHandler),this._gizmo.detach(),this._scene.remove(this._gizmoHelper),this._gizmo.dispose()}onSelectionChange(e){e&&_.implementsInterface(e,"isMovable")?this.attachGizmo(e):this._gizmo.detach()}attachGizmo(e){_.implementsInterface(e,"isMovable")&&(this._gizmo.attach(e),this.setGizmoVisible(e.visible&&this._gizmoVisible))}isGizmoChild(e){let s=e;for(;s;){if(s===this._gizmoHelper)return!0;s=s.parent}return!1}initGizmo(){const e=new T.TransformControls(this._controller.object,this._controller.domElement);return e.mode="translate",e.getHelper().traverse(i=>{if(!("isMesh"in i))return;const o=i.material;i.name==="X"&&o.color.set(d.AxesColorRed),i.name==="Y"&&o.color.set(d.AxesColorGreen),i.name==="Z"&&o.color.set(d.AxesColorBlue),i.name==="XY"&&o.color.set(d.AxesColorBlue),i.name==="YZ"&&o.color.set(d.AxesColorRed),i.name==="XZ"&&o.color.set(d.AxesColorGreen)}),e.addEventListener("mouseDown",()=>{var i,o;this._controller.enabled=!1,_.implementsInterface(e.object,"isMovable")&&((o=(i=e.object).onMoveStart)==null||o.call(i))}),e.addEventListener("objectChange",()=>{var i,o;if(_.implementsInterface(e.object,"isMovable")){if((o=(i=e.object).onMove)==null||o.call(i),this._scaleLinked&&e.object){const a=e.object.scale,l=(a.x+a.y+a.z)/3;e.object.scale.set(l,l,l)}switch(this.dispatchEvent({type:"object-change",object:e.object}),e.mode){case"translate":this.dispatchEvent({type:"object-position-change",object:e.object});break;case"rotate":this.dispatchEvent({type:"object-rotation-change",object:e.object});break;case"scale":this.dispatchEvent({type:"object-scale-change",object:e.object});break}}}),e.addEventListener("mouseUp",()=>{var i,o;this._controller.enabled=!0,_.implementsInterface(e.object,"isMovable")&&((o=(i=e.object).onMoveEnd)==null||o.call(i))}),e}}const C=.001;class D{constructor(t){r(this,"name","drag");r(this,"priority",10);r(this,"_controller");r(this,"_raycaster");r(this,"_dragging",!1);r(this,"_draggable",null);r(this,"_dragStart",new c.Vector3);r(this,"_dragCurrent",new c.Vector3);r(this,"_dragEnd",new c.Vector3);r(this,"_dragDelta",new c.Vector3);r(this,"_dragRaycastTargets",null);this._controller=t,this._raycaster=new c.Raycaster}get isDragging(){return this._dragging}get draggable(){return this._draggable}onActivate(){this.resetDragState()}onDeactivate(){this._dragging&&this._draggable&&this.endDrag(),this.resetDragState()}onPointerDown(t){var e;t.pointerPrimaryDown&&(this._draggable=_.findInterface((e=t.intersects[0])==null?void 0:e.object,"isDraggable")||null)}onPointerMove(t){if(t.pointerPrimaryDown&&this._draggable&&(this._raycaster.setFromCamera(t.pointer,this._controller.object),this._dragging||t.lastPointerDown.distanceTo(t.pointer)>C&&this.startDrag(t),this._dragging))return this.updateDrag(t),!0}onPointerUp(t){this._dragging&&(this._raycaster.setFromCamera(t.pointer,this._controller.object),this.endDrag()),this._draggable=null}setDragRaycastTargets(t){this._dragRaycastTargets=t}startDrag(t){var s,i;const e=this.getDragIntersect(t);e&&(this._dragStart.copy(e.point),this._dragCurrent.copy(e.point),this._dragEnd.copy(e.point),this._dragDelta.set(0,0,0),(i=(s=this._draggable)==null?void 0:s.onDragStart)==null||i.call(s,this.createDragEvent()),this._dragging=!0,this._controller.enabled=!1)}updateDrag(t){var s,i;const e=this.getDragIntersect(t);e&&(this._dragCurrent.copy(e.point),this._dragEnd.copy(e.point),this._dragDelta.subVectors(this._dragCurrent,this._dragStart),(i=(s=this._draggable)==null?void 0:s.onDrag)==null||i.call(s,this.createDragEvent()))}endDrag(){var e,s;const t=this.createDragEvent();(s=(e=this._draggable)==null?void 0:e.onDragEnd)==null||s.call(e,t),this._dragging=!1,this._controller.enabled=!0,this.resetDragState()}getDragIntersect(t){return this._dragRaycastTargets?this._raycaster.intersectObjects(this._dragRaycastTargets,!0)[0]||null:t.intersects[0]||null}createDragEvent(){return{dragStart:this._dragStart.clone(),dragCurrent:this._dragCurrent.clone(),dragEnd:this._dragEnd.clone(),dragDelta:this._dragDelta.clone()}}resetDragState(){this._dragStart.set(0,0,0),this._dragCurrent.set(0,0,0),this._dragEnd.set(0,0,0),this._dragDelta.set(0,0,0)}}const E=.001;class M{constructor(t,e){r(this,"_scene");r(this,"_controller");r(this,"_canvas");r(this,"_tools");r(this,"_activeTools",new Map);r(this,"_sortedActiveTools",[]);r(this,"_selectionState");r(this,"_raycaster");r(this,"_pointer");r(this,"_productLayerMask");r(this,"_uiLayerMask");r(this,"_pointerPrimaryDown",!1);r(this,"_pointerMiddleDown",!1);r(this,"_pointerSecondaryDown",!1);r(this,"_lastPointerDown");r(this,"_boundPointerMove");r(this,"_boundPointerDown");r(this,"_boundPointerUp");r(this,"_boundWheel");this._scene=t,this._controller=e,this._canvas=e.domElement,this._selectionState=new m,this._raycaster=new c.Raycaster,this._pointer=new c.Vector2,this._lastPointerDown=new c.Vector2,this._productLayerMask=new c.Layers,this._productLayerMask.set(Math.log2(h.PRODUCT_LAYER_MASK)),this._uiLayerMask=new c.Layers,this._uiLayerMask.set(Math.log2(h.UI_LAYER_MASK)),this._tools=new Map([["hover",new b],["select",new g(this._selectionState)],["transform",new u(t,e,this._selectionState)],["drag",new D(e)]]),this._boundPointerMove=this.onPointerMove.bind(this),this._boundPointerDown=this.onPointerDown.bind(this),this._boundPointerUp=this.onPointerUp.bind(this),this._boundWheel=this.onWheel.bind(this),this._canvas.addEventListener("pointermove",this._boundPointerMove),this._canvas.addEventListener("pointerdown",this._boundPointerDown),this._canvas.addEventListener("pointerup",this._boundPointerUp),this._canvas.addEventListener("wheel",this._boundWheel)}get selectionState(){return this._selectionState}enableTool(t){var s;const e=this._tools.get(t);e&&(this._activeTools.has(t)||(this._activeTools.set(t,e),this.updateSortedTools(),(s=e.onActivate)==null||s.call(e)))}disableTool(t){var s;const e=this._activeTools.get(t);e&&((s=e.onDeactivate)==null||s.call(e),this._activeTools.delete(t),this.updateSortedTools())}isToolEnabled(t){return this._activeTools.has(t)}getTool(t){return this._tools.get(t)}getActiveTools(){return[...this._sortedActiveTools]}dispose(){var t;for(const e of this._activeTools.values())(t=e.onDeactivate)==null||t.call(e);this._activeTools.clear(),this._tools.clear(),this._sortedActiveTools=[],this._canvas.removeEventListener("pointermove",this._boundPointerMove),this._canvas.removeEventListener("pointerdown",this._boundPointerDown),this._canvas.removeEventListener("pointerup",this._boundPointerUp),this._canvas.removeEventListener("wheel",this._boundWheel),this._selectionState.dispose()}onPointerMove(t){var s;this.updatePointer(t);const e=this.createPointerContext(t);for(const i of this._sortedActiveTools)if((s=i.onPointerMove)==null?void 0:s.call(i,e))break}onPointerDown(t){var s;this.updatePointerState(t,!0),this.updatePointer(t),this._lastPointerDown.copy(this._pointer);const e=this.createPointerContext(t);for(const i of this._sortedActiveTools)if((s=i.onPointerDown)==null?void 0:s.call(i,e))break}onPointerUp(t){var i,o;this.updatePointer(t);const e=this.createPointerContext(t),s=!this.pointerWasDragged();for(const a of this._sortedActiveTools)if((i=a.onPointerUp)==null?void 0:i.call(a,e))break;if(s){for(const a of this._sortedActiveTools)if((o=a.onClick)==null?void 0:o.call(a,e))break}this.updatePointerState(t,!1)}onWheel(t){var s;const e=this.createWheelContext(t);for(const i of this._sortedActiveTools)if((s=i.onWheel)==null?void 0:s.call(i,e))break}createPointerContext(t){const e=this.raycast();return{event:t,pointer:this._pointer.clone(),intersects:e,modelIntersects:this.filterIntersectsByLayer(e,h.PRODUCT_LAYER_MASK),uiIntersects:this.filterIntersectsByLayer(e,h.UI_LAYER_MASK),pointerPrimaryDown:this._pointerPrimaryDown,pointerMiddleDown:this._pointerMiddleDown,pointerSecondaryDown:this._pointerSecondaryDown,lastPointerDown:this._lastPointerDown.clone()}}createWheelContext(t){const e=this.raycast();return{event:t,pointer:this._pointer.clone(),intersects:e,modelIntersects:this.filterIntersectsByLayer(e,h.PRODUCT_LAYER_MASK),uiIntersects:this.filterIntersectsByLayer(e,h.UI_LAYER_MASK)}}updatePointer(t){this._pointer.x=t.offsetX/this._canvas.clientWidth*2-1,this._pointer.y=-(t.offsetY/this._canvas.clientHeight)*2+1,this._raycaster.setFromCamera(this._pointer,this._controller.object)}updatePointerState(t,e){switch(t.button){case 0:this._pointerPrimaryDown=e;break;case 1:this._pointerMiddleDown=e;break;case 2:this._pointerSecondaryDown=e;break}}raycast(){this._raycaster.layers.mask=h.PRODUCT_LAYER_MASK|h.UI_LAYER_MASK;const t=this._scene.children.filter(e=>e.visible&&"isMesh"in e&&e.isMesh);return this._raycaster.intersectObjects(t,!0)}filterIntersectsByLayer(t,e){return t.filter(s=>(s.object.layers.mask&e)!==0)}updateSortedTools(){this._sortedActiveTools=[...this._activeTools.values()].sort((t,e)=>t.priority-e.priority)}pointerWasDragged(){return this._lastPointerDown.distanceTo(this._pointer)>E}}exports.DIVESelectTool=g;exports.DIVETransformTool=u;exports.DragTool=D;exports.HoverTool=b;exports.SelectTool=g;exports.SelectionState=m;exports.Toolbox=M;exports.TransformTool=u;exports.isSelectTool=P;exports.isTransformTool=w;

package/build/plugins/toolbox/index.mjs

@@ -2,7 +2,7 @@ var S = Object.defineProperty;
 var w = (n, t, e) => t in n ? S(n, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[t] = e;
 var o = (n, t, e) => w(n, typeof t != "symbol" ? t + "" : t, e);
 import { EventDispatcher as T, Vector3 as l, Raycaster as P, Vector2 as f, Layers as m } from "three/webgpu";
-import "../../chunks/FileTypes-DYtXCJQV.mjs";
+import "../../chunks/FileTypes-DiYB3WBp.mjs";
 import { P as _, U as d } from "../../chunks/PerspectiveCamera-B5TvUzTa.mjs";
 import "three/examples/jsm/loaders/HDRLoader.js";
 import "three/tsl";
@@ -395,22 +395,13 @@ class X {
     o(this, "_boundPointerUp");
     o(this, "_boundWheel");
     this._scene = t, this._controller = e, this._canvas = e.domElement, this._selectionState = new z(), this._raycaster = new P(), this._pointer = new f(), this._lastPointerDown = new f(), this._productLayerMask = new m(), this._productLayerMask.set(Math.log2(_)), this._uiLayerMask = new m(), this._uiLayerMask.set(Math.log2(d)), this._tools = /* @__PURE__ */ new Map([
-      [
-        "hover",
-        new C()
-      ],
-      [
-        "select",
-        new M(this._selectionState)
-      ],
+      ["hover", new C()],
+      ["select", new M(this._selectionState)],
       [
         "transform",
         new L(t, e, this._selectionState)
       ],
-      [
-        "drag",
-        new j(e)
-      ]
+      ["drag", new j(e)]
     ]), this._boundPointerMove = this.onPointerMove.bind(this), this._boundPointerDown = this.onPointerDown.bind(this), this._boundPointerUp = this.onPointerUp.bind(this), this._boundWheel = this.onWheel.bind(this), this._canvas.addEventListener("pointermove", this._boundPointerMove), this._canvas.addEventListener("pointerdown", this._boundPointerDown), this._canvas.addEventListener("pointerup", this._boundPointerUp), this._canvas.addEventListener("wheel", this._boundWheel);
   }
   get selectionState() {

package/build/types/schema/BaseEntitySchema.d.ts

@@ -1,8 +1,25 @@
 import { EntityTypeSchema } from './EntityTypeSchema.ts';
+/** What every entity of a scene carries, whatever its type. */
 export type BaseEntitySchema = {
+    /**
+     * Identifies the entity across the whole system: it keys the state's
+     * registry and is what a scene object carries in `userData.id`, which is
+     * how the two are matched up again.
+     */
     id: string;
+    /** Free text for the user interface, not used to look anything up. */
     name: string;
+    /** Discriminates the union, see {@link EntityTypeSchema}. */
     entityType: EntityTypeSchema;
     visible: boolean;
+    /**
+     * The id of the group this entity hangs under, or `null` for the root.
+     *
+     * This is the one field where `null` carries meaning rather than standing
+     * for "not set". A parent that is not in the scene is ignored with a
+     * warning and the entity stays at the root.
+     */
     parentId?: string | null;
+    /** Blocks the entity from being moved through the toolbox. */
+    locked?: boolean;
 };

package/build/types/schema/CameraSchema.d.ts

@@ -0,0 +1,18 @@
+import { Vector3Like } from 'three/webgpu';
+import { BaseEntitySchema } from './BaseEntitySchema.ts';
+import { EntitySchema } from './EntitySchema.ts';
+export declare function isCameraSchema(entity: EntitySchema): entity is CameraSchema;
+/**
+ * A stored point of view that a user can jump to.
+ *
+ * Unlike the other entity types this creates nothing in the scene graph, it
+ * only lives in the state. Moving the camera there is the job of the camera
+ * actions, not of adding the entity.
+ */
+export type CameraSchema = BaseEntitySchema & {
+    entityType: 'camera';
+    /** Where the camera sits. */
+    position: Vector3Like;
+    /** What it looks at, which is also the point it orbits around. */
+    target: Vector3Like;
+};

package/build/types/schema/EntitySchema.d.ts

@@ -1,11 +1,21 @@
-import { PovSchema } from './PovSchema.ts';
+import { CameraSchema } from './CameraSchema.ts';
 import { LightSchema } from './LightSchema.ts';
 import { ModelSchema } from './ModelSchema.ts';
 import { PrimitiveSchema } from './PrimitiveSchema.ts';
 import { GroupSchema } from './GroupSchema.ts';
-export type MinimalSchema<T extends EntitySchema> = T extends EntitySchema ? {
+export type MinimalSchema<T extends EntitySchema | void = void> = T extends EntitySchema ? {
     id: string;
     entityType: T['entityType'];
 } : never;
+/**
+ * A patch of an entity: the id and entity type identify what to change, every
+ * other field is optional.
+ *
+ * A missing field means "leave this as it is". There is no way to unset a field
+ * through a patch, and `null` is not a delete marker: it is only valid where a
+ * schema declares it and carries its own meaning there, as `parentId: null`
+ * does for "sits at the root". Consumers apply exactly the fields that are not
+ * `undefined` and pass everything else through untouched.
+ */
 export type PartialSchema<T extends EntitySchema | void = void> = T extends EntitySchema ? MinimalSchema<T> & Partial<T> : MinimalSchema<EntitySchema> & Partial<EntitySchema>;
-export type EntitySchema = PovSchema | LightSchema | ModelSchema | PrimitiveSchema | GroupSchema;
+export type EntitySchema = CameraSchema | LightSchema | ModelSchema | PrimitiveSchema | GroupSchema;

package/build/types/schema/EntityTypeSchema.d.ts

@@ -1 +1,9 @@
-export type EntityTypeSchema = 'pov' | 'light' | 'model' | 'primitive' | 'group';
+/**
+ * Discriminant of {@link EntitySchema}, and what decides which scene object an
+ * entity turns into.
+ *
+ * Everything but `camera` becomes an object in the scene graph. A camera is a
+ * stored point of view, so adding one registers it without creating anything
+ * to render, which is why an add can resolve without a scene object.
+ */
+export type EntityTypeSchema = 'camera' | 'light' | 'model' | 'primitive' | 'group';

package/build/types/schema/GeometrySchema.d.ts

@@ -1,5 +1,14 @@
 import { GeometryTypeSchema } from './GeometryTypeSchema.ts';
+/**
+ * Describes the shape of a primitive.
+ *
+ * The three dimensions are a common denominator across all shapes rather than
+ * a bounding box, so each type reads only what it needs: a sphere derives its
+ * radius from `width` alone and ignores the other two, while a box uses all
+ * three.
+ */
 export type GeometrySchema = {
+    /** Picks the shape to build, see {@link GeometryTypeSchema}. */
     name: GeometryTypeSchema;
     width: number;
     height: number;

package/build/types/schema/GeometryTypeSchema.d.ts

@@ -1 +1,7 @@
+/**
+ * The shapes a primitive can take.
+ *
+ * `cube` and `box` build the same geometry. An unknown value is not an error,
+ * it only warns and leaves the primitive without a mesh.
+ */
 export type GeometryTypeSchema = 'cylinder' | 'sphere' | 'pyramid' | 'cube' | 'box' | 'cone' | 'wall' | 'plane';

package/build/types/schema/GroupSchema.d.ts

@@ -2,10 +2,17 @@ import { Vector3Like } from 'three/webgpu';
 import { BaseEntitySchema } from './BaseEntitySchema.ts';
 import { EntitySchema } from './EntitySchema.ts';
 export declare function isGroupSchema(entity: EntitySchema): entity is GroupSchema;
+/**
+ * Holds other entities, which reference it through their `parentId`.
+ *
+ * Moving a group moves its members with it. Deleting one keeps the members
+ * alive: they are re-attached to the root and keep their world position.
+ */
 export type GroupSchema = BaseEntitySchema & {
     entityType: 'group';
     position: Vector3Like;
     rotation: Vector3Like;
     scale: Vector3Like;
+    /** Shows the helper lines that run from the group to each of its members. */
     bbVisible?: boolean;
 };

package/build/types/schema/LightSchema.d.ts

@@ -2,27 +2,43 @@ import { Vector3Like } from 'three/webgpu';
 import { BaseEntitySchema } from './BaseEntitySchema.ts';
 import { EntitySchema } from './EntitySchema.ts';
 export declare function isLightSchema(entity: EntitySchema): entity is LightSchema;
+/** What all lights share, regardless of their {@link LightTypeSchema}. */
 export type BaseLightSchema = BaseEntitySchema & {
+    /** Discriminates the light union and picks the class to instantiate. */
     type: LightTypeSchema;
     intensity: number;
     color: string | number;
+    /**
+     * Turns the light itself off while the entity stays in the scene, which is
+     * not the same as `visible` on the entity.
+     */
     enabled: boolean;
+    /** Optional here because only a point light is placed somewhere. */
     position?: Vector3Like;
     rotation?: Vector3Like;
 };
+/** Lights the whole scene evenly, so it has no position to speak of. */
 export type AmbientLightSchema = BaseLightSchema & {
     entityType: 'light';
     type: 'ambient';
 };
+/** Radiates from one point, the only light type that needs a position. */
 export type PointLightSchema = BaseLightSchema & {
     entityType: 'light';
     type: 'point';
     position: Vector3Like;
 };
+/** The preset three point setup that DIVE ships as a default lighting. */
 export type SceneLightSchema = BaseLightSchema & {
     entityType: 'light';
     type: 'scene';
 };
 type LightTypeSchema = 'ambient' | 'point' | 'scene';
+/**
+ * A light in the scene.
+ *
+ * An unknown `type` is a hard error when the entity is added, because there is
+ * no sensible light to fall back to.
+ */
 export type LightSchema = AmbientLightSchema | PointLightSchema | SceneLightSchema;
 export {};

package/build/types/schema/MaterialSchema.d.ts

@@ -1,7 +1,17 @@
 import { Texture } from 'three/webgpu';
+/**
+ * Surface properties of a model or primitive.
+ *
+ * Both carry this as a `Partial`, and a patch is merged into what is already
+ * there field by field. A nested field can therefore be overwritten but not
+ * removed again through an update.
+ *
+ * The `null` on the texture slots means "no texture", not "unchanged".
+ */
 export type MaterialSchema = {
     vertexColors: boolean;
     color: string | number;
+    /** The base colour texture. */
     map: Texture | null;
     normalMap: Texture | null;
     roughness: number;

package/build/types/schema/ModelSchema.d.ts

@@ -3,12 +3,28 @@ import { MaterialSchema } from './MaterialSchema.ts';
 import { BaseEntitySchema } from './BaseEntitySchema.ts';
 import { EntitySchema } from './EntitySchema.ts';
 export declare function isModelSchema(entity: EntitySchema): entity is ModelSchema;
+/**
+ * A 3D asset that is fetched from a uri, the only entity type whose creation
+ * involves a network round trip.
+ */
 export type ModelSchema = BaseEntitySchema & {
     entityType: 'model';
+    /**
+     * Where the asset is loaded from.
+     *
+     * The uri is what identifies the loaded asset, so a patch that repeats the
+     * current one does not fetch anything again. Only a different uri triggers
+     * a reload, and adding or updating a model settles once that finished.
+     */
     uri: string;
     position: Vector3Like;
     rotation: Vector3Like;
     scale: Vector3Like;
+    /**
+     * @deprecated Never written or read. Whether an asset has arrived is
+     * signalled by the `MODEL_LOADED` action instead.
+     */
     loaded: boolean;
+    /** Overrides on top of what the asset itself brings along. */
     material?: Partial<MaterialSchema>;
 };

package/build/types/schema/PrimitiveSchema.d.ts

@@ -4,11 +4,16 @@ import { GeometrySchema } from './GeometrySchema.ts';
 import { MaterialSchema } from './MaterialSchema.ts';
 import { EntitySchema } from './EntitySchema.ts';
 export declare function isPrimitiveSchema(entity: EntitySchema): entity is PrimitiveSchema;
+/**
+ * A shape that DIVE generates itself, so unlike a model it needs no asset and
+ * is there the moment it is added.
+ */
 export type PrimitiveSchema = BaseEntitySchema & {
     entityType: 'primitive';
     position: Vector3Like;
     rotation: Vector3Like;
     scale: Vector3Like;
+    /** Rebuilding this replaces the mesh, see {@link GeometrySchema}. */
     geometry: GeometrySchema;
     material?: Partial<MaterialSchema>;
 };

package/build/types/schema/index.d.ts

@@ -7,5 +7,5 @@ export * from './GroupSchema.ts';
 export * from './LightSchema.ts';
 export * from './MaterialSchema.ts';
 export * from './ModelSchema.ts';
-export * from './PovSchema.ts';
+export * from './CameraSchema.ts';
 export * from './PrimitiveSchema.ts';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@shopware-ag/dive",
-    "version": "3.0.11",
+    "version": "3.1.0",
     "description": "Shopware Spatial Framework",
     "type": "module",
     "main": "build/dive.cjs",
@@ -107,9 +107,8 @@
         "> 1%, not dead, not ie 11, not op_mini all"
     ],
     "dependencies": {
-        "three": "^0.183.0",
+        "three": "^0.185.1",
         "@tweenjs/tween.js": "^25.0.0",
-        "three-spritetext": "^1.8.2",
         "lodash": "^4.18.1",
         "occt-import-js": "^0.0.23"
     },
@@ -119,8 +118,8 @@
         "@types/jest": "^29.5.12",
         "@types/lodash": "^4.17.12",
         "@types/node": "^20.12.7",
-        "@types/three": "^0.183.0",
-        "@vitest/coverage-v8": "3.1.2",
+        "@types/three": "^0.185.1",
+        "@vitest/coverage-v8": "3.2.7",
         "acorn": "^8.14.1",
         "acorn-walk": "^8.3.4",
         "chokidar": "^3.6.0",
@@ -130,13 +129,11 @@
         "jsdom": "^26.1.0",
         "log-update": "^6.1.0",
         "magic-string": "^0.30.17",
-        "prettier": "^3.3.3",
-        "prettier-plugin-multiline-arrays": "^3.0.6",
+        "prettier": "^3.9.6",
         "rollup-plugin-copy": "^3.5.0",
         "ts-jest": "^29.1.2",
         "ts-morph": "^25.0.1",
         "ts-node": "^10.9.2",
-        "tsc": "^2.0.4",
         "tsx": "^4.19.4",
         "typescript": "^5.8.2",
         "typescript-eslint": "^7.7.1",
@@ -148,7 +145,9 @@
     },
     "resolutions": {
         "lodash": "4.18.1",
-        "vite-plugin-dts/@microsoft/api-extractor/minimatch": "3.1.5"
+        "vite-plugin-dts/@microsoft/api-extractor/minimatch": "3.1.5",
+        "minimatch/brace-expansion": "1.1.16",
+        "fast-uri": "^3.1.5"
     },
     "scripts": {
         "build": "vite build",

package/build/chunks/PovSchema-Co9FznEz.cjs

@@ -1 +0,0 @@
-"use strict";function t(e){return e.entityType==="model"}function i(e){return e.entityType==="pov"}exports.isModelSchema=t;exports.isPovSchema=i;

package/build/types/schema/PovSchema.d.ts

@@ -1,10 +0,0 @@
-import { Vector3Like } from 'three/webgpu';
-import { BaseEntitySchema } from './BaseEntitySchema.ts';
-import { EntitySchema } from './EntitySchema.ts';
-export declare function isPovSchema(entity: EntitySchema): entity is PovSchema;
-export type PovSchema = BaseEntitySchema & {
-    entityType: 'pov';
-    position: Vector3Like;
-    target: Vector3Like;
-    locked?: boolean;
-};