@arcgis/map-components 4.34.0-next.4 → 4.34.0-next.40

package/dist/components/arcgis-link-chart/customElement.d.ts

@@ -6,7 +6,7 @@ import { default as LinkChartView } from '@arcgis/core/views/LinkChartView.js';
 import { default as WebLinkChart } from '@arcgis/core/WebLinkChart.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 
-declare const useWebLinkChart: (component: LitElement & Omit<Pick<WebLinkChart, "basemap" | "ground" | "layers" | "bookmarks" | "tables" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "initialViewProperties" | "linkChartProperties" | "mapType" | "portalItem" | "thumbnailUrl">, "basemap" | "ground" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "layers" | "bookmarks" | "tables" | "presentation" | "knowledgeGraph" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "entityCount" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "linkChartProperties" | "mapType" | "portalItem" | "relationshipCount" | "thumbnailUrl"> & {
+declare const useWebLinkChart: (component: LitElement & Omit<Pick<WebLinkChart, "basemap" | "focusAreas" | "ground" | "layers" | "bookmarks" | "tables" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "initialViewProperties" | "linkChartProperties" | "mapType" | "portalItem" | "thumbnailUrl">, "basemap" | "ground" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "layers" | "bookmarks" | "tables" | "presentation" | "knowledgeGraph" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "entityCount" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "linkChartProperties" | "mapType" | "portalItem" | "relationshipCount" | "thumbnailUrl"> & {
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }) => WebLinkChart;
@@ -89,13 +89,14 @@ export declare class ArcgisLinkChart extends LitElement {
     fatalError: nullish | __esri.Error;
     /**
      * Allows for adding graphics directly to the default graphics in the View.
-     * Example:
-     * ```
+     *
+     * @example
+     * ```js
      * // Adds a graphic to the View
      * graphics.add(pointGraphic);
      * ```
-     * Example:
-     * ```
+     * @example
+     * ```js
      * // Removes a graphic from the View
      * graphics.remove(pointGraphic);
      * ```
@@ -131,7 +132,7 @@ export declare class ArcgisLinkChart extends LitElement {
      * An instance of a [WebLinkChart](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebLinkChart.html)
      * object to display in the view.
      */
-    map: WebLinkChart;
+    map: WebLinkChart | nullish;
     /**
      * Indication whether the view is being navigated (for example when panning).
      *
@@ -270,14 +271,14 @@ export declare class ArcgisLinkChart extends LitElement {
     set zoom(newValue: number);
     /**
      * @deprecated
-     * since 4.33. Use `element.map.add(layer)` instead.
+     * since 4.33, use `element.map.add(layer)` instead.
      *
      * Adds a layer to the map layers collection.
      */
     addLayer(layer: __esri.Layer | Promise<any>, index?: number): Promise<void>;
     /**
      * @deprecated
-     * since 4.33. Use `element.map.addMany([layer])` instead.
+     * since 4.33, use `element.map.addMany([layer])` instead.
      *
      * Adds a layer or array of layers to the map layers collection.
      */
@@ -300,8 +301,17 @@ export declare class ArcgisLinkChart extends LitElement {
     /** Gets the LayerView created on the view for the given layer. */
     whenLayerView(layer: __esri.Layer): Promise<__esri.LayerView>;
     /**
-     * `viewOnReady()` may be leveraged once an instance of the component is created and ready.
-     * This method takes two input parameters: a `callback` function and an `errback` function.
+     * `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.
+     * This 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.
+     *
+     * @since 4.33
+     * @see [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)
+     * @example
+     * ```js
+     * const viewElement = document.querySelector("arcgis-link-chart");
+     * await viewElement.viewOnReady();
+     * // The view is now ready to be used.
+     * ```
      */
     viewOnReady(callback?: () => void, errback?: (error: Error) => void): Promise<void>;
     /**

package/dist/components/arcgis-link-chart/customElement.js

@@ -8,8 +8,8 @@ import { c as v, i as l } from "../../chunks/component-utils.js";
 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.4 */
-const d = m`@layer{arcgis-link-chart{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, g = r(
+v4.34.0-next.40 */
+const g = m`@layer{arcgis-link-chart{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, d = r(
   w,
   /**
    * Since omitProps is only needed for typing, not runtime, `{} as { ... }` is
@@ -23,18 +23,18 @@ const d = m`@layer{arcgis-link-chart{display:block;height:100%;.esri-view{height
 ), y = r(o, {});
 class u extends c {
   constructor() {
-    super(), this._map = g(this), this.view = y(this), this.allLayerViews = this.view.allLayerViews, this.autoDestroyDisabled = !1, this.background = this.view.background, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, this.constraints = this.view.constraints, this.displayFilterDisabled = this.view.displayFilterEnabled, this.fatalError = this.view.fatalError, this.graphics = this.view.graphics, this.highlights = this.view.highlights, this.layerViews = this.view.layerViews, this.magnifier = this.view.magnifier, this.map = this.view.map, this.navigation = this.view.navigation, this.padding = this.view.padding, this.popup = this.view.popup, this.popupDisabled = this.view.popupEnabled, this.ready = this.view.ready, this.resizeAlign = this.view.resizeAlign, this.resolution = this.view.resolution, this.rotation = this.view.rotation, this.spatialReference = this.view.spatialReference, this.suspended = this.view.suspended, this.theme = this.view.theme, this.timeExtent = this.view.timeExtent, this.timeZone = this.view.timeZone, this.updating = this.view.updating, this.arcgisViewChange = a(), this.arcgisViewClick = e(() => this.view, "click"), this.arcgisViewDoubleClick = e(() => this.view, "double-click"), this.arcgisViewDrag = e(() => this.view, "drag"), this.arcgisViewHold = e(() => this.view, "hold"), this.arcgisViewImmediateClick = e(() => this.view, "immediate-click"), this.arcgisViewImmediateDoubleClick = e(() => this.view, "immediate-double-click"), this.arcgisViewKeyDown = e(() => this.view, "key-down"), this.arcgisViewKeyUp = e(() => this.view, "key-up"), this.arcgisViewLayerviewCreate = e(() => this.view, "layerview-create"), this.arcgisViewLayerviewCreateError = e(() => this.view, "layerview-create-error"), this.arcgisViewLayerviewDestroy = e(() => this.view, "layerview-destroy"), this.arcgisViewMouseWheel = e(() => this.view, "mouse-wheel"), this.arcgisViewPointerDown = e(() => this.view, "pointer-down"), this.arcgisViewPointerEnter = e(() => this.view, "pointer-enter"), this.arcgisViewPointerLeave = e(() => this.view, "pointer-leave"), this.arcgisViewPointerMove = e(() => this.view, "pointer-move"), this.arcgisViewPointerUp = e(() => this.view, "pointer-up"), this.arcgisViewReadyChange = a(), this.view.ui = {
+    super(), this._map = d(this), this.view = y(this), this.allLayerViews = this.view.allLayerViews, this.autoDestroyDisabled = !1, this.background = this.view.background, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, this.constraints = this.view.constraints, this.displayFilterDisabled = this.view.displayFilterEnabled, this.fatalError = this.view.fatalError, this.graphics = this.view.graphics, this.highlights = this.view.highlights, this.layerViews = this.view.layerViews, this.magnifier = this.view.magnifier, this.map = this.view.map, this.navigation = this.view.navigation, this.padding = this.view.padding, this.popup = this.view.popup, this.popupDisabled = this.view.popupEnabled, this.ready = this.view.ready, this.resizeAlign = this.view.resizeAlign, this.resolution = this.view.resolution, this.rotation = this.view.rotation, this.spatialReference = this.view.spatialReference, this.suspended = this.view.suspended, this.theme = this.view.theme, this.timeExtent = this.view.timeExtent, this.timeZone = this.view.timeZone, this.updating = this.view.updating, this.arcgisViewChange = a(), this.arcgisViewClick = e(() => this.view, "click"), this.arcgisViewDoubleClick = e(() => this.view, "double-click"), this.arcgisViewDrag = e(() => this.view, "drag"), this.arcgisViewHold = e(() => this.view, "hold"), this.arcgisViewImmediateClick = e(() => this.view, "immediate-click"), this.arcgisViewImmediateDoubleClick = e(() => this.view, "immediate-double-click"), this.arcgisViewKeyDown = e(() => this.view, "key-down"), this.arcgisViewKeyUp = e(() => this.view, "key-up"), this.arcgisViewLayerviewCreate = e(() => this.view, "layerview-create"), this.arcgisViewLayerviewCreateError = e(() => this.view, "layerview-create-error"), this.arcgisViewLayerviewDestroy = e(() => this.view, "layerview-destroy"), this.arcgisViewMouseWheel = e(() => this.view, "mouse-wheel"), this.arcgisViewPointerDown = e(() => this.view, "pointer-down"), this.arcgisViewPointerEnter = e(() => this.view, "pointer-enter"), this.arcgisViewPointerLeave = e(() => this.view, "pointer-leave"), this.arcgisViewPointerMove = e(() => this.view, "pointer-move"), this.arcgisViewPointerUp = e(() => this.view, "pointer-up"), this.arcgisViewReadyChange = a(), this.view.ui = {
       components: ["attribution"]
     };
   }
   static {
-    this.properties = { _map: 16, view: 32, allLayerViews: 0, autoDestroyDisabled: 5, background: 0, basemap: 1, basemapView: 0, center: 1, constraints: 0, displayFilterDisabled: 5, extent: 0, fatalError: 0, graphics: 0, highlights: 0, interacting: 32, itemId: 3, layerViews: 0, magnifier: 0, map: 0, navigating: 32, navigation: 0, padding: 0, popup: 0, popupDisabled: 5, ready: 4, resizeAlign: 1, resolution: 8, rotation: 9, scale: 9, spatialReference: 0, stationary: 32, suspended: 7, theme: 0, timeExtent: 0, timeZone: 1, updating: 4, viewpoint: 0, zoom: 9 };
+    this.properties = { _map: 16, view: 32, allLayerViews: 0, autoDestroyDisabled: 5, background: 0, basemap: 1, basemapView: 0, center: 1, constraints: 0, displayFilterDisabled: 5, extent: 0, fatalError: 0, focusAreas: 0, graphics: 0, highlights: 0, interacting: 32, itemId: 3, layerViews: 0, magnifier: 0, map: 0, navigating: 32, navigation: 0, padding: 0, popup: 0, popupDisabled: 5, ready: 4, resizeAlign: 1, resolution: 8, rotation: 9, scale: 9, spatialReference: 0, stationary: 32, suspended: 7, theme: 0, timeExtent: 0, timeZone: 1, updating: 4, viewpoint: 0, zoom: 9 };
   }
   static {
     this.shadowRootOptions = p;
   }
   static {
-    this.styles = d;
+    this.styles = g;
   }
   get center() {
     return this.view.center;
@@ -49,6 +49,15 @@ class u extends c {
   set extent(i) {
     this.extent?.equals(i) || (this.view.extent = i);
   }
+  get focusAreas() {
+    return this.map ? this.map?.focusAreas : {
+      areas: [],
+      style: "bright"
+    };
+  }
+  set focusAreas(i) {
+    this.map && (this.map.focusAreas = i);
+  }
   get interacting() {
     return this.view.interacting;
   }
@@ -83,10 +92,10 @@ class u extends c {
     this.view.zoom = i;
   }
   async addLayer(i, t) {
-    this.map.add(i, t);
+    this.map?.add(i, t);
   }
   async addLayers(i, t) {
-    this.map.addMany(i, t);
+    this.map?.addMany(i, t);
   }
   async closePopup() {
     this.view.closePopup();
@@ -121,7 +130,9 @@ class u extends c {
   }
   loaded() {
     this.map ||= this._map, this.manager.onLifecycle(() => [
-      s(() => this.map, () => this._map = this.map, { initial: !0, sync: !0 }),
+      s(() => this.map, (i) => {
+        i && (this._map = i);
+      }, { initial: !0, sync: !0 }),
       s(() => this.view.stationary, () => this.arcgisViewChange.emit(), { initial: !0 }),
       s(() => this.view.ready, () => this.arcgisViewReadyChange.emit(), { initial: this.view.ready })
     ]);

package/dist/components/arcgis-link-chart-layout-switcher/customElement.d.ts

@@ -55,7 +55,6 @@ export declare class ArcgisLinkChartLayoutSwitcher extends LitElement {
      * Icon displayed in the component's button, when `appearance` is `dropdown`.
      *
      * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
-     * @since 4.28
      * @default "nodes-link"
      */
     icon?: string;
@@ -69,7 +68,11 @@ export declare class ArcgisLinkChartLayoutSwitcher extends LitElement {
      * @default "organic-standard"
      */
     readonly layout: DiagramLayoutType;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     /** @default "top-left" */
     position: __esri.UIPosition;
@@ -81,6 +84,12 @@ export declare class ArcgisLinkChartLayoutSwitcher extends LitElement {
      * @default false
      */
     preventExtentUpdate: boolean;
+    /**
+     * 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.
+     *
+     * See also:
+     * - [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
     referenceElement?: ArcgisReferenceElement | string;
     /**
      * The current state of the widget.
@@ -98,9 +107,11 @@ export declare class ArcgisLinkChartLayoutSwitcher extends LitElement {
      * Fires when component has completed the layout switch
      *
      * @example
+     * ```js
      * layoutswitcher.addEventListener("arcgisSwitchLayout", (event) => {
      *   console.log("Layout Switched");
      * });
+     * ```
      */
     readonly arcgisSwitchLayout: TargetedEvent<this, __esri.LinkChartLayoutSwitcherViewModelSwitchLayoutEvent>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */

package/dist/components/arcgis-link-chart-layout-switcher/customElement.js

@@ -1,18 +1,17 @@
-import { c as d } from "../../chunks/runtime.js";
+import { c as n } from "../../chunks/runtime.js";
 import { html as e } from "lit-html";
-import { classes as m } from "@arcgis/components-utils";
-import { g as s } from "../../chunks/globalCss.js";
-import g from "@arcgis/core/widgets/LinkChartLayoutSwitcher/LinkChartLayoutSwitcherViewModel.js";
-import { usePropertyChange as p } from "@arcgis/lumina/controllers";
-import { m as u } from "../../chunks/useViewModel.js";
-import { u as y } from "../../chunks/useT9n.js";
-import { reEmitEvent as w } from "@arcgis/lumina/controllers/accessor";
-import { LitElement as b, createEvent as f, noShadowRoot as v, safeClassMap as c } from "@arcgis/lumina";
-import { css as $ } from "@lit/reactive-element/css-tag.js";
+import { classes as h } from "@arcgis/components-utils";
+import d from "@arcgis/core/widgets/LinkChartLayoutSwitcher/LinkChartLayoutSwitcherViewModel.js";
+import { usePropertyChange as m } from "@arcgis/lumina/controllers";
+import { m as g } from "../../chunks/useViewModel.js";
+import { u as p } from "../../chunks/useT9n.js";
+import { reEmitEvent as u } from "@arcgis/lumina/controllers/accessor";
+import { LitElement as y, createEvent as w, noShadowRoot as b, safeClassMap as f } from "@arcgis/lumina";
+import { css as v } 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.4 */
-const L = $`@layer{arcgis-link-chart-layout-switcher{display:block}}`, l = {
+v4.34.0-next.40 */
+const L = v`@layer{arcgis-link-chart-layout-switcher{display:block}}`, c = {
   basicLayoutCategory: [
     "basic-grid"
     /* SIMPLE */
@@ -37,7 +36,7 @@ const L = $`@layer{arcgis-link-chart-layout-switcher{display:block}}`, l = {
     "chronological-multi-timeline"
     /* CHRONOLOGICAL_MULTIPLE */
   ]
-}, n = {
+}, s = {
   "organic-standard": "force-directed-link-chart-layout",
   "organic-community": "community-link-chart-layout",
   "basic-grid": "simple-link-chart-layout",
@@ -47,7 +46,7 @@ const L = $`@layer{arcgis-link-chart-layout-switcher{display:block}}`, l = {
   "geographic-organic-standard": "geographic-link-chart-layout",
   "chronological-mono-timeline": "single-timeline",
   "chronological-multi-timeline": "multi-timeline"
-}, h = {
+}, l = {
   "organic-standard": "forceDirected",
   "organic-community": "community",
   "basic-grid": "simple",
@@ -57,18 +56,18 @@ const L = $`@layer{arcgis-link-chart-layout-switcher{display:block}}`, l = {
   "geographic-organic-standard": "geographic",
   "chronological-mono-timeline": "chronologicalSingle",
   "chronological-multi-timeline": "chronologicalMultiple"
-}, k = {
+}, $ = {
   base: "esri-link-chart-layout-switcher"
-}, M = u(g);
-class C extends b {
+}, k = g(d);
+class M extends y {
   constructor() {
-    super(...arguments), this.messages = y(), this.viewModel = M(this), this.appearance = "dropdown", this.autoDestroyDisabled = !1, this.closeOnSelectDisabled = !1, this.icon = "nodes-link", this.layout = this.viewModel.layout, this.position = "top-left", this.preventExtentUpdate = this.viewModel.preventExtentUpdate, this.state = this.viewModel.state, this.arcgisSwitchLayout = w(() => this.viewModel, "switchLayout"), this.arcgisPropertyChange = p()("state"), this.arcgisReady = f();
+    super(...arguments), this.messages = p(), this.viewModel = k(this), this.appearance = "dropdown", this.autoDestroyDisabled = !1, this.closeOnSelectDisabled = !1, this.icon = "nodes-link", this.layout = this.viewModel.layout, this.position = "top-left", this.preventExtentUpdate = this.viewModel.preventExtentUpdate, this.state = this.viewModel.state, this.arcgisSwitchLayout = u(() => this.viewModel, "switchLayout"), this.arcgisPropertyChange = m()("state"), this.arcgisReady = w();
   }
   static {
     this.properties = { appearance: 1, autoDestroyDisabled: 5, closeOnSelectDisabled: 5, icon: 1, label: 1, layout: 32, messageOverrides: 0, position: 3, preventExtentUpdate: 5, referenceElement: 1, state: 3 };
   }
   static {
-    this.shadowRootOptions = v;
+    this.shadowRootOptions = b;
   }
   static {
     this.styles = L;
@@ -80,19 +79,19 @@ class C extends b {
     this.viewModel.switchLayout(t);
   }
   _renderDropdown() {
-    const { messages: t, icon: o } = this;
-    return e`<calcite-dropdown scale=s width=m max-items=9 .closeOnSelectDisabled=${this.closeOnSelectDisabled}><calcite-button class=${c(s.widgetButton)} slot=trigger kind=neutral .disabled=${this.viewModel.state === "disabled"} .iconStart=${o ?? void 0} .label=${t.layoutOptions ?? "Layout"}></calcite-button>${Object.entries(l).map(([r, i]) => e`<calcite-dropdown-group selection-mode=single .groupTitle=${this.messages[r]}>${i.map((a) => e`<calcite-dropdown-item .iconStart=${n[a]} .selected=${a === this.layout ? !0 : void 0} @click=${() => void this.switchLayout(a)}>${t[h[a]]}</calcite-dropdown-item>`)}</calcite-dropdown-group>`)}</calcite-dropdown>`;
+    const { messages: t, icon: a } = this;
+    return e`<calcite-dropdown scale=s width=m max-items=9 .closeOnSelectDisabled=${this.closeOnSelectDisabled}><calcite-action slot=trigger .disabled=${this.viewModel.state === "disabled"} .icon=${a ?? void 0} .label=${t.layoutOptions ?? "Layout"} appearance=solid scale=s .text=${t.layoutOptions ?? "Layout"}></calcite-action>${Object.entries(c).map(([r, i]) => e`<calcite-dropdown-group selection-mode=single .groupTitle=${this.messages[r]}>${i.map((o) => e`<calcite-dropdown-item .iconStart=${s[o]} .selected=${o === this.layout ? !0 : void 0} @click=${() => void this.switchLayout(o)}>${t[l[o]]}</calcite-dropdown-item>`)}</calcite-dropdown-group>`)}</calcite-dropdown>`;
   }
   _renderMenuBar() {
     const { messages: t } = this;
-    return e`<calcite-action-bar scale=s floating overflow-actions-disabled>${Object.entries(l).map(([o, r]) => e`<calcite-action-group .label=${this.messages[o]}>${r.map((i) => e`<calcite-action scale=s .icon=${n[i]} .active=${i === this.layout ? !0 : void 0} @click=${() => void this.switchLayout(i)} .text=${t[h[i]]}></calcite-action>`)}</calcite-action-group>`)}</calcite-action-bar>`;
+    return e`<calcite-action-bar scale=s floating overflow-actions-disabled>${Object.entries(c).map(([a, r]) => e`<calcite-action-group .label=${this.messages[a]}>${r.map((i) => e`<calcite-action scale=s .icon=${s[i]} .active=${i === this.layout ? !0 : void 0} @click=${() => void this.switchLayout(i)} .text=${t[l[i]]}></calcite-action>`)}</calcite-action-group>`)}</calcite-action-bar>`;
   }
   render() {
-    const { appearance: t } = this, o = t === "menu-bar" ? this._renderMenuBar() : this._renderDropdown();
-    return e`<div class=${c(m(k.base, s.widget))}>${o}</div>`;
+    const { appearance: t } = this, a = t === "menu-bar" ? this._renderMenuBar() : this._renderDropdown();
+    return e`<div class=${f(h($.base))}>${a}</div>`;
   }
 }
-d("arcgis-link-chart-layout-switcher", C);
+n("arcgis-link-chart-layout-switcher", M);
 export {
-  C as ArcgisLinkChartLayoutSwitcher
+  M as ArcgisLinkChartLayoutSwitcher
 };

package/dist/components/arcgis-link-chart-layout-switcher/index.d.ts

@@ -1,8 +1,7 @@
 import "@esri/calcite-components/components/calcite-dropdown";
-import "@esri/calcite-components/components/calcite-button";
+import "@esri/calcite-components/components/calcite-action";
 import "@esri/calcite-components/components/calcite-dropdown-group";
 import "@esri/calcite-components/components/calcite-dropdown-item";
 import "@esri/calcite-components/components/calcite-action-bar";
 import "@esri/calcite-components/components/calcite-action-group";
-import "@esri/calcite-components/components/calcite-action";
 export * from "./customElement.js";

package/dist/components/arcgis-link-chart-layout-switcher/index.js

@@ -1,8 +1,7 @@
 import "@esri/calcite-components/components/calcite-dropdown";
-import "@esri/calcite-components/components/calcite-button";
+import "@esri/calcite-components/components/calcite-action";
 import "@esri/calcite-components/components/calcite-dropdown-group";
 import "@esri/calcite-components/components/calcite-dropdown-item";
 import "@esri/calcite-components/components/calcite-action-bar";
 import "@esri/calcite-components/components/calcite-action-group";
-import "@esri/calcite-components/components/calcite-action";
 export * from "./customElement.js";

package/dist/components/arcgis-locate/LocateViewModel.d.ts

@@ -1,5 +1,4 @@
 import { default as ActionButton } from '@arcgis/core/support/actions/ActionButton.js';
-import { Nil } from '@arcgis/components-utils';
 import { default as GeolocationPositioning } from '../../geolocation/GeolocationPositioning';
 import { ArcgisLocate } from './customElement.js';
 type State = "disabled" | "error" | "feature-unsupported" | "locating" | "ready";
@@ -8,10 +7,10 @@ declare class LocateViewModel extends GeolocationPositioning {
     constructor(properties?: Partial<LocateViewModel>);
     protected initialize(): void;
     destroy(): void;
-    private _locateController;
-    currentPosition: GeolocationPosition | null;
-    error: GeolocationPositionError | Nil;
-    messages: Nil | NonNullable<ArcgisLocate["messageOverrides"]>;
+    private _locateController?;
+    currentPosition?: GeolocationPosition;
+    error?: GeolocationPositionError;
+    messages?: NonNullable<ArcgisLocate["messageOverrides"]>;
     popupEnabled: boolean;
     get state(): State;
     locate(): Promise<GeolocationPosition | null>;

package/dist/components/arcgis-locate/customElement.d.ts

@@ -1,7 +1,6 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 import { default as LocateViewModel } from './LocateViewModel';
@@ -10,6 +9,10 @@ declare const useLocateViewModel: (component: LitElement & Pick<LocateViewModel,
 /**
  * The Locate component animates the Map or Scene to the user's current location.
  *
+ * This component uses the browser's [Geolocation API](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation_API) which is only available in [secure contexts](https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts), such as HTTPS.
+ * Note that localhost is considered "potentially secure" and can be used for easy testing in browsers that support
+ * [Window.isSecureContext](https://developer.mozilla.org/en-US/docs/Web/API/isSecureContext#browser_compatibility).
+ *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-locate/)
  */
 export declare class ArcgisLocate extends LitElement {
@@ -23,26 +26,35 @@ export declare class ArcgisLocate extends LitElement {
      * @default false
      */
     autoDestroyDisabled: boolean;
-    geolocationOptions: Nil | PositionOptions;
+    geolocationOptions: PositionOptions | undefined;
     /**
      * Indicates whether to navigate the view to the position and scale of the geolocated result.
      *
      * @default false
      */
     goToLocationDisabled: boolean;
-    goToOverride: Nil | __esri.GoToOverride;
+    goToOverride: __esri.GoToOverride | undefined;
     /** The graphic used to show the user's location on the map. */
     graphic: __esri.Graphic;
     /** @default "gps-off" */
     icon?: string | undefined;
     /** The component's default label. */
     label?: string;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     /** @default false */
     popupDisabled: boolean;
     /** @default "top-left" */
     position: __esri.UIPosition;
+    /**
+     * 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.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
     referenceElement?: ArcgisReferenceElement | string;
     /**
      * Indicates the scale to set on the view when navigating to the position of the geolocated
@@ -50,7 +62,7 @@ export declare class ArcgisLocate extends LitElement {
      *
      * @default null
      */
-    scale: number | Nil;
+    scale: number | undefined;
     /** The current state of the component. */
     state: "ready" | "disabled" | "error" | "feature-unsupported" | "locating";
     /**