@arcgis/map-components 4.31.0-next.98 → 4.32.0-next.10

package/dist/components/arcgis-version-management-version-properties/customElement.js

@@ -0,0 +1,94 @@
+import { c as g } from "../../chunks/runtime.js";
+import { html as l } from "lit-html";
+import { createRef as u, ref as v } from "lit-html/directives/ref.js";
+import { LitElement as V, createEvent as d, noShadowRoot as w } from "@arcgis/lumina";
+/*!
+ * All material copyright Esri, All Rights Reserved, unless otherwise specified.
+ * See https://js.arcgis.com/4.32/esri/copyright.txt for details.
+ * v4.32.0-next.10
+*/
+class $ extends V {
+  constructor() {
+    super(...arguments), this._switchToVersion = !0, this._switchToVersionCheckboxElement = u(), this._versionNameInputElement = u(), this.arcgisAlterVersion = d(), this.arcgisCreateVersion = d(), this.arcgisFlowItemBack = d(), this.arcgisFlowItemClose = d();
+  }
+  static {
+    this.properties = { versionPropertiesElementProps: 0 };
+  }
+  static {
+    this.shadowRootOptions = w;
+  }
+  // #endregion
+  // #region Lifecycle
+  load() {
+    const { versionPropertiesElementProps: { versionInfo: e } } = this;
+    e ? (this._mode = "edit", this._fullVersionName = e.versionIdentifier.name, this._ownerName = this._fullVersionName.substring(0, this._fullVersionName.lastIndexOf(".")), this._versionName = this._fullVersionName.substring(this._fullVersionName.lastIndexOf(".") + 1)) : this._mode = "create";
+  }
+  updated() {
+    this._mode === "create" && this._versionNameInputElement.value?.setFocus();
+  }
+  // #endregion
+  // #region Private Methods
+  _handleCancel() {
+    this.arcgisFlowItemBack.emit();
+  }
+  _handleChange(e) {
+    const { _mode: i, _ownerName: h, _versionName: m, versionPropertiesElementProps: { currentUser: t, isVersionAdministrator: o, serviceUrl: a, versionInfo: p } } = this;
+    let { _alterVersionParameters: c, _createVersionParameters: s } = this;
+    switch (i === "create" && (s || (s = {
+      access: "public",
+      description: "",
+      featureServerUrl: a,
+      ownerName: t,
+      versionName: ""
+    })), i === "edit" && (c || (c = {
+      featureServerUrl: a,
+      versionIdentifier: p.versionIdentifier,
+      ownerName: h,
+      versionName: m,
+      access: p.access,
+      description: p.description
+    })), e.type) {
+      case "calciteChipGroupSelect": {
+        const r = e.target.label, n = e.target.selectedItems[0].value;
+        i === "create" && (s = { ...s, [r]: n }), i === "edit" && (c = { ...c, [r]: n });
+        break;
+      }
+      case "calciteInputTextInput": {
+        const r = e.target.name, n = e.target.value;
+        i === "create" && (s = { ...s, [r]: n }), i === "edit" && (c = { ...c, [r]: n });
+        break;
+      }
+      case "calciteTextAreaInput": {
+        const r = e.target.name, n = e.target.value;
+        i === "create" && (s = { ...s, [r]: n }), i === "edit" && (c = { ...c, [r]: n });
+        break;
+      }
+    }
+    i === "create" && (s.access !== "public" && t.toUpperCase() !== s.ownerName?.toUpperCase() && !o ? (this._switchToVersionCheckboxElement.value.checked = !1, this._switchToVersionCheckboxElement.value.disabled = !0, this._switchToVersion = !1) : this._switchToVersionCheckboxElement.value.disabled = !1, this._createVersionParameters = s), i === "edit" && (this._alterVersionParameters = c);
+  }
+  _handleClose() {
+    this.arcgisFlowItemClose.emit();
+  }
+  _handleSave() {
+    const { _alterVersionParameters: e, _createVersionParameters: i, _mode: h, _switchToVersion: m } = this;
+    h === "create" && this.arcgisCreateVersion.emit({
+      createVersionParameters: i,
+      switchToVersion: m
+    }), h === "edit" && this.arcgisAlterVersion.emit({
+      alterVersionParameters: e
+    });
+  }
+  _handleSwitchToVersionChange(e) {
+    this._switchToVersion = e.target.checked;
+  }
+  // #endregion
+  // #region Rendering
+  render() {
+    const { versionPropertiesElementProps: { closable: e, currentUser: i, hasAdvEditingUte: h, state: m, strings: t, versionInfo: o }, _mode: a, _ownerName: p, _versionName: c } = this, s = l`<div><calcite-button appearance=outline slot=footer width=half @click=${this._handleCancel}>${t.actions.cancelSave}</calcite-button><calcite-button slot=footer width=half @click=${this._handleSave}>${t.actions.saveVersion}</calcite-button></div>`, r = l`<calcite-label>${t.input.versionAccess}<calcite-chip-group label=access @calciteChipGroupSelect=${this._handleChange} selection-mode=single-persist><calcite-chip .selected=${a === "edit" && o.access === "public" || a === "create" || ""} value=public>${t.accessLevels.public}</calcite-chip><calcite-chip .selected=${a === "edit" && o.access === "protected" || ""} value=protected>${t.accessLevels.protected}</calcite-chip><calcite-chip .selected=${a === "edit" && o.access === "private" || ""} value=private>${t.accessLevels.private}</calcite-chip></calcite-chip-group></calcite-label>`, n = l`<calcite-label>${t.input.versionDescription}<calcite-text-area name=description @calciteTextAreaInput=${this._handleChange} resize=vertical .value=${a === "edit" ? o.description : ""}></calcite-text-area></calcite-label>`, f = l`<calcite-label>${t.input.versionName}<calcite-input-text name=versionName @calciteInputTextInput=${this._handleChange} max-length=62 .value=${a === "edit" ? c : ""} ${v(this._versionNameInputElement)}></calcite-input-text></calcite-label>`, _ = l`<calcite-label>${t.input.versionOwner}<calcite-input-text name=ownerName @calciteInputTextInput=${this._handleChange} .disabled=${!h} .value=${a === "edit" ? p : i}></calcite-input-text></calcite-label>`, b = a === "create" ? l`<calcite-label layout=inline><calcite-checkbox checked name=switchToVersion @calciteCheckboxChange=${this._handleSwitchToVersionChange} ${v(this._switchToVersionCheckboxElement)}></calcite-checkbox>${t.actions.switchToVersion}</calcite-label>` : void 0;
+    return l`<calcite-flow-item .closable=${e} .description=${o ? o.versionIdentifier.name : ""} .heading=${o ? t.actions.editVersion : t.actions.newVersion} @calciteFlowItemClose=${this._handleClose}><calcite-panel .loading=${m === "executing"}><calcite-block heading open>${f}${n}${r}${_}${b}${s}</calcite-block></calcite-panel></calcite-flow-item>`;
+  }
+}
+g("arcgis-version-management-version-properties", $);
+export {
+  $ as ArcgisVersionManagementVersionProperties
+};

