@arcgis/map-components 5.0.0-next.65 → 5.0.0-next.68

package/dist/docs/api.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-11-24T04:38:39",
+  "timestamp": "2025-11-26T04:35:57",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "5.0.0-next.65",
+    "version": "5.0.0-next.68",
     "typescriptVersion": "5.9.3"
   },
   "schemaVersion": "2.1.0",
@@ -43013,6 +43013,21 @@
           "pascalCaseName": "ArcgisPresentation",
           "importPath": "components/arcgis-presentation",
           "members": [
+            {
+              "kind": "field",
+              "name": "autoDestroyDisabled",
+              "description": "If true, the component will not be destroyed automatically when it is\ndisconnected from the document. This is useful when you want to move the\ncomponent to a different place on the page, or temporarily hide it. If this\nis set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-presentation/#destroy) method when you are done to\nprevent memory leaks.",
+              "type": {
+                "text": "boolean",
+                "values": [
+                  {
+                    "type": "boolean"
+                  }
+                ]
+              },
+              "default": "false",
+              "attribute": "auto-destroy-disabled"
+            },
             {
               "kind": "method",
               "name": "componentOnReady",
@@ -43043,6 +43058,78 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "destroy",
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "typescript",
+                      "module": "lib/lib.es5.d.ts",
+                      "start": 0,
+                      "end": 7
+                    }
+                  ]
+                }
+              },
+              "signature": "(): Promise<void>"
+            },
+            {
+              "kind": "field",
+              "name": "keyboardNavigationEnabled",
+              "description": "Enable navigation with the keyboard\nby using the arrow keys or page up/page down keys",
+              "type": {
+                "text": "boolean",
+                "values": [
+                  {
+                    "type": "boolean"
+                  }
+                ]
+              },
+              "default": "false",
+              "attribute": "keyboard-navigation-enabled"
+            },
+            {
+              "kind": "field",
+              "name": "scale",
+              "description": "specifies the size of the component",
+              "type": {
+                "text": "\"l\" | \"m\" | \"s\"",
+                "values": [
+                  {
+                    "value": "l",
+                    "type": "string"
+                  },
+                  {
+                    "value": "m",
+                    "type": "string"
+                  },
+                  {
+                    "value": "s",
+                    "type": "string"
+                  }
+                ]
+              },
+              "default": "\"m\"",
+              "attribute": "scale"
+            },
+            {
+              "kind": "field",
+              "name": "slideId",
+              "description": "The id of the slide applied to the view\nSet the id of the slide applied to the view",
+              "type": {
+                "text": "string",
+                "values": [
+                  {
+                    "type": "string"
+                  }
+                ]
+              },
+              "attribute": "slide-id"
+            },
             {
               "kind": "field",
               "name": "view",
@@ -43062,6 +43149,72 @@
               }
             }
           ],
