@arcgis/map-components 4.33.0-next.161 → 4.33.0-next.163

package/dist/docs/api.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-06-15T04:37:41",
+  "timestamp": "2025-06-17T04:36:34",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "4.33.0-next.161",
+    "version": "4.33.0-next.163",
     "typescriptVersion": "5.8.3"
   },
   "schemaVersion": "1.0.0",
@@ -661,7 +661,7 @@
           "customElement": true,
           "name": "ArcgisAreaMeasurement3d",
           "tagName": "arcgis-area-measurement-3d",
-          "description": "The Area Measurement 3D component calculates and displays the area and perimeter of a polygon.\nThis component can be used in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html)\nto measure the area and perimeter of a polygon.",
+          "description": "The Area Measurement 3D component calculates and displays the area and perimeter of a polygon.\nIt can be used in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)\ncomponent to measure the area and perimeter of a polygon.\n\n[![measurement-area-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/3D_AreaMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n\nHow the area and perimeter are computed depends on the scene's spatial reference and the length of the measured perimeter.\n\nIn **geographic coordinate systems** (GCS) and in **Web Mercator**:\n- If the measurement's perimeter is below 100 km, they are computed in a Euclidean manner,\n  in an [ECEF](https://en.wikipedia.org/wiki/ECEF) coordinate system (or equivalent on other planets).\n- If the perimeter is above 100 km, they are computed geodetically, and the visualization takes\n  the curvature of the planet into consideration.\n\nIn **projected coordinate systems** (PCS), apart from Web Mercator, the area and perimeter\nare always calculated in a Euclidean manner (in their respective PCS).\n\nThe area may be visualized and calculated in two ways:\n1. If all the vertices are more or less **coplanar** (aligning onto a horizontal or a sloped plane),\n  the area and perimeter are projected to that plane. Also, the measurements are computed on that plane.\n2. If the vertices have varying z-values and they create a **non-planar** surface, the visualization and the\nmeasurements show the area and perimeter that are projected to a horizontal plane.\n\n![area-measurement-3d-types](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/area-measurement-3d-types.png)\n\nWhen the component is active, a horizontal \"laser\" line is drawn which indicates the height at the current mouse position.\nThis line can help in analyzing the heights of objects relative to each other and the terrain.\n\nThe Area Measurement 3D is designed to work in the Scene component. For measurements in the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)\ncomponent, use [Area Measurement 2D](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-area-measurement-2d/).\n\n**Things to consider**\n\n* Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.\n* Layer types currently supported for snapping are:\n[FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),\n[GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) (except Mesh geometries),\n[GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),\n[WFSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WFSLayer.html),\n[CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),\n[3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html),\nand [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).\n\n**See also**\n\n- [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-AreaMeasurementAnalysis.html)\n- [Sample - Measurement in 3D](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n- [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)",
           "demos": [
             {
               "description": "Docs",
@@ -683,7 +683,7 @@
             {
               "kind": "field",
               "name": "analysis",
-              "description": "Analysis data object.",
+              "description": "The [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-AreaMeasurementAnalysis.html)\ncreated or modified by the component.\n\nIf no programmatically created analysis is provided, the component automatically creates an empty analysis on its own and adds it to the view.\nIn this case, the analysis will also be automatically removed from the view when the component is destroyed.\n\n\n```js\n// Create the analysis.\nconst areaMeasurementAnalysis = new AreaMeasurementAnalysis({\n   geometry: new Polygon({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     rings: [\n       [\n         [-13624861.22274897, 4550346.5519295, 63.378210234455764],\n         [-13624935.305160372, 4550273.144585712, 63.37829629518092],\n         [-13624995.61798748, 4550334.030096778, 63.37819860037416],\n         [-13624921.53589075, 4550407.42357004, 63.3783810287714],\n         [-13624861.22274897, 4550346.5519295, 63.378210234455764]\n       ]\n     ]\n   })\n});\n// Get the Scene and measurement component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst areaMeasurement3d = document.querySelector(\"arcgis-area-measurement-3d\");\nawait areaMeasurement3d.componentOnReady();\n// Add the analysis to the view component.\nviewElement.analyses.add(areaMeasurementAnalysis);\n// Connect the analysis to the measurement component:\nareaMeasurement3d.analysis = areaMeasurementAnalysis;\n```",
               "type": {
                 "text": "AreaMeasurementAnalysis",
                 "references": [
@@ -716,6 +716,7 @@
             {
               "kind": "method",
               "name": "clear",
+              "description": "Clears the current measurement.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -923,6 +924,7 @@
             {
               "kind": "method",
               "name": "start",
+              "description": "Starts a new measurement.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -943,7 +945,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the component.",
+              "description": "The component's state. The values mean the following:\n\n* `disabled` -  not ready yet\n* `ready` - ready for measuring\n* `measuring` - currently measuring\n* `measured` - measuring has finished",
               "type": {
                 "text": "\"disabled\" | \"measured\" | \"measuring\" | \"ready\"",
                 "values": [
@@ -972,7 +974,7 @@
             {
               "kind": "field",
               "name": "unit",
-              "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values.",
+              "description": "Unit system (imperial, metric) or specific unit used for displaying the area values. Possible values are listed in\n[unitOptions](#unitOptions).",
               "type": {
                 "text": "\"acres\" | \"ares\" | \"hectares\" | \"imperial\" | \"metric\" | \"square-centimeters\" | \"square-decimeters\" | \"square-feet\" | \"square-inches\" | \"square-kilometers\" | \"square-meters\" | \"square-miles\" | \"square-millimeters\" | \"square-nautical-miles\" | \"square-us-feet\" | \"square-yards\"",
                 "values": [
@@ -1047,7 +1049,7 @@
             {
               "kind": "field",
               "name": "unitOptions",
-              "description": "List of unit systems (imperial, metric) and specific units for displaying the distance values.",
+              "description": "List of available units and unit systems (imperial, metric) for displaying the area values.\nBy default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.\nPossible [unit](#unit) values can only be a subset of this list.\nWith this, it is possible to limit which options are shown in the component's dropdown.",
               "type": {
                 "text": "Array<\"square-millimeters\" | \"square-centimeters\" | \"square-decimeters\" | \"square-meters\" | \"square-kilometers\" | \"square-inches\" | \"square-feet\" | \"square-yards\" | \"square-miles\" | \"square-nautical-miles\" | \"square-us-feet\" | \"acres\" | \"ares\" | \"hectares\" | \"imperial\" | \"metric\">",
                 "references": [
@@ -1165,7 +1167,7 @@
             },
             {
               "name": "state",
-              "description": "The current state of the component.",
+              "description": "The component's state. The values mean the following:\n\n* `disabled` -  not ready yet\n* `ready` - ready for measuring\n* `measuring` - currently measuring\n* `measured` - measuring has finished",
               "type": {
                 "text": "\"disabled\" | \"measured\" | \"measuring\" | \"ready\"",
                 "values": [
@@ -1191,7 +1193,7 @@
             },
             {
               "name": "unit",
-              "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values.",
+              "description": "Unit system (imperial, metric) or specific unit used for displaying the area values. Possible values are listed in\n[unitOptions](#unitOptions).",
               "type": {
                 "text": "\"acres\" | \"ares\" | \"hectares\" | \"imperial\" | \"metric\" | \"square-centimeters\" | \"square-decimeters\" | \"square-feet\" | \"square-inches\" | \"square-kilometers\" | \"square-meters\" | \"square-miles\" | \"square-millimeters\" | \"square-nautical-miles\" | \"square-us-feet\" | \"square-yards\"",
                 "values": [
@@ -5360,7 +5362,7 @@
           "customElement": true,
           "name": "ArcgisBuildingExplorer",
           "tagName": "arcgis-building-explorer",
-          "description": "The Building Explorer component is used to filter and explore the various components of [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html). BuildingSceneLayers are complex digital models of buildings and interiors and can contain thousands of components grouped in sublayers. Using this component, buildings can be filtered by level, construction phase or by disciplines and categories.",
+          "description": "The Building Explorer component is used to filter and explore the various components of [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html). BuildingSceneLayers are complex digital models of buildings and interiors and can contain thousands of components grouped in sublayers. Using this component, buildings can be filtered by level, construction phase or by disciplines and categories.\n\n**Known limitations**\n\nBuilding Explorer is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.",
           "demos": [
             {
               "description": "Docs",
@@ -5449,7 +5451,7 @@
             {
               "kind": "field",
               "name": "headingLevel",
-              "description": "Indicates the heading level to use for the headings in the widget.",
+              "description": "Indicates the heading level to use for the component title.",
               "type": {
                 "text": "number",
                 "values": [
@@ -5506,7 +5508,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).\n\nSee also: [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)",
               "type": {
                 "text": "string",
                 "values": [
@@ -5516,18 +5518,12 @@
                 ]
               },
               "default": "\"organization\"",
-              "attribute": "icon",
-              "docsTags": [
-                {
-                  "name": "see",
-                  "text": "[Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)"
-                }
-              ]
+              "attribute": "icon"
             },
             {
               "kind": "field",
               "name": "label",
-              "description": "The widget's default label.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer.html#label)",
+              "description": "The component's default label.",
               "type": {
                 "text": "string",
                 "values": [
@@ -5541,7 +5537,7 @@
             {
               "kind": "field",
               "name": "layers",
-              "description": "A [collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html) of layers of type [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html)\nthat are added to the widget for exploration.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer.html#layers)",
+              "description": "A [collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html)\nof layers of type [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html)\nthat are added to the componen for exploration.",
               "type": {
                 "text": "Collection<BuildingSceneLayer>",
                 "references": [
@@ -5706,7 +5702,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the view model that can be used for rendering the UI of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer-BuildingExplorerViewModel.html#state)",
+              "description": "The component's state. The values mean the following:\n\n* `disabled` -  \tcomponent is being created\n* `loading` - layers and statistics are loading\n* `ready` - component is ready\n* `failed` - component failed to load data",
               "type": {
                 "text": "\"disabled\" | \"failed\" | \"loading\" | \"ready\"",
                 "values": [
@@ -5752,7 +5748,7 @@
             },
             {
               "name": "heading-level",
-              "description": "Indicates the heading level to use for the headings in the widget.",
+              "description": "Indicates the heading level to use for the component title.",
               "type": {
                 "text": "number",
                 "values": [
@@ -5805,7 +5801,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).\n\nSee also: [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)",
               "type": {
                 "text": "string",
                 "values": [
@@ -5819,7 +5815,7 @@
             },
             {
               "name": "label",
-              "description": "The widget's default label.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer.html#label)",
+              "description": "The component's default label.",
               "type": {
                 "text": "string",
                 "values": [
@@ -5891,7 +5887,7 @@
             },
             {
               "name": "state",
-              "description": "The current state of the view model that can be used for rendering the UI of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer-BuildingExplorerViewModel.html#state)",
+              "description": "The component's state. The values mean the following:\n\n* `disabled` -  \tcomponent is being created\n* `loading` - layers and statistics are loading\n* `ready` - component is ready\n* `failed` - component failed to load data",
               "type": {
                 "text": "\"disabled\" | \"failed\" | \"loading\" | \"ready\"",
                 "values": [
@@ -8379,7 +8375,7 @@
           "customElement": true,
           "name": "ArcgisDaylight",
           "tagName": "arcgis-daylight",
-          "description": "The Daylight component can be used to manipulate the lighting conditions of a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).",
+          "description": "The Daylight component can be used to manipulate the lighting conditions of a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\n**Known limitations**\n\nDaylight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.",
           "demos": [
             {
               "description": "Docs",
@@ -8474,7 +8470,7 @@
             {
               "kind": "field",
               "name": "dateOrSeason",
-              "description": "Controls whether the widget displays a date or a season picker.",
+              "description": "Controls whether the component displays a date or a season picker.",
               "type": {
                 "text": "\"date\" | \"season\"",
                 "values": [
@@ -8530,7 +8526,7 @@
             {
               "kind": "field",
               "name": "headingLevel",
-              "description": "Indicates the heading level to use for the widget title.",
+              "description": "Indicates the heading level to use for the component title.",
               "type": {
                 "text": "number",
                 "values": [
@@ -8629,7 +8625,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).\n\nSee also: [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)",
               "type": {
                 "text": "string",
                 "values": [
@@ -8639,18 +8635,12 @@
                 ]
               },
               "default": "\"brightness\"",
-              "attribute": "icon",
-              "docsTags": [
-                {
-                  "name": "see",
-                  "text": "[Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)"
-                }
-              ]
+              "attribute": "icon"
             },
             {
               "kind": "field",
               "name": "label",
-              "description": "The widget's default label.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#label)",
+              "description": "The component's default label.",
               "type": {
                 "text": "string",
                 "values": [
@@ -8861,7 +8851,7 @@
             },
             {
               "name": "date-or-season",
-              "description": "Controls whether the widget displays a date or a season picker.",
+              "description": "Controls whether the component displays a date or a season picker.",
               "type": {
                 "text": "\"date\" | \"season\"",
                 "values": [
@@ -8894,7 +8884,7 @@
             },
             {
               "name": "heading-level",
-              "description": "Indicates the heading level to use for the widget title.",
+              "description": "Indicates the heading level to use for the component title.",
               "type": {
                 "text": "number",
                 "values": [
@@ -8986,7 +8976,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).\n\nSee also: [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)",
               "type": {
                 "text": "string",
                 "values": [
@@ -9000,7 +8990,7 @@
             },
             {
               "name": "label",
-              "description": "The widget's default label.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#label)",
+              "description": "The component's default label.",
               "type": {
                 "text": "string",
                 "values": [
@@ -9123,7 +9113,7 @@
             },
             {
               "name": "arcgisUserDateTimeChange",
-              "description": "Fires when the user changes the date or time in the widget by interacting with the slider, the date picker, the\nseason selector or the play buttons.",
+              "description": "Fires when the user changes the date or time in the component by interacting with the slider, the date picker, the\nseason selector or the play buttons.",
               "type": {
                 "text": "void"
               },
@@ -10220,7 +10210,7 @@
             {
               "kind": "field",
               "name": "searchProperties",
-              "description": "Controls the default properties used when [searching](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search.html).",
+              "description": "Controls the default properties used when searching.",
               "type": {
                 "text": "DirectionsSearchProperties",
                 "references": [
@@ -10715,7 +10705,7 @@
           "customElement": true,
           "name": "ArcgisDirectLineMeasurement3d",
           "tagName": "arcgis-direct-line-measurement-3d",
-          "description": "The Direct Line Measurement 3D component calculates and displays the 3D distance between two points. This component\ncan be used in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html)\nto measure the vertical, horizontal, and direct distance between two points.",
+          "description": "The Direct Line Measurement 3D component calculates and displays the 3D distance between two points.\nIt can be used in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)\ncomponent to measure the vertical, horizontal, and direct distance between two points.\n\n[![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/3D_DirectLineMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n\nHow distances are computed depends on the scene's spatial reference.\n\nIn **geographic coordinate systems** (GCS) and in **Web Mercator**:\n- Direct distance is computed in a Euclidean manner, in an [ECEF](https://en.wikipedia.org/wiki/ECEF) coordinate system (or equivalent on other planets);\n- Horizontal distance is computed geodetically, taking into consideration the curvature of the planet;\n- Vertical distance is computed as an elevation difference.\n\nIn **projected coordinate systems** (PCS), apart from Web Mercator, all three distances (direct, horizontal, and vertical)\n are computed in a Euclidean manner (in their respective PCS).\n\nDirectLineMeasurement3D widget visualizes and labels the direct, horizontal, and vertical distances and displays the same values\nin the UI panel. When the distance between the points is greater than 100 kilometers,\nthe measurement visualization is simplified, and only the horizontal and vertical distances are calculated.\nThe direct distance option becomes unavailable.\n\n![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/direct-line-measurement-3d.png)\n\nWhen the widget is active, a horizontal \"laser\" line is drawn which indicates the height at the current mouse position.\nThis line can help in analyzing the heights of objects relative to each other and the terrain.\nA second laser line shows the intersection of the scene with the vertical plane that passes through the checkered line.\n\nThe Direct Line Measurement 3D is designed to work in the Scene component. For measurements in the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)\ncomponent, use [Distance Measurement 2D](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-distance-measurement-2d/).\n\n**Things to consider**\n\n* Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.\n* Layer types currently supported for snapping are:\n[FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),\n[GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) (except Mesh geometries),\n[GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),\n[WFSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WFSLayer.html),\n[CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),\n[3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html),\nand [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).\n\n**See also**\n\n- [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)\n- [Sample - Measurement in 3D](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n- [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)\n- [Sample - Color theming for interactive tools](https://developers.arcgis.com/javascript/latest/sample-code/view-theme/)",
           "demos": [
             {
               "description": "Docs",
@@ -10737,7 +10727,7 @@
             {
               "kind": "field",
               "name": "analysis",
-              "description": "Analysis data object.",
+              "description": "The [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)\ncreated or modified by the component.\n\nIf no programmatically created analysis is provided, the component automatically creates an empty analysis on its own and adds it to the view.\nIn this case, the analysis will also be automatically removed from the view when the component is destroyed.\n\n\n```js\n// Create the analysis.\nconst directLineAnalysis = new DirectLineMeasurementAnalysis({\n   startPoint: new Point({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     x: -13624995.61798748,\n     y: 4550334.030096778,\n     z: 63.378210234455764\n   }),\n   endPoint: new Point({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     x: -13624921.53589075,\n     y: 4550407.42357004,\n     z: 63.3783810287714\n   }),\n});\n// Get the Scene and measurement component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst directLineMeasurement3d = document.querySelector(\"arcgis-direct-line-measurement-3d\");\nawait directLineMeasurement3d.componentOnReady();\n// Add the analysis to the view component.\nviewElement.analyses.add(directLineAnalysis);\n// Connect the analysis to the measurement component:\ndirectLineMeasurement3d.analysis = directLineAnalysis;\n```",
               "type": {
                 "text": "DirectLineMeasurementAnalysis",
                 "references": [
@@ -10770,6 +10760,7 @@
             {
               "kind": "method",
               "name": "clear",
+              "description": "Clears the current measurement.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -10977,6 +10968,7 @@
             {
               "kind": "method",
               "name": "start",
+              "description": "Starts a new measurement.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -10997,6 +10989,7 @@
             {
               "kind": "field",
               "name": "state",
+              "description": "The component's state. The values mean the following:\n\n* `disabled` -  not ready yet\n* `ready` - ready for measuring\n* `measuring` - currently measuring\n* `measured` - measuring has finished",
               "type": {
                 "text": "\"disabled\" | \"measured\" | \"measuring\" | \"ready\"",
                 "values": [
@@ -11025,7 +11018,7 @@
             {
               "kind": "field",
               "name": "unit",
-              "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values.",
+              "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values. Possible values are listed in\n[unitOptions](#unitOptions).",
               "type": {
                 "text": "\"centimeters\" | \"decimeters\" | \"feet\" | \"imperial\" | \"inches\" | \"kilometers\" | \"meters\" | \"metric\" | \"miles\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\"",
                 "values": [
@@ -11088,7 +11081,7 @@
             {
               "kind": "field",
               "name": "unitOptions",
-              "description": "List of unit systems (imperial, metric) and specific units for displaying the distance values.",
+              "description": "List of available units and unit systems (imperial, metric) for displaying the distance values.\nBy default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.\nPossible [unit](#unit) values can only be a subset of this list.\nWith this, it is possible to limit which options are shown in the component's dropdown.",
               "type": {
                 "text": "Array<\"imperial\" | \"metric\" | \"millimeters\" | \"centimeters\" | \"decimeters\" | \"meters\" | \"kilometers\" | \"inches\" | \"feet\" | \"yards\" | \"miles\" | \"nautical-miles\" | \"us-feet\">",
                 "references": [
@@ -11206,6 +11199,7 @@
             },
             {
               "name": "state",
+              "description": "The component's state. The values mean the following:\n\n* `disabled` -  not ready yet\n* `ready` - ready for measuring\n* `measuring` - currently measuring\n* `measured` - measuring has finished",
               "type": {
                 "text": "\"disabled\" | \"measured\" | \"measuring\" | \"ready\"",
                 "values": [
@@ -11231,7 +11225,7 @@
             },
             {
               "name": "unit",
-              "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values.",
+              "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values. Possible values are listed in\n[unitOptions](#unitOptions).",
               "type": {
                 "text": "\"centimeters\" | \"decimeters\" | \"feet\" | \"imperial\" | \"inches\" | \"kilometers\" | \"meters\" | \"metric\" | \"miles\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\"",
                 "values": [
@@ -11315,7 +11309,7 @@
           "name": "DeprecatedArcgisDirectLineMeasurement3d",
           "tagName": "arcgis-directline-measurement-3d",
           "deprecated": true,
-          "description": "The Direct Line Measurement 3D component calculates and displays the 3D distance between two points. This component can be used in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html) to measure the vertical, horizontal, and direct distance between two points.",
+          "description": "The Directline Measurement 3D component calculates and displays the 3D distance between two points. It can be used in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component to measure the vertical, horizontal, and direct distance between two points.",
           "demos": [
             {
               "description": "Docs",
@@ -11337,7 +11331,7 @@
             {
               "kind": "field",
               "name": "analysis",
-              "description": "Analysis data object.",
+              "description": "The [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)\ncreated or modified by the component.\n\nIf no programmatically created analysis is provided, the component automatically creates an empty analysis on its own and adds it to the view.\nIn this case, the analysis will also be automatically removed from the view when the component is destroyed.\n\n\n```js\n// Create the analysis.\nconst directLineAnalysis = new DirectLineMeasurementAnalysis({\n   startPoint: new Point({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     x: -13624995.61798748,\n     y: 4550334.030096778,\n     z: 63.378210234455764\n   }),\n   endPoint: new Point({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     x: -13624921.53589075,\n     y: 4550407.42357004,\n     z: 63.3783810287714\n   }),\n});\n// Get the Scene and measurement component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst directLineMeasurement3d = document.querySelector(\"arcgis-direct-line-measurement-3d\");\nawait directLineMeasurement3d.componentOnReady();\n// Add the analysis to the view component.\nviewElement.analyses.add(directLineAnalysis);\n// Connect the analysis to the measurement component:\ndirectLineMeasurement3d.analysis = directLineAnalysis;\n```",
               "type": {
                 "text": "DirectLineMeasurementAnalysis",
                 "references": [
@@ -11378,6 +11372,7 @@
             {
               "kind": "method",
               "name": "clear",
+              "description": "Clears the current measurement.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -11609,6 +11604,7 @@
             {
               "kind": "method",
               "name": "start",
+              "description": "Starts a new measurement.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -11633,6 +11629,7 @@
             {
               "kind": "field",
               "name": "state",
+              "description": "The component's state. The values mean the following:\n\n* `disabled` -  not ready yet\n* `ready` - ready for measuring\n* `measuring` - currently measuring\n* `measured` - measuring has finished",
               "type": {
                 "text": "\"disabled\" | \"measured\" | \"measuring\" | \"ready\"",
                 "values": [
@@ -11665,7 +11662,7 @@
             {
               "kind": "field",
               "name": "unit",
-              "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values.",
+              "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values. Possible values are listed in\n[unitOptions](#unitOptions).",
               "type": {
                 "text": "\"centimeters\" | \"decimeters\" | \"feet\" | \"imperial\" | \"inches\" | \"kilometers\" | \"meters\" | \"metric\" | \"miles\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\"",
                 "values": [
@@ -11732,7 +11729,7 @@
             {
               "kind": "field",
               "name": "unitOptions",
-              "description": "List of unit systems (imperial, metric) and specific units for displaying the distance values.",
+              "description": "List of available units and unit systems (imperial, metric) for displaying the distance values.\nBy default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.\nPossible [unit](#unit) values can only be a subset of this list.\nWith this, it is possible to limit which options are shown in the component's dropdown.",
               "type": {
                 "text": "Array<\"imperial\" | \"metric\" | \"millimeters\" | \"centimeters\" | \"decimeters\" | \"meters\" | \"kilometers\" | \"inches\" | \"feet\" | \"yards\" | \"miles\" | \"nautical-miles\" | \"us-feet\">",
                 "references": [
@@ -11874,6 +11871,7 @@
             },
             {
               "name": "state",
+              "description": "The component's state. The values mean the following:\n\n* `disabled` -  not ready yet\n* `ready` - ready for measuring\n* `measuring` - currently measuring\n* `measured` - measuring has finished",
               "inheritedFrom": {
                 "name": "ArcgisDirectLineMeasurement3d",
                 "module": "components/arcgis-direct-line-measurement-3d"
@@ -11903,7 +11901,7 @@
             },
             {
               "name": "unit",
-              "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values.",
+              "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values. Possible values are listed in\n[unitOptions](#unitOptions).",
               "inheritedFrom": {
                 "name": "ArcgisDirectLineMeasurement3d",
                 "module": "components/arcgis-direct-line-measurement-3d"
@@ -13869,7 +13867,7 @@
             {
               "kind": "field",
               "name": "effectiveUnits",
-              "description": "Units which have been selected according to the magnitude of the elevations and distances\nthat are to be displayed in the widget, according to the selected unit or unit system.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileViewModel.html#effectiveUnits)",
+              "description": "Units which have been selected according to the magnitude of the elevations and distances that are to be displayed in the component, according to the selected unit or unit system.",
               "type": {
                 "text": "EffectiveUnits",
                 "references": [
@@ -14030,7 +14028,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).\n\nSee also: [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)",
               "type": {
                 "text": "string",
                 "values": [
@@ -14040,13 +14038,7 @@
                 ]
               },
               "default": "\"altitude\"",
-              "attribute": "icon",
-              "docsTags": [
-                {
-                  "name": "see",
-                  "text": "[Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)"
-                }
-              ]
+              "attribute": "icon"
             },
             {
               "kind": "field",
@@ -14070,7 +14062,7 @@
             {
               "kind": "field",
               "name": "label",
-              "description": "The widget's default label.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#label)",
+              "description": "The component's default label.",
               "type": {
                 "text": "string",
                 "values": [
@@ -14131,7 +14123,7 @@
             {
               "kind": "field",
               "name": "profiles",
-              "description": "Collection of elevation profile lines which are to be generated and displayed in the widget's\nchart.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#profiles)",
+              "description": "Collection of elevation profile lines which are to be generated and displayed in the component's chart.",
               "type": {
                 "text": "Collection<ElevationProfileLineGround | ElevationProfileLineInput | ElevationProfileLineQuery | ElevationProfileLineView>",
                 "references": [
@@ -14268,7 +14260,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the view model that can be used for rendering the UI\nof the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileViewModel.html#state)",
+              "description": "The component's state. The values mean the following:\n\n* `disabled` -  component is being created\n* `ready` - component is ready; no path configured and no interactive operation ongoing\n* `creating` - user is creating a new input path\n* `created` - input path is configured but no interactive operation is ongoing\n* `selecting` - user is selecting an existing input path\n* `selected` - user selected an existing input path",
               "type": {
                 "text": "\"created\" | \"creating\" | \"disabled\" | \"ready\" | \"selected\" | \"selecting\"",
                 "values": [
@@ -14568,7 +14560,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).\n\nSee also: [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)",
               "type": {
                 "text": "string",
                 "values": [
@@ -14582,7 +14574,7 @@
             },
             {
               "name": "label",
-              "description": "The widget's default label.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#label)",
+              "description": "The component's default label.",
               "type": {
                 "text": "string",
                 "values": [
@@ -14654,7 +14646,7 @@
             },
             {
               "name": "state",
-              "description": "The current state of the view model that can be used for rendering the UI\nof the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileViewModel.html#state)",
+              "description": "The component's state. The values mean the following:\n\n* `disabled` -  component is being created\n* `ready` - component is ready; no path configured and no interactive operation ongoing\n* `creating` - user is creating a new input path\n* `created` - input path is configured but no interactive operation is ongoing\n* `selecting` - user is selecting an existing input path\n* `selected` - user selected an existing input path",
               "type": {
                 "text": "\"created\" | \"creating\" | \"disabled\" | \"ready\" | \"selected\" | \"selecting\"",
                 "values": [
@@ -28465,7 +28457,7 @@
           "customElement": true,
           "name": "ArcgisLineOfSight",
           "tagName": "arcgis-line-of-sight",
-          "description": "The Line Of Sight component is a 3D analysis tool that allows you to perform\n[line of sight visibility analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)\nin a 3D view. Visibility between a given observer and multiple target points is calculated against the currently\ndisplayed content in the view, including ground, integrated meshes, and 3D objects such as buildings or trees.\n\nThe results from the analysis are displayed as lines, where the visible part, indicating what the observer can see,\nis colored green. Visible targets are displayed with a green sphere and a fully green line of sight.\nThe spheres marking occluded targets are displayed red, as are the occluded parts of the lines of sight.\nWhen the line of sight cannot be calculated, it will be displayed with a gray color. This may happen if either\nthe target or the observer is not in the view.\n\nWhen creating a new line of sight analysis with the component, the first click in the scene creates the\n[observer](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisObserver.html)\nand any further clicks place the [targets](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisTarget.html).\nBoth, observer and target points, can be moved by dragging them. Additionally, the target points can be removed with a right click.",
+          "description": "The Line Of Sight component is a 3D analysis tool that allows you to perform\n[line of sight visibility analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)\nin a 3D view. Visibility between a given observer and multiple target points is calculated against the currently\ndisplayed content in the view, including ground, integrated meshes, and 3D objects such as buildings or trees.\n\nThe results from the analysis are displayed as lines, where the visible part, indicating what the observer can see,\nis colored green. Visible targets are displayed with a green sphere and a fully green line of sight.\nThe spheres marking occluded targets are displayed red, as are the occluded parts of the lines of sight.\nWhen the line of sight cannot be calculated, it will be displayed with a gray color. This may happen if either\nthe target or the observer is not in the view.\n\nWhen creating a new line of sight analysis with the component, the first click in the scene creates the\n[observer](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisObserver.html)\nand any further clicks place the [targets](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisTarget.html).\nBoth, observer and target points, can be moved by dragging them. Additionally, the target points can be removed with a right click.\n\n**Known limitations**\n\nLine Of Sight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.",
           "demos": [
             {
               "description": "Docs",
@@ -28572,7 +28564,7 @@
             {
               "kind": "method",
               "name": "continue",
-              "description": "After [stop()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-line-of-sight/#stop)\nwas called, this method allows to continue the line of sight analysis and add more targets.",
+              "description": "After [stop()](#stop) was called, this method allows to continue the line of sight analysis and add more targets.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -35202,7 +35194,7 @@
           "customElement": true,
           "name": "ArcgisNavigationToggle",
           "tagName": "arcgis-navigation-toggle",
-          "description": "The Navigation Toggle component can be used to control the navigation mode of a Scene component.\n\nWhen the navigation mode is set to \"pan\" (default), the mouse drag gesture pans the view and right-click + drag allows the user\nto rotate the view. When the navigation mode is set to \"rotate\", the mouse drag gesture rotates the view and\nright-click + drag pans the view.\n\nThe Navigation Toggle component is only supported in 3D.",
+          "description": "The Navigation Toggle component can be used to control the navigation mode of a Scene component.\n\nWhen the navigation mode is set to \"pan\" (default), the mouse drag gesture pans the view and right-click + drag allows the user\nto rotate the view. When the navigation mode is set to \"rotate\", the mouse drag gesture rotates the view and\nright-click + drag pans the view.\n\n**Known limitations**\n\nNavigation Toggle is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.",
           "demos": [
             {
               "description": "Docs",
@@ -35318,7 +35310,7 @@
             {
               "kind": "field",
               "name": "navigationMode",
-              "description": "The navigation mode of the view. See the table below for a list of\npossible values.\n\nPossible Value | Description\n---------------|-------------\npan | The mouse drag gesture pans the view. Right-click + drag allows the user to perform a 3D rotate around the center of the view.\nrotate | The mouse drag gesture performs a 3D rotate around the center of the view and the right-click + drag gesture pans the view.",
+              "description": "The navigation mode of the view. The possible values:\n\n* `pan` - The mouse drag gesture pans the view. Right-click + drag allows the user to perform a 3D rotate around the center of the view.\n* `rotate` - The mouse drag gesture performs a 3D rotate around the center of the view and the right-click + drag gesture pans the view.",
               "type": {
                 "text": "\"pan\" | \"rotate\"",
                 "values": [
@@ -35525,7 +35517,7 @@
             },
             {
               "name": "navigation-mode",
-              "description": "The navigation mode of the view. See the table below for a list of\npossible values.\n\nPossible Value | Description\n---------------|-------------\npan | The mouse drag gesture pans the view. Right-click + drag allows the user to perform a 3D rotate around the center of the view.\nrotate | The mouse drag gesture performs a 3D rotate around the center of the view and the right-click + drag gesture pans the view.",
+              "description": "The navigation mode of the view. The possible values:\n\n* `pan` - The mouse drag gesture pans the view. Right-click + drag allows the user to perform a 3D rotate around the center of the view.\n* `rotate` - The mouse drag gesture performs a 3D rotate around the center of the view and the right-click + drag gesture pans the view.",
               "type": {
                 "text": "\"pan\" | \"rotate\"",
                 "values": [
@@ -38747,7 +38739,7 @@
           "customElement": true,
           "name": "ArcgisScene",
           "tagName": "arcgis-scene",
-          "description": "The ArcGIS Scene component is used to add 3D maps to web applications. For 2D maps, use the\n[ArcGIS Map component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/).\n\nThe Scene component creates a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html)\nand loads a [WebScene](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html) item from either\n[ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).\n\n```html\n<arcgis-scene item-id=\"e2da7564e4f24eaaa918ffd70378056a\"></arcgis-scene>\n```\n\nAlternatively, the Scene component can be initialized without a WebScene item:\n\n```html\n<arcgis-scene\n basemap=\"satellite\"\n ground=\"world-elevation\"\n camera-position=\"12.3808, 46.3959, 4400\"\n camera-tilt=\"75\"\n camera-heading=\"300\">\n</arcgis-scene>\n```\n\nFurther components can be added and connected to the Scene component:\n\n```html\n<arcgis-scene item-id=\"e2da7564e4f24eaaa918ffd70378056a\">\n  <arcgis-layer-list position=\"bottom-right\"></arcgis-layer-list>\n</arcgis-scene>\n```\n\nThe Scene component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/api-reference/)\nof the ArcGIS Maps SDK for JavaScript.\n\n```js\nconst viewElement = document.querySelector(\"arcgis-scene\");\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n  const layer = new GraphicsLayer({ title: \"My layer\"});\n  viewElement.map.add(layer);\n});\n```\n\nSee also:\n- [SDK sample apps using the Scene component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-scene)\n- [Getting started](https://developers.arcgis.com/javascript/latest/get-started-overview/)\n- [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)",
+          "description": "The ArcGIS Scene component is used to add 3D maps to web applications. For 2D maps, use the\n[ArcGIS Map component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/).\n\nThe Scene component creates a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html)\nand loads a [WebScene](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html) item from either\n[ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).\n\n```html\n<arcgis-scene item-id=\"e2da7564e4f24eaaa918ffd70378056a\"></arcgis-scene>\n```\n\nAlternatively, the Scene component can be initialized without a WebScene item:\n\n```html\n<arcgis-scene\n basemap=\"satellite\"\n ground=\"world-elevation\"\n camera-position=\"12.3808, 46.3959, 4400\"\n camera-tilt=\"75\"\n camera-heading=\"300\">\n</arcgis-scene>\n```\n\nFurther components can be added and connected to the Scene component:\n\n```html\n<arcgis-scene item-id=\"e2da7564e4f24eaaa918ffd70378056a\">\n  <arcgis-layer-list position=\"bottom-right\"></arcgis-layer-list>\n</arcgis-scene>\n```\n\nThe Scene component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/api-reference/)\nof the ArcGIS Maps SDK for JavaScript.\n\n```js\nconst viewElement = document.querySelector(\"arcgis-scene\");\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n  const layer = new GraphicsLayer({ title: \"My layer\"});\n  viewElement.map.add(layer);\n});\n```\n\n**See also**\n\n- [SDK sample apps using the Scene component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-scene)\n- [Getting started](https://developers.arcgis.com/javascript/latest/get-started-overview/)\n- [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)",
           "demos": [
             {
               "description": "Docs",
@@ -39168,7 +39160,7 @@
             {
               "kind": "field",
               "name": "camera",
-              "description": "The [camera](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html) allows to set the observation point from which the visible portion (or perspective)\nof the view is determined. When set in the constructor, this property overrides the\n[center](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#center),\n[extent](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#extent),\n[scale](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#scale),\n[viewpoint](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#viewpoint), and\n[zoom](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#zoom) properties.\n\nSetting the camera immediately changes the current view. For animating the view, see this component's\n[goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.",
+              "description": "The [camera](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html) allows to set the observation point from which the visible portion (or perspective)\nof the view is determined. When set in the constructor, this property overrides the [center](#center), [extent](#extent), [scale](#scale), [viewpoint](#viewpoint), and [zoom](#zoom) properties.\n\nSetting the camera immediately changes the current view. For animating the view, see this component's\n[goTo()](#goTo) method.",
               "type": {
                 "text": "Camera",
                 "references": [
@@ -39186,7 +39178,7 @@
             {
               "kind": "field",
               "name": "cameraFov",
-              "description": "The diagonal field of view (fov) angle for the camera. The range of angles must be between 1 and 170 degrees.\n\nSetting the camera fov immediately changes the current view. For animating the view, see this component's\n[goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#fov)",
+              "description": "The diagonal field of view (fov) angle for the camera. The range of angles must be between 1 and 170 degrees.\n\nSetting the camera fov immediately changes the current view. For animating the view, see this component's\n[goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#fov)",
               "type": {
                 "text": "number",
                 "values": [
@@ -39200,7 +39192,7 @@
             {
               "kind": "field",
               "name": "cameraHeading",
-              "description": "The compass heading of the camera in degrees.\n\nSetting the camera heading immediately changes the current view. For animating the view, see this component's\n[goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#heading)",
+              "description": "The compass heading of the camera in degrees.\n\nSetting the camera heading immediately changes the current view. For animating the view, see this component's\n[goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#heading)",
               "type": {
                 "text": "number",
                 "values": [
@@ -39214,7 +39206,7 @@
             {
               "kind": "field",
               "name": "cameraPosition",
-              "description": "The position of the camera defined by a map point. It can be a string with the format `\"<longitude>, <latitude>, <elevation>\"`\nor a [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance.\n\nSetting the camera position immediately changes the current view. For animating the view, see this component's\n[goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#position)",
+              "description": "The position of the camera defined by a map point. It can either be set with a\n[Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance\nor a string in the format: longitude, latitude, elevation. E.g. `\"12.3808, 46.3959, 4400\"`.\n\nSetting the camera position immediately changes the current view. For animating the view, see this component's\n[goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#position)",
               "type": {
                 "text": "Array<number> | Point | string",
                 "references": [
@@ -39251,7 +39243,7 @@
             {
               "kind": "field",
               "name": "cameraTilt",
-              "description": "The tilt of the camera in degrees with respect to the surface as projected down from the camera position.\n\nSetting the camera tilt immediately changes the current view. For animating the view, see this component's\n[goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#tilt)",
+              "description": "The tilt of the camera in degrees with respect to the surface as projected down from the camera position.\n\nSetting the camera tilt immediately changes the current view. For animating the view, see this component's\n[goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#tilt)",
               "type": {
                 "text": "number",
                 "values": [
@@ -39265,7 +39257,7 @@
             {
               "kind": "field",
               "name": "center",
-              "description": "Represents the center point of the view. It can be a string with the format `\"<longitude>, <latitude>\"`\nor a [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance.\n\nSetting the center immediately changes the current view. For animating the view, see this component's\n[goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#center)",
+              "description": "Represents the center point of the view. It can be a string with the format `\"<longitude>, <latitude>\"`\nor a [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance.\n\nSetting the center immediately changes the current view. For animating the view, see this component's\n[goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#center)",
               "type": {
                 "text": "Array<number> | Point | string",
                 "references": [
@@ -39305,7 +39297,7 @@
             {
               "kind": "field",
               "name": "clippingArea",
-              "description": "Represents an optional clipping area used to define the visible [extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html)\nof a [local scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#viewingMode).\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#clippingArea)",
+              "description": "Represents an optional clipping area used to define the visible [extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html)\nof a [local scene](#viewingMode).\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#clippingArea)",
               "type": {
                 "text": "Extent",
                 "references": [
@@ -39323,7 +39315,7 @@
             {
               "kind": "method",
               "name": "closePopup",
-              "description": "Closes the [popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#popup).",
+              "description": "Closes the [popup](#popup).",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -39392,7 +39384,7 @@
             {
               "kind": "method",
               "name": "destroy",
-              "description": "Destroys the Scene component, and any associated resources, including its\n[map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map),\n[popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#popup),\nand removes components or other UI DOM elements added to it.",
+              "description": "Destroys the Scene component, and any associated resources, including its [map](#map), [popup](#popup),\nand removes components or other UI DOM elements added to it.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -39445,7 +39437,7 @@
             {
               "kind": "field",
               "name": "extent",
-              "description": "The extent represents the visible portion of a map within the view as an instance of\n[Extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html).\n\nSetting the extent immediately changes the view without animation. To animate\nthe view, see this component's [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\nWhen the view is rotated, the extent does not update to include the newly visible portions of the map.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#extent)",
+              "description": "The extent represents the visible portion of a map within the view as an instance of\n[Extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html).\n\nSetting the extent immediately changes the view without animation. To animate\nthe view, see this component's [goTo()](#goTo) method.\nWhen the view is rotated, the extent does not update to include the newly visible portions of the map.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#extent)",
               "type": {
                 "text": "Extent",
                 "references": [
@@ -40061,7 +40053,7 @@
             {
               "kind": "field",
               "name": "qualityProfile",
-              "description": "SceneView can draw scenes in three different quality modes: `high`, `medium` and `low`.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#qualityProfile)",
+              "description": "Scenes can be drawn in three different quality modes: `high`, `medium` and `low`.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#qualityProfile)",
               "type": {
                 "text": "\"high\" | \"low\" | \"medium\"",
                 "values": [
@@ -40100,7 +40092,7 @@
             {
               "kind": "field",
               "name": "resolution",
-              "description": "Represents the current value of one pixel in the unit of the view's\n[spatialReference](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#spatialReference).\nThe resolution is calculated by dividing the view's [extent width](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html#width)\nby [its width](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#width).",
+              "description": "Represents the current value of one pixel in the unit of the view's\n[spatialReference](#spatialReference).\nThe resolution is calculated by dividing the view's [extent width](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html#width)\nby [its width](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#width).",
               "type": {
                 "text": "number",
                 "values": [
@@ -40114,7 +40106,7 @@
             {
               "kind": "field",
               "name": "scale",
-              "description": "Represents the map scale at the center of the view.\n\nSetting the scale immediately changes the view. For animating\nthe view, see this component's [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#scale)",
+              "description": "Represents the map scale at the center of the view.\n\nSetting the scale immediately changes the view. For animating\nthe view, see this component's [goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#scale)",
               "type": {
                 "text": "number",
                 "values": [
@@ -40235,7 +40227,7 @@
             {
               "kind": "field",
               "name": "theme",
-              "description": "This property specifies the base colors used by some widgets\nand components to render graphics and labels.\nThis only affects those elements that would otherwise use the default orange pattern.",
+              "description": "This property specifies the base colors used by some components to render graphics and labels.\nThis only affects those elements that would otherwise use the default orange pattern.",
               "type": {
                 "text": "Theme",
                 "references": [
@@ -40554,7 +40546,7 @@
             {
               "kind": "field",
               "name": "viewpoint",
-              "description": "Represents the current view as a [Viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-Viewpoint.html)\nor point of observation on the view.\n\nSetting the viewpoint immediately changes the current view. For animating\nthe view, see this component's [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#viewpoint)",
+              "description": "Represents the current view as a [Viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-Viewpoint.html)\nor point of observation on the view.\n\nSetting the viewpoint immediately changes the current view. For animating\nthe view, see this component's [goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#viewpoint)",
               "type": {
                 "text": "Viewpoint",
                 "references": [
@@ -40786,7 +40778,7 @@
             {
               "kind": "field",
               "name": "zoom",
-              "description": "Represents the level of detail (LOD) at the center of the view.\n\nSetting the zoom immediately changes the current view. For animating the view, see this component's [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\nSetting this property in conjunction with [center](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#center)\nis a convenient way to set the initial extent of the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#zoom)",
+              "description": "Represents the level of detail (LOD) at the center of the view.\n\nSetting the zoom immediately changes the current view. For animating the view, see this component's [goTo()](#goTo) method.\nSetting this property in conjunction with [center](#center)\nis a convenient way to set the initial extent of the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#zoom)",
               "type": {
                 "text": "number",
                 "values": [
@@ -40842,7 +40834,7 @@
             },
             {
               "name": "camera-fov",
-              "description": "The diagonal field of view (fov) angle for the camera. The range of angles must be between 1 and 170 degrees.\n\nSetting the camera fov immediately changes the current view. For animating the view, see this component's\n[goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#fov)",
+              "description": "The diagonal field of view (fov) angle for the camera. The range of angles must be between 1 and 170 degrees.\n\nSetting the camera fov immediately changes the current view. For animating the view, see this component's\n[goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#fov)",
               "type": {
                 "text": "number",
                 "values": [
@@ -40855,7 +40847,7 @@
             },
             {
               "name": "camera-heading",
-              "description": "The compass heading of the camera in degrees.\n\nSetting the camera heading immediately changes the current view. For animating the view, see this component's\n[goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#heading)",
+              "description": "The compass heading of the camera in degrees.\n\nSetting the camera heading immediately changes the current view. For animating the view, see this component's\n[goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#heading)",
               "type": {
                 "text": "number",
                 "values": [
@@ -40868,7 +40860,7 @@
             },
             {
               "name": "camera-position",
-              "description": "The position of the camera defined by a map point. It can be a string with the format `\"<longitude>, <latitude>, <elevation>\"`\nor a [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance.\n\nSetting the camera position immediately changes the current view. For animating the view, see this component's\n[goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#position)",
+              "description": "The position of the camera defined by a map point. It can either be set with a\n[Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance\nor a string in the format: longitude, latitude, elevation. E.g. `\"12.3808, 46.3959, 4400\"`.\n\nSetting the camera position immediately changes the current view. For animating the view, see this component's\n[goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#position)",
               "type": {
                 "text": "string",
                 "values": [
@@ -40881,7 +40873,7 @@
             },
             {
               "name": "camera-tilt",
-              "description": "The tilt of the camera in degrees with respect to the surface as projected down from the camera position.\n\nSetting the camera tilt immediately changes the current view. For animating the view, see this component's\n[goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#tilt)",
+              "description": "The tilt of the camera in degrees with respect to the surface as projected down from the camera position.\n\nSetting the camera tilt immediately changes the current view. For animating the view, see this component's\n[goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#tilt)",
               "type": {
                 "text": "number",
                 "values": [
@@ -40894,7 +40886,7 @@
             },
             {
               "name": "center",
-              "description": "Represents the center point of the view. It can be a string with the format `\"<longitude>, <latitude>\"`\nor a [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance.\n\nSetting the center immediately changes the current view. For animating the view, see this component's\n[goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#center)",
+              "description": "Represents the center point of the view. It can be a string with the format `\"<longitude>, <latitude>\"`\nor a [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance.\n\nSetting the center immediately changes the current view. For animating the view, see this component's\n[goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#center)",
               "type": {
                 "text": "string",
                 "values": [
@@ -40961,7 +40953,7 @@
             },
             {
               "name": "quality-profile",
-              "description": "SceneView can draw scenes in three different quality modes: `high`, `medium` and `low`.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#qualityProfile)",
+              "description": "Scenes can be drawn in three different quality modes: `high`, `medium` and `low`.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#qualityProfile)",
               "type": {
                 "text": "\"high\" | \"low\" | \"medium\"",
                 "values": [
@@ -40983,7 +40975,7 @@
             },
             {
               "name": "scale",
-              "description": "Represents the map scale at the center of the view.\n\nSetting the scale immediately changes the view. For animating\nthe view, see this component's [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#scale)",
+              "description": "Represents the map scale at the center of the view.\n\nSetting the scale immediately changes the view. For animating\nthe view, see this component's [goTo()](#goTo) method.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#scale)",
               "type": {
                 "text": "number",
                 "values": [
@@ -41029,7 +41021,7 @@
             },
             {
               "name": "zoom",
-              "description": "Represents the level of detail (LOD) at the center of the view.\n\nSetting the zoom immediately changes the current view. For animating the view, see this component's [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.\nSetting this property in conjunction with [center](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#center)\nis a convenient way to set the initial extent of the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#zoom)",
+              "description": "Represents the level of detail (LOD) at the center of the view.\n\nSetting the zoom immediately changes the current view. For animating the view, see this component's [goTo()](#goTo) method.\nSetting this property in conjunction with [center](#center)\nis a convenient way to set the initial extent of the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#zoom)",
               "type": {
                 "text": "number",
                 "values": [
@@ -41092,7 +41084,7 @@
             },
             {
               "name": "arcgisViewChange",
-              "description": "This event is for view related property changes:\n[zoom](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#zoom),\n[scale](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#scale),\n[center](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#center),\n[rotation](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#rotation),\n[extent](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#extent),\n[camera](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#camera),\n[viewpoint](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#viewpoint).\nThis event will also emit if [stationary](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#stationary)\ntoggles from `true` to `false`.",
+              "description": "This event is for view related property changes: [zoom](#zoom), [scale](#scale), [center](#center), [rotation](#rotation), [extent](#extent),\n[camera](#camera), [viewpoint](#viewpoint). This event will also emit if [stationary](#stationary) toggles from `true` to `false`.",
               "type": {
                 "text": "void"
               }
@@ -41385,7 +41377,7 @@
             },
             {
               "name": "arcgisViewReadyChange",
-              "description": "This event is for the [ready](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#ready)\nproperty and will be emitted when the view is ready.\nThis event will also emit if the [map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) property is changed.\n\n```js\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n   const layer = new GraphicsLayer({ title: \"My layer\"});\n   viewElement.map.add(layer);\n});\n```",
+              "description": "This event is for the [ready](#ready) property and will be emitted when the view is ready.\nThis event will also emit if the [map](#map) property is changed.\n\n```js\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n   const layer = new GraphicsLayer({ title: \"My layer\"});\n   viewElement.map.add(layer);\n});\n```",
               "type": {
                 "text": "void"
               }
@@ -42285,7 +42277,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#state)",
+              "description": "The current state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#state)",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\" | \"searching\"",
                 "values": [
@@ -42710,7 +42702,7 @@
             },
             {
               "name": "state",
-              "description": "The current state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#state)",
+              "description": "The current state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#state)",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\" | \"searching\"",
                 "values": [
@@ -43038,7 +43030,7 @@
           "customElement": true,
           "name": "ArcgisShadowCast",
           "tagName": "arcgis-shadow-cast",
-          "description": "The Shadow Cast component displays the cumulative shadows of 3D features in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).",
+          "description": "The Shadow Cast component displays the cumulative shadows of 3D features in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\n**Known limitations**\n\nShadow Cast is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.",
           "demos": [
             {
               "description": "Docs",
@@ -43158,7 +43150,7 @@
             {
               "kind": "field",
               "name": "discreteOptions",
-              "description": "The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to \"discrete\".\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#discreteOptions)",
+              "description": "The configuration used when the component's [visualizationType](#visualizationType)\nis set to \"discrete\".",
               "type": {
                 "text": "DiscreteOptions",
                 "references": [
@@ -43176,7 +43168,7 @@
             {
               "kind": "field",
               "name": "durationOptions",
-              "description": "The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to \"duration\".\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#durationOptions)",
+              "description": "The configuration used when the component's [visualizationType](#visualizationType)\nis set to \"duration\".",
               "type": {
                 "text": "DurationOptions",
                 "references": [
@@ -43402,7 +43394,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).\n\nSee also: [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)",
               "type": {
                 "text": "string",
                 "values": [
@@ -43412,18 +43404,12 @@
                 ]
               },
               "default": "\"measure-building-height-shadow\"",
-              "attribute": "icon",
-              "docsTags": [
-                {
-                  "name": "see",
-                  "text": "[Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)"
-                }
-              ]
+              "attribute": "icon"
             },
             {
               "kind": "field",
               "name": "label",
-              "description": "The widget's default label.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html#label)",
+              "description": "The component's default label.",
               "type": {
                 "text": "string",
                 "values": [
@@ -43571,7 +43557,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the view model that can be used for rendering the UI\nof the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#state)",
+              "description": "The component's state. The values mean the following:\n\n* `disabled` -  component is being created\n* `ready` - component is ready",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -43614,7 +43600,7 @@
             {
               "kind": "field",
               "name": "thresholdOptions",
-              "description": "The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to \"threshold\".\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#thresholdOptions)",
+              "description": "The configuration used when the component's [visualizationType](#visualizationType)\nis set to \"threshold\".",
               "type": {
                 "text": "ThresholdOptions",
                 "references": [
@@ -43632,7 +43618,7 @@
             {
               "kind": "field",
               "name": "utcOffset",
-              "description": "The difference in hours between UTC time and the times displayed in the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#utcOffset)",
+              "description": "The difference in hours between UTC time and the times displayed in the component.",
               "type": {
                 "text": "number",
                 "values": [
@@ -43858,7 +43844,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).\n\nSee also: [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)",
               "type": {
                 "text": "string",
                 "values": [
@@ -43872,7 +43858,7 @@
             },
             {
               "name": "label",
-              "description": "The widget's default label.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html#label)",
+              "description": "The component's default label.",
               "type": {
                 "text": "string",
                 "values": [
@@ -43958,7 +43944,7 @@
             },
             {
               "name": "state",
-              "description": "The current state of the view model that can be used for rendering the UI\nof the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#state)",
+              "description": "The component's state. The values mean the following:\n\n* `disabled` -  component is being created\n* `ready` - component is ready",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -43977,7 +43963,7 @@
             },
             {
               "name": "utc-offset",
-              "description": "The difference in hours between UTC time and the times displayed in the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#utcOffset)",
+              "description": "The difference in hours between UTC time and the times displayed in the component.",
               "type": {
                 "text": "number",
                 "values": [
@@ -46038,7 +46024,7 @@
           "customElement": true,
           "name": "ArcgisSlice",
           "tagName": "arcgis-slice",
-          "description": "The Slice component is a 3D analysis tool that can be used to reveal occluded content in a 3D view. It applies\n[slice analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)\nto any layer type, making it possible to see inside buildings or to explore geological surfaces.\n\nThe slicing [shape](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#shape)\nis always a [plane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html).\nBy default, the plane is either horizontal or vertical. To allow a tilt angle for the plane, set\n[tiltEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#tiltEnabled)\nto `true`. The slice hides any content in front of the surface. The handles on the sides of the plane can be used to adjust\nthe size, heading, tilt, and position of the slice plane.\nThe [SlicePlane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html)\ncan be set or retrieved using the [shape](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#shape) property.\n\nOnce the slice plane is applied, layers can be excluded from the slicing. For example, by excluding the sublayers which include\ncolumns and floor slabs, the inner structure of a building can investigated.",
+          "description": "The Slice component is a 3D analysis tool that can be used to reveal occluded content in a\n[Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/). It applies\n[slice analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)\nto any layer type, making it possible to see inside buildings or to explore geological surfaces.\n\n[![slice](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/slice.gif)](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-slice/index.html)\n\nThe slicing [shape](#shape)\nis always a [plane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html).\nBy default, the plane is either horizontal or vertical. To allow a tilt angle for the plane, set\n[tiltEnabled](#tiltEnabled)\nto `true`. The slice hides any content in front of the surface. The handles on the sides of the plane can be used to adjust\nthe size, heading, tilt, and position of the slice plane.\nThe [SlicePlane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html)\ncan be set or retrieved using the [shape](#shape) property.\n\nOnce the slice plane is applied, layers can be excluded from the slicing. For example, by excluding the sublayers which include\ncolumns and floor slabs, the inner structure of a building can investigated.\n\n[![slice-exclude](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/slice-exclude.png)](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-slice/index.html)\n\nWhen interactively creating a new slice, the Shift key can be held to force the slice to be applied vertically.\n\n**Known limitations**\n\nSlice is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n\n**See also**\n\n- [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)\n- [Sample - BuildingSceneLayer with Slice component](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-slice/)\n- [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)",
           "demos": [
             {
               "description": "Docs",
@@ -46060,7 +46046,7 @@
             {
               "kind": "field",
               "name": "analysis",
-              "description": "The [slice analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)\nobject being created by the component.",
+              "description": "The [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)\ncreated or modified by the component.\n\nIf no programmatically created analysis is provided, the component automatically creates an empty analysis on its own and adds it to the view.\nIn this case, the analysis will also be automatically removed from the view when the component is destroyed.\n\n\n```js\n// Create the analysis.\nconst sliceAnalysis = new SliceAnalysis({\n   shape: new SlicePlane({\n     position: new Point({\n       spatialReference: { latestWkid: 3857, wkid: 102100 },\n       x: -13624925.727820931,\n       y: 4550341.695170021,\n       z: 56\n     }),\n     tilt: 270,\n     width: 310,\n     height: 190,\n     heading: 45\n   })\n});\n// Get the Scene and measurement component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst slice = document.querySelector(\"arcgis-slice\");\nawait slice.componentOnReady();\n// Add the analysis to the view component.\nviewElement.analyses.add(sliceAnalysis);\n// Connect the analysis to the slice component:\nslice.analysis = sliceAnalysis;\n```",
               "type": {
                 "text": "SliceAnalysis",
                 "references": [
@@ -46093,7 +46079,7 @@
             {
               "kind": "method",
               "name": "clear",
-              "description": "Clear the [shape](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#shape) of the slice,\neffectively removing it from the view. Other properties like [excludedLayers](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#excludedLayers)\nand [excludeGroundSurface](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#excludeGroundSurface) are not modified.",
+              "description": "Clear the [shape](#shape) of the slice, effectively removing it from the view. Other properties like [excludedLayers](#excludedLayers)\nand [excludeGroundSurface](#excludeGroundSurface) are not modified.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -46393,7 +46379,7 @@
             {
               "kind": "field",
               "name": "shape",
-              "description": "The shape used to slice elements in a 3D scene. Currently the only supported shape is a plane.",
+              "description": "The shape used to slice elements in a 3D scene. Currently the only supported shape is a\n[plane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html).",
               "type": {
                 "text": "SlicePlane",
                 "references": [
@@ -46417,7 +46403,7 @@
             {
               "kind": "method",
               "name": "start",
-              "description": "Start the interactive creation of a new slice, clearing the previous\n[shape](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#shape).",
+              "description": "Start the interactive creation of a new slice, clearing the previous [shape](#shape).",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -56634,7 +56620,7 @@
           "customElement": true,
           "name": "ArcgisWeather",
           "tagName": "arcgis-weather",
-          "description": "The Weather component provides an interface for easily selecting and configuring the weather effects in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).",
+          "description": "The Weather component provides an interface for easily selecting and configuring the weather effects in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\n**Known limitations**\n\nWeather is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.",
           "demos": [
             {
               "description": "Docs",