@arcgis/core 5.2.0-next.136 → 5.2.0-next.138

package/widgets/Slider/types.d.ts

@@ -3,6 +3,7 @@ import type { LabelFormatFunction } from "../types.js";
 /**
  * Represents the effective bounds of the slider.
  *
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
  * @since 5.0
  */
 export interface Bounds {
@@ -23,6 +24,7 @@ export interface Bounds {
 /**
  * Label infos for the slider.
  *
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
  * @since 5.0
  */
 export interface LabelInfos {
@@ -46,10 +48,16 @@ export interface LabelInfos {
   values: (string | null | undefined)[];
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export type InputType = "max" | "min" | "thumb";
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export type SliderTickMode = "count" | "percent" | "step" | "position";
 
 /**
@@ -64,6 +72,7 @@ export type SliderTickMode = "count" | "percent" | "step" | "position";
  * @param labelElement - The HTMLElement representing the label of the tick. You can add or modify the default
  *   style of the tick's labels by adding CSS classes to this element. You can also add custom behavior to tick labels by attaching
  *   event listeners to individual elements.
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
  * @since 5.0
  */
 export type TickCreatedFunction = (value: number, tickElement?: HTMLElement | null, labelElement?: HTMLElement | null) => void;
@@ -80,6 +89,7 @@ export type TickCreatedFunction = (value: number, tickElement?: HTMLElement | nu
  * @param labelElement - The HTMLElement representing the label of the thumb. You can add or modify the default
  *   style of the thumb's labels by adding CSS classes to this element. You can also add custom behavior to thumb labels by attaching
  *   event listeners to individual elements.
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
  * @since 5.0
  */
 export type ThumbCreatedFunction = (index: number, value: number, thumbElement: HTMLElement, labelElement?: HTMLElement | null) => void;
@@ -94,6 +104,7 @@ export type ThumbCreatedFunction = (index: number, value: number, thumbElement:
  *   the `type` and `pattern` attributes.
  * @param type - The type of input created.
  * @param thumbIndex - The index of the thumb corresponding to the input element.
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
  * @since 5.0
  */
 export type InputCreatedFunction = (inputElement: HTMLInputElement, type: InputType, thumbIndex?: number | null) => void;
@@ -102,6 +113,7 @@ export type InputCreatedFunction = (inputElement: HTMLInputElement, type: InputT
  * Object specification for configuring ticks on the slider. An array of these objects should be set on the
  * [Slider.tickConfigs](https://developers.arcgis.com/javascript/latest/references/core/widgets/Slider/#tickConfigs) property.
  *
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
  * @since 5.0
  * @example
  * // places 25 ticks on the slider track
@@ -212,7 +224,10 @@ export interface TickConfig {
   labelFormatFunction?: LabelFormatFunction;
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export interface MaxChangeEvent {
   /**
    * The former [Slider.max](https://developers.arcgis.com/javascript/latest/references/core/widgets/Slider/#max) value (or bound) of the slider.
@@ -234,7 +249,10 @@ export interface MaxChangeEvent {
   value: number;
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export interface MinChangeEvent {
   /**
    * The former [Slider.min](https://developers.arcgis.com/javascript/latest/references/core/widgets/Slider/#min) value (or bound) of the slider.
@@ -256,7 +274,10 @@ export interface MinChangeEvent {
   value: number;
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export interface MaxClickEvent {
   /**
    * The type of the event.
@@ -272,7 +293,10 @@ export interface MaxClickEvent {
   value: number;
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export interface MinClickEvent {
   /**
    * The type of the event.
@@ -288,7 +312,10 @@ export interface MinClickEvent {
   value: number;
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export interface ThumbClickEvent {
   /**
    * The 0-based index of the thumb.
@@ -310,7 +337,10 @@ export interface ThumbClickEvent {
   value: number;
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export interface ThumbChangeEvent {
   /**
    * The 0-based index of the updated thumb position.
@@ -338,7 +368,10 @@ export interface ThumbChangeEvent {
   value: number;
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export interface ThumbDragEvent {
   /**
    * The 0-based index of the updated thumb position.
@@ -366,7 +399,10 @@ export interface ThumbDragEvent {
   value: number;
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export interface TickClickEvent {
   /**
    * The approximate value that the tick represents on the slider track.
@@ -394,7 +430,10 @@ export interface TickClickEvent {
   groupIndex: number;
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export interface TrackClickEvent {
   /**
    * The approximate value of the slider at the location of the click event.
@@ -410,7 +449,10 @@ export interface TrackClickEvent {
   type: "track-click";
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export interface SegmentClickEvent {
   /**
    * The 1-based index of the segment on the slider.
@@ -441,7 +483,10 @@ export interface SegmentClickEvent {
   value: number;
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
+ * @since 5.0
+ */
 export interface SegmentDragEvent {
   /**
    * The 1-based index of the segment in the slider.

package/widgets/Slider.d.ts

@@ -7,6 +7,7 @@ import type { WidgetProperties } from "./Widget.js";
 import type { InputCreatedFunction, LabelInfos, MaxClickEvent, MinClickEvent, SegmentClickEvent, SegmentDragEvent, ThumbChangeEvent, ThumbClickEvent, ThumbCreatedFunction, ThumbDragEvent, TrackClickEvent, TickConfig, MaxChangeEvent, MinChangeEvent, TickClickEvent } from "./Slider/types.js";
 import type { SliderViewModelProperties } from "./Slider/SliderViewModel.js";
 
+/** @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead. */
 export interface SliderProperties extends WidgetProperties, Partial<Pick<Slider, "disabled" | "draggableSegmentsEnabled" | "effectiveMax" | "effectiveMin" | "inputCreatedFunction" | "inputFormatFunction" | "inputParseFunction" | "labelFormatFunction" | "labelInputsEnabled" | "layout" | "max" | "min" | "precision" | "rangeLabelInputsEnabled" | "snapOnClickEnabled" | "steps" | "syncedSegmentsEnabled" | "thumbCreatedFunction" | "thumbsConstrained" | "tickConfigs" | "values" | "visibleElements">> {
   /**
    * Icon displayed in the widget's button.
@@ -34,13 +35,16 @@ export interface SliderProperties extends WidgetProperties, Partial<Pick<Slider,
   viewModel?: SliderViewModelProperties;
 }
 
+/** @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead. */
 export type SliderLayout = "vertical" | "vertical-reversed" | "horizontal" | "horizontal-reversed";
 
+/** @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead. */
 export type SliderState = "disabled" | "ready" | "dragging" | "editing";
 
 /**
  * The HTML Element nodes representing a single slider tick and its associated label.
  *
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
  * @since 4.20
  */
 export interface TickElementGroup {
@@ -192,6 +196,8 @@ export interface SliderEvents extends CommonSliderEvents {
  * The visible elements that are displayed within the widget.
  * This provides the ability to turn individual elements of the widget's display on/off.
  * Alternatively, developers may also use CSS (e.g. `display: none`) to show/hide elements, such as labels.
+ *
+ * @deprecated since version 5.2. Use the [Slider component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/) instead.
  */
 export interface VisibleElements {
   /**

package/widgets/smartMapping/BinaryColorSizeSlider/BinaryColorSizeSliderViewModel.d.ts

@@ -2,11 +2,13 @@ import type SizeStop from "../../../renderers/visualVariables/support/SizeStop.j
 import type SizeSliderViewModel from "../SizeSlider/SizeSliderViewModel.js";
 import type { SizeSliderViewModelProperties } from "../SizeSlider/SizeSliderViewModel.js";
 
+/** @deprecated since version 5.2. Use the [Slider Binary Color Size](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-binary-color-size-legacy/) component instead. */
 export interface BinaryColorSizeSliderViewModelProperties extends SizeSliderViewModelProperties {}
 
 /**
  * Provides the logic for the [BinaryColorSizeSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/BinaryColorSizeSlider/) widget.
  *
+ * @deprecated since version 5.2. Use the [Slider Binary Color Size](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-binary-color-size-legacy/) component instead.
  * @since 4.28
  * @see [BinaryColorSizeSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/BinaryColorSizeSlider/)
  */

package/widgets/smartMapping/ClassedColorSlider/ClassedColorSliderViewModel.d.ts

@@ -2,11 +2,13 @@ import type SmartMappingSliderViewModel from "../SmartMappingSliderViewModel.js"
 import type { SmartMappingSupportedStop, GradientStopInfo, ColorBreak } from "../types.js";
 import type { SmartMappingSliderViewModelProperties } from "../SmartMappingSliderViewModel.js";
 
+/** @deprecated since version 5.2. Use the [Slider Classed Color](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-classed-color-legacy/) component instead. */
 export interface ClassedColorSliderViewModelProperties extends SmartMappingSliderViewModelProperties, Partial<Pick<ClassedColorSliderViewModel, "breaks">> {}
 
 /**
  * Provides the logic for the [ClassedColorSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/ClassedColorSlider/) widget.
  *
+ * @deprecated since version 5.2. Use the [Slider Classed Color](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-classed-color-legacy/) component instead.
  * @since 4.12
  * @see [ClassedColorSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/ClassedColorSlider/)
  */

package/widgets/smartMapping/ClassedSizeSlider/ClassedSizeSliderViewModel.d.ts

@@ -2,11 +2,13 @@ import type SmartMappingSliderViewModel from "../SmartMappingSliderViewModel.js"
 import type { SmartMappingSupportedStop, SizeBreak } from "../types.js";
 import type { SmartMappingSliderViewModelProperties } from "../SmartMappingSliderViewModel.js";
 
+/** @deprecated since version 5.2. Use the [Slider Classed Size](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-classed-size-legacy/) component instead. */
 export interface ClassedSizeSliderViewModelProperties extends SmartMappingSliderViewModelProperties, Partial<Pick<ClassedSizeSliderViewModel, "breaks">> {}
 
 /**
  * Provides the logic for the [ClassedSizeSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/ClassedSizeSlider/) widget.
  *
+ * @deprecated since version 5.2. Use the [Slider Classed Size](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-classed-size-legacy/) component instead.
  * @since 4.12
  * @see [ClassedSizeSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/ClassedSizeSlider/)
  */

package/widgets/smartMapping/ColorSizeSlider/ColorSizeSliderViewModel.d.ts

@@ -3,6 +3,7 @@ import type SizeSliderViewModel from "../SizeSlider/SizeSliderViewModel.js";
 import type { GradientStopInfo } from "../types.js";
 import type { SizeSliderViewModelProperties } from "../SizeSlider/SizeSliderViewModel.js";
 
+/** @deprecated since version 5.2. Use the [Slider Color Size](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-color-size-legacy/) component instead. */
 export interface ColorSizeSliderViewModelProperties extends SizeSliderViewModelProperties {
   /**
    * The colors and sizes corresponding with data values in the
@@ -43,6 +44,7 @@ export interface ColorSizeSliderViewModelProperties extends SizeSliderViewModelP
 /**
  * Provides the logic for the [ColorSizeSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/ColorSizeSlider/) widget.
  *
+ * @deprecated since version 5.2. Use the [Slider Color Size](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-color-size-legacy/) component instead.
  * @since 4.12
  * @see [ColorSizeSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/ColorSizeSlider/)
  */

package/widgets/smartMapping/ColorSlider/ColorSliderViewModel.d.ts

@@ -3,11 +3,13 @@ import type SmartMappingPrimaryHandleSliderViewModel from "../SmartMappingPrimar
 import type { GradientStopInfo } from "../types.js";
 import type { SmartMappingPrimaryHandleSliderViewModelProperties } from "../SmartMappingPrimaryHandleSliderViewModel.js";
 
+/** @deprecated since version 5.2. Use the [Slider Color](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-color-legacy/) component instead. */
 export interface ColorSliderViewModelProperties extends SmartMappingPrimaryHandleSliderViewModelProperties, Partial<Pick<ColorSliderViewModel, "stops">> {}
 
 /**
  * Provides the logic for the [ColorSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/ColorSlider/) widget.
  *
+ * @deprecated since version 5.2. Use the [Slider Color](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-color-legacy/) component instead.
  * @since 4.12
  * @see [ColorSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/ColorSlider/)
  */

package/widgets/smartMapping/HeatmapSlider/HeatmapSliderViewModel.d.ts

@@ -4,11 +4,13 @@ import type SmartMappingSliderViewModel from "../SmartMappingSliderViewModel.js"
 import type { GradientStopInfo } from "../types.js";
 import type { SmartMappingSliderViewModelProperties } from "../SmartMappingSliderViewModel.js";
 
+/** @deprecated since version 5.2. Use the [Slider Heatmap](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-heatmap-legacy/) component instead. */
 export interface HeatmapSliderViewModelProperties extends SmartMappingSliderViewModelProperties, Partial<Pick<HeatmapSliderViewModel, "stops">> {}
 
 /**
  * Provides the logic for the [HeatmapSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/HeatmapSlider/) widget.
  *
+ * @deprecated since version 5.2. Use the [Slider Heatmap](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-heatmap-legacy/) component instead.
  * @since 4.12
  * @see [HeatmapSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/HeatmapSlider/)
  */

package/widgets/smartMapping/OpacitySlider/OpacitySliderViewModel.d.ts

@@ -4,11 +4,13 @@ import type SmartMappingSliderViewModel from "../SmartMappingSliderViewModel.js"
 import type { GradientStopInfo } from "../types.js";
 import type { SmartMappingSliderViewModelProperties } from "../SmartMappingSliderViewModel.js";
 
+/** @deprecated since version 5.2. Use the [Slider Opacity](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-opacity-legacy/) component instead. */
 export interface OpacitySliderViewModelProperties extends SmartMappingSliderViewModelProperties, Partial<Pick<OpacitySliderViewModel, "stops">> {}
 
 /**
  * Provides the logic for the [OpacitySlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/OpacitySlider/) widget.
  *
+ * @deprecated since version 5.2. Use the [Slider Opacity](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-opacity-legacy/) component instead.
  * @since 4.12
  * @see [OpacitySlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/OpacitySlider/)
  */

package/widgets/smartMapping/SizeSlider/SizeSliderViewModel.d.ts

@@ -3,13 +3,16 @@ import type SizeStop from "../../../renderers/visualVariables/support/SizeStop.j
 import type SmartMappingPrimaryHandleSliderViewModel from "../SmartMappingPrimaryHandleSliderViewModel.js";
 import type { SmartMappingPrimaryHandleSliderViewModelProperties } from "../SmartMappingPrimaryHandleSliderViewModel.js";
 
+/** @deprecated since version 5.2. Use the [Slider Size](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/) component instead. */
 export interface SizeSliderViewModelProperties<StopType extends SupportedStops = SupportedStops> extends SmartMappingPrimaryHandleSliderViewModelProperties, Partial<Pick<SizeSliderViewModel<StopType>, "persistSizeRangeEnabled" | "stops">> {}
 
+/** @deprecated since version 5.2. Use the [Slider Size](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/) component instead. */
 export type SupportedStops = SizeStop | ColorSizeStop;
 
 /**
  * Provides the logic for the [SizeSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/SizeSlider/) widget.
  *
+ * @deprecated since version 5.2. Use the [Slider Size](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-size-legacy/) component instead.
  * @since 4.12
  * @see [SizeSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/SizeSlider/)
  */

package/widgets/smartMapping/SmartMappingPrimaryHandleSliderViewModel.d.ts

@@ -2,11 +2,13 @@ import type SmartMappingSliderViewModel from "./SmartMappingSliderViewModel.js";
 import type { SupportedBreaks, SmartMappingSupportedStop } from "./types.js";
 import type { SmartMappingSliderViewModelProperties } from "./SmartMappingSliderViewModel.js";
 
+/** @deprecated since version 5.2. Use the appropriate smart mapping slider component instead. */
 export interface SmartMappingPrimaryHandleSliderViewModelProperties<StopType extends SmartMappingSupportedStop = SmartMappingSupportedStop> extends SmartMappingSliderViewModelProperties, Partial<Pick<SmartMappingPrimaryHandleSliderViewModel<StopType>, "handlesSyncedToPrimary" | "primaryHandleEnabled">> {}
 
 /**
  * Shared properties for sliders that have a [primaryHandle](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/SmartMappingPrimaryHandleSliderViewModel/#primaryHandleEnabled) option.
  *
+ * @deprecated since version 5.2. Use the appropriate smart mapping slider component instead.
  * @since 4.18
  * @see [SmartMappingSliderBase](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/SmartMappingSliderBase/)
  * @see [Programming patterns: Widget viewModel pattern](https://developers.arcgis.com/javascript/latest/programming-patterns/#widget-viewmodel-pattern)

package/widgets/smartMapping/SmartMappingSliderViewModel.d.ts

@@ -4,6 +4,7 @@ import type { LabelInfos } from "../Slider/types.js";
 import type { SmartMappingSupportedStop, ZoomOptions, ViewModelState } from "./types.js";
 import type { SliderViewModelProperties } from "../Slider/SliderViewModel.js";
 
+/** @deprecated since version 5.2. Use the appropriate smart mapping slider component instead. */
 export interface SmartMappingSliderViewModelProperties<StopType extends SmartMappingSupportedStop = SmartMappingSupportedStop, BreakType extends any = any> extends SliderViewModelProperties, Partial<Pick<SmartMappingSliderViewModel<StopType, BreakType>, "zoomingEnabled" | "zoomOptions">> {
   /**
    * A function used to format user inputs. As opposed to [labelFormatFunction](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/SmartMappingSliderViewModel/#labelFormatFunction), which formats
@@ -140,6 +141,7 @@ export interface SmartMappingSliderViewModelProperties<StopType extends SmartMap
 /**
  * Provides the shared base logic for the [smart mapping slider](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/SmartMappingSliderBase/) view models.
  *
+ * @deprecated since version 5.2. Use the appropriate smart mapping slider component instead.
  * @since 4.14
  * @see [SmartMappingSliderBase](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/SmartMappingSliderBase/)
  * @see [Programming patterns: Widget viewModel pattern](https://developers.arcgis.com/javascript/latest/programming-patterns/#widget-viewmodel-pattern)

package/widgets/smartMapping/types.d.ts

@@ -7,19 +7,34 @@ import type SizeStop from "../../renderers/visualVariables/support/SizeStop.js";
 import type { HistogramBin } from "../../smartMapping/statistics/types.js";
 import type { BarCreatedFunction, DataLineInfos, DataLineCreatedFunction } from "../Histogram/types.js";
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the appropriate smart mapping slider component instead.
+ * @since 5.0
+ */
 export type VisualVariableStop = ColorSizeStop | ColorStop | SizeStop | OpacityStop;
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the appropriate smart mapping slider component instead.
+ * @since 5.0
+ */
 export type SmartMappingSupportedStop = VisualVariableStop | HeatmapColorStop;
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the appropriate smart mapping slider component instead.
+ * @since 5.0
+ */
 export type SupportedBreaks = ColorBreak | SizeBreak;
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the appropriate smart mapping slider component instead.
+ * @since 5.0
+ */
 export type ViewModelState = "disabled" | "ready";
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the appropriate smart mapping slider component instead.
+ * @since 5.0
+ */
 export interface ZoomOptions {
   /**
    * The upper bound of the zoom.
@@ -38,6 +53,7 @@ export interface ZoomOptions {
 /**
  * Configuration options for defining the slider's [Histogram](https://developers.arcgis.com/javascript/latest/references/core/widgets/Histogram/).
  *
+ * @deprecated since version 5.2. Use the appropriate smart mapping slider component instead.
  * @since 5.0
  */
 export interface HistogramConfig {
@@ -102,6 +118,7 @@ export interface HistogramConfig {
 /**
  * The return object of the `getStopInfo()` and `getColorStopInfo()` methods.
  *
+ * @deprecated since version 5.2. Use the appropriate smart mapping slider component instead.
  * @since 5.0
  */
 export interface GradientStopInfo {
@@ -119,7 +136,10 @@ export interface GradientStopInfo {
   offset: number;
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the appropriate smart mapping slider component instead.
+ * @since 5.0
+ */
 export interface ColorBreak {
   /**
    * Features with values within the provided `min`
@@ -144,7 +164,10 @@ export interface ColorBreak {
   min: number;
 }
 
-/** @since 5.0 */
+/**
+ * @deprecated since version 5.2. Use the appropriate smart mapping slider component instead.
+ * @since 5.0
+ */
 export interface SizeBreak {
   /**
    * The size in points of the symbol representing features with values within

package/widgets/support/FilterBuilder/FilterBuilderViewModel.d.ts

@@ -1,9 +1,9 @@
 import type Accessor from "../../../core/Accessor.js";
 import type Collection from "../../../core/Collection.js";
 import type FilterConditionViewModel from "../FilterCondition/FilterConditionViewModel.js";
-import type { FieldValue } from "../../../layers/support/fieldUtils.js";
 import type { AssociationsLayerUnion } from "../../BatchAttributeForm/types.js";
-import type { ConditionOperatorName, OperatorName, OperatorNamesByFieldType } from "../FilterCondition/types.js";
+import type { AddConditionParameters } from "./types.js";
+import type { ConditionOperatorName, OperatorNamesByFieldType } from "../FilterCondition/types.js";
 
 /**
  * Properties for the FilterBuilderViewModel.
@@ -72,29 +72,39 @@ export default class FilterBuilderViewModel extends Accessor {
   /**
    * Adds a new condition with the provided parameters.
    *
-   * @param config - The configuration for the new condition.
+   * @param params - The configuration parameters for the new condition.
    * @param index - The index at which to insert the new condition. If not provided, the condition is added to the end.
    * @internal
    */
-  addCondition(config?: {
-      fieldName?: string | null | undefined;
-      operator?: OperatorName;
-      value?: FieldValue;
-  }, index?: number): void;
+  addCondition(params?: AddConditionParameters, index?: number): void;
   /**
    * Duplicates a specified condition.
    *
+   * @param viewModel - The view model to duplicate a condition for.
+   * @internal
+   */
+  duplicateCondition(viewModel: FilterConditionViewModel): void;
+  /**
+   * Duplicates a specified condition by index.
+   *
    * @param index - The index of the condition to duplicate.
    * @internal
    */
-  duplicateCondition(index: number): void;
+  duplicateConditionByIndex(index: number): void;
+  /**
+   * Removes a specific condition. If a view model is not provided, the last condition is removed.
+   *
+   * @param viewModel - The view model to remove.
+   * @internal
+   */
+  removeCondition(viewModel: FilterConditionViewModel): void;
   /**
-   * Removes a specific condition. If an index is not provided, the last condition is removed.
+   * Removes a specific condition by index. If an index is not provided, the last condition is removed.
    *
    * @param index - The index of the condition to remove. If not provided, the last condition is removed.
    * @internal
    */
-  removeCondition(index?: number): void;
+  removeConditionByIndex(index?: number): void;
   /**
    * Removes all conditions.
    *

package/widgets/support/FilterBuilder/FilterBuilderViewModel.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"../../../core/Accessor.js";import{isSome as n}from"../../../core/arrayUtils.js";import r from"../../../core/Collection.js";import{watch as i,initial as a}from"../../../core/reactiveUtils.js";import{property as o,subclass as s}from"../../../core/accessorSupport/decorators.js";import{defaultOperatorNamesByFieldType as c}from"../FilterCondition/conditionUtils.js";import l from"../FilterCondition/FilterConditionViewModel.js";let u=class extends t{constructor(e){super(e),this.conditionOperator=`AND`,this.conditionViewModels=new r,this.layer=null,this.operators=c}initialize(){this.addHandles([i(()=>this.layer,async e=>{e&&!e.loaded&&await e.load()},a)])}get count(){return this.conditionViewModels.length}get state(){let{layer:e}=this;return e?e.loaded?`ready`:`loading`:`disabled`}get whereClause(){let{conditionOperator:e,whereClauses:t}=this,n=``;return t.forEach((t,r)=>{n+=r>0?` ${e} (${t})`:`(${t})`}),n}get whereClauses(){return this.conditionViewModels.toArray().map(e=>e.whereClause).filter(n)}addCondition(e,t){let{layer:n,operators:r}=this;n&&this.conditionViewModels.add(new l({...e,layer:n,operators:r}),t)}duplicateCondition(e){let t=this.conditionViewModels.at(e);if(!t)return;let{fieldName:n,operator:r,value:i}=t;this.addCondition({fieldName:n,operator:r,value:i})}reset(){this.conditionViewModels.removeAll()}removeCondition(e){e==null?this.conditionViewModels.pop():this.conditionViewModels.splice(e,1)}};e([o()],u.prototype,`conditionOperator`,void 0),e([o()],u.prototype,`conditionViewModels`,void 0),e([o()],u.prototype,`count`,null),e([o()],u.prototype,`layer`,void 0),e([o()],u.prototype,`operators`,void 0),e([o()],u.prototype,`state`,null),e([o()],u.prototype,`whereClause`,null),e([o()],u.prototype,`whereClauses`,null),u=e([s(`esri.widgets.support.FilterBuilder.FilterBuilderViewModel`)],u);export{u as default};
+import{__decorate as e}from"tslib";import t from"../../../core/Accessor.js";import{isSome as n}from"../../../core/arrayUtils.js";import r from"../../../core/Collection.js";import{watch as i,syncAndInitial as a}from"../../../core/reactiveUtils.js";import{property as o,subclass as s}from"../../../core/accessorSupport/decorators.js";import{defaultOperatorNamesByFieldType as c}from"../FilterCondition/conditionUtils.js";import l from"../FilterCondition/FilterConditionViewModel.js";let u=class extends t{constructor(e){super(e),this.conditionOperator=`AND`,this.conditionViewModels=new r,this.layer=null,this.operators=c}initialize(){this.addHandles([i(()=>this.layer,async(e,t)=>{t&&this.reset(),await e?.load()},a)])}get count(){return this.conditionViewModels.length}get state(){let{layer:e}=this;return e?e.loaded?`ready`:`loading`:`disabled`}get whereClause(){let{conditionOperator:e,whereClauses:t}=this,n=``;return t.forEach((t,r)=>{n+=r>0?` ${e} (${t})`:`(${t})`}),n}get whereClauses(){return this.conditionViewModels.toArray().map(e=>e.whereClause).filter(n)}addCondition(e,t){let{layer:n,operators:r}=this;n&&this.conditionViewModels.add(new l({layer:n,operators:r,...e}),t)}duplicateCondition(e){let{fieldName:t,operator:n,value:r}=e;this.addCondition({fieldName:t,operator:n,value:r})}duplicateConditionByIndex(e){let t=this.conditionViewModels.at(e);if(!t)return;let{fieldName:n,operator:r,value:i}=t;this.addCondition({fieldName:n,operator:r,value:i})}reset(){this.conditionViewModels.removeAll()}removeCondition(e){if(e==null)this.conditionViewModels.pop();else{let t=this.conditionViewModels.indexOf(e);t>-1&&this.conditionViewModels.splice(t,1)}}removeConditionByIndex(e){e==null?this.conditionViewModels.pop():this.conditionViewModels.splice(e,1)}};e([o()],u.prototype,`conditionOperator`,void 0),e([o()],u.prototype,`conditionViewModels`,void 0),e([o()],u.prototype,`count`,null),e([o()],u.prototype,`layer`,void 0),e([o()],u.prototype,`operators`,void 0),e([o()],u.prototype,`state`,null),e([o()],u.prototype,`whereClause`,null),e([o()],u.prototype,`whereClauses`,null),u=e([s(`esri.widgets.support.FilterBuilder.FilterBuilderViewModel`)],u);export{u as default};

package/widgets/support/FilterBuilder/types.d.ts

@@ -0,0 +1,28 @@
+import type { FieldValue } from "../../../layers/support/fieldUtils.js";
+import type { OperatorName } from "../FilterCondition/types.js";
+
+/**
+ * Configuration parameters for adding a new condition to the FilterBuilder.
+ *
+ * @internal
+ */
+export interface AddConditionParameters {
+  /**
+   * The name of the field to be used in the new condition.
+   *
+   * @internal
+   */
+  fieldName?: string | null;
+  /**
+   * The operator to be used in the new condition.
+   *
+   * @internal
+   */
+  operator?: OperatorName;
+  /**
+   * The value to be used in the new condition. Only applies to operators that require a value.
+   *
+   * @internal
+   */
+  value?: FieldValue;
+}

package/widgets/support/FilterBuilder.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"../../core/Collection.js";import{on as n}from"../../core/reactiveUtils.js";import{property as r,cast as i,subclass as a}from"../../core/accessorSupport/decorators.js";import o from"../Widget.js";import{loadCalciteComponents as s}from"./componentsUtils.js";import c from"./FilterCondition.js";import{tsx as l,messageBundle as u}from"./widget.js";import d from"./FilterBuilder/FilterBuilderViewModel.js";const f={fab:!0,menu:!0},p=`esri-filter-builder`,m={base:p,conditionContainer:`${p}__condition-container`,operatorSelect:`${p}__operator-select`};let h=class extends o{constructor(e,n){super(e,n),this._conditionWidgets=new t,this.messages=null,this.messagesCommon=null,this.viewModel=new d,this.visibleElements={...f}}loadDependencies(){return s({action:()=>import(`@esri/calcite-components/dist/components/calcite-action`),"action-menu":()=>import(`@esri/calcite-components/dist/components/calcite-action-menu`),block:()=>import(`@esri/calcite-components/dist/components/calcite-block`),fab:()=>import(`@esri/calcite-components/dist/components/calcite-fab`),option:()=>import(`@esri/calcite-components/dist/components/calcite-option`),select:()=>import(`@esri/calcite-components/dist/components/calcite-select`)})}initialize(){this.addHandles([n(()=>this.viewModel.conditionViewModels,`change`,({added:e,removed:t})=>{let n=this._conditionWidgets;t.forEach(e=>{let t=n.find(t=>t.viewModel===e);t&&(n.remove(t),t.destroy())}),e.forEach(e=>n.add(new c({viewModel:e})))})])}destroy(){this._conditionWidgets.drain(e=>!e.destroyed&&e.destroy())}get conditionOperator(){return this.viewModel.conditionOperator}set conditionOperator(e){this.viewModel.conditionOperator=e}get count(){return this.viewModel.count}get layer(){return this.viewModel.layer}set layer(e){this.viewModel.layer=e}get operators(){return this.viewModel.operators}set operators(e){this.viewModel.operators=e}get state(){return this.viewModel.state}castVisibleElements(e){return{...f,...e}}get whereClause(){return this.viewModel.whereClause}get whereClauses(){return this.viewModel.whereClauses}render(){return l(`div`,{class:m.base},this._renderOperatorSelect(),this._renderConditions(),this._renderFAB())}reset(){this.viewModel.reset()}_renderOperatorSelect(){if(this.count<2)return;let{conditionOperator:e,messages:t}=this,n=e===`AND`;return l(`div`,{class:m.operatorSelect},l(`calcite-select`,{label:t.condition,width:`full`,onCalciteSelectChange:({currentTarget:e})=>{this.conditionOperator=e.value}},l(`calcite-option`,{label:t.allAreTrue,selected:n,value:`AND`}),l(`calcite-option`,{label:t.anyAreTrue,selected:!n,value:`OR`})))}_renderConditions(){return this._conditionWidgets.toArray().map((e,t)=>this._renderConditionContainer(e,t))}_renderConditionContainer(e,t){return l(`calcite-block`,{class:m.conditionContainer,expanded:!0,heading:this.messages.condition},e.render(),this._renderConditionMenu(t))}_renderFAB(){if(!this.visibleElements.fab)return;let e=this.state===`loading`;return l(`calcite-fab`,{appearance:`outline-fill`,disabled:e,icon:`plus`,kind:`neutral`,loading:e,text:this.messages.addNew,textEnabled:!0,onclick:()=>this.viewModel.addCondition()})}_renderConditionMenu(e){if(!this.visibleElements.menu)return;let{messages:t}=this;return l(`calcite-action-menu`,{label:t.moreOptions,overlayPositioning:`fixed`,placement:`bottom-end`,slot:`control`},l(`calcite-action`,{text:t.delete,textEnabled:!0,onclick:()=>this.viewModel.removeCondition(e)}),l(`calcite-action`,{text:t.duplicate,textEnabled:!0,onclick:()=>this.viewModel.duplicateCondition(e)}))}};e([r()],h.prototype,`_conditionWidgets`,void 0),e([r()],h.prototype,`conditionOperator`,null),e([r()],h.prototype,`count`,null),e([r()],h.prototype,`layer`,null),e([r(),u(`esri/widgets/support/FilterBuilder/t9n/FilterBuilder`)],h.prototype,`messages`,void 0),e([r(),u(`esri/t9n/common`)],h.prototype,`messagesCommon`,void 0),e([r()],h.prototype,`operators`,null),e([r()],h.prototype,`state`,null),e([r()],h.prototype,`viewModel`,void 0),e([r()],h.prototype,`visibleElements`,void 0),e([i(`visibleElements`)],h.prototype,`castVisibleElements`,null),e([r()],h.prototype,`whereClause`,null),e([r()],h.prototype,`whereClauses`,null),h=e([a(`esri.widgets.support.FilterBuilder`)],h);export{h as default};
+import{__decorate as e}from"tslib";import t from"../../core/Collection.js";import{on as n}from"../../core/reactiveUtils.js";import{property as r,cast as i,subclass as a}from"../../core/accessorSupport/decorators.js";import o from"../Widget.js";import{loadCalciteComponents as s}from"./componentsUtils.js";import c from"./FilterCondition.js";import{tsx as l,messageBundle as u}from"./widget.js";import d from"./FilterBuilder/FilterBuilderViewModel.js";const f={fab:!0,menu:!0},p=`esri-filter-builder`,m={base:p,conditionContainer:`${p}__condition-container`,operatorSelect:`${p}__operator-select`};let h=class extends o{constructor(e,n){super(e,n),this._conditionWidgets=new t,this.messages=null,this.messagesCommon=null,this.viewModel=new d,this.visibleElements={...f}}loadDependencies(){return s({action:()=>import(`@esri/calcite-components/dist/components/calcite-action`),"action-menu":()=>import(`@esri/calcite-components/dist/components/calcite-action-menu`),block:()=>import(`@esri/calcite-components/dist/components/calcite-block`),fab:()=>import(`@esri/calcite-components/dist/components/calcite-fab`),option:()=>import(`@esri/calcite-components/dist/components/calcite-option`),select:()=>import(`@esri/calcite-components/dist/components/calcite-select`)})}initialize(){this.addHandles([n(()=>this.viewModel.conditionViewModels,`change`,({added:e,removed:t})=>{let n=this._conditionWidgets;t.forEach(e=>{let t=n.find(t=>t.viewModel===e);t&&(n.remove(t),t.destroy())}),e.forEach(e=>n.add(new c({viewModel:e})))})])}destroy(){this._conditionWidgets.drain(e=>!e.destroyed&&e.destroy())}get conditionOperator(){return this.viewModel.conditionOperator}set conditionOperator(e){this.viewModel.conditionOperator=e}get count(){return this.viewModel.count}get layer(){return this.viewModel.layer}set layer(e){this.viewModel.layer=e}get operators(){return this.viewModel.operators}set operators(e){this.viewModel.operators=e}get state(){return this.viewModel.state}castVisibleElements(e){return{...f,...e}}get whereClause(){return this.viewModel.whereClause}get whereClauses(){return this.viewModel.whereClauses}render(){return l(`div`,{class:m.base},this._renderOperatorSelect(),this._renderConditions(),this._renderFAB())}reset(){this.viewModel.reset()}_renderOperatorSelect(){if(this.count<2)return;let{conditionOperator:e,messages:t}=this,n=e===`AND`;return l(`div`,{class:m.operatorSelect},l(`calcite-select`,{label:t.condition,width:`full`,onCalciteSelectChange:({currentTarget:e})=>{this.conditionOperator=e.value}},l(`calcite-option`,{label:t.allAreTrue,selected:n,value:`AND`}),l(`calcite-option`,{label:t.anyAreTrue,selected:!n,value:`OR`})))}_renderConditions(){return this._conditionWidgets.toArray().map((e,t)=>this._renderConditionContainer(e,t))}_renderConditionContainer(e,t){return l(`calcite-block`,{class:m.conditionContainer,expanded:!0,heading:this.messages.condition},e.render(),this._renderConditionMenu(t))}_renderFAB(){if(!this.visibleElements.fab)return;let e=this.state===`loading`;return l(`calcite-fab`,{appearance:`outline-fill`,disabled:e,icon:`plus`,kind:`neutral`,loading:e,text:this.messages.addNew,textEnabled:!0,onclick:()=>this.viewModel.addCondition()})}_renderConditionMenu(e){if(!this.visibleElements.menu)return;let{messages:t}=this;return l(`calcite-action-menu`,{label:t.moreOptions,overlayPositioning:`fixed`,placement:`bottom-end`,slot:`control`},l(`calcite-action`,{text:t.delete,textEnabled:!0,onclick:()=>this.viewModel.removeConditionByIndex(e)}),l(`calcite-action`,{text:t.duplicate,textEnabled:!0,onclick:()=>this.viewModel.duplicateConditionByIndex(e)}))}};e([r()],h.prototype,`_conditionWidgets`,void 0),e([r()],h.prototype,`conditionOperator`,null),e([r()],h.prototype,`count`,null),e([r()],h.prototype,`layer`,null),e([r(),u(`esri/widgets/support/FilterBuilder/t9n/FilterBuilder`)],h.prototype,`messages`,void 0),e([r(),u(`esri/t9n/common`)],h.prototype,`messagesCommon`,void 0),e([r()],h.prototype,`operators`,null),e([r()],h.prototype,`state`,null),e([r()],h.prototype,`viewModel`,void 0),e([r()],h.prototype,`visibleElements`,void 0),e([i(`visibleElements`)],h.prototype,`castVisibleElements`,null),e([r()],h.prototype,`whereClause`,null),e([r()],h.prototype,`whereClauses`,null),h=e([a(`esri.widgets.support.FilterBuilder`)],h);export{h as default};

package/widgets/support/FilterCondition/FilterConditionViewModel.d.ts

@@ -20,6 +20,12 @@ export interface FilterConditionViewModelProperties extends Partial<Pick<FilterC
 export default class FilterConditionViewModel extends Accessor {
   /** @internal */
   constructor(properties?: FilterConditionViewModelProperties);
+  /**
+   * The default field name to display.
+   *
+   * @internal
+   */
+  get defaultFieldName(): string | null | undefined;
   /**
    * Used for dropdowns.
    *
@@ -136,6 +142,24 @@ export default class FilterConditionViewModel extends Accessor {
    * @internal
    */
   get valueAsString(): string;
+  /**
+   * Indicates whether the value input should be hidden based on the selected operator.
+   *
+   * @internal
+   */
+  get valueInputIsHidden(): boolean;
+  /**
+   * The type of input that should be displayed.
+   *
+   * @internal
+   */
+  get valueInputType(): "number" | "text";
+  /**
+   * The types of operators that should be displayed based on the selected field.
+   *
+   * @internal
+   */
+  get visibleOperators(): OperatorName[];
   /**
    * Auto-generated string used to filter data.
    *