@arcgis/map-components 4.34.0-next.115 → 4.34.0-next.116

package/dist/docs/docs.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-08-29T04:42:16",
+  "timestamp": "2025-08-30T04:38:34",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "4.34.0-next.115",
+    "version": "4.34.0-next.116",
     "typescriptVersion": "5.8.3"
   },
   "components": [
@@ -7159,7 +7159,7 @@
       "overview": "",
       "readme": "",
       "usage": {},
-      "docs": "The Daylight component can be used to manipulate the lighting conditions of a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\n**Known limitations**\n\nDaylight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n\n**See also**\n\n- [Environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)\n- [Sample - Daylight component](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)",
+      "docs": "",
       "docsTags": [
         {
           "name": "superclass",
@@ -7204,7 +7204,7 @@
           "mutable": true,
           "attr": "current-season",
           "reflectToAttr": false,
-          "docs": "A season can be set instead of a date.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight-DaylightViewModel.html#currentSeason)",
+          "docs": "A season can be set instead of a date.\nEach season uses a fixed date corresponding to the seasonal equinoxes and solstices.",
           "docsTags": [],
           "values": [
             {
@@ -7237,7 +7237,7 @@
           },
           "mutable": true,
           "attr": "date-or-season",
-          "reflectToAttr": false,
+          "reflectToAttr": true,
           "docs": "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)",
           "docsTags": [],
           "default": "\"date\"",
@@ -7265,7 +7265,29 @@
           "mutable": true,
           "attr": "day-playing",
           "reflectToAttr": false,
-          "docs": "Starts or pauses the daytime animation cycling through the minutes of the day.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight-DaylightViewModel.html#dayPlaying)",
+          "docs": "Starts or pauses the daytime animation cycling through the minutes of the day.\nSet to `true` to start the animation and to `false` to pause it.",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "directShadowsEnabled",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "direct-shadows-enabled",
+          "reflectToAttr": false,
+          "docs": "",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -7278,10 +7300,10 @@
         },
         {
           "name": "headingLevel",
-          "type": "number",
+          "type": "1 | 2 | 3 | 4 | 5 | 6",
           "complexType": {
-            "original": "number",
-            "resolved": "number",
+            "original": "1 | 2 | 3 | 4 | 5 | 6",
+            "resolved": "1 | 2 | 3 | 4 | 5 | 6",
             "references": {}
           },
           "mutable": true,
@@ -7289,9 +7311,30 @@
           "reflectToAttr": false,
           "docs": "Indicates the heading level to use for the component title.",
           "docsTags": [],
-          "default": "3",
+          "default": "2",
           "values": [
             {
+              "value": "1",
+              "type": "number"
+            },
+            {
+              "value": "2",
+              "type": "number"
+            },
+            {
+              "value": "3",
+              "type": "number"
+            },
+            {
+              "value": "4",
+              "type": "number"
+            },
+            {
+              "value": "5",
+              "type": "number"
+            },
+            {
+              "value": "6",
               "type": "number"
             }
           ],
@@ -7440,7 +7483,7 @@
           },
           "mutable": true,
           "attr": "icon",
-          "reflectToAttr": false,
+          "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": [],
           "default": "\"brightness\"",
@@ -7473,6 +7516,97 @@
           "optional": true,
           "required": false
         },
+        {
+          "name": "lighting",
+          "type": "SunLighting | VirtualLighting",
+          "complexType": {
+            "original": "SunLighting | VirtualLighting",
+            "resolved": "SunLighting | VirtualLighting",
+            "references": {
+              "SunLighting": {
+                "location": "import",
+                "path": "@arcgis/core/interfaces.d.ts",
+                "id": "notImplemented"
+              },
+              "VirtualLighting": {
+                "location": "import",
+                "path": "@arcgis/core/interfaces.d.ts",
+                "id": "notImplemented"
+              }
+            }
+          },
+          "mutable": true,
+          "reflectToAttr": false,
+          "docs": "",
+          "docsTags": [
+            {
+              "name": "readonly",
+              "text": ""
+            }
+          ],
+          "values": [
+            {
+              "type": "SunLighting"
+            },
+            {
+              "type": "VirtualLighting"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "localDate",
+          "type": "Date",
+          "complexType": {
+            "original": "Date",
+            "resolved": "Date",
+            "references": {
+              "Date": {
+                "location": "import",
+                "path": "typescript/lib/lib.es5.d.ts",
+                "id": "notImplemented"
+              }
+            }
+          },
+          "mutable": true,
+          "reflectToAttr": false,
+          "docs": "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).",
+          "docsTags": [],
+          "values": [],
+          "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": [],
+          "values": [
+            {
+              "value": "day",
+              "type": "string"
+            },
+            {
+              "value": "none",
+              "type": "string"
+            },
+            {
+              "value": "year",
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "playSpeedMultiplier",
           "type": "number",
@@ -7484,8 +7618,13 @@
           "mutable": true,
           "attr": "play-speed-multiplier",
           "reflectToAttr": false,
-          "docs": "Controls the speed of the daytime and date animation.",
-          "docsTags": [],
+          "docs": "Controls the daytime and date animation speed.",
+          "docsTags": [
+            {
+              "name": "example",
+              "text": "// Plays the daylight animation at half of the default speed\ndaylightWidget.playSpeedMultiplier = 0.5;"
+            }
+          ],
           "default": "1.0",
           "values": [
             {
@@ -7602,29 +7741,115 @@
           "required": false
         },
         {
-          "name": "timeSliderSteps",
-          "type": "Array<number> | number",
+          "name": "sunlightingDisabled",
+          "type": "boolean",
           "complexType": {
-            "original": "Array<number> | number",
-            "resolved": "Array<number> | number",
-            "references": {
-              "Array": {
-                "location": "import",
-                "path": "typescript/lib/lib.es5.d.ts",
-                "id": "notImplemented"
-              }
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "sunlighting-disabled",
+          "reflectToAttr": false,
+          "docs": "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).",
+          "docsTags": [],
+          "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": "readonly",
+              "text": ""
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
             }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "timeSliderPosition",
+          "type": "number",
+          "complexType": {
+            "original": "number",
+            "resolved": "number",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "time-slider-position",
+          "reflectToAttr": false,
+          "docs": "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).",
+          "docsTags": [
+            {
+              "name": "example",
+              "text": "view.environment.lighting = new SunLighting({\n  date: new Date(\"2022-06-21T12:00:00\")\n});"
+            }
+          ],
+          "values": [
+            {
+              "type": "number"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "timeSliderSteps",
+          "type": "number",
+          "complexType": {
+            "original": "number",
+            "resolved": "number",
+            "references": {}
           },
           "mutable": true,
           "attr": "time-slider-steps",
           "reflectToAttr": false,
-          "docs": "Sets steps, or intervals, on the time slider to restrict the times of the day that can be selected when dragging the thumb.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#timeSliderSteps)",
+          "docs": "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.",
           "docsTags": [],
           "default": "5",
           "values": [
             {
-              "type": "Array<number>"
-            },
+              "type": "number"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "utcOffset",
+          "type": "number",
+          "complexType": {
+            "original": "number",
+            "resolved": "number",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "utc-offset",
+          "reflectToAttr": false,
+          "docs": "The difference in hours between UTC time and the time displayed in the widget.",
+          "docsTags": [],
+          "values": [
             {
               "type": "number"
             }
@@ -7643,7 +7868,7 @@
           "mutable": true,
           "attr": "year-playing",
           "reflectToAttr": false,
-          "docs": "Starts or pauses the date animation cycling through the months of the year.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight-DaylightViewModel.html#yearPlaying)",
+          "docs": "Starts or pauses the date animation cycling through the months of the year. Set to `true` to start the animation\nand to `false` to pause it.",
           "docsTags": [],
           "default": "false",
           "values": [

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

@@ -1537,7 +1537,7 @@
     },
     {
       "name": "arcgis-daylight",
-      "description": "The Daylight component can be used to manipulate the lighting conditions of a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\n**Known limitations**\n\nDaylight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n\n**See also**\n\n- [Environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)\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": "### 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",
@@ -1546,7 +1546,7 @@
         },
         {
           "name": "current-season",
-          "description": "A season can be set instead of a date.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight-DaylightViewModel.html#currentSeason)",
+          "description": "A season can be set instead of a date.\nEach season uses a fixed date corresponding to the seasonal equinoxes and solstices.",
           "values": [
             {
               "name": "fall"
@@ -1576,13 +1576,36 @@
         },
         {
           "name": "day-playing",
-          "description": "Starts or pauses the daytime animation cycling through the minutes of the day.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight-DaylightViewModel.html#dayPlaying)",
+          "description": "Starts or pauses the daytime animation cycling through the minutes of the day.\nSet to `true` to start the animation and to `false` to pause it.",
+          "values": []
+        },
+        {
+          "name": "direct-shadows-enabled",
           "values": []
         },
         {
           "name": "heading-level",
           "description": "Indicates the heading level to use for the component title.",
-          "values": []
+          "values": [
+            {
+              "name": "1"
+            },
+            {
+              "name": "2"
+            },
+            {
+              "name": "3"
+            },
+            {
+              "name": "4"
+            },
+            {
+              "name": "5"
+            },
+            {
+              "name": "6"
+            }
+          ]
         },
         {
           "name": "hide-date-picker",
@@ -1620,9 +1643,23 @@
         },
         {
           "name": "play-speed-multiplier",
-          "description": "Controls the speed of the daytime and date animation.",
+          "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://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead.. ",
@@ -1661,14 +1698,29 @@
           "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": "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).",
+          "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).",
+          "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.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#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.",
+          "values": []
+        },
+        {
+          "name": "utc-offset",
+          "description": "The difference in hours between UTC time and the time displayed in the widget.",
           "values": []
         },
         {
           "name": "year-playing",
-          "description": "Starts or pauses the date animation cycling through the months of the year.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight-DaylightViewModel.html#yearPlaying)",
+          "description": "Starts or pauses the date animation cycling through the months of the year. Set to `true` to start the animation\nand to `false` to pause it.",
           "values": []
         }
       ],