@pilotdev/pilot-web-3d 23.0.5 → 23.0.6-alpha.2

package/index.d.ts

@@ -1,5 +1,9 @@
 /// <reference types="@types/three" />
 declare namespace PilotWeb3D {
+export class InitializerOptions {
+    libList?: string[];
+    language?: string;
+}
 export class Localization {
     static initialize(options: any): Promise<void>;
     static translate(stringToTrans: string): string;
@@ -83,11 +87,11 @@ export interface ISettings {
     changeSetting<T>(name: string, value: T, notify?: boolean, providedData?: any): void;
     getSettingValue<T>(name: string): T;
 }
-
 export class BaseSettingsNames {
     static TOOLBAR: string;
     static TOOLBAR_DIRECTION: string;
     static TOOLBAR_CONTENT: string;
+    static THEME: string;
 }
 export class SettingChangedEvent extends Event {
     name: string;
@@ -102,6 +106,11 @@ export abstract class SettingsBase implements ISettings {
     getSettingValue<T>(name: string): T;
     protected abstract getKeyWithPrefix(key: string): string;
 }
+export enum SettingsTheme {
+    LIGHT_THEME = "ascn-light",
+    DARK_THEME = "ascn-dark"
+}
+export const defaultThemeAppearance: string;
 export enum ToolbarDirection {
     TOP_FIXED = "ascn-toolbar-direction-fixed-top",
     TOP_FLUENT = "ascn-toolbar-direction-top",
@@ -127,6 +136,7 @@ export class ViewerConfiguration {
     settingsPrefix: string;
     appearance: ViewerSettings;
     createConfiguration(configuration: ViewerSettings, origin: ViewerSettings): void;
+    changeTheme(newTheme: string): void;
 }
 export type ErrorCallback = (message: string) => void;
 export type SuccessCallback = (modelId: any) => void;
@@ -159,6 +169,7 @@ export abstract class ViewerBase {
     finish(): void;
     onPostExtensionLoad(extension: ExtensionBase): void;
     protected loadExtensions(): void;
+    protected setThemeFromSettings(): void;
 }
 export class Control {
     container: HTMLElement;
@@ -238,6 +249,7 @@ export class Color {
     alpha(): number;
     fromArray(array: ArrayLike<number>, offset?: number): Color;
     toArray(array: Array<number>, offset?: number): Array<number>;
+    clone(): Color;
 }
 export abstract class ViewObject extends THREE.Object3D {
     protected _isDisposed: boolean;
@@ -706,6 +718,34 @@ export interface IEventSigner<Data> {
         allowMissing?: boolean;
     }): boolean;
 }
+
+export enum SelectionMode {
+    Append = 0,
+    Replace = 1
+}
+export class RenderViewSettings {
+    telemetry?: boolean;
+    hideEdgesWhenNavigation?: boolean;
+    antiAliasing?: boolean;
+    displayMode?: DisplayMode;
+    /** Desired render framerate */
+    desiredFramerate?: number;
+    /** Allocated time for rendering operations, excluding scene rendering */
+    manageTime?: number;
+    /** Draw hovered meshes on the `selectionScene` */
+    hoverMeshes?: boolean;
+    /** Draw hovered edges on the `selectionScene` */
+    hoverEdges?: boolean;
+    /** Draw selected meshes on the `selectionScene` */
+    selectEdges?: boolean;
+    /** Draw selected edges on the `selectionScene` */
+    selectMeshes?: boolean;
+}
+export enum DisplayMode {
+    FACES_AND_EDGES = 0,
+    FACES = 1
+}
+export const defaultRenderViewSettings: RenderViewSettings;
 export interface IModelIntersectionChecker {
     /** Gets the center of the model*/
     get modelCenter(): THREE.Vector3;
@@ -718,13 +758,15 @@ export interface IModelIntersectionChecker {
     /**
      * Gets {@link THREE.Intersection} between a casted {@link ray} and model object.
      * @param ray
+     * @param camera
      */
-    getIntersectionByRay(ray: THREE.Ray): THREE.Intersection<THREE.Object3D> | undefined;
+    getIntersectionByRay(ray: THREE.Ray, camera: THREE.Camera): THREE.Intersection<THREE.Object3D> | undefined;
     /**
      * Gets ID of the model object intersected by {@link ray}
      * @param ray
+     * @param camera
      */
-    getIntersectionIDByRay(ray: THREE.Ray): {
+    getIntersectionIDByRay(ray: THREE.Ray, camera: THREE.Camera): {
         modelId: string;
         guid: string;
     } | undefined;
@@ -755,29 +797,60 @@ export interface IModelIntersectionChecker {
         guid: string;
     }[];
 }
-export class RenderViewSettings {
-    telemetry?: boolean;
-    hideEdgesWhenNavigation?: boolean;
-    antiAliasing?: boolean;
-    displayMode?: DisplayMode;
-    /** Desired render framerate */
-    desiredFramerate?: number;
-    /** Allocated time for rendering operations, excluding scene rendering */
-    manageTime?: number;
-    /** Draw hovered meshes on the `selectionScene` */
-    hoverMeshes?: boolean;
-    /** Draw hovered edges on the `selectionScene` */
-    hoverEdges?: boolean;
-    /** Draw selected meshes on the `selectionScene` */
-    selectEdges?: boolean;
-    /** Draw selected edges on the `selectionScene` */
-    selectMeshes?: boolean;
+export interface I3DRenderer {
+    clear(color?: boolean, depth?: boolean, stencil?: boolean): void;
+    setClearColor(color: THREE.ColorRepresentation, alpha?: number): void;
+    clearDepth(): void;
+    render(scene: THREE.Object3D, camera: THREE.Camera): void;
+    getSize(target: THREE.Vector2): THREE.Vector2;
+    setSize(width: number, height: number, updateStyle?: boolean): void;
+    setViewport(x: THREE.Vector4 | number, y?: number, width?: number, height?: number): void;
+    clippingPlanes: THREE.Plane[];
+    domElement: HTMLCanvasElement;
 }
-export enum DisplayMode {
-    FACES_AND_EDGES = 0,
-    FACES = 1
+export interface IRenderViewer3D {
+    /** Gets model inetrsection checker. */
+    getIntersectionChecker(): IModelIntersectionChecker;
+    /** Request a full redraw of the canvas. */
+    updateCurrentCanvas(): Promise<void>;
+    /**
+     * Place object on the scene.\
+     * An object can only be placed on one scene.
+     * @param iObj - object to place.
+     * @param sceneID - (optional) scene name. `MainScene` by default.
+     */
+    placeObjectOnScene(iObj: THREE.Object3D, sceneID?: string): Promise<void>;
+    /**
+     * Remove object from scene.
+     * @param iObj
+     */
+    removeObjectFromScene(iObj: THREE.Object3D): Promise<void>;
+    /**
+     * Set clipping planes for rendering.
+     * @param planes - array of clipping planes.
+     */
+    setClipping(planes: THREE.Plane[]): void;
+    /**
+     * Set active clipping planes: planes with colored sections
+     * @param indices - active planes indices in the array of clipping planes
+     */
+    setActiveClipPlaneIndices(indices: number[]): void;
+    /**
+     * Gets all render scenes.
+     */
+    getScenes(): IUserScene[];
+    /**
+     *
+     * @param name
+     * @param isClippable
+     */
+    addScene(name: string, isClippable: boolean): IUserScene;
+    /**
+     *
+     * @param scene
+     */
+    removeScene(scene: IUserScene): void;
 }
-export const defaultRenderViewSettings: RenderViewSettings;
 export interface IRenderOperationContext {
     /** If true, renderScenes operations will be forced*/
     isRedrawRequested: boolean;
@@ -843,6 +916,10 @@ export interface IUserScene {
     get intersectionChecker(): IModelIntersectionChecker | null;
     /** Gets the THREE.Object3D representation of the scene */
     get threeObjectRepresentation(): THREE.Object3D | null;
+    /** Sets clipping enable */
+    set clippingEnable(value: boolean);
+    /** Indicates whether the scene should be clipped */
+    get clippingEnable(): boolean;
     /** Place objects on scene */
     addRange(objects: THREE.Object3D[]): void;
     /** Update objects on scene */
@@ -864,109 +941,350 @@ export interface IUserScene {
     /** Dispose scene */
     dispose(): void;
 }
-export interface I3DRenderer {
-    clear(color?: boolean, depth?: boolean, stencil?: boolean): void;
-    clearDepth(): void;
-    render(scene: THREE.Object3D, camera: THREE.Camera): void;
-    getSize(target: THREE.Vector2): THREE.Vector2;
-    setSize(width: number, height: number, updateStyle?: boolean): void;
-    setViewport(x: THREE.Vector4 | number, y?: number, width?: number, height?: number): void;
-    clippingPlanes: THREE.Plane[];
-    domElement: HTMLCanvasElement;
+export enum NavigationHandlerPriority {
+    DefaultNavigation = 0,
+    GizmoHandlers = 20,
+    EmbeddedExtensions = 40,
+    CustomExtensions = 100
 }
-export interface IRenderViewer3D {
-    /** Gets model inetrsection checker. */
-    getIntersectionChecker(): IModelIntersectionChecker;
-    /** Request a full redraw of the canvas. */
-    updateCurrentCanvas(): Promise<void>;
+export class NavigationEventOptions implements EventListenerOptions {
+    /** If true, use event capturing instead of event bubbling*/
+    readonly capture: boolean;
+    /** Call priority of navigation event handlers, from highest to lowest*/
+    readonly priority: number | NavigationHandlerPriority;
+    /** Always handle, used if `NavigationEvent.isHandled` set to true*/
+    readonly alwaysHandle: boolean;
+    /** (optional) listener name*/
+    readonly navigationTargetName?: string;
+    
+    constructor(
+    /** If true, use event capturing instead of event bubbling*/
+    capture?: boolean, 
+    /** Call priority of navigation event handlers, from highest to lowest*/
+    priority?: number | NavigationHandlerPriority, 
+    /** Always handle, used if `NavigationEvent.isHandled` set to true*/
+    alwaysHandle?: boolean, 
+    /** (optional) listener name*/
+    navigationTargetName?: string);
+}
+export type NavigationEvent = {
     /**
-     * Place object on the scene.\
-     * An object can only be placed on one scene.
-     * @param iObj - object to place.
-     * @param sceneID - (optional) scene name. `MainScene` by default.
+     * (optional) Value indicating whether the NavigationEvent event was handled.
      */
-    placeObjectOnScene(iObj: THREE.Object3D, sceneID?: string): Promise<void>;
+    isHandled?: boolean;
+};
+export interface INavigationEventSource {
     /**
-     * Remove object from scene.
-     * @param iObj
+     * Event fired on activity changed
      */
-    removeObjectFromScene(iObj: THREE.Object3D): Promise<void>;
+    readonly eventSourceActivityChanged: IEventSigner<boolean>;
     /**
-     * Set clipping planes for rendering.
-     * @param planes - array of clipping planes.
+     * Activates or deactivate event source
+     * @param value - activate if true
      */
-    setClipping(planes: THREE.Plane[]): void;
+    setActive(value: boolean): void;
+    addEventListener<T extends keyof HTMLElementEventMap>(type: T, listener: (this: object, ev: HTMLElementEventMap[T] & NavigationEvent) => void, options?: boolean | EventListenerOptions | NavigationEventOptions): void;
+    removeEventListener<T extends keyof HTMLElementEventMap>(type: T, listener: (this: object, ev: HTMLElementEventMap[T] & NavigationEvent) => void, options?: boolean | EventListenerOptions | NavigationEventOptions): void;
+}
+export interface INavigationAgent {
     /**
-     * Set active clipping planes: planes with colored sections
-     * @param indices - active planes indices in the array of clipping planes
+     * Canvas DOM-events source
      */
-    setActiveClipPlaneIndices(indices: number[]): void;
+    readonly canvasNavigationSource: INavigationEventSource;
     /**
-     * Gets all render scenes.
+     * Keyboard DOM-events source
      */
-    getScenes(): IUserScene[];
-}
-export class ModelElement {
-    get id(): string;
-    get modelPartId(): string;
-    get parent(): ModelElement | undefined;
-    get type(): string;
-    get name(): string;
-    get children(): ModelElement[];
-    get hasGeometry(): boolean;
-    get boundingBoxCenter(): Point3;
+    readonly keyboardNavigationSource: INavigationEventSource;
+    /**
+     * Activates canvas and keyboard navigation event sources
+     */
+    setActive(value: boolean): void;
+    /**
+     * Gets rectangle of the navigation area
+     */
+    getNavigationArea(): DOMRect;
 }
-export class ModelElementTree {
+export interface INavigationTool {
     /**
-     *
-     * @param {string|ModelElement} element - element id or element instance
-     * @param callback
-     * @param recursive
+     * Gets name of this navigation tool.
      */
-    enumElementChildren(element: string | ModelElement, callback: (guid: string) => void, recursive?: boolean): void;
+    get name(): string;
     /**
-     * Gets the root element of the model part
-     * @returns {ModelElement} - model element instance
+     * Initialize navigation tool.
      */
-    getRootElement(): ModelElement;
+    init(navAgent: INavigationAgent, cameraControl: ICameraControl, intersectionChecker: IModelIntersectionChecker): void;
     /**
-     * Gets all elements of the model part
-     * @returns array of the model elements
+     * Activates or deactivates this navigation tool.
      */
-    getAllElements(): ModelElement[];
+    setActive(isActive: boolean): void;
     /**
-     * Gets model element by id
-     * @param { string } id - model element id
-     * @returns model element;
+     * Gets the camera pivot point.
      */
-    getElement(id: string): ModelElement;
+    getPivotPoint(): THREE.Vector3;
     /**
-     * Checks given element is viewable
-     * @param {string|ModelElement} element - element id or element instance
-     * @returns {boolean}
+     * Sets the camera pivot point.
      */
-    isViewableElement(element: string | ModelElement): boolean;
+    setPivotPoint(pivotPoint: THREE.Vector3): void;
     /**
-     * Checks given element is detached from the root element
-     * @param {string|ModelElement} element - element id or element instance
-     * @returns {boolean}
+     * Sets the camera parameters.
+     * @param iParams
      */
-    isDetachedElement(element: string | ModelElement): boolean;
+    setCameraParameters(iParams: CameraParameters): void;
     /**
-     * Gets the element level in the element tree
-     * @param {string|ModelElement} element - element id or element instance
-     * @returns {number} - level of the element
+     * Gets the camera parameters.
      */
-    getChildLevelNumber(element: string | ModelElement): number;
+    getCameraParameters(): CameraParameters;
 }
-export class ModelPart {
-    get id(): string;
-    get elementTree(): ModelElementTree;
+export class GizmoMaterials {
+    static gizmoMaterial: THREE.MeshBasicMaterial;
+    static matInvisible: THREE.MeshBasicMaterial;
+    static matRed: THREE.MeshBasicMaterial;
+    static matGreen: THREE.MeshBasicMaterial;
+    static matBlue: THREE.MeshBasicMaterial;
+    static matYellow: THREE.MeshBasicMaterial;
+    static matViolet: THREE.MeshBasicMaterial;
+    static matYellowTransparent: THREE.MeshBasicMaterial;
+    static init(): void;
+}
+export interface IGizmoObject extends THREE.Object3D {
+    getHovered(): boolean;
+    setHovered(value: boolean): void;
+    getActive(): boolean;
+    setActive(value: boolean): void;
     dispose(): void;
 }
-
-export class SettingsNames {
-    static TELEMETRY: string;
+export class GizmoObject extends THREE.Object3D implements IGizmoObject {
+    protected _meshes: THREE.Mesh[];
+    readonly baseMaterial: THREE.Material;
+    readonly hoverMaterial: THREE.Material;
+    readonly activeMaterial: THREE.Material;
+    
+    constructor(_meshes: THREE.Mesh[], baseMaterial?: THREE.Material, hoverMaterial?: THREE.Material, activeMaterial?: THREE.Material);
+    getHovered(): boolean;
+    setHovered(value: boolean): void;
+    getActive(): boolean;
+    setActive(value: boolean): void;
+    dispose(): void;
+    raycast(raycaster: THREE.Raycaster, intersects: THREE.Intersection<THREE.Object3D<THREE.Event>>[]): void;
+}
+export abstract class GizmoAxis extends THREE.Object3D implements IGizmoObject {
+    readonly handle: IGizmoObject;
+    readonly picker?: IGizmoObject;
+    readonly helper?: IGizmoObject;
+    protected _isHovered: boolean;
+    protected _isActive: boolean;
+    protected _plane: THREE.Plane;
+    protected _axisDir: THREE.Vector3;
+    protected _raycaster: THREE.Raycaster;
+    protected _worldPositionStart: THREE.Vector3;
+    protected _worldQuaternionStart: THREE.Quaternion;
+    protected _worldAxisDir: THREE.Vector3;
+    protected _startPoint: THREE.Vector3;
+    protected _endPoint: THREE.Vector3;
+    getActive(): boolean;
+    setActive(value: boolean): void;
+    getHovered(): boolean;
+    setHovered(value: boolean): void;
+    dispose(): void;
+    raycast(raycaster: THREE.Raycaster, intersects: THREE.Intersection<THREE.Object3D<THREE.Event>>[]): void;
+    abstract moveByNdcPt(ndcPos: THREE.Vector2, camera: THREE.Camera): THREE.Matrix4;
+    protected abstract updateGizmoPlane(camera: THREE.Camera): void;
+    protected setStartPt(ndcPos: THREE.Vector2, camera: THREE.Camera): void;
+}
+export class GizmoTranslationAxis extends GizmoAxis {
+    readonly handle: IGizmoObject;
+    readonly picker?: IGizmoObject;
+    readonly helper?: IGizmoObject;
+    
+    constructor(axisDir: THREE.Vector3, handle: IGizmoObject, picker?: IGizmoObject, helper?: IGizmoObject);
+    moveByNdcPt(ndcPos: THREE.Vector2, camera: THREE.Camera): THREE.Matrix4;
+    protected updateGizmoPlane(camera: THREE.Camera): void;
+}
+export class GizmoRotationAxis extends GizmoAxis {
+    readonly handle: IGizmoObject;
+    readonly picker?: IGizmoObject;
+    readonly helper?: IGizmoObject;
+    moveByNdcPt(ndcPos: THREE.Vector2, camera: THREE.Camera): THREE.Matrix4;
+    protected updateGizmoPlane(camera: THREE.Camera): void;
+}
+export class GizmoScaleAxis extends GizmoAxis {
+    readonly handle: IGizmoObject;
+    readonly picker?: IGizmoObject;
+    readonly helper?: IGizmoObject;
+    moveByNdcPt(ndcPos: THREE.Vector2, camera: THREE.Camera): THREE.Matrix4;
+    protected updateGizmoPlane(camera: THREE.Camera): void;
+}
+export class GizmoControl extends THREE.Object3D {
+    
+    constructor(camera: THREE.Camera, navAgent: INavigationAgent);
+    attachTo(object: THREE.Object3D, asChild?: boolean): void;
+    detach(): void;
+    addAxis(axis: GizmoAxis): void;
+    dispose(): void;
+    updateMatrixWorld(force?: boolean): void;
+    updateGizmoOffset(position?: THREE.Vector3, quaternion?: THREE.Quaternion): void;
+}
+export enum GizmoAxisDir {
+    NONE = 0,
+    X = 1,
+    Y = 2,
+    Z = 4,
+    XY = 3,
+    YZ = 6,
+    XZ = 5,
+    XYZ = 7
+}
+export class GizmoBuilder {
+    static build(camera: THREE.Camera, navAgent: INavigationAgent, translation?: GizmoAxisDir, rotation?: GizmoAxisDir, scale?: GizmoAxisDir): GizmoControl;
+    static buildTranslationAxis(axisDir: THREE.Vector3, handleBaseMatrial?: THREE.Material, handleHoveredMaterial?: THREE.Material, handleSelectedMaterial?: THREE.Material, pickerBaseMatrial?: THREE.Material, pickerHoveredMaterial?: THREE.Material, pickerSelectedMaterial?: THREE.Material): GizmoAxis;
+    static buildRotationAxis(axisDir: THREE.Vector3, handleBaseMatrial?: THREE.Material, handleHoveredMaterial?: THREE.Material, handleSelectedMaterial?: THREE.Material, pickerBaseMatrial?: THREE.Material, pickerHoveredMaterial?: THREE.Material, pickerSelectedMaterial?: THREE.Material): GizmoAxis;
+    static buildScaleAxis(axisDir: THREE.Vector3, handleBaseMatrial?: THREE.Material, handleHoveredMaterial?: THREE.Material, handleSelectedMaterial?: THREE.Material): GizmoAxis;
+}
+export interface LabelSpriteParameters {
+    text?: string | undefined;
+    sizeAttenuation?: boolean | undefined;
+    fontFace?: string | FontFace | undefined;
+    fontSize?: number | undefined;
+    borderColor?: Color | undefined;
+    backgroundColor?: Color | undefined;
+    borderThickness?: number | undefined;
+    borderRadius?: number | undefined;
+    textColor?: Color | undefined;
+    textPadding?: THREE.Vector4Tuple | undefined;
+}
+export class LabelSprite extends THREE.Sprite {
+    readonly extraHeightFactor = 1.4;
+    
+    constructor(parameters: LabelSpriteParameters);
+    get sizeAttenuation(): boolean;
+    set sizeAttenuation(value: boolean);
+    /**
+     * @default ''
+     */
+    get text(): string;
+    set text(value: string);
+    /**
+    * @default 'Roboto, sans-serif'
+    */
+    get fontFace(): string | FontFace;
+    set fontFace(value: string | FontFace);
+    /**
+    * @default 12
+    */
+    get fontSize(): number;
+    set fontSize(value: number);
+    /**
+    * @default 2
+    */
+    get borderThickness(): number;
+    set borderThickness(value: number);
+    /**
+    * @default new Color(0, 0, 0, 1.0)
+    */
+    get borderColor(): Color;
+    set borderColor(value: Color);
+    /**
+    * @default 1
+    */
+    get borderRadius(): number;
+    set borderRadius(value: number);
+    /**
+    * @default new Color(1.0, 1.0, 1.0, 1.0)
+    */
+    get backgroundColor(): Color;
+    set backgroundColor(value: Color);
+    /**
+    * @default new Color(0, 0, 0, 1.0)
+    */
+    get textColor(): Color;
+    set textColor(value: Color);
+    /**
+     * Label text padding: left, top, right, bottom
+     * @default [0, 0, 0, 0]
+     */
+    get textPadding(): THREE.Vector4Tuple;
+    set textPadding(value: THREE.Vector4Tuple);
+    dispose(): void;
+}
+export interface EventEmitter<Data> {
+    emit(data?: Data, options?: object): void;
+}
+export class EventDispatcher<Data> implements IEventSigner<Data>, EventEmitter<Data> {
+    listen(func: EventFunction<Data>, options?: {
+        bind?: object;
+    }): IEventListener<Data>;
+    unlisten(func: EventFunction<Data>, options?: {
+        bind?: object;
+        allowMissing?: boolean;
+    }): boolean;
+    emit(data?: Data): void;
+    emitR(data?: Data): any[];
+    asSigner(): IEventSigner<Data>;
+    asEmitter(): EventEmitter<Data>;
+    removeAllListeners(): void;
+}
+export class ModelElement {
+    get id(): string;
+    get modelPartId(): string;
+    get parent(): ModelElement | undefined;
+    get type(): string;
+    get name(): string;
+    get children(): ModelElement[];
+    get hasGeometry(): boolean;
+    get viewObject(): ViewObject | undefined;
+    get boundingBoxCenter(): Point3 | null;
+}
+export class ModelElementTree {
+    /**
+     *
+     * @param {string|ModelElement} element - element id or element instance
+     * @param callback
+     * @param recursive
+     */
+    enumElementChildren(element: string | ModelElement, callback: (guid: string) => void, recursive?: boolean): void;
+    /**
+     * Gets the root element of the model part
+     * @returns {ModelElement} - model element instance
+     */
+    getRootElement(): ModelElement;
+    /**
+     * Gets all elements of the model part
+     * @returns array of the model elements
+     */
+    getAllElements(): ModelElement[];
+    /**
+     * Gets model element by id
+     * @param { string } id - model element id
+     * @returns model element;
+     */
+    getElement(id: string): ModelElement;
+    /**
+     * Checks given element is viewable
+     * @param {string|ModelElement} element - element id or element instance
+     * @returns {boolean}
+     */
+    isViewableElement(element: string | ModelElement): boolean;
+    /**
+     * Checks given element is detached from the root element
+     * @param {string|ModelElement} element - element id or element instance
+     * @returns {boolean}
+     */
+    isDetachedElement(element: string | ModelElement): boolean;
+    /**
+     * Gets the element level in the element tree
+     * @param {string|ModelElement} element - element id or element instance
+     * @returns {number} - level of the element
+     */
+    getChildLevelNumber(element: string | ModelElement): number;
+}
+export class ModelPart {
+    get id(): string;
+    get elementTree(): ModelElementTree;
+    dispose(): void;
+}
+
+export class SettingsNames {
+    static TELEMETRY: string;
     static AXES: string;
     static CAMERA_ANIMATION: string;
     static HIDE_SMALL_ELEMENTS_WHEN_NAVIGATING: string;
@@ -2226,11 +2544,6 @@ export class ModelElementPropertyValue {
     bool_value?: boolean;
     get value(): unknown;
 }
-
-export enum SelectionMode {
-    Append = 0,
-    Replace = 1
-}
 export class ModelElementIds {
     modelPartId: string;
     elementIds: string[];
@@ -2261,100 +2574,6 @@ export class HoverEvent extends Event {
     modelId: string;
     modelElementId: string;
 }
-export enum NavigationHandlerPriority {
-    DefaultNavigation = 0,
-    GizmoHandlers = 20,
-    EmbeddedExtensions = 40,
-    CustomExtensions = 100
-}
-export class NavigationEventOptions implements EventListenerOptions {
-    /** If true, use event capturing instead of event bubbling*/
-    readonly capture: boolean;
-    /** Call priority of navigation event handlers, from highest to lowest*/
-    readonly priority: number | NavigationHandlerPriority;
-    /** Always handle, used if `NavigationEvent.isHandled` set to true*/
-    readonly alwaysHandle: boolean;
-    /** (optional) listener name*/
-    readonly navigationTargetName?: string;
-    
-    constructor(
-    /** If true, use event capturing instead of event bubbling*/
-    capture?: boolean, 
-    /** Call priority of navigation event handlers, from highest to lowest*/
-    priority?: number | NavigationHandlerPriority, 
-    /** Always handle, used if `NavigationEvent.isHandled` set to true*/
-    alwaysHandle?: boolean, 
-    /** (optional) listener name*/
-    navigationTargetName?: string);
-}
-export type NavigationEvent = {
-    /**
-     * (optional) Value indicating whether the NavigationEvent event was handled.
-     */
-    isHandled?: boolean;
-};
-export interface INavigationEventSource {
-    /**
-     * Event fired on activity changed
-     */
-    readonly eventSourceActivityChanged: IEventSigner<boolean>;
-    /**
-     * Activates or deactivate event source
-     * @param value - activate if true
-     */
-    setActive(value: boolean): void;
-    addEventListener<T extends keyof HTMLElementEventMap>(type: T, listener: (this: object, ev: HTMLElementEventMap[T] & NavigationEvent) => void, options?: boolean | EventListenerOptions | NavigationEventOptions): void;
-    removeEventListener<T extends keyof HTMLElementEventMap>(type: T, listener: (this: object, ev: HTMLElementEventMap[T] & NavigationEvent) => void, options?: boolean | EventListenerOptions | NavigationEventOptions): void;
-}
-export interface INavigationAgent {
-    /**
-     * Canvas DOM-events source
-     */
-    readonly canvasNavigationSource: INavigationEventSource;
-    /**
-     * Keyboard DOM-events source
-     */
-    readonly keyboardNavigationSource: INavigationEventSource;
-    /**
-     * Activates canvas and keyboard navigation event sources
-     */
-    setActive(value: boolean): void;
-    /**
-     * Gets rectangle of the navigation area
-     */
-    getNavigationArea(): DOMRect;
-}
-export interface INavigationTool {
-    /**
-     * Gets name of this navigation tool.
-     */
-    get name(): string;
-    /**
-     * Initialize navigation tool.
-     */
-    init(navAgent: INavigationAgent, cameraControl: ICameraControl, intersectionChecker: IModelIntersectionChecker): void;
-    /**
-     * Activates or deactivates this navigation tool.
-     */
-    setActive(isActive: boolean): void;
-    /**
-     * Gets the camera pivot point.
-     */
-    getPivotPoint(): THREE.Vector3;
-    /**
-     * Sets the camera pivot point.
-     */
-    setPivotPoint(pivotPoint: THREE.Vector3): void;
-    /**
-     * Sets the camera parameters.
-     * @param iParams
-     */
-    setCameraParameters(iParams: CameraParameters): void;
-    /**
-     * Gets the camera parameters.
-     */
-    getCameraParameters(): CameraParameters;
-}
 export interface INavigation {
     /**
      * Register navigation tool.
@@ -2422,12 +2641,6 @@ export class ModelLoadingOptions {
     guid: string;
     isConsolidatedModel?: boolean;
 }
-export class EventsObserver {
-    protected eventsDispatcher: IEventsDispatcher;
-    protected _listeners: Map<string, EventListener>;
-    watch(): void;
-    dispose(): void;
-}
 /**
  * This class describes the coordination model. The coordination model contains parts of the model (aka ModelPart).
  */
@@ -2577,6 +2790,7 @@ export class Viewer3D extends ViewerBase {
      * @returns Blob object representing render image.
      */
     makeScreenshot(mimeType?: string, quality?: number): Promise<Blob>;
+    setThemeFromSettings(): void;
 }
 export class GuiViewer3D extends Viewer3D {
     loadModelPart(buffer: ArrayBuffer, options: ModelLoadingOptions, onSuccessCallback: SuccessCallback, onErrorCallback: ErrorCallback): void;
@@ -2599,177 +2813,6 @@ export class Extension extends ExtensionBase {
     
     constructor(viewer: Viewer3D, options?: object);
 }
-export class GizmoMaterials {
-    static gizmoMaterial: THREE.MeshBasicMaterial;
-    static matInvisible: THREE.MeshBasicMaterial;
-    static matRed: THREE.MeshBasicMaterial;
-    static matGreen: THREE.MeshBasicMaterial;
-    static matBlue: THREE.MeshBasicMaterial;
-    static matYellow: THREE.MeshBasicMaterial;
-    static matViolet: THREE.MeshBasicMaterial;
-    static matYellowTransparent: THREE.MeshBasicMaterial;
-    static init(): void;
-}
-export interface IGizmoObject extends THREE.Object3D {
-    getHovered(): boolean;
-    setHovered(value: boolean): void;
-    getActive(): boolean;
-    setActive(value: boolean): void;
-    dispose(): void;
-}
-export class GizmoObject extends THREE.Object3D implements IGizmoObject {
-    protected _meshes: THREE.Mesh[];
-    readonly baseMaterial: THREE.Material;
-    readonly hoverMaterial: THREE.Material;
-    readonly activeMaterial: THREE.Material;
-    
-    constructor(_meshes: THREE.Mesh[], baseMaterial?: THREE.Material, hoverMaterial?: THREE.Material, activeMaterial?: THREE.Material);
-    getHovered(): boolean;
-    setHovered(value: boolean): void;
-    getActive(): boolean;
-    setActive(value: boolean): void;
-    dispose(): void;
-    raycast(raycaster: THREE.Raycaster, intersects: THREE.Intersection<THREE.Object3D<THREE.Event>>[]): void;
-}
-export abstract class GizmoAxis extends THREE.Object3D implements IGizmoObject {
-    readonly handle: IGizmoObject;
-    readonly picker?: IGizmoObject;
-    readonly helper?: IGizmoObject;
-    protected _isHovered: boolean;
-    protected _isActive: boolean;
-    protected _plane: THREE.Plane;
-    protected _axisDir: THREE.Vector3;
-    protected _raycaster: THREE.Raycaster;
-    protected _worldPositionStart: THREE.Vector3;
-    protected _worldQuaternionStart: THREE.Quaternion;
-    protected _worldAxisDir: THREE.Vector3;
-    protected _startPoint: THREE.Vector3;
-    protected _endPoint: THREE.Vector3;
-    getActive(): boolean;
-    setActive(value: boolean): void;
-    getHovered(): boolean;
-    setHovered(value: boolean): void;
-    dispose(): void;
-    raycast(raycaster: THREE.Raycaster, intersects: THREE.Intersection<THREE.Object3D<THREE.Event>>[]): void;
-    abstract moveByNdcPt(ndcPos: THREE.Vector2, camera: THREE.Camera): THREE.Matrix4;
-    protected abstract updateGizmoPlane(camera: THREE.Camera): void;
-    protected setStartPt(ndcPos: THREE.Vector2, camera: THREE.Camera): void;
-}
-export class GizmoTranslationAxis extends GizmoAxis {
-    readonly handle: IGizmoObject;
-    readonly picker?: IGizmoObject;
-    readonly helper?: IGizmoObject;
-    
-    constructor(axisDir: THREE.Vector3, handle: IGizmoObject, picker?: IGizmoObject, helper?: IGizmoObject);
-    moveByNdcPt(ndcPos: THREE.Vector2, camera: THREE.Camera): THREE.Matrix4;
-    protected updateGizmoPlane(camera: THREE.Camera): void;
-}
-export class GizmoRotationAxis extends GizmoAxis {
-    readonly handle: IGizmoObject;
-    readonly picker?: IGizmoObject;
-    readonly helper?: IGizmoObject;
-    moveByNdcPt(ndcPos: THREE.Vector2, camera: THREE.Camera): THREE.Matrix4;
-    protected updateGizmoPlane(camera: THREE.Camera): void;
-}
-export class GizmoScaleAxis extends GizmoAxis {
-    readonly handle: IGizmoObject;
-    readonly picker?: IGizmoObject;
-    readonly helper?: IGizmoObject;
-    moveByNdcPt(ndcPos: THREE.Vector2, camera: THREE.Camera): THREE.Matrix4;
-    protected updateGizmoPlane(camera: THREE.Camera): void;
-}
-export class GizmoControl extends THREE.Object3D {
-    
-    constructor(camera: THREE.Camera, navAgent: INavigationAgent);
-    attachTo(object: THREE.Object3D, asChild?: boolean): void;
-    detach(): void;
-    addAxis(axis: GizmoAxis): void;
-    dispose(): void;
-    updateMatrixWorld(force?: boolean): void;
-    updateGizmoOffset(position?: THREE.Vector3, quaternion?: THREE.Quaternion): void;
-}
-export enum GizmoAxisDir {
-    NONE = 0,
-    X = 1,
-    Y = 2,
-    Z = 4,
-    XY = 3,
-    YZ = 6,
-    XZ = 5,
-    XYZ = 7
-}
-export class GizmoBuilder {
-    static build(camera: THREE.Camera, navAgent: INavigationAgent, translation?: GizmoAxisDir, rotation?: GizmoAxisDir, scale?: GizmoAxisDir): GizmoControl;
-    static buildTranslationAxis(axisDir: THREE.Vector3, handleBaseMatrial?: THREE.Material, handleHoveredMaterial?: THREE.Material, handleSelectedMaterial?: THREE.Material, pickerBaseMatrial?: THREE.Material, pickerHoveredMaterial?: THREE.Material, pickerSelectedMaterial?: THREE.Material): GizmoAxis;
-    static buildRotationAxis(axisDir: THREE.Vector3, handleBaseMatrial?: THREE.Material, handleHoveredMaterial?: THREE.Material, handleSelectedMaterial?: THREE.Material, pickerBaseMatrial?: THREE.Material, pickerHoveredMaterial?: THREE.Material, pickerSelectedMaterial?: THREE.Material): GizmoAxis;
-    static buildScaleAxis(axisDir: THREE.Vector3, handleBaseMatrial?: THREE.Material, handleHoveredMaterial?: THREE.Material, handleSelectedMaterial?: THREE.Material): GizmoAxis;
-}
-export interface LabelSpriteParameters {
-    text?: string | undefined;
-    sizeAttenuation?: boolean | undefined;
-    fontFace?: string | FontFace | undefined;
-    fontSize?: number | undefined;
-    borderColor?: Color | undefined;
-    backgroundColor?: Color | undefined;
-    borderThickness?: number | undefined;
-    borderRadius?: number | undefined;
-    textColor?: Color | undefined;
-    textPadding?: THREE.Vector4Tuple | undefined;
-}
-export class LabelSprite extends THREE.Sprite {
-    readonly extraHeightFactor = 1.4;
-    
-    constructor(parameters: LabelSpriteParameters);
-    get sizeAttenuation(): boolean;
-    set sizeAttenuation(value: boolean);
-    /**
-     * @default ''
-     */
-    get text(): string;
-    set text(value: string);
-    /**
-    * @default 'Roboto, sans-serif'
-    */
-    get fontFace(): string | FontFace;
-    set fontFace(value: string | FontFace);
-    /**
-    * @default 12
-    */
-    get fontSize(): number;
-    set fontSize(value: number);
-    /**
-    * @default 2
-    */
-    get borderThickness(): number;
-    set borderThickness(value: number);
-    /**
-    * @default new Color(0, 0, 0, 1.0)
-    */
-    get borderColor(): Color;
-    set borderColor(value: Color);
-    /**
-    * @default 1
-    */
-    get borderRadius(): number;
-    set borderRadius(value: number);
-    /**
-    * @default new Color(1.0, 1.0, 1.0, 1.0)
-    */
-    get backgroundColor(): Color;
-    set backgroundColor(value: Color);
-    /**
-    * @default new Color(0, 0, 0, 1.0)
-    */
-    get textColor(): Color;
-    set textColor(value: Color);
-    /**
-     * Label text padding: left, top, right, bottom
-     * @default [0, 0, 0, 0]
-     */
-    get textPadding(): THREE.Vector4Tuple;
-    set textPadding(value: THREE.Vector4Tuple);
-    dispose(): void;
-}
 export interface IWindowStyle {
     width: string;
     height: string;
@@ -2797,6 +2840,30 @@ export class Dragger {
     constructor(allowedDraggableElement: HTMLElement, draggableContainer: HTMLElement, containerToRestriction: HTMLElement, windowStater?: WindowStater);
     get windowState(): IWindowStyle | null;
 }
+export namespace Viewer3DIcons {
+    const VIEWER_SETTINGS_ICON: string;
+    const VIEWER_MODEL_BROWSER_ICON: string;
+    const VIEWER_FULL_SCREEN_ICON: string;
+    const VIEWER_COLLAPSE_ICON: string;
+    const VIEWER_ELEMENT_PROPERTIES_ICON: string;
+    const VIEWER_ADD_CLIPPING_PLANE_ICON: string;
+    const VIEWER_CLIPPING_FLIP_ICON: string;
+    const VIEWER_DELETE_CLIPPING_PLANE_ICON: string;
+    const VIEWER_CLIPPING_CUBE_ICON: string;
+    const VIEWER_DISABLED_DELETE_CLIPPING_PLANE_ICON: string;
+    const VIEWER_DISABLED_CLIPPING_FLIP_ICON: string;
+    const VIEWER_ADD_REMARK_ICON: string;
+}
+export namespace ViewerGeneralIcons {
+    const ZOOM_IN: string;
+    const ZOOM_OUT: string;
+    const CLOSE: string;
+    const STRETCH_WINDOW: string;
+    const EXPAND_TREE: string;
+    const COLLAPSE_TREE: string;
+    const ARROW_DROP_DOWN: string;
+    const ARROW_DROP_RIGHT: string;
+}
 export class Button extends Control {
     
     constructor(id: string);
@@ -2804,6 +2871,7 @@ export class Button extends Control {
     setState(state: Button.State): boolean;
     getState(): Button.State;
     setIcon(iconClassName: string): void;
+    setFromSvgTemlate(template: string): void;
     /**
      * Override this method to be notified when the user clicks on the button.
      * @param {MouseEvent} event

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pilotdev/pilot-web-3d",
-  "version": "23.0.5",
+  "version": "23.0.6-alpha.2",
   "description": "TypeScript definitions for ASCON PilotWeb3D component",
   "main": "",
   "types": "index.d.ts",
@@ -8,7 +8,7 @@
   "author": "JSC Ascon",
   "license": "MIT",
   "typeScriptVersion": "4.9.4",
-  "devDependencies": {
+  "dependencies": {
     "@types/three": "0.148.0"
   },
   "keywords": [