@arcgis/map-components 4.33.0-next.98 → 4.34.0-next.0

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

@@ -1,17 +1,17 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
 import { default as Measurement } from '@arcgis/core/widgets/Measurement.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useMeasurementWidget: (component: LitElement & Pick<Measurement, never> & {
+declare const useMeasurementWidget: (component: LitElement & Pick<Measurement, "icon" | "label" | "viewModel" | "activeTool" | "areaUnit" | "linearUnit"> & {
     state?: unknown;
     viewModel?: __esri.MeasurementViewModel | undefined;
-    icon: Nil | string;
-    label: Nil | string;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    closed?: boolean;
+    icon: import('@arcgis/components-utils').Nil | string;
+    label: import('@arcgis/components-utils').Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
     position: __esri.UIPosition;
     arcgisReady: import('@arcgis/lumina').EventEmitter;
     arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
@@ -21,47 +21,86 @@ declare const useMeasurementWidget: (component: LitElement & Pick<Measurement, n
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.MapView | __esri.SceneView | Nil;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
-}, options?: {
-    editConstructorProperties(props: __esri.MeasurementProperties | undefined): __esri.MeasurementProperties | Promise<__esri.MeasurementProperties | undefined> | undefined;
-} | undefined) => Measurement;
+}) => Measurement;
 /**
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-measurement/)
+ *
  * @internal
  */
 export declare class ArcgisMeasurement extends LitElement {
-    activeTool: "area" | nullish | "distance" | "direct-line";
-    readonly activeWidget: nullish | __esri.DistanceMeasurement2D | __esri.DirectLineMeasurement3D | __esri.AreaMeasurement3D | __esri.AreaMeasurement2D;
+    /**
+     * Specifies the current measurement tool to display.
+     *
+     * @default null
+     */
+    activeTool: nullish | "area" | "distance" | "direct-line";
+    /**
+     * The measurement widget that is currently being used.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement.html#activeWidget)
+     *
+     * @default null
+     */
+    readonly activeWidget: nullish | __esri.DistanceMeasurement2D | __esri.AreaMeasurement2D | __esri.AreaMeasurement3D | __esri.DirectLineMeasurement3D;
+    /**
+     * Unit system (imperial, metric) or specific unit used for displaying the area values.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement.html#areaUnit)
+     */
     areaUnit: __esri.SystemOrAreaUnit;
     /**
      * 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-measurement/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
     /**
-     * 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.
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "measure"
      */
     icon: string;
-    /** The component's default label. */
+    /**
+     * The widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement.html#label)
+     */
     label: string;
+    /**
+     * 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-Measurement.html#linearUnit)
+     */
     linearUnit: __esri.SystemOrLengthUnit;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * The ViewModel's state.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement-MeasurementViewModel.html#state)
+     *
+     * @default "disabled"
+     */
     readonly state: "ready" | "disabled" | "measuring" | "measured";
     clear(): Promise<void>;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     startMeasurement(): 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" | "activeTool";
     }>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
 }
 export {};

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