package/dist/components/arcgis-version-management-version-properties/index.d.ts

@@ -0,0 +1,11 @@
+import "@esri/calcite-components/dist/components/calcite-button";
+import "@esri/calcite-components/dist/components/calcite-label";
+import "@esri/calcite-components/dist/components/calcite-chip-group";
+import "@esri/calcite-components/dist/components/calcite-chip";
+import "@esri/calcite-components/dist/components/calcite-text-area";
+import "@esri/calcite-components/dist/components/calcite-input-text";
+import "@esri/calcite-components/dist/components/calcite-checkbox";
+import "@esri/calcite-components/dist/components/calcite-flow-item";
+import "@esri/calcite-components/dist/components/calcite-panel";
+import "@esri/calcite-components/dist/components/calcite-block";
+export * from "./customElement.js";

package/dist/components/arcgis-version-management-version-properties/index.js

@@ -0,0 +1,11 @@
+import "@esri/calcite-components/dist/components/calcite-button";
+import "@esri/calcite-components/dist/components/calcite-label";
+import "@esri/calcite-components/dist/components/calcite-chip-group";
+import "@esri/calcite-components/dist/components/calcite-chip";
+import "@esri/calcite-components/dist/components/calcite-text-area";
+import "@esri/calcite-components/dist/components/calcite-input-text";
+import "@esri/calcite-components/dist/components/calcite-checkbox";
+import "@esri/calcite-components/dist/components/calcite-flow-item";
+import "@esri/calcite-components/dist/components/calcite-panel";
+import "@esri/calcite-components/dist/components/calcite-block";
+export * from "./customElement.js";

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

