@arcgis/map-components 4.33.0-next.5 → 4.33.0-next.51

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

@@ -1,16 +1,16 @@
-import { c } from "../../chunks/runtime.js";
-import { makeAccessorController as r, reEmitEvent as t, accessorSupport as v } from "@arcgis/components-controllers/accessor";
+import { c as v } from "../../chunks/runtime.js";
+import { makeAccessorController as r, reEmitEvent as e, accessorSupport as d } from "@arcgis/components-controllers/accessor";
 import { watch as s } from "@arcgis/core/core/reactiveUtils.js";
-import d from "@arcgis/core/views/LinkChartView.js";
-import l from "@arcgis/core/WebLinkChart.js";
-import { LitElement as p, createEvent as a, noShadowRoot as m } from "@arcgis/lumina";
+import p from "@arcgis/core/views/LinkChartView.js";
+import n from "@arcgis/core/WebLinkChart.js";
+import { LitElement as l, createEvent as a, noShadowRoot as m } from "@arcgis/lumina";
 import { e as h, i as g } from "../../chunks/component-utils.js";
 import { css as y } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.5 */
-const u = y`.arcgis-link-chart{padding:0;margin:0;height:100%;width:100%}`, f = r(
-  l,
+v4.33.0-next.51 */
+const u = y`@layer{arcgis-link-chart{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, f = r(
+  n,
   /**
    * 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,15 +20,15 @@ const u = y`.arcgis-link-chart{padding:0;margin:0;height:100%;width:100%}`, f =
    * in an externalized package.
    */
   {}
-), V = r(d, {});
-class b extends p {
+), _ = r(p, {});
+class V extends l {
   constructor() {
-    super(...arguments), this._center = void 0, this._extent = void 0, this._itemId = void 0, this._map = f(this, {
+    super(...arguments), this._center = void 0, this._extent = void 0, this._itemId = void 0, this._scale = void 0, this._viewpoint = void 0, this._zoom = void 0, this._map = f(this, {
       editConstructorProperties: this._editMapProperties
-    }), this._scale = void 0, this._viewpoint = void 0, this._zoom = void 0, this.view = V(this, { editConstructorProperties: this._editViewProperties }), 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 = t(() => this.view, "click"), this.arcgisViewDoubleClick = t(() => this.view, "double-click"), this.arcgisViewDrag = t(() => this.view, "drag"), this.arcgisViewHold = t(() => this.view, "hold"), this.arcgisViewImmediateClick = t(() => this.view, "immediate-click"), this.arcgisViewImmediateDoubleClick = t(() => this.view, "immediate-double-click"), this.arcgisViewKeyDown = t(() => this.view, "key-down"), this.arcgisViewKeyUp = t(() => this.view, "key-up"), this.arcgisViewLayerviewCreate = t(() => this.view, "layer-view-create"), this.arcgisViewLayerviewCreateError = t(() => this.view, "layer-view-create-error"), this.arcgisViewLayerviewDestroy = t(() => this.view, "layer-view-destroy"), this.arcgisViewMouseWheel = t(() => this.view, "mouse-wheel"), this.arcgisViewPointerDown = t(() => this.view, "pointer-down"), this.arcgisViewPointerEnter = t(() => this.view, "pointer-enter"), this.arcgisViewPointerLeave = t(() => this.view, "pointer-leave"), this.arcgisViewPointerMove = t(() => this.view, "pointer-move"), this.arcgisViewPointerUp = t(() => this.view, "pointer-up"), this.arcgisViewReadyChange = a();
+    }), this.view = _(this, { editConstructorProperties: this._editViewProperties }), 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();
   }
   static {
-    this.properties = { 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: 7, 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, 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: 7, viewpoint: 0, zoom: 9 };
   }
   static {
     this.shadowRootOptions = m;
@@ -47,8 +47,8 @@ class b extends p {
     return this.view.center ?? this._center;
   }
   set center(i) {
-    const e = h(i, this.ready ? this.view : void 0);
-    e && (this.ready && (this.view.center = e), this._center = e);
+    const t = h(i, this.ready ? this.view : void 0);
+    t && (this.ready && (this.view.center = t), this._center = t);
   }
   /**
    * The extent represents the visible portion of a link chart within the view as an instance of
@@ -75,9 +75,9 @@ class b extends p {
     return this._map.portalItem?.id ?? this._itemId;
   }
   set itemId(i) {
-    this._itemId = i, this.ready && v.reCreate(this._map, this).then(() => {
+    this._itemId = i, this.ready ? d.reCreate(this._map, this).then(() => {
       this.view.map = this._map;
-    }).catch(console.error);
+    }).catch(console.error) : this.view.ready != null && (this._map.destroy(), this._map = new n(this._editMapProperties({ portalItem: { id: this._itemId } })), this.view.map = this._map);
   }
   /** Indication whether the view is being navigated (for example when panning). */
   get navigating() {
@@ -125,15 +125,15 @@ class b extends p {
   set zoom(i) {
     this.ready && (this.view.zoom = i), this._zoom = i;
   }
-  // #endregion
-  // #region Public Methods
+  //#endregion
+  //#region Public Methods
   /** Adds a layer to the layers collection. */
-  async addLayer(i, e) {
-    this.map?.add(i, e);
+  async addLayer(i, t) {
+    this.map?.add(i, t);
   }
   /** Adds a layer or array of layers to the layers collection. */
-  async addLayers(i, e) {
-    this.map?.addMany(i, e);
+  async addLayers(i, t) {
+    this.map?.addMany(i, t);
   }
   /** Closes the popup. */
   async closePopup() {
@@ -144,8 +144,8 @@ class b extends p {
     await this.manager.destroy();
   }
   /** Sets the view to a given target. */
-  async goTo(i, e) {
-    return await this.view?.goTo(i, e);
+  async goTo(i, t) {
+    return await this.view?.goTo(i, t);
   }
   /**
    * Opens the popup at the given location with content defined either explicitly with content or driven
@@ -157,8 +157,8 @@ class b extends p {
   toMap(i) {
     return this.view.toMap(i);
   }
-  toScreen(i, e) {
-    return this.view.toScreen(i, e);
+  toScreen(i, t) {
+    return this.view.toScreen(i, t);
   }
   /** Call this method to clear any fatal errors resulting from a lost WebGL context. */
   async tryFatalErrorRecovery() {
@@ -168,10 +168,17 @@ class b extends p {
   async whenLayerView(i) {
     return await this.view?.whenLayerView(i);
   }
-  // #endregion
-  // #region Lifecycle
+  /**
+   * `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.
+   */
+  async viewOnReady(i, t) {
+    return await this.componentOnReady(), await this.view.whenReady().then(() => i?.()).catch(t);
+  }
+  //#endregion
+  //#region Lifecycle
   load() {
-    this.el.childElem = document.createElement("div"), this.el.childElem.classList.add("arcgis-link-chart"), this.el.append(this.el.childElem), this.view.container ??= this.el.childElem;
+    this.el.childElem = document.createElement("div"), this.el.append(this.el.childElem), this.view.container ??= this.el.childElem;
   }
   loaded() {
     this.manager.onLifecycle(() => [
@@ -183,24 +190,24 @@ class b extends p {
       }, { initial: this.view.ready })
     ]);
   }