@@ -5,8 +5,8 @@ import { LitElement as s, createEvent as a, noShadowRoot as o } from "@arcgis/lu
 import { m as r } from "../../chunks/useWidget.js";
 import { css as n } 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.98 */
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
 const c = n`@layer{arcgis-measurement{display:block}}`, l = r(i);
 class h extends s {
   constructor() {
@@ -21,12 +21,9 @@ class h extends s {
   static {
     this.styles = c;
   }
-  //#endregion
-  //#region Public Methods
   async clear() {
     this.widget?.clear();
   }
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }

package/dist/components/arcgis-measurement-content/customElement.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="../../index.d.ts" />
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { MeasurementState, MeasurementValue } from '../../support/measurementUtils';
+
+/**
+ * Component which displays the contents of a measurement content.
+ *
+ * @private
+ */
+export declare class ArcgisMeasurementContent extends LitElement {
+    hintLabel?: string;
+    items: {
+        title?: string;
+        measurement: MeasurementValue;
+    }[];
+    /** @default "disabled" */
+    state: MeasurementState;
+    /** @default "" */
+    unsupportedLabel: string;
+}

package/dist/components/arcgis-measurement-content/customElement.js

@@ -0,0 +1,59 @@
+import { c as n } from "../../chunks/runtime.js";
+import { html as i } from "lit-html";
+import o from "@arcgis/core/applications/Components/QuantityFormatter.js";
+import { LitElement as c, safeClassMap as s } from "@arcgis/lumina";
+import { f as l } from "../../chunks/measurementUtils.js";
+import { css as m } from "@lit/reactive-element/css-tag.js";
+/*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
+const u = m`:host,.hint,.error,.section,.actions,.item{display:flex;flex-direction:column;gap:var(--calcite-spacing-md);animation:esri-fade-in .25s ease-in-out}.error{color:var(--calcite-color-status-danger)}.error,.hint{overflow:hidden;p{margin:0;padding:0}}.item-disabled{color:var(--calcite-color-text-1);opacity:var(--calcite-opacity-light)}.item-value{font-weight:var(--calcite-font-weight-semibold)}.actions{justify-content:center}`, e = {
+  error: "error",
+  hint: "hint",
+  actions: "actions",
+  section: "section",
+  item: "item",
+  itemDisabled: "item-disabled",
+  itemTitle: "item-title",
+  itemValue: "item-value"
+};
+class d extends c {
+  constructor() {
+    super(...arguments), this._formatter = new o(), this.items = [], this.state = "disabled", this.unsupportedLabel = "";
+  }
+  static {
+    this.properties = { hintLabel: 1, items: 0, state: 1, unsupportedLabel: 1 };
+  }
+  static {
+    this.styles = u;
+  }
+  async load() {
+    await this._formatter.when();
+  }
+  render() {
+    switch (this.state) {
+      case "unsupported":
+        return i`<section class=${s(e.error)}><p>${this.unsupportedLabel}</p></section>`;
+      case "measuring":
+        return i`<section class=${s(e.hint)}><p>${this.hintLabel}</p></section>`;
+      case "ready":
+        return i`<div class=${s(e.actions)}><slot name=actions></slot></div>`;
+      default:
+        return i`<slot name=settings></slot>${h({ formatter: this._formatter, items: this.items })}<div class=${s(e.actions)}><slot name=actions></slot></div>`;
+    }
+  }
+}
+function h(t) {
+  return i`<section class=${s(e.section)}>${t.items.map((a) => f({ formatter: t.formatter, measurement: a.measurement, title: a.title }))}</section>`;
+}
+function f(t) {
+  const a = t.measurement.state === "available" ? l(t.formatter, t.measurement.value) : null, r = t.measurement.state === "unavailable";
+  return i`<div class=${s({
+    [e.item]: !0,
+    [e.itemDisabled]: r
+  })}><span class=${s(e.itemTitle)}>${t.title}</span><span aria-live=polite class=${s(e.itemValue)}>${a ?? "-"}</span></div>`;
+}
+n("arcgis-measurement-content", d);
+export {
+  d as ArcgisMeasurementContent
+};

package/dist/components/arcgis-navigation-toggle/customElement.d.ts

@@ -1,7 +1,6 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { PropertyValues } from 'lit';
 import { useView } from '../../controllers/useView';
@@ -18,6 +17,8 @@ type LayoutMode = "horizontal" | "vertical";
  * right-click + drag pans the view.
  *
  * The Navigation Toggle component is only supported in 3D.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-navigation-toggle/)
  */
 export declare class ArcgisNavigationToggle extends LitElement {
     /**
@@ -27,11 +28,17 @@ export declare class ArcgisNavigationToggle extends LitElement {
      *
      * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
      */
-    icon: HTMLCalciteIconElement["icon"] | Nil;
+    icon?: HTMLCalciteIconElement["icon"];
     /** The component's default label. */
-    label: string | undefined;
-    /** The layout direction of the component. */
+    label?: string;
+    /**
+     * The layout direction of the component.
+     *
+     * @default "vertical"
+     */
     layout: LayoutMode;
+    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    messageOverrides?: typeof this._messages._overrides;
     /**
      * The navigation mode of the view. See the table below for a list of
      * possible values.
@@ -40,15 +47,34 @@ export declare class ArcgisNavigationToggle extends LitElement {
      * ---------------|-------------
      * pan | The mouse drag gesture pans the view. Right-click + drag allows the user to perform a 3D rotate around the center of the view.
      * rotate | The mouse drag gesture performs a 3D rotate around the center of the view and the right-click + drag gesture pans the view.
+     *
+     * @default "pan"
      */
     navigationMode: NavigationMode;
+    /** @default "top-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * The current state of the component.
+     *
+     * @default "disabled"
+     */
     state: State;
     toggle(): 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" | "layout";
     }>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
+    private _messages: Partial<{
+        componentLabel: string;
+        pan: string;
+        rotate: string;
+    }> & import('@arcgis/lumina/controllers').T9nMeta<{
+        componentLabel: string;
+        pan: string;
+        rotate: string;
+    }>;
 }
 export {};

package/dist/components/arcgis-navigation-toggle/customElement.js

@@ -8,8 +8,8 @@ import { u as f } from "../../chunks/useView.js";
 import { g as b } from "../../chunks/globalCss.js";
 import { css as M } 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.98 */
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
 const $ = "arcgis-navigation-toggle", w = {
   base: $
 }, x = M`@layer{.arcgis-navigation-toggle{display:flex;box-shadow:0 1px 2px #0000004d;inline-size:fit-content;block-size:fit-content}}`, e = { pan: "move", rotate: "rotate" };
@@ -18,7 +18,7 @@ class _ extends g {
     super(...arguments), this.view = f(this), this._messages = y(), this.icon = e.pan, this.layout = "vertical", this.navigationMode = "pan", this.position = "top-left", this.state = "disabled", this.arcgisPropertyChange = d()("layout", "state"), this.arcgisReady = h();
   }
   static {
-    this.properties = { icon: 3, label: 1, layout: 3, navigationMode: 3, position: 1, referenceElement: 1, state: 3 };
+    this.properties = { icon: 1, label: 1, layout: 3, messageOverrides: 0, navigationMode: 3, position: 1, referenceElement: 1, state: 3 };
   }
   static {
     this.shadowRootOptions = m;
@@ -26,13 +26,9 @@ class _ extends g {
   static {
     this.styles = x;
   }
-  //#endregion
-  //#region Public Methods
   async toggle() {
     this.state !== "disabled" && (this.navigationMode = this.navigationMode !== "pan" ? "pan" : "rotate");
   }
-  //#endregion
-  //#region Lifecycle
   load() {
     this.manager.onLifecycle(() => [
       c(() => this.view?.navigation?.actionMap, () => this._updateNavigationActionMap()),
@@ -47,8 +43,6 @@ class _ extends g {
   willUpdate(t) {
     t.has("navigationMode") && this._updateNavigationActionMap();
   }
-  //#endregion
-  //#region Private Methods
   _onPanClick() {
     this.navigationMode = "pan";
   }
@@ -62,11 +56,9 @@ class _ extends g {
     const a = this.navigationMode === "pan";
     t.dragPrimary = a ? "pan" : "rotate", t.dragSecondary = a ? "rotate" : "pan";
   }
-  //#endregion
-  //#region Rendering
   render() {
-    const { _messages: t, navigationMode: a, state: l } = this, o = t.pan ?? "", s = t.rotate ?? "", i = l === "disabled", n = a === "pan";
-    return u`<calcite-action-bar class=${v({ [w.base]: !0, [b.disabled]: i })} expand-disabled .layout=${this.layout} scale=s><calcite-action .active=${n} appearance=solid .disabled=${i} .icon=${e.pan} @click=${this._onPanClick} scale=s .text=${o} title=${o ?? r}></calcite-action><calcite-action .active=${!n} appearance=solid .disabled=${i} .icon=${e.rotate} @click=${this._onRotateClick} scale=s .text=${s} title=${s ?? r}></calcite-action></calcite-action-bar>`;
+    const { _messages: t, navigationMode: a, state: l } = this, s = t.pan ?? "", o = t.rotate ?? "", i = l === "disabled", n = a === "pan";
+    return u`<calcite-action-bar class=${v({ [w.base]: !0, [b.disabled]: i })} expand-disabled .layout=${this.layout} scale=s><calcite-action .active=${n} appearance=solid .disabled=${i} .icon=${e.pan} @click=${this._onPanClick} scale=s .text=${s} title=${s ?? r}></calcite-action><calcite-action .active=${!n} appearance=solid .disabled=${i} .icon=${e.rotate} @click=${this._onRotateClick} scale=s .text=${o} title=${o ?? r}></calcite-action></calcite-action-bar>`;
   }
 }
 p("arcgis-navigation-toggle", _);

package/dist/components/arcgis-oriented-imagery-viewer/customElement.d.ts

@@ -1,20 +1,19 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
 import { default as OrientedImageryLayer } from '@arcgis/core/layers/OrientedImageryLayer.js';
 import { default as OrientedImageryViewer } from '@arcgis/core/widgets/OrientedImageryViewer.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { PropertyValues } from 'lit';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-export type OrientedImageryViewerWidget = InstanceType<typeof OrientedImageryViewer>;
-declare const useOrientedImageryViewerWidget: (component: LitElement & Pick<OrientedImageryViewer, never> & {
+declare const useOrientedImageryViewerWidget: (component: LitElement & Pick<OrientedImageryViewer, "icon" | "label" | "viewModel" | "layer" | "disabled" | "currentCoverageVisible" | "dataCaptureEnabled" | "galleryOpened" | "imageEnhancementToolActive" | "isAdditionalCoverageVisible" | "isAdditionalPointSourcesVisible" | "mapImageConversionToolState" | "navigationToolActive"> & {
     state?: unknown;
     viewModel?: __esri.OrientedImageryViewerViewModel | undefined;
-    icon: Nil | string;
-    label: Nil | string;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    closed?: boolean;
+    icon: import('@arcgis/components-utils').Nil | string;
+    label: import('@arcgis/components-utils').Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
     position: __esri.UIPosition;
     arcgisReady: import('@arcgis/lumina').EventEmitter;
     arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
@@ -24,60 +23,133 @@ declare const useOrientedImageryViewerWidget: (component: LitElement & Pick<Orie
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.
-        /**
-         * 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.
-         */
-        MapView | __esri.SceneView | Nil;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
-}, options?: {
-    editConstructorProperties(props: __esri.OrientedImageryViewerProperties | undefined): __esri.OrientedImageryViewerProperties | Promise<__esri.OrientedImageryViewerProperties | undefined> | undefined;
-} | undefined) => OrientedImageryViewer;
-/** The OrientedImageryViewer component allows the user to explore and use their oriented images.
+}) => OrientedImageryViewer;
+/**
+ * The Oriented Imagery Viewer component allows the user to explore and use their oriented images.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-oriented-imagery-viewer/)
  */
 export declare class ArcgisOrientedImageryViewer extends LitElement {
     /**
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the
      * component to a different place on the page, or temporarily hide it. If this
-     * is set, make sure to call the \`destroy\` method when you are done to prevent
-     * memory leaks.
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-oriented-imagery-viewer/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * Toggles the visibility of the current footprint polygon associated with the selected image loaded in the viewer.
+     *
+     * @default true
+     */
     currentCoverageVisible: boolean;
+    /**
+     * Indicates whether the data capture tools are enabled in the oriented imagery viewer for digitization.
+     *
+     * @default false
+     */
     dataCaptureEnabled: boolean;
+    /**
+     * When `false`, the view click interaction is enabled for the oriented imagery viewer widget.
+     *
+     * @default false
+     */
     disabled: boolean;
+    /**
+     * Indicates if the image gallery functionality is available in the widget.
+     *
+     * @default false
+     */
     galleryOpened: boolean;
     /**
-     * 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 displayed in the widget's button.
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "oriented-imagery-widget"
      */
     icon: string;
+    /**
+     * Indicates if the image enhancement tool is active.
+     *
+     * @default false
+     */
     imageEnhancementToolActive: boolean;
+    /**
+     * When `true`, the image gallery functionality is available in the widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-OrientedImageryViewer.html#imageGalleryEnabled)
+     *
+     * @default false
+     */
     readonly imageGalleryEnabled: boolean;
+    /**
+     * Indicates whether the image overlays tab in the oriented imagery viewer is open.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-OrientedImageryViewer.html#imageOverlaysOpened)
+     *
+     * @default false
+     */
+    imageOverlaysOpened: boolean;
+    /**
+     * Indicates if the additional footprint polygons are visible for the selected image loaded in the viewer.
+     *
+     * @default false
+     */
     isAdditionalCoverageVisible: boolean;
+    /**
+     * Indicates if the additional camera locations are visible for the selected image loaded in the viewer.
+     *
+     * @default false
+     */
     isAdditionalPointSourcesVisible: boolean;
-    /** The component's default label. */
+    /**
+     * The widget's label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Widget.html#label)
+     */
     label: string | nullish;
+    /**
+     * Specifies the current [OrientedImageryLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-OrientedImageryLayer.html) to use.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-OrientedImageryViewer.html#layer)
+     */
     layer: nullish | OrientedImageryLayer;
+    /**
+     * Indicates if the map-image location tool is available in the widget.
+     *
+     * @default false
+     */
     mapImageConversionToolState: boolean;
+    /**
+     * When `true`, the navigation tool is available in the widget.
+     *
+     * @default false
+     */
     navigationToolActive: boolean;
     orientedImageryLayerItemId?: string;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * This property provides the location of an image pixel in Map coordinates when using map-image conversion tool.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-OrientedImageryViewer.html#referencePoint)
+     */
     readonly referencePoint: nullish | __esri.Point;
-    /** 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: "layer" | "imageGalleryEnabled";
     }>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
 }
 export {};

package/dist/components/arcgis-oriented-imagery-viewer/customElement.js

@@ -6,15 +6,15 @@ import { LitElement as o, createEvent as d, noShadowRoot as n } from "@arcgis/lu
 import { m as l } from "../../chunks/useWidget.js";
 import { css as g } 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.98 */
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
 const h = g`@layer{arcgis-oriented-imagery-viewer{display:block}}`, m = l(r);
 class y extends o {
   constructor() {
-    super(...arguments), this.widget = m(this), this._hasOrientedImageryLayerToAdd = !1, this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.currentCoverageVisible = this.widget.currentCoverageVisible, this.dataCaptureEnabled = this.widget.dataCaptureEnabled, this.disabled = this.widget.disabled, this.galleryOpened = this.widget.galleryOpened, this.icon = this.widget.icon, this.imageEnhancementToolActive = this.widget.imageEnhancementToolActive, this.imageGalleryEnabled = this.widget.imageGalleryEnabled, this.isAdditionalCoverageVisible = this.widget.isAdditionalCoverageVisible, this.isAdditionalPointSourcesVisible = this.widget.isAdditionalPointSourcesVisible, this.label = this.widget.label, this.layer = this.widget.layer, this.mapImageConversionToolState = this.widget.mapImageConversionToolState, this.navigationToolActive = this.widget.navigationToolActive, this.position = "bottom-left", this.referencePoint = this.widget.referencePoint, this.arcgisPropertyChange = a()("imageGalleryEnabled", "layer"), this.arcgisReady = d();
+    super(...arguments), this.widget = m(this), this._hasOrientedImageryLayerToAdd = !1, this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.currentCoverageVisible = this.widget.currentCoverageVisible, this.dataCaptureEnabled = this.widget.dataCaptureEnabled, this.disabled = this.widget.disabled, this.galleryOpened = this.widget.galleryOpened, this.icon = this.widget.icon, this.imageEnhancementToolActive = this.widget.imageEnhancementToolActive, this.imageGalleryEnabled = this.widget.imageGalleryEnabled, this.imageOverlaysOpened = this.widget.imageOverlaysOpened, this.isAdditionalCoverageVisible = this.widget.isAdditionalCoverageVisible, this.isAdditionalPointSourcesVisible = this.widget.isAdditionalPointSourcesVisible, this.label = this.widget.label, this.layer = this.widget.layer, this.mapImageConversionToolState = this.widget.mapImageConversionToolState, this.navigationToolActive = this.widget.navigationToolActive, this.position = "bottom-left", this.referencePoint = this.widget.referencePoint, this.arcgisPropertyChange = a()("imageGalleryEnabled", "layer"), this.arcgisReady = d();
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, currentCoverageVisible: 5, dataCaptureEnabled: 5, disabled: 5, galleryOpened: 5, icon: 1, imageEnhancementToolActive: 5, imageGalleryEnabled: 4, isAdditionalCoverageVisible: 5, isAdditionalPointSourcesVisible: 5, label: 1, layer: 0, mapImageConversionToolState: 5, navigationToolActive: 5, orientedImageryLayerItemId: 1, position: 1, referenceElement: 1, referencePoint: 0 };
+    this.properties = { autoDestroyDisabled: 5, currentCoverageVisible: 5, dataCaptureEnabled: 5, disabled: 5, galleryOpened: 5, icon: 1, imageEnhancementToolActive: 5, imageGalleryEnabled: 4, imageOverlaysOpened: 5, isAdditionalCoverageVisible: 5, isAdditionalPointSourcesVisible: 5, label: 1, layer: 0, mapImageConversionToolState: 5, navigationToolActive: 5, orientedImageryLayerItemId: 1, position: 1, referenceElement: 1, referencePoint: 0 };
   }
   static {
     this.shadowRootOptions = n;
@@ -22,18 +22,13 @@ class y extends o {
   static {
     this.styles = h;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
-  //#endregion
-  //#region Lifecycle
   willUpdate(e) {
     if (e.has("orientedImageryLayerItemId")) {
       const i = this.orientedImageryLayerItemId;
-      i && this.widget && (this.layer = new s({ portalItem: { id: i } }), this.widget.view ? this.widget.view.map.add(this.layer) : this._hasOrientedImageryLayerToAdd = !0);
+      i && this.widget && (this.layer = new s({ portalItem: { id: i } }), this.widget.view ? this.widget.view.map?.add(this.layer) : this._hasOrientedImageryLayerToAdd = !0);
     }
   }
   loaded() {
@@ -41,11 +36,9 @@ class y extends o {
       this._onReady();
     }, { once: !0 }));
   }
-  //#endregion
-  //#region Private Methods
   _onReady() {
     const { layer: e } = this;
-    e && (this.widget.view?.map.add(e), this._hasOrientedImageryLayerToAdd = !1);
+    e && (this.widget.view?.map?.add(e), this._hasOrientedImageryLayerToAdd = !1);
   }
 }
 t("arcgis-oriented-imagery-viewer", y);

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

@@ -1,14 +1,18 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { ArcgisReferenceElement, WidgetOrMapComponent } from '../../utils/component-utils';
-import { Nil } from '@arcgis/components-utils';
 import { PropertyValues } from 'lit';
 import { ToElement, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 
-/** The placement component is used to position content relative to the map. This component may be **temporary** until we offer a more robust solution.
+/**
+ * The placement component is used to position content relative to the map. This component may be **temporary** until we offer a more robust solution.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-placement/)
  */
 export declare class ArcgisPlacement extends LitElement {
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    referenceElement?: ArcgisReferenceElement | string;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
 }