@arcgis/map-components 4.34.0-next.165 → 4.34.0-next.167

package/dist/docs/docs.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-10-15T04:31:35",
+  "timestamp": "2025-10-16T13:35:34",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "4.34.0-next.165",
+    "version": "4.34.0-next.167",
     "typescriptVersion": "5.8.3"
   },
   "components": [
@@ -3992,7 +3992,7 @@
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Specifies how new bookmarks will be created if [showAddBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showAddBookmarkButton) is set to `true`.\nCan be used to enable or disable taking screenshots or capturing the bookmark's viewpoint based on the current\nview when a bookmark is created. See [BookmarkOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks-BookmarksViewModel-BookmarkOptions.html)\nfor the full list of options.",
+          "docs": "Specifies how new bookmarks will be created if [showAddBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showAddBookmarkButton) is set to `true`.\nCan be used to enable or disable taking screenshots or capturing the bookmark's viewpoint based on the current\nview when a bookmark is created. See [BookmarkOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks-BookmarksViewModel.html#BookmarkOptions)\nfor the full list of options.",
           "docsTags": [
             {
               "name": "example",
@@ -4019,7 +4019,7 @@
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Specifies how bookmarks will be edited, if [showEditBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showEditBookmarkButton) is set to `true`.\nCan be used to enable or disable taking screenshots or capturing the bookmark's viewpoint based on the current\nview when a bookmark is edited. See [BookmarkOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks-BookmarksViewModel-BookmarkOptions.html)\nfor the full list of options.",
+          "docs": "Specifies how bookmarks will be edited, if [showEditBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showEditBookmarkButton) is set to `true`.\nCan be used to enable or disable taking screenshots or capturing the bookmark's viewpoint based on the current\nview when a bookmark is edited. See [BookmarkOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks-BookmarksViewModel.html#BookmarkOptions)\nfor the full list of options.",
           "docsTags": [],
           "values": [],
           "optional": true,
@@ -7789,8 +7789,24 @@
       "overview": "",
       "readme": "",
       "usage": {},
-      "docs": "The Daylight component can be used to manipulate the lighting conditions of a\n[Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\nFor this, the component modifies the `lighting` property of the\n[environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment) of the Scene component.\n\nTo illuminate the scene, one can either use a configuration of date and time to position the\n[sun](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html) or switch to the\n[virtual mode](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html) mode,\nwhere the light source is relative to the camera.\n\nWhen **lighting the scene with the sun** and adjusting the time and date, the position of the sun\nand the stars get updated accordingly, changing the light and the shadows in the scene. This sets the `date` and `directShadowsEnabled` properties of\n[environment.lighting](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment).\n\n[![daylight-default](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-default.png)](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)\n\nThe component has an option to select the timezone. When the user makes any adjustments here, a new time\nin the chosen timezone is calculated and displayed in the slider. The timezone selector can be disabled\nby using `hide-timezone` attribute or setting `hideTimezone` property to `true`.\n\nBy default, a calendar is displayed where the user can select the day, month and year.\nWith the [dateOrSeason](#dateOrSeason) property, the calendar can be replaced with\na dropdown menu where a season can be selected instead:\n\n![daylight-seasons](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-seasons.png)\n\nThere are two play buttons, one corresponds to the daytime slider and it animates the time as\nit cycles through the minutes of the day. The second button corresponds to the date picker\nand it animates the time as it cycles through the months of the year. The speed of the animation can\nbe set using the [playSpeedMultiplier](#playSpeedMultiplier) property.\n\n![daylight-animation](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-animation.gif)\n\nExcept for the daytime slider, all the elements in the Daylight component can be hidden:\n\n![daylight-no-elements](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-no-elements.png)\n\nWhenever the sun position option is unchecked, the scene applies the **virtual light source** relative to the camera.\nWith this, the component's time slider, timezone and date picker get automatically disabled:\n\n![daylight-virtual](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-virtual.png)\n\n**Things to consider**\n\n* Daylight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n* The Daylight component uses UTC time and does not account for the daylight savings times in different countries and regions of the world.\n* When the [environment.lighting](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)\nis of the type `virtual`, setting the time and date does not have an influence on the lighting conditions of the scene.\n\n**See also**\n\n- [Environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)\n- [SunLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html)\n- [VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html)\n- [Sample - Daylight component](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)",
+      "docs": "The Daylight component can be used to manipulate the lighting conditions of a\n[Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\nTo achieve this, the component modifies the `lighting` property of the\n[environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment) of the Scene component.\n\nTo illuminate the scene, one can either use a configuration of date and time to position the\n[sun](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html) or switch to the\n[virtual](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html) mode,\nwhere the light source is relative to the camera.\n\nWhen illuminating the scene with **[sunlight](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html)**\nand adjusting the time and date, the positions of the sun and stars are updated accordingly. This also updates the\n[date](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html#date) property of\n[environment.lighting](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment).\n\n[![daylight-default](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-default.png)](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)\n\nThe component has an option to select the timezone. When the user makes any adjustments here, a new time\nin the chosen timezone is calculated and displayed in the slider. The timezone selector can be disabled\nby using the [hideTimezone](#hideTimezone) property.\n\nBy default, a calendar is displayed to select the day, month, and year.\nWith the [dateOrSeason](#dateOrSeason) property, the calendar can be replaced with\na dropdown menu where a season can be selected instead:\n\n![daylight-seasons](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-seasons.png)\n\nThere are two play buttons: one corresponds to the time-of-day slider and animates the lighting\nover the course of a day, while the other corresponds to the date picker\nand animates the lighting over the course of a year (month by month). The speed of the animation can\nbe set using the [playSpeedMultiplier](#playSpeedMultiplier) property.\n\n![daylight-animation](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-animation.gif)\n\nExcept for the daytime slider, all the elements in the Daylight component can be hidden:\n\n![daylight-no-elements](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-no-elements.png)\n\nWhenever the sun position option is unchecked, the scene applies the\n**[virtual light](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html)** source relative to the camera.\nWith this, the component's time slider, timezone, and date picker get automatically disabled:\n\n![daylight-virtual](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-virtual.png)\n\n**Things to consider**\n\n* Daylight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n* The Daylight component uses UTC time and does not account for the daylight savings times in different countries and regions of the world.\n* When using the [virtual light](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html),\nsetting the time and date programmatically does not have an influence on the lighting conditions of the scene.\n* When using the [sunlight](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html),\nthe time slider and time zone automatically react to the changes of the camera (e.g., position, rotation, pan, zoom) because the position of the simulated sun\nis updated to maintain a consistent solar time of day based on the camera's current longitude. This can be adjusted using the\n[cameraTrackingEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html#cameraTrackingEnabled)\nproperty on [environment.lighting](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment).",
       "docsTags": [
+        {
+          "name": "see",
+          "text": "[Environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)"
+        },
+        {
+          "name": "see",
+          "text": "[SunLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html)"
+        },
+        {
+          "name": "see",
+          "text": "[VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html)"
+        },
+        {
+          "name": "see",
+          "text": "[Sample - Daylight component](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)"
+        },
         {
           "name": "since",
           "text": "4.28"
@@ -7838,8 +7854,13 @@
           "mutable": true,
           "attr": "current-season",
           "reflectToAttr": false,
-          "docs": "Sets the season that is used when the component displays a season picker.\nEach season uses a fixed date corresponding to the seasonal equinoxes and solstices.\n\n**See also**\n\n[dateOrSeason](#dateOrSeason)",
-          "docsTags": [],
+          "docs": "Sets the season that is used when the component displays the season picker.\nEach season uses a fixed date corresponding to the seasonal equinoxes and solstices.",
+          "docsTags": [
+            {
+              "name": "see",
+              "text": "[dateOrSeason](#dateOrSeason)"
+            }
+          ],
           "values": [
             {
               "value": "fall",
@@ -7910,33 +7931,6 @@
           "optional": true,
           "required": false
         },
-        {
-          "name": "directShadowsDisabled",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": true,
-          "attr": "direct-shadows-disabled",
-          "reflectToAttr": false,
-          "docs": "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)",
-          "docsTags": [
-            {
-              "name": "since",
-              "text": "4.34"
-            }
-          ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": true,
-          "required": false
-        },
         {
           "name": "headingLevel",
           "type": "1 | 2 | 3 | 4 | 5 | 6",
@@ -8123,8 +8117,13 @@
           "mutable": true,
           "attr": "icon",
           "reflectToAttr": true,
-          "docs": "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/)",
-          "docsTags": [],
+          "docs": "Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).",
+          "docsTags": [
+            {
+              "name": "see",
+              "text": "[Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)"
+            }
+          ],
           "default": "\"brightness\"",
           "values": [
             {
@@ -8175,37 +8174,13 @@
           "docs": "The calendar date in the timezone given by [utcOffset](#utcOffset).",
           "docsTags": [
             {
-              "name": "since",
-              "text": "4.34"
-            }
-          ],
-          "values": [
-            {
-              "type": "Date"
+              "name": "example",
+              "text": "```js\ndaylight.localDate = new Date(\"2005-08-25\");\n```"
             },
             {
-              "type": "number"
+              "name": "example",
+              "text": "```js\n// Alternatively, the date can be set by configuring the `date` property of `SunLighting`.\nviewElement.environment.lighting = new SunLighting({\n  date: new Date(\"2005-08-25T16:00:00\")\n});\n```"
             },
-            {
-              "type": "string"
-            }
-          ],
-          "optional": true,
-          "required": false
-        },
-        {
-          "name": "playingState",
-          "type": "\"day\" | \"none\" | \"year\"",
-          "complexType": {
-            "original": "\"day\" | \"none\" | \"year\"",
-            "resolved": "\"day\" | \"none\" | \"year\"",
-            "references": {}
-          },
-          "mutable": true,
-          "attr": "playing-state",
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
             {
               "name": "since",
               "text": "4.34"
@@ -8213,15 +8188,12 @@
           ],
           "values": [
             {
-              "value": "day",
-              "type": "string"
+              "type": "Date"
             },
             {
-              "value": "none",
-              "type": "string"
+              "type": "number"
             },
             {
-              "value": "year",
               "type": "string"
             }
           ],
@@ -8243,7 +8215,7 @@
           "docsTags": [
             {
               "name": "example",
-              "text": "// Plays the daylight animation at half of the default speed\ndaylight.playSpeedMultiplier = 0.5;"
+              "text": "```js\n// Plays the daylight animation at half of the default speed\ndaylight.playSpeedMultiplier = 0.5;\n```"
             }
           ],
           "default": "1.0",
@@ -8361,63 +8333,6 @@
           "optional": true,
           "required": false
         },
-        {
-          "name": "sunlightingDisabled",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": true,
-          "attr": "sunlighting-disabled",
-          "reflectToAttr": false,
-          "docs": "When set, the light source is positioned relative to the camera, using\n[VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html).\nOtherwise, [date and time](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html)\nare used to determine position of the light source.",
-          "docsTags": [
-            {
-              "name": "since",
-              "text": "4.34"
-            }
-          ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": true,
-          "required": false
-        },
-        {
-          "name": "supported",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": true,
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
-            {
-              "name": "since",
-              "text": "4.34"
-            },
-            {
-              "name": "readonly",
-              "text": ""
-            }
-          ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": true,
-          "required": false
-        },
         {
           "name": "timeSliderPosition",
           "type": "number",
@@ -8433,7 +8348,11 @@
           "docsTags": [
             {
               "name": "example",
-              "text": "viewElement.environment.lighting = new SunLighting({\n  date: new Date(\"2022-06-21T12:00:00\")\n});"
+              "text": "```js\n// Set the time to 4:00 PM (16:00) in the given timezone.\ndaylight.timeSliderPosition = 16 * 60;\n```"
+            },
+            {
+              "name": "example",
+              "text": "```js\n// Alternatively, the time can be set by configuring the `date` property of `SunLighting`.\n// Then, the time slider gets updated automatically.\nviewElement.environment.lighting = new SunLighting({\n  date: new Date(\"2005-08-25T16:00:00\")\n});\n```"
             },
             {
               "name": "since",
@@ -8450,19 +8369,33 @@
         },
         {
           "name": "timeSliderSteps",
-          "type": "number",
+          "type": "Array<number> | number",
           "complexType": {
-            "original": "number",
-            "resolved": "number",
-            "references": {}
+            "original": "Array<number> | number",
+            "resolved": "Array<number> | number",
+            "references": {
+              "Array": {
+                "location": "import",
+                "path": "typescript/lib/lib.es5.d.ts",
+                "id": "notImplemented"
+              }
+            }
           },
           "mutable": true,
           "attr": "time-slider-steps",
           "reflectToAttr": false,
-          "docs": "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.",
-          "docsTags": [],
+          "docs": "Sets the interval, in minutes, with which the time slider increments or decrements as it is dragged or changed via the keyboard.",
+          "docsTags": [
+            {
+              "name": "example",
+              "text": "```js\n// Set steps at an interval of 60. Then, the slider thumb snaps at each hour of the day.\ndaylight.timeSliderSteps = 60;\n```"
+            }
+          ],
           "default": "5",
           "values": [
+            {
+              "type": "Array<number>"
+            },
             {
               "type": "number"
             }
@@ -8483,6 +8416,14 @@
           "reflectToAttr": false,
           "docs": "The difference in hours between UTC time and the time displayed in the component.",
           "docsTags": [
+            {
+              "name": "example",
+              "text": "```js\ndaylight.utcOffset = -8;\n```"
+            },
+            {
+              "name": "example",
+              "text": "```js\n// Alternatively, the UTC offset can be set by configuring the `displayUTCOffset` property of `SunLighting`.\nviewElement.environment.lighting = new SunLighting({\n  displayUTCOffset: -8\n});\n```"
+            },
             {
               "name": "since",
               "text": "4.34"
@@ -8498,21 +8439,11 @@
         },
         {
           "name": "view",
-          "type": "LinkChartView | MapView | SceneView",
+          "type": "SceneView",
           "complexType": {
-            "original": "LinkChartView | MapView | SceneView",
-            "resolved": "LinkChartView | MapView | SceneView",
+            "original": "SceneView",
+            "resolved": "SceneView",
             "references": {
-              "LinkChartView": {
-                "location": "import",
-                "path": "@arcgis/core/interfaces.d.ts",
-                "id": "notImplemented"
-              },
-              "MapView": {
-                "location": "import",
-                "path": "@arcgis/core/interfaces.d.ts",
-                "id": "notImplemented"
-              },
               "SceneView": {
                 "location": "import",
                 "path": "@arcgis/core/interfaces.d.ts",
@@ -8524,17 +8455,7 @@
           "reflectToAttr": false,
           "docs": "",
           "docsTags": [],
-          "values": [
-            {
-              "type": "LinkChartView"
-            },
-            {
-              "type": "MapView"
-            },
-            {
-              "type": "SceneView"
-            }
-          ],
+          "values": [],
           "optional": true,
           "required": false
         },
@@ -15490,48 +15411,6 @@
           "optional": true,
           "required": false
         },
-        {
-          "name": "flowItems",
-          "type": "Collection<HTMLArcgisFeatureElement | HTMLArcgisFeatureRelationshipElement | HTMLArcgisFeatureUtilityNetworkAssociationsElement>",
-          "complexType": {
-            "original": "Collection<HTMLArcgisFeatureElement | HTMLArcgisFeatureRelationshipElement | HTMLArcgisFeatureUtilityNetworkAssociationsElement>",
-            "resolved": "Collection<HTMLArcgisFeatureElement | HTMLArcgisFeatureRelationshipElement | HTMLArcgisFeatureUtilityNetworkAssociationsElement>",
-            "references": {
-              "Collection": {
-                "location": "import",
-                "path": "@arcgis/core/interfaces.d.ts",
-                "id": "notImplemented"
-              },
-              "HTMLArcgisFeatureElement": {
-                "location": "local",
-                "path": "index.js",
-                "id": "notImplemented"
-              },
-              "HTMLArcgisFeatureRelationshipElement": {
-                "location": "local",
-                "path": "index.js",
-                "id": "notImplemented"
-              },
-              "HTMLArcgisFeatureUtilityNetworkAssociationsElement": {
-                "location": "local",
-                "path": "index.js",
-                "id": "notImplemented"
-              }
-            }
-          },
-          "mutable": true,
-          "reflectToAttr": false,
-          "docs": "A collection of flow items that are used to manage drill-in navigation.",
-          "docsTags": [
-            {
-              "name": "since",
-              "text": "4.34"
-            }
-          ],
-          "values": [],
-          "optional": true,
-          "required": false
-        },
         {
           "name": "graphic",
           "type": "Graphic",
@@ -16361,7 +16240,7 @@
           "mutable": true,
           "attr": "show-utility-network-content",
           "reflectToAttr": false,
-          "docs": "This property provides the ability to hide or show [utility network content](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-UtilityNetworkContent.html) within the component.",
+          "docs": "This property provides the ability to hide or show [utility network content](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-UtilityNetworkAssociationsContent.html) within the component.",
           "docsTags": [
             {
               "name": "since",
@@ -16658,7 +16537,7 @@
               "docs": ""
             }
           ],
-          "docs": "Paginates to the previous [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info in the specified\n[media](esri-popup-content-MediaContent.html) content element.",
+          "docs": "Paginates to the previous [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info.",
           "docsTags": []
         },
         {
@@ -16703,7 +16582,7 @@
               "docs": ""
             }
           ],
-          "docs": "Paginates to a specified [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info object. For example,\nyou may have [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) content which contains\nmultiple `mediaInfos`. This method allows you to specify the index of the `mediaInfos`\nyou wish to display.\n\n::: esri-md class=\"warning\"\nPrior to   version 4.17, this method was named `goToMedia`.\n:::",
+          "docs": "Paginates to a specified [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info object. For example,\nyou may have [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) content which contains\nmultiple `mediaInfos`. This method allows you to specify the index of the `mediaInfos`\nyou wish to display.",
           "docsTags": []
         },
         {

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

@@ -1565,7 +1565,7 @@
     },
     {
       "name": "arcgis-daylight",
-      "description": "The Daylight component can be used to manipulate the lighting conditions of a\n[Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\nFor this, the component modifies the `lighting` property of the\n[environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment) of the Scene component.\n\nTo illuminate the scene, one can either use a configuration of date and time to position the\n[sun](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html) or switch to the\n[virtual mode](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html) mode,\nwhere the light source is relative to the camera.\n\nWhen **lighting the scene with the sun** and adjusting the time and date, the position of the sun\nand the stars get updated accordingly, changing the light and the shadows in the scene. This sets the `date` and `directShadowsEnabled` properties of\n[environment.lighting](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment).\n\n[![daylight-default](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-default.png)](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)\n\nThe component has an option to select the timezone. When the user makes any adjustments here, a new time\nin the chosen timezone is calculated and displayed in the slider. The timezone selector can be disabled\nby using `hide-timezone` attribute or setting `hideTimezone` property to `true`.\n\nBy default, a calendar is displayed where the user can select the day, month and year.\nWith the [dateOrSeason](#dateOrSeason) property, the calendar can be replaced with\na dropdown menu where a season can be selected instead:\n\n![daylight-seasons](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-seasons.png)\n\nThere are two play buttons, one corresponds to the daytime slider and it animates the time as\nit cycles through the minutes of the day. The second button corresponds to the date picker\nand it animates the time as it cycles through the months of the year. The speed of the animation can\nbe set using the [playSpeedMultiplier](#playSpeedMultiplier) property.\n\n![daylight-animation](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-animation.gif)\n\nExcept for the daytime slider, all the elements in the Daylight component can be hidden:\n\n![daylight-no-elements](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-no-elements.png)\n\nWhenever the sun position option is unchecked, the scene applies the **virtual light source** relative to the camera.\nWith this, the component's time slider, timezone and date picker get automatically disabled:\n\n![daylight-virtual](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-virtual.png)\n\n**Things to consider**\n\n* Daylight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n* The Daylight component uses UTC time and does not account for the daylight savings times in different countries and regions of the world.\n* When the [environment.lighting](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)\nis of the type `virtual`, setting the time and date does not have an influence on the lighting conditions of the scene.\n\n**See also**\n\n- [Environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)\n- [SunLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html)\n- [VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html)\n- [Sample - Daylight component](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)\n--\n\n### Events\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n- **arcgisUserDateTimeChange** - 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.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.",
+      "description": "The Daylight component can be used to manipulate the lighting conditions of a\n[Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\nTo achieve this, the component modifies the `lighting` property of the\n[environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment) of the Scene component.\n\nTo illuminate the scene, one can either use a configuration of date and time to position the\n[sun](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html) or switch to the\n[virtual](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html) mode,\nwhere the light source is relative to the camera.\n\nWhen illuminating the scene with **[sunlight](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html)**\nand adjusting the time and date, the positions of the sun and stars are updated accordingly. This also updates the\n[date](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html#date) property of\n[environment.lighting](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment).\n\n[![daylight-default](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-default.png)](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)\n\nThe component has an option to select the timezone. When the user makes any adjustments here, a new time\nin the chosen timezone is calculated and displayed in the slider. The timezone selector can be disabled\nby using the [hideTimezone](#hideTimezone) property.\n\nBy default, a calendar is displayed to select the day, month, and year.\nWith the [dateOrSeason](#dateOrSeason) property, the calendar can be replaced with\na dropdown menu where a season can be selected instead:\n\n![daylight-seasons](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-seasons.png)\n\nThere are two play buttons: one corresponds to the time-of-day slider and animates the lighting\nover the course of a day, while the other corresponds to the date picker\nand animates the lighting over the course of a year (month by month). The speed of the animation can\nbe set using the [playSpeedMultiplier](#playSpeedMultiplier) property.\n\n![daylight-animation](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-animation.gif)\n\nExcept for the daytime slider, all the elements in the Daylight component can be hidden:\n\n![daylight-no-elements](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-no-elements.png)\n\nWhenever the sun position option is unchecked, the scene applies the\n**[virtual light](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html)** source relative to the camera.\nWith this, the component's time slider, timezone, and date picker get automatically disabled:\n\n![daylight-virtual](https://developers.arcgis.com/javascript/latest/assets/img/apiref/components/daylight/daylight-virtual.png)\n\n**Things to consider**\n\n* Daylight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n* The Daylight component uses UTC time and does not account for the daylight savings times in different countries and regions of the world.\n* When using the [virtual light](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html),\nsetting the time and date programmatically does not have an influence on the lighting conditions of the scene.\n* When using the [sunlight](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html),\nthe time slider and time zone automatically react to the changes of the camera (e.g., position, rotation, pan, zoom) because the position of the simulated sun\nis updated to maintain a consistent solar time of day based on the camera's current longitude. This can be adjusted using the\n[cameraTrackingEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html#cameraTrackingEnabled)\nproperty on [environment.lighting](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment).\n--\n\n### Events\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n- **arcgisUserDateTimeChange** - 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.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.",
       "attributes": [
         {
           "name": "auto-destroy-disabled",
@@ -1574,7 +1574,7 @@
         },
         {
           "name": "current-season",
-          "description": "Sets the season that is used when the component displays a season picker.\nEach season uses a fixed date corresponding to the seasonal equinoxes and solstices.\n\n**See also**\n\n[dateOrSeason](#dateOrSeason)",
+          "description": "Sets the season that is used when the component displays the season picker.\nEach season uses a fixed date corresponding to the seasonal equinoxes and solstices.",
           "values": [
             {
               "name": "fall"
@@ -1607,11 +1607,6 @@
           "description": "Starts or pauses the daytime animation cycling through the minutes of the day.\nSet the property to `true` to start the animation and to `false` to pause it.",
           "values": []
         },
-        {
-          "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": []
-        },
         {
           "name": "heading-level",
           "description": "Indicates the heading level to use for the component title.",
@@ -1662,7 +1657,7 @@
         },
         {
           "name": "icon",
-          "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/)",
+          "description": "Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).",
           "values": []
         },
         {
@@ -1680,20 +1675,6 @@
           "description": "Controls the daytime and date animation speed.",
           "values": []
         },
-        {
-          "name": "playing-state",
-          "values": [
-            {
-              "name": "day"
-            },
-            {
-              "name": "none"
-            },
-            {
-              "name": "year"
-            }
-          ]
-        },
         {
           "name": "position",
           "description": "**Deprecated**: since 4.34, use [`slot`](https://developers.arcgis.com/javascript/latest/building-your-ui/#slots) instead.. ",
@@ -1732,11 +1713,6 @@
           "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": "sunlighting-disabled",
-          "description": "When set, the light source is positioned relative to the camera, using\n[VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html).\nOtherwise, [date and time](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html)\nare used to determine position of the light source.",
-          "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.",
@@ -1744,7 +1720,7 @@
         },
         {
           "name": "time-slider-steps",
-          "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.",
+          "description": "Sets the interval, in minutes, with which the time slider increments or decrements as it is dragged or changed via the keyboard.",
           "values": []
         },
         {
@@ -3261,7 +3237,7 @@
     },
     {
       "name": "arcgis-feature",
-      "description": "The Feature component displays a graphic according to its [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).\nThis component is useful in instances where you want to display information about a feature but without\nthe use of a [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html).\n\nIf wanting to show a feature's content with [actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#actions), [related](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-RelationshipContent.html), or [clustering](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionCluster.html#popupTemplate), etc., then use the [arcgis-features](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/) component.\n\nWhen Arcade expressions that use `$map` or [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/) are defined in any popup template content or as expression elements,\nthe [map](#map) and [spatialReference](#spatialReference) properties need to be defined in the Feature component.\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- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.\n- `nextMedia(contentElementIndex: number): Promise<void>` - Paginates to the next [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info.\n- `previousMedia(contentElementIndex: number): Promise<void>` - Paginates to the previous [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info in the specified\n[media](esri-popup-content-MediaContent.html) content element.\n- `setActiveMedia(contentElementIndex: number, mediaInfoIndex: number): Promise<void>` - Paginates to a specified [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info object. For example,\nyou may have [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) content which contains\nmultiple `mediaInfos`. This method allows you to specify the index of the `mediaInfos`\nyou wish to display.\n\n::: esri-md class=\"warning\"\nPrior to   version 4.17, this method was named `goToMedia`.\n:::\n- `updateGeometry(): Promise<void>` - Updates the geometry of the graphic.",
+      "description": "The Feature component displays a graphic according to its [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).\nThis component is useful in instances where you want to display information about a feature but without\nthe use of a [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html).\n\nIf wanting to show a feature's content with [actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#actions), [related](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-RelationshipContent.html), or [clustering](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionCluster.html#popupTemplate), etc., then use the [arcgis-features](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/) component.\n\nWhen Arcade expressions that use `$map` or [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/) are defined in any popup template content or as expression elements,\nthe [map](#map) and [spatialReference](#spatialReference) properties need to be defined in the Feature component.\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- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.\n- `nextMedia(contentElementIndex: number): Promise<void>` - Paginates to the next [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info.\n- `previousMedia(contentElementIndex: number): Promise<void>` - Paginates to the previous [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info.\n- `setActiveMedia(contentElementIndex: number, mediaInfoIndex: number): Promise<void>` - Paginates to a specified [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info object. For example,\nyou may have [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) content which contains\nmultiple `mediaInfos`. This method allows you to specify the index of the `mediaInfos`\nyou wish to display.\n- `updateGeometry(): Promise<void>` - Updates the geometry of the graphic.",
       "attributes": [
         {
           "name": "auto-destroy-disabled",
@@ -3437,7 +3413,7 @@
         },
         {
           "name": "show-utility-network-content",
-          "description": "This property provides the ability to hide or show [utility network content](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-UtilityNetworkContent.html) within the component.",
+          "description": "This property provides the ability to hide or show [utility network content](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-UtilityNetworkAssociationsContent.html) within the component.",
           "values": []
         },
         {
@@ -3470,16 +3446,8 @@
           "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-feature/"
         },
         {
-          "name": "Feature",
-          "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-feature--demo&singleStory=true"
-        },
-        {
-          "name": "Generic",
-          "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-feature--generic&singleStory=true"
-        },
-        {
-          "name": "Expression",
-          "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-feature--expression&singleStory=true"
+          "name": "Feature\nThe Feature component displays on hover.",
+          "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-feature--hover&singleStory=true"
         }
       ]
     },
@@ -4294,7 +4262,7 @@
           "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/"
         },
         {
-          "name": "Features",
+          "name": "Features\nThe Features component displays in a Calcite shell panel on click.",
           "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-features--demo&singleStory=true"
         }
       ]
@@ -6497,15 +6465,11 @@
           "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-popup/"
         },
         {
-          "name": "Popup",
+          "name": "Popup\nThe Popup component opens on view element click.",
           "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-popup--demo&singleStory=true"
         },
         {
-          "name": "Small Map",
-          "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-popup--small-map&singleStory=true"
-        },
-        {
-          "name": "Custom Popup",
+          "name": "Custom Popup\nThe Popup component opens manually within a click event.",
           "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-popup--custom-popup&singleStory=true"
         }
       ]