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

package/dist/components/arcgis-shadow-cast/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 ShadowCast } from '@arcgis/core/widgets/ShadowCast.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useShadowCastWidget: (component: LitElement & Pick<ShadowCast, never> & {
+declare const useShadowCastWidget: (component: LitElement & Pick<ShadowCast, "icon" | "label" | "viewModel" | "headingLevel"> & {
     state?: unknown;
     viewModel?: __esri.ShadowCastViewModel | 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,57 +21,142 @@ declare const useShadowCastWidget: (component: LitElement & Pick<ShadowCast, nev
         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.ShadowCastProperties | undefined): __esri.ShadowCastProperties | Promise<__esri.ShadowCastProperties | undefined> | undefined;
-} | undefined) => ShadowCast;
-/** ShadowCast component displays the cumulative shadows of 3D features in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+}) => ShadowCast;
+/**
+ * The Shadow Cast component displays the cumulative shadows of 3D features in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/)
  */
 export declare class ArcgisShadowCast 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-shadow-cast/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
-    discreteOptions: __esri.ShadowCastViewModelDiscreteOptions;
-    durationOptions: __esri.ShadowCastViewModelDurationOptions;
+    get date(): Date;
+    set date(value: Date | number | string);
+    /**
+     * The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to "discrete".
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#discreteOptions)
+     */
+    discreteOptions: __esri.DiscreteOptions;
+    /**
+     * The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to "duration".
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#durationOptions)
+     */
+    durationOptions: __esri.DurationOptions;
+    /**
+     * Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#date)) when the shadow cast computation should stop.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#endTimeOfDay)
+     *
+     * @default 16 * 3600 * 1000
+     */
     endTimeOfDay: number;
+    /**
+     * Indicates the heading level to use for the titles "Time range" and "Visualization".
+     *
+     * @default 4
+     */
     headingLevel: number;
+    /** @default false */
     hideColorPicker: boolean;
+    /** @default false */
     hideDatePicker: boolean;
+    /** @default false */
     hideTimeRangeSlider: boolean;
+    /** @default false */
     hideTimezone: boolean;
+    /** @default false */
     hideTooltip: boolean;
+    /** @default false */
     hideVisualizationOptions: boolean;
+    /** @default false */
+    hideThresholdContext: boolean;
+    /** @default false */
+    hideThresholdContextColor: boolean;
+    /** @default false */
+    hideThresholdContextTimeInterval: boolean;
+    /** @default false */
+    hideThresholdContextToggle: 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-building-height-shadow"
      */
     icon: string;
-    /** The component's default label. */
+    /**
+     * The widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html#label)
+     */
     label: string;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#date))
+     * when the shadow cast computation should start.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#startTimeOfDay)
+     *
+     * @default 10 * 3600 * 1000
+     */
     startTimeOfDay: number;
+    /**
+     * The current state of the view model that can be used for rendering the UI
+     * of the widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#state)
+     *
+     * @default "disabled"
+     */
     readonly state: "ready" | "disabled";
-    thresholdOptions: __esri.ShadowCastViewModelThresholdOptions;
+    /**
+     * The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to "threshold".
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#thresholdOptions)
+     */
+    thresholdOptions: __esri.ThresholdOptions;
+    /**
+     * The difference in hours between UTC time and the times displayed in the widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#utcOffset)
+     */
     utcOffset: number;
+    /**
+     * Type of visualization to use when showing the shadows.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType)
+     *
+     * @default "threshold"
+     */
     visualizationType: "duration" | "threshold" | "discrete";
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     getDuration(point: __esri.Point): Promise<number>;
     start(): Promise<void>;
     stop(): 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";
     }>;
-    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>;
+    readonly _setterTypes: {
+        date?: Date | number | string;
+    };
 }
 export {};

package/dist/components/arcgis-shadow-cast/customElement.js

@@ -1,34 +1,37 @@
 import { c as t } from "../../chunks/runtime.js";
-import { usePropertyChange as e } from "@arcgis/lumina/controllers";
+import { usePropertyChange as i } from "@arcgis/lumina/controllers";
 import s from "@arcgis/core/widgets/ShadowCast.js";
