@arcgis/map-components 5.0.0-next.12 → 5.0.0-next.14

package/dist/docs/vscode.html-custom-data.json

@@ -1592,7 +1592,7 @@
         },
         {
           "name": "date-or-season",
-          "description": "Controls whether the component displays a date or a season picker.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#dateOrSeason)",
+          "description": "Controls whether the component displays a date or a season picker. When the date picker is set, the user selects the date from a calendar. The season picker allows the user to choose a season from a drop-down list. Each season uses a fixed date corresponding to the equinoxes and solstices of 2014.",
           "values": [
             {
               "name": "date"
@@ -1609,6 +1609,7 @@
         },
         {
           "name": "direct-shadows-disabled",
+          "description": "Indicates whether to hide shadows cast by the sun.\n\n**See also**\n\n- [SunLighting.directShadowsEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html#directShadowsEnabled)\n- [Scene's `environment`](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)",
           "values": []
         },
         {
@@ -1671,7 +1672,7 @@
         },
         {
           "name": "local-date",
-          "description": "The calendar date in the timezone given by [utcOffset](#utcOffset).\n\nThis property should only be set once the widget and the view are initialized, for example,\nfrom within an event handler. To initialize the view with a specific date and time, set a\n[SunLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html) on the [SceneView.environment](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#environment).",
+          "description": "The calendar date in the timezone given by [utcOffset](#utcOffset).",
           "values": []
         },
         {
@@ -1733,22 +1734,22 @@
         },
         {
           "name": "sunlighting-disabled",
-          "description": "Indicates whether date and time are used to determine position of the light source.\nWhen `false`, the light source is positioned relative to the camera, using [VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html).",
+          "description": "Indicates whether date and time are used to determine position of the light source.\nWhen set, the light source is positioned relative to the camera, using [VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html).",
           "values": []
         },
         {
           "name": "time-slider-position",
-          "description": "Slider position for the time of day in the timezone\ngiven by [utcOffset](#utcOffset). The position represents the time\nof the day in minutes. Possible values range between 0 and 1440.\n\nThis property should only be set once the widget and the view are initialized, for example,\nfrom within an event handler. To initialize the view with a specific date and time, set a\n[SunLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html) on the [SceneView.environment](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#environment).",
+          "description": "Slider position for the time of day in the timezone\ngiven by [utcOffset](#utcOffset). The position represents the time\nof the day in minutes. Possible values range between 0 and 1440.",
           "values": []
         },
         {
           "name": "time-slider-steps",
-          "description": "Sets steps, or intervals, on the time slider to restrict the times of the day that can be selected when dragging the thumb.\nSets steps, or intervals, on the time slider to restrict the times of the day that can be selected when dragging the thumb. All values are in minutes, where 0 is midnight and 23 * 60 + 59 is just before midnight the following day.\n\nIf an array of numbers is passed to this property, the slider thumbs may only be moved to the times specified in the array.\n\nIf a single number is set, then steps are set for the entire day at an interval of timeSliderSteps minutes. For example, if a value of 60 is set here, dragging the slider will allow selecting each of 24 hours of the day.",
+          "description": "Sets the interval, in minutes, with which the time slider increments or decrements as it is dragged or changed via the keyboard.\n\nFor example, if set to 60, the slider will allow selecting each hour of the day.",
           "values": []
         },
         {
           "name": "utc-offset",
-          "description": "The difference in hours between UTC time and the time displayed in the widget.",
+          "description": "The difference in hours between UTC time and the time displayed in the component.",
           "values": []
         },
         {
@@ -2192,134 +2193,6 @@
         }
       ]
     },