@@ -0,0 +1,58 @@
+/// <reference types="@arcgis/core/interfaces.d.ts" />
+import { ArcgisReferenceElement } from '../../utils/component-utils';
+import { Use } from '@arcgis/components-controllers';
+import { Nil } from '@arcgis/components-utils';
+import { PublicLitElement as LitElement } from '@arcgis/lumina';
+
+declare const useWeatherWidget: (component: import('@arcgis/components-controllers').StencilLifecycles & {
+    manager: import('@arcgis/components-controllers').ControllerManager<never>;
+    el: HTMLElement;
+    autoDestroyDisabled?: boolean | undefined;
+    destroy?: (() => Promise<void>) | undefined;
+} & Pick<__esri.Weather, "viewModel" | "icon" | "headingLevel"> & {
+    reactiveUtils?: __esri.reactiveUtils | undefined;
+    state?: unknown;
+    viewModel?: __esri.WeatherViewModel | undefined;
+    icon: string | Nil;
+    label: string | Nil;
+    referenceElement: string | Nil | ArcgisReferenceElement;
+    position: __esri.UIPosition;
+    arcgisReady: import('@arcgis/components-controllers').EventEmitter;
+    arcgisPropertyChange: import('@arcgis/components-controllers').EventEmitter<{
+        name: string;
+    }> | undefined;
+    el: HTMLElement & {
+        childElem?: (HTMLElement & {
+            ownedBy?: HTMLElement | undefined;
+        }) | undefined;
+        view?: __esri.MapView | Nil | __esri.SceneView;
+    };
+    autoDestroyDisabled: boolean;
+    destroy: () => Promise<void>;
+}, options?: {
+    editConstructorProperties(props: __esri.WeatherProperties): __esri.WeatherProperties | Promise<__esri.WeatherProperties>;
+} | undefined) => __esri.Weather;
+export declare class ArcgisWeather extends LitElement implements Use<typeof useWeatherWidget> {
+    /**
+     * 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 temporary hide it. If this
+     * is set, make sure to call the \`destroy\` method when you are done to prevent
+     * memory leaks.
+     */
+    autoDestroyDisabled: boolean;
+    headingLevel: number;
+    hideHeader: boolean | undefined;
+    icon: string;
+    label: string;
+    position: __esri.UIPosition;
+    referenceElement: ArcgisReferenceElement | Nil | string;
+    readonly state: "ready" | "disabled";
+    /** Permanently destroy the component */
+    destroy(): Promise<void>;
+    readonly arcgisPropertyChange: CustomEvent<{
+        name: "state";
+    }>;
+    readonly arcgisReady: CustomEvent<undefined>;
+}
+export {};

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