+          "attributes": [
+            {
+              "name": "auto-destroy-disabled",
+              "description": "If true, the component will not be destroyed automatically when it is\ndisconnected from the document. This is useful when you want to move the\ncomponent to a different place on the page, or temporarily hide it. If this\nis set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-presentation/#destroy) method when you are done to\nprevent memory leaks.",
+              "type": {
+                "text": "boolean",
+                "values": [
+                  {
+                    "type": "boolean"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "autoDestroyDisabled"
+            },
+            {
+              "name": "keyboard-navigation-enabled",
+              "description": "Enable navigation with the keyboard\nby using the arrow keys or page up/page down keys",
+              "type": {
+                "text": "boolean",
+                "values": [
+                  {
+                    "type": "boolean"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "keyboardNavigationEnabled"
+            },
+            {
+              "name": "scale",
+              "description": "specifies the size of the component",
+              "type": {
+                "text": "\"l\" | \"m\" | \"s\"",
+                "values": [
+                  {
+                    "value": "l",
+                    "type": "string"
+                  },
+                  {
+                    "value": "m",
+                    "type": "string"
+                  },
+                  {
+                    "value": "s",
+                    "type": "string"
+                  }
+                ]
+              },
+              "default": "\"m\"",
+              "fieldName": "scale"
+            },
+            {
+              "name": "slide-id",
+              "description": "The id of the slide applied to the view\nSet the id of the slide applied to the view",
+              "type": {
+                "text": "string",
+                "values": [
+                  {
+                    "type": "string"
+                  }
+                ]
+              },
+              "fieldName": "slideId"
+            }
+          ],
           "events": [
             {
               "name": "arcgisReady",
@@ -61197,291 +61350,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/arcgis-utility-network-result-feature-list",
-      "sourcePath": "src/components/utility-network-trace-analysis/components/utility-network-result-feature-list/utility-network-result-feature-list.tsx",
-      "declarations": [
-        {
-          "kind": "class",
-          "customElement": true,
-          "name": "ArcgisUtilityNetworkResultFeatureList",
-          "tagName": "arcgis-utility-network-result-feature-list",
-          "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes trace result elements as input.\nIt displays the layers the elements are from, with a count of elements on each layer.\nA `UtilityNetwork` and list of layers is required to display feature layer names.",
-          "demos": [
-            {
-              "description": "Docs",
-              "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-result-feature-list/"
-            }
-          ],
-          "docsTags": [
-            {
-              "name": "since",
-              "text": "4.34"
-            },
-            {
-              "name": "internal"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "@arcgis/lumina"
-          },
-          "pascalCaseName": "ArcgisUtilityNetworkResultFeatureList",
-          "importPath": "components/arcgis-utility-network-result-feature-list",
-          "members": [
-            {
-              "kind": "method",
-              "name": "componentOnReady",
-              "return": {
-                "type": {
-                  "text": "Promise<void>",
-                  "references": [
-                    {
-                      "module": "lib/lib.es5.d.ts",
-                      "name": "Promise",
-                      "package": "typescript",
-                      "start": 0,
-                      "end": 7
-                    }
-                  ]
-                }
-              },
-              "description": "Create a promise that resolves once component is fully loaded.",
-              "signature": "(): Promise<void>",
-              "inheritedFrom": {
-                "name": "LitElement",
-                "package": "@arcgis/lumina"
-              },
-              "docsTags": [
-                {
-                  "name": "example",
-                  "text": "```js\nconst arcgisUtilityNetworkResultFeatureList = document.querySelector(\"arcgis-utility-network-result-feature-list\");\ndocument.body.append(arcgisUtilityNetworkResultFeatureList);\nawait arcgisUtilityNetworkResultFeatureList.componentOnReady();\nconsole.log(\"arcgis-utility-network-result-feature-list is ready to go!\");\n```"
-                }
-              ]
-            },
-            {
-              "kind": "field",
-              "name": "elements",
-              "type": {
-                "text": "Array<NetworkElement>",
-                "references": [
-                  {
-                    "name": "Array",
-                    "package": "typescript",
-                    "module": "lib/lib.es5.d.ts",
-                    "start": 0,
-                    "end": 5
-                  },
-                  {
-                    "name": "NetworkElement",
-                    "package": "@arcgis/core",
-                    "module": "interfaces.d.ts",
-                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-NetworkElement.html",
-                    "start": 6,
-                    "end": 20
-                  }
-                ]
-              },
-              "docsTags": [
-                {
-                  "name": "required"
-                }
-              ]
-            },
-            {
-              "kind": "field",
-              "name": "featuresFromSelectedLayer",
-              "type": {
-                "text": "Array<FeatureWithLabel>",
-                "references": [
-                  {
-                    "name": "Array",
-                    "package": "typescript",
-                    "module": "lib/lib.es5.d.ts",
-                    "start": 0,
-                    "end": 5
-                  },
-                  {
-                    "name": "FeatureWithLabel",
-                    "module": "dist/components/arcgis-utility-network-result-feature-list/customElement.d.ts",
-                    "start": 6,
-                    "end": 22
-                  }
-                ]
-              },
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "layers",
-              "type": {
-                "text": "Array<Layer>",
-                "references": [
-                  {
-                    "name": "Array",
-                    "package": "typescript",
-                    "module": "lib/lib.es5.d.ts",
-                    "start": 0,
-                    "end": 5
-                  },
-                  {
-                    "name": "Layer",
-                    "package": "@arcgis/core",
-                    "module": "interfaces.d.ts",
-                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html",
-                    "start": 6,
-                    "end": 11
-                  }
-                ]
-              },
-              "docsTags": [
-                {
-                  "name": "required"
-                }
-              ]
-            },
-            {
-              "kind": "field",
-              "name": "messageOverrides",
-              "type": {
-                "text": "Record<string, unknown>"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "selectedLayer",
-              "type": {
-                "text": "FeatureLayer | Layer | SubtypeSublayer",
-                "references": [
-                  {
-                    "name": "FeatureLayer",
-                    "package": "@arcgis/core",
-                    "module": "interfaces.d.ts",
-                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html",
-                    "start": 0,
-                    "end": 12
-                  },
-                  {
-                    "name": "Layer",
-                    "package": "@arcgis/core",
-                    "module": "interfaces.d.ts",
-                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html",
-                    "start": 15,
-                    "end": 20
-                  },
-                  {
-                    "name": "SubtypeSublayer",
-                    "package": "@arcgis/core",
-                    "module": "interfaces.d.ts",
-                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SubtypeSublayer.html",
-                    "start": 23,
-                    "end": 38
-                  }
-                ],
-                "values": [
-                  {
-                    "type": "FeatureLayer"
-                  },
-                  {
-                    "type": "Layer"
-                  },
-                  {
-                    "type": "SubtypeSublayer"
-                  }
-                ]
-              }
-            },
-            {
-              "kind": "field",
-              "name": "state",
-              "type": {
-                "text": "\"loading\" | \"ready\"",
-                "values": [
-                  {
-                    "value": "loading",
-                    "type": "string"
-                  },
-                  {
-                    "value": "ready",
-                    "type": "string"
-                  }
-                ]
-              },
-              "default": "\"ready\"",
-              "attribute": "state"
-            },
-            {
-              "kind": "field",
-              "name": "utilityNetwork",
-              "type": {
-                "text": "UtilityNetwork | undefined",
-                "references": [
-                  {
-                    "name": "UtilityNetwork",
-                    "package": "@arcgis/core",
-                    "module": "interfaces.d.ts",
-                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-networks-UtilityNetwork.html",
-                    "start": 0,
-                    "end": 14
-                  }
-                ],
-                "values": [
-                  {
-                    "type": "UtilityNetwork"
-                  },
-                  {
-                    "type": "undefined"
-                  }
-                ]
-              },
-              "docsTags": [
-                {
-                  "name": "required"
-                }
-              ]
-            }
-          ],
-          "attributes": [
-            {
-              "name": "state",
-              "type": {
-                "text": "\"loading\" | \"ready\"",
-                "values": [
-                  {
-                    "value": "loading",
-                    "type": "string"
-                  },
-                  {
-                    "value": "ready",
-                    "type": "string"
-                  }
-                ]
-              },
-              "default": "\"ready\"",
-              "fieldName": "state"
-            }
-          ],
-          "events": [
-            {
-              "name": "arcgisSelectedLayerChange",
-              "type": {
-                "text": "void"
-              }
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "custom-element-definition",
-          "name": "arcgis-utility-network-result-feature-list",
-          "declaration": {
-            "name": "ArcgisUtilityNetworkResultFeatureList"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "components/arcgis-utility-network-subnetwork-info",
@@ -62362,7 +62230,7 @@
           "customElement": true,
           "name": "ArcgisUtilityNetworkTraceResults",
           "tagName": "arcgis-utility-network-trace-results",
-          "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes a `TraceResult` instance as input.\nOptionally, the title of a trace configuration can be provided.\n\nIt displays a list of result types returned by a trace in the provided `TraceResult`.\nSelecting a trace result type renders a flow item for that result type.",
+          "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes a `TraceResult` instance as input.\nOptionally, the title of a trace configuration can be provided as a heading to display.",
           "demos": [
             {
               "description": "Docs",
@@ -62415,6 +62283,28 @@
                 }
               ]
             },
+            {
+              "kind": "field",
+              "name": "featuresFromSelectedLayer",
+              "type": {
+                "text": "Array<FeatureWithLabel>",
+                "references": [
+                  {
+                    "name": "Array",
+                    "package": "typescript",
+                    "module": "lib/lib.es5.d.ts",
+                    "start": 0,
+                    "end": 5
+                  },
+                  {
+                    "name": "FeatureWithLabel",
+                    "module": "dist/components/arcgis-utility-network-trace-results/customElement.d.ts",
+                    "start": 6,
+                    "end": 22
+                  }
+                ]
+              }
+            },
             {
               "kind": "field",
               "name": "isElementsSelected",
@@ -62460,6 +62350,138 @@
                 "text": "Record<string, unknown>"
               }
             },
+            {
+              "kind": "field",
+              "name": "referenceElement",
+              "description": "By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.",
+              "type": {
+                "text": "HTMLArcgisLinkChartElement | HTMLArcgisMapElement | HTMLArcgisSceneElement | string",
+                "references": [
+                  {
+                    "name": "HTMLArcgisLinkChartElement",
+                    "module": "index.js",
+                    "start": 0,
+                    "end": 26,
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/"
+                  },
+                  {
+                    "name": "HTMLArcgisMapElement",
+                    "module": "index.js",
+                    "start": 29,
+                    "end": 49,
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/"
+                  },
+                  {
+                    "name": "HTMLArcgisSceneElement",
+                    "module": "index.js",
+                    "start": 52,
+                    "end": 74,
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/"
+                  }
+                ],
+                "values": [
+                  {
+                    "type": "HTMLArcgisLinkChartElement"
+                  },
+                  {
+                    "type": "HTMLArcgisMapElement"
+                  },
+                  {
+                    "type": "HTMLArcgisSceneElement"
+                  },
+                  {
+                    "type": "string"
+                  }
+                ]
+              },
+              "attribute": "reference-element",
+              "docsTags": [
+                {
+                  "name": "see",
+                  "text": "[Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)"
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "selectedFeature",
+              "type": {
+                "text": "Graphic",
+                "references": [
+                  {
+                    "name": "Graphic",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html",
+                    "start": 0,
+                    "end": 7
+                  }
+                ]
+              }
+            },
+            {
+              "kind": "field",
+              "name": "selectedLayer",
+              "type": {
+                "text": "FeatureLayer | Layer | SubtypeSublayer",
+                "references": [
+                  {
+                    "name": "FeatureLayer",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html",
+                    "start": 0,
+                    "end": 12
+                  },
+                  {
+                    "name": "Layer",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html",
+                    "start": 15,
+                    "end": 20
+                  },
+                  {
+                    "name": "SubtypeSublayer",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SubtypeSublayer.html",
+                    "start": 23,
+                    "end": 38
+                  }
+                ],
+                "values": [
+                  {
+                    "type": "FeatureLayer"
+                  },
+                  {
+                    "type": "Layer"
+                  },
+                  {
+                    "type": "SubtypeSublayer"
+                  }
+                ]
+              }
+            },
+            {
+              "kind": "field",
+              "name": "state",
+              "type": {
+                "text": "\"loading\" | \"ready\"",
+                "values": [
+                  {
+                    "value": "loading",
+                    "type": "string"
+                  },
+                  {
+                    "value": "ready",
+                    "type": "string"
+                  }
+                ]
+              },
+              "default": "\"ready\"",
+              "attribute": "state"
+            },
             {
               "kind": "field",
               "name": "traceConfigTitle",
@@ -62511,7 +62533,7 @@
               "kind": "field",
               "name": "view",
               "type": {
-                "text": "MapView | undefined",
+                "text": "MapView",
                 "references": [
                   {
                     "name": "MapView",
@@ -62521,21 +62543,8 @@
                     "start": 0,
                     "end": 7
                   }
-                ],
-                "values": [
-                  {
-                    "type": "MapView"
-                  },
-                  {
-                    "type": "undefined"
-                  }
                 ]
-              },
-              "docsTags": [
-                {
-                  "name": "required"
-                }
-              ]
+              }
             }
           ],
           "attributes": [
@@ -62552,6 +62561,37 @@
               "default": "false",
               "fieldName": "isElementsSelected"
             },
+            {
+              "name": "reference-element",
+              "description": "By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.",
+              "type": {
+                "text": "string",
+                "values": [
+                  {
+                    "type": "string"
+                  }
+                ]
+              },
+              "fieldName": "referenceElement"
+            },
+            {
+              "name": "state",
+              "type": {
+                "text": "\"loading\" | \"ready\"",
+                "values": [
+                  {
+                    "value": "loading",
+                    "type": "string"
+                  },
+                  {
+                    "value": "ready",
+                    "type": "string"
+                  }
+                ]
+              },
+              "default": "\"ready\"",
+              "fieldName": "state"
+            },
             {
               "name": "trace-config-title",
               "type": {
@@ -62566,6 +62606,12 @@
             }
           ],
           "events": [
+            {
+              "name": "arcgisSelectedLayerChange",
+              "type": {
+                "text": "void"
+              }
+            },
             {
               "name": "arcgisSelectedResultTypeChange",
               "type": {