-  // #endregion
-  // #region Private Methods
+  //#endregion
+  //#region Private Methods
   _editMapProperties(i) {
-    this.map && (this._map = this.map), this.itemId ? i.portalItem = { id: this.itemId } : this.basemap ? this.basemap === "none" && (i.basemap = void 0, this.basemap = null) : i.basemap = "topo-vector";
-    const { basemap: e, ...n } = i;
-    e || (i = n);
-    const { ground: o, ...w } = i;
-    return o || (i = w), i;
+    this.map && (this._map = this.map), this.itemId && (i.portalItem = { id: this.itemId });
+    const { basemap: t, ...o } = i;
+    t || (i = o);
+    const { ground: w, ...c } = i;
+    return w || (i = c), i;
   }
   async _editViewProperties(i) {
     await this.manager.use(this._map), this.view.ui || (i.ui = {
       components: ["attribution"]
     }), i.map ??= this._map;
-    const e = h(this.center, void 0);
-    return e && (i.center = e), this.viewpoint && (i.viewpoint = this.viewpoint), this.scale !== void 0 && (i.scale = this.scale), this.extent && (i.extent = this.extent), this.zoom !== void 0 && (i.zoom = this.zoom), i;
+    const t = h(this.center, void 0);
+    return t && (i.center = t), this.viewpoint && (i.viewpoint = this.viewpoint), this.scale !== void 0 && (i.scale = this.scale), this.extent && (i.extent = this.extent), this.zoom !== void 0 && (i.zoom = this.zoom), i;
   }
 }
-c("arcgis-link-chart", b);
+v("arcgis-link-chart", V);
 export {
-  b as ArcgisLinkChart
+  V as ArcgisLinkChart
 };

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

@@ -0,0 +1,77 @@
+/// <reference types="@arcgis/core/interfaces.d.ts" />
+/// <reference types="../../index.d.ts" />
+import { ArcgisReferenceElement } from '../../utils/component-utils';
+import { Nil } from '@arcgis/components-utils';
+import { Use } from '@arcgis/components-controllers';
+import { default as LinkChartLayoutSwitcherViewModel } from '@arcgis/core/widgets/LinkChartLayoutSwitcher/LinkChartLayoutSwitcherViewModel.js';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+declare enum DiagramLayoutValues {
+    FORCE_DIRECTED = "organic-standard",
+    COMMUNITY = "organic-community",
+    SIMPLE = "basic-grid",
+    HIERARCHICAL = "hierarchical-bottom-to-top",
+    RADIAL_TREE = "radial-root-centric",
+    SMART_TREE = "tree-left-to-right",
+    GEOGRAPHIC = "geographic-organic-standard",
+    CHRONOLOGICAL_SINGLE = "chronological-mono-timeline",
+    CHRONOLOGICAL_MULTIPLE = "chronological-multi-timeline"
+}
+type DiagramLayoutType = `${DiagramLayoutValues}`;
+
+declare const useLinkChartLayoutSwitcherViewModel: (component: import('@arcgis/components-controllers').StencilLifecycles & {
+    manager: import('@arcgis/components-controllers').ControllerManager;
+    el: HTMLElement;
+    autoDestroyDisabled?: boolean;
+    destroy?: () => Promise<void>;
+} & Pick<LinkChartLayoutSwitcherViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<LinkChartLayoutSwitcherViewModel>, options?: {
+    editConstructorProperties(props: unknown): unknown;
+} | undefined) => LinkChartLayoutSwitcherViewModel;
+/** A component for use in link charts that allows users to switch between different layouts. See [documentation on layouts](https://enterprise.arcgis.com/en/knowledge/latest/knowledge-studio/change-the-layout-applied-to-a-link-chart.htm) for more details.
+ 
+
+Note: Sign in to access the data in this demo, U/P: `viewer01`/`I68VGU^nMurF`
+ */
+export declare class ArcgisLinkChartLayoutSwitcher extends LitElement {
+    /**
+     * If true, the component will not be destroyed automatically when it is
+     * disconnected from the document. This is useful when you want to move the
+     * component to a different place on the page, or temporarily hide it. If this
+     * is set, make sure to call the \`destroy\` method when you are done to prevent
+     * memory leaks.
+     */
+    autoDestroyDisabled: boolean;
+    /**
+     * Icon displayed in the widget's button.
+     *
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @since 4.28
+     */
+    icon: Nil | string;
+    /** The component's default label. */
+    label: Nil | string;
+    readonly layout: DiagramLayoutType;
+    position: __esri.UIPosition;
+    preventExtentUpdate: boolean;
+    referenceElement: ArcgisReferenceElement | Nil | string;
+    readonly state: "ready" | "loading" | "disabled";
+    /** Permanently destroy the component */
+    destroy(): Promise<void>;
+    /**
+     * Switches the layout of the link chart to the value provided.
+     */
+    switchLayout(newLayout: "basic-grid" | "chronological-mono-timeline" | "chronological-multi-timeline" | "geographic-organic-standard" | "hierarchical-bottom-to-top" | "organic-community" | "organic-standard" | "radial-root-centric" | "tree-left-to-right"): Promise<void>;
+    /**
+     * Fires when component has completed the layout switch
+     *
+     * @example
+     * layoutswitcher.addEventListener("arcgisSwitchLayout", (event) => {
+     *   console.log("Layout Switched");
+     * });
+     */
+    readonly arcgisSwitchLayout: TargetedEvent<this, __esri.LinkChartLayoutSwitcherViewModelSwitchLayoutEvent>;
+    readonly arcgisPropertyChange: TargetedEvent<this, {
+        name: "state";
+    }>;
+    readonly arcgisReady: TargetedEvent<this, undefined>;
+}
+export {};

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

