soonspacejs 2.3.17 → 2.3.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soonspacejs",
-  "version": "2.3.17",
+  "version": "2.3.20",
   "description": "soonspacejs 2.x",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -17,9 +17,9 @@
     "@robotlegsjs/signals": "1.1.0",
     "@soonspacejs/xml2json": "0.0.2",
     "@tweenjs/tween.js": "18.6.4",
-    "@types/three": "^0.138.0",
+    "@types/three": "0.139.0",
     "localforage": "1.9.0",
-    "three": "^0.138.3"
+    "three": "0.139.0"
   },
-  "gitHead": "615a37b746fc1f12beab499a49807a4fdd667688"
+  "gitHead": "e1703d68f492f42e428f921e5436aa425346d20e"
 }

package/types/Interface/base.d.ts

@@ -38,4 +38,10 @@ interface ObjectEvents<ObjectType> {
     onDblClick?: ((object: ObjectType) => void) | null;
     onRightClick?: ((object: ObjectType) => void) | null;
 }
+export interface ObjectEventsListener {
+    type: 'click' | 'rightClick' | 'dblClick';
+}
+export interface Interpolate {
+    t: number;
+}
 export { IVector2, IVector3, Position, Rotation, Scale, IColor, PlaneIVector2, Level, OffsetPoint, FlyToViewpoint, AxisType, SceneEventType, PoiNodeType, BaseSelectOptions, ObjectEvents, };

package/types/Interface/viewport.d.ts