@@ -0,0 +1,36 @@
+import { c as e } from "../../chunks/runtime.js";
+import { newWidgetsWeather as t } from "@arcgis/core-adapter";
+import { usePropertyChange as s } from "@arcgis/components-controllers";
+import { m as i } from "../../chunks/useWidget.js";
+import { LitElement as o, createEvent as a, noShadowRoot as r } from "@arcgis/lumina";
+import { css as h } from "@lit/reactive-element/css-tag.js";
+/*!
+ * All material copyright Esri, All Rights Reserved, unless otherwise specified.
+ * See https://js.arcgis.com/4.32/esri/copyright.txt for details.
+ * v4.32.0-next.10
+*/
+const d = h`arcgis-weather{display:flex}`, l = i(t);
+class n extends o {
+  constructor() {
+    super(...arguments), this.widget = l(this), this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.headingLevel = this.widget.headingLevel, this.hideHeader = this.widget.visibleElements.header, this.icon = this.widget.icon, this.label = this.widget.label, this.position = "bottom-left", this.state = this.viewModel.state, this.arcgisPropertyChange = s()("state"), this.arcgisReady = a();
+  }
+  static {
+    this.properties = { autoDestroyDisabled: 5, headingLevel: 9, hideHeader: 5, icon: 1, label: 1, position: 1, referenceElement: 1, state: 3 };
+  }
+  static {
+    this.shadowRootOptions = r;
+  }
+  static {
+    this.styles = d;
+  }
+  // #endregion
+  // #region Public Methods
+  /** Permanently destroy the component */
+  async destroy() {
+    await this.manager.destroy();
+  }
+}
+e("arcgis-weather", n);
+export {
+  n as ArcgisWeather
+};

package/dist/components/arcgis-weather/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

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

@@ -0,0 +1 @@
+export * from "./customElement.js";

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

@@ -0,0 +1,66 @@
+/// <reference types="@arcgis/core/interfaces.d.ts" />
+import { Use } from '@arcgis/components-controllers';
+import { Nil } from '@arcgis/components-utils';
+import { ArcgisReferenceElement } from '../../utils/component-utils';
+import { JsxNode, PublicLitElement as LitElement } from '@arcgis/lumina';
+
+type Layout = "horizontal" | "vertical";
+declare const useZoomViewModel: (component: import('@arcgis/components-controllers').StencilLifecycles & {
+    manager: import('@arcgis/components-controllers').ControllerManager<never>;
+    el: HTMLElement;
+    autoDestroyDisabled?: boolean | undefined;
+    destroy?: (() => Promise<void>) | undefined;
+} & Pick<__esri.ZoomViewModel, never> & {
+    reactiveUtils?: __esri.reactiveUtils | undefined;
+    state?: "ready" | "disabled" | undefined;
+    icon: string | Nil;
+    label: string | Nil;
+    referenceElement: string | Nil | ArcgisReferenceElement;
+    arcgisReady: import('@arcgis/components-controllers').EventEmitter;
+    position: __esri.UIPosition;
+    arcgisPropertyChange: import('@arcgis/components-controllers').EventEmitter<{
+        name: string;
+    }> | undefined;
+    el: HTMLElement & {
+        childElem?: (HTMLElement & {
+            ownedBy?: HTMLElement | undefined;
+        }) | undefined;
+        view?: __esri.MapView | __esri.SceneView | undefined;
+    };
+    autoDestroyDisabled: boolean;
+    destroy: () => Promise<void>;
+}, options?: {
+    editConstructorProperties(props: unknown): unknown;
+} | undefined) => __esri.ZoomViewModel;
+export declare class ArcgisZoom extends LitElement implements Use<typeof useZoomViewModel> {
+    /**
+     * 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
+     * temporary hide it. If this is set, make sure to call the
+     * \`destroy\` method when you are done to prevent memory leaks.
+     */
+    autoDestroyDisabled: boolean;
+    /** Icon which represents the widget. */
+    icon: Nil | string;
+    /** The widget's default label. */
+    label: Nil | string;
+    /** Determines the layout/orientation of the Zoom widget. */
+    layout: Layout;
+    /** Overwrite localized strings for this component */
+    messageOverrides?: typeof this.messages._overrides;
+    position: __esri.UIPosition;
+    referenceElement: ArcgisReferenceElement | Nil | string;
+    readonly state: "ready" | "disabled";
+    /** Permanently destroy the component */
+    destroy(): Promise<void>;
+    /** Zooms the view in by an LOD factor of 0.5. */
+    zoomIn(): Promise<void>;
+    /** Zooms the view out by an LOD factor of 2. */
+    zoomOut(): Promise<void>;
+    readonly arcgisPropertyChange: CustomEvent<{
+        name: "state";
+    }>;
+    readonly arcgisReady: CustomEvent<undefined>;
+}
+export {};

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

