@arcgis/map-components 5.0.0-next.4 → 5.0.0-next.6

package/dist/docs/api.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-09-29T04:41:47",
+  "timestamp": "2025-10-01T04:36:32",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "5.0.0-next.4",
+    "version": "5.0.0-next.6",
     "typescriptVersion": "5.8.3"
   },
   "schemaVersion": "1.0.0",
@@ -412,7 +412,7 @@
               "name": "unitOptions",
               "description": "List of available units and unit systems (imperial, metric) for displaying the area values.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D.html#unitOptions)",
               "type": {
-                "text": "Array<\"metric\" | \"imperial\" | \"square-millimeters\" | \"square-centimeters\" | \"square-decimeters\" | \"square-meters\" | \"square-kilometers\" | \"square-inches\" | \"square-feet\" | \"square-yards\" | \"square-miles\" | \"square-nautical-miles\" | \"square-us-feet\" | \"acres\" | \"ares\" | \"hectares\">",
+                "text": "Array<\"imperial\" | \"metric\" | \"square-millimeters\" | \"square-centimeters\" | \"square-decimeters\" | \"square-meters\" | \"square-kilometers\" | \"square-inches\" | \"square-feet\" | \"square-yards\" | \"square-miles\" | \"square-nautical-miles\" | \"square-us-feet\" | \"acres\" | \"ares\" | \"hectares\">",
                 "references": [
                   {
                     "name": "Array",
@@ -1079,7 +1079,7 @@
               "name": "unitOptions",
               "description": "List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.\nBy default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.\nPossible [unit](#unit) values can only be a subset of this list.",
               "type": {
-                "text": "Array<\"metric\" | \"imperial\" | \"square-millimeters\" | \"square-centimeters\" | \"square-decimeters\" | \"square-meters\" | \"square-kilometers\" | \"square-inches\" | \"square-feet\" | \"square-yards\" | \"square-miles\" | \"square-nautical-miles\" | \"square-us-feet\" | \"acres\" | \"ares\" | \"hectares\">",
+                "text": "Array<\"imperial\" | \"metric\" | \"square-millimeters\" | \"square-centimeters\" | \"square-decimeters\" | \"square-meters\" | \"square-kilometers\" | \"square-inches\" | \"square-feet\" | \"square-yards\" | \"square-miles\" | \"square-nautical-miles\" | \"square-us-feet\" | \"acres\" | \"ares\" | \"hectares\">",
                 "references": [
                   {
                     "name": "Array",
@@ -9275,7 +9275,7 @@
               "name": "arcgisPropertyChange",
               "description": "Emitted when the value of a property is changed. Use this to listen to changes to properties.",
               "type": {
-                "text": "{ name: \"state\" | \"mode\" | \"expanded\" | \"currentLocation\"; }"
+                "text": "{ name: \"state\" | \"expanded\" | \"mode\" | \"currentLocation\"; }"
               }
             },
             {
@@ -12425,7 +12425,7 @@
               "name": "unitOptions",
               "description": "List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.\nBy default, the following units are included: `metric`, `imperial`, `inches`, `feet`, `us-feet`, `yards`, `miles`, `nautical-miles`, `meters`, `kilometers`.\nPossible [unit](#unit) values can only be a subset of this list.",
               "type": {
-                "text": "Array<\"meters\" | \"metric\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\" | \"imperial\">",
+                "text": "Array<\"imperial\" | \"metric\" | \"meters\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\">",
                 "references": [
                   {
                     "name": "Array",
@@ -13091,7 +13091,7 @@
               "name": "unitOptions",
               "description": "List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.\nBy default, the following units are included: `metric`, `imperial`, `inches`, `feet`, `us-feet`, `yards`, `miles`, `nautical-miles`, `meters`, `kilometers`.\nPossible [unit](#unit) values can only be a subset of this list.",
               "type": {
-                "text": "Array<\"meters\" | \"metric\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\" | \"imperial\">",
+                "text": "Array<\"imperial\" | \"metric\" | \"meters\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\">",
                 "references": [
                   {
                     "name": "Array",
@@ -13786,7 +13786,7 @@
               "name": "unitOptions",
               "description": "List of available units and unit systems (imperial, metric) for displaying the distance values.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-DistanceMeasurement2D.html#unitOptions)",
               "type": {
-                "text": "Array<\"meters\" | \"metric\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\" | \"imperial\">",
+                "text": "Array<\"imperial\" | \"metric\" | \"meters\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\">",
                 "references": [
                   {
                     "name": "Array",
@@ -15896,7 +15896,7 @@
               "name": "unitOptions",
               "description": "List of available units and unit systems (imperial, metric) for displaying the elevation and distance values.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#unitOptions)",
               "type": {
-                "text": "Array<\"meters\" | \"metric\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\" | \"imperial\">",
+                "text": "Array<\"imperial\" | \"metric\" | \"meters\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\">",
                 "references": [
                   {
                     "name": "Array",
@@ -16292,7 +16292,7 @@
               "name": "arcgisPropertyChange",
               "description": "Emitted when the value of a property is changed. Use this to listen to changes to properties.",
               "type": {
-                "text": "{ name: \"state\" | \"input\" | \"progress\" | \"effectiveUnits\"; }"
+                "text": "{ name: \"input\" | \"progress\" | \"state\" | \"effectiveUnits\"; }"
               }
             },
             {
@@ -17079,7 +17079,7 @@
               "name": "unitOptionsDistance",
               "description": "List of available units and unit systems (imperial, metric) for displaying the distance values. These are the\noptions displayed in the distance unit selector in the settings popover.",
               "type": {
-                "text": "Array<\"meters\" | \"metric\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\" | \"imperial\">",
+                "text": "Array<\"imperial\" | \"metric\" | \"meters\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\">",
                 "references": [
                   {
                     "name": "Array",
@@ -17096,7 +17096,7 @@
               "name": "unitOptionsElevation",
               "description": "List of available units and unit systems (imperial, metric) for displaying the elevation values. These are the\noptions displayed in the elevation unit selector in the settings popover.",
               "type": {
-                "text": "Array<\"meters\" | \"metric\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\" | \"imperial\">",
+                "text": "Array<\"imperial\" | \"metric\" | \"meters\" | \"centimeters\" | \"decimeters\" | \"feet\" | \"inches\" | \"kilometers\" | \"millimeters\" | \"nautical-miles\" | \"us-feet\" | \"yards\" | \"miles\">",
                 "references": [
                   {
                     "name": "Array",
@@ -17552,7 +17552,7 @@
               "name": "arcgisPropertyChange",
               "description": "Emitted when the value of a property is changed. Use this to listen to changes to properties.",
               "type": {
-                "text": "{ name: \"state\" | \"progress\" | \"geometry\" | \"effectiveDisplayUnits\"; }"
+                "text": "{ name: \"progress\" | \"state\" | \"geometry\" | \"effectiveDisplayUnits\"; }"
               }
             },
             {
@@ -18808,7 +18808,7 @@
               "name": "flowItems",
               "description": "A collection of flow items that are used to manage drill-in navigation.",
               "type": {
-                "text": "Collection<HTMLArcgisFeatureElement | HTMLArcgisFeatureRelationshipElement>",
+                "text": "Collection<HTMLArcgisFeatureElement | HTMLArcgisFeatureRelationshipElement | HTMLArcgisFeatureUtilityNetworkAssociationsElement>",
                 "references": [
                   {
                     "name": "Collection",
@@ -18831,6 +18831,13 @@
                     "start": 38,
                     "end": 74,
                     "viewUrl": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-feature-relationship/"
+                  },
+                  {
+                    "name": "HTMLArcgisFeatureUtilityNetworkAssociationsElement",
+                    "module": "index.js",
+                    "start": 77,
+                    "end": 127,
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-feature-utility-network-associations/"
                   }
                 ]
               },
@@ -25244,11 +25251,7 @@
           "docsTags": [
             {
               "name": "see",
-              "text": "module :esri/PopupTemplate"
-            },
-            {
-              "name": "see",
-              "text": "[Guide - Esri Icon Font](../esri-icon-font/)"
+              "text": "[PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html)"
             },
             {
               "name": "since",
@@ -34494,6 +34497,71 @@
               "readonly": true,
               "docsOnlyReadonly": true
             },
+            {
+              "kind": "field",
+              "name": "loadErrorSources",
+              "description": "Any objects that encountered an error while loading the map, its basemap, ground, or any of the layers or tables in the map. You may inspect the errors by accessing each object's `loadError` property.",
+              "type": {
+                "text": "Array<WebLinkChart | Basemap | Ground | Layer | WebMap | WebScene>",
+                "references": [
+                  {
+                    "name": "Array",
+                    "package": "typescript",
+                    "module": "lib/lib.es5.d.ts",
+                    "start": 0,
+                    "end": 5
+                  },
+                  {
+                    "name": "WebLinkChart",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-WebLinkChart.html",
+                    "start": 6,
+                    "end": 18
+                  },
+                  {
+                    "name": "Basemap",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html",
+                    "start": 21,
+                    "end": 28
+                  },
+                  {
+                    "name": "Ground",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-Ground.html",
+                    "start": 31,
+                    "end": 37
+                  },
+                  {
+                    "name": "Layer",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html",
+                    "start": 40,
+                    "end": 45
+                  },
+                  {
+                    "name": "WebMap",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html",
+                    "start": 48,
+                    "end": 54
+                  },
+                  {
+                    "name": "WebScene",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html",
+                    "start": 57,
+                    "end": 65
+                  }
+                ]
+              }
+            },
             {
               "kind": "field",
               "name": "magnifier",
@@ -35462,6 +35530,23 @@
             }
           ],
           "events": [
+            {
+              "name": "arcgisLoadError",
+              "description": "Fires when a Map, Scene, or Link Chart fails to load or if one of their sub-components fails to load (e.g., basemap, ground, layers).",
+              "type": {
+                "text": "void"
+              },
+              "docsTags": [
+                {
+                  "name": "see",
+                  "text": "[loadErrorSources](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/#loadErrorSources)"
+                },
+                {
+                  "name": "example",
+                  "text": "```js\n      viewComponent.addEventListener(\"arcgisLoadError\", () => {\n        console.log(viewComponent.loadErrorSources);\n      });\n     ```"
+                }
+              ]
+            },
             {
               "name": "arcgisViewAnalysisViewCreate",
               "description": "Fires when the view for an analysis is created.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#event-analysis-view-create)",
@@ -35809,6 +35894,19 @@
               "type": {
                 "text": "void"
               }
+            },
+            {
+              "name": "arcgisViewReadyError",
+              "description": "Fires if the map view encounters a content or rendering error.",
+              "type": {
+                "text": "void"
+              },
+              "docsTags": [
+                {
+                  "name": "example",
+                  "text": "```js\n      viewComponent.addEventListener(\"arcgisViewReadyError\", () => {\n        // handle error\n      });\n     ```"
+                }
+              ]
             }
           ],
           "slots": [
@@ -37541,7 +37639,7 @@
             {
               "kind": "field",
               "name": "aria",
-              "description": "The ARIA attributes for the view container.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#aria)",
+              "description": "The ARIA information for the view.",
               "type": {
                 "text": "DOMContainerAria",
                 "references": [
@@ -37553,7 +37651,13 @@
                     "end": 16
                   }
                 ]
-              }
+              },
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.34"
+                }
+              ]
             },
             {
               "kind": "field",
@@ -38185,6 +38289,71 @@
               "readonly": true,
               "docsOnlyReadonly": true
             },
+            {
+              "kind": "field",
+              "name": "loadErrorSources",
+              "description": "Any objects that encountered an error while loading the map, its basemap, ground, or any of the layers or tables in the map. You may inspect the errors by accessing each object's `loadError` property.",
+              "type": {
+                "text": "Array<WebLinkChart | Basemap | Ground | Layer | WebMap | WebScene>",
+                "references": [
+                  {
+                    "name": "Array",
+                    "package": "typescript",
+                    "module": "lib/lib.es5.d.ts",
+                    "start": 0,
+                    "end": 5
+                  },
+                  {
+                    "name": "WebLinkChart",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-WebLinkChart.html",
+                    "start": 6,
+                    "end": 18
+                  },
+                  {
+                    "name": "Basemap",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html",
+                    "start": 21,
+                    "end": 28
+                  },
+                  {
+                    "name": "Ground",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-Ground.html",
+                    "start": 31,
+                    "end": 37
+                  },
+                  {
+                    "name": "Layer",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html",
+                    "start": 40,
+                    "end": 45
+                  },
+                  {
+                    "name": "WebMap",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html",
+                    "start": 48,
+                    "end": 54
+                  },
+                  {
+                    "name": "WebScene",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html",
+                    "start": 57,
+                    "end": 65
+                  }
+                ]
+              }
+            },
             {
               "kind": "field",
               "name": "magnifier",
@@ -39282,6 +39451,23 @@
             }
           ],
           "events": [
+            {
+              "name": "arcgisLoadError",
+              "description": "Fires when a Map, Scene, or Link Chart fails to load or if one of their sub-components fails to load (e.g., basemap, ground, layers).",
+              "type": {
+                "text": "void"
+              },
+              "docsTags": [
+                {
+                  "name": "see",
+                  "text": "[loadErrorSources](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#loadErrorSources)"
+                },
+                {
+                  "name": "example",
+                  "text": "```js\n      viewComponent.addEventListener(\"arcgisLoadError\", () => {\n        console.log(viewComponent.loadErrorSources);\n      });\n     ```"
+                }
+              ]
+            },
             {
               "name": "arcgisViewAnalysisViewCreate",
               "description": "Fires when the view for an analysis is created.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#event-analysis-view-create)",
@@ -39629,6 +39815,19 @@
               "type": {
                 "text": "void"
               }
+            },
+            {
+              "name": "arcgisViewReadyError",
+              "description": "Fires if the map view encounters a content or rendering error.",
+              "type": {
+                "text": "void"
+              },
+              "docsTags": [
+                {
+                  "name": "example",
+                  "text": "```js\n      viewComponent.addEventListener(\"arcgisViewReadyError\", () => {\n        // handle error\n      });\n     ```"
+                }
+              ]
             }
           ],
           "slots": [
@@ -42122,7 +42321,7 @@
           "customElement": true,
           "name": "ArcgisPopup",
           "tagName": "arcgis-popup",
-          "description": "## Overview\nThe Popup component allows users to view content from feature attributes. Popups enhance web applications\nby providing users with a simple way to interact with and view attributes in a layer.\nThey play an important role in relaying information to the user, which improves the storytelling capabilities of the application.\n\n## Popup UI\nThe [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) components contain a default popup.\nThis popup can display generic content, which is set in its [heading](#heading)\nand [content](#content) properties.\nWhen  content is set directly on the Popup instance it is not tied to a specific feature or layer.\n\n[![popup-basic-example](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/popup/popup-basic.png)](../sample-code/sandbox/?sample=intro-popup)\n\nIn the image above, the text \"Marriage in Nassau County Census Tract 5177.01\" is the popup's [heading](#heading).\nThe remaining text is the popup's [`content`](#content).\nA dock button is displayed in the top right corner of the popup allowing the user to dock the popup to one of the sides or corners of the view.\nThe options for docking may be set in the [dockOptions](#dockOptions) property.\nThe popup may also be collapsed by clicking the collapse button (the down arrow icon) in the top right corner of the popup.\nWhen collapsed, only the heading of the popup displays.\nThe popup may be closed by clicking the close button (the \"x\" icon) in the top right corner of the popup.\n\nPopups can also contain [actions](#actions) which execute a function defined by the developer when clicked.\nBy default, every popup has a \"Zoom to\" action (as shown in the image above with the magnifying glass) that allows users to zoom to the selected feature.\nSee the [actions](#actions) property for information about adding custom actions to a popup.\n\nThe Popup component is tied to a [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) component, whether it's docked or anchored to the selected feature.\nIf wanting to utilize the Popup functionality outside of [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/), the [arcgis-features](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/) component can be used to display the same content\nin its own container.\n\n## Popup and PopupTemplate\n[PopupTemplates](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) are closely related to Popup, but are more specific to [layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html)\nand [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html). Popup templates allow you to define custom titles and content templates based on the source of the\n[selected feature](#selectedFeature). When a layer or a graphic has a defined\npopup template, the popup will display the content defined in the popup template when the feature is clicked.\nThe content may contain field values from the attributes of the [selected feature](#selectedFeature).\n\nCustom PopupTemplates may also be assigned directly to a popup by setting [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) on the\n[features](#features) property.",
+          "description": "## Overview\nThe Popup component allows users to view content from feature attributes. Popups enhance web applications\nby providing users with a simple way to interact with and view attributes in a layer.\nThey play an important role in relaying information to the user, which improves the storytelling capabilities of the application.\n\n## Popup UI\nThe [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) components contain a default popup.\nThis popup can display generic content, which is set in its [heading](#heading)\nand [content](#content) properties.\nWhen  content is set directly on the Popup instance it is not tied to a specific feature or layer.\n\n![popup-basic-example](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/popup/popup-basic.png)\n\nIn the image above, the text \"Marriage in Nassau County Census Tract 5177.01\" is the popup's [heading](#heading).\nThe remaining text is the popup's [content](#content).\nA dock button is displayed in the top right corner of the popup allowing the user to dock the popup to one of the sides or corners of the view.\nThe options for docking may be set in the [dockOptions](#dockOptions) property.\nThe popup may also be collapsed by clicking the collapse button (the down arrow icon) in the top right corner of the popup.\nWhen collapsed, only the heading of the popup displays.\nThe popup may be closed by clicking the close button (the \"x\" icon) in the top right corner of the popup.\n\nPopups can also contain [actions](#actions) which execute a function defined by the developer when clicked.\nBy default, every popup has a \"Zoom to\" action (as shown in the image above with the magnifying glass) that allows users to zoom to the selected feature.\nSee the [actions](#actions) property for information about adding custom actions to a popup.\n\nThe Popup component is tied to a [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) component, whether it's docked or anchored to the selected feature.\nIf wanting to utilize the Popup functionality outside of [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/), the [arcgis-features](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/) component can be used to display the same content\nin its own container.\n\n## Popup and PopupTemplate\n[PopupTemplates](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) are closely related to Popup, but are more specific to [layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html)\nand [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html). Popup templates allow you to define custom titles and content templates based on the source of the\n[selected feature](#selectedFeature). When a layer or a graphic has a defined\npopup template, the popup will display the content defined in the popup template when the feature is clicked.\nThe content may contain field values from the attributes of the [selected feature](#selectedFeature).\n\nCustom PopupTemplates may also be assigned directly to a popup by setting [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) on the\n[features](#features) property.",
           "demos": [
             {
               "description": "Docs",
@@ -42135,6 +42334,10 @@
             {
               "description": "Small Map",
               "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-popup--small-map&singleStory=true"
+            },
+            {
+              "description": "Custom Popup",
+              "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-popup--custom-popup&singleStory=true"
             }
           ],
           "docsTags": [
@@ -42147,11 +42350,7 @@
             },
             {
               "name": "see",
-              "text": "module :esri/PopupTemplate"
-            },
-            {
-              "name": "see",
-              "text": "[Guide - Esri Icon Font](../guide/esri-icon-font/index.html)"
+              "text": "[PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html)"
             }
           ],
           "superclass": {
@@ -42164,7 +42363,7 @@
             {
               "kind": "field",
               "name": "actions",
-              "description": "A [collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html) of [action button](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionButton.html) or [action toggle](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionToggle.html) objects.\nEach action may be executed by clicking the icon or image symbolizing them.\n\nBy default, popups have a `Zoom To` action styled with a magnifying glass icon.\nWhen this icon is clicked, the view zooms in four LODs and centers on the selected feature.\nYou may remove this default action by setting [includeDefaultActionsDisabled](#includeDefaultActionsDisabled) to `true`, or by setting the\n[`overwriteActions`](esri-PopupTemplate.html#overwriteActions) property to `true` in a [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).\n\nThe order of each action is the order in which they appear in the actions [Collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html).\n\nThe [arcgisTriggerAction](#arcgisTriggerAction) event fires each time an action is clicked.",
+              "description": "A [collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html) of [action button](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionButton.html) or [action toggle](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionToggle.html) objects.\nEach action may be executed by clicking the icon or image symbolizing them.\n\nBy default, popups have a `Zoom To` action styled with a magnifying glass icon.\nWhen this icon is clicked, the view zooms in four LODs and centers on the selected feature.\nYou may remove this default action by setting [includeDefaultActionsDisabled](#includeDefaultActionsDisabled) to `true`, or by setting the\n[`overwriteActions`](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#overwriteActions) property to `true` in a [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).\n\nThe order of each action is the order in which they appear in the actions [Collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html).\n\nThe [arcgisTriggerAction](#arcgisTriggerAction) event fires each time an action is clicked.",
               "type": {
                 "text": "Collection<ActionButton | ActionToggle>",
                 "references": [
@@ -42203,18 +42402,6 @@
                   "name": "see",
                   "text": "[arcgisTriggerAction](#arcgisTriggerAction)"
                 },
-                {
-                  "name": "see",
-                  "text": "[Sample - Popup actions](../sample-code/popup-actions/index.html)"
-                },
-                {
-                  "name": "see",
-                  "text": "[Sample - Custom popup actions per feature](../sample-code/popup-custom-action/index.html)"
-                },
-                {
-                  "name": "see",
-                  "text": "[Sample - Popup with edit action](../sample-code/popup-editaction/index.html)"
-                },
                 {
                   "name": "example",
                   "text": "```js\n// Defines an action button to zoom out from the selected feature\nconst zoomOutAction = {\n  type: \"button\",\n  // This text is displayed as a tooltip\n  title: \"Zoom out\",\n  // The ID by which to reference the action in the event handler\n  id: \"zoom-out\",\n  // Sets the icon used to style the action button\n  icon: \"magnifying-glass-minus\"\n};\n// Adds the custom action to the popup.\npopupComponent.actions.push(zoomOutAction);\n```"
@@ -42449,14 +42636,6 @@
                 {
                   "name": "noautocast"
                 },
-                {
-                  "name": "see",
-                  "text": "[Sample - Popup Docking](../sample-code/popup-docking-position/index.html)"
-                },
-                {
-                  "name": "see",
-                  "text": "[Sample - Popup with DOM node](../sample-code/popup-domnode/index.html)"
-                },
                 {
                   "name": "example",
                   "text": "```js\n// This sets generic instructions in the popup that will always be displayed\n// unless it is overridden by a PopupTemplate\npopupComponent.content = \"Click a feature on the map to view its attributes\";\n```"
@@ -42549,10 +42728,6 @@
               "default": "false",
               "attribute": "dock-enabled",
               "docsTags": [
-                {
-                  "name": "see",
-                  "text": "[Sample - Popup docking](../sample-code/popup-docking-position/index.html)"
-                },
                 {
                   "name": "example",
                   "text": "```html\n<!-- Setting this property in HTML -->\n<arcgis-popup dock-enabled></arcgis-popup>\n```"
@@ -42579,10 +42754,6 @@
                 ]
               },
               "docsTags": [
-                {
-                  "name": "see",
-                  "text": "[Sample - Popup docking](../sample-code/popup-docking-position/index.html)"
-                },
                 {
                   "name": "example",
                   "text": "```js\npopupComponent.dockOptions = {\n  // Disable the dock button so users cannot undock the popup\n  buttonEnabled: false,\n  // Dock the popup when the size of the view is less than or equal to 600x1000 pixels\n  breakpoint: {\n    width: 600,\n    height: 1000\n  }\n};\n```"
@@ -43071,10 +43242,6 @@
                   "name": "autocast",
                   "text": "{ \"byTypeProperty\": false }"
                 },
-                {
-                  "name": "see",
-                  "text": "[Intro to popups](../sample-code/intro-popup/index.html)"
-                },
                 {
                   "name": "example",
                   "text": "```js\n// Sets the location of the popup to the center of the view\npopupComponent.location = viewELement.center;\n// Displays the popup\npopupComponent.visible = true;\n```"
@@ -43497,6 +43664,40 @@
               "signature": "(action: __esri.ActionButton | __esri.ActionToggle): Promise<void>",
               "async": true
             },
+            {
+              "kind": "field",
+              "name": "view",
+              "description": "The view associated with the component. \n  > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the ArcgisPopup component will be associated with a map or scene component rather than using the `view` property.",
+              "type": {
+                "text": "MapView | SceneView",
+                "references": [
+                  {
+                    "name": "MapView",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html",
+                    "start": 0,
+                    "end": 7
+                  },
+                  {
+                    "name": "SceneView",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html",
+                    "start": 10,
+                    "end": 19
+                  }
+                ],
+                "values": [
+                  {
+                    "type": "MapView"
+                  },
+                  {
+                    "type": "SceneView"
+                  }
+                ]
+              }
+            },
             {
               "kind": "field",
               "name": "visible",
@@ -47371,6 +47572,71 @@
               "readonly": true,
               "docsOnlyReadonly": true
             },
+            {
+              "kind": "field",
+              "name": "loadErrorSources",
+              "description": "Any objects that encountered an error while loading the map, its basemap, ground, or any of the layers or tables in the map. You may inspect the errors by accessing each object's `loadError` property.",
+              "type": {
+                "text": "Array<WebLinkChart | Basemap | Ground | Layer | WebMap | WebScene>",
+                "references": [
+                  {
+                    "name": "Array",
+                    "package": "typescript",
+                    "module": "lib/lib.es5.d.ts",
+                    "start": 0,
+                    "end": 5
+                  },
+                  {
+                    "name": "WebLinkChart",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-WebLinkChart.html",
+                    "start": 6,
+                    "end": 18
+                  },
+                  {
+                    "name": "Basemap",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html",
+                    "start": 21,
+                    "end": 28
+                  },
+                  {
+                    "name": "Ground",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-Ground.html",
+                    "start": 31,
+                    "end": 37
+                  },
+                  {
+                    "name": "Layer",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html",
+                    "start": 40,
+                    "end": 45
+                  },
+                  {
+                    "name": "WebMap",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html",
+                    "start": 48,
+                    "end": 54
+                  },
+                  {
+                    "name": "WebScene",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html",
+                    "start": 57,
+                    "end": 65
+                  }
+                ]
+              }
+            },
             {
               "kind": "field",
               "name": "magnifier",
@@ -48499,6 +48765,23 @@
             }
           ],
           "events": [
+            {
+              "name": "arcgisLoadError",
+              "description": "Fires when a Map, Scene, or Link Chart fails to load or if one of their sub-components fails to load (e.g., basemap, ground, layers).",
+              "type": {
+                "text": "void"
+              },
+              "docsTags": [
+                {
+                  "name": "see",
+                  "text": "[loadErrorSources](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#loadErrorSources)"
+                },
+                {
+                  "name": "example",
+                  "text": "```js\n      viewComponent.addEventListener(\"arcgisLoadError\", () => {\n        console.log(viewComponent.loadErrorSources);\n      });\n     ```"
+                }
+              ]
+            },
             {
               "name": "arcgisViewAnalysisViewCreate",
               "description": "Fires when the view for an analysis is created.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-analysis-view-create)",
@@ -48846,6 +49129,19 @@
               "type": {
                 "text": "void"
               }
+            },
+            {
+              "name": "arcgisViewReadyError",
+              "description": "Fires if the map view encounters a content or rendering error.",
+              "type": {
+                "text": "void"
+              },
+              "docsTags": [
+                {
+                  "name": "example",
+                  "text": "```js\n      viewComponent.addEventListener(\"arcgisViewReadyError\", () => {\n        // handle error\n      });\n     ```"
+                }
+              ]
             }
           ],
           "slots": [
@@ -50473,6 +50769,11 @@
               "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-search-result-renderer/"
             }
           ],
+          "docsTags": [
+            {
+              "name": "internal"
+            }
+          ],
           "superclass": {
             "name": "LitElement",
             "package": "@arcgis/lumina"
@@ -50551,7 +50852,7 @@
               "kind": "field",
               "name": "messages",
               "type": {
-                "text": "({\n    componentLabel: string;\n    searchButtonTitle: string;\n    placeholder: string;\n    searchIn: string;\n    all: string;\n    allPlaceholder: string;\n    locateError: string;\n    untitledResult: string;\n    untitledSource: string;\n    noResults: string;\n    noResultsFound: string;\n    noResultsFoundForValue: string;\n    showMoreResults: string;\n    hideMoreResults: string;\n    searchResult: string;\n    moreResultsHeader: string;\n    useCurrentLocation: string;\n} & {\n    _lang: string;\n    _t9nLocale: \"el\" | \"id\" | \"sl\" | \"it\" | \"de\" | \"ca\" | \"fi\" | \"es\" | \"ar\" | \"th\" | \"et\" | \"da\" | \"sk\" | \"en\" | \"sv\" | \"fr\" | \"he\" | \"cs\" | \"lt\" | \"no\" | \"pl\" | \"ro\" | \"ru\" | \"tr\" | \"vi\" | \"bs\" | \"hr\" | \"bg\" | \"lv\" | \"nl\" | \"sr\" | \"hu\" | \"ja\" | \"ko\" | \"nb\" | \"pt-BR\" | \"pt-PT\" | \"uk\" | \"zh-CN\" | \"zh-HK\" | \"zh-TW\";\n    _loading: boolean;\n    _overrides: {\n        componentLabel?: string | undefined;\n        searchButtonTitle?: string | undefined;\n        placeholder?: string | undefined;\n        searchIn?: string | undefined;\n        all?: string | undefined;\n        allPlaceholder?: string | undefined;\n        locateError?: string | undefined;\n        untitledResult?: string | undefined;\n        untitledSource?: string | undefined;\n        noResults?: string | undefined;\n        noResultsFound?: string | undefined;\n        noResultsFoundForValue?: string | undefined;\n        showMoreResults?: string | undefined;\n        hideMoreResults?: string | undefined;\n        searchResult?: string | undefined;\n        moreResultsHeader?: string | undefined;\n        useCurrentLocation?: string | undefined;\n    };\n    _original?: {\n        componentLabel: string;\n        searchButtonTitle: string;\n        placeholder: string;\n        searchIn: string;\n        all: string;\n        allPlaceholder: string;\n        locateError: string;\n        untitledResult: string;\n        untitledSource: string;\n        noResults: string;\n        noResultsFound: string;\n        noResultsFoundForValue: string;\n        showMoreResults: string;\n        hideMoreResults: string;\n        searchResult: string;\n        moreResultsHeader: string;\n        useCurrentLocation: string;\n    } | undefined;\n})"
+                "text": "({\n    componentLabel: string;\n    searchButtonTitle: string;\n    placeholder: string;\n    searchIn: string;\n    all: string;\n    allPlaceholder: string;\n    locateError: string;\n    untitledResult: string;\n    untitledSource: string;\n    noResults: string;\n    noResultsFound: string;\n    noResultsFoundForValue: string;\n    showMoreResults: string;\n    hideMoreResults: string;\n    searchResult: string;\n    moreResultsHeader: string;\n    useCurrentLocation: string;\n} & {\n    _lang: string;\n    _t9nLocale: \"el\" | \"hr\" | \"th\" | \"tr\" | \"id\" | \"ar\" | \"de\" | \"da\" | \"vi\" | \"ca\" | \"sl\" | \"fi\" | \"it\" | \"es\" | \"et\" | \"sk\" | \"en\" | \"sv\" | \"fr\" | \"he\" | \"cs\" | \"lt\" | \"no\" | \"pl\" | \"ro\" | \"ru\" | \"bs\" | \"bg\" | \"ko\" | \"pt-BR\" | \"pt-PT\" | \"zh-CN\" | \"zh-HK\" | \"zh-TW\" | \"hu\" | \"ja\" | \"lv\" | \"nl\" | \"nb\" | \"sr\" | \"uk\";\n    _loading: boolean;\n    _overrides: {\n        componentLabel?: string | undefined;\n        searchButtonTitle?: string | undefined;\n        placeholder?: string | undefined;\n        searchIn?: string | undefined;\n        all?: string | undefined;\n        allPlaceholder?: string | undefined;\n        locateError?: string | undefined;\n        untitledResult?: string | undefined;\n        untitledSource?: string | undefined;\n        noResults?: string | undefined;\n        noResultsFound?: string | undefined;\n        noResultsFoundForValue?: string | undefined;\n        showMoreResults?: string | undefined;\n        hideMoreResults?: string | undefined;\n        searchResult?: string | undefined;\n        moreResultsHeader?: string | undefined;\n        useCurrentLocation?: string | undefined;\n    };\n    _original?: {\n        componentLabel: string;\n        searchButtonTitle: string;\n        placeholder: string;\n        searchIn: string;\n        all: string;\n        allPlaceholder: string;\n        locateError: string;\n        untitledResult: string;\n        untitledSource: string;\n        noResults: string;\n        noResultsFound: string;\n        noResultsFoundForValue: string;\n        showMoreResults: string;\n        hideMoreResults: string;\n        searchResult: string;\n        moreResultsHeader: string;\n        useCurrentLocation: string;\n    } | undefined;\n})"
               }
             },
             {
@@ -56227,7 +56528,7 @@
                 {
                   "name": "settings",
                   "type": {
-                    "text": "{\n    loop?: boolean | undefined;\n    fullTimeExtent?: nullish | TimeExtentProperties;\n    stops?: nullish | Array<Date>;\n}"
+                    "text": "{\n    fullTimeExtent?: nullish | TimeExtentProperties;\n    loop?: boolean | undefined;\n    stops?: nullish | Array<Date>;\n}"
                   }
                 }
               ],