@@ -66,6 +66,7 @@ interface SkyOptions {
 interface ViewportOptions {
     showInfo?: boolean;
     showStats?: boolean;
+    showViewHelper?: boolean;
     showGrid?: boolean | GridHelperOptions;
     background?: {
         color?: IColor | null;

package/types/Library/BaseMesh.d.ts

@@ -1,5 +1,6 @@
 import { Box3, Vector3, Euler, Mesh, BufferGeometry, Material } from 'three';
-import { Position, Rotation, Scale, Level, AnimationOptions } from '../Interface';
+import { Tween } from '@tweenjs/tween.js';
+import { Position, Rotation, Scale, Level, AnimationOptions, Interpolate } from '../Interface';
 import { BaseObject3DInfo } from './BaseObject3D';
 declare type BaseMeshInfo = BaseObject3DInfo;
 declare class BaseMesh extends Mesh {
@@ -12,9 +13,9 @@ declare class BaseMesh extends Mesh {
     constructor(geometry: BufferGeometry, material: Material | Material[], param: BaseMeshInfo, type?: string);
     show(): void;
     hide(): void;
-    setMove(position: Position | Vector3, options?: AnimationOptions): Promise<void>;
-    setRotate(rotation: Rotation | Euler, options?: AnimationOptions): Promise<void>;
-    setScale(scale: Scale | Vector3, options?: AnimationOptions): Promise<void>;
+    setMove(position: Position | Vector3, options?: AnimationOptions, onUpdate?: (source: Position, tween: Tween<Position>) => void, onStart?: (tween: Tween<Position>) => void): Promise<void>;
+    setRotate(rotation: Rotation | Euler, options?: AnimationOptions, onUpdate?: (source: Rotation, tween: Tween<Interpolate>) => void, onStart?: (tween: Tween<Interpolate>) => void): Promise<void>;
+    setScale(scale: Scale | Vector3, options?: AnimationOptions, onUpdate?: (source: Scale, tween: Tween<Scale>) => void, onStart?: (tween: Tween<Scale>) => void): Promise<void>;
     getBoundingBox(): Box3;
     eventPropagation(): void;
     sClone(recursive?: boolean): BaseMesh;

package/types/Library/BaseObject3D.d.ts

@@ -1,6 +1,6 @@
-import { Object3D, Vector3, Euler } from 'three';
+import { Object3D, Vector3, Euler, BaseEvent, Event } from 'three';
 import { Tween } from '@tweenjs/tween.js';
-import { Position, Rotation, Scale, Level, AnimationOptions } from '../Interface';
+import { Position, Rotation, Scale, Level, AnimationOptions, Interpolate } from '../Interface';
 interface BaseObject3DInfo {
     id: string | number;
     name?: string;
@@ -11,7 +11,7 @@ interface BaseObject3DInfo {
     scale?: Scale;
     userData?: any;
 }
-declare class BaseObject3D extends Object3D {
+declare class BaseObject3D<E extends BaseEvent = Event> extends Object3D<E> {
     sid: string | number;
     stype: string;
     handleHide: boolean;
@@ -21,7 +21,7 @@ declare class BaseObject3D extends Object3D {
     show(): void;
     hide(): void;
     setMove(position: Position | Vector3, options?: AnimationOptions, onUpdate?: (source: Position, tween: Tween<Position>) => void, onStart?: (tween: Tween<Position>) => void): Promise<void>;
-    setRotate(rotation: Rotation | Euler, options?: AnimationOptions, onUpdate?: (source: Rotation, tween: Tween<Rotation>) => void, onStart?: (tween: Tween<Rotation>) => void): Promise<void>;
+    setRotate(rotation: Rotation | Euler, options?: AnimationOptions, onUpdate?: (source: Rotation, tween: Tween<Interpolate>) => void, onStart?: (tween: Tween<Interpolate>) => void): Promise<void>;
     setScale(scale: Scale | Vector3, options?: AnimationOptions, onUpdate?: (source: Scale, tween: Tween<Scale>) => void, onStart?: (tween: Tween<Scale>) => void): Promise<void>;
     sClone<T extends BaseObject3D>(recursive?: boolean): T;
     sCopy<T extends BaseObject3D>(source: BaseObject3D, recursive?: boolean): T;

package/types/Library/Circle.d.ts

@@ -1,9 +1,11 @@
 import { IColor } from '../Interface';
 import { BaseMesh, BaseMeshInfo } from './BaseMesh';
+import { GradientTextureOptions } from '../Shared';
 interface CircleInfo extends BaseMeshInfo {
     radius?: number;
     color?: IColor;
     opacity?: number;
+    gradient?: GradientTextureOptions;
 }
 declare type SetOptionsCircleInfo = Omit<CircleInfo, 'id'>;
 declare class Circle extends BaseMesh {

package/types/Library/Line.d.ts

@@ -1,3 +1,4 @@
+import { GradientTextureOptions } from '../Shared';
 import { Position, IColor } from '../Interface';
 import { BaseMesh, BaseMeshInfo } from './BaseMesh';
 interface LineInfo extends BaseMeshInfo {
@@ -5,6 +6,7 @@ interface LineInfo extends BaseMeshInfo {
     width?: number;
     color?: IColor;
     opacity?: number;
+    gradient?: GradientTextureOptions;
 }
 declare type SetOptionsLineInfo = Omit<LineInfo, 'id'>;
 declare class Line extends BaseMesh {

package/types/Library/Model.d.ts

@@ -1,13 +1,13 @@
 import { Box3 } from 'three';
 import { BaseObject3D, BaseObject3DInfo } from './BaseObject3D';
-import { ObjectEvents } from '../Interface';
+import { ObjectEvents, ObjectEventsListener } from '../Interface';
 interface ModelInfo extends BaseObject3DInfo, ObjectEvents<Model> {
     url: string;
 }
 interface ModelInnerInfo extends ModelInfo {
     format: string;
 }
-declare class Model extends BaseObject3D implements ObjectEvents<Model> {
+declare class Model extends BaseObject3D<ObjectEventsListener> implements ObjectEvents<Model> {
     readonly formatType: string;
     isEventPropagation: boolean;
     onLoad: ((object: Model) => void) | null;

package/types/Library/Poi.d.ts

@@ -1,7 +1,7 @@
 import { BaseObject3D, BaseObject3DInfo } from './BaseObject3D';
 import { Icon, IconInfo } from './Icon';
 import { SpriteMaterial, Box3 } from 'three';
-import { ObjectEvents, Scale } from '../Interface';
+import { ObjectEvents, ObjectEventsListener, Scale } from '../Interface';
 interface PoiInfo extends BaseObject3DInfo, ObjectEvents<Poi> {
     url: string;
     nameScale?: Scale;
@@ -13,7 +13,7 @@ interface CanvasTextInfo {
     textAlign?: CanvasTextAlign;
     textBaseline?: CanvasTextBaseline;
 }
-declare class Poi extends BaseObject3D implements ObjectEvents<Poi> {
+declare class Poi extends BaseObject3D<ObjectEventsListener> implements ObjectEvents<Poi> {
     icon: Icon;
     text: Icon | null;
     isEventPropagation: boolean;

package/types/Library/Point.d.ts

@@ -1,9 +1,11 @@
 import { BaseMesh, BaseMeshInfo } from './BaseMesh';
 import { IColor } from '../Interface';
+import { GradientTextureOptions } from '../Shared';
 interface PointInfo extends BaseMeshInfo {
     radius?: number;
     color?: IColor;
     opacity?: number;
+    gradient?: GradientTextureOptions;
 }
 declare type SetOptionsPointInfo = Omit<PointInfo, 'id'>;
 declare class Point extends BaseMesh {

package/types/Library/Polygon.d.ts

@@ -1,10 +1,12 @@
 import { IColor, PlaneIVector2 } from '../Interface';
 import { BaseMesh, BaseMeshInfo } from './BaseMesh';
+import { GradientTextureOptions } from '../Shared';
 interface PolygonInfo extends BaseMeshInfo {
     yHeight: number;
     points: PlaneIVector2[];
     color?: IColor;
     opacity?: number;
+    gradient?: GradientTextureOptions;
 }
 declare type SetOptionsPolygonInfo = Omit<PolygonInfo, 'id'>;
 declare class Polygon extends BaseMesh {

package/types/Library/Sbm.d.ts

@@ -1,11 +1,11 @@
 import { Box3 } from 'three';
 import { BaseObject3D, BaseObject3DInfo } from './BaseObject3D';
-import { ObjectEvents } from '../Interface';
+import { ObjectEvents, ObjectEventsListener } from '../Interface';
 interface SbmInfo extends BaseObject3DInfo, ObjectEvents<Sbm> {
     url: string;
     isPlatform?: boolean;
 }
-declare class Sbm extends BaseObject3D implements ObjectEvents<Sbm> {
+declare class Sbm extends BaseObject3D<ObjectEventsListener> implements ObjectEvents<Sbm> {
     isEventPropagation: boolean;
     onLoad: ((object: Sbm) => void) | null;
     onClick: ((object: Sbm) => void) | null;

package/types/Shared/map.d.ts

@@ -1,3 +1,11 @@
-import { CubeTexture } from 'three';
+import { CubeTexture, Texture } from 'three';
+import { IColor } from '../Interface';
 declare function getCubeTexture(dirPath: string, fileNames?: string[]): Promise<CubeTexture>;
 export { getCubeTexture, };
+interface GradientTextureOptions {
+    colors: IColor[];
+    stops?: number[];
+    size?: number;
+}
+declare function gradientTexture(options?: GradientTextureOptions): Texture | null;
+export { GradientTextureOptions, gradientTexture, };

package/types/Viewport/CameraManager.d.ts

@@ -16,7 +16,7 @@ declare class cameraManager {
     getMainCamera(): PerspectiveCamera;
     getCameraViewpoint(): CameraViewpointData;
     setCameraViewpoint(data: CameraViewpointData): void;
-    rotateTo(rotation: Rotation, options?: AnimationOptions): Promise<void>;
+    rotateTo(rotation: Euler, options?: AnimationOptions): Promise<void>;
     moveTo(position: Position, options?: AnimationOptions): Promise<void>;
     flyTo(position: Position, rotation?: FlyToViewpoint | Rotation | Euler, options?: AnimationOptions): Promise<void>;
     flyToBoundingBox(bbox: Box3, rotation?: FlyToViewpoint | Rotation | Euler, options?: AnimationOptions): Promise<void>;

package/types/Viewport/ViewHelper.d.ts

@@ -0,0 +1,7 @@
+import * as THREE from 'three';
+import { Camera, WebGLRenderer } from 'three';
+declare class ViewHelper extends THREE.Object3D {
+    render: (renderer: WebGLRenderer) => void;
+    constructor(editorCamera: Camera, dom: HTMLElement);
+}
+export { ViewHelper, };

package/types/Viewport/index.d.ts

@@ -1,15 +1,16 @@
 import { Scene, PerspectiveCamera, WebGLRenderer, PMREMGenerator, Vector3, AnimationMixer, Intersection, Object3D, AnimationAction, AnimationClip } from 'three';
+import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
 import Stats from 'three/examples/jsm/libs/stats.module.js';
 import { Sky } from 'three/examples/jsm/objects/Sky.js';
 import Scener from './Scener';
 import { CSS2DRenderer, CSS2DHalfRenderer, CSS3DRenderer } from '../Renderer';
-import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
 import RendererManager, { PassObj } from './RendererManager';
 import CameraManager from './CameraManager';
 import { FullFreeControls } from '../Controls';
 import { Model } from '../Library';
 import { ColorSpace, SkyOptions, IColor, OffsetPoint, SceneEventType, Position, ViewportOptions, ViewportState, ModelAnimationFindFunc, SignalsState, BloomOptions, SobelOptions } from '../Interface';
 import Info from './Info';
+import { ViewHelper } from './ViewHelper';
 export declare const innerRenderState: Record<string, boolean>;
 declare class Viewport {
     options: ViewportOptions;
@@ -45,9 +46,11 @@ declare class Viewport {
     private selectModel;
     private selectPoi;
     private _loop;
+    viewHelper: ViewHelper;
     constructor(options: ViewportOptions);
-    initInfo(): void;
-    initStats(): void;
+    _initInfo(): void;
+    _initStats(): void;
+    _initViewHelper(): void;
     setSobel(options?: SobelOptions): void;
     /**
      ***************************** renderer ***************************

package/types/index.d.ts

@@ -31,6 +31,7 @@ declare global {
     }
 }
 export default class SoonSpace {
+    static readonly THREE: typeof THREE;
     readonly THREE: typeof THREE;
     readonly THREE_PLUGINS: {
         TransformControls: typeof TransformControls;

package/types/environments/RoomEnvironment.d.ts

@@ -1,8 +0,0 @@
-/**
- * https://github.com/google/model-viewer/blob/master/packages/model-viewer/src/three-components/EnvironmentScene.ts
- */
-import { Scene } from 'three';
-declare class RoomEnvironment extends Scene {
-    constructor();
-}
-export { RoomEnvironment, };

package/types/environments/index.d.ts

@@ -1 +0,0 @@
-export { RoomEnvironment, } from './RoomEnvironment';