@arcgis/map-components 4.32.0-next.10 → 4.32.0-next.100

package/dist/components/arcgis-directional-pad/css.d.ts

@@ -0,0 +1,10 @@
+export declare const css: {
+    readonly base: "arcgis-directional-pad";
+    readonly buttonsContainer: "arcgis-directional-pad__buttons-container";
+    readonly button: "arcgis-directional-pad__button";
+    readonly compassButton: "arcgis-directional-pad__compass";
+    readonly rotationContainer: "arcgis-directional-pad__rotation-container";
+    readonly rotationSliderContainer: "arcgis-directional-pad__rotation-slider-container";
+    readonly rotationReset: "arcgis-directional-pad__rotation-reset-button";
+    readonly error: "arcgis-directional-pad__error";
+};

package/dist/components/arcgis-directional-pad/customElement.d.ts

@@ -1,58 +1,127 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-import { ArcgisReferenceElement } from '../../utils/component-utils';
+/// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/components-controllers';
 import { Nil } from '@arcgis/components-utils';
-import { PublicLitElement as LitElement } from '@arcgis/lumina';
+import { default as DirectionalPadViewModel } from '@arcgis/core/widgets/DirectionalPad/DirectionalPadViewModel.js';
+import { JsxNode, ToElement, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useDirectionalPadWidget: (component: import('@arcgis/components-controllers').StencilLifecycles & {
-    manager: import('@arcgis/components-controllers').ControllerManager<never>;
+declare const useDirectionalPadViewModel: (component: import('@arcgis/components-controllers').StencilLifecycles & {
+    manager: import('@arcgis/components-controllers').ControllerManager;
     el: HTMLElement;
-    autoDestroyDisabled?: boolean | undefined;
-    destroy?: (() => Promise<void>) | undefined;
-} & Pick<__esri.DirectionalPad, "label" | "viewModel" | "icon" | "disabled" | "visualScale"> & {
-    reactiveUtils?: __esri.reactiveUtils | undefined;
-    state?: unknown;
-    viewModel?: __esri.DirectionalPadViewModel | undefined;
-    icon: string | Nil;
-    label: string | Nil;
-    referenceElement: string | Nil | ArcgisReferenceElement;
-    position: __esri.UIPosition;
+    autoDestroyDisabled?: boolean;
+    destroy?: () => Promise<void>;
+} & Pick<DirectionalPadViewModel, never> & {
+    reactiveUtils?: typeof __esri.reactiveUtils;
+    state?: "ready" | "disabled" | "moving" | undefined;
+    icon: Nil | string;
+    label: Nil | string;
+    referenceElement: ArcgisReferenceElement | Nil | string;
     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 | Nil | __esri.SceneView;
+        childElem?: HTMLElement & {
+            ownedBy?: HTMLElement;
+        };
+        view
+        /**
+         * A directional pad (D-Pad) component can be used to control the position and
+         * rotation of the map. The D-Pad provides eight directions of movement, a small
+         * compass which indicates the current orientation of the map and a slider for
+         * rotating the map.
+         *
+         * It is also possible to disable the map's rotation controls or change the size
+         * of the component.
+         *
+         * The DirectionalPad component is not supported in 3d.
+         */
+        ? /**
+         * A directional pad (D-Pad) component can be used to control the position and
+         * rotation of the map. The D-Pad provides eight directions of movement, a small
+         * compass which indicates the current orientation of the map and a slider for
+         * rotating the map.
+         *
+         * It is also possible to disable the map's rotation controls or change the size
+         * of the component.
+         *
+         * The DirectionalPad component is not supported in 3d.
+         */: __esri.MapView | __esri.SceneView | undefined;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }, options?: {
-    editConstructorProperties(props: __esri.DirectionalPadProperties): __esri.DirectionalPadProperties | Promise<__esri.DirectionalPadProperties>;
-} | undefined) => __esri.DirectionalPad;
-export declare class ArcgisDirectionalPad extends LitElement implements Use<typeof useDirectionalPadWidget> {
+    editConstructorProperties(props: unknown): unknown;
+} | undefined) => DirectionalPadViewModel;
+/**
+ * A directional pad (D-Pad) component can be used to control the position and
+ * rotation of the map. The D-Pad provides eight directions of movement, a small
+ * compass which indicates the current orientation of the map and a slider for
+ * rotating the map.
+ *
+ * It is also possible to disable the map's rotation controls or change the size
+ * of the component.
+ *
+ * The DirectionalPad component is not supported in 3d.
+ */
+export declare class ArcgisDirectionalPad extends LitElement {
+    private messages;
     /**
-     * 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.
+     * 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;
+    /**
+     * Indicates whether interaction is allowed on the component. When `true`,
+     * this property sets the component to a disabled state to disable any user
+     * interaction.
+     */
     disabled: boolean;
-    icon: string;
-    label: string;
+    /**
+     * Whether to hide directional pad buttons.
+     */
+    hideDirectionalButtons: boolean;
+    /**
+     * Icon which represents the component. It is typically used when the
+     * component is controlled by another one (e.g. in the arcgis-expand
+     * component).
+     *
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     */
+    icon: Nil | string;
+    /** The component's default label. */
+    label: Nil | string;
+    /** Overwrite localized strings for this component */
+    messageOverrides?: typeof this.messages._overrides;
     position: __esri.UIPosition;
     referenceElement: ArcgisReferenceElement | Nil | string;
+    /**
+     * Whether to display the button to reset the rotation angle. This only takes
+     * effect if showRotationSlider is true.
+     */
+    showRotationResetButton: boolean;
+    /**
+     * Whether to display the map rotation slider.
+     */
+    showRotationSlider: boolean;
     readonly state: "ready" | "disabled" | "moving";
-    visualScale: "s" | "l" | "m";
+    /**
+     * Determines the size of directional pad buttons and the slider.
+     *
+     * In addition to this parameter, you can set the width on the component
+     * container to dictate directional pad size.
+     */
+    visualScale: HTMLCalciteButtonElement["scale"];
     /** Permanently destroy the component */
     destroy(): Promise<void>;
-    readonly arcgisPropertyChange: CustomEvent<{
+    readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    readonly arcgisReady: CustomEvent<undefined>;
+    readonly arcgisReady: TargetedEvent<this, undefined>;
 }
 export {};

package/dist/components/arcgis-directional-pad/customElement.js

@@ -1,27 +1,65 @@
-import { c as t } from "../../chunks/runtime.js";
-import { newWidgetsDirectionalPad as i } from "@arcgis/core-adapter";
-import { usePropertyChange as e } from "@arcgis/components-controllers";
-import { m as s } from "../../chunks/useWidget.js";
-import { LitElement as a, createEvent as o, noShadowRoot as r } from "@arcgis/lumina";
-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.32/esri/copyright.txt for details.
- * v4.32.0-next.10
-*/
-const d = l`arcgis-directional-pad{display:flex}`, c = s(i);
-class n extends a {
+import { c as u } from "../../chunks/runtime.js";
+import { html as o } from "lit-html";
+import { ref as p } from "lit-html/directives/ref.js";
+import { usePropertyChange as m } from "@arcgis/components-controllers";
+import { focusElement as b } from "@arcgis/components-utils";
+import { watch as g } from "@arcgis/core/core/reactiveUtils.js";
+import _ from "@arcgis/core/widgets/DirectionalPad/DirectionalPadViewModel.js";
+import { LitElement as v, createEvent as f, noShadowRoot as $, safeClassMap as n, nothing as l, safeStyleMap as w } from "@arcgis/lumina";
+import { u as R, m as C } from "../../chunks/useViewModel.js";
+import { g as d } from "../../chunks/globalCss.js";
+import { css as x } 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.100 */
+const h = [-45, 0, 45, -90, 90, -135, 180, 135], y = {
+  0: { label: "north", iconName: "chevron-up" },
+  45: { label: "northEast", iconName: "chevron-up-right" },
+  90: { label: "east", iconName: "chevron-right" },
+  135: { label: "southEast", iconName: "chevron-down-right" },
+  180: { label: "south", iconName: "chevron-down" },
+  "-135": { label: "southWest", iconName: "chevron-down-left" },
+  "-90": { label: "west", iconName: "chevron-left" },
+  "-45": { label: "northWest", iconName: "chevron-up-left" }
+}, a = "arcgis-directional-pad", s = {
+  base: a,
+  buttonsContainer: `${a}__buttons-container`,
+  button: `${a}__button`,
+  compassButton: `${a}__compass`,
+  rotationContainer: `${a}__rotation-container`,
+  rotationSliderContainer: `${a}__rotation-slider-container`,
+  rotationReset: `${a}__rotation-reset-button`,
+  error: `${a}__error`
+}, M = x`.arcgis-directional-pad{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm);outline:none;box-shadow:none!important;background:transparent;user-select:none;calcite-action-pad{display:contents}calcite-action-group{touch-action:none}calcite-action{aspect-ratio:1}}.arcgis-directional-pad__buttons-container{--calcite-color-background: transparent;--calcite-action-group-gap: 0;--calcite-action-group-padding: 0;calcite-action{--calcite-color-focus: var(--calcite-color-foreground-3)}calcite-action:not([active]){--calcite-action-background-color-press: var(--calcite-color-foreground-1)}calcite-action[active]{--calcite-action-background-color: var(--calcite-color-foreground-3)}calcite-icon{transform:var(--rotation, unset)}@media (hover: none){calcite-action{--calcite-action-background-color-hover: var(--calcite-color-foreground-1);--calcite-action-text-color-press: var(--calcite-color-text-3)}}}.arcgis-directional-pad__rotation-container{display:block;width:100%;calcite-action{flex:.3}}.arcgis-directional-pad__rotation-slider-container{display:flex;flex:1;align-items:center;calcite-slider{flex:1;padding-inline:var(--calcite-spacing-xxs)}}`;
+function S(c) {
+  const { x: t, y: e, width: i, height: r } = c.getBoundingClientRect();
+  return { x: t + i / 2, y: e + r / 2 };
+}
+function B(c) {
+  return c?.spatialReference?.isWebMercator || c?.spatialReference?.isGeographic || !1;
+}
+const E = C(_);
+class D extends v {
   constructor() {
-    super(...arguments), this.widget = c(this), this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.disabled = this.widget.disabled, this.icon = this.widget.icon, this.label = this.widget.label, this.position = "bottom-left", this.state = this.viewModel.state, this.visualScale = this.widget.visualScale, this.arcgisPropertyChange = e()("state"), this.arcgisReady = o();
+    super(...arguments), this.messages = R({}), this._onContextMenu = (t) => t.preventDefault(), this._buttons = {}, this.viewModel = E(this), this.angle = this.viewModel.angle, this.rotation = this.viewModel.rotation, this.autoDestroyDisabled = !1, this.disabled = this.viewModel.disabled, this.hideDirectionalButtons = !1, this.icon = "move", this.position = "bottom-left", this.showRotationResetButton = !1, this.showRotationSlider = !1, this.state = this.viewModel.state, this.visualScale = "s", this.arcgisPropertyChange = m()("state"), this.arcgisReady = f();
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, disabled: 5, icon: 1, label: 1, position: 1, referenceElement: 1, state: 3, visualScale: 1 };
+    this.properties = { _rotationEnabled: 16, angle: 16, rotation: 16, autoDestroyDisabled: 5, disabled: 5, hideDirectionalButtons: 5, icon: 3, label: 1, messageOverrides: 0, position: 3, referenceElement: 1, showRotationResetButton: 5, showRotationSlider: 5, state: 3, visualScale: 1 };
   }
   static {
-    this.shadowRootOptions = r;
+    this.shadowRootOptions = $;
   }
   static {
-    this.styles = d;
+    this.styles = M;
+  }
+  // #endregion
+  // #region State Properties
+  /**
+   * When `false`, sets rotation-related controls to a disabled state so the
+   * user  cannot interact with them.
+   */
+  get _rotationEnabled() {
+    return this.el.view?.ready ? this.el.view.constraints.rotationEnabled ?? !1 : !0;
   }
   // #endregion
   // #region Public Methods
@@ -29,8 +67,97 @@ class n extends a {
   async destroy() {
     await this.manager.destroy();
   }
+  // #endregion
+  // #region Lifecycle
+  loaded() {
+    this.manager.onLifecycle(() => [
+      // Move focus when movement angle changed by touch/mouse (not keyboard!)
+      g(() => this.viewModel.angle, () => {
+        this._buttonsContainer?.contains(document.activeElement) && (this.viewModel.angle == null ? this.el.childElem?.focus() : b(this._buttons[this.viewModel.angle]));
+      })
+    ]);
+  }
+  // #endregion
+  // #region Private Methods
+  _rotateIcon(t) {
+    return {
+      "--rotation": `rotate(${t}deg)`
+    };
+  }
+  _setButtonContainerRef(t) {
+    t !== void 0 ? (this._buttonsContainer = t, queueMicrotask(() => {
+      this._buttons = Object.fromEntries(Array.from(t.children, (e) => [
+        Number.parseInt(e.getAttribute("data-angle") ?? ""),
+        e
+      ]));
+    })) : (this._buttonsContainer = void 0, this._buttons = {});
+  }
+  /**
+   * Find component center and start movement
+   */
+  _onButtonPointerDown(t) {
+    if (this._buttonsContainer === void 0)
+      return;
+    t.composedPath().find((r) => r.hasPointerCapture?.(t.pointerId))?.releasePointerCapture(t.pointerId);
+    const i = S(this._buttonsContainer);
+    this.viewModel.beginFollowingPointer(t, i);
+  }
+  _onSliderInput({ currentTarget: t }) {
+    typeof t.value == "number" && (this.viewModel.rotation = t.value);
+  }
+  /**
+   * Reset angle of rotation
+   */
+  _onRotationReset() {
+    this.viewModel.rotation = 0;
+  }
+  /**
+   * Handle directional pad clicks only when using the keyboard
+   */
+  _onClick(t) {
+    this.viewModel.moveOnce(t);
+  }
+  // #endregion
+  // #region Rendering
+  render() {
+    const { label: t, disabled: e } = this, i = this.el.view == null || this.el.view.type === "2d";
+    return o`<div .ariaLabel=${t ?? void 0} class=${n({ [s.base]: !0, [d.widget]: !0, [d.disabled]: e })} tabindex=-1>${i ? this._renderContent() : this._renderUnsupportedMessage()}</div>`;
+  }
+  _renderUnsupportedMessage() {
+    return o`<section class=${n(s.error)}><p>${this.messages.unsupported}</p></section>`;
+  }
+  _renderContent() {
+    return [
+      this.hideDirectionalButtons ? void 0 : this._renderDirectionalButtons(),
+      this.showRotationSlider ? this._renderRotation() : void 0
+    ];
+  }
+  _renderDirectionalButtons() {
+    return o`<calcite-action-pad expand-disabled layout=grid><calcite-action-group class=${n(s.buttonsContainer)} dir=ltr @contextmenu=${{
+      handleEvent: this._onContextMenu,
+      capture: !0
+    }} ${p(this._setButtonContainerRef)}>${h.slice(0, 4).map(this._renderButton, this)}${this._renderCompass()}${h.slice(4).map(this._renderButton, this)}</calcite-action-group></calcite-action-pad>`;
+  }
+  _renderButton(t) {
+    const { label: e, iconName: i } = y[t], r = this.messages[e];
+    return o`<calcite-action .active=${this.angle === t} alignment=center class=${n(s.button)} data-angle=${t ?? l} .disabled=${this.disabled} @click=${this._onClick.bind(this, t)} @pointerdown=${this._onButtonPointerDown} .scale=${this.visualScale} .text=${r ?? ""} title=${r ?? l}><calcite-icon .icon=${i} .scale=${this.visualScale}></calcite-icon></calcite-action>`;
+  }
+  _renderCompass() {
+    const t = this.disabled || B(this.el.view) ? "compass-needle" : "arrow-up", e = this.rotation === 0, i = this.messages.resetHeading;
+    return o`<calcite-action alignment=center class=${n(s.compassButton)} .disabled=${this.disabled || !this._rotationEnabled || e} @click=${this._onRotationReset} .scale=${this.visualScale} style=${w(this._rotateIcon(this.rotation))} .text=${i ?? ""} title=${i ?? l}>${!e && o`<calcite-icon .icon=${t} .scale=${this.visualScale}></calcite-icon>` || ""}</calcite-action>`;
+  }
+  _renderRotation() {
+    return o`<calcite-action-pad expand-disabled layout=horizontal><calcite-action-group class=${n(s.rotationContainer)}>${this.showRotationResetButton ? this._renderRotationResetButton() : null}${this._renderRotationSlider()}</calcite-action-group></calcite-action-pad>`;
+  }
+  _renderRotationResetButton() {
+    const t = this.messages.resetHeading;
+    return o`<calcite-action alignment=center class=${n(s.rotationReset)} .disabled=${this.disabled || !this._rotationEnabled} @click=${this._onRotationReset} .scale=${this.visualScale} .text=${t ?? ""} title=${t ?? l}><calcite-icon flip-rtl icon=rotate .scale=${this.visualScale}></calcite-icon></calcite-action>`;
+  }
+  _renderRotationSlider() {
+    return o`<div class=${n(s.rotationSliderContainer)}><calcite-slider .ariaLabel=${this.messages.heading} .disabled=${this.disabled || !this._rotationEnabled} label-handles max=360 min=0 required .scale=${this.visualScale} .value=${Math.round(this.rotation)} @calciteSliderInput=${this._onSliderInput}></calcite-slider></div>`;
+  }
 }
-t("arcgis-directional-pad", n);
+u("arcgis-directional-pad", D);
 export {
-  n as ArcgisDirectionalPad
+  D as ArcgisDirectionalPad
 };

package/dist/components/arcgis-directional-pad/index.d.ts

@@ -1 +1,6 @@
+import "@esri/calcite-components/components/calcite-action-pad";
+import "@esri/calcite-components/components/calcite-action-group";
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-slider";
 export * from "./customElement.js";

package/dist/components/arcgis-directional-pad/index.js

@@ -1 +1,6 @@
+import "@esri/calcite-components/components/calcite-action-pad";
+import "@esri/calcite-components/components/calcite-action-group";
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-slider";
 export * from "./customElement.js";

package/dist/components/arcgis-directional-pad/utils.d.ts

@@ -0,0 +1,25 @@
+/// <reference types="@arcgis/core/interfaces.d.ts" />
+import { Nil } from '@arcgis/components-utils';
+import { DirectionalPadAngle } from './constants';
+export interface Vector {
+    readonly x: number;
+    readonly y: number;
+}
+/**
+ * Find which of the 8 directions is closest to a given vector
+ *
+ * @private
+ */
+export declare function vectorToClosestAngle(vector: Vector): DirectionalPadAngle;
+export declare function unitVectorToAngle({ x, y }: Vector): number;
+export declare function angleToUnitVector(angle: number): Vector;
+export declare function deg2rad(d: number): number;
+export declare function rad2deg(r: number): number;
+export declare function toUnitVector(first: Vector, second: Vector): Vector;
+/**
+ * Given an HTML element, find it's center coordinates
+ *
+ * @private
+ */
+export declare function findElementCenter(element: Element): Vector;
+export declare function canShowNorth(view: __esri.MapView | __esri.SceneView | Nil): boolean;

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

@@ -1,44 +1,49 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-import { ArcgisReferenceElement } from '../../utils/component-utils';
+/// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/components-controllers';
 import { Nil } from '@arcgis/components-utils';
-import { PublicLitElement as LitElement } from '@arcgis/lumina';
+import { default as RouteLayer } from '@arcgis/core/layers/RouteLayer.js';
+import { default as Directions } from '@arcgis/core/widgets/Directions.js';
+import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { PropertyValues } from 'lit';
+import { ArcgisReferenceElement } from '../../utils/component-utils';
 
 declare const useDirectionsWidget: (component: import('@arcgis/components-controllers').StencilLifecycles & {
-    manager: import('@arcgis/components-controllers').ControllerManager<never>;
+    manager: import('@arcgis/components-controllers').ControllerManager;
     el: HTMLElement;
-    autoDestroyDisabled?: boolean | undefined;
-    destroy?: (() => Promise<void>) | undefined;
-} & Pick<__esri.Directions, "label" | "viewModel" | "icon" | "headingLevel" | "layer" | "unit" | "apiKey" | "maxStops" | "searchProperties"> & {
-    reactiveUtils?: __esri.reactiveUtils | undefined;
+    autoDestroyDisabled?: boolean;
+    destroy?: () => Promise<void>;
+} & Pick<Directions, never> & {
+    reactiveUtils?: typeof __esri.reactiveUtils;
     state?: unknown;
     viewModel?: __esri.DirectionsViewModel | undefined;
-    icon: string | Nil;
-    label: string | Nil;
-    referenceElement: string | Nil | ArcgisReferenceElement;
+    icon: Nil | string;
+    label: Nil | string;
+    referenceElement: ArcgisReferenceElement | Nil | string;
     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;
+        childElem?: HTMLElement & {
+            ownedBy?: HTMLElement;
+        };
+        view?: __esri.MapView | __esri.SceneView | Nil;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }, options?: {
-    editConstructorProperties(props: __esri.DirectionsProperties): __esri.DirectionsProperties | Promise<__esri.DirectionsProperties>;
-} | undefined) => __esri.Directions;
-export declare class ArcgisDirections extends LitElement implements Use<typeof useDirectionsWidget> {
-    apiKey: string;
+    editConstructorProperties(props: __esri.DirectionsProperties | undefined): __esri.DirectionsProperties | Promise<__esri.DirectionsProperties | undefined> | undefined;
+} | undefined) => Directions;
+/** [Directions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions.html) provides a way to calculate directions, between two or more input locations with a [RouteLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-RouteLayer.html), using ArcGIS Online and custom Network Analysis Route services.
+ */
+export declare class ArcgisDirections extends LitElement {
+    apiKey: string | nullish;
     /**
      * 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
+     * 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.
      */
@@ -47,29 +52,35 @@ export declare class ArcgisDirections extends LitElement implements Use<typeof u
     hideLayerDetails: boolean | undefined;
     hideSaveAsButton: boolean | undefined;
     hideSaveButton: boolean | undefined;
+    /**
+     * Icon which represents the component.
+     * Typically used when the component is controlled by another component (e.g. by the Expand component).
+     * Search [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/) for possible values.
+     */
     icon: string;
+    /** The component's default label. */
     label: string;
-    readonly lastRoute: __esri.DirectionsLastRoute;
-    layer: __esri.RouteLayer;
+    readonly lastRoute: nullish | __esri.DirectionsLastRoute;
+    layer: nullish | RouteLayer;
     maxStops: number;
     position: __esri.UIPosition;
     referenceElement: ArcgisReferenceElement | Nil | string;
     routeLayerItemId?: string;
-    searchProperties: __esri.DirectionsSearchProperties;
-    readonly state: "ready" | "disabled";
-    unit: "metric" | "imperial" | "millimeters" | "centimeters" | "decimeters" | "meters" | "kilometers" | "inches" | "feet" | "yards" | "miles" | "nautical-miles";
+    searchProperties: nullish | __esri.DirectionsSearchProperties;
+    readonly state: "ready" | "disabled" | "error" | "initializing" | "routing" | "unauthenticated";
+    unit: __esri.SystemOrLengthUnit;
     useDefaultRouteLayer: boolean;
     /** Permanently destroy the component */
     destroy(): Promise<void>;
     getDirections(): Promise<__esri.RouteLayerSolveResult>;
     save(): Promise<__esri.PortalItem>;
-    saveAs(portalItem: Promise<__esri.PortalItem>, options: {
+    saveAs(portalItem: __esri.PortalItem, options: {
         folder: __esri.PortalFolder;
     }): Promise<__esri.PortalItem>;
     zoomToRoute(): Promise<void>;
-    readonly arcgisPropertyChange: CustomEvent<{
+    readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state" | "lastRoute";
     }>;
-    readonly arcgisReady: CustomEvent<undefined>;
+    readonly arcgisReady: TargetedEvent<this, undefined>;
 }
 export {};

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

@@ -1,25 +1,24 @@
 import { c as a } from "../../chunks/runtime.js";
-import { newLayersRouteLayer as s, newWidgetsDirections as r } from "@arcgis/core-adapter";
-import { f as h } from "../../chunks/component-utils.js";
-import { usePropertyChange as n } from "@arcgis/components-controllers";
-import { m as d } from "../../chunks/useWidget.js";
-import { LitElement as l, createEvent as c, noShadowRoot as w } from "@arcgis/lumina";
+import { usePropertyChange as r } from "@arcgis/components-controllers";
+import o from "@arcgis/core/layers/RouteLayer.js";
+import h from "@arcgis/core/widgets/Directions.js";
+import { LitElement as n, createEvent as d, noShadowRoot as l } from "@arcgis/lumina";
+import { m as w } from "../../chunks/useWidget.js";
+import { f as m } from "../../chunks/component-utils.js";
 import { css as u } 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 y = u`arcgis-directions{display:flex}`, m = d(r), i = "map-components:arcgis-directions";
-class g extends l {
+/*! 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.100 */
+const y = u`arcgis-directions{display:block}`, c = w(h), i = "map-components:arcgis-directions";
+class g extends n {
   constructor() {
-    super(...arguments), this.widget = m(this), this.viewModel = this.widget.viewModel, this.apiKey = this.widget.apiKey, this.autoDestroyDisabled = !1, this.headingLevel = this.widget.headingLevel, this.hideLayerDetails = this.widget.visibleElements.layerDetails, this.hideSaveAsButton = this.widget.visibleElements.saveAsButton, this.hideSaveButton = this.widget.visibleElements.saveButton, this.icon = this.widget.icon, this.label = this.widget.label, this.lastRoute = this.widget.lastRoute, this.layer = this.widget.layer, this.maxStops = this.widget.maxStops, this.position = "bottom-left", this.searchProperties = this.widget.searchProperties, this.state = this.viewModel.state, this.unit = this.widget.unit, this.useDefaultRouteLayer = !1, this.arcgisPropertyChange = n()("lastRoute", "state"), this.arcgisReady = c();
+    super(...arguments), this.widget = c(this), this.viewModel = this.widget.viewModel, this.apiKey = this.widget.apiKey, this.autoDestroyDisabled = !1, this.headingLevel = this.widget.headingLevel, this.hideLayerDetails = this.widget.visibleElements.layerDetails, this.hideSaveAsButton = this.widget.visibleElements.saveAsButton, this.hideSaveButton = this.widget.visibleElements.saveButton, this.icon = this.widget.icon, this.label = this.widget.label, this.lastRoute = this.widget.lastRoute, this.layer = this.widget.layer, this.maxStops = this.widget.maxStops, this.position = "bottom-left", this.searchProperties = this.widget.searchProperties, this.state = this.viewModel.state, this.unit = this.widget.unit, this.useDefaultRouteLayer = !1, this.arcgisPropertyChange = r()("lastRoute", "state"), this.arcgisReady = d();
   }
   static {
     this.properties = { apiKey: 1, autoDestroyDisabled: 5, headingLevel: 9, hideLayerDetails: 5, hideSaveAsButton: 5, hideSaveButton: 5, icon: 1, label: 1, lastRoute: 0, layer: 0, maxStops: 9, position: 1, referenceElement: 1, routeLayerItemId: 1, searchProperties: 0, state: 0, unit: 1, useDefaultRouteLayer: 5 };
   }
   static {
-    this.shadowRootOptions = w;
+    this.shadowRootOptions = l;
   }
   static {
     this.styles = y;
@@ -40,10 +39,10 @@ class g extends l {
       throw new Error(`${i} - component not ready to save directions`);
     return await this.widget?.save();
   }
-  async saveAs(t, e) {
+  async saveAs(e, t) {
     if (this.widget?.viewModel?.state !== "ready")
       throw new Error(`${i} - component not ready to save directions as a Portal Item`);
-    return await this.widget?.saveAs(t, e);
+    return await this.widget?.saveAs(e, t);
   }
   async zoomToRoute() {
     if (this.widget?.viewModel?.state !== "ready")
@@ -52,26 +51,25 @@ class g extends l {
   }
   // #endregion
   // #region Lifecycle
-  willUpdate(t) {
-    if (t.has("routeLayerItemId")) {
-      const e = this.routeLayerItemId;
-      h(e) && !this.useDefaultRouteLayer ? (this.widget.view?.map.remove(this.layer), this._setDefaultLayer()) : e && this.widget && s({
+  willUpdate(e) {
+    if (e.has("routeLayerItemId")) {
+      const t = this.routeLayerItemId;
+      if (m(t) && !this.useDefaultRouteLayer) {
+        const { layer: s } = this;
+        s && this.widget.view?.map.remove(s), this._setDefaultLayer();
+      } else t && this.widget && (this.layer = new o({
         portalItem: {
-          id: e
+          id: t
         }
-      }).then((o) => {
-        this.layer = o, this.widget.view?.map.add(this.layer);
-      }).catch(console.error);
+      }), this.widget.view?.map.add(this.layer));
     }
-    t.has("useDefaultRouteLayer") && this._setDefaultLayer();
+    e.has("useDefaultRouteLayer") && this._setDefaultLayer();
   }
   // #endregion
   // #region Private Methods
   /** Maintain a default route layer */
   _setDefaultLayer() {
-    this.useDefaultRouteLayer && !this.routeLayerItemId && s({}).then((t) => {
-      this.layer = t, this.widget.view?.map.add(this.layer);
-    }).catch(console.error);
+    this.useDefaultRouteLayer && !this.routeLayerItemId && (this.layer = new o(), this.widget.view?.map.add(this.layer));
   }
 }
 a("arcgis-directions", g);