@shopware-ag/dive 1.16.7 → 1.16.9

package/build/dive.d.cts

@@ -1,4 +1,4 @@
-import { ShadowMapType, ToneMapping, WebGLRenderer, Scene, Camera, PerspectiveCamera, Box3, Vector3Like, Texture, Object3D, Color, Mesh, ColorRepresentation, Intersection, Vector2, Raycaster, Vector3 } from 'three';
+import { ShadowMapType, ToneMapping, WebGLRenderer, Scene, Camera, PerspectiveCamera, Box3, Vector3Like, Texture, Object3D, Vector3, Color, Mesh, ColorRepresentation, Intersection, Vector2, Raycaster } from 'three';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls';
 import { Tween } from '@tweenjs/tween.js';
 import { TransformControls } from 'three/examples/jsm/controls/TransformControls';
@@ -235,6 +235,7 @@ type COMLight = COMBaseEntity & {
     color: string | number;
     enabled: boolean;
     position?: Vector3Like;
+    rotation?: Vector3Like;
 };
 
 type COMMaterial = {
@@ -354,76 +355,6 @@ interface GENERATE_MEDIA {
     RETURN: boolean;
 }
 
-type SceneData = {
-    name: string;
-    mediaItem: null;
-    backgroundColor: string;
-    floorEnabled: boolean;
-    floorColor: string;
-    userCamera: {
-        position: Vector3Like;
-        target: Vector3Like;
-    };
-    spotmarks: object[];
-    lights: COMLight[];
-    objects: COMModel[];
-    cameras: COMPov[];
-    primitives: COMPrimitive[];
-};
-interface GET_ALL_SCENE_DATA {
-    DESCRIPTION: 'Retrieves all current scene data.';
-    PAYLOAD: object;
-    RETURN: SceneData;
-}
-
-interface SELECT_OBJECT {
-    DESCRIPTION: 'Selects an existing object.';
-    PAYLOAD: Partial<COMEntity> & {
-        id: string;
-    };
-    RETURN: boolean;
-}
-
-interface DESELECT_OBJECT {
-    DESCRIPTION: 'Deselects an existing object.';
-    PAYLOAD: Partial<COMEntity> & {
-        id: string;
-    };
-    RETURN: boolean;
-}
-
-interface GET_CAMERA_TRANSFORM {
-    DESCRIPTION: 'Returns the current camera position and target.';
-    PAYLOAD: object;
-    RETURN: {
-        position: Vector3Like;
-        target: Vector3Like;
-    };
-}
-
-interface DROP_IT {
-    DESCRIPTION: 'Places an object on top of an underlying object or the floor.';
-    PAYLOAD: {
-        id: string;
-    };
-    RETURN: boolean;
-}
-
-interface SET_GIZMO_VISIBILITY {
-    DESCRIPTION: "Sets the gizmo's visibility.";
-    PAYLOAD: boolean;
-    RETURN: boolean;
-}
-
-interface COMPUTE_ENCOMPASSING_VIEW {
-    DESCRIPTION: 'Calculates the camera position and target to view the whole scene. (experimental)';
-    PAYLOAD: object;
-    RETURN: {
-        position: Vector3Like;
-        target: Vector3Like;
-    };
-}
-
 /**
  * Interface for objects that can be moved in the scene.
  *
@@ -452,6 +383,7 @@ declare class DIVENode extends Object3D implements DIVESelectable, DIVEMovable {
     readonly isSelectable: true;
     readonly isMovable: true;
     gizmo: TransformControls | null;
+    protected _positionWorldBuffer: Vector3;
     protected _boundingBox: Box3;
     constructor();
     SetPosition(position: Vector3Like): void;
@@ -459,6 +391,9 @@ declare class DIVENode extends Object3D implements DIVESelectable, DIVEMovable {
     SetScale(scale: Vector3Like): void;
     SetVisibility(visible: boolean): void;
     SetToWorldOrigin(): void;
+    /**
+     * Can be called when the object is moved from a foreign object (gizmo, parent, etc.) to update the object's position.
+     */
     onMove(): void;
     onSelect(): void;
     onDeselect(): void;
@@ -469,6 +404,7 @@ declare class DIVEGroup extends DIVENode {
     private _members;
     private _lines;
     constructor();
+    SetPosition(position: Vector3Like): void;
     SetLinesVisibility(visible: boolean, object?: Object3D): void;
     attach(object: DIVESceneObject): this;
     remove(object: DIVESceneObject): this;
@@ -596,6 +532,78 @@ type DIVESceneFileType = {
     glb: GLTF$1;
 };
 
+type DIVESceneData = {
+    name: string;
+    mediaItem: null;
+    backgroundColor: string;
+    floorEnabled: boolean;
+    floorColor: string;
+    userCamera: {
+        position: Vector3Like;
+        target: Vector3Like;
+    };
+    spotmarks: object[];
+    lights: COMLight[];
+    objects: COMModel[];
+    cameras: COMPov[];
+    primitives: COMPrimitive[];
+    groups: COMGroup[];
+};
+
+interface GET_ALL_SCENE_DATA {
+    DESCRIPTION: 'Retrieves all current scene data.';
+    PAYLOAD: object;
+    RETURN: DIVESceneData;
+}
+
+interface SELECT_OBJECT {
+    DESCRIPTION: 'Selects an existing object.';
+    PAYLOAD: Partial<COMEntity> & {
+        id: string;
+    };
+    RETURN: boolean;
+}
+
+interface DESELECT_OBJECT {
+    DESCRIPTION: 'Deselects an existing object.';
+    PAYLOAD: Partial<COMEntity> & {
+        id: string;
+    };
+    RETURN: boolean;
+}
+
+interface GET_CAMERA_TRANSFORM {
+    DESCRIPTION: 'Returns the current camera position and target.';
+    PAYLOAD: object;
+    RETURN: {
+        position: Vector3Like;
+        target: Vector3Like;
+    };
+}
+
+interface DROP_IT {
+    DESCRIPTION: 'Places an object on top of an underlying object or the floor.';
+    PAYLOAD: {
+        id: string;
+    };
+    RETURN: boolean;
+}
+
+interface SET_GIZMO_VISIBILITY {
+    DESCRIPTION: "Sets the gizmo's visibility.";
+    PAYLOAD: boolean;
+    RETURN: boolean;
+}
+
+interface COMPUTE_ENCOMPASSING_VIEW {
+    DESCRIPTION: 'Calculates the camera position and target to view the whole scene. (experimental)';
+    PAYLOAD: object;
+    RETURN: {
+        position: Vector3Like;
+        target: Vector3Like;
+    };
+}
+
 /**
  * A basic scene node to hold grid, floor and all lower level roots.
  *
@@ -1001,6 +1009,10 @@ declare function toFixedExp(number: number, decimals?: number): string;
 
 declare function truncateExp(number: number, decimals?: number): number;
 
+declare function radToDeg(radians: number): number;
+
+declare function degToRad(degrees: number): number;
+
 declare const DIVEMath: {
     ceilExp: typeof ceilExp;
     floorExp: typeof floorExp;
@@ -1008,6 +1020,8 @@ declare const DIVEMath: {
     toFixedExp: typeof toFixedExp;
     truncateExp: typeof truncateExp;
     signedAngleTo: typeof signedAngleTo;
+    radToDeg: typeof radToDeg;
+    degToRad: typeof degToRad;
 };
 
 type DIVESettings = {
@@ -1065,4 +1079,4 @@ declare class DIVE {
     private removeResizeObserver;
 }
 
-export { type Actions, type COMEntity, type COMEntityType, type COMGeometry, type COMGeometryType, type COMGroup, type COMLight, type COMMaterial, type COMModel, type COMPov, type COMPrimitive, DIVE, DIVECommunication, DIVEDefaultSettings, DIVEMath, type DIVESettings, DIVE as default };
+export { type Actions, type COMEntity, type COMEntityType, type COMGeometry, type COMGeometryType, type COMGroup, type COMLight, type COMMaterial, type COMModel, type COMPov, type COMPrimitive, DIVE, DIVECommunication, DIVEDefaultSettings, DIVEMath, type DIVESceneData, type DIVESceneFileType, type DIVESceneObject, type DIVESettings, DIVE as default };

package/build/dive.d.ts

@@ -1,4 +1,4 @@
-import { ShadowMapType, ToneMapping, WebGLRenderer, Scene, Camera, PerspectiveCamera, Box3, Vector3Like, Texture, Object3D, Color, Mesh, ColorRepresentation, Intersection, Vector2, Raycaster, Vector3 } from 'three';
+import { ShadowMapType, ToneMapping, WebGLRenderer, Scene, Camera, PerspectiveCamera, Box3, Vector3Like, Texture, Object3D, Vector3, Color, Mesh, ColorRepresentation, Intersection, Vector2, Raycaster } from 'three';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls';
 import { Tween } from '@tweenjs/tween.js';
 import { TransformControls } from 'three/examples/jsm/controls/TransformControls';
@@ -235,6 +235,7 @@ type COMLight = COMBaseEntity & {
     color: string | number;
     enabled: boolean;
     position?: Vector3Like;
+    rotation?: Vector3Like;
 };
 
 type COMMaterial = {
@@ -354,76 +355,6 @@ interface GENERATE_MEDIA {
     RETURN: boolean;
 }
 
-type SceneData = {
-    name: string;
-    mediaItem: null;
-    backgroundColor: string;
-    floorEnabled: boolean;
-    floorColor: string;
-    userCamera: {
-        position: Vector3Like;
-        target: Vector3Like;
-    };
-    spotmarks: object[];
-    lights: COMLight[];
-    objects: COMModel[];
-    cameras: COMPov[];
-    primitives: COMPrimitive[];
-};
-interface GET_ALL_SCENE_DATA {
-    DESCRIPTION: 'Retrieves all current scene data.';
-    PAYLOAD: object;
-    RETURN: SceneData;
-}
-
-interface SELECT_OBJECT {
-    DESCRIPTION: 'Selects an existing object.';
-    PAYLOAD: Partial<COMEntity> & {
-        id: string;
-    };
-    RETURN: boolean;
-}
-
-interface DESELECT_OBJECT {
-    DESCRIPTION: 'Deselects an existing object.';
-    PAYLOAD: Partial<COMEntity> & {
-        id: string;
-    };
-    RETURN: boolean;
-}
-
-interface GET_CAMERA_TRANSFORM {
-    DESCRIPTION: 'Returns the current camera position and target.';
-    PAYLOAD: object;
-    RETURN: {
-        position: Vector3Like;
-        target: Vector3Like;
-    };
-}
-
-interface DROP_IT {
-    DESCRIPTION: 'Places an object on top of an underlying object or the floor.';
-    PAYLOAD: {
-        id: string;
-    };
-    RETURN: boolean;
-}
-
-interface SET_GIZMO_VISIBILITY {
-    DESCRIPTION: "Sets the gizmo's visibility.";
-    PAYLOAD: boolean;
-    RETURN: boolean;
-}
-
-interface COMPUTE_ENCOMPASSING_VIEW {
-    DESCRIPTION: 'Calculates the camera position and target to view the whole scene. (experimental)';
-    PAYLOAD: object;
-    RETURN: {
-        position: Vector3Like;
-        target: Vector3Like;
-    };
-}
-
 /**
  * Interface for objects that can be moved in the scene.
  *
@@ -452,6 +383,7 @@ declare class DIVENode extends Object3D implements DIVESelectable, DIVEMovable {
     readonly isSelectable: true;
     readonly isMovable: true;
     gizmo: TransformControls | null;
+    protected _positionWorldBuffer: Vector3;
     protected _boundingBox: Box3;
     constructor();
     SetPosition(position: Vector3Like): void;
@@ -459,6 +391,9 @@ declare class DIVENode extends Object3D implements DIVESelectable, DIVEMovable {
     SetScale(scale: Vector3Like): void;
     SetVisibility(visible: boolean): void;
     SetToWorldOrigin(): void;
+    /**
+     * Can be called when the object is moved from a foreign object (gizmo, parent, etc.) to update the object's position.
+     */
     onMove(): void;
     onSelect(): void;
     onDeselect(): void;
@@ -469,6 +404,7 @@ declare class DIVEGroup extends DIVENode {
     private _members;
     private _lines;
     constructor();
+    SetPosition(position: Vector3Like): void;
     SetLinesVisibility(visible: boolean, object?: Object3D): void;
     attach(object: DIVESceneObject): this;
     remove(object: DIVESceneObject): this;
@@ -596,6 +532,78 @@ type DIVESceneFileType = {
     glb: GLTF$1;
 };
 
+type DIVESceneData = {
+    name: string;
+    mediaItem: null;
+    backgroundColor: string;
+    floorEnabled: boolean;
+    floorColor: string;
+    userCamera: {
+        position: Vector3Like;
+        target: Vector3Like;
+    };
+    spotmarks: object[];
+    lights: COMLight[];
+    objects: COMModel[];
+    cameras: COMPov[];
+    primitives: COMPrimitive[];
+    groups: COMGroup[];
+};
+
+interface GET_ALL_SCENE_DATA {
+    DESCRIPTION: 'Retrieves all current scene data.';
+    PAYLOAD: object;
+    RETURN: DIVESceneData;
+}
+
+interface SELECT_OBJECT {
+    DESCRIPTION: 'Selects an existing object.';
+    PAYLOAD: Partial<COMEntity> & {
+        id: string;
+    };
+    RETURN: boolean;
+}
+
+interface DESELECT_OBJECT {
+    DESCRIPTION: 'Deselects an existing object.';
+    PAYLOAD: Partial<COMEntity> & {
+        id: string;
+    };
+    RETURN: boolean;
+}
+
+interface GET_CAMERA_TRANSFORM {
+    DESCRIPTION: 'Returns the current camera position and target.';
+    PAYLOAD: object;
+    RETURN: {
+        position: Vector3Like;
+        target: Vector3Like;
+    };
+}
+
+interface DROP_IT {
+    DESCRIPTION: 'Places an object on top of an underlying object or the floor.';
+    PAYLOAD: {
+        id: string;
+    };
+    RETURN: boolean;
+}
+
+interface SET_GIZMO_VISIBILITY {
+    DESCRIPTION: "Sets the gizmo's visibility.";
+    PAYLOAD: boolean;
+    RETURN: boolean;
+}
+
+interface COMPUTE_ENCOMPASSING_VIEW {
+    DESCRIPTION: 'Calculates the camera position and target to view the whole scene. (experimental)';
+    PAYLOAD: object;
+    RETURN: {
+        position: Vector3Like;
+        target: Vector3Like;
+    };
+}
+
 /**
  * A basic scene node to hold grid, floor and all lower level roots.
  *
@@ -1001,6 +1009,10 @@ declare function toFixedExp(number: number, decimals?: number): string;
 
 declare function truncateExp(number: number, decimals?: number): number;
 
+declare function radToDeg(radians: number): number;
+
+declare function degToRad(degrees: number): number;
+
 declare const DIVEMath: {
     ceilExp: typeof ceilExp;
     floorExp: typeof floorExp;
@@ -1008,6 +1020,8 @@ declare const DIVEMath: {
     toFixedExp: typeof toFixedExp;
     truncateExp: typeof truncateExp;
     signedAngleTo: typeof signedAngleTo;
+    radToDeg: typeof radToDeg;
+    degToRad: typeof degToRad;
 };
 
 type DIVESettings = {
@@ -1065,4 +1079,4 @@ declare class DIVE {
     private removeResizeObserver;
 }
 
-export { type Actions, type COMEntity, type COMEntityType, type COMGeometry, type COMGeometryType, type COMGroup, type COMLight, type COMMaterial, type COMModel, type COMPov, type COMPrimitive, DIVE, DIVECommunication, DIVEDefaultSettings, DIVEMath, type DIVESettings, DIVE as default };
+export { type Actions, type COMEntity, type COMEntityType, type COMGeometry, type COMGeometryType, type COMGroup, type COMLight, type COMMaterial, type COMModel, type COMPov, type COMPrimitive, DIVE, DIVECommunication, DIVEDefaultSettings, DIVEMath, type DIVESceneData, type DIVESceneFileType, type DIVESceneObject, type DIVESettings, DIVE as default };