@arcgis/map-components 4.33.0-next.99 → 4.33.0

package/dist/components/arcgis-area-measurement-3d/AreaMeasurement3dViewModel.d.ts

@@ -0,0 +1,39 @@
+/// <reference types="@arcgis/core/interfaces.d.ts" />
+import { default as AreaMeasurementAnalysis } from '@arcgis/core/analysis/AreaMeasurementAnalysis.js';
+import { default as SceneView } from '@arcgis/core/views/SceneView';
+import { AnalysisViewModel } from '../../support/AnalysisViewModel';
+import { MeasurementModeString, MeasurementState, MeasurementValue } from '../../support/measurementUtils';
+export interface Measurement {
+    readonly mode: MeasurementModeString;
+    readonly area: MeasurementValue<__esri.Area>;
+    readonly perimeter: MeasurementValue<__esri.Length>;
+}
+export default class AreaMeasurement3dViewModel extends AnalysisViewModel<SceneView, AreaMeasurementAnalysis> {
+    initialize(): void;
+    get state(): Exclude<MeasurementState, "unsupported">;
+    get displayState(): MeasurementState;
+    /**
+     * The current measurement calculated between the two points.
+     */
+    get measurement(): Measurement;
+    /**
+     * List of unit systems (imperial, metric) and specific units for displaying the distance values.
+     */
+    get unitOptions(): __esri.SystemOrAreaUnit[];
+    set unitOptions(units: __esri.SystemOrAreaUnit[] | undefined);
+    private _userUnitOptions?;
+    /**
+     * Unit system (imperial, metric) or specific unit used for displaying the distance values.
+     */
+    get unit(): __esri.SystemOrAreaUnit;
+    set unit(unit: __esri.SystemOrAreaUnit | undefined);
+    private _userUnit?;
+    get defaultUnit(): __esri.MeasurementSystem | undefined;
+    place(options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    protected clearAnalysis(): void;
+    protected readonly supportedViewType = "3d";
+    protected readonly unsupportedErrorMessage = "The Area Measurement 3D component is only supported in 3D views.";
+    protected constructAnalysis(): AreaMeasurementAnalysis;
+}

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

@@ -1,65 +1,161 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
+import { PublicLitElement as LitElement, JsxNode, TargetedEvent } from '@arcgis/lumina';
 import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
-import { default as AreaMeasurement3D } from '@arcgis/core/widgets/AreaMeasurement3D.js';
-import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
+import { default as AreaMeasurement3dViewModel } from './AreaMeasurement3dViewModel';
 
-declare const useAreaMeasurement3dWidget: (component: LitElement & Pick<AreaMeasurement3D, never> & {
-    state?: unknown;
-    viewModel?: __esri.AreaMeasurement3DViewModel | undefined;
-    icon: Nil | string;
-    label: Nil | string;
-    referenceElement: ArcgisReferenceElement | Nil | string;
-    position: __esri.UIPosition;
-    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;
-    };
-    autoDestroyDisabled: boolean;
-    destroy: () => Promise<void>;
-}, options?: {
-    editConstructorProperties(props: __esri.AreaMeasurement3DProperties | undefined): __esri.AreaMeasurement3DProperties | Promise<__esri.AreaMeasurement3DProperties | undefined> | undefined;
-} | undefined) => AreaMeasurement3D;
-/** AreaMeasurement3D component calculates and displays the area and perimeter of a polygon. This component can be used in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html) to measure the area and perimeter of a polygon.
+declare const useViewModel: (component: LitElement & Pick<AreaMeasurement3dViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<AreaMeasurement3dViewModel>) => AreaMeasurement3dViewModel;
+/**
+ * The Area Measurement 3D component can be added to a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)
+ * component to calculate and display area and perimeter of polygons.
+ *
+ * [![measurement-area-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/3D_AreaMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)
+ *
+ * How the area and perimeter are computed depends on the scene's spatial reference and the length of the measured perimeter.
+ *
+ * In **geographic coordinate systems** (GCS) and in **Web Mercator**:
+ * - If the measurement's perimeter is below 100 km, they are computed in a Euclidean manner,
+ *   in an [ECEF](https://en.wikipedia.org/wiki/ECEF) coordinate system (or equivalent on other planets).
+ * - If the perimeter is above 100 km, they are computed geodetically, and the visualization takes
+ *   the curvature of the planet into consideration.
+ *
+ * In **projected coordinate systems** (PCS), apart from Web Mercator, the area and perimeter
+ * are always calculated in a Euclidean manner (in their respective PCS).
+ *
+ * The area may be visualized and calculated in two ways:
+ * 1. If all the vertices are mostly coplanar (lying on the same plane),
+ *    the measurement polygon is formed on that plane, and area and perimeter are calculated from its geometry.
+ * 2. If the vertices don't form a planar surface, the measurement polygon
+ *    is projected to a horizontal plane, and area and perimeter are calculated from its geometry.
+ *
+ * ![area-measurement-3d-types](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/area-measurement-3d-types.png)
+ *
+ * When the component is active, a horizontal "laser" line is drawn which indicates the height at the current mouse position.
+ * This line can help in analyzing the heights of objects relative to each other and the terrain.
+ *
+ * **Things to consider**
+ *
+ * * Area Measurement 3D is designed to work in the Scene component. For measurements in the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)
+ * component, use [Area Measurement 2D](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-area-measurement-2d/).
+ * * Snapping is enabled by default. Holding the `CTRL` key disables it.
+ * * Layer types currently supported for snapping are:
+ * [FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),
+ * [GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) (except Mesh geometries),
+ * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),
+ * [WFSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WFSLayer.html),
+ * [CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),
+ * [3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html),
+ * and [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).
+ *
+ * **See also**
+ *
+ * - [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-AreaMeasurementAnalysis.html)
+ * - [Sample - Measurement in 3D](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)
+ * - [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-area-measurement-3d/)
  */
 export declare class ArcgisAreaMeasurement3d extends LitElement {
-    readonly analysis: __esri.AreaMeasurementAnalysis;
+    /**
+     * The [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-AreaMeasurementAnalysis.html)
+     * created or modified by the component.
+     *
+     * When connecting the Area Measurement 3D component to the [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)
+     * component, it automatically creates an empty analysis and adds it to the Scene's
+     * [analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#analyses) collection.
+     * Whenever the component is destroyed, the analysis is automatically removed from the collection.
+     *
+     * Alternatively, a programmatically created analysis can be provided to the component.
+     * Then, the application itself needs to add it to and later remove it from the Scene's analyses collection.
+     *
+     * ```js
+     * // Create the analysis.
+     * const areaMeasurementAnalysis = new AreaMeasurementAnalysis({
+     *    geometry: new Polygon({
+     *      spatialReference: { latestWkid: 3857, wkid: 102100 },
+     *      rings: [
+     *        [
+     *          [-13624861.22274897, 4550346.5519295, 63.378210234455764],
+     *          [-13624935.305160372, 4550273.144585712, 63.37829629518092],
+     *          [-13624995.61798748, 4550334.030096778, 63.37819860037416],
+     *          [-13624921.53589075, 4550407.42357004, 63.3783810287714],
+     *          [-13624861.22274897, 4550346.5519295, 63.378210234455764]
+     *        ]
+     *      ]
+     *    })
+     * });
+     * // Get the Scene and measurement component and wait until they are ready.
+     * const viewElement = document.querySelector("arcgis-scene");
+     * await viewElement.viewOnReady();
+     * const areaMeasurement3d = document.querySelector("arcgis-area-measurement-3d");
+     * await areaMeasurement3d.componentOnReady();
+     * // Add the analysis to the Scene component.
+     * viewElement.analyses.add(areaMeasurementAnalysis);
+     * // Connect the analysis to the measurement component:
+     * areaMeasurement3d.analysis = areaMeasurementAnalysis;
+     * ```
+     */
+    analysis: __esri.AreaMeasurementAnalysis;
     /**
      * 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-area-measurement-3d/#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.
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "measure-area"
      */
-    icon: string;
+    icon?: HTMLCalciteIconElement["icon"];
     /** The component's default label. */
-    label: string;
+    label?: string;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    /**
+     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * The component's state. The values mean the following:
+     *
+     * * `disabled` -  not ready yet
+     * * `ready` - ready for measuring
+     * * `measuring` - currently measuring
+     * * `measured` - measuring has finished
+     */
     readonly state: "ready" | "disabled" | "measuring" | "measured";
+    /**
+     * Unit system (imperial, metric) or specific unit used for displaying the area values. Possible values are listed in
+     * [unitOptions](#unitOptions).
+     */
     unit: __esri.SystemOrAreaUnit;
+    /**
+     * List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.
+     * By default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.
+     * Possible [unit](#unit) values can only be a subset of this list.
+     */
     unitOptions: __esri.SystemOrAreaUnit[];
+    /** Clears the current measurement. */
     clear(): Promise<void>;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /** Starts a new measurement. */
     start(): 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" | "analysis";
     }>;