@@ -0,0 +1,58 @@
+import { c as m } from "../../chunks/runtime.js";
+import { html as c } from "lit-html";
+import { usePropertyChange as d } from "@arcgis/components-controllers";
+import { classes as h } from "@arcgis/components-utils";
+import { newWidgetsZoomZoomViewModel as u } from "@arcgis/core-adapter";
+import { u as z, m as p } from "../../chunks/useViewModel.js";
+import { g as o } from "../../chunks/globalCss.js";
+import { LitElement as b, createEvent as g, noShadowRoot as w, safeClassMap as t, nothing as i } 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.32/esri/copyright.txt for details.
+ * v4.32.0-next.10
+*/
+const r = {
+  base: "esri-zoom",
+  horizontalLayout: "esri-zoom--horizontal"
+}, y = f`arcgis-zoom{display:flex}.esri-zoom{display:flex;flex-flow:column nowrap}.esri-zoom .esri-widget--button{box-shadow:none}.esri-zoom .esri-widget--button:first-child{margin-bottom:0}.esri-zoom .esri-widget--button:last-child{border-top:solid 1px var(--calcite-color-border-1)}.esri-zoom.esri-zoom--horizontal{flex-flow:row-reverse nowrap}.esri-zoom.esri-zoom--horizontal .esri-widget--button:last-child{border-top:none}.esri-zoom.esri-zoom--horizontal .esri-widget--button:first-child{border-left:solid 1px var(--calcite-color-border-1)}[dir=rtl] .esri-zoom.esri-zoom--horizontal .esri-widget--button:first-child{border-top:none}[dir=rtl] .esri-zoom.esri-zoom--horizontal .esri-widget--button:last-child{border-left:solid 1px var(--calcite-color-border-1)}`, v = p(u);
+class Z extends b {
+  constructor() {
+    super(...arguments), this.messages = z({}), this.viewModel = v(this), this.canZoomIn = this.viewModel.canZoomIn, this.canZoomOut = this.viewModel.canZoomOut, this.autoDestroyDisabled = !1, this.icon = "magnifying-glass-plus", this.layout = "vertical", this.position = "top-left", this.state = this.viewModel.state, this.arcgisPropertyChange = d()("state"), this.arcgisReady = g();
+  }
+  static {
+    this.properties = { canZoomIn: 16, canZoomOut: 16, autoDestroyDisabled: 5, icon: 3, label: 1, layout: 3, messageOverrides: 0, position: 1, referenceElement: 1, state: 3 };
+  }
+  static {
+    this.shadowRootOptions = w;
+  }
+  static {
+    this.styles = y;
+  }
+  // #endregion
+  // #region Public Methods
+  /** Permanently destroy the component */
+  async destroy() {
+    await this.manager.destroy();
+  }
+  /** Zooms the view in by an LOD factor of 0.5. */
+  async zoomIn() {
+    this.viewModel.zoomIn();
+  }
+  /** Zooms the view out by an LOD factor of 2. */
+  async zoomOut() {
+    this.viewModel.zoomOut();
+  }
+  // #endregion
+  // #region Rendering
+  render() {
+    const a = {
+      [r.horizontalLayout]: this.layout === "horizontal"
+    }, { canZoomIn: l, canZoomOut: n } = this.viewModel, { zoomIn: s, zoomOut: e } = this.messages;
+    return c`<div class=${t(h(r.base, o.widget, a))}><calcite-button class=${t(o.widgetButton)} .disabled=${!l} icon-start=plus kind=neutral .label=${s} @click=${this.zoomIn} title=${s ?? i}></calcite-button><calcite-button class=${t(o.widgetButton)} .disabled=${!n} icon-start=minus kind=neutral .label=${e} @click=${this.zoomOut} title=${e ?? i}></calcite-button></div>`;
+  }
+}
+m("arcgis-zoom", Z);
+export {
+  Z as ArcgisZoom
+};

