@arcgis/map-components 5.1.0-next.1 → 5.1.0-next.11

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

@@ -4,27 +4,26 @@ import type ShadowCastAnalysis from "@arcgis/core/analysis/ShadowCastAnalysis.js
 import type SceneView from "@arcgis/core/views/SceneView.js";
 import type Color from "@arcgis/core/Color.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { HeadingLevel } from "../../support/heading.js";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
+import type { ArcgisReferenceElement, HeadingLevel } from "../types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { Icon as Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { ShadowCastMode as ShadowCastMode2, ShadowCastTotalDurationMode } from "@arcgis/core/analysis/ShadowCast/types.js";
 
 /**
  * The Shadow Cast component displays the cumulative shadows of 3D features in a
- * [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).
+ * [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/).
  * This type of analysis is helpful in urban development, where new projects have to satisfy certain shadow duration constraints.
  *
  * The component calculates the cumulative shadows for a time range during a single day. The user can
  * configure the time range and select a calendar date. This time range and calendar date are only used
  * for the shadow analysis and are not connected to the lighting in the scene.
  * To control the lighting in the scene, use the
- * [Daylight](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-daylight/) component.
+ * [arcgis-daylight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/) component.
  * Changing the timezone in the component updates the visualization by interpreting the time range as being
  * in that timezone. This behavior is different from the
- * [Daylight](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-daylight/) component,
+ * [arcgis-daylight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/) component,
  * where selecting a timezone updates the
- * [environment lighting's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)
+ * [arcgis-scene.environment](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#environment)
  * date and time according to the camera position.
  *
  * The component provides three [modes](#mode): minimum duration, total duration, and discrete mode.
@@ -55,7 +54,7 @@ import type { ShadowCastMode as ShadowCastMode2, ShadowCastTotalDurationMode } f
  *
  * **Known limitations**
  *
- * * Shadow Cast is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.
+ * * Shadow Cast is only supported in a 3D [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) component.
  * * Terrain does not cast shadows in this analysis. As a result, to avoid incorrect shadow visualization, `startTimeOfDay`
  * should be set after local sunrise and `endTimeOfDay` before local sunset. If these times fall outside daylight hours,
  * shadows may be missing in areas where terrain would normally block sunlight.
@@ -72,13 +71,13 @@ import type { ShadowCastMode as ShadowCastMode2, ShadowCastTotalDurationMode } f
  */
 export abstract class ArcgisShadowCast extends LitElement {
   /**
-   * The [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html)
+   * The [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/)
    * created or modified by the component.
    *
-   * When connecting the Shadow Cast 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 [analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#analyses)
+   * When connecting the Shadow Cast component to the [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/)
+   * component, it automatically creates an empty analysis and adds it to the [arcgis-scene.analyses](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#analyses)
    * collection.
-   * You can then wait for the [ShadowCastAnalysisView3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ShadowCastAnalysisView3D.html)
+   * You can then wait for the [ShadowCastAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ShadowCastAnalysisView3D/)
    * to be created before accessing the analysis results.
    *
    * ```js
@@ -103,7 +102,7 @@ export abstract class ArcgisShadowCast extends LitElement {
    * ```
    * Whenever the component is destroyed, the analysis is automatically removed from the collection.
    *
-   * Alternatively, a programmatically created [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html)
+   * Alternatively, a programmatically created [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/)
    * can be provided to the component.
    * Then, the application itself needs to add it to and later remove it from the analyses collection of the Scene component.
    *
@@ -123,6 +122,8 @@ export abstract class ArcgisShadowCast extends LitElement {
    * // Connect the analysis to the shadow cast component.
    * shadowCastElement.analysis = analysis;
    * ```
+   *
+   * @since 5.0
    */
   accessor analysis: ShadowCastAnalysis;
   /**
@@ -149,18 +150,22 @@ export abstract class ArcgisShadowCast extends LitElement {
    * Color of the shadow visualization in "discrete" [mode](#mode). The opacity of the visualization is mapped to the
    * number of overlapping shadows. No shadow corresponds to opacity 0 and maximum number of shadows corresponds to the
    * opacity set in this color value.
+   *
+   * @since 5.0
    */
   accessor discreteColor: Color;
   /**
    * Individual shadows are displayed at this time interval in "discrete" [mode](#mode), starting with the start time of
    * day. The interval is expressed in milliseconds. If set to 0, we'll use the smallest possible interval, up to a
    * maximum of 255 samples.
+   *
+   * @since 5.0
    */
   accessor discreteInterval: number;
   /**
    * Time (in milliseconds from midnight of the [date](#date)) when the shadow cast computation should stop.
    *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html#endTimeOfDay)
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#endTimeOfDay)
    */
   accessor endTimeOfDay: number;
   /**
@@ -179,66 +184,77 @@ export abstract class ArcgisShadowCast extends LitElement {
    * If true, the color picker will be hidden in the discrete mode options.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideDiscreteColorPicker: boolean;
   /**
    * If true, the interval selector will be hidden in the discrete mode options.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideDiscreteInterval: boolean;
   /**
    * If true, the visualization options will be hidden in discrete mode.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideDiscreteOptions: boolean;
   /**
    * If true, the color picker will be hidden in the minimum duration mode options.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideMinDurationColorPicker: boolean;
   /**
    * If true, the color picker will be hidden in the context options in minimum duration mode.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideMinDurationContextColorPicker: boolean;
   /**
    * If true, the interval selector will be hidden in the context options in minimum duration mode.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideMinDurationContextInterval: boolean;
   /**
    * If true, the context options will be hidden in the minimum duration mode options.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideMinDurationContextOptions: boolean;
   /**
    * If true, the toggle used to show or hide the context options will be hidden.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideMinDurationContextToggle: boolean;
   /**
    * If true, the visualization options will be hidden in minimum duration mode.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideMinDurationOptions: boolean;
   /**
    * If true, the minimum duration slider will be hidden in the minimum duration mode options.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideMinDurationSlider: boolean;
   /**
    * If true, the tooltip which displays the amount of shadow at a certain location will be hidden.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideShadowDurationTooltip: boolean;
   /**
@@ -257,30 +273,35 @@ export abstract class ArcgisShadowCast extends LitElement {
    * If true, the color picker will be hidden in the total duration mode options.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideTotalDurationColorPicker: boolean;
   /**
    * If true, the mode selector will be hidden in the total duration mode options.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideTotalDurationModeSelect: boolean;
   /**
    * If true, the visualization options will be hidden in the total duration mode.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideTotalDurationOptions: boolean;
   /**
    * Indicates whether the component's visualization is hidden in the view.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideVisualization: boolean;
   /**
    * If true, the visualization options will be hidden.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideVisualizationOptions: boolean;
   /**
@@ -293,7 +314,11 @@ export abstract class ArcgisShadowCast extends LitElement {
   accessor icon: Icon["icon"] | undefined;
   /** The component's default label. */
   accessor label: string | undefined;
-  /** Maximum allowed value for the [minDuration](#minDuration) property, in milliseconds. */
+  /**
+   * Maximum allowed value for the [minDuration](#minDuration) property, in milliseconds.
+   *
+   * @since 5.0
+   */
   accessor maxMinDuration: number;
   /** @internal */
   protected messages: Partial<{
@@ -351,16 +376,24 @@ export abstract class ArcgisShadowCast extends LitElement {
       timezoneLabel: string;
       visualizationLabel: string;
   }>;
-  /** The minimum duration (in milliseconds) used in "min-duration" [mode](#mode) to determine which shadow areas are displayed. */
+  /**
+   * The minimum duration (in milliseconds) used in "min-duration" [mode](#mode) to determine which shadow areas are displayed.
+   *
+   * @since 5.0
+   */
   accessor minDuration: number;
   /**
    * Color of the shadow visualization in "min-duration" [mode](#mode). The areas with cumulative shadow time longer than
    * the minimum duration value are displayed with this color.
+   *
+   * @since 5.0
    */
   accessor minDurationColor: Color;
   /**
    * The color used when showing additional context in "min-duration" [mode](#mode) when
    * [minDurationContextEnabled](#contextEnabled) is true.
+   *
+   * @since 5.0
    */
   accessor minDurationContextColor: Color;
   /**
@@ -370,17 +403,21 @@ export abstract class ArcgisShadowCast extends LitElement {
    * discrete shadows when context is enabled.
    *
    * @default false
+   * @since 5.0
    */
   accessor minDurationContextEnabled: boolean;
   /**
    * The interval in milliseconds used when showing additional context in "min-duration" [mode](#mode) when
    * [minDurationContextEnabled](#contextEnabled) is true.
+   *
+   * @since 5.0
    */
   accessor minDurationContextInterval: number;
   /**
    * Minimum allowed value for the [minDuration](#minDuration) property, in milliseconds.
    *
    * @default 0
+   * @since 5.0
    */
   accessor minMinDuration: number;
   /**
@@ -390,6 +427,8 @@ export abstract class ArcgisShadowCast extends LitElement {
    * within the selected time range. Optional discrete shadow overlays can provide additional context.
    * - "total-duration": Displays total shadow accumulation within the selected time range using opacity: areas with
    * longer shadow duration appear more opaque. Supports continuous or 1‑hour aggregated modes.
+   *
+   * @since 5.0
    */
   accessor mode: ShadowCastMode2;
   /**
@@ -401,7 +440,7 @@ export abstract class ArcgisShadowCast extends LitElement {
   /**
    * Time (in milliseconds from midnight of the [date](#date)) when the shadow cast computation should start.
    *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html#startTimeOfDay)
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#startTimeOfDay)
    */
   accessor startTimeOfDay: number;
   /**
@@ -415,11 +454,15 @@ export abstract class ArcgisShadowCast extends LitElement {
    * Color of the shadow visualization in "total-duration" [mode](#mode). The opacity is mapped to the time spent in shadow.
    * Areas that don't receive any shadow are displayed with zero opacity and areas that receive shadows for the entire
    * time range are displayed with the opacity specified in this property.
+   *
+   * @since 5.0
    */
   accessor totalDurationColor: Color;
   /**
    * Mode in which the cumulative shadow duration should be displayed in "total-duration" [mode](#mode): as a continuous
    * surface or as an hourly aggregation of values.
+   *
+   * @since 5.0
    */
   accessor totalDurationMode: ShadowCastTotalDurationMode;
   /** The difference in hours between UTC time and the times displayed in the component. */
@@ -442,9 +485,10 @@ export abstract class ArcgisShadowCast extends LitElement {
   /**
    * Returns the time (in milliseconds) spent in shadow for a certain point on the screen.
    *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ShadowCast-ShadowCastAnalysisView3D.html#getDurationAtScreen)
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ShadowCast/ShadowCastAnalysisView3D/#getDurationAtScreen)
    *
    * @param point
+   * @since 5.0
    */
   getDurationAtScreen(point: Point): Promise<number>;
   "@setterTypes": {

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

@@ -5,27 +5,27 @@ import type Graphic from "@arcgis/core/Graphic.js";
 import type SketchLabelOptions from "@arcgis/core/views/interactive/sketch/SketchLabelOptions.js";
 import type MapNotesLayer from "@arcgis/core/layers/MapNotesLayer.js";
 import type SnappingOptions from "@arcgis/core/views/interactive/snapping/SnappingOptions.js";
-import type SketchTooltipOptions from "@arcgis/core/views/interactive/sketch/SketchTooltipOptions.js";
 import type TextSymbol from "@arcgis/core/symbols/TextSymbol.js";
+import type SketchTooltipOptions from "@arcgis/core/views/interactive/sketch/SketchTooltipOptions.js";
 import type Collection from "@arcgis/core/core/Collection.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { IconName } from "../../utils/action-utils.js";
+import type { ArcgisReferenceElement, IconName } from "../types.js";
 import type { CreateOptions, CreateTool, UpdateEvent, UndoEvent, RedoEvent, DeleteEvent, CreateEvent } from "@arcgis/core/widgets/Sketch/types";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
-import type { SketchTool, SelectionTool, CreateTool as CreateTool2, CreationMode, CreateOptions as CreateOptions2, UpdateOptions, Layout, SketchPointSymbol, SketchPolygonSymbol, SketchPolylineSymbol, ToolbarKind, State } from "@arcgis/core/widgets/Sketch/types.js";
+import type { SketchTool, SelectionTool, CreateTool as CreateTool2, CreationMode, CreateOptions as CreateOptions2, UpdateOptions, Layout, SketchPointSymbol, SketchPolygonSymbol, SketchPolylineSymbol, State, ToolbarKind } from "@arcgis/core/widgets/Sketch/types.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
+import type { Button as Button } from "@esri/calcite-components/components/calcite-button";
 
 /**
- * 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).
+ * The Sketch component provides a simple UI for creating and updating graphics on a [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) or a [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
  *
  * @since 4.28
  */
 export abstract 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),
+   * When creating new graphics (for example after [create()](https://developers.arcgis.com/javascript/latest/references/core/widgets/Sketch/#create) has been called),
    * 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
+   * (for example after [update()](https://developers.arcgis.com/javascript/latest/references/core/widgets/Sketch/#update) has been called), this property reflects the
    * update tool being used. If no create or update operation is in progress, this is `null`.
    *
    * Prior to 4.32, creation tools were modeled as a combination of a geometry type (point, line, polygon)
@@ -63,7 +63,7 @@ export abstract class ArcgisSketch extends LitElement {
   /** The graphic that is being created. */
   get createGraphic(): Graphic | null | undefined;
   /**
-   * 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
+   * Defines the default behavior once the [create()](https://developers.arcgis.com/javascript/latest/references/core/widgets/Sketch/#create) operation is completed. By default, the user will be
    * able to continuously create graphics with same geometry types.
    *
    * **Possible Values**
@@ -72,7 +72,7 @@ export abstract class ArcgisSketch extends LitElement {
    * ----- | ----------- |
    * 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.
+   * update | The graphic will be selected for an [update()](https://developers.arcgis.com/javascript/latest/references/core/widgets/Sketch/#update) operation once the `create` operation is completed.
    *
    * @default "continuous"
    * @since 4.14
@@ -93,7 +93,7 @@ export abstract class ArcgisSketch extends LitElement {
   accessor defaultGraphicsLayerDisabled: boolean;
   /**
    * Default update options set for the Sketch component. 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.
+   * when [update()](https://developers.arcgis.com/javascript/latest/references/core/widgets/Sketch/#update) method is called.
    *
    * @since 4.11
    * @example
@@ -203,7 +203,7 @@ export abstract class ArcgisSketch extends LitElement {
   accessor hideSnappingControls: boolean;
   /**
    * Indicates whether to hide the `enabledToggle` (Enable snapping). This toggles
-   * the [SnappingOptions#enabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html#enabled) property.
+   * the [SnappingOptions#enabled](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/snapping/SnappingOptions/#enabled) property.
    * > [!WARNING]
    * >
    * > **Note**
@@ -217,14 +217,14 @@ export abstract class ArcgisSketch extends LitElement {
   accessor hideSnappingControlsElementsEnabledToggle: boolean;
   /**
    * Indicates whether to hide the `featureEnabledToggle` (Feature to feature). This toggles
-   * the [SnappingOptions#featureEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html#featureEnabled) property.
+   * the [SnappingOptions#featureEnabled](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/snapping/SnappingOptions/#featureEnabled) property.
    *
    * @default false
    * @since 5.0
    */
   accessor hideSnappingControlsElementsFeatureEnabledToggle: boolean;
   /**
-   * Indicates whether to hide the [FeatureSnappingLayerSource](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-FeatureSnappingLayerSource.html) layerList. The layerlist provides the available layer sources supported for snapping.
+   * Indicates whether to hide the [FeatureSnappingLayerSource](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/snapping/FeatureSnappingLayerSource/) layerList. The layerlist provides the available layer sources supported for snapping.
    *
    * @default false
    * @since 5.0
@@ -232,7 +232,7 @@ export abstract class ArcgisSketch extends LitElement {
   accessor hideSnappingControlsElementsLayerList: boolean;
   /**
    * Indicates whether to hide the `selfEnabledToggle` (Geometry guides). This toggles
-   * the [SnappingOptions#selfEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html#selfEnabled) property.
+   * the [SnappingOptions#selfEnabled](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/snapping/SnappingOptions/#selfEnabled) property.
    *
    * @default false
    * @since 5.0
@@ -275,13 +275,13 @@ export abstract class ArcgisSketch extends LitElement {
    * >
    * > **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).
+   * > Sketch labels are currently only supported when working with a [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
    *
    * @since 4.24
    */
   accessor labelOptions: SketchLabelOptions;
   /**
-   * The [GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) associated with the Sketch component. The Sketch component adds new [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) to this layer or can only update graphics
+   * The [GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/) associated with the Sketch component. The Sketch component adds new [graphics](https://developers.arcgis.com/javascript/latest/references/core/Graphic/) to this layer or can only update graphics
    * stored in this layer.
    */
   accessor layer: GraphicsLayer | MapNotesLayer | null | undefined;
@@ -293,7 +293,7 @@ export abstract class ArcgisSketch extends LitElement {
    */
   accessor layout: Layout;
   /**
-   * 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.
+   * A [SimpleMarkerSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/SimpleMarkerSymbol/), [PictureMarkerSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/PictureMarkerSymbol/), [PointSymbol3D](https://developers.arcgis.com/javascript/latest/references/core/symbols/PointSymbol3D/), [TextSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/TextSymbol/), [CIMSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/CIMSymbol/), or [WebStyleSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/WebStyleSymbol/) used for representing the point geometry that is being drawn. [SimpleMarkerSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/SimpleMarkerSymbol/) may also be used to symbolize point features in a [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/). However, it is recommended you use [PointSymbol3D](https://developers.arcgis.com/javascript/latest/references/core/symbols/PointSymbol3D/) instead.
    *
    * > [!WARNING]
    * >
@@ -316,7 +316,7 @@ export abstract class ArcgisSketch extends LitElement {
    */
   accessor pointSymbol: 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. [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.
+   * A [SimpleFillSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/SimpleFillSymbol/), [PolygonSymbol3D](https://developers.arcgis.com/javascript/latest/references/core/symbols/PolygonSymbol3D/), or [CIMSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/CIMSymbol/) used for representing the polygon geometry that is being drawn. [SimpleFillSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/SimpleFillSymbol/) may also be used to symbolize polygon features in a [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/). However, it is recommended you use [PolygonSymbol3D](https://developers.arcgis.com/javascript/latest/references/core/symbols/PolygonSymbol3D/) instead.
    *
    * > [!WARNING]
    * >
@@ -337,7 +337,7 @@ export abstract class ArcgisSketch extends LitElement {
    */
   accessor polygonSymbol: 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. [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.
+   * A [SimpleLineSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/SimpleLineSymbol/), [LineSymbol3D](https://developers.arcgis.com/javascript/latest/references/core/symbols/LineSymbol3D/), or [CIMSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/CIMSymbol/) used for representing the polyline geometry that is being drawn. [SimpleLineSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/SimpleLineSymbol/) may also be used to symbolize polyline features in a [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/). However, it is recommended you use [LineSymbol3D](https://developers.arcgis.com/javascript/latest/references/core/symbols/LineSymbol3D/) instead.
    *
    * > [!WARNING]
    * >
@@ -361,38 +361,55 @@ export abstract class ArcgisSketch extends LitElement {
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
-   * Determines the size of component elements.
+   * Indicates whether to display the freehandPolygon tool.
    *
-   * @default "m"
-   * @since 4.32
+   * @default false
+   * @since 5.0
    */
-  accessor scale: "s" | "m" | "l";
+  accessor showCreateToolsFreehandPolygon: boolean;
   /**
-   * Indicates whether to display the freehandPolygon tool. Default is `false`.
+   * Indicates whether to display the freehandPolyline tool.
    *
    * @default false
    * @since 5.0
    */
-  accessor showCreateToolsFreehandPolygon: boolean;
+  accessor showCreateToolsFreehandPolyline: boolean;
   /**
-   * Indicates whether to display the freehandPolyline tool. Default is `false`.
+   * Indicates whether to display the text tool.
    *
    * @default false
    * @since 5.0
    */
-  accessor showCreateToolsFreehandPolyline: boolean;
+  accessor showCreateToolsText: boolean;
   /**
-   * Indicates whether to display the header. Default is `false`.
+   * Indicates whether to display the header.
    *
    * @default false
    * @since 5.0
    */
   accessor showSnappingControlsElementsHeader: 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. */
+  /** The [SnappingOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/snapping/SnappingOptions/) for sketching. It supports [self](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/snapping/SnappingOptions/#selfEnabled) and [feature](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/snapping/SnappingOptions/#featureEnabled) snapping. */
   accessor snappingOptions: SnappingOptions;
   /** The current state of the component. */
   get state(): State;
-  /** A [TextSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-TextSymbol.html) used when creating features with the 'text' tool. */
+  /**
+   * A [TextSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/TextSymbol/) used for representing the geometry that is being drawn.
+   *
+   * > [!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: "text",
+   *   text: "hello world"
+   * }
+   * ```
+   *
+   * @since 5.0
+   */
   accessor textSymbol: TextSymbol;
   /**
    * Controls the appearance of the sketch component, allowing the toolbar to adapt its appearance appropriately based on context.
@@ -404,19 +421,21 @@ export abstract class ArcgisSketch extends LitElement {
    * @since 4.32
    */
   accessor toolbarKind: ToolbarKind;
-  /**
-   * Options to configure the tooltip shown next to the cursor when creating or updating graphics.
-   *
-   * @since 4.24
-   */
+  /** Options to configure the tooltip shown next to the cursor when creating or updating graphics. */
   accessor tooltipOptions: SketchTooltipOptions;
-  /** An array of [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) that are being updated by the Sketch component. */
+  /** An array of [graphics](https://developers.arcgis.com/javascript/latest/references/core/Graphic/) that are being updated by the Sketch component. */
   get updateGraphics(): Collection<Graphic>;
   /**
    * 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 arcgis-sketch component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapViewOrSceneView | null | undefined;
+  /**
+   * Specifies the size of the component.
+   *
+   * @since 5.0
+   */
+  accessor visualScale: Button["scale"];
   cancel(): Promise<void>;
   complete(): Promise<void>;
   /**