@arcgis/map-components 5.0.0-next.9 → 5.0.0-next.90

package/dist/components/arcgis-shadow-cast-min-duration-config/index.js

@@ -0,0 +1,6 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-slider";
+import "../arcgis-color-select/index.js";
+import "@esri/calcite-components/components/calcite-switch";
+import "../arcgis-shadow-cast-discrete-config/index.js";
+export * from "./customElement.js";

package/dist/components/arcgis-shadow-cast-total-duration-config/customElement.d.ts

@@ -0,0 +1,20 @@
+/// <reference path="../../index.d.ts" />
+import { default as TotalDurationOptions } from '@arcgis/core/analysis/ShadowCast/TotalDurationOptions.js';
+import { PublicLitElement as LitElement, JsxNode, TargetedEvent } from '@arcgis/lumina';
+import { ShadowCastMessages } from '../arcgis-shadow-cast/interfaces';
+
+/**
+ * Component which renders the configuration options for the "duration" mode of the Shadow Cast analysis.
+ *
+ * @private
+ */
+export declare class ArcgisShadowCastTotalDurationConfig extends LitElement {
+    options: TotalDurationOptions;
+    /** @default "s" */
+    scale: "l" | "m" | "s";
+    /** @default false */
+    hideColorPicker?: boolean | undefined;
+    /** @default false */
+    hideModeSelect?: boolean | undefined;
+    messages?: ShadowCastMessages;
+}

package/dist/components/arcgis-shadow-cast-total-duration-config/customElement.js

@@ -0,0 +1,34 @@
+import { c as a } from "../../chunks/runtime.js";
+import { css as r, html as o } from "lit";
+import { LitElement as n } from "@arcgis/lumina";
+import { V as s } from "../../chunks/visible-element.js";
+/*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
+See https://js.arcgis.com/5.0/esri/copyright.txt for details.
+v5.0.0-next.90 */
+const d = r`:host{--calcite-label-margin-bottom: 0;gap:var(--calcite-spacing-md);flex-direction:column;display:flex}calcite-label{display:block}`;
+class m extends n {
+  constructor() {
+    super(...arguments), this.scale = "s", this.hideColorPicker = !1, this.hideModeSelect = !1;
+  }
+  static {
+    this.properties = { options: 0, scale: 1, hideColorPicker: 5, hideModeSelect: 5, messages: 0 };
+  }
+  static {
+    this.styles = d;
+  }
+  render() {
+    return o`${s({ hidden: this.hideModeSelect, children: this._renderModeSelect() })}${s({ hidden: this.hideColorPicker, children: o`<arcgis-color-select .color=${this.options.color} .label=${this.messages?.totalDuration?.colorLabel} @arcgisColorChanged=${(e) => {
+      this.options.color = e.detail;
+    }}></arcgis-color-select>` })}`;
+  }
+  _renderModeSelect() {
+    const { options: e, scale: l } = this, { mode: c } = e, t = this.messages?.totalDuration;
+    return o`<calcite-label .scale=${l}>${t?.modeLabel}<calcite-segmented-control .scale=${l} width=full @calciteSegmentedControlChange=${(i) => {
+      e.mode = i.currentTarget.value;
+    }}><calcite-segmented-control-item value=hourly .checked=${c === "hourly"}>${t?.hourlyLabel}</calcite-segmented-control-item><calcite-segmented-control-item value=continuous .checked=${c === "continuous"}>${t?.continuousLabel}</calcite-segmented-control-item></calcite-segmented-control></calcite-label>`;
+  }
+}
+a("arcgis-shadow-cast-total-duration-config", m);
+export {
+  m as ArcgisShadowCastTotalDurationConfig
+};

package/dist/components/arcgis-shadow-cast-total-duration-config/index.d.ts

@@ -0,0 +1,5 @@
+import "../arcgis-color-select/index.js";
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-segmented-control";
+import "@esri/calcite-components/components/calcite-segmented-control-item";
+export * from "./customElement.js";

package/dist/components/arcgis-shadow-cast-total-duration-config/index.js

