string-tune-3d 0.0.3 → 0.0.5

package/dist/index.d.mts

@@ -61,6 +61,8 @@ interface I3DObject {
 interface I3DMesh extends I3DObject {
     geometry: I3DGeometry;
     material: I3DMaterial | I3DMaterial[];
+    castShadow: boolean;
+    receiveShadow: boolean;
 }
 interface I3DGeometry {
     dispose(): void;
@@ -75,6 +77,13 @@ interface I3DMaterial {
 interface I3DLight extends I3DObject {
     color: any;
     intensity: number;
+    castShadow?: boolean;
+    shadow?: any;
+    target?: I3DObject;
+    distance?: number;
+    decay?: number;
+    angle?: number;
+    penumbra?: number;
 }
 interface I3DCamera extends I3DObject {
     aspect: number;
@@ -103,6 +112,11 @@ interface I3DRenderer {
     setPixelRatio(ratio: number): void;
     render(scene: I3DScene, camera: I3DCamera): void;
     dispose(): void;
+    outputEncoding: any;
+    shadowMap: {
+        enabled: boolean;
+        type: any;
+    };
 }
 interface I3DTextureLoader {
     load(url: string, onLoad?: (texture: any) => void): any;
@@ -134,6 +148,8 @@ interface I3DEngine {
     createMeshBasicMaterial(params?: any): I3DMaterial;
     createMeshStandardMaterial(params?: any): I3DMaterial;
     createPointLight(color?: string | number, intensity?: number, distance?: number, decay?: number): I3DLight;
+    createSpotLight(color?: string | number, intensity?: number, distance?: number, angle?: number, penumbra?: number, decay?: number): I3DLight;
+    createHemisphereLight(skyColor?: string | number, groundColor?: string | number, intensity?: number): I3DLight;
     createAmbientLight(color?: string | number, intensity?: number): I3DLight;
     createDirectionalLight(color?: string | number, intensity?: number): I3DLight;
     createTextureLoader(): I3DTextureLoader;
@@ -152,6 +168,12 @@ interface String3DOptions {
     hideHTML?: boolean;
     container?: string | HTMLElement;
     zIndex?: number;
+    modelLoaderType?: string;
+    modelLoader?: I3DModelLoader;
+    modelLoaderFactory?: (engine: I3DEngine, type?: string) => I3DModelLoader;
+    useDirtySync?: boolean;
+    useTransformWorker?: boolean;
+    transformWorkerWasmUrl?: string;
 }
 declare class String3D extends StringModule {
     private static provider;
@@ -163,18 +185,50 @@ declare class String3D extends StringModule {
     private canvasContainer;
     private isLoading;
     private options;
+    private useDirtySync;
+    private dirtyElements;
+    private observedElements;
+    private resizeObserver;
+    private mutationObserver;
+    private lastSyncData;
+    private transformWorker;
+    private workerHasResult;
+    private workerObjectMap;
+    private domVersion;
+    private lastSubmittedVersion;
+    private scrollTicking;
+    private onScrollBound;
     static setProvider(provider: I3DEngineProvider): void;
-    constructor(context: StringContext, options?: String3DOptions);
+    constructor(context: StringContext);
     canConnect(object: StringObject): boolean;
     initializeObject(globalId: number, object: StringObject, element: HTMLElement, attributes: Record<string, any>): void;
     onResize(): void;
     onInit(): void;
+    onSettingsChange(): void;
+    private buildOptionsFromSettings;
+    private getSettingValue;
+    private resolveModelLoader;
+    private resolveModelLoaderFactory;
     private createOrGetContainer;
     private applyContainerStyles;
     onObjectConnected(object: StringObject): void;
     onFrame(data: StringData): void;
     private syncRecursive;
     private injectCSS;
+    private registerTypedProperties;
+    private setupObservers;
+    private setupScrollListeners;
+    private removeScrollListeners;
+    private handleScroll;
+    private observeElement;
+    private observeSceneElements;
+    private observeRecursive;
+    private markDirty;
+    private markAllDirty;
+    private readNumberStyle;
+    private buildWorkerCameraData;
+    private collectWorkerInputs;
+    private applyWorkerResults;
     destroy(): void;
 }
 
@@ -202,6 +256,8 @@ declare class String3DCamera {
     getScaleAtZ(z: number, viewportHeight: number): number;
     clearScaleCache(): void;
     getMode(): CameraMode;
+    getPerspectiveFov(): number;
+    getPositionZ(): number;
 }
 
 declare class String3DObject {
@@ -220,7 +276,11 @@ declare class String3DObject {
     private _children;
     private engine;
     get children(): String3DObject[];
-    constructor(id: string, type: string, object: I3DObject, engine: I3DEngine);
+    constructor(id: string, type: string, object: I3DObject, engine: I3DEngine, options?: {
+        material?: I3DMaterial;
+        geometry?: I3DGeometry;
+        texture?: any;
+    });
     get object(): I3DObject;
     get material(): I3DMaterial | undefined;
     get originalSize(): I3DVector3;
@@ -239,19 +299,28 @@ declare class String3DObject {
     set metalness(value: number);
     set roughness(value: number);
     set texture(texture: any);
+    set material(material: I3DMaterial | undefined);
+    set geometry(geometry: I3DGeometry | undefined);
     updateBoundingBox(): void;
     destroy(): void;
+    private disposeObjectResources;
 }
 
+interface String3DSceneOptions {
+    modelLoader?: I3DModelLoader;
+    modelLoaderFactory?: (engine: I3DEngine, type?: string) => I3DModelLoader;
+}
 declare class String3DScene {
     private _scene;
     private _objects;
     private _rootObjects;
     private _elementMap;
     private engine;
-    private _modelLoader;
+    private _modelLoader?;
+    private _modelLoaderFactory?;
+    private _modelLoaderCache;
     get rootObjects(): String3DObject[];
-    constructor(engine: I3DEngine, modelLoader?: any);
+    constructor(engine: I3DEngine, options?: String3DSceneOptions);
     getScene(): I3DScene;
     getObject(id: string): String3DObject | undefined;
     hasObject(id: string): boolean;
@@ -259,13 +328,21 @@ declare class String3DScene {
     createFromElement(object: StringObject): void;
     private createGroup;
     private createLight;
+    private applyShadowProps;
     private createBox;
     private createSphere;
     private createPlane;
     private createCylinder;
     private createModel;
+    private resolveModelLoader;
+    private centerObject;
+    private getBoxCenter;
     private createMaterialFromObject;
+    private createMaterialFromElement;
     private loadTexture;
+    private parseFlipY;
+    private shouldOverrideModelMaterial;
+    private applyModelTextureRemap;
     destroy(): void;
 }
 
@@ -323,6 +400,8 @@ declare class ThreeJSEngine implements I3DEngine {
     createMeshBasicMaterial(params?: any): I3DMaterial;
     createMeshStandardMaterial(params?: any): I3DMaterial;
     createPointLight(color?: string | number, intensity?: number, distance?: number, decay?: number): I3DLight;
+    createSpotLight(color?: string | number, intensity?: number, distance?: number, angle?: number, penumbra?: number, decay?: number): I3DLight;
+    createHemisphereLight(skyColor?: string | number, groundColor?: string | number, intensity?: number): I3DLight;
     createAmbientLight(color?: string | number, intensity?: number): I3DLight;
     createDirectionalLight(color?: string | number, intensity?: number): I3DLight;
     createTextureLoader(): I3DTextureLoader;

package/dist/index.d.ts

@@ -61,6 +61,8 @@ interface I3DObject {
 interface I3DMesh extends I3DObject {
     geometry: I3DGeometry;
     material: I3DMaterial | I3DMaterial[];
+    castShadow: boolean;
+    receiveShadow: boolean;
 }
 interface I3DGeometry {
     dispose(): void;
@@ -75,6 +77,13 @@ interface I3DMaterial {
 interface I3DLight extends I3DObject {
     color: any;
     intensity: number;
+    castShadow?: boolean;
+    shadow?: any;
+    target?: I3DObject;
+    distance?: number;
+    decay?: number;
+    angle?: number;
+    penumbra?: number;
 }
 interface I3DCamera extends I3DObject {
     aspect: number;
@@ -103,6 +112,11 @@ interface I3DRenderer {
     setPixelRatio(ratio: number): void;
     render(scene: I3DScene, camera: I3DCamera): void;
     dispose(): void;
+    outputEncoding: any;
+    shadowMap: {
+        enabled: boolean;
+        type: any;
+    };
 }
 interface I3DTextureLoader {
     load(url: string, onLoad?: (texture: any) => void): any;
@@ -134,6 +148,8 @@ interface I3DEngine {
     createMeshBasicMaterial(params?: any): I3DMaterial;
     createMeshStandardMaterial(params?: any): I3DMaterial;
     createPointLight(color?: string | number, intensity?: number, distance?: number, decay?: number): I3DLight;
+    createSpotLight(color?: string | number, intensity?: number, distance?: number, angle?: number, penumbra?: number, decay?: number): I3DLight;
+    createHemisphereLight(skyColor?: string | number, groundColor?: string | number, intensity?: number): I3DLight;
     createAmbientLight(color?: string | number, intensity?: number): I3DLight;
     createDirectionalLight(color?: string | number, intensity?: number): I3DLight;
     createTextureLoader(): I3DTextureLoader;
@@ -152,6 +168,12 @@ interface String3DOptions {
     hideHTML?: boolean;
     container?: string | HTMLElement;
     zIndex?: number;
+    modelLoaderType?: string;
+    modelLoader?: I3DModelLoader;
+    modelLoaderFactory?: (engine: I3DEngine, type?: string) => I3DModelLoader;
+    useDirtySync?: boolean;
+    useTransformWorker?: boolean;
+    transformWorkerWasmUrl?: string;
 }
 declare class String3D extends StringModule {
     private static provider;
@@ -163,18 +185,50 @@ declare class String3D extends StringModule {
     private canvasContainer;
     private isLoading;
     private options;
+    private useDirtySync;
+    private dirtyElements;
+    private observedElements;
+    private resizeObserver;
+    private mutationObserver;
+    private lastSyncData;
+    private transformWorker;
+    private workerHasResult;
+    private workerObjectMap;
+    private domVersion;
+    private lastSubmittedVersion;
+    private scrollTicking;
+    private onScrollBound;
     static setProvider(provider: I3DEngineProvider): void;
-    constructor(context: StringContext, options?: String3DOptions);
+    constructor(context: StringContext);
     canConnect(object: StringObject): boolean;
     initializeObject(globalId: number, object: StringObject, element: HTMLElement, attributes: Record<string, any>): void;
     onResize(): void;
     onInit(): void;
+    onSettingsChange(): void;
+    private buildOptionsFromSettings;
+    private getSettingValue;
+    private resolveModelLoader;
+    private resolveModelLoaderFactory;
     private createOrGetContainer;
     private applyContainerStyles;
     onObjectConnected(object: StringObject): void;
     onFrame(data: StringData): void;
     private syncRecursive;
     private injectCSS;
+    private registerTypedProperties;
+    private setupObservers;
+    private setupScrollListeners;
+    private removeScrollListeners;
+    private handleScroll;
+    private observeElement;
+    private observeSceneElements;
+    private observeRecursive;
+    private markDirty;
+    private markAllDirty;
+    private readNumberStyle;
+    private buildWorkerCameraData;
+    private collectWorkerInputs;
+    private applyWorkerResults;
     destroy(): void;
 }
 
@@ -202,6 +256,8 @@ declare class String3DCamera {
     getScaleAtZ(z: number, viewportHeight: number): number;
     clearScaleCache(): void;
     getMode(): CameraMode;
+    getPerspectiveFov(): number;
+    getPositionZ(): number;
 }
 
 declare class String3DObject {
@@ -220,7 +276,11 @@ declare class String3DObject {
     private _children;
     private engine;
     get children(): String3DObject[];
-    constructor(id: string, type: string, object: I3DObject, engine: I3DEngine);
+    constructor(id: string, type: string, object: I3DObject, engine: I3DEngine, options?: {
+        material?: I3DMaterial;
+        geometry?: I3DGeometry;
+        texture?: any;
+    });
     get object(): I3DObject;
     get material(): I3DMaterial | undefined;
     get originalSize(): I3DVector3;
@@ -239,19 +299,28 @@ declare class String3DObject {
     set metalness(value: number);
     set roughness(value: number);
     set texture(texture: any);
+    set material(material: I3DMaterial | undefined);
+    set geometry(geometry: I3DGeometry | undefined);
     updateBoundingBox(): void;
     destroy(): void;
+    private disposeObjectResources;
 }
 
+interface String3DSceneOptions {
+    modelLoader?: I3DModelLoader;
+    modelLoaderFactory?: (engine: I3DEngine, type?: string) => I3DModelLoader;
+}
 declare class String3DScene {
     private _scene;
     private _objects;
     private _rootObjects;
     private _elementMap;
     private engine;
-    private _modelLoader;
+    private _modelLoader?;
+    private _modelLoaderFactory?;
+    private _modelLoaderCache;
     get rootObjects(): String3DObject[];
-    constructor(engine: I3DEngine, modelLoader?: any);
+    constructor(engine: I3DEngine, options?: String3DSceneOptions);
     getScene(): I3DScene;
     getObject(id: string): String3DObject | undefined;
     hasObject(id: string): boolean;
@@ -259,13 +328,21 @@ declare class String3DScene {
     createFromElement(object: StringObject): void;
     private createGroup;
     private createLight;
+    private applyShadowProps;
     private createBox;
     private createSphere;
     private createPlane;
     private createCylinder;
     private createModel;
+    private resolveModelLoader;
+    private centerObject;
+    private getBoxCenter;
     private createMaterialFromObject;
+    private createMaterialFromElement;
     private loadTexture;
+    private parseFlipY;
+    private shouldOverrideModelMaterial;
+    private applyModelTextureRemap;
     destroy(): void;
 }
 
@@ -323,6 +400,8 @@ declare class ThreeJSEngine implements I3DEngine {
     createMeshBasicMaterial(params?: any): I3DMaterial;
     createMeshStandardMaterial(params?: any): I3DMaterial;
     createPointLight(color?: string | number, intensity?: number, distance?: number, decay?: number): I3DLight;
+    createSpotLight(color?: string | number, intensity?: number, distance?: number, angle?: number, penumbra?: number, decay?: number): I3DLight;
+    createHemisphereLight(skyColor?: string | number, groundColor?: string | number, intensity?: number): I3DLight;
     createAmbientLight(color?: string | number, intensity?: number): I3DLight;
     createDirectionalLight(color?: string | number, intensity?: number): I3DLight;
     createTextureLoader(): I3DTextureLoader;