-    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-area-measurement-3d/customElement.js

@@ -1,40 +1,173 @@
-import { c as t } from "../../chunks/runtime.js";
-import { usePropertyChange as e } from "@arcgis/lumina/controllers";
-import s from "@arcgis/core/widgets/AreaMeasurement3D.js";
-import { LitElement as i, createEvent as a, noShadowRoot as o } from "@arcgis/lumina";
-import { m as r } from "../../chunks/useWidget.js";
-import { css as n } from "@lit/reactive-element/css-tag.js";
+import { c as h } from "../../chunks/runtime.js";
+import { html as y } from "lit-html";
+import { LitElement as g, createEvent as f, noShadowRoot as w, nothing as v, safeClassMap as b } from "@arcgis/lumina";
+import { usePropertyChange as M } from "@arcgis/lumina/controllers";
+import { u as O } from "../../chunks/useT9n.js";
+import { m as $ } from "../../chunks/useViewModel.js";
+import { g as m } from "../../chunks/globalCss.js";
+import { css as A } from "@lit/reactive-element/css-tag.js";
+import U from "@arcgis/core/analysis/AreaMeasurementAnalysis.js";
+import { getDefaultUnitForView as V } from "@arcgis/core/applications/Components/getDefaultUnits.js";
+import { property as o, subclass as _ } from "@arcgis/core/core/accessorSupport/decorators.js";
+import { watch as D } from "@arcgis/core/core/reactiveUtils.js";
+import { A as C } from "../../chunks/AnalysisViewModel.js";
+import { g as p, a as d } from "../../chunks/measurementUtils.js";
+import { hasValidAreaResult as L } from "@arcgis/core/applications/Components/analysisUtils.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.99 */
-const l = n`@layer{arcgis-area-measurement-3d{display:block}}`, h = r(s);
-class d extends i {
+v4.33.0 */
+const P = A`@layer{arcgis-area-measurement-3d{display:block}.arcgis-area-measurement-3d{position:relative;padding:var(--esri-widget-padding);overflow-y:auto}}`;
+var S = Object.defineProperty, E = Object.getOwnPropertyDescriptor, n = (e, t, s, a) => {
+  for (var r = a > 1 ? void 0 : a ? E(t, s) : t, l = e.length - 1, u; l >= 0; l--)
+    (u = e[l]) && (r = (a ? u(t, s, r) : u(r)) || r);
+  return a && r && S(t, s, r), r;
+};
+let i = class extends C {
   constructor() {
-    super(...arguments), this.widget = h(this), this.viewModel = this.widget.viewModel, this.analysis = this.widget.analysis, this.autoDestroyDisabled = !1, this.icon = this.widget.icon, this.label = this.widget.label, this.position = "bottom-left", this.state = this.viewModel.state, this.unit = this.widget.unit, this.unitOptions = this.widget.unitOptions, this.arcgisPropertyChange = e()("analysis", "state"), this.arcgisReady = a();
+    super(...arguments), this.supportedViewType = "3d", this.unsupportedErrorMessage = "The Area Measurement 3D component is only supported in 3D views.";
+  }
+  initialize() {
+    this.addHandles(
+      // Make sure the analysis and view model units are in sync.
+      D(
+        () => ({
+          analysis: this.analysis,
+          unit: this.unit
+        }),
+        ({ analysis: e, unit: t }) => {
+          e != null && (e.unit = t);
+        },
+        { sync: !0, initial: !0 }
+      )
+    );
+  }
+  get state() {
+    return this.disabled || !this.ready ? "disabled" : this.operationState === "inactive" ? this.analysis.valid ? "measured" : "ready" : "measuring";
+  }
+  get displayState() {
+    if (!this.supported)
+      return "unsupported";
+    switch (this.state) {
+      case "disabled":
+      case "ready":
+        return "ready";
+      case "measuring":
+        return this.analysis.geometry == null ? "measuring" : "measured";
+      case "measured":
+        return "measured";
+    }
+  }
+  get measurement() {
+    const { analysisView: e } = this, t = e?.result, s = t?.mode ?? "euclidean", a = e != null && L(e);
+    return {
+      mode: s,
+      area: p(t?.area, a),
+      perimeter: p(t?.perimeter, a)
+    };
+  }
+  get unitOptions() {
+    const e = this._userUnitOptions?.filter((t) => d.includes(t));
+    return e && e.length > 0 ? e : d.slice();
+  }
+  set unitOptions(e) {
+    this._userUnitOptions = e;
+  }
+  get unit() {
+    const e = this._userUnit, t = this.unitOptions;
+    if (e && t.includes(e))
+      return e;
+    const s = this.defaultUnit;
+    return s && t.includes(s) ? s : t[0];
+  }
+  set unit(e) {
+    this._userUnit = e;
+  }
+  get defaultUnit() {
+    return this.view ? V(this.view) : void 0;
+  }
+  async place(e) {
+    await this.analysisView?.place(e);
+  }
+  clearAnalysis() {
+    this.analysis.geometry = null;
+  }
+  constructAnalysis() {
+    return new U();
+  }
+};
+n([
+  o({ readOnly: !0 })
+], i.prototype, "state", 1);
+n([
+  o({ readOnly: !0 })
+], i.prototype, "displayState", 1);
+n([
+  o({ readOnly: !0 })
+], i.prototype, "measurement", 1);
+n([
+  o()
+], i.prototype, "unitOptions", 1);
+n([
+  o()
+], i.prototype, "_userUnitOptions", 2);
+n([
+  o()
+], i.prototype, "unit", 1);
+n([
+  o()
+], i.prototype, "_userUnit", 2);
+n([
+  o({ readOnly: !0 })
+], i.prototype, "defaultUnit", 1);
+i = n([
+  _("components.area-measurement-3d.AreaMeasurement3dViewModel")
+], i);
+const R = "arcgis-area-measurement-3d", x = { base: R }, T = $(i);
+class j extends g {
+  constructor() {
+    super(...arguments), this.viewModel = T(this), this.messages = O({ blocking: !0 }), this.analysis = this.viewModel.analysis, this.autoDestroyDisabled = !1, this.icon = "measure-area", this.position = "bottom-left", this.state = this.viewModel.state, this.unit = this.viewModel.unit, this.unitOptions = this.viewModel.unitOptions, this.arcgisPropertyChange = M()("analysis", "state"), this.arcgisReady = f();
   }
   static {
-    this.properties = { analysis: 0, autoDestroyDisabled: 5, icon: 1, label: 1, position: 1, referenceElement: 1, state: 3, unit: 1, unitOptions: 0 };
+    this.properties = { analysis: 0, autoDestroyDisabled: 5, icon: 3, label: 1, position: 1, referenceElement: 1, state: 35, unit: 1, unitOptions: 0 };
   }
   static {
-    this.shadowRootOptions = o;
+    this.shadowRootOptions = w;
   }
   static {
-    this.styles = l;
+    this.styles = P;
   }
-  //#endregion
-  //#region Public Methods
   async clear() {
-    this.widget?.viewModel.clear();
+    this.viewModel.clear();
   }
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
   async start() {
-    this.widget?.viewModel.start();
+    this.viewModel.start();
+  }
+  render() {
+    const { messages: t, unit: s, unitOptions: a, viewModel: r } = this, { measurement: l, state: u } = r;
+    return y`<div aria-label=${t.componentLabel ?? v} class=${b({
+      [x.base]: !0,
+      [m.widget]: !0,
+      [m.panel]: !0
+    })} role=presentation><arcgis-measurement-content .state=${r.displayState} .hintLabel=${t.hint} .unsupportedLabel=${t.unsupported} .items=${[
+      {
+        title: t.area,
+        measurement: l.area
+      },
+      {
+        title: t.perimeterLength,
+        measurement: l.perimeter
+      }
+    ]}><arcgis-unit-select slot=settings .options=${a} .selectLabel=${t.unit} .value=${s} @arcgisUnitSelectChange=${(c) => {
+      this.unit = c.detail;
+    }}></arcgis-unit-select><calcite-button slot=actions .disabled=${u === "disabled"} @click=${() => {
+      this.viewModel.clear(), this.viewModel.start();
+    }}>${t.newMeasurement}</calcite-button></arcgis-measurement-content></div>`;
   }
 }
-t("arcgis-area-measurement-3d", d);
+h("arcgis-area-measurement-3d", j);
 export {
-  d as ArcgisAreaMeasurement3d
+  j as ArcgisAreaMeasurement3d
 };

package/dist/components/arcgis-area-measurement-3d/index.d.ts

@@ -1 +1,4 @@
+import "../arcgis-measurement-content/index.js";
+import "../arcgis-unit-select/index.js";
+import "@esri/calcite-components/components/calcite-button";
 export * from "./customElement.js";

package/dist/components/arcgis-area-measurement-3d/index.js

@@ -1 +1,4 @@
+import "../arcgis-measurement-content/index.js";
+import "../arcgis-unit-select/index.js";
+import "@esri/calcite-components/components/calcite-button";
 export * from "./customElement.js";

package/dist/components/arcgis-attachments/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 Attachments } from '@arcgis/core/widgets/Attachments.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useAttachmentsWidget: (component: LitElement & Pick<Attachments, never> & {
+declare const useAttachmentsWidget: (component: LitElement & Pick<Attachments, "icon" | "label" | "viewModel" | "graphic" | "capabilities" | "displayType"> & {
     state?: unknown;
     viewModel?: __esri.AttachmentsViewModel | 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,14 +21,14 @@ declare const useAttachmentsWidget: (component: LitElement & Pick<Attachments, 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.AttachmentsProperties | undefined): __esri.AttachmentsProperties | Promise<__esri.AttachmentsProperties | undefined> | undefined;
-} | undefined) => Attachments;
+}) => Attachments;
 /**
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-attachments/)
+ *
  * @internal
  */
 export declare class ArcgisAttachments extends LitElement {
@@ -36,38 +36,89 @@ export declare class ArcgisAttachments 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-attachments/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * Configures the attachment editing functionality that can be performed by the user.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Attachments.html#capabilities)
+     */
     capabilities: __esri.AttachmentsCapabilities;
+    /**
+     * A string value indicating how to display an attachment.
+     *
+     * @default "auto"
+     */
     displayType: "auto" | "list" | "preview";
+    /**
+     * The graphic for the attachments.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Attachments.html#graphic)
+     */
     graphic: nullish | __esri.Graphic;
+    /** @default false */
     hideAddButton: boolean | undefined;
+    /** @default false */
     hideAddSubmitButton: boolean | undefined;
+    /** @default false */
     hideCancelAddButton: boolean | undefined;
+    /** @default false */
     hideCancelUpdateButton: boolean | undefined;
+    /** @default false */
     hideDeleteButton: boolean | undefined;
+    /** @default false */
     hideErrorMessage: boolean | undefined;
+    /** @default false */
     hideProgressBar: boolean | undefined;
+    /** @default false */
     hideUpdateButton: 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.
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "attachment"
      */
     icon: string;
-    /** 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;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
-    readonly state: "ready" | "disabled" | "loading";
+    /**
+     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * The current state of the component.
+     *
+     * @default "ready"
+     */
+    readonly state: "ready" | "loading" | "disabled";
+    /**
+     * Indicates whether there is currently an attachment being added, updated or deleted.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Attachments.html#submitting)
+     *
+     * @default false
+     */
     readonly submitting: boolean;
-    /** 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" | "submitting";
     }>;
-    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-attachments/customElement.js

@@ -6,7 +6,7 @@ import { m as o } from "../../chunks/useWidget.js";
 import { css as h } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.99 */
+v4.33.0 */
 const n = h`@layer{arcgis-attachments{display:block}}`, r = o(i);
 class l extends s {
   constructor() {
@@ -21,9 +21,6 @@ class l extends s {
   static {
     this.styles = n;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }