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

package/dist/components/arcgis-slider-size-legacy/customElement.d.ts

@@ -1,12 +1,11 @@
 /// <reference path="../../index.d.ts" />
-import type SizeVariable from "@arcgis/core/renderers/visualVariables/SizeVariable";
+import type SizeVariable from "@arcgis/core/renderers/visualVariables/SizeVariable.js";
 import type SizeStop from "@arcgis/core/renderers/visualVariables/support/SizeStop.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ContinuousRendererResult } from "@arcgis/core/smartMapping/renderers/size";
-import type { HistogramResult } from "@arcgis/core/smartMapping/statistics/types";
-import type { IconName } from "../../utils/action-utils.js";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { ThumbDragEvent, ThumbChangeEvent } from "@arcgis/core/widgets/Slider/types";
+import type { ContinuousRendererResult } from "@arcgis/core/smartMapping/renderers/size.js";
+import type { HistogramResult } from "@arcgis/core/smartMapping/statistics/types.js";
+import type { ArcgisReferenceElement, IconName } from "../types.js";
+import type { ThumbDragEvent, ThumbChangeEvent } from "@arcgis/core/widgets/Slider/types.js";
 import type { HistogramConfig, ZoomOptions } from "@arcgis/core/widgets/smartMapping/types.js";
 import type { LabelFormatFunction, InputParseFunction } from "@arcgis/core/widgets/types.js";
 import type { SizeSliderStyle } from "@arcgis/core/widgets/smartMapping/SizeSlider.js";
@@ -17,25 +16,24 @@ import type { SmartMappingSliderBaseState } from "@arcgis/core/widgets/smartMapp
  * >
  * > This is a **legacy component**. It relies on an underlying widget as part of our migration to native web components.
  * >
- * > A fully native replacement for this component is in development. Once it reaches feature parity, the legacy component will be deprecated and no longer maintained. At that point, new development should use the native component.
+ * > A fully native replacement for this component is in development. Once it reaches feature parity, the legacy component will be deprecated and no longer maintained. At that point, development should use the native component.
  *
  * The Size Slider component is intended for authoring and exploring data-driven visualizations in any