package/dist/components/arcgis-zoom/index.d.ts

@@ -0,0 +1,2 @@
+import "@esri/calcite-components/dist/components/calcite-button";
+export * from "./customElement.js";

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

@@ -0,0 +1,2 @@
+import "@esri/calcite-components/dist/components/calcite-button";
+export * from "./customElement.js";

package/dist/components/types.d.ts

@@ -0,0 +1,5 @@
+export type MeasurementSystem = "imperial" | "metric";
+type MetricMapUnit = "centimeter" | "kilometer" | "meter" | "millimeter";
+type ImperialMapUnit = "foot" | "inch" | "mile";
+export type MapUnit = ImperialMapUnit | MetricMapUnit;
+export {};

package/dist/controllers/Handles.d.ts

@@ -0,0 +1,109 @@
+import { IHandle, Nil } from '@arcgis/components-utils';
+export declare class Handles<T = string, H extends IHandle = IHandle> {
+    /**
+     * A handle to a {@link module:esri/views/layers/FeatureLayerView#highlight highlight} call result.
+     * The handle can be used to remove the installed highlight.
+     *
+     * @typedef module:esri/core/Handles~Handle
+     *
+     * @property {Function} remove - Removes the handle.
+     */
+    /**
+     * Destroys the object, removing all the handles.
+     *
+     * @method destroy
+     * @instance
+     *
+     * @example
+     * let handles = new Handles();
+     *
+     * handles.add(reactiveUtils.when(
+     *   () => !view.updating,
+     *   () => {
+     *     wkidSelect.disabled = false;
+     *   },
+     *   { once: true }
+     * ));
+     *
+     * handles.destroy();
+     */
+    destroy(): void;
+    private _groups;
+    /**
+     * Handle count. Used for unit testing.
+     *
+     * @return {number}
+     * @private
+     */
+    get size(): number;
+    /**
+     * Adds a group of handles.
+     *
+     * @method add
+     * @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 {@link module:esri/core/Handles#remove Handles.remove()}. If no
+     *    key is provided the handles are added to a default group.
+     *
+     * @example
+     * let handles = new Handles();
+     *
+     * handles.add(handle); // added to the default group
+     * handles.add([handle1, handle2]); // added to the default group
+     *
+     * handles.add(handle, "handle-group");
+     * handles.add([handle1, handle2], "other-handle-group");
+     * @example
+     * let handles = new Handles();
+     *
+     * handles.add(reactiveUtils.when(
+     *   () => !view.updating,
+     *   () => {
+     *     wkidSelect.disabled = false;
+     *   },
+     *   { once: true }
+     * ));
+     * @instance
+     */
+    add(handles: (H | Nil)[] | H | Nil, groupKey?: T): this;
+    forEach(groupKey: T, callback: (handle: H) => void): void;
+    forEach(callback: (handle: H) => void): void;
+    /**
+     * Returns true if a group exists for the provided group key, false otherwise.
+     *
+     * @method has
+     * @instance
+     * @param {*} groupKey - group handle key
+     * @return {boolean}
+     */
+    has(groupKey?: T): boolean;
+    /**
+     * Removes a group of handles.
+     *
+     * @method remove
+     * @instance
+     * @param {*} [groupKey] - A group key or an array or collection of group keys to remove.
+     *
+     * @example
+     * let handles = new Handles();
+     *
+     * handles.remove(); // removes handles from default group
+     *
+     * handles.remove("handle-group");
+     * handles.remove("other-handle-group");
+     */
+    remove(groupKey?: T | T[]): this;
+    /**
+     * Removes all handles.
+     *
+     * @method removeAll
+     * @instance
+     */
+    removeAll(): this;
+    private _isHandle;
+    private _getOrCreateGroup;
+    private _getGroup;
+    private _ensureGroupKey;
+    private _removeAllFromGroup;
+}