-import { LitElement as o, createEvent as a, noShadowRoot as h } from "@arcgis/lumina";
-import { m as d } from "../../chunks/useWidget.js";
-import { css as r } from "@lit/reactive-element/css-tag.js";
+import { LitElement as o, createEvent as h, noShadowRoot as d } from "@arcgis/lumina";
+import { m as l } from "../../chunks/useWidget.js";
+import { css as a } 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 */
-const l = r`@layer{arcgis-shadow-cast{display:block}}`, n = d(s);
-class c extends o {
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
+const r = a`@layer{arcgis-shadow-cast{display:block}}`, n = l(s);
+class m extends o {
   constructor() {
-    super(...arguments), this.widget = n(this), this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.discreteOptions = this.viewModel.discreteOptions, this.durationOptions = this.viewModel.durationOptions, this.endTimeOfDay = this.viewModel.endTimeOfDay, this.headingLevel = this.widget.headingLevel, this.hideColorPicker = this.widget.visibleElements.colorPicker, this.hideDatePicker = this.widget.visibleElements.datePicker, this.hideTimeRangeSlider = this.widget.visibleElements.timeRangeSlider, this.hideTimezone = this.widget.visibleElements.timezone, this.hideTooltip = this.widget.visibleElements.tooltip, this.hideVisualizationOptions = this.widget.visibleElements.visualizationOptions, this.icon = this.widget.icon, this.label = this.widget.label, this.position = "bottom-left", this.startTimeOfDay = this.viewModel.startTimeOfDay, this.state = this.viewModel.state, this.thresholdOptions = this.viewModel.thresholdOptions, this.utcOffset = this.viewModel.utcOffset, this.visualizationType = this.viewModel.visualizationType, this.arcgisPropertyChange = e()("state"), this.arcgisReady = a();
+    super(...arguments), this.widget = n(this), this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.discreteOptions = this.viewModel.discreteOptions, this.durationOptions = this.viewModel.durationOptions, this.endTimeOfDay = this.viewModel.endTimeOfDay, this.headingLevel = this.widget.headingLevel, this.hideColorPicker = this.widget.visibleElements.colorPicker, this.hideDatePicker = this.widget.visibleElements.datePicker, this.hideTimeRangeSlider = this.widget.visibleElements.timeRangeSlider, this.hideTimezone = this.widget.visibleElements.timezone, this.hideTooltip = this.widget.visibleElements.tooltip, this.hideVisualizationOptions = this.widget.visibleElements.visualizationOptions, this.hideThresholdContext = this.widget.visibleElements.thresholdContext, this.hideThresholdContextColor = this.widget.visibleElements.thresholdContextColor, this.hideThresholdContextTimeInterval = this.widget.visibleElements.thresholdContextTimeInterval, this.hideThresholdContextToggle = this.widget.visibleElements.thresholdContextToggle, this.icon = this.widget.icon, this.label = this.widget.label, this.position = "bottom-left", this.startTimeOfDay = this.viewModel.startTimeOfDay, this.state = this.viewModel.state, this.thresholdOptions = this.viewModel.thresholdOptions, this.utcOffset = this.viewModel.utcOffset, this.visualizationType = this.viewModel.visualizationType, this.arcgisPropertyChange = i()("state"), this.arcgisReady = h();
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, discreteOptions: 0, durationOptions: 0, endTimeOfDay: 9, headingLevel: 9, hideColorPicker: 5, hideDatePicker: 5, hideTimeRangeSlider: 5, hideTimezone: 5, hideTooltip: 5, hideVisualizationOptions: 5, icon: 1, label: 1, position: 1, referenceElement: 1, startTimeOfDay: 9, state: 3, thresholdOptions: 0, utcOffset: 9, visualizationType: 1 };
+    this.properties = { autoDestroyDisabled: 5, date: 1, discreteOptions: 0, durationOptions: 0, endTimeOfDay: 9, headingLevel: 9, hideColorPicker: 5, hideDatePicker: 5, hideTimeRangeSlider: 5, hideTimezone: 5, hideTooltip: 5, hideVisualizationOptions: 5, hideThresholdContext: 5, hideThresholdContextColor: 5, hideThresholdContextTimeInterval: 5, hideThresholdContextToggle: 5, icon: 1, label: 1, position: 1, referenceElement: 1, startTimeOfDay: 9, state: 3, thresholdOptions: 0, utcOffset: 9, visualizationType: 1 };
   }
   static {
-    this.shadowRootOptions = h;
+    this.shadowRootOptions = d;
   }
   static {
-    this.styles = l;
+    this.styles = r;
+  }
+  get date() {
+    return this.viewModel.date;
+  }
+  set date(e) {
+    this.viewModel.date = e;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
-  async getDuration(i) {
-    return await this.widget?.viewModel.getDuration(i);
+  async getDuration(e) {
+    return await this.widget?.viewModel.getDuration(e);
   }
   async start() {
     this.widget?.viewModel.start();
@@ -37,7 +40,7 @@ class c extends o {
     this.widget?.viewModel.stop();
   }
 }
-t("arcgis-shadow-cast", c);
+t("arcgis-shadow-cast", m);
 export {
-  c as ArcgisShadowCast
+  m as ArcgisShadowCast
 };

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

@@ -1,18 +1,18 @@
 /// <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 GraphicsLayer } from '@arcgis/core/layers/GraphicsLayer.js';
 import { default as Sketch } from '@arcgis/core/widgets/Sketch.js';
 import { PublicLitElement as LitElement, ToElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useSketchWidget: (component: LitElement & Pick<Sketch, never> & {
+declare const useSketchWidget: (component: LitElement & Pick<Sketch, "icon" | "label" | "viewModel" | "scale" | "layout" | "layer" | "availableCreateTools" | "creationMode" | "defaultCreateOptions" | "defaultUpdateOptions" | "labelOptions" | "toolbarKind" | "snappingOptions" | "tooltipOptions"> & {
     state?: "ready" | "disabled" | "active" | undefined;
     viewModel?: __esri.SketchViewModel | 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<{
@@ -22,82 +22,205 @@ declare const useSketchWidget: (component: LitElement & Pick<Sketch, never> & {
         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.SketchProperties | undefined): __esri.SketchProperties | Promise<__esri.SketchProperties | undefined> | undefined;
-} | undefined) => Sketch;
-/** Sketch component provides a simple UI for creating and updating graphics on a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) or a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+}) => Sketch;
+/**
+ * The Sketch component provides a simple UI for creating and updating graphics on a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) or a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-sketch/)
  */
 export declare class ArcgisSketch extends LitElement {
+    /**
+     * When creating new graphics (for example after [create()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#create) has been called),
+     * this property reflects the create tool being used.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#activeTool)
+     */
     readonly activeTool: nullish | "rectangle" | "polygon" | "point" | "move" | "circle" | "reshape" | "multipoint" | "polyline" | "mesh" | "transform" | "freehandPolyline" | "freehandPolygon" | "rectangle-selection" | "lasso-selection" | "custom-selection";
     /**
      * 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-sketch/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * Property controlling the visibility and order of create tool buttons.
+     *
+     * @default ["point", "polyline", "polygon", "rectangle", "circle"]
+     */
     availableCreateTools: nullish | ("rectangle" | "polygon" | "point" | "circle" | "multipoint" | "polyline" | "mesh" | "freehandPolyline" | "freehandPolygon")[];
+    /**
+     * The graphic that is being created.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#createGraphic)
+     */
     readonly createGraphic: nullish | __esri.Graphic;
+    /**
+     * Defines the default behavior once the [create](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#create) operation is completed.
+     *
+     * @default "continuous"
+     */
     creationMode: "update" | "single" | "continuous";
+    /**
+     * Default create options set for the Sketch widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#defaultCreateOptions)
+     */
     defaultCreateOptions: __esri.SketchDefaultCreateOptions;
     /**
      * By default, sketch will auto-create a new graphics layer if none was
      * provided. Set this prop to true to disable this behavior.
+     *
+     * @default false
      */
     defaultGraphicsLayerDisabled: boolean;
+    /**
+     * Default update options set for the Sketch widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#defaultUpdateOptions)
+     */
     defaultUpdateOptions: __esri.SketchDefaultUpdateOptions;
+    /** @default false */
     hideCreateToolsCircle: boolean;
+    /** @default false */
     hideCreateToolsPoint: boolean;
+    /** @default false */
     hideCreateToolsPolygon: boolean;
+    /** @default false */
     hideCreateToolsPolyline: boolean;
+    /** @default false */
     hideCreateToolsRectangle: boolean;
+    /** @default false */
     hideDuplicateButton: boolean;
+    /** @default false */
     hideDeleteButton: boolean;
+    /** @default false */
     hideSelectionCountLabel: boolean;
+    /** @default false */
     hideLabelsToggle: boolean;
+    /** @default false */
     hideSelectionToolsLassoSelection: boolean;
+    /** @default false */
     hideSelectionToolsRectangleSelection: boolean;
+    /** @default false */
     hideSettingsMenu: boolean;
+    /** @default false */
     hideSnappingControls: boolean;
+    /** @default false */
     hideSnappingControlsElementsEnabledToggle: boolean;
+    /** @default false */
     hideSnappingControlsElementsFeatureEnabledToggle: boolean;
+    /** @default false */
     hideSnappingControlsElementsLayerList: boolean;
+    /** @default false */
     hideSnappingControlsElementsSelfEnabledToggle: boolean;
+    /** @default false */
     hideTooltipsToggle: boolean;
+    /** @default false */
     hideUndoRedoMenu: 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 "pencil"
      */
     icon: string;
-    /** The component's default label. */
+    /**
+     * The Sketch widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#label)
+     */
     label: string;
+    /**
+     * Options to configure the sketch labels shown next to each segment of the geometry being created or updated.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#labelOptions)
+     */
     labelOptions: __esri.SketchLabelOptions;
+    /**
+     * The [GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) associated with the Sketch widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#layer)
+     */
     layer: GraphicsLayer;
+    /**
+     * Determines the layout/orientation of the Sketch widget.
+     *
+     * @default "horizontal"
+     */
     layout: "vertical" | "horizontal";
+    /**
+     * A [SimpleMarkerSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleMarkerSymbol.html), [PointSymbol3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-PointSymbol3D.html), [TextSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-TextSymbol.html), [CIMSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-CIMSymbol.html), or [WebStyleSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-WebStyleSymbol.html) used for representing the point geometry that is being drawn.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#pointSymbol)
+     */
     pointSymbol: __esri.SimpleMarkerSymbol | __esri.PictureMarkerSymbol | __esri.PointSymbol3D | __esri.TextSymbol | __esri.CIMSymbol | __esri.WebStyleSymbol;
+    /**
+     * A [SimpleFillSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleFillSymbol.html), [PolygonSymbol3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-PolygonSymbol3D.html), or [CIMSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-CIMSymbol.html) used for representing the polygon geometry that is being drawn.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#polygonSymbol)
+     */
     polygonSymbol: __esri.CIMSymbol | __esri.SimpleFillSymbol | __esri.PolygonSymbol3D;
+    /**
+     * A [SimpleLineSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleLineSymbol.html), [LineSymbol3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-LineSymbol3D.html), or [CIMSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-CIMSymbol.html) used for representing the polyline geometry that is being drawn.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#polylineSymbol)
+     */
     polylineSymbol: __esri.SimpleLineSymbol | __esri.CIMSymbol | __esri.LineSymbol3D;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * Determines the size of widget elements.
+     *
+     * @default "m"
+     */
     scale: "s" | "m" | "l";
+    /**
+     * Controls the appearance of the sketch widget, allowing
+     * the toolbar to adapt its appearance appropriately based on context.
+     *
+     * @default "floating"
+     */
     toolbarKind: "floating" | "docked";
+    /** @default false */
     showSnappingControlsElementsHeader: boolean;
+    /**
+     * The [SnappingOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html) for sketching.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#snappingOptions)
+     */
     snappingOptions: __esri.SnappingOptions;
+    /**
+     * The Sketch widget's state.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#state)
+     */
     readonly state: "ready" | "disabled" | "active";
+    /**
+     * Options to configure the tooltip shown next to the cursor when creating or updating graphics.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#tooltipOptions)
+     */
     tooltipOptions: __esri.SketchTooltipOptions;
+    /**
+     * An array of [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) that are being updated by the Sketch widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#updateGraphics)
+     */
     readonly updateGraphics: __esri.Collection<__esri.Graphic>;
     cancel(): Promise<void>;
     complete(): Promise<void>;
     create(tool: "circle" | "point" | "polygon" | "polyline" | "rectangle", createOptions?: __esri.SketchViewModelCreateCreateOptions): Promise<void>;
     delete(): Promise<void>;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     duplicate(): Promise<void>;
     redo(): Promise<void>;
@@ -105,10 +228,12 @@ export declare class ArcgisSketch extends LitElement {
     undo(): Promise<void>;
     readonly arcgisCreate: TargetedEvent<this, __esri.SketchCreateEvent>;
     readonly arcgisDelete: TargetedEvent<this, __esri.SketchDeleteEvent>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    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>;
     readonly arcgisRedo: TargetedEvent<this, __esri.SketchRedoEvent>;
     readonly arcgisUndo: TargetedEvent<this, __esri.SketchUndoEvent>;
     readonly arcgisUpdate: TargetedEvent<this, __esri.SketchUpdateEvent>;

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

@@ -1,45 +1,40 @@
 import { c as s } from "../../chunks/runtime.js";
 import { usePropertyChange as o } from "@arcgis/lumina/controllers";
-import { reEmitEvent as t } from "@arcgis/lumina/controllers/accessor";
+import { reEmitEvent as e } from "@arcgis/lumina/controllers/accessor";
 import l from "@arcgis/core/layers/GraphicsLayer.js";
 import n from "@arcgis/core/widgets/Sketch.js";
-import { LitElement as a, createEvent as d, noShadowRoot as h } from "@arcgis/lumina";
+import { LitElement as a, createEvent as h, noShadowRoot as d } from "@arcgis/lumina";
 import { m as r } 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.99 */
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
 const p = g`@layer{arcgis-sketch{display:block}}`, c = r(n);
 class m extends a {
-  //#endregion
-  //#region Lifecycle
   constructor() {
-    super(), this.widget = c(this, { editConstructorProperties: this._editConstructorProperties }), this.viewModel = this.widget.viewModel, this.activeTool = this.widget.activeTool, this.autoDestroyDisabled = !1, this.availableCreateTools = this.widget.availableCreateTools, this.createGraphic = this.widget.createGraphic, this.creationMode = this.widget.creationMode, this.defaultCreateOptions = this.widget.defaultCreateOptions, this.defaultGraphicsLayerDisabled = !1, this.defaultUpdateOptions = this.widget.defaultUpdateOptions, this.hideCreateToolsCircle = this.widget.visibleElements.createTools.circle, this.hideCreateToolsPoint = this.widget.visibleElements.createTools.point, this.hideCreateToolsPolygon = this.widget.visibleElements.createTools.polygon, this.hideCreateToolsPolyline = this.widget.visibleElements.createTools.polyline, this.hideCreateToolsRectangle = this.widget.visibleElements.createTools.rectangle, this.hideDuplicateButton = this.widget.visibleElements.duplicateButton, this.hideDeleteButton = this.widget.visibleElements.deleteButton, this.hideSelectionCountLabel = this.widget.visibleElements.selectionCountLabel, this.hideLabelsToggle = this.widget.visibleElements.labelsToggle, this.hideSelectionToolsLassoSelection = this.widget.visibleElements.selectionTools["lasso-selection"], this.hideSelectionToolsRectangleSelection = this.widget.visibleElements.selectionTools["rectangle-selection"], this.hideSettingsMenu = this.widget.visibleElements.settingsMenu, this.hideSnappingControls = this.widget.visibleElements.snappingControls, this.hideSnappingControlsElementsEnabledToggle = this.widget.visibleElements.snappingControlsElements.enabledToggle, this.hideSnappingControlsElementsFeatureEnabledToggle = this.widget.visibleElements.snappingControlsElements.featureEnabledToggle, this.hideSnappingControlsElementsLayerList = this.widget.visibleElements.snappingControlsElements.layerList, this.hideSnappingControlsElementsSelfEnabledToggle = this.widget.visibleElements.snappingControlsElements.selfEnabledToggle, this.hideTooltipsToggle = this.widget.visibleElements.tooltipsToggle, this.hideUndoRedoMenu = this.widget.visibleElements.undoRedoMenu, this.icon = this.widget.icon, this.label = this.widget.label, this.labelOptions = this.widget.labelOptions, this.layer = this.widget.layer, this.layout = this.widget.layout, this.pointSymbol = this.viewModel.pointSymbol, this.polygonSymbol = this.viewModel.polygonSymbol, this.polylineSymbol = this.viewModel.polylineSymbol, this.position = "bottom-left", this.scale = this.widget.scale, this.toolbarKind = this.widget.toolbarKind, this.showSnappingControlsElementsHeader = this.widget.visibleElements.snappingControlsElements.header, this.snappingOptions = this.widget.snappingOptions, this.state = this.widget.state, this.tooltipOptions = this.widget.tooltipOptions, this.updateGraphics = this.widget.updateGraphics, this.arcgisCreate = t(() => this.widget, "create"), this.arcgisDelete = t(() => this.widget, "delete"), this.arcgisPropertyChange = o()("state"), this.arcgisReady = d(), this.arcgisRedo = t(() => this.widget, "redo"), this.arcgisUndo = t(() => this.widget, "undo"), this.arcgisUpdate = t(() => this.widget, "update"), this.listen("arcgisReady", this._arcgisReadyHandler);
+    super(), this.widget = c(this), this.viewModel = this.widget.viewModel, this.activeTool = this.widget.activeTool, this.autoDestroyDisabled = !1, this.availableCreateTools = this.widget.availableCreateTools, this.createGraphic = this.widget.createGraphic, this.creationMode = this.widget.creationMode, this.defaultCreateOptions = this.widget.defaultCreateOptions, this.defaultGraphicsLayerDisabled = !1, this.defaultUpdateOptions = this.widget.defaultUpdateOptions, this.hideCreateToolsCircle = this.widget.visibleElements.createTools.circle, this.hideCreateToolsPoint = this.widget.visibleElements.createTools.point, this.hideCreateToolsPolygon = this.widget.visibleElements.createTools.polygon, this.hideCreateToolsPolyline = this.widget.visibleElements.createTools.polyline, this.hideCreateToolsRectangle = this.widget.visibleElements.createTools.rectangle, this.hideDuplicateButton = this.widget.visibleElements.duplicateButton, this.hideDeleteButton = this.widget.visibleElements.deleteButton, this.hideSelectionCountLabel = this.widget.visibleElements.selectionCountLabel, this.hideLabelsToggle = this.widget.visibleElements.labelsToggle, this.hideSelectionToolsLassoSelection = this.widget.visibleElements.selectionTools["lasso-selection"], this.hideSelectionToolsRectangleSelection = this.widget.visibleElements.selectionTools["rectangle-selection"], this.hideSettingsMenu = this.widget.visibleElements.settingsMenu, this.hideSnappingControls = this.widget.visibleElements.snappingControls, this.hideSnappingControlsElementsEnabledToggle = this.widget.visibleElements.snappingControlsElements.enabledToggle, this.hideSnappingControlsElementsFeatureEnabledToggle = this.widget.visibleElements.snappingControlsElements.featureEnabledToggle, this.hideSnappingControlsElementsLayerList = this.widget.visibleElements.snappingControlsElements.layerList, this.hideSnappingControlsElementsSelfEnabledToggle = this.widget.visibleElements.snappingControlsElements.selfEnabledToggle, this.hideTooltipsToggle = this.widget.visibleElements.tooltipsToggle, this.hideUndoRedoMenu = this.widget.visibleElements.undoRedoMenu, this.icon = this.widget.icon, this.label = this.widget.label, this.labelOptions = this.widget.labelOptions, this.layer = this.widget.layer, this.layout = this.widget.layout, this.pointSymbol = this.viewModel.pointSymbol, this.polygonSymbol = this.viewModel.polygonSymbol, this.polylineSymbol = this.viewModel.polylineSymbol, this.position = "bottom-left", this.scale = this.widget.scale, this.toolbarKind = this.widget.toolbarKind, this.showSnappingControlsElementsHeader = this.widget.visibleElements.snappingControlsElements.header, this.snappingOptions = this.widget.snappingOptions, this.state = this.widget.state, this.tooltipOptions = this.widget.tooltipOptions, this.updateGraphics = this.widget.updateGraphics, this.arcgisCreate = e(() => this.widget, "create"), this.arcgisDelete = e(() => this.widget, "delete"), this.arcgisPropertyChange = o()("state"), this.arcgisReady = h(), this.arcgisRedo = e(() => this.widget, "redo"), this.arcgisUndo = e(() => this.widget, "undo"), this.arcgisUpdate = e(() => this.widget, "update"), this.widget.layer = new l({ title: "Sketch Layer" }), this.listen("arcgisReady", this._arcgisReadyHandler);
   }
   static {
     this.properties = { activeTool: 3, autoDestroyDisabled: 5, availableCreateTools: 0, createGraphic: 0, creationMode: 1, defaultCreateOptions: 0, defaultGraphicsLayerDisabled: 5, defaultUpdateOptions: 0, hideCreateToolsCircle: 5, hideCreateToolsPoint: 5, hideCreateToolsPolygon: 5, hideCreateToolsPolyline: 5, hideCreateToolsRectangle: 5, hideDuplicateButton: 5, hideDeleteButton: 5, hideSelectionCountLabel: 5, hideLabelsToggle: 5, hideSelectionToolsLassoSelection: 5, hideSelectionToolsRectangleSelection: 5, hideSettingsMenu: 5, hideSnappingControls: 5, hideSnappingControlsElementsEnabledToggle: 5, hideSnappingControlsElementsFeatureEnabledToggle: 5, hideSnappingControlsElementsLayerList: 5, hideSnappingControlsElementsSelfEnabledToggle: 5, hideTooltipsToggle: 5, hideUndoRedoMenu: 5, icon: 1, label: 1, labelOptions: 0, layer: 0, layout: 1, pointSymbol: 0, polygonSymbol: 0, polylineSymbol: 0, position: 1, referenceElement: 1, scale: 1, toolbarKind: 1, showSnappingControlsElementsHeader: 5, snappingOptions: 0, state: 3, tooltipOptions: 0, updateGraphics: 0 };
   }
   static {
-    this.shadowRootOptions = h;
+    this.shadowRootOptions = d;
   }
   static {
     this.styles = p;
   }
-  //#endregion
-  //#region Public Methods
   async cancel() {
     this.widget?.cancel();
   }
   async complete() {
     this.widget?.complete();
   }
-  async create(e, i) {
-    await this.widget?.create(e, i);
+  async create(t, i) {
+    await this.widget?.create(t, i);
   }
   async delete() {
     this.widget?.delete();
   }
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
@@ -49,19 +44,14 @@ class m extends a {
   async redo() {
     this.widget?.redo();
   }
-  async triggerUpdate(e, i) {
-    this.widget?.update(e, i);
+  async triggerUpdate(t, i) {
+    this.widget?.update(t, i);
   }
   async undo() {
     this.widget?.undo();
   }
-  //#endregion
-  //#region Private Methods
   _arcgisReadyHandler() {
-    this.defaultGraphicsLayerDisabled || this.el.view?.map.add(this.widget.layer);
-  }
-  async _editConstructorProperties(e) {
-    return this.defaultGraphicsLayerDisabled || (e.layer ??= new l({ title: "Sketch Layer" })), e;
+    this.defaultGraphicsLayerDisabled || this.el.view?.map?.add(this.widget.layer);
   }
 }
 s("arcgis-sketch", m);