@@ -0,0 +1,98 @@
+import { c as l } from "../../chunks/runtime.js";
+import { html as i } from "lit-html";
+import { classes as n } from "@arcgis/components-utils";
+import { g as e } from "../../chunks/globalCss.js";
+import h from "@arcgis/core/widgets/LinkChartLayoutSwitcher/LinkChartLayoutSwitcherViewModel.js";
+import { usePropertyChange as d } from "@arcgis/components-controllers";
+import { m } from "../../chunks/useViewModel.js";
+import { u as g } from "../../chunks/useView.js";
+import { reEmitEvent as u } from "@arcgis/components-controllers/accessor";
+import { LitElement as p, createEvent as y, noShadowRoot as w, safeClassMap as a } from "@arcgis/lumina";
+import { css as f } from "@lit/reactive-element/css-tag.js";
+/*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
+See https://js.arcgis.com/4.33/esri/copyright.txt for details.
+v4.33.0-next.51 */
+const b = f`@layer{arcgis-link-chart-layout-switcher{display:block}}`, k = {
+  basicLayoutCategory: [
+    "basic-grid"
+    /* SIMPLE */
+  ],
+  organicLayoutCategory: [
+    "organic-standard",
+    "organic-community",
+    "geographic-organic-standard"
+    /* GEOGRAPHIC */
+  ],
+  treeLayoutCategory: [
+    "tree-left-to-right",
+    "radial-root-centric"
+    /* RADIAL_TREE */
+  ],
+  hierarchicalLayoutCategory: [
+    "hierarchical-bottom-to-top"
+    /* HIERARCHICAL */
+  ],
+  chronologicalLayoutCategory: [
+    "chronological-mono-timeline",
+    "chronological-multi-timeline"
+    /* CHRONOLOGICAL_MULTIPLE */
+  ]
+}, L = {
+  "organic-standard": "force-directed-link-chart-layout",
+  "organic-community": "community-link-chart-layout",
+  "basic-grid": "simple-link-chart-layout",
+  "hierarchical-bottom-to-top": "hierarchical-link-chart-layout",
+  "radial-root-centric": "radial-tree-link-chart-layout",
+  "tree-left-to-right": "smart-tree-link-chart-layout",
+  "geographic-organic-standard": "geographic-link-chart-layout",
+  "chronological-mono-timeline": "clock-forward",
+  "chronological-multi-timeline": "clock-forward"
+}, v = {
+  "organic-standard": "forceDirected",
+  "organic-community": "community",
+  "basic-grid": "simple",
+  "hierarchical-bottom-to-top": "hierarchical",
+  "radial-root-centric": "radialTree",
+  "tree-left-to-right": "smartTree",
+  "geographic-organic-standard": "geographic",
+  "chronological-mono-timeline": "chronologicalSingle",
+  "chronological-multi-timeline": "chronologicalMultiple"
+}, M = {
+  base: "esri-link-chart-layout-switcher"
+}, C = m(h);
+class $ extends p {
+  constructor() {
+    super(...arguments), this.messages = g(), this.viewModel = C(this), this.autoDestroyDisabled = !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 = d()("state"), this.arcgisReady = y();
+  }
+  static {
+    this.properties = { autoDestroyDisabled: 5, icon: 3, label: 1, layout: 32, position: 3, preventExtentUpdate: 5, referenceElement: 1, state: 3 };
+  }
+  static {
+    this.shadowRootOptions = w;
+  }
+  static {
+    this.styles = b;
+  }
+  //#endregion
+  //#region Public Methods
+  /** Permanently destroy the component */
+  async destroy() {
+    await this.manager.destroy();
+  }
+  /**
+   * Switches the layout of the link chart to the value provided.
+   */
+  async switchLayout(t) {
+    this.viewModel.switchLayout(t);
+  }
+  //#endregion
+  //#region Rendering
+  render() {
+    const { messages: t, icon: r } = this;
+    return i`<div class=${a(n(M.base, e.widget))}><calcite-dropdown scale=s width=m max-items=9><calcite-button class=${a(e.widgetButton)} slot=trigger kind=neutral .disabled=${this.viewModel.state === "disabled"} .iconStart=${r ?? void 0} .label=${t.layoutOptions ?? "Layout"}></calcite-button>${Object.entries(k).map(([c, s]) => i`<calcite-dropdown-group selection-mode=single .groupTitle=${this.messages[c]}>${s.map((o) => i`<calcite-dropdown-item .iconStart=${L[o]} .selected=${o === this.layout ? !0 : void 0} @click=${() => void this.switchLayout(o)}>${t[v[o]]}</calcite-dropdown-item>`)}</calcite-dropdown-group>`)}</calcite-dropdown></div>`;
+  }
+}
+l("arcgis-link-chart-layout-switcher", $);
+export {
+  $ as ArcgisLinkChartLayoutSwitcher
+};

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

