itowns 2.44.2-next.6 → 2.44.3-next.0

package/lib/Controls/FirstPersonControls.js

@@ -63,7 +63,6 @@ function moveCameraVerticalGlobe(value) {
 }
 class FirstPersonControls extends THREE.EventDispatcher {
   /**
-   * @Constructor
    * @param {View} view
    * @param {object} options
    * @param {boolean} options.focusOnClick - whether or not to focus the renderer domElement on click

package/lib/Controls/FlyControls.js

@@ -112,7 +112,6 @@ function onDocumentMouseWheel(event) {
  */
 class FlyControls extends THREE.EventDispatcher {
   /**
-   * @Constructor
    * @param {View} view
    * @param {object} options
    * @param {boolean} options.focusOnClick - whether or not to focus the renderer domElement on click

package/lib/Controls/GlobeControls.js

@@ -1090,11 +1090,11 @@ class GlobeControls extends THREE.EventDispatcher {
    * Zoom parameter is ignored if range is set
    * The tilt's interval is between 4 and 89.5 degree
    *
-   * @param      {CameraUtils~CameraTransformOptions|Extent}   params camera transformation to apply
-   * @param      {number}   [params.zoom]   zoom
-   * @param      {number}   [params.scale]   scale
-   * @param      {boolean}  isAnimated  Indicates if animated
-   * @return     {Promise}  A promise that resolves when transformation is complete
+   * @param {CameraUtils~CameraTransformOptions|Extent} [params] - camera transformation to apply
+   * @param {number} [params.zoom] - zoom
+   * @param {number} [params.scale] - scale
+   * @param {boolean} [isAnimated] - Indicates if animated
+   * @return {Promise} A promise that resolves when transformation is complete
    */
   lookAtCoordinate() {
     let params = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};

package/lib/Controls/StreetControls.js

@@ -78,7 +78,7 @@ function computeTime(distance) {
 }
 
 /**
- * @classdesc Camera controls that can follow a path.
+ * Camera controls that can follow a path.
  * It is used to simulate a street view.
  * It stores a currentPosition and nextPosition, and do a camera traveling to go to next position.
  * It also manages picking on the ground and on other object, like building.
@@ -112,7 +112,6 @@ function computeTime(distance) {
  */
 class StreetControls extends FirstPersonControls {
   /**
-   * @constructor
    * @param { View } view - View where this control will be used
    * @param { Object } options - Configuration of this controls
    * @param { number } [options.wallMaxDistance=1000] - Maximum distance to click on a wall, in meter.

package/lib/Converter/Feature2Mesh.js

@@ -465,7 +465,7 @@ function createInstancedMesh(mesh, count, ptsIn) {
 }
 
 /**
- * Convert a [Feature]{@link Feature} of type POINT to a Instanced meshes
+ * Convert a {@link Feature} of type POINT to a Instanced meshes
  *
  * @param {Object} feature
  * @returns {THREE.Mesh} mesh or GROUP of THREE.InstancedMesh
@@ -488,7 +488,7 @@ function pointsToInstancedMeshes(feature) {
 }
 
 /**
- * Convert a [Feature]{@link Feature} to a Mesh
+ * Convert a {@link Feature} to a Mesh
  * @param {Feature} feature - the feature to convert
  * @param {Object} options - options controlling the conversion
  *

package/lib/Core/3DTiles/C3DTBatchTable.js

@@ -2,7 +2,7 @@ import binaryPropertyAccessor from "./utils/BinaryPropertyAccessor.js";
 import { C3DTilesTypes } from "./C3DTilesEnums.js";
 const utf8Decoder = new TextDecoder();
 
-/** @classdesc
+/**
  * A 3D Tiles
  * [batch
  * table](https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/specification/TileFormats/BatchTable).

package/lib/Core/3DTiles/C3DTBatchTableHierarchyExtension.js

@@ -1,5 +1,4 @@
 /**
- * @classdesc
  * Batch Table part of the 3D Tiles
  * [Batch Table Hierarchy Extension](https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/extensions/3DTILES_batch_table_hierarchy)
  * @property {object} classes - The classes as defined in the specification.

package/lib/Core/3DTiles/C3DTBoundingVolume.js

@@ -78,7 +78,6 @@ function initFromSphere(sphere) {
 }
 
 /**
- * @classdesc 3D Tiles
  * [bounding volume](https://github.com/AnalyticalGraphicsInc/3d-tiles/blob/master/specification/schema/boundingVolume.schema.json)
  * Used to represent bounding volumes and viewer request volumes. The input bounding volume (from the dataset) can be a
  * box, a sphere or a region. Regions are transformed to spheres internally for simplification of parsing and to speed
@@ -132,7 +131,7 @@ class C3DTBoundingVolume {
   }
 
   /**
-   * Checks if the camera is inside the [viewer request volumes](@link https://github.com/CesiumGS/3d-tiles/tree/main/specification#viewer-request-volume).
+   * Checks if the camera is inside the [viewer request volumes](https://github.com/CesiumGS/3d-tiles/tree/main/specification#viewer-request-volume).
    * @param {Camera} camera - the camera to perform culling for
    * @param {THREE.Matrix4} tileMatrixWorld - the world matrix of the tile
    * @returns {boolean} true if the camera is outside the viewer request volume, false otherwise.

package/lib/Core/3DTiles/C3DTExtensions.js

@@ -1,11 +1,11 @@
-/** @classdesc
+/**
  * Class for managing
  * [3D Tiles extensions](https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/extensions).
  * Extensions used in a 3D Tiles tileset must be registered in the iTowns' layer
  * holding the tileset by the user with the {@link registerExtension}
  * method. The extension must be registered together with a class holding the
  * code to interpret the extension.
- * An example of extension class is {@link $3DTBatchTableHierarchyExtension}.
+ * An example of extension class is {@link C3DTBatchTableHierarchyExtension}.
  * This extension has only one part situated in the batch table (but other
  * extensions can have multiple parts, stored in different 3D Tiles classes
  * such as tileset or bounding volume).
@@ -40,7 +40,7 @@ class C3DTExtensions {
    * corresponding to this class. These extension managers should be able
    * to parse the extension fragment (done in the constructor) and should
    * have a getInfoById method if they are related to the batch table class.
-   * See {@link $3DTBatchTableHierarchyExtension} for an example of
+   * See {@link C3DTBatchTableHierarchyExtension} for an example of
    * extension class.
    */
   registerExtension(extensionName, extensionManagers) {

package/lib/Core/3DTiles/C3DTileset.js

@@ -8,7 +8,7 @@ import { C3DTilesTypes } from "./C3DTilesEnums.js";
 // to a reference local to the tile.
 const tileMatrixInverse = new THREE.Matrix4();
 
-/** @classdesc
+/**
  * A 3D Tiles
  *  [Tileset](https://github.com/AnalyticalGraphicsInc/3d-tiles/blob/master/specification/schema/tileset.schema.json).
  * @property {C3DTilesTypes} type - Used by 3D Tiles extensions

package/lib/Core/Feature.js

@@ -26,6 +26,7 @@ export const FEATURE_TYPES = {
 };
 
 /**
+ * @typedef {Object} FeatureBuildingOptions
  * @property {string} crs - The CRS to convert the input coordinates to.
  * @property {string} [structure='2d'] - data structure type : 2d or 3d.
  * If the structure is 3d, the feature have 3 dimensions by vertices positions and
@@ -42,8 +43,7 @@ export const FEATURE_TYPES = {
  * @property {Style} style - The style to inherit when creating
  * style for all new features.
  *
-*/
-export class FeatureBuildingOptions {}
+ */
 
 /**
  * @property {Extent} extent - The 2D extent containing all the points
@@ -322,8 +322,8 @@ const alignYtoEast = new THREE.Quaternion();
  * @property {boolean} isInverted - This option is to be set to the
  * correct value, true or false (default being false), if the computation of
  * the coordinates needs to be inverted to same scheme as OSM, Google Maps
- * or other system. See [this link]{@link
- * https://alastaira.wordpress.com/2011/07/06/converting-tms-tile-coordinates-to-googlebingosm-tile-coordinates}
+ * or other system. See [this link](
+ * https://alastaira.wordpress.com/2011/07/06/converting-tms-tile-coordinates-to-googlebingosm-tile-coordinates)
  * for more informations.
  * @property {THREE.Matrix4} matrixWorldInverse - The matrix world inverse.
  * @property {Coordinates} center - The local center coordinates in `EPSG:4326`.
@@ -422,7 +422,7 @@ export class FeatureCollection extends THREE.Object3D {
   }
 
   /**
-   * Remove features that don't have [FeatureGeometry]{@link FeatureGeometry}.
+   * Remove features that don't have {@link FeatureGeometry}.
    */
   removeEmptyFeature() {
     this.features = this.features.filter(feature => feature.geometries.length);

package/lib/Core/Geographic/Coordinates.js

@@ -20,11 +20,23 @@ function proj4cache(crsIn, crsOut) {
 }
 
 /**
- * A Coordinates object, defined by a [crs]{@link http://inspire.ec.europa.eu/theme/rs}
+ * A Coordinates object, defined by a [crs](http://inspire.ec.europa.eu/theme/rs)
  * and three values. These values are accessible through `x`, `y` and `z`,
  * although it can also be accessible through `latitude`, `longitude` and
  * `altitude`. To change a value, prefer the `set()` method below.
  *
+ * `EPSG:4978` and `EPSG:4326` are supported by default. To use another CRS,
+ * you have to declare it with `proj4`. You can find most projections and their
+ * proj4 code at [epsg.io](https://epsg.io/).
+ *
+ * @example
+ * new Coordinates('EPSG:4978', 20885167, 849862, 23385912); //Geocentric coordinates
+ * new Coordinates('EPSG:4326', 2.33, 48.24, 24999549); //Geographic coordinates
+ *
+ * @example
+ * // Declare EPSG:3946 with proj4
+ * itowns.proj4.defs('EPSG:3946', '+proj=lcc +lat_1=45.25 +lat_2=46.75 +lat_0=46 +lon_0=3 +x_0=1700000 +y_0=5200000 +ellps=GRS80 +towgs84=0,0,0,0,0,0,0 +units=m +no_defs');
+ *
  * @property {boolean} isCoordinates - Used to checkout whether this coordinates
  * is a Coordinates. Default is true. You should not change this, as it is used
  * internally for optimisation.
@@ -40,22 +52,10 @@ function proj4cache(crsIn, crsOut) {
  * @property {number} altitude - The third value of the coordinate.
  * @property {THREE.Vector3} geodesicNormal - The geodesic normal of the
  * coordinate.
- *
- * @example
- * new Coordinates('EPSG:4978', 20885167, 849862, 23385912); //Geocentric coordinates
- *
- * @example
- * new Coordinates('EPSG:4326', 2.33, 48.24, 24999549); //Geographic coordinates
  */
 class Coordinates {
   /**
-   * @constructor
-   *
-   * @param {string} crs - A supported Coordinate Reference System. 'EPSG:4978' and 'EPSG:4326' are
-   * supported by default. To use another CRS, you have to declare it with proj4. For instance:
-   * @example
-   * itowns.proj4.defs('EPSG:3946', '+proj=lcc +lat_1=45.25 +lat_2=46.75 +lat_0=46 +lon_0=3 +x_0=1700000 +y_0=5200000 +ellps=GRS80 +towgs84=0,0,0,0,0,0,0 +units=m +no_defs');
-   * You can find most projections and their proj4 code at [epsg.io]{@link https://epsg.io/}
+   * @param {string} crs - A supported Coordinate Reference System.
    * @param {number|Array<number>|Coordinates|THREE.Vector3} [v0=0] -
    * x or longitude value, or a more complex one: it can be an array of three
    * numbers, being x/lon, y/lat, z/alt, or it can be `THREE.Vector3`. It can
@@ -277,7 +277,7 @@ class Coordinates {
   }
 
   /**
-   * Returns coordinates in the wanted [CRS]{@link http://inspire.ec.europa.eu/theme/rs}.
+   * Returns coordinates in the wanted [CRS](http://inspire.ec.europa.eu/theme/rs).
    *
    * @param {string} crs - The CRS to convert the Coordinates into.
    * @param {Coordinates} [target] - The target to put the converted

package/lib/Core/Geographic/Extent.js

@@ -39,7 +39,10 @@ for (let i = cardinals.length - 1; i >= 0; i--) {
   cardinals[i] = new Coordinates('EPSG:4326', 0, 0, 0, 0);
 }
 const _c = new Coordinates('EPSG:4326', 0, 0);
+
+/** @private */
 export const globalExtentTMS = new Map();
+/** @private */
 export const schemeTiles = new Map();
 function getInfoTms(crs) {
   const epsg = CRS.formatToEPSG(crs);

package/lib/Core/Geographic/GeoidGrid.js

@@ -13,13 +13,13 @@ function biLinearInterpolation(indexes, getData) {
 
 /**
  * An instance of `GeoidGrid` allows accessing some geoid height grid data from geographic instances (like some
- * `{@link Coordinates}`). The geoid height grid data must contain geoid height values for a set of geographic points
+ * {@link Coordinates}). The geoid height grid data must contain geoid height values for a set of geographic points
  * regularly dispatched on a planar surface.
  *
  * @property    {Extent}        extent      The geographic extent of the geoid height grid data.
  * @property    {THREE.Vector2} step        The distance between two consecutive points of the geoid height grid. The
-                                            * `x` value stands for the distance along the West-East direction, and the
-                                            * `y` value stands for the distance along the South-North direction.
+ * `x` value stands for the distance along the West-East direction, and the
+ * `y` value stands for the distance along the South-North direction.
  * @property    {THREE.Vector2} dimensions  The planar dimensions of the geoid height grid data extent.
  * @property    {THREE.Vector2} dataSize    The number of values in the gridded data along the West-East direction (`x`
                                             * axis) and the South-North direction (`y` axis).
@@ -61,21 +61,21 @@ class GeoidGrid {
   /**
    * @param   {Extent}        extent      The geographic extent of the geoid height grid data.
    * @param   {THREE.Vector2} step        The distance between two consecutive points of the geoid height grid. The
-                                          * `x` value stands for the distance along the West-East direction, and the
-                                          * `y` value stands for the distance along the South-North direction.
+   * `x` value stands for the distance along the West-East direction, and the
+   * `y` value stands for the distance along the South-North direction.
    * @param   {function}      getData     A method that allows reading a value in the geoid height grid from its
-                                          * vertical and horizontal indexes. The lower an index, the lower the
-                                          * coordinate on the corresponding axis - 0 being the index of the minimal
-                                          * coordinate of the gridded data on a given axis. In other words :
-                                          * - `getData(0, 0)` must return the geoid height value at the SOUTH-WEST
-                                          *   corner of your data extent.
-                                          * - `getData(0, j)` must return a geoid height on the southern limit of your
-                                          *   data extent.
-                                          * - `getData(i, 0)` must return a geoid height on the western limit of your
-                                          *   data extent.
-                                          * - if your gridded data has dimensions (rowNumber, colNumber),
-                                          *   `getData(rowNumber - 1, colNumber - 1)` must return the geoid height at
-                                          *   the NORTH-EAST corner of your data extent.
+   * vertical and horizontal indexes. The lower an index, the lower the
+   * coordinate on the corresponding axis - 0 being the index of the minimal
+   * coordinate of the gridded data on a given axis. In other words :
+   * - `getData(0, 0)` must return the geoid height value at the SOUTH-WEST
+   *   corner of your data extent.
+   * - `getData(0, j)` must return a geoid height on the southern limit of your
+   *   data extent.
+   * - `getData(i, 0)` must return a geoid height on the western limit of your
+   *   data extent.
+   * - if your gridded data has dimensions (rowNumber, colNumber),
+   *   `getData(rowNumber - 1, colNumber - 1)` must return the geoid height at
+   *   the NORTH-EAST corner of your data extent.
    */
   constructor(extent, step, getData) {
     CRS.isGeographic(extent.crs);
@@ -87,12 +87,12 @@ class GeoidGrid {
   }
 
   /**
-   * Get the value of the geoid height at given geographic `{@link Coordinates}`. The geoid height value is
+   * Get the value of the geoid height at given geographic {@link Coordinates}. The geoid height value is
    * bi-linearly interpolated from the gridded data accessed by the `GeoidGrid` instance.
    *
    * @param   {Coordinates}   coordinates     Geographic coordinates to get the geoid height value at.
    *
-   * @returns {number}    The geoid height value at the given `{@link Coordinates}`, bi-interpolated from the gridded
+   * @returns {number}    The geoid height value at the given {@link Coordinates}, bi-interpolated from the gridded
                           * data accessed by the `GeoidGrid` instance.
    */
   getHeightAtCoordinates(coordinates) {

package/lib/Core/Prefab/Globe/Atmosphere.js

@@ -38,9 +38,8 @@ class Atmosphere extends GeometryLayer {
    *
   * The atmospheric-scattering it is taken from :
   * * [Atmosphere Shader From Space (Atmospheric scattering)](http://stainlessbeer.weebly.com/planets-9-atmospheric-scattering.html)
-  * * [Accurate Atmospheric Scattering (NVIDIA GPU Gems 2)]{@link https://developer.nvidia.com/gpugems/gpugems2/part-ii-shading-lighting-and-shadows/chapter-16-accurate-atmospheric-scattering}.
+  * * [Accurate Atmospheric Scattering (NVIDIA GPU Gems 2)](https://developer.nvidia.com/gpugems/gpugems2/part-ii-shading-lighting-and-shadows/chapter-16-accurate-atmospheric-scattering).
   *
-  * @constructor
   * @extends GeometryLayer
   *
   * @param {string} id - The id of the layer Atmosphere.

package/lib/Core/Prefab/Globe/GlobeLayer.js

@@ -24,7 +24,6 @@ class GlobeLayer extends TiledGeometryLayer {
    * A {@link TiledGeometryLayer} to use with a {@link GlobeView}. It has
    * specific method for updating and subdivising its grid.
    *
-   * @constructor
    * @extends TiledGeometryLayer
    *
    * @param {string} id - The id of the layer, that should be unique. It is

package/lib/Core/Prefab/GlobeView.js

@@ -63,7 +63,6 @@ class GlobeView extends View {
   /**
    * Creates a view of a globe.
    *
-   * @constructor
    * @extends View
    *
    * @example <caption><b>Instance GlobeView.</b></caption>
@@ -77,8 +76,8 @@ class GlobeView extends View {
    * @param {HTMLDivElement} viewerDiv - Where to attach the view and display it
    * in the DOM.
    * @param {CameraTransformOptions|Extent} placement - An object to place view
-   * @param {object=} options - See options of {@link View}.
-   * @param {Object} options.controls - See options of {@link GlobeControls}
+   * @param {object} [options] - See options of {@link View}.
+   * @param {Object} [options.controls] - See options of {@link GlobeControls}
    */
   constructor(viewerDiv) {
     let placement = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};

package/lib/Core/Prefab/Planar/PlanarLayer.js

@@ -14,7 +14,6 @@ class PlanarLayer extends TiledGeometryLayer {
    * A {@link TiledGeometryLayer} to use with a {@link PlanarView}. It has
    * specific method for updating and subdivising its grid.
    *
-   * @constructor
    * @extends TiledGeometryLayer
    *
    * @param {string} id - The id of the layer, that should be unique. It is

package/lib/Core/Prefab/PlanarView.js

@@ -5,7 +5,6 @@ import PlanarControls from "../../Controls/PlanarControls.js";
 import PlanarLayer from "./Planar/PlanarLayer.js";
 class PlanarView extends View {
   /**
-   * @constructor
    * @extends View
    *
    * @example <caption><b>Instance with placement on the ground.</b></caption>
@@ -16,9 +15,9 @@ class PlanarView extends View {
    * @param {HTMLDivElement} viewerDiv - Where to attach the view and display it
    * in the DOM.
    * @param {Extent} extent - The ground extent.
-   * @param {object=} options - See options of {@link View}.
+   * @param {Object} [options] - See options of {@link View}.
    * @param {boolean} [options.noControls=false] - If true, no controls are associated to the view.
-   * @param {object=} [options.controls] - options for the {@link PlanarControls} associated to the view, if
+   * @param {Object} [options.controls] - options for the {@link PlanarControls} associated to the view, if
    * `options.noControls` is false.
    * @param {CameraUtils~CameraTransformOptions|Extent} [options.placement] - The
    * {@link CameraUtils~CameraTransformOptions} to apply to view's camera or the extent it must display at

package/lib/Core/Style.js

@@ -7,7 +7,7 @@ import { deltaE } from "../Renderer/Color.js";
 import Coordinates from "./Geographic/Coordinates.js";
 /* babel-plugin-inline-import './StyleChunk/itowns_stroke_single_before.css' */
 const itowns_stroke_single_before = ".itowns-stroke-single:before {\n    display: var(--text_stroke_display);\n    content: attr(data-before);\n    opacity: 1;\n    position: absolute;\n    -webkit-text-stroke-width: var(--text_stroke_width);\n    -webkit-text-stroke-color: var(--text_stroke_color);\n    left: 0;\n    right: 0;\n    bottom: 0;\n    top: 0;\n    z-index: -1;\n    white-space: inherit;\n    overflow-wrap: inherit;\n    letter-spacing: inherit;\n    text-align: inherit;\n    padding: inherit;\n    font-family: inherit;\n    text-transform: inherit;\n    max-width: inherit;\n    font-size: inherit;\n}\n";
-export const cacheStyle = new Cache();
+const cacheStyle = new Cache();
 const matrix = document.createElementNS('http://www.w3.org/2000/svg', 'svg').createSVGMatrix();
 const canvas = document.createElement('canvas');
 const inv255 = 1 / 255;
@@ -177,8 +177,7 @@ function defineStyleProperty(style, category, parameter, userValue, defaultValue
 }
 
 /**
- * @class
- * @classdesc StyleContext stores metadata of one FeatureGeometry that are needed for its style computation:
+ * StyleContext stores metadata of one FeatureGeometry that are needed for its style computation:
  * type of feature and what is needed (fill, stroke or draw a point, etc.) as well as where to get its
  * properties and its coordinates (for base_altitude).
  *
@@ -295,8 +294,11 @@ function _addIcon(icon, domElement, opt) {
 }
 
 /**
+ * An object that can contain any properties (order, zoom, fill, stroke, point,
+ * text or/and icon) and sub properties of a Style.<br/>
+ * Used for the instanciation of a {@link Style}.
+ *
  * @typedef {Object} StyleOptions
- * @memberof StyleOptions
  *
  * @property {Number} [order] - Order of the features that will be associated to
  * the style. It can helps sorting and prioritizing features if needed.
@@ -313,12 +315,12 @@ function _addIcon(icon, domElement, opt) {
  * @property {Image|Canvas|String|Object|Function} [fill.pattern] - Defines a pattern to fill the
  * surface with. It can be an `Image` to use directly, an url to fetch the pattern or an object containing
  * the url of the image to fetch and the transformation to apply.
- * from. See [this example] (http://www.itowns-project.org/itowns/examples/#source_file_geojson_raster)
+ * from. See [this example](http://www.itowns-project.org/itowns/examples/#source_file_geojson_raster)
  * for how to use.
  * @property {Image|String} [fill.pattern.source] - The image or the url to fetch the pattern image
  * @property {Object} [fill.pattern.cropValues] - The x, y, width and height (in pixel) of the sub image to use.
- * @property {THREE.Color} [fill.pattern.color] - Can be any [valid color string]
- * (https://developer.mozilla.org/en-US/docs/Web/CSS/color_value).
+ * @property {THREE.Color} [fill.pattern.color] - Can be any
+ * [valid color string](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value).
  * It will change the color of the white pixels of the source image.
  * @property {Number|Function} [fill.opacity] - The opacity of the color or of the
  * pattern. Can be between `0.0` and `1.0`. Default is `1.0`.
@@ -439,17 +441,7 @@ function _addIcon(icon, domElement, opt) {
 */
 
 /**
- * @description An object that can contain any properties
- * (order, zoom, fill, stroke, point, text or/and icon)
- * and sub properties of a Style.<br/>
- * Used for the instanciation of a {@link Style}.
- * @hideconstructor
- */
-export class StyleOptions {}
-
-/**
- * @class
- * @classdesc A Style is a class that defines the visual appearance of {@link
+ * A Style is a class that defines the visual appearance of {@link
  * FeatureCollection} and {@link Feature}. It is taken into account when drawing
  * them in textures that will be placed onto tiles.
  *
@@ -620,8 +612,7 @@ class Style {
   /**
    * @param {StyleOptions} [params={}] An object that contain any properties
    * (order, zoom, fill, stroke, point, text or/and icon)
-   * and sub properties of a Style (@see {@link StyleOptions}).
-   * @constructor
+   * and sub properties of a Style ({@link StyleOptions}).
    */
   constructor() {
     let params = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};

package/lib/Core/TileMesh.js

@@ -5,7 +5,6 @@ import { geoidLayerIsVisible } from "../Layer/GeoidLayer.js";
 /**
  * A TileMesh is a THREE.Mesh with a geometricError and an OBB
  * The objectId property of the material is the with the id of the TileMesh
- * @constructor
  * @param {TileGeometry} geometry - the tile geometry
  * @param {THREE.Material} material - a THREE.Material compatible with THREE.Mesh
  * @param {Layer} layer - the layer the tile is added to

package/lib/Core/View.js

@@ -138,21 +138,19 @@ class View extends THREE.EventDispatcher {
    *
    * @param {string} crs - The default CRS of Three.js coordinates. Should be a cartesian CRS.
    * @param {HTMLElement} viewerDiv - Where to instanciate the Three.js scene in the DOM
-   * @param {Object=} options - Optional properties.
+   * @param {Object} [options] - Optional properties.
    * @param {object} [options.camera] - Options for the camera associated to the view. See {@link Camera} options.
-   * @param {?MainLoop} options.mainLoop - {@link MainLoop} instance to use, otherwise a default one will be constructed
-   * @param {?(WebGLRenderer|object)} options.renderer - {@link WebGLRenderer} instance to use, otherwise
+   * @param {MainLoop} [options.mainLoop] - {@link MainLoop} instance to use, otherwise a default one will be constructed
+   * @param {WebGLRenderer|Object} [options.renderer] - {@link WebGLRenderer} instance to use, otherwise
    * a default one will be constructed. In this case, if options.renderer is an object, it will be used to
    * configure the renderer (see {@link c3DEngine}.  If not present, a new <canvas> will be created and
    * added to viewerDiv (mutually exclusive with mainLoop)
-   * @param {boolean|Object} [options.webXR=false] - enable webxr button to switch on VR visualization.
+   * @param {Object} [options.webXR] - enable webxr button to switch on VR visualization.
    * @param {number} [options.webXR.scale=1.0] - apply webxr scale tranformation.
-   * @param {?Scene} [options.scene3D] - [THREE.Scene](https://threejs.org/docs/#api/en/scenes/Scene) instance to use, otherwise a default one will be constructed
-   * @param {?Color} options.diffuse - [THREE.Color](https://threejs.org/docs/?q=color#api/en/math/Color) Diffuse color terrain material.
+   * @param {Scene} [options.scene3D] - [THREE.Scene](https://threejs.org/docs/#api/en/scenes/Scene) instance to use, otherwise a default one will be constructed
+   * @param {Color} [options.diffuse] - [THREE.Color](https://threejs.org/docs/?q=color#api/en/math/Color) Diffuse color terrain material.
    * This color is applied to terrain if there isn't color layer on terrain extent (by example on pole).
    * @param {boolean} [options.enableFocusOnStart=true] - enable focus on dom element on start.
-   *
-   * @constructor
    */
   constructor(crs, viewerDiv) {
     let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};

package/lib/Layer/C3DTilesLayer.js

@@ -55,7 +55,6 @@ class C3DTilesLayer extends GeometryLayer {
   #fillColorMaterialsBuffer;
   /**
    * @deprecated Deprecated 3D Tiles layer. Use {@link OGC3DTilesLayer} instead.
-   * @constructor
    * @extends GeometryLayer
    *
    * @example
@@ -92,11 +91,11 @@ class C3DTilesLayer extends GeometryLayer {
    * @param {Number} [config.cleanupDelay=1000] The time (in ms) after which a tile content (and its children) are
    * removed from the scene.
    * @param {C3DTExtensions} [config.registeredExtensions] 3D Tiles extensions managers registered for this tileset.
-   * @param {String} [config.pntsMode= PNTS_MODE.COLOR] {@link PointsMaterials} Point cloud coloring mode.
+   * @param {String} [config.pntsMode= PNTS_MODE.COLOR] {@link PointsMaterial} Point cloud coloring mode.
    *      Only 'COLOR' or 'CLASSIFICATION' are possible. COLOR uses RGB colors of the points,
    *      CLASSIFICATION uses a classification property of the batch table to color points.
    * @param {String} [config.pntsShape= PNTS_SHAPE.CIRCLE] Point cloud point shape. Only 'CIRCLE' or 'SQUARE' are possible.
-   * @param {String} [config.pntsSizeMode= PNTS_SIZE_MODE.VALUE] {@link PointsMaterials} Point cloud size mode. Only 'VALUE' or 'ATTENUATED' are possible. VALUE use constant size, ATTENUATED compute size depending on distance from point to camera.
+   * @param {String} [config.pntsSizeMode= PNTS_SIZE_MODE.VALUE] {@link PointsMaterial} Point cloud size mode. Only 'VALUE' or 'ATTENUATED' are possible. VALUE use constant size, ATTENUATED compute size depending on distance from point to camera.
    * @param {Number} [config.pntsMinAttenuatedSize=3] Minimum scale used by 'ATTENUATED' size mode
    * @param {Number} [config.pntsMaxAttenuatedSize=10] Maximum scale used by 'ATTENUATED' size mode
    * @param {Style} [config.style=null] - style used for this layer
@@ -248,7 +247,7 @@ class C3DTilesLayer extends GeometryLayer {
   }
 
   /**
-   * Call by {@link 3dTilesProcessing} which handle load and unload of 3DTiles
+   * Called when a tile content is loaded
    * @param {THREE.Object3D} tileContent - tile as THREE.Object3D
    */
   onTileContentLoaded(tileContent) {

package/lib/Layer/ColorLayer.js

@@ -51,7 +51,6 @@ class ColorLayer extends RasterLayer {
    * it can be an aerial view of the ground or a simple transparent layer with the
    * roads displayed.
    *
-   * @constructor
    * @extends Layer
    *
    * @param {string} id - The id of the layer, that should be unique. It is
@@ -65,13 +64,13 @@ class ColorLayer extends RasterLayer {
    * @param {Source} [config.source] - Description and options of the source.
    * @param {number} [config.magFilter] - How the texture is sampled when a texel covers more than one pixel. [see](https://threejs.org/docs/?q=texture#api/en/textures/Texture.magFilter)
    * @param {number} [config.minFilter] - How the texture is sampled when a texel covers less than one pixel. [see](https://threejs.org/docs/?q=texture#api/en/textures/Texture.minFilter)
-   * @param {number} [effect_type=0] - type effect to apply on raster color.
+   * @param {number} [config.effect_type=0] - type effect to apply on raster color.
    * if `effect_type` equals:
    * * `0`: no special effect.
    * * `1`: light color to invisible effect.
    * * `2`: white color to invisible effect.
    * * `3`: custom shader effect (defined `ShaderChunk.customBodyColorLayer` and `ShaderChunk.customHeaderColorLayer`).
-   * @param {number} [effect_parameter=1.0] - amount value used with effect applied on raster color.
+   * @param {number} [config.effect_parameter=1.0] - amount value used with effect applied on raster color.
    *
    * @example
    * // Create a ColorLayer

package/lib/Layer/CopcLayer.js

@@ -3,7 +3,6 @@ import CopcNode from "../Core/CopcNode.js";
 import PointCloudLayer from "./PointCloudLayer.js";
 
 /**
- * @classdesc
  * A layer for [Cloud Optimised Point Cloud](https://copc.io) (COPC) datasets.
  * See {@link PointCloudLayer} class for documentation on base properties.
  *

package/lib/Layer/ElevationLayer.js

@@ -28,7 +28,6 @@ class ElevationLayer extends RasterLayer {
    * A simple layer, managing an elevation texture to add some reliefs on the
    * plane or globe view for example.
    *
-   * @constructor
    * @extends Layer
    *
    * @param {string} id - The id of the layer, that should be unique. It is

package/lib/Layer/EntwinePointTileLayer.js

@@ -15,7 +15,6 @@ class EntwinePointTileLayer extends PointCloudLayer {
   /**
    * Constructs a new instance of Entwine Point Tile layer.
    *
-   * @constructor
    * @extends PointCloudLayer
    *
    * @example

package/lib/Layer/FeatureGeometryLayer.js

@@ -15,7 +15,6 @@ import Feature2Mesh from "../Converter/Feature2Mesh.js";
  */
 class FeatureGeometryLayer extends GeometryLayer {
   /**
-   * @constructor
    * @extends GeometryLayer
    *
    * @param {string} id - The id of the layer, that should be unique. It is

package/lib/Layer/GeometryLayer.js

@@ -14,16 +14,15 @@ import ObjectRemovalHelper from "../Process/ObjectRemovalHelper.js";
  * internally for optimisation.
  * @property {number} [zoom.max=Infinity] - this is the maximum zoom beyond which it'll be hidden.
  * The `max` is constant and the value is `Infinity` because there's no maximum display level after which it is hidden.
- * This property is used only if the layer is attached to [TiledGeometryLayer]{@link TiledGeometryLayer}.
+ * This property is used only if the layer is attached to {@link TiledGeometryLayer}.
  * @property {number} [zoom.min=0] - this is the minimum zoom from which it'll be visible.
- * This property is used only if the layer is attached to [TiledGeometryLayer]{@link TiledGeometryLayer}.
+ * This property is used only if the layer is attached to {@link TiledGeometryLayer}.
  */
 class GeometryLayer extends Layer {
   /**
    * A layer usually managing a geometry to display on a view. For example, it
    * can be a layer of buildings extruded from a a WFS stream.
    *
-   * @constructor
    * @extends Layer
    *
    * @param {string} id - The id of the layer, that should be unique. It is
@@ -183,8 +182,7 @@ class GeometryLayer extends Layer {
   }
 
   /**
-   * Picking method for this layer. It uses the {@link Picking#pickObjectsAt}
-   * method.
+   * Picking method for this layer.
    *
    * @param {View} view - The view instance.
    * @param {Object} coordinates - The coordinates to pick in the view. It