-    {
-      "name": "arcgis-directline-measurement-3d",
-      "description": "**Deprecated**. 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.\n--\n\n### Events\n- **arcgisPropertyChange** - Emitted when the value of a property is changed. Use this to listen to changes to properties.\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n\n### Methods\n- `clear(): Promise<void>` - Clears the current measurement.\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.\n- `start(): Promise<void>` - Starts a new measurement.",
-      "attributes": [
-        {
-          "name": "auto-destroy-disabled",
-          "description": "If true, the component will not be destroyed automatically when it is\ndisconnected from the document. This is useful when you want to move the\ncomponent to a different place on the page, or temporarily hide it. If this\nis set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-direct-line-measurement-3d/#destroy) method when you are done to\nprevent memory leaks.",
-          "values": []
-        },
-        {
-          "name": "icon",
-          "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
-          "values": []
-        },
-        {
-          "name": "label",
-          "description": "The component's default label.",
-          "values": []
-        },
-        {
-          "name": "position",
-          "description": "**Deprecated**: since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead.. ",
-          "values": [
-            {
-              "name": "bottom-leading"
-            },
-            {
-              "name": "bottom-left"
-            },
-            {
-              "name": "bottom-right"
-            },
-            {
-              "name": "bottom-trailing"
-            },
-            {
-              "name": "manual"
-            },
-            {
-              "name": "top-leading"
-            },
-            {
-              "name": "top-left"
-            },
-            {
-              "name": "top-right"
-            },
-            {
-              "name": "top-trailing"
-            }
-          ]
-        },
-        {
-          "name": "reference-element",
-          "description": "By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.",
-          "values": []
-        },
-        {
-          "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",
-          "values": [
-            {
-              "name": "disabled"
-            },
-            {
-              "name": "measured"
-            },
-            {
-              "name": "measuring"
-            },
-            {
-              "name": "ready"
-            }
-          ]
-        },
-        {
-          "name": "unit",
-          "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values. Possible values are listed in\n[unitOptions](#unitOptions).",
-          "values": [
-            {
-              "name": "centimeters"
-            },
-            {
-              "name": "decimeters"
-            },
-            {
-              "name": "feet"
-            },
-            {
-              "name": "imperial"
-            },
-            {
-              "name": "inches"
-            },
-            {
-              "name": "kilometers"
-            },
-            {
-              "name": "meters"
-            },
-            {
-              "name": "metric"
-            },
-            {
-              "name": "miles"
-            },
-            {
-              "name": "millimeters"
-            },
-            {
-              "name": "nautical-miles"
-            },
-            {
-              "name": "us-feet"
-            },
-            {
-              "name": "yards"
-            }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-directline-measurement-3d/"
-        }
-      ]
-    },
     {
       "name": "arcgis-distance-measurement-2d",
       "description": "The Distance Measurement 2D component calculates and displays the distance between two or more points in a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html).\n--\n\n### Events\n- **arcgisPropertyChange** - Emitted when the value of a property is changed. Use this to listen to changes to properties.\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n\n### Methods\n- `clear(): Promise<void>` - Clear the current measurement.\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.\n- `start(): Promise<void>` - Starts a new measurement.",
@@ -2578,6 +2451,9 @@
             {
               "name": "awaiting-update-feature-candidate"
             },
+            {
+              "name": "choosing-key-feature"
+            },
             {
               "name": "creating-features"
             },
@@ -3107,7 +2983,7 @@
         },
         {
           "name": "mode",
-          "description": "The mode in which the component displays. These modes are listed below.\n\n| mode         | description |\n|--------------|-------------|\n| auto         | This is the default mode. It is responsive to browser size changes and will update based on whether the component is viewed in a desktop or mobile application. |\n| floating     | Use this mode if you wish to always display the component as floating regardless of browser size. |\n| drawer       | Use this mode if you wish to always display the component in a panel regardless of browser size. |",
+          "description": "The mode in which the component displays. These modes are listed below:\n\n- `auto`: This is the default mode. It is responsive to browser size changes and will update based on whether the component is viewed in a desktop or mobile application.\n- `floating`: Use this mode if you wish to always display the component as floating in a [Calcite Popover component](https://developers.arcgis.com/calcite-design-system/components/popover/) regardless of browser size.\n- `drawer`: Use this mode if you wish to always display the component in a [Calcite Sheet component](https://developers.arcgis.com/calcite-design-system/components/sheet/) regardless of browser size.",
           "values": [
             {
               "name": "auto"
@@ -3122,7 +2998,7 @@
         },
         {
           "name": "placement",
-          "description": "The placement used by the [calcite popover](https://developers.arcgis.com/calcite-design-system/components/popover/) when the component is expanded.\nThis property has no effect when the component is in `drawer` mode.",
+          "description": "The placement used by the [Calcite Popover](https://developers.arcgis.com/calcite-design-system/components/popover/) when the component is expanded.\nThis property has no effect when the component is in `drawer` mode.",
           "values": [
             {
               "name": "auto"

package/dist/docs/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@arcgis/map-components",
-  "version": "5.0.0-next.12",
+  "version": "5.0.0-next.14",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -2866,7 +2866,7 @@
             },
             {
               "name": "date-or-season",
-              "description": "Controls whether the component displays a date or a season picker.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#dateOrSeason)",
+              "description": "Controls whether the component displays a date or a season picker. When the date picker is set, the user selects the date from a calendar. The season picker allows the user to choose a season from a drop-down list. Each season uses a fixed date corresponding to the equinoxes and solstices of 2014.",
               "default": "\"date\"",
               "value": {
                 "type": [
@@ -2885,6 +2885,7 @@
             },
             {
               "name": "direct-shadows-disabled",
+              "description": "Indicates whether to hide shadows cast by the sun.\n\n**See also**\n\n- [SunLighting.directShadowsEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html#directShadowsEnabled)\n- [Scene's `environment`](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -2964,7 +2965,7 @@
             },
             {
               "name": "local-date",
-              "description": "The calendar date in the timezone given by [utcOffset](#utcOffset).\n\nThis property should only be set once the widget and the view are initialized, for example,\nfrom within an event handler. To initialize the view with a specific date and time, set a\n[SunLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html) on the [SceneView.environment](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#environment).",
+              "description": "The calendar date in the timezone given by [utcOffset](#utcOffset).",
               "value": {
                 "type": [
                   "number",
@@ -3016,7 +3017,7 @@
             },
             {
               "name": "sunlighting-disabled",
-              "description": "Indicates whether date and time are used to determine position of the light source.\nWhen `false`, the light source is positioned relative to the camera, using [VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html).",
+              "description": "Indicates whether date and time are used to determine position of the light source.\nWhen set, the light source is positioned relative to the camera, using [VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html).",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -3024,14 +3025,14 @@
             },
             {
               "name": "time-slider-position",
-              "description": "Slider position for the time of day in the timezone\ngiven by [utcOffset](#utcOffset). The position represents the time\nof the day in minutes. Possible values range between 0 and 1440.\n\nThis property should only be set once the widget and the view are initialized, for example,\nfrom within an event handler. To initialize the view with a specific date and time, set a\n[SunLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html) on the [SceneView.environment](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#environment).",
+              "description": "Slider position for the time of day in the timezone\ngiven by [utcOffset](#utcOffset). The position represents the time\nof the day in minutes. Possible values range between 0 and 1440.",
               "value": {
                 "type": "number"
               }
             },
             {
               "name": "time-slider-steps",
-              "description": "Sets steps, or intervals, on the time slider to restrict the times of the day that can be selected when dragging the thumb.\nSets steps, or intervals, on the time slider to restrict the times of the day that can be selected when dragging the thumb. All values are in minutes, where 0 is midnight and 23 * 60 + 59 is just before midnight the following day.\n\nIf an array of numbers is passed to this property, the slider thumbs may only be moved to the times specified in the array.\n\nIf a single number is set, then steps are set for the entire day at an interval of timeSliderSteps minutes. For example, if a value of 60 is set here, dragging the slider will allow selecting each of 24 hours of the day.",
+              "description": "Sets the interval, in minutes, with which the time slider increments or decrements as it is dragged or changed via the keyboard.\n\nFor example, if set to 60, the slider will allow selecting each hour of the day.",
               "default": "5",
               "value": {
                 "type": "number"
@@ -3039,7 +3040,7 @@
             },
             {
               "name": "utc-offset",
-              "description": "The difference in hours between UTC time and the time displayed in the widget.",
+              "description": "The difference in hours between UTC time and the time displayed in the component.",
               "value": {
                 "type": "number"
               }
@@ -3079,7 +3080,7 @@
               },
               {
                 "name": "dateOrSeason",
-                "description": "Controls whether the component displays a date or a season picker.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#dateOrSeason)",
+                "description": "Controls whether the component displays a date or a season picker. When the date picker is set, the user selects the date from a calendar. The season picker allows the user to choose a season from a drop-down list. Each season uses a fixed date corresponding to the equinoxes and solstices of 2014.",
                 "type": "\"date\" | \"season\""
               },
               {
@@ -3089,6 +3090,7 @@
               },
               {
                 "name": "directShadowsDisabled",
+                "description": "Indicates whether to hide shadows cast by the sun.\n\n**See also**\n\n- [SunLighting.directShadowsEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html#directShadowsEnabled)\n- [Scene's `environment`](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)",
                 "type": "boolean"
               },
               {
@@ -3130,13 +3132,9 @@
                 "description": "The component's default label.",
                 "type": "string"
               },
-              {
-                "name": "lighting",
-                "type": "SunLighting | VirtualLighting"
-              },
               {
                 "name": "localDate",
-                "description": "The calendar date in the timezone given by [utcOffset](#utcOffset).\n\nThis property should only be set once the widget and the view are initialized, for example,\nfrom within an event handler. To initialize the view with a specific date and time, set a\n[SunLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html) on the [SceneView.environment](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#environment).",
+                "description": "The calendar date in the timezone given by [utcOffset](#utcOffset).",
                 "type": "Date | number | string"
               },
               {
@@ -3159,7 +3157,7 @@
               },
               {
                 "name": "sunlightingDisabled",
-                "description": "Indicates whether date and time are used to determine position of the light source.\nWhen `false`, the light source is positioned relative to the camera, using [VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html).",
+                "description": "Indicates whether date and time are used to determine position of the light source.\nWhen set, the light source is positioned relative to the camera, using [VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html).",
                 "type": "boolean"
               },
               {
@@ -3168,17 +3166,17 @@
               },
               {
                 "name": "timeSliderPosition",
-                "description": "Slider position for the time of day in the timezone\ngiven by [utcOffset](#utcOffset). The position represents the time\nof the day in minutes. Possible values range between 0 and 1440.\n\nThis property should only be set once the widget and the view are initialized, for example,\nfrom within an event handler. To initialize the view with a specific date and time, set a\n[SunLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html) on the [SceneView.environment](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#environment).",
+                "description": "Slider position for the time of day in the timezone\ngiven by [utcOffset](#utcOffset). The position represents the time\nof the day in minutes. Possible values range between 0 and 1440.",
                 "type": "number"
               },
               {
                 "name": "timeSliderSteps",
-                "description": "Sets steps, or intervals, on the time slider to restrict the times of the day that can be selected when dragging the thumb.\nSets steps, or intervals, on the time slider to restrict the times of the day that can be selected when dragging the thumb. All values are in minutes, where 0 is midnight and 23 * 60 + 59 is just before midnight the following day.\n\nIf an array of numbers is passed to this property, the slider thumbs may only be moved to the times specified in the array.\n\nIf a single number is set, then steps are set for the entire day at an interval of timeSliderSteps minutes. For example, if a value of 60 is set here, dragging the slider will allow selecting each of 24 hours of the day.",
+                "description": "Sets the interval, in minutes, with which the time slider increments or decrements as it is dragged or changed via the keyboard.\n\nFor example, if set to 60, the slider will allow selecting each hour of the day.",
                 "type": "number"
               },
               {
                 "name": "utcOffset",
-                "description": "The difference in hours between UTC time and the time displayed in the widget.",
+                "description": "The difference in hours between UTC time and the time displayed in the component.",
                 "type": "number"
               },
               {
@@ -3839,170 +3837,6 @@
             ]
           }
         },
-        {
-          "name": "arcgis-directline-measurement-3d",
-          "description": "**Deprecated**. 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.\n--\n\n### Events\n- **arcgisPropertyChange** - Emitted when the value of a property is changed. Use this to listen to changes to properties.\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n\n### Methods\n- `clear(): Promise<void>` - Clears the current measurement.\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.\n- `start(): Promise<void>` - Starts a new measurement.",
-          "doc-url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-directline-measurement-3d/",
-          "attributes": [
-            {
-              "name": "auto-destroy-disabled",
-              "description": "If true, the component will not be destroyed automatically when it is\ndisconnected from the document. This is useful when you want to move the\ncomponent to a different place on the page, or temporarily hide it. If this\nis set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-direct-line-measurement-3d/#destroy) method when you are done to\nprevent memory leaks.",
-              "default": "false",
-              "value": {
-                "type": "boolean"
-              }
-            },
-            {
-              "name": "icon",
-              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
-              "default": "\"measure-line\"",
-              "value": {
-                "type": "string"
-              }
-            },
-            {
-              "name": "label",
-              "description": "The component's default label.",
-              "value": {
-                "type": "string"
-              }
-            },
-            {
-              "name": "position",
-              "description": "**Deprecated**: since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead.. ",
-              "value": {
-                "type": [
-                  "\"bottom-leading\"",
-                  "\"bottom-left\"",
-                  "\"bottom-right\"",
-                  "\"bottom-trailing\"",
-                  "\"manual\"",
-                  "\"top-leading\"",
-                  "\"top-left\"",
-                  "\"top-right\"",
-                  "\"top-trailing\""
-                ]
-              }
-            },
-            {
-              "name": "reference-element",
-              "description": "By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.",
-              "value": {
-                "type": "string"
-              }
-            },
-            {
-              "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",
-              "value": {
-                "type": [
-                  "\"disabled\"",
-                  "\"measured\"",
-                  "\"measuring\"",
-                  "\"ready\""
-                ]
-              }
-            },
-            {
-              "name": "unit",
-              "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values. Possible values are listed in\n[unitOptions](#unitOptions).",
-              "value": {
-                "type": [
-                  "\"centimeters\"",
-                  "\"decimeters\"",
-                  "\"feet\"",
-                  "\"imperial\"",
-                  "\"inches\"",
-                  "\"kilometers\"",
-                  "\"meters\"",
-                  "\"metric\"",
-                  "\"miles\"",
-                  "\"millimeters\"",
-                  "\"nautical-miles\"",
-                  "\"us-feet\"",
-                  "\"yards\""
-                ]
-              }
-            }
-          ],
-          "events": [
-            {
-              "name": "arcgisPropertyChange",
-              "type": "{ name: \"state\" | \"analysis\"; }",
-              "description": "Emitted when the value of a property is changed. Use this to listen to changes to properties."
-            },
-            {
-              "name": "arcgisReady",
-              "type": "void",
-              "description": "Emitted when the component associated with a map or scene view is ready to be interacted with."
-            }
-          ],
-          "js": {
-            "properties": [
-              {
-                "name": "analysis",
-                "description": "The [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)\ncreated or modified by the component.\n\nWhen connecting the Direct Line Measurement 3D component to the [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)\ncomponent, it automatically creates an empty analysis and adds it to the Scene's\n[analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#analyses) collection.\nWhenever the component is destroyed, the analysis is automatically removed from the collection.\n\nAlternatively, a programmatically created analysis can be provided to the component.\nThen, the application itself needs to add it to and later remove it from the Scene's analyses collection.\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 Scene component.\nviewElement.analyses.add(directLineAnalysis);\n// Connect the analysis to the measurement component:\ndirectLineMeasurement3d.analysis = directLineAnalysis;\n```",
-                "type": "DirectLineMeasurementAnalysis"
-              },
-              {
-                "name": "autoDestroyDisabled",
-                "description": "If true, the component will not be destroyed automatically when it is\ndisconnected from the document. This is useful when you want to move the\ncomponent to a different place on the page, or temporarily hide it. If this\nis set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-direct-line-measurement-3d/#destroy) method when you are done to\nprevent memory leaks.",
-                "type": "boolean"
-              },
-              {
-                "name": "icon",
-                "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
-                "type": "string"
-              },
-              {
-                "name": "label",
-                "description": "The component's default label.",
-                "type": "string"
-              },
-              {
-                "name": "position",
-                "type": "\"bottom-leading\" | \"bottom-left\" | \"bottom-right\" | \"bottom-trailing\" | \"manual\" | \"top-leading\" | \"top-left\" | \"top-right\" | \"top-trailing\""
-              },
-              {
-                "name": "referenceElement",
-                "description": "By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.",
-                "type": "HTMLArcgisLinkChartElement | HTMLArcgisMapElement | HTMLArcgisSceneElement | string"
-              },
-              {
-                "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": "\"disabled\" | \"measured\" | \"measuring\" | \"ready\""
-              },
-              {
-                "name": "unit",
-                "description": "Unit system (imperial, metric) or specific unit used for displaying the distance values. Possible values are listed in\n[unitOptions](#unitOptions).",
-                "type": "\"centimeters\" | \"decimeters\" | \"feet\" | \"imperial\" | \"inches\" | \"kilometers\" | \"meters\" | \"metric\" | \"miles\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\""
-              },
-              {
-                "name": "unitOptions",
-                "description": "List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.\nBy default, the following units are included: `metric`, `imperial`, `inches`, `feet`, `us-feet`, `yards`, `miles`, `nautical-miles`, `meters`, `kilometers`.\nPossible [unit](#unit) values can only be a subset of this list.",
-                "type": "Array<\"imperial\" | \"metric\" | \"meters\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\">"
-              },
-              {
-                "name": "view",
-                "description": "The view associated with the component. \n  > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the ArcgisDirectLineMeasurement3d component will be associated with a map or scene component rather than using the `view` property.",
-                "type": "SceneView"
-              }
-            ],
-            "events": [
-              {
-                "name": "arcgisPropertyChange",
-                "type": "{ name: \"state\" | \"analysis\"; }",
-                "description": "Emitted when the value of a property is changed. Use this to listen to changes to properties."
-              },
-              {
-                "name": "arcgisReady",
-                "type": "void",
-                "description": "Emitted when the component associated with a map or scene view is ready to be interacted with."
-              }
-            ]
-          }
-        },
         {
           "name": "arcgis-distance-measurement-2d",
           "description": "The Distance Measurement 2D component calculates and displays the distance between two or more points in a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html).\n--\n\n### Events\n- **arcgisPropertyChange** - Emitted when the value of a property is changed. Use this to listen to changes to properties.\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n\n### Methods\n- `clear(): Promise<void>` - Clear the current measurement.\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.\n- `start(): Promise<void>` - Starts a new measurement.",
@@ -4304,6 +4138,7 @@
                   "\"awaiting-feature-to-create\"",
                   "\"awaiting-feature-to-update\"",
                   "\"awaiting-update-feature-candidate\"",
+                  "\"choosing-key-feature\"",
                   "\"creating-features\"",
                   "\"disabled\"",
                   "\"drawing-splitter-geometry\"",
@@ -4430,7 +4265,7 @@
               {
                 "name": "state",
                 "description": "The current state of the component.",
-                "type": "\"add-association-create-association\" | \"add-association-select-feature\" | \"add-association-select-layer\" | \"adding-attachment\" | \"awaiting-feature-creation-info\" | \"awaiting-feature-to-create\" | \"awaiting-feature-to-update\" | \"awaiting-update-feature-candidate\" | \"creating-features\" | \"disabled\" | \"drawing-splitter-geometry\" | \"editing-attachment\" | \"editing-attributes\" | \"editing-existing-feature\" | \"editing-features\" | \"ready\" | \"reviewing-features\" | \"viewing-selection-list\""
+                "type": "\"add-association-create-association\" | \"add-association-select-feature\" | \"add-association-select-layer\" | \"adding-attachment\" | \"awaiting-feature-creation-info\" | \"awaiting-feature-to-create\" | \"awaiting-feature-to-update\" | \"awaiting-update-feature-candidate\" | \"choosing-key-feature\" | \"creating-features\" | \"disabled\" | \"drawing-splitter-geometry\" | \"editing-attachment\" | \"editing-attributes\" | \"editing-existing-feature\" | \"editing-features\" | \"ready\" | \"reviewing-features\" | \"viewing-selection-list\""
               },
               {
                 "name": "supportingWidgetDefaults",
@@ -5240,7 +5075,7 @@
             },
             {
               "name": "mode",
-              "description": "The mode in which the component displays. These modes are listed below.\n\n| mode         | description |\n|--------------|-------------|\n| auto         | This is the default mode. It is responsive to browser size changes and will update based on whether the component is viewed in a desktop or mobile application. |\n| floating     | Use this mode if you wish to always display the component as floating regardless of browser size. |\n| drawer       | Use this mode if you wish to always display the component in a panel regardless of browser size. |",
+              "description": "The mode in which the component displays. These modes are listed below:\n\n- `auto`: This is the default mode. It is responsive to browser size changes and will update based on whether the component is viewed in a desktop or mobile application.\n- `floating`: Use this mode if you wish to always display the component as floating in a [Calcite Popover component](https://developers.arcgis.com/calcite-design-system/components/popover/) regardless of browser size.\n- `drawer`: Use this mode if you wish to always display the component in a [Calcite Sheet component](https://developers.arcgis.com/calcite-design-system/components/sheet/) regardless of browser size.",
               "default": "\"auto\"",
               "value": {
                 "type": [
@@ -5252,7 +5087,7 @@
             },
             {
               "name": "placement",
-              "description": "The placement used by the [calcite popover](https://developers.arcgis.com/calcite-design-system/components/popover/) when the component is expanded.\nThis property has no effect when the component is in `drawer` mode.",
+              "description": "The placement used by the [Calcite Popover](https://developers.arcgis.com/calcite-design-system/components/popover/) when the component is expanded.\nThis property has no effect when the component is in `drawer` mode.",
               "value": {
                 "type": [
                   "\"auto\"",
@@ -5401,12 +5236,12 @@
               },
               {
                 "name": "mode",
-                "description": "The mode in which the component displays. These modes are listed below.\n\n| mode         | description |\n|--------------|-------------|\n| auto         | This is the default mode. It is responsive to browser size changes and will update based on whether the component is viewed in a desktop or mobile application. |\n| floating     | Use this mode if you wish to always display the component as floating regardless of browser size. |\n| drawer       | Use this mode if you wish to always display the component in a panel regardless of browser size. |",
+                "description": "The mode in which the component displays. These modes are listed below:\n\n- `auto`: This is the default mode. It is responsive to browser size changes and will update based on whether the component is viewed in a desktop or mobile application.\n- `floating`: Use this mode if you wish to always display the component as floating in a [Calcite Popover component](https://developers.arcgis.com/calcite-design-system/components/popover/) regardless of browser size.\n- `drawer`: Use this mode if you wish to always display the component in a [Calcite Sheet component](https://developers.arcgis.com/calcite-design-system/components/sheet/) regardless of browser size.",
                 "type": "\"auto\" | \"drawer\" | \"floating\""
               },
               {
                 "name": "placement",
-                "description": "The placement used by the [calcite popover](https://developers.arcgis.com/calcite-design-system/components/popover/) when the component is expanded.\nThis property has no effect when the component is in `drawer` mode.",
+                "description": "The placement used by the [Calcite Popover](https://developers.arcgis.com/calcite-design-system/components/popover/) when the component is expanded.\nThis property has no effect when the component is in `drawer` mode.",
                 "type": "\"auto\" | \"auto-end\" | \"auto-start\" | \"bottom\" | \"bottom-end\" | \"bottom-start\" | \"leading\" | \"leading-end\" | \"leading-start\" | \"left\" | \"left-end\" | \"left-start\" | \"right\" | \"right-end\" | \"right-start\" | \"top\" | \"top-end\" | \"top-start\" | \"trailing\" | \"trailing-end\" | \"trailing-start\""
               },
               {
@@ -10174,7 +10009,7 @@
               },
               {
                 "name": "aria",
-                "description": "The ARIA information for the view.",
+                "description": "The ARIA attributes for the view container. Provides accessibility information to assistive technologies such as screen readers. Supports the following properties: [`label`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label), [`description`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-description), [`describedByElements`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaDescribedByElements), and [`labelledByElements`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaLabelledByElements).",
                 "type": "DOMContainerAria"
               },
               {
@@ -11195,7 +11030,7 @@
               },
               {
                 "name": "aria",
-                "description": "The ARIA information for the view.",
+                "description": "The ARIA attributes for the view container. Provides accessibility information to assistive technologies such as screen readers. Supports the following properties: [`label`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label), [`description`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-description), [`describedByElements`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaDescribedByElements), and [`labelledByElements`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaLabelledByElements).",
                 "type": "DOMContainerAria"
               },
               {
@@ -13741,7 +13576,7 @@
               },
               {
                 "name": "aria",
-                "description": "The ARIA attributes for the view container.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#aria)",
+                "description": "The ARIA attributes for the view container. Provides accessibility information to assistive technologies such as screen readers. Supports the following properties: [`label`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label), [`description`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-description), [`describedByElements`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaDescribedByElements), and [`labelledByElements`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaLabelledByElements).",
                 "type": "DOMContainerAria"
               },
               {
@@ -18787,7 +18622,7 @@
             "properties": [
               {
                 "name": "aria",
-                "description": "The ARIA attributes for the view container.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-VideoView.html#aria)",
+                "description": "The ARIA attributes for the view container. Provides accessibility information to assistive technologies such as screen readers. Supports the following properties: [`label`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label), [`description`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-description), [`describedByElements`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaDescribedByElements), and [`labelledByElements`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaLabelledByElements).",
                 "type": "DOMContainerAria"
               },
               {