@arcgis/map-components 4.34.0-next.13 → 4.34.0-next.15

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": "4.34.0-next.13",
+  "version": "4.34.0-next.15",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -710,7 +710,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -1332,7 +1332,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -2349,7 +2349,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -3079,7 +3079,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -7048,7 +7048,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -7446,7 +7446,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -7887,7 +7887,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -8647,7 +8647,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -8936,7 +8936,7 @@
               },
               {
                 "name": "graphics",
-                "description": "Allows for adding graphics directly to the default graphics in the View.\nExample:\n```\n// Adds a graphic to the View\ngraphics.add(pointGraphic);\n```\nExample:\n```\n// Removes a graphic from the View\ngraphics.remove(pointGraphic);\n```",
+                "description": "Allows for adding graphics directly to the default graphics in the View.",
                 "type": "Collection<Graphic>"
               },
               {
@@ -9311,7 +9311,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -9495,7 +9495,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -9818,7 +9818,7 @@
               },
               {
                 "name": "graphics",
-                "description": "Allows for adding graphics directly to the default graphics in the View.\nExample:\n```\n// Adds a graphic to the View\ngraphics.add(pointGraphic);\n```\nExample:\n```\n// Removes a graphic from the View\ngraphics.remove(pointGraphic);\n```",
+                "description": "Allows for adding graphics directly to the default graphics in the View.",
                 "type": "Collection<Graphic>"
               },
               {
@@ -10377,7 +10377,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -10730,7 +10730,7 @@
         },
         {
           "name": "arcgis-print",
-          "description": "The Print component connects your application with a [printing service](https://enterprise.arcgis.com/en/portal/latest/administer/windows/configure-the-portal-to-print-maps.htm) to allow the map to be printed.\nIt takes advantage of server-side, high-quality, full cartographic print functionality using the ExportWebMap service of ArcGIS,\nwhich can be configured with custom layout templates. One is provided that shows the map only, while another provides a layout with legend, etc.\nThe Print component works with the [print](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-print.html) which generates a printer-ready version of the map.\n\nThe Print component has two required properties: [view](#view) (reference to the MapView)\nand [printServiceUrl](#printServiceUrl) (URL of the REST endpoint of the Export Web Map Task).\nThe component can preserve map scale or map extent in the printout. By default, the map extent is\npreserved. Use [TemplateOptions.scaleEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-TemplateOptions.html#scaleEnabled) to preserve scale\ninstead.\n\nThe Print component prints a localized date for all [layouts](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-support-PrintTemplate.html#layout)\nexcept `map-only`. If using a custom print service, then `customTextElements` are supported for each print\ntemplate. Values found there will be populated in the Print component under `Advanced options`. These values can\nbe overwritten in the Print component UI, or programmatically using the\n[templateCustomTextElements](#templateCustomTextElements) property.\n\nFor more information about printing with the `MAP_ONLY` layout, please see\n[exportOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-support-PrintTemplate.html#exportOptions).\n\n**Known Limitations**\n\nSee [print](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-print.html) for a detailed list of known limitations.\n\n```html\n<arcgis-map item-id=\"45725ba7d9fb47a0925398919b13d1fa\">\n <arcgis-print position=\"top-right\"></arcgis-print>\n</arcgis-map>\n```\n\n```js\n// get a reference to the component\nconst components = document.querySelectorAll(\"arcgis-print\");\n\nconst portal = new Portal({\n url: \"https://user.maps.arcgis.com/sharing\",\n authMode: \"immediate\",\n authorizedCrossOriginDomains: [\"https://user.maps.arcgis.com\"],\n});\n\ncomponents.forEach((component) => {\n component.portal = portal;\n});\n```\n--\n\n### Events\n- **arcgisComplete**\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 is ready to be interacted with.\n- **arcgisSubmit**\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 Print component connects your application with a [printing service](https://enterprise.arcgis.com/en/portal/latest/administer/windows/configure-the-portal-to-print-maps.htm) to allow the map to be printed.\nIt takes advantage of server-side, high-quality, full cartographic print functionality using the ExportWebMap service of ArcGIS,\nwhich can be configured with custom layout templates. One is provided that shows the map only, while another provides a layout with legend, etc.\nThe Print component works with the [print](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-print.html) module, which generates a printer-ready version of the map.\n\nThe Print component uses the ArcGIS Online print service by default, but it can be configured to use a custom print service with the [printServiceUrl](#printServiceUrl) property.\nThe component can preserve map scale or map extent in the printout. By default, the map extent is preserved. Use\n[TemplateOptions.scaleEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-TemplateOptions.html#scaleEnabled) to preserve scale instead.\n\nThe Print component prints a localized date for all [layouts](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-support-PrintTemplate.html#layout)\nexcept `map-only`. If using a custom print service, then `customTextElements` are supported for each print\ntemplate. Values found there will be populated in the Print component under `Advanced options`. These values can\nbe overwritten in the Print component UI, or programmatically using the\n[templateCustomTextElements](#templateCustomTextElements) property.\n\nFor more information about printing with the `MAP_ONLY` layout, please see\n[exportOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-support-PrintTemplate.html#exportOptions).\n\n**Known Limitations**\n\nSee [print](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-print.html) for a detailed list of known limitations.\n\n```html\n<arcgis-map item-id=\"45725ba7d9fb47a0925398919b13d1fa\">\n <arcgis-print position=\"top-right\"></arcgis-print>\n</arcgis-map>\n```\n\n```js\n// get a reference to the component\nconst components = document.querySelectorAll(\"arcgis-print\");\n\nconst portal = new Portal({\n url: \"https://user.maps.arcgis.com/sharing\",\n authMode: \"immediate\",\n authorizedCrossOriginDomains: [\"https://user.maps.arcgis.com\"],\n});\n\ncomponents.forEach((component) => {\n component.portal = portal;\n});\n```\n--\n\n### Events\n- **arcgisComplete** - Emitted when the component is complete.\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 is ready to be interacted with.\n- **arcgisSubmit** - Emitted when the component is submitted.\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.",
           "doc-url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-print/",
           "attributes": [
             {
@@ -10743,6 +10743,7 @@
             },
             {
               "name": "allowed-formats-for-saving",
+              "description": "Specifies the print output file format(s) that the user can select when saving the exported map printout.\nThis property can take a string value or an array of string values.",
               "value": {
                 "type": "\"all\""
               }
@@ -10842,7 +10843,7 @@
             },
             {
               "name": "print-service-url",
-              "description": "The URL of the REST endpoint of the Export Web Map Task.\nIf the [portal](#portal) property is set, it is not necessary to set this property.",
+              "description": "The URL of the REST endpoint of the Export Web Map Task.\nDefaults to the ArcGIS Online print service if this property is not specified.\nIf the [portal](#portal) property is set, this property will use the portal's print service URL.",
               "value": {
                 "type": "string"
               }
@@ -10863,7 +10864,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-PrintViewModel.html#state)",
+              "description": "The state of the Print component.",
               "default": "\"disabled\"",
               "value": {
                 "type": [
@@ -10878,7 +10879,8 @@
           "events": [
             {
               "name": "arcgisComplete",
-              "type": "{ link: FileLink; }"
+              "type": "{ link: FileLink; }",
+              "description": "Emitted when the component is complete."
             },
             {
               "name": "arcgisPropertyChange",
@@ -10892,7 +10894,8 @@
             },
             {
               "name": "arcgisSubmit",
-              "type": "{ link: FileLink; }"
+              "type": "{ link: FileLink; }",
+              "description": "Emitted when the component is submitted."
             }
           ],
           "js": {
@@ -10904,6 +10907,7 @@
               },
               {
                 "name": "allowedFormatsForSaving",
+                "description": "Specifies the print output file format(s) that the user can select when saving the exported map printout.\nThis property can take a string value or an array of string values.",
                 "type": "\"all\" | Array<string>"
               },
               {
@@ -10961,7 +10965,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -10980,7 +10984,7 @@
               },
               {
                 "name": "printServiceUrl",
-                "description": "The URL of the REST endpoint of the Export Web Map Task.\nIf the [portal](#portal) property is set, it is not necessary to set this property.",
+                "description": "The URL of the REST endpoint of the Export Web Map Task.\nDefaults to the ArcGIS Online print service if this property is not specified.\nIf the [portal](#portal) property is set, this property will use the portal's print service URL.",
                 "type": "string"
               },
               {
@@ -10998,7 +11002,7 @@
               },
               {
                 "name": "state",
-                "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-PrintViewModel.html#state)",
+                "description": "The state of the Print component.",
                 "type": "\"disabled\" | \"error\" | \"initializing\" | \"ready\""
               },
               {
@@ -11008,14 +11012,15 @@
               },
               {
                 "name": "templateOptions",
-                "description": "Defines the layout template options used by the [Print](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print.html) component to generate the print page.",
+                "description": "Defines the layout template options used by the Print component to generate the print page.",
                 "type": "TemplateOptions"
               }
             ],
             "events": [
               {
                 "name": "arcgisComplete",
-                "type": "{ link: FileLink; }"
+                "type": "{ link: FileLink; }",
+                "description": "Emitted when the component is complete."
               },
               {
                 "name": "arcgisPropertyChange",
@@ -11029,7 +11034,8 @@
               },
               {
                 "name": "arcgisSubmit",
-                "type": "{ link: FileLink; }"
+                "type": "{ link: FileLink; }",
+                "description": "Emitted when the component is submitted."
               }
             ]
           }
@@ -11139,7 +11145,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -11408,7 +11414,7 @@
         },
         {
           "name": "arcgis-scene",
-          "description": "The ArcGIS Scene component is used to add 3D maps to web applications. For 2D maps, use the\n[ArcGIS Map component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/).\n\nThe Scene component creates a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html)\nand loads a [WebScene](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html) item from either\n[ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).\n\n```html\n<arcgis-scene item-id=\"e2da7564e4f24eaaa918ffd70378056a\"></arcgis-scene>\n```\n\nAlternatively, the Scene component can be initialized without a WebScene item:\n\n```html\n<arcgis-scene\n basemap=\"satellite\"\n ground=\"world-elevation\"\n camera-position=\"12.3808, 46.3959, 4400\"\n camera-tilt=\"75\"\n camera-heading=\"300\">\n</arcgis-scene>\n```\n\nFurther components can be added and connected to the Scene component:\n\n```html\n<arcgis-scene item-id=\"e2da7564e4f24eaaa918ffd70378056a\">\n  <arcgis-layer-list position=\"bottom-right\"></arcgis-layer-list>\n</arcgis-scene>\n```\n\nThe Scene component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/api-reference/)\nof the ArcGIS Maps SDK for JavaScript.\n\n```js\nconst viewElement = document.querySelector(\"arcgis-scene\");\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n  const layer = new GraphicsLayer({ title: \"My layer\"});\n  viewElement.map.add(layer);\n});\n```\n\nSee also:\n- [SDK sample apps using the Scene component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-scene)\n- [Getting started](https://developers.arcgis.com/javascript/latest/get-started-overview/)\n- [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)\n--\n\n### Events\n- **arcgisViewChange** - This event is for view related property changes:\n[zoom](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#zoom),\n[scale](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#scale),\n[center](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#center),\n[rotation](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#rotation),\n[extent](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#extent),\n[camera](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#camera),\n[viewpoint](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#viewpoint).\nThis event will also emit if [stationary](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#stationary)\ntoggles from `true` to `false`.\n- **arcgisViewClick** - Fires after a user clicks on the view.\n\n```\nviewElement.addEventListener(\"arcgisViewClick\", (event) => {\n  viewElement.hitTest(event.detail).then((response) => {\n     const result = response.results[0];\n     // ....\n  });\n});\n```\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-click)\n- **arcgisViewDoubleClick** - Fires after double-clicking on the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-double-click)\n- **arcgisViewDrag** - Fires during a pointer drag on the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-drag)\n- **arcgisViewHold** - Fires after holding either a mouse button or a single finger on the view for a short amount of time.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-hold)\n- **arcgisViewImmediateClick** - Fires right after a user clicks on the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-immediate-click)\n- **arcgisViewImmediateDoubleClick** - Is emitted after two consecutive immediate-click events.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-immediate-double-click)\n- **arcgisViewKeyDown** - Fires after a keyboard key is pressed.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-key-down)\n- **arcgisViewKeyUp** - Fires after a keyboard key is released.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-key-up)\n- **arcgisViewLayerviewCreate** - Fires after each layer in the map has a corresponding LayerView created and rendered in the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-layerview-create)\n- **arcgisViewLayerviewCreateError** - Fires when an error emits during the creation of a LayerView after a layer has been added to the map.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-layerview-create-error)\n- **arcgisViewLayerviewDestroy** - Fires after a LayerView is destroyed and is no longer rendered in the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-layerview-destroy)\n- **arcgisViewMouseWheel** - Fires when a wheel button of a pointing device (typically a mouse) is scrolled on the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-mouse-wheel)\n- **arcgisViewPointerDown** - Fires after a mouse button is pressed, or a finger touches the display.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-pointer-down)\n- **arcgisViewPointerEnter** - Fires after a mouse cursor enters the view, or a display touch begins.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-pointer-enter)\n- **arcgisViewPointerLeave** - Fires after a mouse cursor leaves the view, or a display touch ends.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-pointer-leave)\n- **arcgisViewPointerMove** - Fires after the mouse or a finger on the display moves.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-pointer-move)\n- **arcgisViewPointerUp** - Fires after a mouse button is released, or a display touch ends.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-pointer-up)\n- **arcgisViewReadyChange** - This event is for the [ready](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#ready)\nproperty and will be emitted when the view is ready.\nThis event will also emit if the [map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) property is changed.\n\n```\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n   const layer = new GraphicsLayer({ title: \"My layer\"});\n   viewElement.map.add(layer);\n});\n```\n\n### Methods\n- `addLayer(layer: __esri.Layer | Promise<any>, index?: number): Promise<void>` - **Deprecated**: since 4.33. Use `element.map.add(layer)` instead.\n\nAdds a layer to the [map's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) `layers` collection.. \n- `addLayers(layers: __esri.Layer[], index?: number): Promise<void>` - **Deprecated**: since 4.33. Use `element.map.addMany([layer])` instead.\n\nAdds a layer or array of layers to the [map's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) `layers` collection.. \n- `addTable(table: __esri.FeatureLayer): Promise<void>` - **Deprecated**: since 4.33. Use `element.map.tables.add(table)` instead.\n\nAdds a table to the [map's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) `tables` collection.. \n- `addTables(tables: __esri.FeatureLayer[], index?: number): Promise<void>` - **Deprecated**: since 4.33. Use `element.map.tables.addMany([table])` instead.\n\nAdds a table or array of tables to the [map's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) `tables` collection.. \n- `closePopup(): Promise<void>` - Closes the [popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#popup).\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Destroys the Scene component, and any associated resources, including its\n[map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map),\n[popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#popup),\nand removes components or other UI DOM elements added to it.\n- `goTo(target: __esri.GoToTarget3D, options?: __esri.GoToOptions3D): Promise<unknown>` - Sets the view to a given target.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo)\n- `hitTest(screenPoint: __esri.SceneViewScreenPoint | MouseEvent, options?: __esri.SceneViewHitTestOptions): Promise<__esri.SceneViewHitTestResult>` - Returns [hit test results](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#HitTestResult)\nfrom each layer that intersects the specified screen coordinates.\n\n```\nviewElement.addEventListener(\"arcgisViewClick\", (event) => {\n  viewElement.hitTest(event.detail).then((response) => {\n     const result = response.results[0];\n     if (result?.type === \"graphic\") {\n        const { longitude, latitude } = result.mapPoint;\n        console.log(\"Hit graphic at (\" + longitude + \", \" + latitude + \")\", result.graphic);\n     } else {\n        console.log(\"Did not hit any graphic\");\n     }\n  });\n});\n```\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#hitTest)\n- `openPopup(options?: __esri.PopupViewOpenPopupOptions): Promise<void>` - Opens the popup based on input options.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#openPopup)\n- `takeScreenshot(options?: __esri.SceneViewTakeScreenshotOptions): Promise<__esri.SceneViewScreenshot>` - Creates a screenshot of the current view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#takeScreenshot)\n- `toMap(screenPoint: __esri.SceneViewScreenPoint | MouseEvent, options?: __esri.SceneViewToMapOptions): __esri.Point | nullish` - Converts the given screen point to a [map point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html).\n- `toScreen(point: __esri.Point): __esri.SceneViewScreenPoint` - Converts the given [map point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) to a screen point.\n- `tryFatalErrorRecovery(): Promise<void>` - Call this method to clear any fatal errors resulting from a lost WebGL context.\n- `viewOnReady(callback?: (): void, errback?: (error: Error) => void): Promise<void>` - `viewOnReady()` may be leveraged once an instance of the component is created and ready.\nThis method takes two input parameters: a `callback` function and an `errback` function.\n- `whenAnalysisView(analysis: __esri.AreaMeasurementAnalysis | __esri.DimensionAnalysis | __esri.DirectLineMeasurementAnalysis | __esri.LineOfSightAnalysis | __esri.SliceAnalysis | __esri.ViewshedAnalysis): Promise<__esri.AreaMeasurementAnalysisView3D | __esri.DimensionAnalysisView3D | __esri.DirectLineMeasurementAnalysisView3D | __esri.LineOfSightAnalysisView3D | __esri.SliceAnalysisView3D | __esri.ViewshedAnalysisView3D>` - Gets the analysis view created for the given analysis object.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenAnalysisView)\n- `whenLayerView(layer: __esri.Layer): Promise<__esri.LayerView>` - Gets the layer view created on the view for the given layer.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenLayerView)",
+          "description": "The ArcGIS Scene component is used to add 3D maps to web applications. For 2D maps, use the\n[ArcGIS Map component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/).\n\nThe Scene component creates a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html)\nand loads a [WebScene](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html) item from either\n[ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).\n\n```html\n<arcgis-scene item-id=\"e2da7564e4f24eaaa918ffd70378056a\"></arcgis-scene>\n```\n\nAlternatively, the Scene component can be initialized without a WebScene item:\n\n```html\n<arcgis-scene\n basemap=\"satellite\"\n ground=\"world-elevation\"\n camera-position=\"12.3808, 46.3959, 4400\"\n camera-tilt=\"75\"\n camera-heading=\"300\">\n</arcgis-scene>\n```\n\nFurther components can be added and connected to the Scene component:\n\n```html\n<arcgis-scene item-id=\"e2da7564e4f24eaaa918ffd70378056a\">\n  <arcgis-layer-list position=\"bottom-right\"></arcgis-layer-list>\n</arcgis-scene>\n```\n\nThe Scene component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/api-reference/)\nof the ArcGIS Maps SDK for JavaScript.\n\n```js\nconst viewElement = document.querySelector(\"arcgis-scene\");\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n  const layer = new GraphicsLayer({ title: \"My layer\"});\n  viewElement.map.add(layer);\n});\n```\n\nSee also:\n- [SDK sample apps using the Scene component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-scene)\n- [Getting started](https://developers.arcgis.com/javascript/latest/get-started-overview/)\n- [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)\n--\n\n### Events\n- **arcgisViewChange** - This event is for view related property changes:\n[zoom](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#zoom),\n[scale](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#scale),\n[center](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#center),\n[rotation](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#rotation),\n[extent](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#extent),\n[camera](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#camera),\n[viewpoint](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#viewpoint).\nThis event will also emit if [stationary](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#stationary)\ntoggles from `true` to `false`.\n- **arcgisViewClick** - Fires after a user clicks on the view.\n\n```js\nviewElement.addEventListener(\"arcgisViewClick\", (event) => {\n  viewElement.hitTest(event.detail).then((response) => {\n     const result = response.results[0];\n     // ....\n  });\n});\n```\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-click)\n- **arcgisViewDoubleClick** - Fires after double-clicking on the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-double-click)\n- **arcgisViewDrag** - Fires during a pointer drag on the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-drag)\n- **arcgisViewHold** - Fires after holding either a mouse button or a single finger on the view for a short amount of time.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-hold)\n- **arcgisViewImmediateClick** - Fires right after a user clicks on the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-immediate-click)\n- **arcgisViewImmediateDoubleClick** - Is emitted after two consecutive immediate-click events.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-immediate-double-click)\n- **arcgisViewKeyDown** - Fires after a keyboard key is pressed.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-key-down)\n- **arcgisViewKeyUp** - Fires after a keyboard key is released.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-key-up)\n- **arcgisViewLayerviewCreate** - Fires after each layer in the map has a corresponding LayerView created and rendered in the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-layerview-create)\n- **arcgisViewLayerviewCreateError** - Fires when an error emits during the creation of a LayerView after a layer has been added to the map.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-layerview-create-error)\n- **arcgisViewLayerviewDestroy** - Fires after a LayerView is destroyed and is no longer rendered in the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-layerview-destroy)\n- **arcgisViewMouseWheel** - Fires when a wheel button of a pointing device (typically a mouse) is scrolled on the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-mouse-wheel)\n- **arcgisViewPointerDown** - Fires after a mouse button is pressed, or a finger touches the display.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-pointer-down)\n- **arcgisViewPointerEnter** - Fires after a mouse cursor enters the view, or a display touch begins.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-pointer-enter)\n- **arcgisViewPointerLeave** - Fires after a mouse cursor leaves the view, or a display touch ends.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-pointer-leave)\n- **arcgisViewPointerMove** - Fires after the mouse or a finger on the display moves.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-pointer-move)\n- **arcgisViewPointerUp** - Fires after a mouse button is released, or a display touch ends.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-pointer-up)\n- **arcgisViewReadyChange** - This event is for the [ready](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#ready)\nproperty and will be emitted when the view is ready.\nThis event will also emit if the [map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) property is changed.\n\n```js\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n   const layer = new GraphicsLayer({ title: \"My layer\"});\n   viewElement.map.add(layer);\n});\n```\n\n### Methods\n- `addLayer(layer: __esri.Layer | Promise<any>, index?: number): Promise<void>` - **Deprecated**: since 4.33. Use `element.map.add(layer)` instead.\n\nAdds a layer to the [map's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) `layers` collection.. \n- `addLayers(layers: __esri.Layer[], index?: number): Promise<void>` - **Deprecated**: since 4.33. Use `element.map.addMany([layer])` instead.\n\nAdds a layer or array of layers to the [map's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) `layers` collection.. \n- `addTable(table: __esri.FeatureLayer): Promise<void>` - **Deprecated**: since 4.33. Use `element.map.tables.add(table)` instead.\n\nAdds a table to the [map's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) `tables` collection.. \n- `addTables(tables: __esri.FeatureLayer[], index?: number): Promise<void>` - **Deprecated**: since 4.33. Use `element.map.tables.addMany([table])` instead.\n\nAdds a table or array of tables to the [map's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) `tables` collection.. \n- `closePopup(): Promise<void>` - Closes the [popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#popup).\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Destroys the Scene component, and any associated resources, including its\n[map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map),\n[popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#popup),\nand removes components or other UI DOM elements added to it.\n- `goTo(target: __esri.GoToTarget3D, options?: __esri.GoToOptions3D): Promise<unknown>` - Sets the view to a given target.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo)\n- `hitTest(screenPoint: __esri.SceneViewScreenPoint | MouseEvent, options?: __esri.SceneViewHitTestOptions): Promise<__esri.SceneViewHitTestResult>` - Returns [hit test results](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#HitTestResult)\nfrom each layer that intersects the specified screen coordinates.\n\n```js\nviewElement.addEventListener(\"arcgisViewClick\", (event) => {\n  viewElement.hitTest(event.detail).then((response) => {\n     const result = response.results[0];\n     if (result?.type === \"graphic\") {\n        const { longitude, latitude } = result.mapPoint;\n        console.log(\"Hit graphic at (\" + longitude + \", \" + latitude + \")\", result.graphic);\n     } else {\n        console.log(\"Did not hit any graphic\");\n     }\n  });\n});\n```\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#hitTest)\n- `openPopup(options?: __esri.PopupViewOpenPopupOptions): Promise<void>` - Opens the popup based on input options.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#openPopup)\n- `takeScreenshot(options?: __esri.SceneViewTakeScreenshotOptions): Promise<__esri.SceneViewScreenshot>` - Creates a screenshot of the current view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#takeScreenshot)\n- `toMap(screenPoint: __esri.SceneViewScreenPoint | MouseEvent, options?: __esri.SceneViewToMapOptions): __esri.Point | nullish` - Converts the given screen point to a [map point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html).\n- `toScreen(point: __esri.Point): __esri.SceneViewScreenPoint` - Converts the given [map point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) to a screen point.\n- `tryFatalErrorRecovery(): Promise<void>` - Call this method to clear any fatal errors resulting from a lost WebGL context.\n- `viewOnReady(callback?: (): void, errback?: (error: Error) => void): Promise<void>` - `viewOnReady()` may be leveraged once an instance of the component is created and ready.\nThis method takes two input parameters: a `callback` function and an `errback` function.\n- `whenAnalysisView(analysis: __esri.AreaMeasurementAnalysis | __esri.DimensionAnalysis | __esri.DirectLineMeasurementAnalysis | __esri.LineOfSightAnalysis | __esri.SliceAnalysis | __esri.ViewshedAnalysis): Promise<__esri.AreaMeasurementAnalysisView3D | __esri.DimensionAnalysisView3D | __esri.DirectLineMeasurementAnalysisView3D | __esri.LineOfSightAnalysisView3D | __esri.SliceAnalysisView3D | __esri.ViewshedAnalysisView3D>` - Gets the analysis view created for the given analysis object.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenAnalysisView)\n- `whenLayerView(layer: __esri.Layer): Promise<__esri.LayerView>` - Gets the layer view created on the view for the given layer.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenLayerView)",
           "doc-url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/",
           "attributes": [
             {
@@ -11553,7 +11559,7 @@
             {
               "name": "arcgisViewClick",
               "type": "ViewClickEvent",
-              "description": "Fires after a user clicks on the view.\n\n```\nviewElement.addEventListener(\"arcgisViewClick\", (event) => {\n  viewElement.hitTest(event.detail).then((response) => {\n     const result = response.results[0];\n     // ....\n  });\n});\n```\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-click)"
+              "description": "Fires after a user clicks on the view.\n\n```js\nviewElement.addEventListener(\"arcgisViewClick\", (event) => {\n  viewElement.hitTest(event.detail).then((response) => {\n     const result = response.results[0];\n     // ....\n  });\n});\n```\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-click)"
             },
             {
               "name": "arcgisViewDoubleClick",
@@ -11638,7 +11644,7 @@
             {
               "name": "arcgisViewReadyChange",
               "type": "void",
-              "description": "This event is for the [ready](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#ready)\nproperty and will be emitted when the view is ready.\nThis event will also emit if the [map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) property is changed.\n\n```\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n   const layer = new GraphicsLayer({ title: \"My layer\"});\n   viewElement.map.add(layer);\n});\n```"
+              "description": "This event is for the [ready](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#ready)\nproperty and will be emitted when the view is ready.\nThis event will also emit if the [map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) property is changed.\n\n```js\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n   const layer = new GraphicsLayer({ title: \"My layer\"});\n   viewElement.map.add(layer);\n});\n```"
             }
           ],
           "js": {
@@ -11745,7 +11751,7 @@
               },
               {
                 "name": "graphics",
-                "description": "Allows for adding graphics directly to the default graphics in the view.\nExamples:\n```\n// Adds a graphic to the View\ngraphics.add(pointGraphic);\n// Removes a graphic from the View\ngraphics.remove(pointGraphic);\n```",
+                "description": "Allows for adding graphics directly to the default graphics in the view.",
                 "type": "Collection<Graphic>"
               },
               {
@@ -11908,7 +11914,7 @@
               {
                 "name": "arcgisViewClick",
                 "type": "ViewClickEvent",
-                "description": "Fires after a user clicks on the view.\n\n```\nviewElement.addEventListener(\"arcgisViewClick\", (event) => {\n  viewElement.hitTest(event.detail).then((response) => {\n     const result = response.results[0];\n     // ....\n  });\n});\n```\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-click)"
+                "description": "Fires after a user clicks on the view.\n\n```js\nviewElement.addEventListener(\"arcgisViewClick\", (event) => {\n  viewElement.hitTest(event.detail).then((response) => {\n     const result = response.results[0];\n     // ....\n  });\n});\n```\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-click)"
               },
               {
                 "name": "arcgisViewDoubleClick",
@@ -11993,7 +11999,7 @@
               {
                 "name": "arcgisViewReadyChange",
                 "type": "void",
-                "description": "This event is for the [ready](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#ready)\nproperty and will be emitted when the view is ready.\nThis event will also emit if the [map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) property is changed.\n\n```\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n   const layer = new GraphicsLayer({ title: \"My layer\"});\n   viewElement.map.add(layer);\n});\n```"
+                "description": "This event is for the [ready](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#ready)\nproperty and will be emitted when the view is ready.\nThis event will also emit if the [map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) property is changed.\n\n```js\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n   const layer = new GraphicsLayer({ title: \"My layer\"});\n   viewElement.map.add(layer);\n});\n```"
               }
             ]
           }
@@ -12312,7 +12318,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -13502,7 +13508,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -13515,7 +13521,7 @@
               },
               {
                 "name": "shape",
-                "description": "The shape used to slice elements in a 3D scene. Currently the only supported shape is a plane.\nExample:\n```\n// Clone the shape to modify its properties\nconst shape = slice.shape.clone();\n// Set new values for heading and tilt\nshape.heading = 180;\nshape.tilt = 45;\n// Apply the new shape to the slice component's shape\nslice.shape = shape;\n```",
+                "description": "The shape used to slice elements in a 3D scene. Currently the only supported shape is a plane.",
                 "type": "SlicePlane"
               },
               {
@@ -14144,7 +14150,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -14912,7 +14918,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -15112,7 +15118,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -16481,7 +16487,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -16713,7 +16719,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -16876,7 +16882,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {
@@ -17017,7 +17023,7 @@
               },
               {
                 "name": "messageOverrides",
-                "description": "Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.",
+                "description": "Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._",
                 "type": "Record<string, unknown>"
               },
               {

package/dist/index.js

@@ -1,7 +1,7 @@
 import { s, g as t } from "./chunks/runtime.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.13 */
+v4.34.0-next.15 */
 const a = s, A = t;
 export {
   A as getArcgisAssetPath,

package/dist/loader.js

@@ -2,7 +2,7 @@ import { r as e } from "./chunks/runtime.js";
 import { makeDefineCustomElements as t } from "@arcgis/lumina";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.13 */
+v4.34.0-next.15 */
 const a = t(e, {
   "arcgis-area-measurement-2d": [() => import("./components/arcgis-area-measurement-2d/customElement.js"), "autoDestroyDisabled,icon,label,position,referenceElement,snappingOptions:,state,unit,unitOptions:;clear,destroy,start"],
   "arcgis-area-measurement-3d": [() => import("./components/arcgis-area-measurement-3d/customElement.js"), "analysis:,autoDestroyDisabled,icon,label,position,referenceElement,state,unit,unitOptions:;clear,destroy,start"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/map-components",
-  "version": "4.34.0-next.13",
+  "version": "4.34.0-next.15",
   "description": "ArcGIS Map Components",
   "keywords": [
     "ArcGIS",
@@ -42,8 +42,8 @@
   ],
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
-    "@arcgis/components-utils": "4.34.0-next.13",
-    "@arcgis/lumina": "4.34.0-next.13",
+    "@arcgis/components-utils": "4.34.0-next.15",
+    "@arcgis/lumina": "4.34.0-next.15",
     "tslib": "^2.8.1"
   },
   "peerDependencies": {

package/dist/cdn/7HOUHZTH.js

@@ -1,4 +0,0 @@
-/*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.13 */
-import{b as g}from"./PKV4IZSQ.js";import{a as d}from"./HBM2N4EV.js";import e from"./OHK44ALB.js";import{a as C}from"./KZP3I3SM.js";import{a as x}from"./HPQSE5N6.js";import c from"./ZBGOIYVF.js";import a from"./O3YAO4TF.js";import{e as b}from"./PEYYMW25.js";import"./RUBT5TK2.js";import"./RL474BTU.js";import{A as w,D as S,O as M,P as l,R as f,T as $,a as m,i as _,j as r,o as v}from"./ZXYDIIFW.js";export default $arcgis.t(([A,{isAbortError:T},{substitute:D},{watch:E},,{a:a},R])=>{var h="arcgis-search",u={base:h,autocomplete:`${h}__autocomplete`,dropdown:`${h}__dropdown`,container:`${h}__container`,form:`${h}__form`},I=_`@layer{arcgis-search{display:block}.arcgis-search{--arcgis-internal-search-width: 240px;display:flex;flex-flow:row nowrap;align-items:center;justify-content:center;width:var(--arcgis-internal-search-width)}.arcgis-search__dropdown{--calcite-color-border-1: var(--calcite-color-border-input);--calcite-dropdown-width: var(--arcgis-internal-search-width);width:31px}.arcgis-search__autocomplete{flex:1}.arcgis-search__container{display:flex;position:relative;flex:1 0 100%;flex-flow:row nowrap;align-items:stretch}.arcgis-search__form{display:flex;flex:1 0;flex-flow:row nowrap;align-items:stretch;margin:0;padding:0}}`,N=R(A),p=class extends M{constructor(){super(...arguments),this.viewModel=N(this),this._currentLocationValue="search-use-current-location",this._autocompleteEl=void 0,this._searchResultRendererContainerEl=document.createElement("div"),this._searchResultRendererEl=void 0,this._suggestController=void 0,this._searchController=void 0,this._lastSearchTerm="",this.messages=C({}),this._setSearchResultRendererRef=e=>{this._searchResultRendererEl=e},this._locateFailed=!1,this._showNoResults=!1,this.position="top-left",this.goToOverride=this.viewModel.goToOverride,this.icon="search",this.activeMenu="none",this.activeSourceIndex=this.viewModel.activeSourceIndex,this.allPlaceholder=this.viewModel.allPlaceholder,this.allSources=this.viewModel.allSources,this.autoNavigate=this.viewModel.autoNavigate,this.autoSelectDisabled=this.viewModel.autoSelect,this.defaultSources=this.viewModel.defaultSources,this.disabled=!1,this.includeDefaultSourcesDisabled=this.viewModel.includeDefaultSources,this.locationDisabled=this.viewModel.locationEnabled,this.maxResults=this.viewModel.maxResults,this.maxSuggestions=this.viewModel.maxSuggestions,this.minSuggestCharacters=this.viewModel.minSuggestCharacters,this.popupDisabled=this.viewModel.popupEnabled,this.popupTemplate=this.viewModel.popupTemplate,this.portal=this.viewModel.portal,this.resultGraphic=this.viewModel.resultGraphic,this.resultGraphicDisabled=this.viewModel.resultGraphicEnabled,this.results=this.viewModel.results,this.searchAllDisabled=this.viewModel.searchAllEnabled,this.searchTerm=this.viewModel.searchTerm,this.selectedResult=this.viewModel.selectedResult,this.sources=this.viewModel.sources,this.suggestions=this.viewModel.suggestions,this.suggestionsDisabled=this.viewModel.suggestionsEnabled,this.autoDestroyDisabled=!1,this.state=this.viewModel.state,this.arcgisPropertyChange=b()("state"),this.arcgisReady=w(),this.arcgisSearchClear=a(()=>this.viewModel,"search-clear"),this.arcgisSearchComplete=a(()=>this.viewModel,"search-complete"),this.arcgisSearchStart=a(()=>this.viewModel,"search-start"),this.arcgisSelectResult=a(()=>this.viewModel,"select-result"),this.arcgisSuggestComplete=a(()=>this.viewModel,"suggest-complete"),this.arcgisSuggestStart=a(()=>this.viewModel,"suggest-start"),this._renderSearchResultsContent=()=>this._searchResultRendererEl}static{this.properties={_locateFailed:16,_showNoResults:16,_isDisabled:16,_showCurrentLocation:16,_effectiveActiveMenu:16,referenceElement:1,position:3,goToOverride:0,icon:1,activeMenu:1,activeSource:32,activeSourceIndex:9,allPlaceholder:1,allSources:0,autoNavigate:5,autoSelectDisabled:5,defaultSources:0,disabled:5,includeDefaultSourcesDisabled:5,locationDisabled:5,maxResults:9,maxSuggestions:9,minSuggestCharacters:9,popupDisabled:5,popupTemplate:0,portal:0,resultGraphic:0,resultGraphicDisabled:5,results:0,searchAllDisabled:5,searchTerm:1,selectedResult:0,sources:0,suggestions:0,suggestionsDisabled:5,autoDestroyDisabled:5,messageOverrides:0,label:1,state:3}}static{this.styles=I}static{this.shadowRootOptions=S}get _isDisabled(){let{state:e}=this.viewModel;return e==="disabled"||e==="loading"||this.disabled}get _showCurrentLocation(){return!this.locationDisabled&&!this.searchTerm?.trim()}get _effectiveActiveMenu(){return this._isDisabled?"none":this.activeMenu}get activeSource(){return this.viewModel?.activeSource}clear(){this._locateFailed=!1,this.viewModel.clear()}async destroy(){await this.manager.destroy(),await this._searchResultRendererEl?.destroy(),this._cancelQueries()}async search(e){this._cancelQueries();let t=new AbortController,{signal:s}=t;this._searchController=t;try{let i=await this.viewModel.search(e,{signal:s});return this._searchController!==t?void 0:(i?.numResults||(this._showNoResults=!0,this.activeMenu="suggestion"),this._searchController=void 0,i)}catch{if(this._searchController!==t)return;this._searchController=void 0;return}}async suggest(e){this._cancelSuggest();let t=new AbortController,{signal:s}=t;this._suggestController=t;try{let i=await this.viewModel.suggest(e,null,{signal:s});return this._suggestController!==t?void 0:(this._suggestController=void 0,i?.numResults&&(this.activeMenu="suggestion",this._scrollToTopSuggestion()),i)}catch{return this._suggestController!==t||(this._suggestController=void 0),null}}async setFocus(){await this._autocompleteEl?.setFocus()}loaded(){this._addSearchResultRenderer(),this.manager.onLifecycle(()=>E(()=>this.viewModel?.defaultPopupTemplate,e=>{e&&(e.content=this._renderSearchResultsContent)},{initial:!0}))}_addSearchResultRenderer(){v(r`<arcgis-search-result-renderer auto-destroy-disabled .messages=${this.messages} .viewModel=${this.viewModel} ${g(this._setSearchResultRendererRef)}></arcgis-search-result-renderer>`,this._searchResultRendererContainerEl)}_handleInputKeydown(e){e.key==="Tab"&&this._cancelSuggest()}_handleAutocompleteCreate(e){this._autocompleteEl=e}_handleCalciteAutocompleteTextInput(e){let t=e.target.inputValue;t!==this.viewModel.searchTerm&&(this.viewModel.searchTerm=t,t||this.clear(),this.suggest())}_handleAutocompleteOpen(){this.activeMenu="suggestion"}_handleAutocompleteClose(){this.activeMenu==="suggestion"&&(this.activeMenu="none")}_handleCalciteAutocompleteChange(e){let t=e.target.value;if(t===this._currentLocationValue){this._useCurrentLocation();return}let s=JSON.parse(t),i=this.viewModel.suggestions?.find(({sourceIndex:o})=>o===s.sourceIndex)?.results?.find(({key:o})=>`${o}`==`${s.key}`);i&&this.search(i)}async _useCurrentLocation(){this._cancelQueries();let e=new AbortController,{signal:t}=e;this._searchController=e;try{await this.viewModel.searchNearby({signal:t})}catch(s){T(s)||(this._locateFailed=!0,this.activeMenu="suggestion")}finally{this._searchController=void 0}}_handleSourceOpen(){this.activeMenu="source"}_handleSourceClose(){this.activeMenu==="source"&&(this.activeMenu="none")}_handleSourceSelect(e){let t=e.target.selectedItems[0].getAttribute("data-source-index");t&&(this.viewModel.activeSourceIndex=Number.parseInt(t,10))}_cancelSuggest(){this.activeMenu="none",this._locateFailed=!1,this._showNoResults=!1,this._suggestController=d(this._suggestController)}_cancelQueries(){this._cancelSuggest(),this._searchController=d(this._searchController)}_scrollToTopSuggestion(){this._autocompleteEl?.scrollContentTo({top:0})}_formSubmit(e){e.preventDefault(),this.activeMenu="none",this._lastSearchTerm=this.searchTerm,this.searchTerm&&this.search()}_getSourceName(e){let{messages:t}=this,{allSources:s}=this.viewModel,i=s.at(e);return(e===-1?t.all:i?.name||t.untitledSource)||""}render(){return r`<div class=${l(m(u.base,x.widget))}><div class=${l(u.container)}>${this._renderSourcesMenu()}${this._renderForm()}</div></div>`}_renderSourcesMenu(){let{messages:e,_isDisabled:t,_effectiveActiveMenu:s}=this,{allSources:i,searchAllEnabled:o}=this.viewModel;return i.length>1?r`<calcite-dropdown class=${l(u.dropdown)} .disabled=${t} .open=${s==="source"} overlay-positioning=fixed @calciteDropdownClose=${this._handleSourceClose} @calciteDropdownOpen=${this._handleSourceOpen} @calciteDropdownSelect=${this._handleSourceSelect}><calcite-button appearance=outline-fill icon-start=caret-down kind=neutral .label=${e.searchIn} slot=trigger></calcite-button><calcite-dropdown-group .groupTitle=${e.searchIn}>${o?this._renderSource(-1):null}${i.map((c,n)=>this._renderSource(n)).toArray()}</calcite-dropdown-group></calcite-dropdown>`:null}_renderUseCurrentLocation(){let{_currentLocationValue:e}=this;return r`<calcite-autocomplete-item .heading=${this.messages.useCurrentLocation??""} icon-start=gps-on .value=${e}></calcite-autocomplete-item>`}_renderAutocomplete(){let{_effectiveActiveMenu:e,messages:t,_isDisabled:s}=this,{maxInputLength:i,placeholder:o,searchTerm:c,state:n}=this.viewModel,y=this.label??t.searchButtonTitle??"";return r`<calcite-autocomplete .autocomplete=${"off"} class=${l(u.autocomplete)} .disabled=${s} .icon=${this.icon} .inputValue=${c} .label=${y} .loading=${n==="searching"} .maxLength=${i} .name=${this.el.id} @keydown=${this._handleInputKeydown} .open=${e==="suggestion"} overlay-positioning=fixed .placeholder=${o} title=${(c?"":o)??f} @calciteAutocompleteChange=${this._handleCalciteAutocompleteChange} @calciteAutocompleteClose=${this._handleAutocompleteClose} @calciteAutocompleteOpen=${this._handleAutocompleteOpen} @calciteAutocompleteTextChange=${this._handleCalciteAutocompleteTextInput} @calciteAutocompleteTextInput=${this._handleCalciteAutocompleteTextInput} ${g(this._handleAutocompleteCreate)}>${this._renderSuggestions()}${this._renderNotices()}</calcite-autocomplete>`}_renderForm(){return r`<form class=${l(u.form)} @submit=${this._formSubmit} role=search>${this._renderAutocomplete()}</form>`}_renderSuggestGroup(e){return e.results?.map(t=>this._renderSuggestion(t))}_renderSuggestions(){let{suggestions:e}=this.viewModel;return this._showNoResults?null:this._showCurrentLocation?this._renderUseCurrentLocation():e?.map(t=>this._renderSuggestResults(t))}_renderSuggestResults(e){let{allSources:t,activeSourceIndex:s}=this.viewModel,{sourceIndex:i}=e,o=e.results?.length,c=t.length>1&&s===-1,n=this._getSourceName(i);return o&&c?r`<calcite-autocomplete-item-group .heading=${n}>${this._renderSuggestGroup(e)}</calcite-autocomplete-item-group>`:this._renderSuggestGroup(e)}_renderSuggestion({key:e,sourceIndex:t,text:s}){let i={key:e,sourceIndex:t};return r`<calcite-autocomplete-item .heading=${s??this.messages.untitledResult??""} .value=${JSON.stringify(i)}></calcite-autocomplete-item>`}_renderSource(e){let t=this._getSourceName(e);return r`<calcite-dropdown-item data-source-index=${`${e}`} .selected=${e===this.viewModel.activeSourceIndex}>${t}</calcite-dropdown-item>`}_renderNoResultsWarning(e){let{messages:t}=this,s=e?D(t.noResultsFoundForValue??"",{value:`"${e}"`}):t.noResultsFound;return r`<calcite-notice icon=exclamation-mark-triangle kind=warning open slot=content-bottom><div slot=title>${t.noResults}</div><div slot=message>${s}</div></calcite-notice>`}_renderLocateError(){return r`<calcite-notice icon=exclamation-mark-circle kind=danger open slot=content-bottom><div slot=message>${this.messages.locateError}</div></calcite-notice>`}_renderNotices(){return this._locateFailed?this._renderLocateError():this._showNoResults?this._renderNoResultsWarning(this._lastSearchTerm??this.viewModel.searchTerm):null}};$("arcgis-search",p);return p},"widgets/Search/SearchViewModel","core/promiseUtils","intl","core/reactiveUtils",a,c,e)

package/dist/cdn/AQA4KDNM.js

@@ -1,4 +0,0 @@
-/*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.13 */
-import{O as o,T as n,i as s,j as t}from"./ZXYDIIFW.js";export default $arcgis.t(([d,{watch:v}])=>{var $=s`.arcgis-video-player__settings-flow{min-width:var(--calcite-size-160)}`,g=["Auto"],_=[{label:"0.25x",value:.25},{label:"0.5x",value:.5},{label:"1x",value:1},{label:"1.5x",value:1.5},{label:"2x",value:2}],r=new d([255,127,0]),a=class extends o{constructor(){super(...arguments),this._color=null,this._speed="1x",this._quality="Auto",this._disabled=!1}static{this.properties={_disabled:16,_active:16,viewModel:0,messages:0}}static{this.styles=$}loaded(){this.manager.onLifecycle(()=>[v(()=>this.viewModel.state,l=>{this._disabled=l==="not-ready"||l==="waiting"},{initial:!0})])}render(){let{viewModel:l,messages:e}=this,h=t`<calcite-flow-item .heading=${e.playbackSpeed} .selected=${this._active==="speed"} @calciteFlowItemBack=${()=>this._active=void 0}><calcite-list .label=${e.playbackSpeed} selection-mode=single-persist>${_.map(({label:i,value:c})=>t`<calcite-list-item .label=${i} @click=${()=>{this._speed=i,l.changePlaybackSpeed(c)}} .selected=${i===this._speed}></calcite-list-item>`)}</calcite-list></calcite-flow-item>`,p=t`<calcite-flow-item .heading=${e.quality} .selected=${this._active==="quality"} @calciteFlowItemBack=${()=>this._active=void 0}><calcite-list .label=${e.quality} selection-mode=single-persist>${g.map(i=>t`<calcite-list-item .label=${i} @click=${()=>this._quality=i} .selected=${i===this._quality}></calcite-list-item>`)}</calcite-list></calcite-flow-item>`,m=t`<calcite-flow-item .heading=${e.graphics} .selected=${this._active==="color"} @calciteFlowItemBack=${()=>this._active=void 0}><calcite-block .heading=${e.color} open><calcite-color-picker channels-disabled format=hex saved-disabled scale=s .value=${this._color?.toHex()??r.toHex()} @calciteColorPickerChange=${({currentTarget:i})=>{let c=i.value?.toString()??null;this._color=c?new d(c):null,this._color&&l.changeGraphicsColor(this._color)}}></calcite-color-picker></calcite-block></calcite-flow-item>`;return t`<div><calcite-popover auto-close .label=${e.settings} overlay-positioning=fixed placement=top-end pointer-disabled reference-element=settings-action scale=s @calcitePopoverClose=${()=>this._active=void 0}><calcite-flow class=arcgis-video-player__settings-flow><calcite-flow-item heading=Settings .selected=${!this._active}><calcite-list .label=${e.settings}><calcite-list-item .label=${e.speed} @click=${()=>this._active="speed"}><div slot=content-end><calcite-chip .label=${this._speed} scale=s>${this._speed}</calcite-chip></div><calcite-icon icon=chevron-right scale=s slot=content-end></calcite-icon></calcite-list-item><calcite-list-item .label=${e.quality} @click=${()=>this._active="quality"}><div slot=content-end><calcite-chip .label=${this._quality} scale=s>${this._quality}</calcite-chip></div><calcite-icon icon=chevron-right scale=s slot=content-end></calcite-icon></calcite-list-item><calcite-list-item .label=${e.graphics} @click=${()=>this._active="color"}><calcite-color-picker-swatch .color=${this._color?.toString()??r.toString()} scale=s slot=content-end></calcite-color-picker-swatch><calcite-icon icon=chevron-right scale=s slot=content-end></calcite-icon></calcite-list-item></calcite-list></calcite-flow-item>${this._active==="speed"?h:null}${this._active==="quality"?p:null}${this._active==="color"?m:null}</calcite-flow></calcite-popover><calcite-action alignment=center .disabled=${this._disabled} icon=sliders id=settings-action scale=s slot=trigger .text=${e.settings}></calcite-action></div>`}};n("arcgis-video-player-settings",a);return a},"Color","core/reactiveUtils")