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

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

@@ -1,15 +1,16 @@
 import { c as e } from "../../chunks/runtime.js";
 import i from "@arcgis/core/widgets/Daylight.js";
 import { LitElement as t, createEvent as s, noShadowRoot as a } from "@arcgis/lumina";
-import { m as l } from "../../chunks/useWidget.js";
-import { css as h } from "@lit/reactive-element/css-tag.js";
+import { m as h } from "../../chunks/useWidget.js";
+import { css as l } from "@lit/reactive-element/css-tag.js";
+import { reEmitEvent as o } from "@arcgis/lumina/controllers/accessor";
 /*! 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.12 */
-const o = h`@layer{arcgis-daylight{display:block}}`, d = l(i);
+v4.33.0-next.120 */
+const d = l`@layer{arcgis-daylight{display:block}}`, r = h(i);
 class n extends t {
   constructor() {
-    super(...arguments), this.widget = d(this), this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.currentSeason = this.viewModel.currentSeason, this.dateOrSeason = this.widget.dateOrSeason, this.dayPlaying = this.viewModel.dayPlaying, this.headingLevel = this.widget.headingLevel, this.hideDatePicker = this.widget.visibleElements.datePicker, this.hideHeader = this.widget.visibleElements.header, this.hidePlayButtons = this.widget.visibleElements.playButtons, this.hideShadowsToggle = this.widget.visibleElements.shadowsToggle, this.hideSunLightingToggle = this.widget.visibleElements.sunLightingToggle, this.hideTimezone = this.widget.visibleElements.timezone, this.icon = this.widget.icon, this.label = this.widget.label, this.playSpeedMultiplier = this.widget.playSpeedMultiplier, this.position = "bottom-left", this.timeSliderSteps = this.widget.timeSliderSteps, this.yearPlaying = this.viewModel.yearPlaying, this.arcgisReady = s();
+    super(...arguments), this.widget = r(this), this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.currentSeason = this.viewModel.currentSeason, this.dateOrSeason = this.widget.dateOrSeason, this.dayPlaying = this.viewModel.dayPlaying, this.headingLevel = this.widget.headingLevel, this.hideDatePicker = this.widget.visibleElements.datePicker, this.hideHeader = this.widget.visibleElements.header, this.hidePlayButtons = this.widget.visibleElements.playButtons, this.hideShadowsToggle = this.widget.visibleElements.shadowsToggle, this.hideSunLightingToggle = this.widget.visibleElements.sunLightingToggle, this.hideTimezone = this.widget.visibleElements.timezone, this.icon = this.widget.icon, this.label = this.widget.label, this.playSpeedMultiplier = this.widget.playSpeedMultiplier, this.position = "bottom-left", this.timeSliderSteps = this.widget.timeSliderSteps, this.yearPlaying = this.viewModel.yearPlaying, this.arcgisReady = s(), this.arcgisUserDateTimeChange = o(() => this.viewModel, "user-date-time-change");
   }
   static {
     this.properties = { autoDestroyDisabled: 5, currentSeason: 1, dateOrSeason: 1, dayPlaying: 5, headingLevel: 9, hideDatePicker: 5, hideHeader: 5, hidePlayButtons: 5, hideShadowsToggle: 5, hideSunLightingToggle: 5, hideTimezone: 5, icon: 1, label: 1, playSpeedMultiplier: 9, position: 1, referenceElement: 1, timeSliderSteps: 9, yearPlaying: 5 };
@@ -18,11 +19,8 @@ class n extends t {
     this.shadowRootOptions = a;
   }
   static {
-    this.styles = o;
+    this.styles = d;
   }
-  // #endregion
-  // #region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }

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

@@ -1,17 +1,12 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
-import { Use } from '@arcgis/components-controllers';
+import { Use } from '@arcgis/lumina/controllers';
 import { Nil } from '@arcgis/components-utils';
 import { default as DirectionalPadViewModel } from '@arcgis/core/widgets/DirectionalPad/DirectionalPadViewModel.js';
-import { JsxNode, ToElement, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useDirectionalPadViewModel: (component: import('@arcgis/components-controllers').StencilLifecycles & {
-    manager: import('@arcgis/components-controllers').ControllerManager;
-    el: HTMLElement;
-    autoDestroyDisabled?: boolean;
-    destroy?: () => Promise<void>;
-} & Pick<DirectionalPadViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<DirectionalPadViewModel>, options?: {
+declare const useDirectionalPadViewModel: (component: LitElement & Pick<DirectionalPadViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<DirectionalPadViewModel>, options?: {
     editConstructorProperties(props: unknown): unknown;
 } | undefined) => DirectionalPadViewModel;
 /**
@@ -23,26 +18,33 @@ declare const useDirectionalPadViewModel: (component: import('@arcgis/components
  * 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.
+ * The Directional Pad component is not supported in 3D.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-directional-pad/)
  */
 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 temporarily hide it. If this
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-directional-pad/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     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.
+     *
+     * @default false
      */
     disabled: boolean;
     /**
      * Whether to hide directional pad buttons.
+     *
+     * @default false
      */
     hideDirectionalButtons: boolean;
     /**
@@ -51,36 +53,78 @@ export declare class ArcgisDirectionalPad extends LitElement {
      * component).
      *
      * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "move"
      */
     icon: Nil | string;
     /** The component's default label. */
     label: Nil | string;
     /** Overwrite localized strings for this component */
     messageOverrides?: typeof this.messages._overrides;
+    /** @default "bottom-left" */
     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.
+     *
+     * @default false
      */
     showRotationResetButton: boolean;
     /**
      * Whether to display the map rotation slider.
+     *
+     * @default false
      */
     showRotationSlider: boolean;
+    /**
+     * The state of the view model.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-DirectionalPad-DirectionalPadViewModel.html#state)
+     */
     readonly state: "ready" | "disabled" | "moving";
     /**
      * 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.
+     *
+     * @default "s"
      */
     visualScale: HTMLCalciteButtonElement["scale"];
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, undefined>;
+    private messages: Partial<{
+        componentLabel: string;
+        northWest: string;
+        north: string;
+        northEast: string;
+        east: string;
+        southEast: string;
+        south: string;
+        southWest: string;
+        west: string;
+        heading: string;
+        resetHeading: string;
+        unsupported: string;
+    }> & import('@arcgis/lumina/controllers').T9nMeta<{
+        componentLabel: string;
+        northWest: string;
+        north: string;
+        northEast: string;
+        east: string;
+        southEast: string;
+        south: string;
+        southWest: string;
+        west: string;
+        heading: string;
+        resetHeading: string;
+        unsupported: string;
+    }>;
 }
 export {};

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

@@ -1,19 +1,20 @@
 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 { usePropertyChange as m } from "@arcgis/lumina/controllers";
+import { focusElement as g } from "@arcgis/components-utils";
+import { watch as b } 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 } from "../../chunks/useView.js";
+import { u as R } from "../../chunks/useT9n.js";
 import { m as C } from "../../chunks/useViewModel.js";
+import { g as x } from "../../chunks/component-utils.js";
 import { g as d } from "../../chunks/globalCss.js";
-import { css as x } from "@lit/reactive-element/css-tag.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.12 */
-const h = [-45, 0, 45, -90, 90, -135, 180, 135], y = {
+v4.33.0-next.120 */
+const h = [-45, 0, 45, -90, 90, -135, 180, 135], M = {
   0: { label: "north", iconName: "chevron-up" },
   45: { label: "northEast", iconName: "chevron-up-right" },
   90: { label: "east", iconName: "chevron-right" },
@@ -31,55 +32,42 @@ const h = [-45, 0, 45, -90, 90, -135, 180, 135], y = {
   rotationSliderContainer: `${a}__rotation-slider-container`,
   rotationReset: `${a}__rotation-reset-button`,
   error: `${a}__error`
-}, M = x`@layer{.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) {
+}, S = y`@layer{.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 B(c) {
   const { x: t, y: e, width: i, height: r } = c.getBoundingClientRect();
   return { x: t + i / 2, y: e + r / 2 };
 }
-function B(c) {
+function E(c) {
   return c?.spatialReference?.isWebMercator || c?.spatialReference?.isGeographic || !1;
 }
-const E = C(_);
-class D extends v {
+const D = C(_);
+class k extends v {
   constructor() {
-    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();
+    super(...arguments), this.messages = R({}), this._onContextMenu = (t) => t.preventDefault(), this._buttons = {}, this.viewModel = D(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 = { _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 };
+    this.properties = { _rotationEnabled: 16, angle: 16, rotation: 16, autoDestroyDisabled: 5, disabled: 5, hideDirectionalButtons: 5, icon: 1, label: 1, messageOverrides: 0, position: 3, referenceElement: 1, showRotationResetButton: 5, showRotationSlider: 5, state: 3, visualScale: 1 };
   }
   static {
     this.shadowRootOptions = $;
   }
   static {
-    this.styles = M;
-  }
-  // #endregion
-  // #region State Properties
-  /**
-   * When `false`, sets rotation-related controls to a disabled state so the
-   * user  cannot interact with them.
-   */
+    this.styles = S;
+  }
   get _rotationEnabled() {
     return this.view?.ready ? this.view.constraints.rotationEnabled ?? !1 : !0;
   }
-  // #endregion
-  // #region Public Methods
-  /** Permanently destroy the component */
   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]));
+      b(() => this.viewModel.angle, () => {
+        this._buttonsContainer?.contains(document.activeElement) && (this.viewModel.angle == null ? x(this)?.focus() : g(this._buttons[this.viewModel.angle]));
       })
     ]);
   }
-  // #endregion
-  // #region Private Methods
   _rotateIcon(t) {
     return {
       "--rotation": `rotate(${t}deg)`
@@ -93,33 +81,22 @@ class D extends v {
       ]));
     })) : (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);