package/dist/controllers/useHandles.d.ts

@@ -0,0 +1,104 @@
+import { IHandle } from '@arcgis/components-utils';
+import { Controller } from '@arcgis/components-controllers';
+/**
+ * Avoid accidentally adding objects that look like handles because they have a `remove` method,
+ * but are not because they can be destroyed e.g. the Handles object.
+ */
+export type SafeHandle = IHandle & {
+    destroy?: null;
+};
+/** Avoid accidentally using a handle as a group key. */
+export type GroupKey<T> = Exclude<T, IHandle>;
+declare class HandleManager extends Controller {
+    destroyed: boolean;
+    private _handles;
+    constructor(removeOn: "destroy" | "disconnect");
+    /**
+     * Adds one or more handles which are to be tied to the lifecycle of the object. The handles will
+     * be removed when the object is destroyed.
+     *
+     * ```js
+     * // Manually manage handles
+     * const handle = reactiveUtils.when(
+     *   () => !view.updating,
+     *   () => {
+     *     wkidSelect.disabled = false;
+     *   },
+     *   { once: true }
+     * );
+     *
+     * this.addHandles(handle);
+     *
+     * // Destroy the object
+     * this.destroy();
+     * ```
+     *
+     * @method addHandles
+     * @since 4.25
+     * @instance
+     * @param {module:esri/core/Accessor~WatchHandle | module:esri/core/Accessor~WatchHandle[]} handleOrHandles
+     *    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 {@link module:esri/core/Accessor#removeHandles Accessor.removeHandles()}.
+     *    If no key is provided the handles are added to a default group.
+     */
+    addHandles<T>(handleOrHandles: SafeHandle | SafeHandle[], groupKey?: GroupKey<T>): void;
+    /**
+     * Removes a group of handles owned by the object.
+     *
+     * @method removeHandles
+     * @since 4.25
+     * @instance
+     * @param {*} [groupKey] - A group key or an array or collection of group keys to remove.
+     *
+     * @example
+     * obj.removeHandles(); // removes handles from default group
+     *
+     * obj.removeHandles("handle-group");
+     * obj.removeHandles("other-handle-group");
+     */
+    removeHandles<T>(groupKey?: GroupKey<T>): void;
+    /**
+     * Removes all the handles currently associated with the object.
+     *
+     * @internal
+     */
+    removeAllHandles(): void;
+    destroy(): void;
+    /**
+     * Returns true if a named group of handles exist.
+     *
+     * @method hasHandles
+     * @since 4.25
+     * @instance
+     * @param {*} [groupKey] - A group key.
+     * @return {boolean} Returns `true` if a named group of handles exist.
+     *
+     * @example
+     * // Remove a named group of handles if they exist.
+     * if (obj.hasHandles("watch-view-updates")) {
+     *   obj.removeHandles("watch-view-updates");
+     * }
+     */
+    hasHandles<T>(groupKey?: GroupKey<T>): boolean;
+}
+/**
+ * Note: you might not need useHandles. See manager.onLifecycle instead.
+ *
+ * useHandles() implements the following methods from JS API's Accessor class:
+ * addHandles - https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Accessor.html#addHandles
+ * hasHandles - https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Accessor.html#hasHandles
+ * removeHandles - https://developers.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
+ * whether handles should get removed on component disconnect or destroy.
+ *
+ * destroy() is an opt-in lifecycle event provided by the controllers API.
+ * Read controllers documentation for instructions on how to opt it.
+ *
+ * Prefer using "disconnect" over "destroy" when possible
+ */
+export declare const useHandles: (removeOn: "destroy" | "disconnect") => HandleManager;
+export {};

package/dist/controllers/useT9n.d.ts

@@ -0,0 +1 @@
+export declare const useT9n: import('@arcgis/components-controllers').UseT9n;

