@xeokit/xeokit-sdk 2.2.5-beta-2 → 2.2.5-beta-3

package/dist/xeokit-sdk.cjs.js

@@ -6956,7 +6956,7 @@ function Core() {
      Existing {@link Scene}s , mapped to their IDs
      @property scenes
      @namespace xeokit
-     @type {{Scene}}
+     @type {Scene}
      */
     this.scenes = {};
 
@@ -12025,7 +12025,7 @@ class Canvas extends Component {
          * ````
          *
          * @property boundary
-         * @type {{Number[]}}
+         * @type {Number[]}
          * @final
          */
         this.boundary = [
@@ -39819,8 +39819,8 @@ class GLTFDefaultDataSource {
      * Gets metamodel JSON.
      *
      * @param {String|Number} metaModelSrc Identifies the metamodel JSON asset.
-     * @param {{Function(*)}} ok Fired on successful loading of the metamodel JSON asset.
-     * @param {{Function(*)}} error Fired on error while loading the metamodel JSON asset.
+     * @param {Function} ok Fired on successful loading of the metamodel JSON asset.
+     * @param {Function} error Fired on error while loading the metamodel JSON asset.
      */
     getMetaModel(metaModelSrc, ok, error) {
         utils.loadJSON(metaModelSrc,
@@ -71533,8 +71533,8 @@ class GLTFLoaderPlugin extends Plugin {
      * @param {String} [params.metaModelSrc] Path to an optional metadata file, as an alternative to the ````metaModelData```` parameter.
      * @param {*} [params.metaModelData] JSON model metadata, as an alternative to the ````metaModelSrc```` parameter.
      * @param {{String:Object}} [params.objectDefaults] Map of initial default states for each loaded {@link Entity} that represents an object. Default value is {@link IFCObjectDefaults}.
-     * @params {String[]} [params.includeTypes] When loading metadata, only loads objects that have {@link MetaObject}s with {@link MetaObject#type} values in this list.
-     * @params {String[]} [params.excludeTypes] When loading metadata, never loads objects that have {@link MetaObject}s with {@link MetaObject#type} values in this list.
+     * @param {String[]} [params.includeTypes] When loading metadata, only loads objects that have {@link MetaObject}s with {@link MetaObject#type} values in this list.
+     * @param {String[]} [params.excludeTypes] When loading metadata, never loads objects that have {@link MetaObject}s with {@link MetaObject#type} values in this list.
      * @param {Boolean} [params.edges=false] Whether or not xeokit renders the model with edges emphasized.
      * @param {Number[]} [params.origin=[0,0,0]] The double-precision World-space origin of the model's coordinates.
      * @param {Number[]} [params.position=[0,0,0]] The single-precision position, relative to ````origin````.
@@ -71543,7 +71543,7 @@ class GLTFLoaderPlugin extends Plugin {
      * @param {Number[]} [params.matrix=[1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,1]] The model's world transform matrix. Overrides the position, scale and rotation parameters. Relative to ````origin````.
      * @param {Boolean} [params.backfaces=false] When true, allows visible backfaces, wherever specified in the glTF. When false, ignores backfaces.
      * @param {Number} [params.edgeThreshold=10] When xraying, highlighting, selecting or edging, this is the threshold angle between normals of adjacent triangles, below which their shared wireframe edge is not drawn.
-     * @params {Boolean} [params.performance=true] Set ````false```` to load all the materials and textures provided by the glTF file, otherwise leave ````true```` to load the default high-performance representation optimized for low memory usage and efficient rendering.
+     * @param {Boolean} [params.performance=true] Set ````false```` to load all the materials and textures provided by the glTF file, otherwise leave ````true```` to load the default high-performance representation optimized for low memory usage and efficient rendering.
      * @returns {Entity} Entity representing the model, which will have {@link Entity#isModel} set ````true```` and will be registered by {@link Entity#id} in {@link Scene#models}
      */
     load(params = {}) {
@@ -80293,8 +80293,8 @@ class XKTDefaultDataSource {
      * Gets metamodel JSON.
      *
      * @param {String|Number} metaModelSrc Identifies the metamodel JSON asset.
-     * @param {{Function(*)}} ok Fired on successful loading of the metamodel JSON asset.
-     * @param {{Function(*)}} error Fired on error while loading the metamodel JSON asset.
+     * @param {Function} ok Fired on successful loading of the metamodel JSON asset.
+     * @param {Function} error Fired on error while loading the metamodel JSON asset.
      */
     getMetaModel(metaModelSrc, ok, error) {
         utils.loadJSON(metaModelSrc,
@@ -137510,7 +137510,7 @@ class Curve extends Component {
     /**
      * Gets the tangent on this Curve at position {@link Curve#t}.
      *
-     * @returns {{Number[]}} The tangent.
+     * @returns {Number[]} The tangent.
      */
     get tangent() {
         return this.getTangent(this._t);
@@ -137530,7 +137530,7 @@ class Curve extends Component {
      * Returns a normalized tangent vector on this Curve at the given position.
      *
      * @param {Number} t Position to get tangent at.
-     * @returns {{Number[]}} Normalized tangent vector
+     * @returns {Number[]} Normalized tangent vector
      */
     getTangent(t) {
         var delta = 0.0001;
@@ -142800,7 +142800,7 @@ class CubicBezierCurve extends Curve {
      *
      * @param {Number} t Position to get point at.
      *
-     * @returns {{Number[]}} The point at the given position.
+     * @returns {Number[]} The point at the given position.
      */
     get point() {
         return this.getPoint(this._t);
@@ -142811,7 +142811,7 @@ class CubicBezierCurve extends Curve {
      *
      * @param {Number} t Position to get point at.
      *
-     * @returns {{Number[]}} The point at the given position.
+     * @returns {Number[]} The point at the given position.
      */
     getPoint(t) {
 
@@ -142988,7 +142988,7 @@ class Path extends Curve {
     /**
      * Gets point on this Path corresponding to the current value of {@link Path#t}.
      *
-     * @returns {{Number[]}} The point.
+     * @returns {Number[]} The point.
      */
     get point() {
         return this.getPoint(this._t);
@@ -143008,7 +143008,7 @@ class Path extends Curve {
      * Gets a point on this Path corresponding to the given progress position.
      *
      * @param {Number} t Indicates point of progress along this curve, in the range [0..1].
-     * @returns {{Number[]}}
+     * @returns {Number[]}
      */
     getPoint(t) {
         var d = t * this.length;
@@ -143197,7 +143197,7 @@ class QuadraticBezierCurve extends Curve {
      Point on this QuadraticBezierCurve at position {@link QuadraticBezierCurve/t}.
 
      @property point
-     @type {{Number[]}}
+     @type {Number[]}
      */
     get point() {
         return this.getPoint(this._t);

package/dist/xeokit-sdk.es.js

@@ -6952,7 +6952,7 @@ function Core() {
      Existing {@link Scene}s , mapped to their IDs
      @property scenes
      @namespace xeokit
-     @type {{Scene}}
+     @type {Scene}
      */
     this.scenes = {};
 
@@ -12021,7 +12021,7 @@ class Canvas extends Component {
          * ````
          *
          * @property boundary
-         * @type {{Number[]}}
+         * @type {Number[]}
          * @final
          */
         this.boundary = [
@@ -39815,8 +39815,8 @@ class GLTFDefaultDataSource {
      * Gets metamodel JSON.
      *
      * @param {String|Number} metaModelSrc Identifies the metamodel JSON asset.
-     * @param {{Function(*)}} ok Fired on successful loading of the metamodel JSON asset.
-     * @param {{Function(*)}} error Fired on error while loading the metamodel JSON asset.
+     * @param {Function} ok Fired on successful loading of the metamodel JSON asset.
+     * @param {Function} error Fired on error while loading the metamodel JSON asset.
      */
     getMetaModel(metaModelSrc, ok, error) {
         utils.loadJSON(metaModelSrc,
@@ -71529,8 +71529,8 @@ class GLTFLoaderPlugin extends Plugin {
      * @param {String} [params.metaModelSrc] Path to an optional metadata file, as an alternative to the ````metaModelData```` parameter.
      * @param {*} [params.metaModelData] JSON model metadata, as an alternative to the ````metaModelSrc```` parameter.
      * @param {{String:Object}} [params.objectDefaults] Map of initial default states for each loaded {@link Entity} that represents an object. Default value is {@link IFCObjectDefaults}.
-     * @params {String[]} [params.includeTypes] When loading metadata, only loads objects that have {@link MetaObject}s with {@link MetaObject#type} values in this list.
-     * @params {String[]} [params.excludeTypes] When loading metadata, never loads objects that have {@link MetaObject}s with {@link MetaObject#type} values in this list.
+     * @param {String[]} [params.includeTypes] When loading metadata, only loads objects that have {@link MetaObject}s with {@link MetaObject#type} values in this list.
+     * @param {String[]} [params.excludeTypes] When loading metadata, never loads objects that have {@link MetaObject}s with {@link MetaObject#type} values in this list.
      * @param {Boolean} [params.edges=false] Whether or not xeokit renders the model with edges emphasized.
      * @param {Number[]} [params.origin=[0,0,0]] The double-precision World-space origin of the model's coordinates.
      * @param {Number[]} [params.position=[0,0,0]] The single-precision position, relative to ````origin````.
@@ -71539,7 +71539,7 @@ class GLTFLoaderPlugin extends Plugin {
      * @param {Number[]} [params.matrix=[1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,1]] The model's world transform matrix. Overrides the position, scale and rotation parameters. Relative to ````origin````.
      * @param {Boolean} [params.backfaces=false] When true, allows visible backfaces, wherever specified in the glTF. When false, ignores backfaces.
      * @param {Number} [params.edgeThreshold=10] When xraying, highlighting, selecting or edging, this is the threshold angle between normals of adjacent triangles, below which their shared wireframe edge is not drawn.
-     * @params {Boolean} [params.performance=true] Set ````false```` to load all the materials and textures provided by the glTF file, otherwise leave ````true```` to load the default high-performance representation optimized for low memory usage and efficient rendering.
+     * @param {Boolean} [params.performance=true] Set ````false```` to load all the materials and textures provided by the glTF file, otherwise leave ````true```` to load the default high-performance representation optimized for low memory usage and efficient rendering.
      * @returns {Entity} Entity representing the model, which will have {@link Entity#isModel} set ````true```` and will be registered by {@link Entity#id} in {@link Scene#models}
      */
     load(params = {}) {
@@ -80289,8 +80289,8 @@ class XKTDefaultDataSource {
      * Gets metamodel JSON.
      *
      * @param {String|Number} metaModelSrc Identifies the metamodel JSON asset.
-     * @param {{Function(*)}} ok Fired on successful loading of the metamodel JSON asset.
-     * @param {{Function(*)}} error Fired on error while loading the metamodel JSON asset.
+     * @param {Function} ok Fired on successful loading of the metamodel JSON asset.
+     * @param {Function} error Fired on error while loading the metamodel JSON asset.
      */
     getMetaModel(metaModelSrc, ok, error) {
         utils.loadJSON(metaModelSrc,
@@ -137506,7 +137506,7 @@ class Curve extends Component {
     /**
      * Gets the tangent on this Curve at position {@link Curve#t}.
      *
-     * @returns {{Number[]}} The tangent.
+     * @returns {Number[]} The tangent.
      */
     get tangent() {
         return this.getTangent(this._t);
@@ -137526,7 +137526,7 @@ class Curve extends Component {
      * Returns a normalized tangent vector on this Curve at the given position.
      *
      * @param {Number} t Position to get tangent at.
-     * @returns {{Number[]}} Normalized tangent vector
+     * @returns {Number[]} Normalized tangent vector
      */
     getTangent(t) {
         var delta = 0.0001;
@@ -142796,7 +142796,7 @@ class CubicBezierCurve extends Curve {
      *
      * @param {Number} t Position to get point at.
      *
-     * @returns {{Number[]}} The point at the given position.
+     * @returns {Number[]} The point at the given position.
      */
     get point() {
         return this.getPoint(this._t);
@@ -142807,7 +142807,7 @@ class CubicBezierCurve extends Curve {
      *
      * @param {Number} t Position to get point at.
      *
-     * @returns {{Number[]}} The point at the given position.
+     * @returns {Number[]} The point at the given position.
      */
     getPoint(t) {
 
@@ -142984,7 +142984,7 @@ class Path extends Curve {
     /**
      * Gets point on this Path corresponding to the current value of {@link Path#t}.
      *
-     * @returns {{Number[]}} The point.
+     * @returns {Number[]} The point.
      */
     get point() {
         return this.getPoint(this._t);
@@ -143004,7 +143004,7 @@ class Path extends Curve {
      * Gets a point on this Path corresponding to the given progress position.
      *
      * @param {Number} t Indicates point of progress along this curve, in the range [0..1].
-     * @returns {{Number[]}}
+     * @returns {Number[]}
      */
     getPoint(t) {
         var d = t * this.length;
@@ -143193,7 +143193,7 @@ class QuadraticBezierCurve extends Curve {
      Point on this QuadraticBezierCurve at position {@link QuadraticBezierCurve/t}.
 
      @property point
-     @type {{Number[]}}
+     @type {Number[]}
      */
     get point() {
         return this.getPoint(this._t);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xeokit/xeokit-sdk",
-  "version": "2.2.5-beta-2",
+  "version": "2.2.5-beta-3",
   "description": "Web Programming Toolkit for 3D/2D BIM and AEC Graphics",
   "module": "/dist/xeokit-sdk.es.js",
   "main": "/dist/xeokit-sdk.cjs.js",
@@ -9,6 +9,7 @@
     "build": "rollup --config rollup.config.js; rollup --config rollup.minified.config.js; cp node_modules/web-ifc/web-ifc.wasm dist/.",
     "test": "percy exec -- node ./snapshots.js",
     "docs": "rm -Rf ./docs/*; ./node_modules/.bin/esdoc",
+    "typedocs": "rm -Rf ./docs/*; typedoc --tsconfig tsconfig.json",
     "publish": "npm publish --access public"
   },
   "repository": {
@@ -45,9 +46,9 @@
   },
   "homepage": "https://xeokit.io",
   "dependencies": {
-    "web-ifc": "0.0.30",
     "@loaders.gl/core": "^3.0.13",
-    "@loaders.gl/las": "^3.0.13"
+    "@loaders.gl/las": "^3.0.13",
+    "web-ifc": "0.0.30"
   },
   "devDependencies": {
     "@babel/cli": "^7.15.7",
@@ -66,9 +67,11 @@
     "http-server": "^0.12.3",
     "jest": "^27.2.2",
     "jest-webgl-canvas-mock": "^0.2.3",
+    "parse5": "^6.0.1",
     "rollup": "^2.46.0",
     "rollup-plugin-node-resolve": "^5.2.0",
-    "rollup-plugin-terser": "^7.0.2"
+    "rollup-plugin-terser": "^7.0.2",
+    "typedoc": "^0.22.13"
   },
   "files": [
     "/dist",

package/types/extras/ContextMenu/ContextMenu.d.ts

@@ -1,9 +1,9 @@
 export declare type ContextMenuConfiguration = {
-  /** The context menu items. These can also be dynamically set on {@link ContextMenu#items}. See the class documentation for an example. */
+  /** The context menu items. These can also be dynamically set on {@link ContextMenu.items}. See the class documentation for an example. */
   items?: any;
-  /** The context, which is passed into the item callbacks. This can also be dynamically set on {@link ContextMenu#context}. This must be set before calling {@link ContextMenu#show}. */
+  /** The context, which is passed into the item callbacks. This can also be dynamically set on {@link ContextMenu.context}. This must be set before calling {@link ContextMenu.show}. */
   context?: any;
-  /** Whether this ````ContextMenu```` is initially enabled. {@link ContextMenu#show} does nothing while this is ````false````. */
+  /** Whether this ````ContextMenu```` is initially enabled. {@link ContextMenu.show} does nothing while this is ````false````. */
   enabled?: boolean;
   /** Whether this ````ContextMenu```` automatically hides whenever we mouse-down or tap anywhere in the page. */
   hideOnMouseDown?: boolean;
@@ -41,9 +41,9 @@ export declare class ContextMenu {
   /**
    * Sets the ````ContextMenu```` context.
    *
-   * The context can be any object that you need to be provides to the callbacks configured on {@link ContextMenu#items}.
+   * The context can be any object that you need to be provides to the callbacks configured on {@link ContextMenu.items}.
    *
-   * This must be set before calling {@link ContextMenu#show}.
+   * This must be set before calling {@link ContextMenu.show}.
    *
    * @type {Object}
    */
@@ -68,7 +68,7 @@ export declare class ContextMenu {
   /**
    * Gets whether this ````ContextMenu```` is enabled.
    *
-   * {@link ContextMenu#show} does nothing while this is ````false````.
+   * {@link ContextMenu.show} does nothing while this is ````false````.
    *
    * @type {Boolean}
    */
@@ -93,9 +93,9 @@ export declare class ContextMenu {
   /**
    * Shows this ````ContextMenu```` at the given page coordinates.
    *
-   * Does nothing when {@link ContextMenu#enabled} is ````false````.
+   * Does nothing when {@link ContextMenu.enabled} is ````false````.
    *
-   * Logs error to console and does nothing if {@link ContextMenu#context} has not been set.
+   * Logs error to console and does nothing if {@link ContextMenu.context} has not been set.
    *
    * Fires a "shown" event when shown.
    *

package/types/plugins/AngleMeasurementsPlugin/AngleMeasurement.d.ts

@@ -5,7 +5,7 @@ import { Marker } from "../../viewer/scene/marker";
 /**
  * @desc Measures the angle indicated by three 3D points.
  */
-export class AngleMeasurement extends Component {
+export declare class AngleMeasurement extends Component {
   /**
    * The {@link AngleMeasurementsPlugin} that owns this AngleMeasurement.
    * @type {AngleMeasurementsPlugin}

package/types/plugins/AngleMeasurementsPlugin/AngleMeasurementsControl.d.ts

@@ -1,4 +1,5 @@
 import { Component } from "../../viewer/scene/Component";
+import { AngleMeasurement } from "./AngleMeasurement";
 import { AngleMeasurementsPlugin } from "./AngleMeasurementsPlugin";
 
 /**
@@ -6,7 +7,7 @@ import { AngleMeasurementsPlugin } from "./AngleMeasurementsPlugin";
  *
  * Once the AngleMeasurementControl is activated, the first click on any {@link Entity} begins constructing a {@link AngleMeasurement}, fixing its origin to that Entity. The next click on any Entity will complete the AngleMeasurement, fixing its target to that second Entity. The AngleMeasurementControl will then wait for the next click on any Entity, to begin constructing another AngleMeasurement, and so on, until deactivated.
  */
-export class AngleMeasurementsControl extends Component {
+export declare class AngleMeasurementsControl extends Component {
   /**
    * The {@link AngleMeasurementsPlugin} that owns this AngleMeasurementsControl.
    * @type {AngleMeasurementsPlugin}
@@ -39,4 +40,28 @@ export class AngleMeasurementsControl extends Component {
    * Does nothing if the AngleMeasurementsControl is not active.
    */
   reset(): void;
+
+  /**
+   * Fires when the measurement is ended.
+   * @param event The measurementEnd event
+   * @param callback Called fired on the event
+   * @param scope  Scope for the callback
+   */
+   on(event: "measurementEnd", callback: (measurement: AngleMeasurement) => void, scope?: any): string
+
+   /**
+   * Fires when the measurement is cancelled.
+   * @param event The measurementCancel event
+   * @param callback Called fired on the event
+   * @param scope  Scope for the callback
+   */
+  on(event: "measurementCancel", callback: (measurement: AngleMeasurement) => void, scope?: any): string
+
+  /**
+   * Fires when the measurement is started.
+   * @param event The measurementStart event
+   * @param callback Called fired on the event
+   * @param scope  Scope for the callback
+   */
+  on(event: "measurementStart", callback: (measurement: AngleMeasurement) => void, scope?: any): string
 }

package/types/plugins/AngleMeasurementsPlugin/AngleMeasurementsPlugin.d.ts

@@ -3,7 +3,7 @@ import { AngleMeasurement } from "./AngleMeasurement";
 import { AngleMeasurementsControl } from "./AngleMeasurementsControl";
 
 export declare type AngleMeasurementsPluginConfiguration = {
-  /** Optional ID for this plugin, so that we can find it within {@link Viewer#plugins}. */
+  /** Optional ID for this plugin, so that we can find it within {@link Viewer.plugins}. */
   id?: string;
   /** Container DOM element for markers and labels. Defaults to ````document.body````. */
   container?: HTMLElement;
@@ -17,69 +17,83 @@ export declare type AngleMeasurementsPluginConfiguration = {
  * {@link Viewer} plugin for measuring angles.
  */
 export declare class AngleMeasurementsPlugin extends Plugin {
-    /**
-     * @constructor
-     * @param {Viewer} viewer The Viewer.
-     * @param {AngleMeasurementsPluginConfiguration} [cfg]  Plugin configuration.
-    */
-    constructor(viewer: Viewer, cfg?: AngleMeasurementsPluginConfiguration);
+  /**
+   * @constructor
+   * @param {Viewer} viewer The Viewer.
+   * @param {AngleMeasurementsPluginConfiguration} [cfg]  Plugin configuration.
+  */
+  constructor(viewer: Viewer, cfg?: AngleMeasurementsPluginConfiguration);
 
-    /**
-     * Gets the {@link AngleMeasurementsControl}, which creates {@link AngleMeasurement}s from user input.
-     *
-     * @type {AngleMeasurementsControl}
-     */
-    get control(): AngleMeasurementsControl;
+  /**
+   * Gets the {@link AngleMeasurementsControl}, which creates {@link AngleMeasurement}s from user input.
+   *
+   * @type {AngleMeasurementsControl}
+   */
+  get control(): AngleMeasurementsControl;
 
-    /**
-     * Gets the existing {@link AngleMeasurement}s, each mapped to its {@link AngleMeasurement#id}.
-     *
-     * @type {{String:AngleMeasurement}}
-     */
-    get measurements(): { [key:string]: AngleMeasurement};
+  /**
+   * Gets the existing {@link AngleMeasurement}s, each mapped to its {@link AngleMeasurement.id}.
+   *
+   * @type {{String:AngleMeasurement}}
+   */
+  get measurements(): { [key:string]: AngleMeasurement};
 
-    /**
-     * Creates an {@link AngleMeasurement}.
-     *
-     * The AngleMeasurement is then registered by {@link AngleMeasurement#id} in {@link AngleMeasurementsPlugin#measurements}.
-     *
-     * @param {Object} params {@link AngleMeasurement} configuration.
-     * @param {String} params.id Unique ID to assign to {@link AngleMeasurement#id}. The AngleMeasurement will be registered by this in {@link AngleMeasurementsPlugin#measurements} and {@link Scene.components}. Must be unique among all components in the {@link Viewer}.
-     * @param {Number[]} params.origin.worldPos Origin World-space 3D position.
-     * @param {Entity} params.origin.entity Origin Entity.
-     * @param {Number[]} params.corner.worldPos Corner World-space 3D position.
-     * @param {Entity} params.corner.entity Corner Entity.
-     * @param {Number[]} params.target.worldPos Target World-space 3D position.
-     * @param {Entity} params.target.entity Target Entity.
-     * @param {Boolean} [params.visible=true] Whether to initially show the {@link AngleMeasurement}.
-     * @returns {AngleMeasurement} The new {@link AngleMeasurement}.
-     */
-    createMeasurement(params?: {
-        id: string;
-        origin: {
-          entity: Entity;
-          worldPos: number[];
-        },
-        corner: {
-          entity: Entity;
-          worldPos: number[];
-        },
-        target: {
-          entity: Entity;
-          worldPos: number[];
-        },
-        visible?: boolean;
-    }): AngleMeasurement;
+  /**
+   * Creates an {@link AngleMeasurement}.
+   *
+   * The AngleMeasurement is then registered by {@link AngleMeasurement.id} in {@link AngleMeasurementsPlugin.measurements}.
+   *
+   * @param {Object} params {@link AngleMeasurement} configuration.
+   * @param {String} params.id Unique ID to assign to {@link AngleMeasurement.id}. The AngleMeasurement will be registered by this in {@link AngleMeasurementsPlugin.measurements} and {@link Scene.components}. Must be unique among all components in the {@link Viewer}.
+   * @param {Number[]} params.origin.worldPos Origin World-space 3D position.
+   * @param {Entity} params.origin.entity Origin Entity.
+   * @param {Number[]} params.corner.worldPos Corner World-space 3D position.
+   * @param {Entity} params.corner.entity Corner Entity.
+   * @param {Number[]} params.target.worldPos Target World-space 3D position.
+   * @param {Entity} params.target.entity Target Entity.
+   * @param {Boolean} [params.visible=true] Whether to initially show the {@link AngleMeasurement}.
+   * @returns {AngleMeasurement} The new {@link AngleMeasurement}.
+   */
+  createMeasurement(params?: {
+      id: string;
+      origin: {
+        entity: Entity;
+        worldPos: number[];
+      },
+      corner: {
+        entity: Entity;
+        worldPos: number[];
+      },
+      target: {
+        entity: Entity;
+        worldPos: number[];
+      },
+      visible?: boolean;
+  }): AngleMeasurement;
 
-    /**
-     * Destroys a {@link AngleMeasurement}.
-     *
-     * @param {String} id ID of AngleMeasurement to destroy.
-     */
-    destroyMeasurement(id: string): void;
-    
-    /**
-     * Destroys all {@link AngleMeasurement}s.
-     */
-    clear(): void;
+  /**
+   * Destroys a {@link AngleMeasurement}.
+   *
+   * @param {String} id ID of AngleMeasurement to destroy.
+   */
+  destroyMeasurement(id: string): void;
+  
+  /**
+   * Destroys all {@link AngleMeasurement}s.
+   */
+  clear(): void;
+
+  /**
+   * Fires when a measurement is created.
+   * @param {String} event The measurementCreated event
+   * @param {Function} callback Callback fired on the event
+   */
+  on(event: "measurementCreated", callback: (measurement: AngleMeasurement)=> void): void;
+
+  /**
+   * Fires when a measurement is destroyed.
+   * @param {String} event The measurementDestroyed event
+   * @param {Function} callback Callback fired on the event
+   */
+  on(event: "measurementDestroyed", callback: (measurement: AngleMeasurement)=> void): void;
 }

package/types/plugins/AnnotationsPlugin/Annotation.d.ts

@@ -1,9 +1,10 @@
+import { Marker } from "../../viewer/scene/marker";
 import { AnnotationsPlugin } from "./AnnotationsPlugin";
+
 /**
  * A {@link Marker} with an HTML label attached to it, managed by an {@link AnnotationsPlugin}.
  */
-export class Annotation {
-
+export declare class Annotation extends Marker {
   /**
    * The {@link AnnotationsPlugin} this Annotation was created by.
    * @type {AnnotationsPlugin}
@@ -11,7 +12,7 @@ export class Annotation {
   plugin: AnnotationsPlugin;
 
   /**
-   * Optional World-space position for {@link Camera#eye}, used when this Annotation is associated with a {@link Camera} position.
+   * Optional World-space position for {@link Camera.eye}, used when this Annotation is associated with a {@link Camera} position.
    *
    * Undefined by default.
    *
@@ -20,7 +21,7 @@ export class Annotation {
   eye: number[];
   
   /**
-   * Optional World-space position for {@link Camera#look}, used when this Annotation is associated with a {@link Camera} position.
+   * Optional World-space position for {@link Camera.look}, used when this Annotation is associated with a {@link Camera} position.
    *
    * Undefined by default.
    *
@@ -29,7 +30,7 @@ export class Annotation {
   look: number[];
 
   /**
-   * Optional World-space position for {@link Camera#up}, used when this Annotation is associated with a {@link Camera} position.
+   * Optional World-space position for {@link Camera.up}, used when this Annotation is associated with a {@link Camera} position.
    *
    * Undefined by default.
    *
@@ -38,7 +39,7 @@ export class Annotation {
   up: number[];
 
   /**
-   * Optional projection type for {@link Camera#projection}, used when this Annotation is associated with a {@link Camera} position.
+   * Optional projection type for {@link Camera.projection}, used when this Annotation is associated with a {@link Camera} position.
    *
    * Undefined by default.
    *
@@ -51,7 +52,7 @@ export class Annotation {
    *
    * The marker shows the Annotation's position.
    *
-   * The marker is only visible when both this property and {@link Annotation#visible} are ````true````.
+   * The marker is only visible when both this property and {@link Annotation.visible} are ````true````.
    *
    * See {@link AnnotationsPlugin} for more info.
    *
@@ -64,7 +65,7 @@ export class Annotation {
    *
    * The marker shows the Annotation's position.
    *
-   * The marker is only visible when both this property and {@link Annotation#visible} are ````true````.
+   * The marker is only visible when both this property and {@link Annotation.visible} are ````true````.
    *
    * See {@link AnnotationsPlugin} for more info.
    *
@@ -75,7 +76,7 @@ export class Annotation {
   /**
    * Sets whether or not to show this Annotation's label.
    *
-   * The label is only visible when both this property and {@link Annotation#visible} are ````true````.
+   * The label is only visible when both this property and {@link Annotation.visible} are ````true````.
    *
    * See {@link AnnotationsPlugin} for more info.
    *
@@ -86,7 +87,7 @@ export class Annotation {
   /**
    * Gets whether or not to show this Annotation's label.
    *
-   * The label is only visible when both this property and {@link Annotation#visible} are ````true````.
+   * The label is only visible when both this property and {@link Annotation.visible} are ````true````.
    *
    * See {@link AnnotationsPlugin} for more info.
    *