@arcgis/map-components 4.34.0-next.12 → 4.34.0-next.120

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

@@ -1,16 +1,20 @@
-import { c as h } from "../../chunks/runtime.js";
-import { makeAccessorController as r, reEmitEvent as e, reCreateAccessor as n } from "@arcgis/lumina/controllers/accessor";
+import { c as p } from "../../chunks/runtime.js";
+import { html as a } from "lit";
 import { watch as s } from "@arcgis/core/core/reactiveUtils.js";
-import o from "@arcgis/core/views/LinkChartView.js";
-import w from "@arcgis/core/WebLinkChart.js";
-import { LitElement as c, createEvent as a, noShadowRoot as p } from "@arcgis/lumina";
-import { c as v, i as l } from "../../chunks/component-utils.js";
-import { css as m } from "@lit/reactive-element/css-tag.js";
+import v from "@arcgis/core/views/LinkChartView.js";
+import l from "@arcgis/core/WebLinkChart.js";
+import { LitElement as m, createEvent as r, safeClassMap as h } from "@arcgis/lumina";
+import { useDirection as g } from "@arcgis/lumina/controllers";
+import { makeAccessorController as c, reEmitEvent as e, reCreateAccessor as d } from "@arcgis/lumina/controllers/accessor";
+import { createRef as n, ref as o } from "lit/directives/ref.js";
+import { C as w, s as y } from "../../chunks/slots.js";
+import { c as u, i as f } from "../../chunks/component-utils.js";
+import { s as V, a as b } from "../../chunks/slots2.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.12 */
-const d = m`@layer{arcgis-link-chart{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, g = r(
-  w,
+v4.34.0-next.120 */
+const C = c(
+  l,
   /**
    * Since omitProps is only needed for typing, not runtime, `{} as { ... }` is
    * a hack to remove them from the runtime code. This argument is not used at
@@ -20,27 +24,24 @@ const d = m`@layer{arcgis-link-chart{display:block;height:100%;.esri-view{height
    * in an externalized package.
    */
   {}
-), y = r(o, {});
-class u extends c {
+), k = c(v, {});
+class E extends m {
   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._containerRef = n(), this._direction = g(), this._mapRef = n(), this._map = C(this), this.view = k(this), this.allLayerViews = this.view.allLayerViews, this.analyses = this.view.analyses, 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.arcgisViewAnalysisViewCreate = e(() => this.view, "analysis-view-create"), this.arcgisViewAnalysisViewCreateError = e(() => this.view, "analysis-view-create-error"), this.arcgisViewAnalysisViewDestroy = e(() => this.view, "analysis-view-destroy"), this.arcgisViewChange = r(), 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 = r(), 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, analyses: 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 = [V, b];
   }
   get center() {
     return this.view.center;
   }
   set center(i) {
-    const t = v(i, this.view);
+    const t = u(i, this.view);
     t && (this.view.center = t);
   }
   get extent() {
@@ -49,6 +50,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;
   }
@@ -56,7 +66,7 @@ class u extends c {
     return this._map.portalItem?.id;
   }
   set itemId(i) {
-    n(this._map, this), this._map.portalItem = { id: i }, this.view.map = this._map;
+    d(this._map, this), this._map.portalItem = { id: i }, this.view.map = this._map;
   }
   get navigating() {
     return this.view.navigating;
@@ -74,7 +84,7 @@ class u extends c {
     return this.view.viewpoint;
   }
   set viewpoint(i) {
-    l(this.viewpoint, i) && (this.view.viewpoint = i);
+    f(this.viewpoint, i) && (this.view.viewpoint = i);
   }
   get zoom() {
     return this.view.zoom;
@@ -83,10 +93,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();
@@ -109,25 +119,33 @@ class u extends c {
   async tryFatalErrorRecovery() {
     this.view.tryFatalErrorRecovery();
   }
-  async whenLayerView(i) {
-    return await this.view.whenLayerView(i);
-  }
   async viewOnReady(i, t) {
     return await this.componentOnReady(), await this.view.whenReady().then(() => i?.()).catch(t);
   }
-  load() {
-    const i = this;
-    i.el.childElem = document.createElement("div"), i.el.append(i.el.childElem), this.view.container = i.el.childElem;
+  async whenAnalysisView(i) {
+    return await this.view.whenAnalysisView(i);
+  }
+  async whenLayerView(i) {
+    return await this.view.whenLayerView(i);
   }
   loaded() {
-    this.map ||= this._map, this.manager.onLifecycle(() => [
-      s(() => this.map, () => this._map = this.map, { initial: !0, sync: !0 }),
+    const i = this;
+    i.el.childElem = this._mapRef.value, this.view.container ??= i.el.childElem, this.map ||= this._map, this.manager.onLifecycle(() => [
+      s(() => this.map, (t) => {
+        t && (this._map = t);
+      }, { initial: !0, sync: !0 }),
       s(() => this.view.stationary, () => this.arcgisViewChange.emit(), { initial: !0 }),
       s(() => this.view.ready, () => this.arcgisViewReadyChange.emit(), { initial: this.view.ready })
     ]);
   }
+  renderMain() {
+    return a`<div class=${h(w.base)} ${o(this._mapRef)}></div>`;
+  }
+  render() {
+    return a`<section class=${h(w.containerUI)} ${o(this._containerRef)}>${y(this._direction)}</section>${this.renderMain()}`;
+  }
 }
-h("arcgis-link-chart", u);
+p("arcgis-link-chart", E);
 export {
-  u as ArcgisLinkChart
+  E as ArcgisLinkChart
 };

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

@@ -1,5 +1,5 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
+/// <reference path="../../index.d.ts" />
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 import { Use } from '@arcgis/lumina/controllers';
 import { default as LinkChartLayoutSwitcherViewModel } from '@arcgis/core/widgets/LinkChartLayoutSwitcher/LinkChartLayoutSwitcherViewModel.js';
@@ -68,10 +68,14 @@ 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;
+    /** @deprecated since 4.34, use `slot` instead. */
+    position?: __esri.UIPosition;
     /**
      * Prevents extent from updating on changes to the layout.
      *
@@ -80,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.
@@ -108,7 +118,7 @@ export declare class ArcgisLinkChartLayoutSwitcher extends LitElement {
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
     private messages: Partial<{
         layoutOptions: string;

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

@@ -1,18 +1,15 @@
-import { c as d } 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 { c as n } from "../../chunks/runtime.js";
+import { css as h, html as e } from "lit";
+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, safeClassMap as b } from "@arcgis/lumina";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.12 */
-const L = $`@layer{arcgis-link-chart-layout-switcher{display:block}}`, l = {
+v4.34.0-next.120 */
+const v = h``, c = {
   basicLayoutCategory: [
     "basic-grid"
     /* SIMPLE */
@@ -37,7 +34,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 +44,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,21 +54,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 {
+}, L = {
+  base: "link-chart-layout-switcher"
+}, $ = g(d);
+class f 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 = $(this), this.appearance = "dropdown", this.autoDestroyDisabled = !1, this.closeOnSelectDisabled = !1, this.icon = "nodes-link", this.layout = this.viewModel.layout, 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;
-  }
-  static {
-    this.styles = L;
+    this.styles = v;
   }
   async destroy() {
     await this.manager.destroy();
@@ -80,19 +74,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=${b(L.base)}>${a}</div>`;
   }
 }
-d("arcgis-link-chart-layout-switcher", C);
+n("arcgis-link-chart-layout-switcher", f);
 export {
-  C as ArcgisLinkChartLayoutSwitcher
+  f 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" />
+/// <reference path="../../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;
+    /** @deprecated since 4.34, use `slot` instead. */
+    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";
     /**
@@ -68,7 +80,7 @@ export declare class ArcgisLocate extends LitElement {
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
     readonly arcgisSuccess: TargetedEvent<this, {
         position: GeolocationPosition;