package/dist/controllers/useViewModel.d.ts

@@ -0,0 +1,83 @@
+/// <reference types="@arcgis/core/interfaces.d.ts" />
+import { BaseComponent, EventEmitter } from '@arcgis/components-controllers';
+import { AccessorController } from '@arcgis/components-controllers/accessor';
+import { Nil } from '@arcgis/components-utils';
+import { default as ArcgisMap } from '@arcgis/core/Map';
+import { ArcgisReferenceElement } from '../utils/component-utils';
+type Requires<Props, ViewModel extends ViewModelInstance> = BaseComponent & Pick<ViewModel, keyof Props & keyof ViewModel> & Uses<ViewModel>;
+type ViewModelInstance = __esri.Accessor & Partial<__esri.Evented> & {
+    state?: string;
+    view?: __esri.MapView | __esri.SceneView | undefined;
+    map?: ArcgisMap | Nil;
+};
+type Uses<ViewModel extends ViewModelInstance> = {
+    reactiveUtils?: typeof __esri.reactiveUtils;
+    state?: ViewModel["state"];
+    icon: Nil | string;
+    label: Nil | string;
+    referenceElement: ArcgisReferenceElement | Nil | string;
+    arcgisReady: EventEmitter;
+    position: __esri.UIPosition;
+    arcgisPropertyChange: EventEmitter<{
+        name: string;
+    }> | undefined;
+    el: HTMLElement & {
+        childElem?: HTMLElement & {
+            ownedBy?: HTMLElement;
+        };
+        view?: __esri.MapView | __esri.SceneView | undefined;
+    };
+    autoDestroyDisabled: boolean;
+    destroy: () => Promise<void>;
+};
+/**
+ * A controller for a mapping component that:
+ * - loads the viewModel
+ * - initializes the viewModel with the component's properties
+ * - does two-way binding between view model and component properties
+ * - re-emits the viewModel's events on the component
+ * - type-checks everything ✨
+ *
+ * Documentation:
+ * https://qawebgis.esri.com/arcgis-components/?path=/docs/lumina-transition-from-widgets--docs#useviewmodel-controller
+ *
+ * TEST: add test cases for this controller
+ */
+export declare const makeViewModelController: <Props, ViewModel extends ViewModelInstance, OmitProps extends string = never>(loadViewModel: (props: Omit<Props, "view">) => Promise<ViewModel>, _options?: {
+    /**
+     * Don't expose the following ViewModels's properties on the component.
+     * You can also bind the property to \@State rather than \@Prop if you
+     * wish to use it internally only:
+     *
+     * @example
+     * \@State() timeZone = this.viewModel.timeZone;
+     */
+    omitProps: OmitProps[];
+}) => (component: Requires<Omit<Props, OmitProps>, ViewModel>, options?: {
+    editConstructorProperties(props: Props): Promise<Props> | Props;
+}) => ViewModel;
+export declare class ViewModelController<Props, ViewModel extends ViewModelInstance> extends AccessorController<Props, ViewModel, Uses<ViewModel>> {
+    hostConnected(): void;
+    hostLoad(): Promise<void>;
+    hostLoaded(): void;
+    hostDisconnected(): void;
+    hostDestroy(): void;
+    private _watchMetaProperties;
+    /**
+     * Destroy the component if view gets destroyed.
+     *
+     * When view is destroyed, component disconnect is triggered, which will
+     * destroy the component in 1s but that can be too late, because in the
+     * meanwhile, a watcher on the widget/viewModel instance may get triggered,
+     * and throw an error if it's not able to access this.view.map or etc
+     * (happens in VersionManagementViewModel for example).
+     *
+     * We can't check for this in disconnectedCallback though as, if the entire
+     * component tree is removed, the disconnect for the component will be
+     * triggered before that of arcgis-map, so the view might not be destroyed
+     * yet at that point.
+     */
+    private _watchViewDestroy;
+    private _watchViewDestroyHandle?;
+}
+export {};