- * layer that can be rendered with a [SizeVariable](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-SizeVariable.html).
+ * layer that can be rendered with a [SizeVariable](https://developers.arcgis.com/javascript/latest/references/core/renderers/visualVariables/SizeVariable/).
  *
- * <span id="image-annotations"></span>
  * See the image below for a summary of the configurable options available on this slider.
  *
- * ![Size Slider with annotations](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sliders/sizeslider-labels.png "Size Slider with annotations")
+ * ![Size Slider with annotations](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/sliders/sizeslider-labels.avif "Size Slider with annotations")
  *
- * The [updateFromRendererResult()](#updateFromRendererResult) method can be used to intelligently populate slider properties including
- * [max](#max), [min](#min), [size visual variable](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-SizeVariable.html)
+ * The [updateFromRendererResult()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#updateFromRendererResult) method can be used to intelligently populate slider properties including
+ * [max](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#max), [min](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#min), [size visual variable](https://developers.arcgis.com/javascript/latest/references/core/renderers/visualVariables/SizeVariable/)
  * intervals, and the slider's histogram after the renderer has been created from the result of the
- * [createContinuousRenderer()](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-renderers-size.html#createContinuousRenderer) method.
+ * [createContinuousRenderer()](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/renderers/size/#createContinuousRenderer) method.
  *
  * ```js
  * const sizeRendererCreator = await import("@arcgis/core/smartMapping/renderers/size.js");
  * const viewElement = document.querySelector("arcgis-map")!;
- * const sizeSlider = document.querySelector("arcgis-slider-size")!;
+ * const sizeSlider = document.querySelector("arcgis-slider-size-legacy")!;
  *
  * const featureLayer = new FeatureLayer({
  *   url: "https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_Major_Cities_/FeatureServer/0",
@@ -62,7 +60,7 @@ import type { SmartMappingSliderBaseState } from "@arcgis/core/widgets/smartMapp
  * sizeSlider.updateFromRendererResult(rendererResult, histogramResult);
  * ```
  *
- * This slider should be used to update a [size visual variable](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-SizeVariable.html)
+ * This slider should be used to update a [size visual variable](https://developers.arcgis.com/javascript/latest/references/core/renderers/visualVariables/SizeVariable/)
  * in a layer's renderer. It is the responsibility of the app developer
  * to set up event listeners that update the size variable of the appropriate renderer.
  *
@@ -73,7 +71,7 @@ import type { SmartMappingSliderBaseState } from "@arcgis/core/widgets/smartMapp
  *     return;
  *   }
  *
- *   const sizeVariable = renderer.visualVariables[0] as __esri.SizeVariable;
+ *   const sizeVariable = renderer.visualVariables[0];
  *   const updatedSizeVariable = sizeSlider.updateVisualVariable(sizeVariable);
  *   if (!updatedSizeVariable) {
  *     return;
@@ -88,9 +86,8 @@ import type { SmartMappingSliderBaseState } from "@arcgis/core/widgets/smartMapp
  * sizeSlider.addEventListener("arcgisPropertyChange", updateRendererFromSlider);
  * ```
  *
- * @since 5.0.0
- * @see [SizeSliderViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-smartMapping-SizeSlider-SizeSliderViewModel.html)
- * @see [sizeRendererCreator](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-renderers-size.html)
+ * @since 5.0
+ * @see [sizeRendererCreator](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/renderers/size/)
  */
 export abstract class ArcgisSliderSizeLegacy extends LitElement {
   /**
@@ -104,11 +101,9 @@ export abstract class ArcgisSliderSizeLegacy extends LitElement {
    */
   accessor autoDestroyDisabled: boolean;
   /**
-   * The [Histogram](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Histogram.html) associated with the data represented on the slider. The bins are typically
-   * generated using the [histogram](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-statistics-histogram.html) statistics function.
+   * The histogram associated with the data represented on the slider. The bins are typically
+   * generated using the [histogram](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/histogram/) statistics function.
    *
-   * @see [histogram](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-statistics-histogram.html)
-   * @see [Histogram](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Histogram.html)
    * @example
    * ```js
    * const histogramResult = await histogram({
@@ -117,10 +112,11 @@ export abstract class ArcgisSliderSizeLegacy extends LitElement {
    *   numBins: 30,
    * });
    *
-   * sizeSlider.histogramConfig = {
-   *   bins: histogramResult.bins
-   * };
-   * ```
+   *  slider.histogramConfig = {
+   *    bins: histogramResult.bins
+   *  };
+   *       ```
+   * @see [histogram](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/histogram/)
    */
   accessor histogramConfig: HistogramConfig | null | undefined;
   /**
@@ -131,33 +127,34 @@ export abstract class ArcgisSliderSizeLegacy extends LitElement {
    */
   accessor icon: IconName;
   /**
-   * A function used to format user inputs. As opposed to [labelFormatFunction](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-smartMapping-SmartMappingSliderBase.html#labelFormatFunction), which formats
+   * A function used to format user inputs. As opposed to [labelFormatFunction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#labelFormatFunction), which formats
    * thumb labels, the `inputFormatFunction` formats thumb values in the input element when the user begins
    * to edit them.
    *
    * The image below demonstrates how slider input values resemble corresponding slider values by default
    * and won't match the formatting set in `labelFormatFunction`.
    *
-   * ![Slider without input formatter](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sliders/slider-no-input-formatter.png "Slider without input formatter")
+   * ![Slider without input formatter](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/sliders/slider-no-input-formatter.avif "Slider without input formatter")
    *
    * If you want to format slider input values so they match thumb labels, you can pass the same function set in `labelFormatFunction` to
    * `inputFormatFunction` for consistent formatting.
    *
-   * ![Slider with input formatter](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sliders/slider-input-formatter.png "Slider with input formatter")
+   * ![Slider with input formatter](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/sliders/slider-input-formatter.avif "Slider with input formatter")
    *
    * However, if an `inputFormatFunction` is specified, you must also write a corresponding
-   * [inputParseFunction](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-smartMapping-SmartMappingSliderBase.html#inputParseFunction) to parse user inputs to understandable slider values. In most cases, if
-   * you specify an `inputFormatFunction`, you should set the [labelFormatFunction](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-smartMapping-SmartMappingSliderBase.html#labelFormatFunction) to the same value
+   * [inputParseFunction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#inputParseFunction) to parse user inputs to understandable slider values. In most cases, if
+   * you specify an `inputFormatFunction`, you should set the [labelFormatFunction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#labelFormatFunction) to the same value
    * for consistency between labels and inputs.
    *
    * This property overrides the default input formatter, which formats by calling `toString()` on the input value.
+   *       
    *
-   * @see [inputParseFunction](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-smartMapping-SmartMappingSliderBase.html#inputParseFunction)
+   * @see [inputParseFunction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#inputParseFunction)
    * @example
    * ```js
    * // Formats the slider input to abbreviated numbers with units
    * // e.g. a thumb at position 1500 will render with an input label of 1.5k
-   * sizeSlider.inputFormatFunction = (value: number): string => {
+   * slider.inputFormatFunction = (value: number): string => {
    *   if (value >= 1000000) {
    *     return (value / 1000000).toPrecision(3) + "m";
    *   }
@@ -169,24 +166,24 @@ export abstract class ArcgisSliderSizeLegacy extends LitElement {
    *   }
    *   return value.toFixed(0);
    * };
-   * ```
+   *            ```
    */
   accessor inputFormatFunction: LabelFormatFunction | null | undefined;
   /**
-   * Function used to parse slider inputs formatted by the [inputFormatFunction](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-smartMapping-SmartMappingSliderBase.html#inputFormatFunction).
+   * Function used to parse slider inputs formatted by the [inputFormatFunction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#inputFormatFunction).
    * This property must be set if an `inputFormatFunction` is set. Otherwise the slider values will
    * likely not update to their expected positions.
    *
    * Overrides the default input parses, which is a parsed floating point number.
    *
-   * @see [inputFormatFunction](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-smartMapping-SmartMappingSliderBase.html#inputFormatFunction)
+   * @see [inputFormatFunction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#inputFormatFunction)
    * @example
    * ```js
    * // Parses the slider input (a string value) to a number value understandable to the slider
    * // This assumes the slider was already configured with an inputFormatFunction
    * // For example, if the input is 1.5k this function will parse
    * // it to a value of 1500
-   * sizeSlider.inputParseFunction = (value: string): number => {
+   * colorSlider.inputParseFunction = (value: string): number => {
    *   const charLength = value.length;
    *   const valuePrefix = parseFloat(value.substring(0, charLength - 1));
    *   const finalChar = value.substring(charLength - 1);
@@ -202,27 +199,23 @@ export abstract class ArcgisSliderSizeLegacy extends LitElement {
    *   }
    *   return parseFloat(value);
    * };
-   * ```
+   *           ```
    */
   accessor inputParseFunction: InputParseFunction | null | undefined;
   /**
-   * A modified version of
-   * [Slider#labelFormatFunction](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider.html#labelFormatFunction),
-   * which is a custom function used to format labels on the thumbs, min, max, and average
-   * values. Overrides the default label formatter.
-   * This function also supports date formatting.
+   * A function used to format labels on the thumbs, min, max, and average values. Overrides the default label formatter. This function also supports date formatting.
    *
    * @example
    * ```js
    * // For thumb values, rounds each label to whole numbers
-   * sizeSlider.labelFormatFunction = (value: number, type?: SliderFormatType): string => {
+   * slider.labelFormatFunction = (value: number, type?: SliderFormatType): string => {
    *   return (type === "value") ? value.toFixed(0) : value.toString();
    * };
-   * ```
+   *           ```
    */
   accessor labelFormatFunction: LabelFormatFunction | null | undefined;
   /**
-   * The maximum value or upper bound of the slider. Once the slider has rendered with the [updateFromRendererResult()](#updateFromRendererResult) method,
+   * The maximum value or upper bound of the slider. Once the slider has rendered with the [updateFromRendererResult()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#updateFromRendererResult) method,
    * the user may change this property by selecting the label containing the max value on the slider UI. It is the responsibility of the app developer
    * to set up event listeners that update the size variable of the appropriate renderer.
    *
@@ -233,7 +226,7 @@ export abstract class ArcgisSliderSizeLegacy extends LitElement {
    */
   accessor max: number;
   /**
-   * The minimum value or lower bound of the slider. Once the slider has rendered with the [updateFromRendererResult()](#updateFromRendererResult) method,
+   * The minimum value or lower bound of the slider. Once the slider has rendered with the [updateFromRendererResult()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#updateFromRendererResult) method,
    * the user may change this property by selecting the label containing the min value on the slider UI. It is the responsibility of the app developer
    * to set up event listeners that update the size variable of the appropriate renderer.
    *
@@ -247,13 +240,13 @@ export abstract class ArcgisSliderSizeLegacy extends LitElement {
    * Defines how slider thumb values should be rounded. This number indicates the number
    * of decimal places slider thumb _values_ should round to when they have been moved.
    *
-   * Keep in mind this property rounds thumb [values](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-smartMapping-SmartMappingSliderViewModel.html#values) and shouldn't be used exclusively
-   * for formatting purposes.
+   * Keep in mind this property rounds thumb values and shouldn't be used exclusively for formatting purposes.
    *
    * @default 4
    * @example
    * ```js
-   * sizeSlider.precision = 7;
+   * // Rounds slider thumb values to 7 decimal places
+   * slider.precision = 7;
    * ```
    */
   accessor precision: number;
@@ -264,10 +257,10 @@ export abstract class ArcgisSliderSizeLegacy extends LitElement {
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
-   * Exposes various properties of the slider that can be styled. The result object from the [createContinuousRenderer()](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-renderers-size.html#createContinuousRenderer)
+   * Exposes various properties of the slider that can be styled. The result object from the [createContinuousRenderer()](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/renderers/size/#createContinuousRenderer)
    * method can be used to match the `trackFillColor` to the current layer symbology.
    *
-   * @see [Color](https://developers.arcgis.com/javascript/latest/api-reference/esri-Color.html)
+   * @see [Color](https://developers.arcgis.com/javascript/latest/references/core/Color/)
    * @example
    * ```js
    * sizeSlider.sliderStyle = {
@@ -278,11 +271,11 @@ export abstract class ArcgisSliderSizeLegacy extends LitElement {
    */
   accessor sliderStyle: SizeSliderStyle;
   /** The current state of the component. */
-  accessor state: SmartMappingSliderBaseState;
+  get state(): SmartMappingSliderBaseState;
   /**
-   * The size stops from the [SizeVariable](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-SizeVariable.html) to link to the slider.
+   * The size stops from the [SizeVariable](https://developers.arcgis.com/javascript/latest/references/core/renderers/visualVariables/SizeVariable/) to link to the slider.
    *
-   * @see [updateVisualVariable()](#updateVisualVariable)
+   * @see [updateVisualVariable()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#updateVisualVariable)
    * @example
    * ```js
    * sizeSlider.stops = [
@@ -295,81 +288,69 @@ export abstract class ArcgisSliderSizeLegacy extends LitElement {
    */
   accessor stops: Array<SizeStop>;
   /**
-   * Zooms the slider track to the bounds provided in this property.
-   * When min and/or max zoom values are provided, the absolute
-   * [min](#min) and [max](#max) slider values are preserved and
-   * rendered at their typical positions on the slider. However, the
-   * slider track itself is zoomed so that thumbs cannot be moved above or
-   * below the provided min and max zoomed values.
+   * Zooms the slider track to the bounds provided in this property. When min and/or max zoom values are provided, the absolute [min](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#min) and
+   * [max](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#max) slider values are preserved and rendered at their typical positions on the slider. However, the
+   *  slider track itself is zoomed so that thumbs cannot be moved above or below the provided min and max zoomed values.
    *
-   * When a slider is in a zoomed state, the zoomed
-   * ends of the track will appear jagged. In the image below, notice how the
-   * top thumb cannot be moved past the zoom max of `31` even though the slider
-   * max is `200`.
+   *  When a slider is in a zoomed state, the zoomed ends of the track will appear jagged. In the image below, notice how the
+   *  top thumb cannot be moved past the zoom max of `31` even though the slider max is `200`.
    *
-   * ![slider-zoom](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sliders/slider-zoomed.png "Zoomed slider")
+   *  ![slider-zoom](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/sliders/slider-zoomed.avif "Zoomed slider")
    *
-   * To exit a zoomed state, the user can click the
-   * jagged line or the developer can set the `zoomOptions` to `null`. It
-   * is up to the developer to provide a UI option for end users to
-   * enable zooming on the slider.
+   *  To exit a zoomed state, the user can click the jagged line or the developer can set the `zoomOptions` to `null`. It
+   *  is up to the developer to provide a UI option for end users to enable zooming on the slider.
    *
-   * Setting the `zoomOptions` is useful when the slider is tied to heavily skewed
-   * datasets where the histogram renders only one or two bars because of outliers.
+   *  Setting the `zoomOptions` is useful when the slider is tied to heavily skewed datasets where the histogram renders only one or two bars because of outliers.
    *
-   * ![slider-not-zoomed](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sliders/slider-skewed-not-zoomed.png "Unzoomed slider")
+   *  ![slider-not-zoomed](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/sliders/slider-skewed-not-zoomed.avif "Unzoomed slider")
    *
-   * You can remove the influence of outliers by zooming the slider and regenerating
-   * a histogram based on the zoomed min and max. This will provide a better view of the data
-   * and make the slider more useful to the end user.
+   *  You can remove the influence of outliers by zooming the slider and regenerating a histogram based on the zoomed min and max. This will provide a better view of the data
+   *  and make the slider more useful to the end user.
    *
    * @example
    * ```js
-   * // zooms the slider so thumbs can only be moved
-   * // to positions between the values of 10 and 25 while
-   * // maintaining the slider's absolute minimum and maximum values
-   * sizeSlider.zoomOptions = {
+   * // zooms the slider so thumbs can only be moved to positions between
+   * // values of 10 and 25 while maintaining the slider's absolute min and max values
+   * slider.zoomOptions = {
    *   min: 10,
    *   max: 25
    * };
-   * ```
+   *           ```
    * @example
    * ```js
    * // disables zooming on the slider
-   * sizeSlider.zoomOptions = null;
-   * ```
+   * slider.zoomOptions = null;
+   *           ```
    * @example
    * ```js
-   * // zooms the slider so thumbs can only be moved
-   * // to positions above the value of 10 while maintaining
-   * // the slider's absolute minimum value
-   * sizeSlider.zoomOptions = {
+   * // zooms the slider so thumbs can only be moved to positions above
+   * // value of 10 while maintaining the slider's absolute min value
+   * slider.zoomOptions = {
    *   min: 10
    * };
-   * ```
+   *           ```
    * @example
    * ```js
-   * // zooms the slider so thumbs can only be moved
-   * // to positions below the value of 25 while maintaining
-   * // the slider's absolute maximum value
-   * sizeSlider.zoomOptions = {
+   * // zooms the slider so thumbs can only be moved to positions below
+   * // value of 25 while maintaining the slider's absolute max value
+   * slider.zoomOptions = {
    *   max: 25
    * };
-   * ```
+   *           ```
    */
   accessor zoomOptions: ZoomOptions | null | undefined;
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
   /**
    * A convenience function used to update the properties of a SizeSlider component instance from the
-   * [result](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-renderers-size.html#ContinuousRendererResult) of
-   * the [createContinuousRenderer()](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-renderers-size.html#createContinuousRenderer)
+   * [result](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/renderers/size/#ContinuousRendererResult) of
+   * the [createContinuousRenderer()](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/renderers/size/#createContinuousRenderer)
    * method. This method is used to configure an empty SizeSlider to be used with the layer data, and is useful for cases when the app allows the end user to switch data variables.
    * Note that this method always expects `rendererResult` to be defined for the slider to function, but `histogramResult` is optional.
    *
-   * @param rendererResult - The result object from the [createContinuousRenderer()](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-renderers-size.html#createContinuousRenderer)
+   * @param rendererResult - The result object from the [createContinuousRenderer()](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/renderers/size/#createContinuousRenderer)
    *   method.
-   * @param histogramResult - The result histogram object from the [histogram()](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-statistics-histogram.html#histogram)
+   * @param histogramResult - The result histogram object from the [histogram()](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/histogram/#histogram)
    *   method.
    * @example
    * ```js
@@ -387,23 +368,23 @@ export abstract class ArcgisSliderSizeLegacy extends LitElement {
    */
   updateFromRendererResult(rendererResult: ContinuousRendererResult, histogramResult?: HistogramResult): void;
   /**
-   * A convenience function used to update the [SizeVariable](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-SizeVariable.html)
-   * to match the values of the [stops](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-smartMapping-SizeSlider.html#stops) on the slider.
+   * A convenience function used to update the [SizeVariable](https://developers.arcgis.com/javascript/latest/references/core/renderers/visualVariables/SizeVariable/)
+   * to match the values of the [stops](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#stops) on the slider.
    * The slider stops are automatically updated internally when the user drags a thumb slider.
    *
    * This is particularly useful for Size visual variables that have a set
-   * [minDataValue](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-SizeVariable.html#minDataValue) and
-   * [maxDataValue](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-SizeVariable.html#minDataValue).
+   * [minDataValue](https://developers.arcgis.com/javascript/latest/references/core/renderers/visualVariables/SizeVariable/#minDataValue) and
+   * [maxDataValue](https://developers.arcgis.com/javascript/latest/references/core/renderers/visualVariables/SizeVariable/#minDataValue).
    * This method will properly reconstruct the variable to set on the renderer so it matches the stops on the slider.
    *
    * @param sizeVariable - The size visual variable
-   *   from the renderer to update to the set [stops](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-smartMapping-SizeSlider.html#stops) on the slider.
+   *   from the renderer to update to the set [stops](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/#stops) on the slider.
    * @returns Returns the updated visual variable
    *   to set back on the renderer.
    * @example
    * ```js
    * const renderer = featureLayer.renderer?.clone();
-   * const sizeVariable = renderer.visualVariables[0] as __esri.SizeVariable;
+   * const sizeVariable = renderer.visualVariables[0];
    * const updatedSizeVariable = sizeSlider.updateVisualVariable(sizeVariable);
    * ```
    */

package/dist/components/arcgis-slider-size-legacy/customElement.js

@@ -12,7 +12,7 @@ class _ extends l {
     super(...arguments), this.widget = h(this), this.viewModel = this.widget.viewModel, this.label = this.widget.label, this.autoDestroyDisabled = !1, this.histogramConfig = this.widget.histogramConfig, this.icon = this.widget.icon, this.inputFormatFunction = this.widget.inputFormatFunction, this.inputParseFunction = this.widget.inputParseFunction, this.labelFormatFunction = this.widget.labelFormatFunction, this.max = this.widget.max, this.min = this.widget.min, this.precision = this.widget.precision, this.sliderStyle = this.widget.style, this.state = this.widget.state, this.stops = this.widget.stops, this.zoomOptions = this.widget.zoomOptions, this.arcgisPropertyChange = d()("histogramConfig", "max", "min", "precision", "sliderStyle", "state", "stops", "zoomOptions"), this.arcgisReady = a(), this.arcgisThumbChange = i(() => this.widget, "thumb-change"), this.arcgisThumbDrag = i(() => this.widget, "thumb-drag");
   }
   static {
-    this.properties = { label: 16, autoDestroyDisabled: 5, histogramConfig: 0, icon: 1, inputFormatFunction: 0, inputParseFunction: 0, labelFormatFunction: 0, max: 9, min: 9, precision: 9, referenceElement: 1, sliderStyle: 0, state: 1, stops: 0, zoomOptions: 0 };
+    this.properties = { label: 16, autoDestroyDisabled: 5, histogramConfig: 0, icon: 1, inputFormatFunction: 0, inputParseFunction: 0, labelFormatFunction: 0, max: 9, min: 9, precision: 9, referenceElement: 1, sliderStyle: 0, state: 32, stops: 0, zoomOptions: 0 };
   }
   static {
     this.styles = c;

package/dist/components/arcgis-snapping-controls/customElement.d.ts

@@ -1,8 +1,7 @@
 /// <reference path="../../index.d.ts" />
 import type SnappingOptions from "@arcgis/core/views/interactive/snapping/SnappingOptions.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 { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { SnappingControlsViewModelState } from "@arcgis/core/widgets/support/SnappingControls/SnappingControlsViewModel.js";
@@ -18,29 +17,77 @@ export abstract class ArcgisSnappingControls extends LitElement {
    * @default false
    */
   accessor autoDestroyDisabled: boolean;
-  /** @default false */
+  /**
+   * Controls display of the "Enable snapping" toggle.
+   *
+   * @default false
+   */
   accessor hideEnabledToggle: boolean;
-  /** @default false */
+  /**
+   * Controls display of the "Feature to feature" toggle. This controls feature snapping.
+   *
+   * @default false
+   */
   accessor hideFeatureEnabledToggle: boolean;
-  /** @default false */
+  /**
+   * Controls display of the [arcgis-grid-controls](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-grid-controls/).
+   *
+   * @default false
+   */
   accessor hideGridControls: boolean;
-  /** @default false */
+  /**
+   * Controls display of the buttons to change the color of the grid.
+   *
+   * @default false
+   */
   accessor hideGridControlsElementsColorSelection: boolean;
-  /** @default false */
+  /**
+   * Controls display of the toggle that modifies [dynamicScaling](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-grid-controls/#dynamicScaling).
+   *
+   * @default false
+   */
   accessor hideGridControlsElementsDynamicScaleToggle: boolean;
-  /** @default false */
+  /**
+   * Controls display of the line interval input. The input sets the interval between major grid lines.
+   *
+   * @default false
+   */
   accessor hideGridControlsElementsLineIntervalInput: boolean;
-  /** @default false */
+  /**
+   * Controls display of the numeric inputs that allow for setting grid spacing and rotation
+   *
+   * @default false
+   */
   accessor hideGridControlsElementsNumericInputs: boolean;
-  /** @default false */
+  /**
+   * Controls display of the out of scale warning. This warning is displayed when the grid is not shown because it would be too small at the current scale and dynamic scaling is disabled.
+   *
+   * @default false
+   */
   accessor hideGridControlsElementsOutOfScaleWarning: boolean;
-  /** @default false */
+  /**
+   * Controls display of the grid placement buttons. These buttons allow the user to start interactive configuration of the grid.
+   *
+   * @default false
+   */
   accessor hideGridControlsElementsPlacementButtons: boolean;
-  /** @default false */
+  /**
+   * Controls display of the "Rotate grid with map" toggle. This toggle controls whether the grid rotates with the map.
+   *
+   * @default false
+   */
   accessor hideGridControlsElementsRotateWithMapToggle: boolean;
-  /** @default false */
+  /**
+   * Controls display of the "Snapping layers" dropdown. The list displays the available layers to configure snapping.
+   *
+   * @default false
+   */
   accessor hideLayerList: boolean;
-  /** @default false */
+  /**
+   * Controls display of the “Geometry guides” toggle. This toggle controls the self-snapping configuration which handles showing right-angle and parallel line indicators while constructing or modifying geometries.
+   *
+   * @default false
+   */
   accessor hideSelfEnabledToggle: boolean;
   /**
    * Icon which represents the component.
@@ -64,10 +111,23 @@ export abstract class ArcgisSnappingControls extends LitElement {
    * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
-  /** @default false */
+  /**
+   * Controls display of the "Enable grid" toggle. This toggle controls whether the grid is displayed.
+   *
+   * @default false
+   */
   accessor showGridControlsElementsGridEnabledToggle: boolean;
-  /** @default false */
+  /**
+   * Controls display of the header
+   *
+   * @default false
+   */
   accessor showHeader: boolean;
+  /**
+   * The [SnappingOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/snapping/SnappingOptions/)
+   * that will be controlled by this component if the snapping toggle is enabled for display.
+   * If SnappingOptions are provided, grid display will be automatically enabled or disabled to match snapping state.
+   */
   accessor snappingOptions: SnappingOptions;
   /**
    * The current state of the component.