@@ -0,0 +1,5 @@
+import "../arcgis-color-select/index.js";
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-segmented-control";
+import "@esri/calcite-components/components/calcite-segmented-control-item";
+export * from "./customElement.js";

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

@@ -5,10 +5,11 @@ import { default as GraphicsLayer } from '@arcgis/core/layers/GraphicsLayer.js';
 import { default as Sketch } from '@arcgis/core/widgets/Sketch.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
+import { IconName } from '../../utils/action-utils';
 
-declare const useSketchWidget: (component: LitElement & Pick<Sketch, "label" | "viewModel" | "icon" | "snappingOptions" | "scale" | "layer" | "layout" | "defaultCreateOptions" | "labelOptions" | "tooltipOptions" | "availableCreateTools" | "creationMode" | "defaultUpdateOptions" | "toolbarKind"> & {
-    state?: "ready" | "disabled" | "active" | undefined;
-    viewModel?: __esri.SketchViewModel | undefined;
+declare const useSketchWidget: (component: LitElement & Pick<Sketch, "label" | "viewModel" | "icon" | "scale" | "layer" | "layout" | "defaultCreateOptions" | "labelOptions" | "snappingOptions" | "tooltipOptions" | "availableCreateTools" | "creationMode" | "defaultUpdateOptions" | "pointSymbol" | "polygonSymbol" | "polylineSymbol" | "toolbarKind" | "textSymbol"> & {
+    state?: import('@arcgis/core/widgets/Sketch/types').State | undefined;
+    viewModel?: import('@arcgis/core/widgets/Sketch/SketchViewModel').default | undefined;
     closed?: boolean;
     icon: import('@arcgis/toolkit/type').nil | string;
     label: import('@arcgis/toolkit/type').nil | string;
@@ -37,16 +38,29 @@ declare const useSketchWidget: (component: LitElement & Pick<Sketch, "label" | "
 export declare class ArcgisSketch extends LitElement {
     /**
      * The view associated with the component.
-     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the ArcgisSketch component will be associated with a map or scene component rather than using the `view` property.
+     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the Sketch component will be associated with a map or scene component rather than using the `view` property.
      */
-    view?: __esri.MapView | __esri.SceneView | nullish;
+    view?: import('@arcgis/core/views/MapViewOrSceneView').MapViewOrSceneView | null | undefined;
     /**
      * 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.
+     * this property reflects the create tool being used. When updating graphics
+     * (for example after [update()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#update) has been called), this property reflects the
+     * update tool being used. If no create or update operation is in progress, this is `null`.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#activeTool)
+     * Prior to 4.32, creation tools were modeled as a combination of a geometry type (point, line, polygon)
+     * and an interaction mode (click, freehand, hybrid).
+     * At 4.32, the available create tools were expanded to include "freehandPolyline" and "freehandPolygon".
+     * These tools are made available to enable interoperability with other components of the ArcGIS system,
+     * where freehand polyline is a distinct create tool from polyline.
+     *
+     * To minimize compatibility issues, if "freehandPolyline" and "freehandPolygon" are not in the list
+     * of available create tools, they will not be returned by this property, even if the user is drawing a
+     * polygon in freehand mode.
+     *
+     * To opt in to freehandPolyline and freehandPolygon tools, include them when setting availableCreateTools,
+     * and visibleElements.createTools.
      */
-    readonly activeTool: nullish | "circle" | "move" | "point" | "polygon" | "rectangle" | "text" | "reshape" | "multipoint" | "polyline" | "mesh" | "transform" | "freehandPolyline" | "freehandPolygon" | "rectangle-selection" | "lasso-selection" | "custom-selection";
+    readonly activeTool: import('@arcgis/core/widgets/Sketch/types').SketchTool | import('@arcgis/core/widgets/Sketch/types').SelectionTool | null;
     /**
      * 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
@@ -59,28 +73,36 @@ export declare class ArcgisSketch extends LitElement {
     autoDestroyDisabled: boolean;
     /**
      * Property controlling the visibility and order of create tool buttons.
+     * Create tool buttons will only be rendered if they are in this collections and the
+     * matching hide/show property or attribute is configured to show the tool.
      *
-     * @default ["point", "polyline", "polygon", "rectangle", "circle"]
+     * @default ["point", "polyline", "freehandPolyline", "polygon", "freehandPolygon", "rectangle", "circle"]
      */
-    availableCreateTools: nullish | ("circle" | "point" | "polygon" | "rectangle" | "text" | "multipoint" | "polyline" | "mesh" | "freehandPolyline" | "freehandPolygon")[];
+    availableCreateTools: import('@arcgis/core/widgets/Sketch/types').CreateTool[] | null | undefined;
+    /** The graphic that is being created. */
+    readonly createGraphic: import('@arcgis/core/Graphic').default | null | undefined;
     /**
-     * The graphic that is being created.
+     * Defines the default behavior once the [create()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#create) operation is completed. By default, the user will be
+     * able to continuously create graphics with same geometry types.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#createGraphic)
-     */
-    readonly createGraphic: __esri.Graphic | nullish;
-    /**
-     * Defines the default behavior once the [create](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#create) operation is completed.
+     * **Possible Values**
+     *
+     * Value | Description |
+     * ----- | ----------- |
+     * continuous | This is the default. Users can continue creating graphics with same geometry types.
+     * single | User can create a single graphic with the specified geometry type. User must choose an operation once the graphic is created.
+     * update | The graphic will be selected for an [update()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#update) operation once the `create` operation is completed.
      *
      * @default "continuous"
+     * @since 4.14
      */
-    creationMode: "update" | "single" | "continuous";
+    creationMode: import('@arcgis/core/widgets/Sketch/types').CreationMode;
     /**
      * Default create options set for the Sketch widget.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#defaultCreateOptions)
+     * @since 4.14
      */
-    defaultCreateOptions: __esri.SketchDefaultCreateOptions;
+    defaultCreateOptions: import('@arcgis/core/widgets/Sketch/types').CreateOptions;
     /**
      * By default, sketch will auto-create a new graphics layer if none was
      * provided. Set this prop to true to disable this behavior.
@@ -89,100 +111,254 @@ export declare class ArcgisSketch extends LitElement {
      */
     defaultGraphicsLayerDisabled: boolean;
     /**
-     * Default update options set for the Sketch widget.
+     * Default update options set for the Sketch widget. Update options set on this property will be overwritten if the update options are changed
+     * when [update()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#update) method is called.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#defaultUpdateOptions)
+     * @since 4.11
+     * @example
+     * // Turn off highlights for update operations
+     * const sketch = new Sketch({
+     *  view,
+     *  defaultUpdateOptions: {
+     *    highlightOptions: {
+     *      enabled: false
+     *    }
+     *  }
+     * });
+     * // Turn off highlights from the update() method
+     * const updateOptions = { tool: "reshape", highlightOptions: { enabled: false }};
+     * sketch.update(graphic, updateOptions);
+     */
+    defaultUpdateOptions: import('@arcgis/core/widgets/Sketch/types').UpdateOptions;
+    /**
+     * Indicates whether to display the circle sketch tool. Default is `true`.
+     *
+     * @default true
      */
-    defaultUpdateOptions: __esri.SketchDefaultUpdateOptions;
-    /** @default false */
     hideCreateToolsCircle: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the multipoint tool. Regardless of setting, multipoint is not available when working with a scene view.
+     *
+     * The multipoint tool is excluded from `availableCreateTools` by default. Even if this property is false,
+     * multipoint will not be available until it is added to `availableCreateTools`.
+     *
+     * @default true
+     */
+    hideCreateToolsMultipoint: boolean;
+    /**
+     * Indicates whether to display the point sketch tool. Default is `true`.
+     *
+     * @default true
+     */
     hideCreateToolsPoint: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the polygon sketch tool. Default is `true`.
+     *
+     * @default true
+     */
     hideCreateToolsPolygon: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the polyline sketch tool. Default is `true`.
+     *
+     * @default true
+     */
     hideCreateToolsPolyline: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the rectangle sketch tool. Default is `true`.
+     *
+     * @default true
+     */
     hideCreateToolsRectangle: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the 'duplicate' button while a graphic is selected. Default is `true`.
+     *
+     * @default true
+     */
     hideDuplicateButton: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the 'delete' button while a graphic is selected. Default is `true`. Do not hide this button without giving users on touch devices another way to delete selected geometries.
+     *
+     * @default true
+     */
     hideDeleteButton: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display a label indicating the length of the currently selected feature set.
+     *
+     * @default true
+     */
     hideSelectionCountLabel: boolean;
-    /** @default false */
+    /**
+     * _Since 4.29_. Indicates whether to display the sketch labels toggle. Default value is `true`.
+     *
+     * @default true
+     */
     hideLabelsToggle: boolean;
     /** @default false */
     hideSelectionToolsLassoSelection: boolean;
     /** @default false */
     hideSelectionToolsRectangleSelection: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the settings menu. Currently this menu contains snapping options. Default value is `true`.
+     *
+     * @default true
+     */
     hideSettingsMenu: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the `SnappingControls` widget. Default is `true`.
+     *
+     * @default true
+     */
     hideSnappingControls: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the `enabledToggle` (Enable snapping). Default is `true`. This toggles
+     * the [SnappingOptions#enabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html#enabled) property.
+     * > [!WARNING]
+     * >
+     * > **Note**
+     * >
+     * > It is recommended to set `SnappingControls.snappingOptions.enabled = true` if `enabledToggle` is set to `false`.
+     * > This is because `selfEnabledToggle` and `featureEnabledToggle` require snapping globally to be enabled in order to be interactive. Otherwise, these toggles will not be responsive.
+     *
+     * @default true
+     */
     hideSnappingControlsElementsEnabledToggle: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the `featureEnabledToggle` (Feature to feature). Default is `true`. This toggles
+     * the [SnappingOptions#featureEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html#featureEnabled) property.
+     *
+     * @default true
+     */
     hideSnappingControlsElementsFeatureEnabledToggle: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the [FeatureSnappingLayerSource](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-FeatureSnappingLayerSource.html) layerList. Default is `true`. The layerlist provides the available layer sources supported for snapping.
+     *
+     * @default true
+     */
     hideSnappingControlsElementsLayerList: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the `selfEnabledToggle` (Geometry guides). Default is `true`. This toggles
+     * the [SnappingOptions#selfEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html#selfEnabled) property.
+     *
+     * @default true
+     */
     hideSnappingControlsElementsSelfEnabledToggle: boolean;
-    /** @default false */
+    /**
+     * _Since 4.29_. Indicates whether to display the tooltips toggle. Default value is `true`.
+     *
+     * @default true
+     */
     hideTooltipsToggle: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the undo/redo menu within the widget. Default is `true`.
+     *
+     * @default true
+     */
     hideUndoRedoMenu: boolean;
     /**
      * Icon which represents the component.
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      * @default "pencil"
+     * @since 4.27
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      */
-    icon: string;
+    get icon(): typeof this.widget.icon;
+    set icon(value: IconName);
     /**
      * The Sketch widget's default label.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#label)
+     * @since 4.11
      */
     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)
+     * > [!WARNING]
+     * >
+     * > **Known Limitation**
+     * >
+     * > Sketch labels are currently only supported when working with a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+     *
+     * @since 4.24
      */
-    labelOptions: __esri.SketchLabelOptions;
+    labelOptions: import('@arcgis/core/views/interactive/sketch/SketchLabelOptions').default;
     /**
-     * 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)
+     * The [GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) associated with the Sketch widget. The Sketch widget adds new [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) to this layer or can only update graphics
+     * stored in this layer.
      */
-    layer: nullish | GraphicsLayer | __esri.MapNotesLayer;
+    layer: GraphicsLayer | import('@arcgis/core/layers/MapNotesLayer').default | null | undefined;
     /**
      * Determines the layout/orientation of the Sketch widget.
      *
      * @default "horizontal"
+     * @since 4.10
      */
-    layout: "horizontal" | "vertical";
+    layout: import('@arcgis/core/widgets/Sketch/types').Layout;
     /**
-     * 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.
+     * A [SimpleMarkerSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleMarkerSymbol.html), [PictureMarkerSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-PictureMarkerSymbol.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. [SimpleMarkerSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleMarkerSymbol.html) may also be used to symbolize point features in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html). However, it is recommended you use [PointSymbol3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-PointSymbol3D.html) instead.
+     *
+     * > [!WARNING]
+     * >
+     * > **Known Limitation**
+     * > To avoid unintended side effects, instantiate a new symbol rather than modifying the current instance.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#pointSymbol)
+     * The default value is the following:
+     * ```js
+     * {
+     *   type: "simple-marker",
+     *   style: "circle",
+     *   size: 6,
+     *   color: [255, 255, 255],
+     *   outline: {
+     *    color: [50, 50, 50],
+     *     width: 1
+     *   }
+     * }
+     * ```
      */
-    pointSymbol: __esri.PictureMarkerSymbol | __esri.SimpleMarkerSymbol | __esri.TextSymbol | __esri.CIMSymbol | __esri.PointSymbol3D | __esri.WebStyleSymbol;
+    pointSymbol: import('@arcgis/core/widgets/Sketch/types').SketchPointSymbol;
     /**
-     * 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.
+     * 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. [SimpleFillSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleFillSymbol.html) may also be used to symbolize polygon features in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html). However, it is recommended you use [PolygonSymbol3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-PolygonSymbol3D.html) instead.
+     *
+     * > [!WARNING]
+     * >
+     * > **Known Limitation**
+     * > To avoid unintended side effects, instantiate a new symbol rather than modifying the current instance.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#polygonSymbol)
+     * The default value is the following:
+     * ```js
+     * {
+     *   type: "simple-fill",
+     *   color: [150, 150, 150, 0.2],
+     *   outline: {
+     *     color: [50, 50, 50],
+     *     width: 2
+     *   }
+     * }
+     * ```
      */
-    polygonSymbol: __esri.SimpleFillSymbol | __esri.CIMSymbol | __esri.PolygonSymbol3D;
+    polygonSymbol: import('@arcgis/core/widgets/Sketch/types').SketchPolygonSymbol;
     /**
-     * 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.
+     * 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. [SimpleLineSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleLineSymbol.html) may also be used to symbolize polyline features in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html). However, it is recommended you use [LineSymbol3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-LineSymbol3D.html) instead.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#polylineSymbol)
+     * > [!WARNING]
+     * >
+     * > **Known Limitation**
+     * > To avoid unintended side effects, instantiate a new symbol rather than modifying the current instance.
+     *
+     * The default value is the following:
+     * ```js
+     * {
+     *   type: "simple-line",
+     *   color: [130, 130, 130],
+     *   width: 2
+     * }
+     * ```
      */
-    polylineSymbol: __esri.SimpleLineSymbol | __esri.CIMSymbol | __esri.LineSymbol3D;
-    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead. */
+    polylineSymbol: import('@arcgis/core/widgets/Sketch/types').SketchPolylineSymbol;
+    /** @deprecated since 4.34, use [`slot`](https://developers.arcgis.com/javascript/latest/building-your-ui/#slots) instead. */
     position?: __esri.UIPosition;
     /**
      * 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.
@@ -194,57 +370,83 @@ export declare class ArcgisSketch extends LitElement {
      * Determines the size of widget elements.
      *
      * @default "m"
+     * @since 4.32
      */
     scale: "s" | "m" | "l";
     /**
-     * Controls the appearance of the sketch widget, allowing
-     * the toolbar to adapt its appearance appropriately based on context.
+     * Controls the appearance of the sketch widget, allowing the toolbar to adapt its appearance appropriately based on context.
+     *
+     * Set this to `docked` for use within the Expand component, or any other situation
+     * where Sketch is not floating within a large canvas.
      *
      * @default "floating"
+     * @since 4.32
+     */
+    toolbarKind: import('@arcgis/core/widgets/Sketch/types').ToolbarKind;
+    /**
+     * Indicates whether to display the header. Default is `false`.
+     *
+     * @default false
      */
-    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.
+     * _since 4.32_ Indicates whether to display the freehandPolygon tool. Default is `false`.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#snappingOptions)
+     * @default false
      */
-    snappingOptions: __esri.SnappingOptions;
-    /** The current state of the component. */
-    readonly state: "ready" | "disabled" | "active";
+    showCreateToolsFreehandPolygon: boolean;
     /**
-     * Options to configure the tooltip shown next to the cursor when creating or updating graphics.
+     * _since 4.32_ Indicates whether to display the freehandPolyline tool. Default is `false`.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#tooltipOptions)
+     * @default false
      */
-    tooltipOptions: __esri.SketchTooltipOptions;
+    showCreateToolsFreehandPolyline: boolean;
+    /** The [SnappingOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html) for sketching. It supports [self](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html#selfEnabled) and [feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html#featureEnabled) snapping. */
+    snappingOptions: import('@arcgis/core/views/interactive/snapping/SnappingOptions').default;
+    /** The current state of the component. */
+    readonly state: import('@arcgis/core/widgets/Sketch/types').State;
     /**
-     * An array of [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) that are being updated by the Sketch widget.
+     * 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#updateGraphics)
+     * @since 4.24
      */
-    readonly updateGraphics: __esri.Collection<__esri.Graphic>;
+    tooltipOptions: import('@arcgis/core/views/interactive/sketch/SketchTooltipOptions').default;
+    /** A [TextSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-TextSymbol.html) used when creating features with the 'text' tool. */
+    textSymbol: import('@arcgis/core/symbols/TextSymbol').default;
+    /** An array of [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) that are being updated by the Sketch widget. */
+    readonly updateGraphics: import('@arcgis/core/core/Collection').default<import('@arcgis/core/Graphic').default>;
     cancel(): Promise<void>;
     complete(): Promise<void>;
-    create(tool: "circle" | "point" | "polygon" | "polyline" | "rectangle", createOptions?: __esri.SketchViewModelCreateCreateOptions): Promise<void>;
+    /**
+     * @param tool
+     * @param createOptions
+     */
+    create(tool: Parameters<Sketch["create"]>[0], createOptions?: Parameters<Sketch["create"]>[1]): Promise<void>;
     delete(): Promise<void>;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
     duplicate(): Promise<void>;
     redo(): Promise<void>;
-    triggerUpdate(graphic: __esri.Graphic | __esri.Graphic[], updateOptions?: __esri.SketchViewModelUpdateUpdateOptions): Promise<void>;
+    /**
+     * @param graphic
+     * @param updateOptions
+     */
+    triggerUpdate(graphic: Parameters<Sketch["update"]>[0], updateOptions?: Parameters<Sketch["update"]>[1]): Promise<void>;
     undo(): Promise<void>;
-    readonly arcgisCreate: TargetedEvent<this, __esri.SketchCreateEvent>;
-    readonly arcgisDelete: TargetedEvent<this, __esri.SketchDeleteEvent>;
+    readonly arcgisCreate: TargetedEvent<this, import('@arcgis/core/widgets/Sketch/types').CreateEvent>;
+    readonly arcgisDelete: TargetedEvent<this, import('@arcgis/core/widgets/Sketch/types').DeleteEvent>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
     /** Emitted when the component associated with a map or scene view is 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>;
+    readonly arcgisRedo: TargetedEvent<this, import('@arcgis/core/widgets/Sketch/types').RedoEvent>;
+    readonly arcgisUndo: TargetedEvent<this, import('@arcgis/core/widgets/Sketch/types').UndoEvent>;
+    readonly arcgisUpdate: TargetedEvent<this, import('@arcgis/core/widgets/Sketch/types').UpdateEvent>;
+    private widget: Sketch;
+    readonly _setterTypes: {
+        icon?: IconName;
+    };
 }
 export {};