+    const i = B(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.view == null || this.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>`;
@@ -140,11 +117,11 @@ class D extends v {
     }} ${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];
+    const { label: e, iconName: i } = M[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.view) ? "compass-needle" : "arrow-up", e = this.rotation === 0, i = this.messages.resetHeading;
+    const t = this.disabled || E(this.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() {
@@ -158,7 +135,7 @@ class D extends v {
     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>`;
   }
 }
-u("arcgis-directional-pad", D);
+u("arcgis-directional-pad", k);
 export {
-  D as ArcgisDirectionalPad
+  k as ArcgisDirectionalPad
 };

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

@@ -1,6 +1,6 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
-import { Use } from '@arcgis/components-controllers';
+import { Use } from '@arcgis/lumina/controllers';
 import { Nil } from '@arcgis/components-utils';
 import { default as RouteLayer } from '@arcgis/core/layers/RouteLayer.js';
 import { default as Directions } from '@arcgis/core/widgets/Directions.js';
@@ -8,69 +8,139 @@ 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;
-    el: HTMLElement;
-    autoDestroyDisabled?: boolean;
-    destroy?: () => Promise<void>;
-} & Pick<Directions, never> & {
-    reactiveUtils?: typeof __esri.reactiveUtils;
+declare const useDirectionsWidget: (component: LitElement & Pick<Directions, never> & {
     state?: unknown;
     viewModel?: __esri.DirectionsViewModel | undefined;
+    closed?: boolean;
     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<{
+    arcgisReady: import('@arcgis/lumina').EventEmitter;
+    arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
         name: string;
     }> | undefined;
     el: HTMLElement & {
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.MapView | __esri.SceneView | Nil;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView | Nil;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }, options?: {
     editConstructorProperties(props: __esri.DirectionsProperties | undefined): __esri.DirectionsProperties | Promise<__esri.DirectionsProperties | undefined> | undefined;
 } | undefined) => Directions;
-/** Directions component 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.
+/**
+ * Directions component 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.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-directions/)
  */
 export declare class ArcgisDirections extends LitElement {
+    /**
+     * An authorization string used to access a resource or service.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions.html#apiKey)
+     */
     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 temporarily hide it. If this
-     * is set, make sure to call the \`destroy\` method when you are done to prevent
-     * memory leaks.
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-directions/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * This function provides the ability to override either the
+     * [MapView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo) or
+     * [SceneView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo) methods.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions.html#goToOverride)
+     */
+    goToOverride: nullish | __esri.GoToOverride;
+    /**
+     * Indicates the heading level to use for the origin and destination addresses (i.e.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions.html#headingLevel)
+     *
+     * @default 2
+     */
     headingLevel: number;
+    /** @default false */
     hideLayerDetails: boolean | undefined;
+    /** @default false */
     hideSaveAsButton: boolean | undefined;
+    /** @default false */
     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 which represents the widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions.html#icon)
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "right"
      */
     icon: string;
-    /** The component's default label. */
+    /**
+     * The widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions.html#label)
+     */
     label: string;
+    /**
+     * The most recent route result.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions.html#lastRoute)
+     *
+     * @default null
+     */
     readonly lastRoute: nullish | __esri.DirectionsLastRoute;
+    /**
+     * The [RouteLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-RouteLayer.html) associated with the Directions widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions.html#layer)
+     */
     layer: nullish | RouteLayer;
+    /**
+     * The maximum number of stops allowed for routing.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions.html#maxStops)
+     *
+     * @default 50
+     */
     maxStops: number;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
     referenceElement: ArcgisReferenceElement | Nil | string;
     routeLayerItemId?: string;
+    /**
+     * Controls the default properties used when [searching](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search.html).
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions.html#searchProperties)
+     *
+     * @default null
+     */
     searchProperties: nullish | __esri.DirectionsSearchProperties;
+    /**
+     * The current state of the view model.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions-DirectionsViewModel.html#state)
+     *
+     * @default "disabled"
+     */
     readonly state: "ready" | "disabled" | "error" | "initializing" | "routing" | "unauthenticated";
+    /**
+     * Unit system (imperial, metric) or specific unit used for displaying the distance values.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions.html#unit)
+     */
     unit: __esri.SystemOrLengthUnit;
+    /** @default false */
     useDefaultRouteLayer: boolean;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     getDirections(): Promise<__esri.RouteLayerSolveResult>;
     save(): Promise<__esri.PortalItem>;
@@ -78,9 +148,11 @@ export declare class ArcgisDirections extends LitElement {
         folder: __esri.PortalFolder;
     }): Promise<__esri.PortalItem>;
     zoomToRoute(): Promise<void>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state" | "lastRoute";
     }>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, undefined>;
 }
 export {};

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

@@ -1,31 +1,29 @@
 import { c as a } from "../../chunks/runtime.js";
-import { usePropertyChange as r } from "@arcgis/components-controllers";
+import { usePropertyChange as r } from "@arcgis/lumina/controllers";
+import { watch as h } from "@arcgis/core/core/reactiveUtils.js";
 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";
+import d from "@arcgis/core/widgets/Directions.js";
+import { LitElement as n, createEvent as l, noShadowRoot as w } from "@arcgis/lumina";
+import { m } from "../../chunks/useWidget.js";
+import { e as u } 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.12 */
-const y = u`@layer{arcgis-directions{display:block}}`, c = w(h), i = "map-components:arcgis-directions";
-class g extends n {
+v4.33.0-next.120 */
+const c = y`@layer{arcgis-directions{display:block}}`, g = m(d), i = "map-components:arcgis-directions";
+class p extends n {
   constructor() {
-    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();
+    super(...arguments), this.widget = g(this), this.viewModel = this.widget.viewModel, this.apiKey = this.widget.apiKey, this.autoDestroyDisabled = !1, this.goToOverride = this.widget.goToOverride, 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 = l();
   }
   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 };
+    this.properties = { apiKey: 1, autoDestroyDisabled: 5, goToOverride: 0, 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: 3, unit: 1, useDefaultRouteLayer: 5 };
   }
   static {
-    this.shadowRootOptions = l;
+    this.shadowRootOptions = w;
   }
   static {
-    this.styles = y;
+    this.styles = c;
   }
-  // #endregion
-  // #region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
@@ -49,30 +47,25 @@ class g extends n {
       throw new Error(`${i} - component not ready to zoom to route`);
     this.widget?.zoomToRoute();
   }
-  // #endregion
-  // #region Lifecycle
   willUpdate(e) {
     if (e.has("routeLayerItemId")) {
       const t = this.routeLayerItemId;
-      if (m(t) && !this.useDefaultRouteLayer) {
+      if (u(t) && !this.useDefaultRouteLayer) {
         const { layer: s } = this;
-        s && this.widget.view?.map.remove(s), this._setDefaultLayer();
+        s && this.widget.view?.map?.remove(s), this._setDefaultLayer();
       } else t && this.widget && (this.layer = new o({
         portalItem: {
           id: t
         }
-      }), this.widget.view?.map.add(this.layer));
+      }), this.widget.view?.map?.add(this.layer));
     }
     e.has("useDefaultRouteLayer") && this._setDefaultLayer();
   }
-  // #endregion
-  // #region Private Methods
-  /** Maintain a default route layer */
   _setDefaultLayer() {
-    this.useDefaultRouteLayer && !this.routeLayerItemId && (this.layer = new o(), this.widget.view?.map.add(this.layer));
+    this.useDefaultRouteLayer && !this.routeLayerItemId && (this.layer = new o(), h(() => this.widget.view, () => this.widget.view?.map?.add(this.layer), { once: !0 }));
   }
 }
-a("arcgis-directions", g);
+a("arcgis-directions", p);
 export {
-  g as ArcgisDirections
+  p as ArcgisDirections
 };