@arcgis/map-components 4.34.0-next.20 → 4.34.0-next.22

package/dist/components/arcgis-video-player-settings/customElement.js

@@ -6,7 +6,7 @@ import { LitElement as p } from "@arcgis/lumina";
 import { css as m } from "@lit/reactive-element/css-tag.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.20 */
+v4.34.0-next.22 */
 const v = m`.arcgis-video-player__settings-flow{min-width:var(--calcite-size-160)}`, $ = ["Auto"], g = [
   { label: "0.25x", value: 0.25 },
   { label: "0.5x", value: 0.5 },

package/dist/components/arcgis-video-player-slider/customElement.js

@@ -4,7 +4,7 @@ import { LitElement as c, safeClassMap as s } from "@arcgis/lumina";
 import { css as t } from "@lit/reactive-element/css-tag.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.20 */
+v4.34.0-next.22 */
 const d = t`.arcgis-video-player__slider-progress-container{position:relative;z-index:1;width:100%}.arcgis-video-player__progress{--esri-video-player-progress-width: 2px;appearance:none;display:block;position:absolute;top:calc(50% - var(--esri-video-player-progress-width) / 2);left:var(--esri-video-player-controls-spacing);border:none;background:var(--calcite-color-border-1);cursor:pointer;width:calc(100% - var(--esri-video-player-controls-spacing) * 2);height:var(--esri-video-player-progress-width)}.arcgis-video-player__progress::-webkit-progress-bar{background-color:var(--calcite-color-border-3)}.arcgis-video-player__progress::-webkit-progress-value{background-color:var(--calcite-color-border-input)}.arcgis-video-player__progress::-moz-progress-bar{background-color:var(--calcite-color-border-3)}.arcgis-video-player__slider{--calcite-slider-track-color: transparent;background-color:var(--calcite-color-foreground-1);padding:calc(var(--esri-video-player-controls-spacing) / 4) calc(var(--esri-video-player-controls-spacing) / 2)}`, o = "arcgis-video-player", i = {
   progress: `${o}__progress`,
   slider: `${o}__slider`,

package/dist/components/arcgis-weather/customElement.js

@@ -18,7 +18,7 @@ import $ from "@arcgis/core/views/3d/environment/SnowyWeather.js";
 import C from "@arcgis/core/views/3d/environment/SunnyWeather.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.20 */
+v4.34.0-next.22 */
 const c = "arcgis-weather", d = {
   base: c,
   content: `${c}__content`,

package/dist/components/arcgis-zoom/customElement.js

@@ -10,7 +10,7 @@ import { u as O } from "../../chunks/useView.js";
 import { css as Z } from "@lit/reactive-element/css-tag.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.20 */
+v4.34.0-next.22 */
 const a = {
   base: "arcgis-zoom",
   horizontalLayout: "arcgis-zoom--horizontal",

package/dist/controllers/Handles.d.ts

@@ -1,7 +1,7 @@
 import { IHandle, Nil } from '@arcgis/components-utils';
 export declare class Handles<T = string, H extends IHandle = IHandle> {
     /**
-     * A handle to a [highlight](https://next.sites.afd.arcgis.com/javascript/latest/api-reference/esri-views-layers-FeatureLayerView.html#highlight) call result.
+     * A handle to a [highlight](https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-views-layers-FeatureLayerView.html#highlight) call result.
      * The handle can be used to remove the installed highlight.
      *
      * @typedef module:esri/core/Handles~Handle
@@ -36,7 +36,7 @@ export declare class Handles<T = string, H extends IHandle = IHandle> {
      * @param {module:esri/core/Accessor~WatchHandle | module:esri/core/Accessor~WatchHandle[] | module:esri/core/Collection<module:esri/core/Accessor~WatchHandle>} handles - An array or collection handles to group.
      * @param {*} [groupKey]
      *    Key identifying the group to which the handles should be added. All the handles in the group
-     *    can later be removed with [Handles.remove()](https://next.sites.afd.arcgis.com/javascript/latest/api-reference/esri-core-Handles.html#remove). If no
+     *    can later be removed with [Handles.remove()](https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-core-Handles.html#remove). If no
      *    key is provided the handles are added to a default group.
      *
      * @example

package/dist/controllers/useHandles.d.ts

@@ -40,7 +40,7 @@ declare class HandleManager extends Controller {
      *    Handles marked for removal once the object is destroyed.
      * @param {*} [groupKey]
      *    Key identifying the group to which the handles should be added. All the handles in the group
-     *    can later be removed with [Accessor.removeHandles()](https://next.sites.afd.arcgis.com/javascript/latest/api-reference/esri-core-Accessor.html#removeHandles).
+     *    can later be removed with [Accessor.removeHandles()](https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-core-Accessor.html#removeHandles).
      *    If no key is provided the handles are added to a default group.
      */
     addHandles<T>(handleOrHandles: SafeHandle | SafeHandle[], groupKey?: GroupKey<T>): void;
@@ -85,9 +85,9 @@ declare class HandleManager extends Controller {
 }
 /**
  * useHandles() implements the following methods from JS API's Accessor class:
- * addHandles - https://next.sites.afd.arcgis.com/javascript/latest/api-reference/esri-core-Accessor.html#addHandles
- * hasHandles - https://next.sites.afd.arcgis.com/javascript/latest/api-reference/esri-core-Accessor.html#hasHandles
- * removeHandles - https://next.sites.afd.arcgis.com/javascript/latest/api-reference/esri-core-Accessor.html#removeHandles
+ * addHandles - https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-core-Accessor.html#addHandles
+ * hasHandles - https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-core-Accessor.html#hasHandles
+ * removeHandles - https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-core-Accessor.html#removeHandles
  * removeAllHandles - (hidden from the JS API's JSDoc)
  *
  * Except, to adapt these to web-components, you have an option of picking

package/dist/docs/api.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-06-09T04:52:12",
+  "timestamp": "2025-06-11T04:54:04",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "4.34.0-next.20",
+    "version": "4.34.0-next.22",
     "typescriptVersion": "5.8.3"
   },
   "schemaVersion": "1.0.0",
@@ -14652,7 +14652,7 @@
               "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-expand/"
             },
             {
-              "description": "Expand with Custom Content\nThe Expand component with custom content. The content must be wrapped in an [Placement](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-placement/) component.",
+              "description": "Expand with Custom Content\nThe Expand component with custom content. The content must be wrapped in a [Placement](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-placement/) component.",
               "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-expand--custom-content&singleStory=true"
             },
             {
@@ -14906,7 +14906,13 @@
                 ]
               },
               "default": "false",
-              "attribute": "focus-trap-disabled"
+              "attribute": "focus-trap-disabled",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.33"
+                }
+              ]
             },
             {
               "kind": "field",
@@ -16496,6 +16502,166 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/feature-content/feature-content.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "name": "ArcgisFeatureContent",
+          "tagName": "arcgis-feature-content",
+          "demos": [
+            {
+              "description": "Docs",
+              "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-feature-content/"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "@arcgis/lumina"
+          },
+          "encapsulation": "none",
+          "pascalCaseName": "ArcgisFeatureContent",
+          "importPath": "components/arcgis-feature-content",
+          "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-feature-content/#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",
+              "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>",
+              "async": true,
+              "inheritedFrom": {
+                "name": "LitElement",
+                "package": "@arcgis/lumina"
+              },
+              "docsTags": [
+                {
+                  "name": "example",
+                  "text": "```js\nconst arcgisFeatureContent = document.createElement(\"arcgis-feature-content\");\ndocument.body.append(arcgisFeatureContent);\narcgisFeatureContent.componentOnReady().then(() => {\n  console.log(\"arcgis-feature-content is ready to go!\");\n});\n```"
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "creator",
+              "type": {
+                "text": "(((event?: PopupTemplateCreatorEvent | undefined) => PopupTemplateContent | Promise<PopupTemplateContent>))"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "destroy",
+              "description": "Permanently destroy the component.",
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "typescript",
+                      "module": "lib/lib.es5.d.ts",
+                      "start": 0,
+                      "end": 7
+                    }
+                  ]
+                }
+              },
+              "signature": "(): Promise<void>",
+              "async": true
+            },
+            {
+              "kind": "field",
+              "name": "destroyer",
+              "type": {
+                "text": "(((event?: PopupTemplateCreatorEvent | undefined) => PopupTemplateContent | Promise<PopupTemplateContent>))"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "graphic",
+              "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
+                  }
+                ]
+              }
+            }
+          ],
+          "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-feature-content/#destroy) method when you are done to\nprevent memory leaks.",
+              "type": {
+                "text": "boolean",
+                "values": [
+                  {
+                    "type": "boolean"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "autoDestroyDisabled"
+            }
+          ],
+          "events": [
+            {
+              "name": "arcgisReady",
+              "description": "Emitted when the component associated with a map or scene view is is ready to be interacted with.",
+              "type": {
+                "text": "void"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "arcgis-feature-content",
+          "declaration": {
+            "name": "ArcgisFeatureContent",
+            "module": "src/components/feature-content/feature-content.tsx"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/feature-form/feature-form.tsx",
@@ -16722,7 +16888,7 @@
               "name": "layer",
               "description": "Layer containing the editable feature attributes.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-FeatureForm.html#layer)",
               "type": {
-                "text": "FeatureLayer | GeoJSONLayer | OrientedImageryLayer | SceneLayer | SubtypeSublayer",
+                "text": "FeatureLayer | GeoJSONLayer | KnowledgeGraphSublayer | OrientedImageryLayer | SceneLayer | SubtypeSublayer",
                 "references": [
                   {
                     "name": "FeatureLayer",
@@ -16740,29 +16906,37 @@
                     "start": 15,
                     "end": 27
                   },
+                  {
+                    "name": "KnowledgeGraphSublayer",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-knowledgeGraph-KnowledgeGraphSublayer.html",
+                    "start": 30,
+                    "end": 52
+                  },
                   {
                     "name": "OrientedImageryLayer",
                     "package": "@arcgis/core",
                     "module": "interfaces.d.ts",
                     "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-OrientedImageryLayer.html",
-                    "start": 30,
-                    "end": 50
+                    "start": 55,
+                    "end": 75
                   },
                   {
                     "name": "SceneLayer",
                     "package": "@arcgis/core",
                     "module": "interfaces.d.ts",
                     "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html",
-                    "start": 53,
-                    "end": 63
+                    "start": 78,
+                    "end": 88
                   },
                   {
                     "name": "SubtypeSublayer",
                     "package": "@arcgis/core",
                     "module": "interfaces.d.ts",
                     "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SubtypeSublayer.html",
-                    "start": 66,
-                    "end": 81
+                    "start": 91,
+                    "end": 106
                   }
                 ],
                 "values": [
@@ -16772,6 +16946,9 @@
                   {
                     "type": "GeoJSONLayer"
                   },
+                  {
+                    "type": "KnowledgeGraphSublayer"
+                  },
                   {
                     "type": "OrientedImageryLayer"
                   },
@@ -29881,7 +30058,7 @@
             {
               "kind": "method",
               "name": "viewOnReady",
-              "description": "`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.",
+              "description": "`viewOnReady()` may be leveraged once an instance of the component and its underlying [view](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/#view) is created and ready.\nThis method takes two input parameters, a `callback` function and an `errback` function, and returns a promise. The `callback` executes when the promise resolves, and the `errback` executes if the promise is rejected.",
               "parameters": [
                 {
                   "name": "callback",
@@ -29937,6 +30114,20 @@
                   ]
                 }
               },
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.33"
+                },
+                {
+                  "name": "see",
+                  "text": "[Watch for changes - waiting for components or views to be ready](https://developers.arcgis.com/javascript/latest/watch-for-changes/#waiting-for-components-or-views-to-be-ready)"
+                },
+                {
+                  "name": "example",
+                  "text": "```js\nconst viewElement = document.querySelector(\"arcgis-link-chart\");\nawait viewElement.viewOnReady();\n// The view is now ready to be used.\n```"
+                }
+              ],
               "signature": "(callback?: (): void, errback?: (error: Error) => void): Promise<void>",
               "async": true
             },
@@ -30692,7 +30883,7 @@
               "docsTags": [
                 {
                   "name": "see",
-                  "text": "[Calcite Icon Search](https://next.gha.afd.arcgis.com/calcite-design-system/icons/)"
+                  "text": "[Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)"
                 }
               ]
             },
@@ -33353,7 +33544,7 @@
             {
               "kind": "method",
               "name": "viewOnReady",
-              "description": "`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.",
+              "description": "`viewOnReady()` may be leveraged once an instance of the component and its underlying [view](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#view) is created and ready.\nThis method takes two input parameters, a `callback` function and an `errback` function, and returns a promise. The `callback` executes when the promise resolves, and the `errback` executes if the promise is rejected.",
               "parameters": [
                 {
                   "name": "callback",
@@ -33409,6 +33600,20 @@
                   ]
                 }
               },
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.33"
+                },
+                {
+                  "name": "see",
+                  "text": "[Watch for changes - waiting for components or views to be ready](https://developers.arcgis.com/javascript/latest/watch-for-changes/#waiting-for-components-or-views-to-be-ready)"
+                },
+                {
+                  "name": "example",
+                  "text": "```js\nconst viewElement = document.querySelector(\"arcgis-map\");\nawait viewElement.viewOnReady();\n// The view is now ready to be used.\nviewElement.map.add(new FeatureLayer({...}));\n```"
+                }
+              ],
               "signature": "(callback?: (): void, errback?: (error: Error) => void): Promise<void>",
               "async": true
             },
@@ -36629,7 +36834,7 @@
             {
               "kind": "field",
               "name": "outSpatialReference",
-              "description": "The [spatial reference](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-SpatialReference.html) used to render the printed map on the server.",
+              "description": "The [spatial reference](https://next.sites.afd.arcgis.com/javascript/latest/api-reference/esri-geometry-SpatialReference.html) used to render the printed map on the server.",
               "type": {
                 "text": "SpatialReference",
                 "references": [
@@ -36647,7 +36852,7 @@
             {
               "kind": "field",
               "name": "portal",
-              "description": "It is possible to search a specified portal instance's [locator services](https://enterprise.arcgis.com/en/portal/latest/administer/windows/configure-portal-to-geocode-addresses.htm).\nUse this property to set this [ArcGIS Portal](https://enterprise.arcgis.com/en/portal/) instance to search.\nThis is especially helpful when working with a [custom template](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-CustomTemplate.html).\n\nIf this property is set, it is not necessary to set the [printServiceUrl](#printServiceUrl) property.",
+              "description": "It is possible to search a specified portal instance's [locator services](https://enterprise.arcgis.com/en/portal/latest/administer/windows/configure-portal-to-geocode-addresses.htm).\nUse this property to set this [ArcGIS Portal](https://enterprise.arcgis.com/en/portal/) instance to search.\nThis is especially helpful when working with a [custom](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-CustomTemplate.html).\n\nIf this property is set, it is not necessary to set the [printServiceUrl](#printServiceUrl) property.",
               "type": {
                 "text": "Portal",
                 "references": [
@@ -36728,7 +36933,7 @@
             {
               "kind": "field",
               "name": "referenceElement",
-              "description": "By passing the `id` of the Map or Scene component into this property, you can position components from the `@arcgis/map-components`\npackage anywhere in the DOM while still maintaining a connection to the Map or Scene.\n\nSee [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component).",
+              "description": "By passing the `id` of the Map or Scene component into this property, you can position components from the `@arcgis/map-components`\npackage anywhere in the DOM while still maintaining a connection to the Map or Scene.\n\nSee [Associate components with a Map or Scene component](https://next.sites.afd.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component).",
               "type": {
                 "text": "HTMLArcgisLinkChartElement | HTMLArcgisMapElement | HTMLArcgisSceneElement | string",
                 "references": [
@@ -37126,7 +37331,7 @@
             },
             {
               "name": "reference-element",
-              "description": "By passing the `id` of the Map or Scene component into this property, you can position components from the `@arcgis/map-components`\npackage anywhere in the DOM while still maintaining a connection to the Map or Scene.\n\nSee [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component).",
+              "description": "By passing the `id` of the Map or Scene component into this property, you can position components from the `@arcgis/map-components`\npackage anywhere in the DOM while still maintaining a connection to the Map or Scene.\n\nSee [Associate components with a Map or Scene component](https://next.sites.afd.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -40115,7 +40320,7 @@
             {
               "kind": "method",
               "name": "viewOnReady",
-              "description": "`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.",
+              "description": "`viewOnReady()` may be leveraged once an instance of the component and its underlying [view](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#view) is created and ready.\nThis method takes two input parameters, a `callback` function and an `errback` function, and returns a promise. The `callback` executes when the promise resolves, and the `errback` executes if the promise is rejected.",
               "parameters": [
                 {
                   "name": "callback",
@@ -40171,6 +40376,20 @@
                   ]
                 }
               },
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.33"
+                },
+                {
+                  "name": "see",
+                  "text": "[Watch for changes - waiting for components or views to be ready](https://developers.arcgis.com/javascript/latest/watch-for-changes/#waiting-for-components-or-views-to-be-ready)"
+                },
+                {
+                  "name": "example",
+                  "text": "```js\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\n// The view is now ready to be used.\nviewElement.map.add(new FeatureLayer({...}));\n```"
+                }
+              ],
               "signature": "(callback?: (): void, errback?: (error: Error) => void): Promise<void>",
               "async": true
             },