@@ -0,0 +1,5 @@
+import "@esri/calcite-components/components/calcite-dropdown";
+import "@esri/calcite-components/components/calcite-button";
+import "@esri/calcite-components/components/calcite-dropdown-group";
+import "@esri/calcite-components/components/calcite-dropdown-item";
+export * from "./customElement.js";

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

@@ -0,0 +1,5 @@
+import "@esri/calcite-components/components/calcite-dropdown";
+import "@esri/calcite-components/components/calcite-button";
+import "@esri/calcite-components/components/calcite-dropdown-group";
+import "@esri/calcite-components/components/calcite-dropdown-item";
+export * from "./customElement.js";

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

@@ -27,17 +27,23 @@ export declare class ArcgisLocate extends LitElement {
      */
     autoDestroyDisabled: boolean;
     geolocationOptions: any;
+    /** @default false */
     goToLocationDisabled: boolean;
     goToOverride: nullish | __esri.GoToOverride;
     graphic: __esri.Graphic;
     icon: Nil | string;
     /** The component's default label. */
     label: Nil | string;
+    /** Replace localized message strings with your own strings. */
     messageOverrides?: typeof this.messages._overrides;
+    /** @default false */
     popupDisabled: boolean;
     position: __esri.UIPosition;
     referenceElement: ArcgisReferenceElement | Nil | string;
     scale: number | nullish;
+    /**
+     * The current state of the component.
+     */
     readonly state: "ready" | "disabled" | "error" | "feature-unsupported" | "locating";
     /**
      * This function provides the ability to interrupt and cancel the process of

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

@@ -4,16 +4,16 @@ import { usePropertyChange as g } from "@arcgis/components-controllers";
 import { reEmitEvent as r } from "@arcgis/components-controllers/accessor";
 import { classes as u } from "@arcgis/components-utils";
 import f from "@arcgis/core/widgets/Locate/LocateViewModel.js";
-import { LitElement as v, createEvent as w, noShadowRoot as E, safeClassMap as c, nothing as b } from "@arcgis/lumina";
+import { LitElement as v, createEvent as w, noShadowRoot as E, safeClassMap as l, nothing as b } from "@arcgis/lumina";
 import { u as M } from "../../chunks/useView.js";
 import { m as y } from "../../chunks/useViewModel.js";
-import { g as l } from "../../chunks/globalCss.js";
+import { g as c } from "../../chunks/globalCss.js";
 import { l as $ } from "../../chunks/legacyIcon.js";
 import { css as L } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.5 */
-const D = L`arcgis-locate{display:block}`, O = {
+v4.33.0-next.51 */
+const D = L`@layer{arcgis-locate{display:block}}`, O = {
   base: "esri-locate"
 }, n = "gps-off", T = y(f);
 class I extends v {
@@ -62,7 +62,7 @@ class I extends v {
   // #region Rendering
   render() {
     const { viewModel: e, icon: d } = this, { state: o } = e, i = o === "locating", s = i ? this.messages.cancel : this.messages.title, h = o === "feature-unsupported", p = $ === void 0 ? n : void 0, a = this._localizeError(this.viewModel?.error);
-    return t`<div class=${c(u(O.base, l.widget))}>${!h && t`<calcite-button class=${c(l.widgetButton)} .disabled=${o === "disabled"} .iconStart=${i ? void 0 : d ?? p} kind=neutral .label=${s} @click=${this._locate} title=${s ?? b}>${i ? t`<calcite-loader inline label></calcite-loader>` : null}</calcite-button>` || ""}${a ? t`<calcite-tooltip open overlay-positioning=fixed .referenceElement=${this.el}>${a}</calcite-tooltip>` : null}</div>`;
+    return t`<div class=${l(u(O.base, c.widget))}>${!h && t`<calcite-button class=${l(c.widgetButton)} .disabled=${o === "disabled"} .iconStart=${i ? void 0 : d ?? p} kind=neutral .label=${s} @click=${this._locate} title=${s ?? b}>${i ? t`<calcite-loader inline label></calcite-loader>` : null}</calcite-button>` || ""}${a ? t`<calcite-tooltip open overlay-positioning=fixed .referenceElement=${this.el}>${a}</calcite-tooltip>` : null}</div>`;
   }
 }
 m("arcgis-locate", I);

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

@@ -30,7 +30,44 @@ declare const useMapView: (component: import('@arcgis/components-controllers').S
 }, options?: {
     editConstructorProperties(props: __esri.MapViewProperties | undefined): __esri.MapViewProperties | Promise<__esri.MapViewProperties | undefined> | undefined;
 } | undefined) => MapView;
-/** Loads a WebMap from [ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm) into a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html).
+/** The ArcGIS Map Component is used to add 2D maps to web applications. For 3D maps, use the
+ * [ArcGIS Scene component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).
+ *
+ * The Map component creates a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) and loads a WebMap from either [ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).
+ *
+ * ```html
+ * <arcgis-map item-id="05e015c5f0314db9a487a9b46cb37eca"></arcgis-map>
+ * ```
+ *
+ * Alternatively, the Map component can be initialized without a WebMap item.
+ *
+ * ```html
+ * <arcgis-map basemap="satellite" center="-154.88, 19.46" zoom="15"></arcgis-map>
+ * ```
+ *
+ * Other components can be added and connected to the Map component.
+ 
+ * ```html
+ * <arcgis-map item-id="05e015c5f0314db9a487a9b46cb37eca">
+ *   <arcgis-zoom position="top-left"></arcgis-zoom>
+ *   <arcgis-legend position="bottom-left"></arcgis-legend>
+ * </arcgis-map>
+ * ```
+ *
+ * The Map component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/api-reference/) of the ArcGIS Maps SDK for JavaScript.
+ *
+ * ```js
+ * const arcgisMap = document.querySelector("arcgis-map");
+ * arcgisMap.addEventListener("arcgisViewReadyChange", () => {
+ *   const layer = new GraphicsLayer({ title: "My Layer" });
+ *   arcgisMap.map.add(layer);
+ * });
+ * ```
+ *
+ * See also:
+ * - [SDK sample apps using the Map component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-map)
+ * - [Getting started](https://developers.arcgis.com/javascript/latest/get-started-overview/)
+ * - [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)
  */
 export declare class ArcgisMap extends LitElement {
     /** Internal view of the component. */
@@ -55,8 +92,13 @@ export declare class ArcgisMap extends LitElement {
     background: nullish | __esri.ColorBackground;
     /**
      * Specifies a basemap for the map. The basemap is a set of layers that give
-     * geographic context to the MapView or SceneView and the other operational layers
+     * geographic context to the view and the other operational layers
      * in the map.
+     * It can either be set using a basemap ID string ([see values](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#basemap)),
+     * [Basemap](https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html)
+     * or [BasemapStyle](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-BasemapStyle.html).
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#basemap)
      */
     basemap: __esri.Basemap | nullish | string;
     /** Represents the view for a single basemap after it has been added to the map. */
@@ -75,6 +117,8 @@ export declare class ArcgisMap extends LitElement {
     /**
      * Indicates whether layer's displayFilter are honored when rendering layers in the view.
      * If `false`, display filters are ignored and all features are rendered.
+     *
+     * @default false
      */
     displayFilterDisabled: boolean;
     /**
@@ -92,7 +136,7 @@ export declare class ArcgisMap extends LitElement {
      * It can filter the map display on floor-aware layers by zero or more level IDs.
      */
     floors: __esri.Collection<string>;
-    /** Gamepad input specific configuration settings.. */
+    /** Gamepad input specific configuration settings. */
     get gamepad(): __esri.GamepadSettings;
     /**
      * Allows for adding graphics directly to the default graphics in the View.
@@ -151,7 +195,11 @@ export declare class ArcgisMap extends LitElement {
     navigation: __esri.Navigation;
     padding: __esri.ViewPadding;
     popup: nullish | __esri.Popup;
-    /** Controls whether the popup opens when users click on the view. */
+    /**
+     * Controls whether the popup opens when users click on the view.
+     *
+     * @default false
+     */
     popupDisabled: boolean;
     /**
      * When `true`, this property indicates whether the view successfully satisfied all dependencies,
@@ -267,6 +315,11 @@ export declare class ArcgisMap extends LitElement {
     tryFatalErrorRecovery(): Promise<void>;
     /** 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(callback?: () => void, errback?: (error: Error) => void): Promise<void>;
     /**
      * This event is for view related property changes: zoom, scale, center, rotation, extent, camera, viewpoint.
      * This event will also emit if stationary toggles from true to false.