@arcgis/map-components 5.0.0-next.11 → 5.0.0-next.111

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

@@ -1,4 +1,3 @@
-/// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference path="../../index.d.ts" />
 import { default as LinkChartView } from '@arcgis/core/views/LinkChartView.js';
 import { default as MapView } from '@arcgis/core/views/MapView.js';
@@ -34,14 +33,14 @@ export declare class ArcgisFullscreen extends LitElement {
      * _**Note**: Individual message keys may change between releases._
      */
     messageOverrides?: typeof this.messages._overrides;
-    /** @deprecated since 4.34, use `slot` instead. */
-    position?: __esri.UIPosition;
     /**
      * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
      *
      * @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)
      */
     referenceElement?: ArcgisReferenceElement | string;
+    /** @default "m" */
+    visualScale: HTMLCalciteButtonElement["scale"];
     get state(): "active" | "disabled" | "ready" | "unsupported";
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
@@ -61,4 +60,8 @@ export declare class ArcgisFullscreen extends LitElement {
     readonly _setterTypes: {
         element?: Element | string | undefined;
     };
+    "@eventTypes": {
+        "arcgisPropertyChange": ArcgisFullscreen["arcgisPropertyChange"]["detail"];
+        "arcgisReady": ArcgisFullscreen["arcgisReady"]["detail"];
+    };
 }

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

@@ -1,29 +1,29 @@
-import { c as i } from "../../chunks/runtime.js";
-import { css as r, html as l } from "lit";
+import { c as r } from "../../chunks/runtime.js";
+import { css as i, html as n } from "lit";
 import { LitElement as a, createEvent as u, safeClassMap as m, nothing as d } from "@arcgis/lumina";
 import { usePropertyChange as h } from "@arcgis/lumina/controllers";
-import { getClosestElement as g, classes as f } from "@arcgis/toolkit/dom";
+import { getClosestElement as f, classes as g } from "@arcgis/toolkit/dom";
 import { u as p } from "../../chunks/useT9n.js";
-import { u as x } from "../../chunks/useView.js";
+import { u as v } from "../../chunks/useView.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.11 */
-const v = r`.arcgis-button{--calcite-ui-icon-color: var(--calcite-color-text-3);--calcite-button-background-color: var(--calcite-color-foreground-1);color:var(--calcite-color-text-3);line-height:var(--calcite-font-line-height-relative-tight);display:flex;flex-flow:column;cursor:pointer;background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);:hover{--calcite-ui-icon-color: var(--calcite-color-text-1);--calcite-button-background-color: var(--calcite-color-transparent-hover)}calcite-button{width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl)}}:host{width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl)}`, c = {
+v5.0.0-next.111 */
+const b = i`.arcgis-button{--calcite-icon-color: var(--calcite-color-text-3);--calcite-button-background-color: var(--calcite-color-foreground-1);color:var(--calcite-color-text-3);line-height:var(--calcite-font-line-height-relative-tight);display:flex;flex-flow:column;cursor:pointer;background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);:hover{--calcite-icon-color: var(--calcite-color-text-1);--calcite-button-background-color: var(--calcite-color-transparent-hover)}}`, c = {
   base: "fullscreen",
   button: "arcgis-button"
 };
-function b(s) {
+function E(s) {
   return s.includes("#") || s.includes(".") || s.includes("[") ? s : `#${s}`;
 }
-class E extends a {
+class x extends a {
   constructor() {
-    super(), this.messages = p(), this.view = x(this), this.arcgisPropertyChange = h()("state"), this.arcgisReady = u(), this.listenOn(document, "fullscreenchange", () => this.fullscreenElement = document.fullscreenElement);
+    super(), this.messages = p(), this.view = v(this), this.visualScale = "m", this.arcgisPropertyChange = h()("state"), this.arcgisReady = u(), this.listenOn(document, "fullscreenchange", () => this.fullscreenElement = document.fullscreenElement);
   }
   static {
-    this.properties = { fullscreenElement: 16, view: 0, element: 1, label: 1, messageOverrides: 0, position: 3, referenceElement: 1, state: 35 };
+    this.properties = { fullscreenElement: 16, view: 0, element: 1, label: 1, messageOverrides: 0, referenceElement: 1, visualScale: 1, state: 35 };
   }
   static {
-    this.styles = v;
+    this.styles = b;
   }
   get fullscreenTitle() {
     const e = this.state;
@@ -35,8 +35,8 @@ class E extends a {
   }
   set element(e) {
     if (typeof e == "string") {
-      const t = b(e), n = g(this.el, t);
-      this.#e = n || void 0;
+      const t = E(e), l = f(this.el, t);
+      this.#e = l || void 0;
     } else
       this.#e = e;
   }
@@ -50,18 +50,18 @@ class E extends a {
     super.connectedCallback(), this.fullscreenElement = document.fullscreenElement;
   }
   _getElement() {
-    const e = this.view?.container, t = e?.getRootNode(), n = t instanceof ShadowRoot ? t.host : null;
-    return this.element ?? e?.parentElement ?? n ?? null;
+    const e = this.view?.container, t = e?.getRootNode(), l = t instanceof ShadowRoot ? t.host : null;
+    return this.element ?? e?.parentElement ?? l ?? null;
   }
   _toggle() {
     document.fullscreenElement ? document.exitFullscreen() : this._getElement()?.requestFullscreen();
   }
   render() {
-    const { fullscreenTitle: e, state: t } = this, n = t === "unsupported", o = t === "ready" || t === "disabled" || t === "unsupported" ? "zoom-out-fixed" : "zoom-in-fixed";
-    return l`<div class=${m(f(c.base, c.button))}>${!n && l`<calcite-button .disabled=${t === "disabled"} .iconStart=${o} kind=neutral .label=${e} @click=${this._toggle} title=${e ?? d}></calcite-button>` || ""}</div>`;
+    const { fullscreenTitle: e, state: t } = this, l = t === "unsupported", o = t === "ready" || t === "disabled" || t === "unsupported" ? "zoom-out-fixed" : "zoom-in-fixed";
+    return n`<div class=${m(g(c.base, c.button))}>${!l && n`<calcite-button .disabled=${t === "disabled"} .iconStart=${o} kind=neutral .label=${e} @click=${this._toggle} .scale=${this.visualScale} title=${e ?? d}></calcite-button>` || ""}</div>`;
   }
 }
-i("arcgis-fullscreen", E);
+r("arcgis-fullscreen", x);
 export {
-  E as ArcgisFullscreen
+  x as ArcgisFullscreen
 };

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

@@ -1,4 +1,3 @@
-/// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference path="../../index.d.ts" />
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 import { nil } from '@arcgis/toolkit/type';
@@ -26,23 +25,21 @@ declare const useGridControlsViewModel: (component: LitElement & Pick<GridContro
 export declare class ArcgisGridControls extends LitElement {
     /**
      * The view associated with the component.
-     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the ArcgisGridControls component will be associated with a map or scene component rather than using the `view` property.
+     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the Grid Controls component will be associated with a map or scene component rather than using the `view` property.
      */
-    view?: __esri.MapView | nullish;
+    view?: import('@arcgis/core/views/MapView').default | null | undefined;
     /**
      * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
      *
      * @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)
      */
     referenceElement?: ArcgisReferenceElement | string;
-    /** @deprecated since 4.34, use `slot` instead. */
-    position?: __esri.UIPosition;
     /**
      * Icon which represents the component.
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      * @default "grid-unit"
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      */
     icon?: string;
     /** The custom color used for drawing the grid, if any. */
@@ -52,7 +49,7 @@ export declare class ArcgisGridControls extends LitElement {
      * 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.
      */
-    snappingOptions: nullish | __esri.SnappingOptions;
+    snappingOptions: import('@arcgis/core/views/interactive/snapping/SnappingOptions').default | null | undefined;
     /**
      * The color scheme used to display the grid. This will be light, dark, or custom. When theme is set to custom,
      * the [customColor](#customColor) is shown, otherwise a default light or dark theme color is used.
@@ -169,7 +166,7 @@ export declare class ArcgisGridControls extends LitElement {
      * The length of the grid cells can usefully correspond to a geographic length when the Grid is used with an
      * appropriate spatial reference (for example a local system or a State Plane system) within the reference's area of interest.
      */
-    unit: nullish | __esri.LengthUnit;
+    unit: import('@arcgis/core/core/units').LengthUnit | undefined;
     /**
      * Returns `true` if the grid is set to scale dynamically. When dynamic scaling is enabled,
      * grid cells are added or removed to ensure that grid cells are a reasonable size on screen as the user zooms.
@@ -192,7 +189,7 @@ export declare class ArcgisGridControls extends LitElement {
      *
      * @default null
      */
-    interactivePlacementState: nullish | "rotate" | "place" | "interactive";
+    interactivePlacementState: import('@arcgis/core/widgets/support/GridControls/types').GridPlacementState | null | undefined;
     /**
      * Controls snapping behavior if [snappingOptions](#snappingOptions) has been defined.
      * If [snappingOptions](#snappingOptions) have been defined, disabling or enabling grid snapping will
@@ -202,13 +199,14 @@ export declare class ArcgisGridControls extends LitElement {
      */
     snappingEnabled: boolean;
     /** Returns the actual spacing of grid lines after dynamic scaling has been applied at the current scale. */
-    readonly effectiveSpacingAfterDynamicScaling: number | nullish;
+    readonly effectiveSpacingAfterDynamicScaling: number | null;
     /**
      * Use this property to disable the interactive grid placement buttons as needed.
      * An example use case might be to block interaction while another interactive operation
      * (e.g. sketching) is in progress.
      *
      * @default false
+     * @since 4.33
      */
     placementDisabled: boolean;
     /**
@@ -234,6 +232,7 @@ export declare class ArcgisGridControls extends LitElement {
     /**
      * Call this to turn the grid on/off.
      *
+     * @param enabled
      * @param enabled Desired end state for grid display.
      */
     trySetDisplayEnabled(enabled: boolean): void;
@@ -308,5 +307,9 @@ export declare class ArcgisGridControls extends LitElement {
             interactivePlaceDisabled: string;
         };
     }>;
+    "@eventTypes": {
+        "arcgisPropertyChange": ArcgisGridControls["arcgisPropertyChange"]["detail"];
+        "arcgisReady": ArcgisGridControls["arcgisReady"]["detail"];
+    };
 }
 export {};

package/dist/components/arcgis-grid-controls/customElement.js

@@ -15,7 +15,7 @@ import { watch as D } from "@arcgis/core/core/reactiveUtils.js";
 import O from "@arcgis/core/widgets/support/GridControls/GridControlsViewModel.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.11 */
+v5.0.0-next.111 */
 function L(o) {
   if (o == null || Number.isNaN(o))
     return 0;
@@ -53,7 +53,7 @@ class G extends T {
     super(...arguments), this._labelUid = I(), this._messages = k({}), this._viewModel = j(this), this._placementModeButtonRefs = /* @__PURE__ */ new Map(), this.numericSpacingInputShouldBeVisible = this._viewModel.numericSpacingInputShouldBeVisible, this.view = this._viewModel.view, this.icon = m.componentIcon, this.snappingOptions = this._viewModel.snappingOptions, this.hideColorSelection = !1, this.hideDynamicScaleToggle = !1, this.hideGridEnabledToggle = !1, this.hideNumericInputs = !1, this.hideGridSnapEnabledToggle = !1, this.hideLineIntervalInput = !1, this.hideOutOfScaleWarning = !1, this.hidePlacementButtons = !1, this.hideRotateWithMapToggle = !1, this.rotation = this._viewModel.rotation, this.rotateWithMap = this._viewModel.rotateWithMap, this.spacing = this._viewModel.spacing, this.majorLineInterval = this._viewModel.majorLineInterval, this.gridColor = this._viewModel.gridColor, this.displayEnabled = this._viewModel.displayEnabled, this.gridOutOfScale = this._viewModel.gridOutOfScale, this.unit = this._viewModel.unit, this.dynamicScaling = this._viewModel.dynamicScaling, this.gridControlsEnabled = this._viewModel.gridControlsEnabled, this.interactivePlacementState = this._viewModel.interactivePlacementState, this.snappingEnabled = this._viewModel.snappingEnabled, this.effectiveSpacingAfterDynamicScaling = this._viewModel.effectiveSpacingAfterDynamicScaling, this.placementDisabled = this._viewModel.placementDisabled, this.autoDestroyDisabled = !1, this.arcgisPropertyChange = M()("customColor", "theme", "spacing", "rotation", "majorLineInterval", "rotateWithMap", "dynamicScaling", "snappingEnabled", "interactivePlacementState", "displayEnabled", "gridOutOfScale", "effectiveSpacingAfterDynamicScaling", "gridControlsEnabled", "gridColor"), this.arcgisReady = P();
   }
   static {
-    this.properties = { _placementModeButtonRefs: 16, _warningIconTooltipRef: 16, _themePopoverRef: 16, numericSpacingInputShouldBeVisible: 16, view: 0, referenceElement: 1, position: 3, icon: 1, customColor: [3, { converter: w }], snappingOptions: 0, theme: 1, hideColorSelection: 5, hideDynamicScaleToggle: 5, hideGridEnabledToggle: 5, hideNumericInputs: 5, hideGridSnapEnabledToggle: 5, hideLineIntervalInput: 5, hideOutOfScaleWarning: 5, hidePlacementButtons: 5, hideRotateWithMapToggle: 5, rotation: 11, rotateWithMap: 5, spacing: 11, majorLineInterval: 11, gridColor: [3, { converter: w }], displayEnabled: 4, gridOutOfScale: 7, unit: 1, dynamicScaling: 5, gridControlsEnabled: 4, interactivePlacementState: 3, snappingEnabled: 5, effectiveSpacingAfterDynamicScaling: 43, placementDisabled: 5, autoDestroyDisabled: 5, messageOverrides: 0, label: 1 };
+    this.properties = { _placementModeButtonRefs: 16, _warningIconTooltipRef: 16, _themePopoverRef: 16, numericSpacingInputShouldBeVisible: 16, view: 0, referenceElement: 1, icon: 1, customColor: [3, { converter: w }], snappingOptions: 0, theme: 1, hideColorSelection: 5, hideDynamicScaleToggle: 5, hideGridEnabledToggle: 5, hideNumericInputs: 5, hideGridSnapEnabledToggle: 5, hideLineIntervalInput: 5, hideOutOfScaleWarning: 5, hidePlacementButtons: 5, hideRotateWithMapToggle: 5, rotation: 11, rotateWithMap: 5, spacing: 11, majorLineInterval: 11, gridColor: [3, { converter: w }], displayEnabled: 4, gridOutOfScale: 7, unit: 1, dynamicScaling: 5, gridControlsEnabled: 4, interactivePlacementState: 3, snappingEnabled: 5, effectiveSpacingAfterDynamicScaling: 43, placementDisabled: 5, autoDestroyDisabled: 5, messageOverrides: 0, label: 1 };
   }
   static {
     this.styles = B;

package/dist/components/arcgis-histogram-range-slider/customElement.d.ts

@@ -4,21 +4,21 @@ import { Use } from '@arcgis/lumina/controllers';
 import { default as HistogramRangeSlider } from '@arcgis/core/widgets/HistogramRangeSlider.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
+import { IconName } from '../../utils/action-utils';
 
-declare const useHistogramRangeSliderWidget: (component: LitElement & Pick<HistogramRangeSlider, "label" | "viewModel" | "icon" | "values" | "max" | "min" | "average" | "barCreatedFunction" | "bins" | "dataLineCreatedFunction" | "dataLines" | "labelFormatFunction" | "precision" | "rangeType" | "standardDeviation" | "standardDeviationCount"> & {
+declare const useHistogramRangeSliderWidget: (component: LitElement & Pick<HistogramRangeSlider, "values" | "label" | "viewModel" | "icon" | "average" | "barCreatedFunction" | "bins" | "dataLineCreatedFunction" | "dataLines" | "labelFormatFunction" | "max" | "min" | "precision" | "rangeType" | "standardDeviation" | "standardDeviationCount"> & {
     state?: unknown;
-    viewModel?: __esri.HistogramRangeSliderViewModel | undefined;
+    viewModel?: import('@arcgis/core/widgets/HistogramRangeSlider/HistogramRangeSliderViewModel').default | undefined;
     closed?: boolean;
     icon: import('@arcgis/toolkit/type').nil | string;
     label: import('@arcgis/toolkit/type').nil | string;
     referenceElement?: ArcgisReferenceElement | string;
-    position?: __esri.UIPosition;
     arcgisReady: import('@arcgis/lumina').EventEmitter;
     arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
         name: string;
     }> | undefined;
     el: HTMLElement & {
-        childElem? /** @copyDoc */: HTMLElement & {
+        childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
         view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView | nullish;
@@ -43,43 +43,114 @@ export declare class ArcgisHistogramRangeSlider extends LitElement {
      */
     autoDestroyDisabled: boolean;
     /**
-     * The statistical average of the data in the histogram.
+     * The statistical average of the data in the histogram. You would typically
+     * get this value from the `avg` property of
+     * [SummaryStatisticsResult](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-statistics-types.html#SummaryStatisticsResult),
+     * which is the result of the
+     * [summaryStatistics](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-statistics-summaryStatistics.html) function.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#average)
+     * When set, this value will render on the histogram with a line and an average symbol.
+     *
+     * @example
+     * // sets result returned from a smart mapping method
+     * // to the histogram
+     * slider.average = response.statistics.avg;
+     * @example slider.average = 34.5;
      */
-    average: number | nullish;
+    average: number | null | undefined;
     /**
      * Function for styling bars representing histogram bins.
+     * This can be used to color bins with the same color of features in the
+     * view that fall into bins representing the same range of data.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#barCreatedFunction)
+     * @example
+     * slider.barCreatedFunction = function(index, element){
+     *   const bin = slider.bins[index];
+     *   element.addEventListener("focus", function(){
+     *     layerView.filter = {
+     *       where: `POPULATION >= ${bin.minValue} AND POPULATION < ${bin.maxValue}`
+     *     };
+     *   });
+     *   element.addEventListener("blur", function(){
+     *     layerView.filter = null;
+     *   });
+     * };
      */
-    barCreatedFunction: nullish | __esri.BarCreatedFunction;
+    barCreatedFunction: import('@arcgis/core/widgets/Histogram/types').BarCreatedFunction | null | undefined;
     /**
-     * An array of objects representing each bin in the histogram.
+     * An array of objects representing each bin in the histogram. This
+     * information is typically returned from the
+     * [histogram](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-statistics-histogram.html) function.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#bins)
+     * @example
+     * // sets the bins of the histogram from the bins in the histogram() result
+     * histogram.bins = histogramResult.bins;
+     * @example
+     * // Creates a histogram with 7 bins.
+     * histogram.bins = [
+     *   { minValue: 0, maxValue: 10, count: 4 },
+     *   { minValue: 10.1, maxValue: 20, count: 14 },
+     *   { minValue: 20.1, maxValue: 30, count: 9 },
+     *   { minValue: 30.1, maxValue: 40, count: 34 },
+     *   { minValue: 40.1, maxValue: 50, count: 351 },
+     *   { minValue: 50.1, maxValue: 60, count: 100 },
+     *   { minValue: 60.1, maxValue: 70, count: 1 }
+     * ];
      */
-    bins: nullish | __esri.HistogramBin[];
+    bins: import('@arcgis/core/smartMapping/statistics/types').HistogramBin[] | null | undefined;
     /**
      * Function that fires each time a data line is created.
+     * You can use this to style individual [dataLines](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#dataLines) on the data axis.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#dataLineCreatedFunction)
+     * @example
+     * histogram.dataLineCreatedFunction = function (lineElement, labelElement) {
+     *   lineElement.setAttribute("y2", "25%");
+     *   lineElement.classList.add("line-style");
+     * };
      */
-    dataLineCreatedFunction: nullish | __esri.DataLineCreatedFunction;
+    dataLineCreatedFunction: import('@arcgis/core/widgets/Histogram/types').DataLineCreatedFunction | null | undefined;
     /**
      * When set, renders lines on the histogram that indicate important or
      * meaningful values to the end user.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#dataLines)
+     * @example
+     * // will render lines at the 25th, 50th, 75th, and 99th percentiles
+     * histogram.dataLines = [{
+     *   value: 30,
+     *   label: "25 pctl"
+     * }, {
+     *   value: 45,
+     *   label: "50 pctl"
+     * }, {
+     *   value: 65,
+     *   label: "75 pctl"
+     * }, {
+     *   value: 89,
+     *   label: "99 pctl"
+     * }];
+     * @example
+     * // calculate standard deviations from mean using stats
+     * // returned from smart mapping statistic methods
+     * const stddevs = smartMappingUtils.getDeviationValues(stats.stddev, stats.avg, 2);
+     * histogram.dataLines = stddevs.map(function(stddev){
+     *   return {
+     *     value: stddev
+     *   };
+     * });
      */
-    dataLines: nullish | __esri.HistogramRangeSliderDataLines[];
+    dataLines: import('@arcgis/core/widgets/Histogram/types').DataLineInfos[] | null | undefined;
     /**
      * Sets the color of the histogram bars that are excluded based on the specified
-     * [rangeType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType).
+     * [rangeType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType). For example, when a rangeType of `between` is used,
+     * all bars **not** between the slider thumbs will be rendered with the color set here.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#excludedBarColor)
+     * To change the style of histogram bars representing included data based on the
+     * [rangeType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType), use the [includedBarColor](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#includedBarColor) property.
      *
      * @default "#d7e5f0"
+     * @see [includedBarColor](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#includedBarColor)
+     * @see [rangeType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType)
+     * @example slider.excludedBarColor = "black";
      */
     get excludedBarColor(): typeof this.widget.excludedBarColor;
     set excludedBarColor(value: __esri.ColorProperties);
@@ -87,58 +158,158 @@ export declare class ArcgisHistogramRangeSlider extends LitElement {
      * Icon which represents the component.
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      * @default "arrow-double-horizontal"
+     * @since 4.27
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      */
-    icon: string;
+    get icon(): typeof this.widget.icon;
+    set icon(value: IconName);
     /**
      * Sets the color of the histogram bars that are included in the specified
-     * [rangeType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType).
+     * [rangeType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType). For example, when a rangeType of `between` is used,
+     * all bars between the slider thumbs will be rendered with the color set here.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#includedBarColor)
+     * To change the style of histogram bars representing excluded data based on the
+     * [rangeType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType), use the [excludedBarColor](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#excludedBarColor) property.
      *
      * @default "#599dd4"
+     * @see [excludedBarColor](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#excludedBarColor)
+     * @see [rangeType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType)
+     * @example slider.includedBarColor = "green";
      */
     get includedBarColor(): typeof this.widget.includedBarColor;
     set includedBarColor(value: __esri.ColorProperties);
     /**
-     * The widget's default label.
+     * The widget's default label. This label displays when it is
+     * used within another widget, such as the [Expand](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Expand.html)
+     * or [LayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html) widgets.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#label)
+     * @since 4.11
      */
     label: string;
     /**
-     * A function used to format labels.
+     * A function used to format labels. Overrides the default label formatter.
+     *
+     * By default labels are formatted in the following way:
+     *
+     * - When the data range is less than `10` (`(max - min) < 10`), labels
+     *   are rounded based on the value set in the [precision](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#precision) property.
+     * - When the data range is larger than `10`, [HistogramRangeSliderViewModel#labels](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider-HistogramRangeSliderViewModel.html#labels) display with a precision of
+     *   no more than two decimal places, though actual slider thumb values will maintain the
+     *   precision specified in [precision](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#precision).
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#labelFormatFunction)
+     * Use this property to override the behavior defined above.
+     *
+     * @example
+     * // For thumb values, rounds each label to whole numbers.
+     * // Note the actual value of the thumb continues to be stored
+     * // based on the indicated data `precision` despite this formatting
+     * slider.labelFormatFunction = function(value, type) {
+     *   return (type === "value") ? value.toFixed(0) : value;
+     * }
+     * @example
+     * // Format thumb values as dates
+     * slider.labelFormatFunction = function(value, type) {
+     *   return new Date(value).toLocaleDateString();
+     * }
      */
-    labelFormatFunction: __esri.SliderLabelFormatter;
+    labelFormatFunction: import('@arcgis/core/widgets/types').LabelFormatFunction;
     /**
-     * The maximum value or upper bound of the slider.
+     * The maximum value or upper bound of the slider. If the largest
+     * slider [value](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#values) _in the constructor_ is greater than the `maxValue` set in
+     * this property, then the `maxValue` will update to match the largest
+     * slider [value](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#values).
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#max)
+     * @example slider.max = 150;
      */
-    max: number | nullish;
+    max: number | null | undefined;
     /**
-     * The minimum value or lower bound of the slider.
+     * The minimum value or lower bound of the slider. If the smallest
+     * slider [value](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#values) _in the constructor_ is greater than the `minValue` set in
+     * this property, then the `minValue` will update to match the smallest
+     * slider [value](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#values).
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#min)
+     * @example slider.min = -150;
      */
-    min: number | nullish;
-    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead. */
-    position?: __esri.UIPosition;
+    min: number | null | undefined;
     /**
-     * Defines how slider thumb values should be rounded.
+     * 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.
+     *
+     * This value also indicates the precision of thumb [HistogramRangeSliderViewModel#labels](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider-HistogramRangeSliderViewModel.html#labels) when the data range
+     * ([max](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#max) - [min](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#min)) is less than `10`.
+     *
+     * When the data range is larger than `10`, [HistogramRangeSliderViewModel#labels](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider-HistogramRangeSliderViewModel.html#labels) display with a precision of
+     * no more than two decimal places, though actual slider thumb values will maintain the
+     * precision specified in this property.
+     *
+     * For example, given the default precision of `4`, and the following slider configuration,
+     * The label of the thumb will display two decimal places, but the precision of the actual
+     * thumb value will not be lost even when the user slides or moves the thumb.
+     *
+     * ```js
+     * const slider = new HistogramRangeSliderViewModel({
+     *   min: 20,
+     *   max: 100,  // data range of 80
+     *   values: [50.4331],
+     *   // thumb label will display 50.43
+     *   // thumb value will maintain precision, so
+     *   // value will remain at 50.4331
+     * });
+     * ```
+     *
+     * If the user manually enters a value that has a higher precision than what's indicated by
+     * this property, the precision of that thumb value will be maintained until the thumb
+     * is moved by the user. At that point, the value will be rounded according to the indicated precision.
+     *
+     * Keep in mind this property rounds thumb [values](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#values) and shouldn't be used exclusively
+     * for formatting purposes. To format thumb `labels`, use the [labelFormatFunction](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#labelFormatFunction)
+     * property.
      *
      * @default 4
+     * @example histogramRangeSlider.precision = 7;
      */
     precision: number;
     /**
-     * Indicates how the histogram bins should be rendered as the user slides the thumbs.
+     * Indicates how the histogram bins should be rendered as the user slides the thumbs. By default,
+     * blue bars indicate data bins included in the range. Gray bars indicate data bins excluded from
+     * the range. These colors can be customized with the [includedBarColor](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#includedBarColor) and
+     * [excludedBarColor](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#includedBarColor) properties.
+     *
+     * This property also determines the SQL where clause generated in [generateWhereClause()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#generateWhereClause)
+     * for filtering purposes. The value set here determines the number of [values](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#values)
+     * allowed on the slider.
+     *
+     * See the table below for a description and requirements of all possible values. `value1` refers to
+     * the value of the first thumb position. `value2` refers to the value of the final thumb position, if applicable.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType)
+     * Possible Value | Number of [values](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#values) | [Where clause](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#generateWhereClause)
+     * ---------------|----------------------------|----------------------
+     * equal | 1 | `${field} = ${value1}`
+     * not-equal | 1 | `${field} <> ${value1}`
+     * less-than | 1 | `${field} < ${value1}`
+     * greater-than | 1 | `${field} > ${value1}`
+     * at-most | 1 | `${field} <= ${value1}`
+     * at-least | 1 | `${field} >= ${value1}`
+     * between | 2 | `${field} BETWEEN ${value1} AND ${value2}`
+     * not-between | 2 | `${field} NOT BETWEEN ${value1} AND ${value2}`
+     *
+     * @see [values](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#values)
+     * @see [generateWhereClause()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#generateWhereClause)
+     * @example
+     * // renders the histogram so that all bins between
+     * // the two handles are shaded with a blue color
+     * slider.rangeType = "between";
+     *
+     * // filters the layer view based on the configuration
+     * // of the slider
+     * layerView.filter = {
+     *   where: slider.generateWhereClause("POPULATION")
+     * }
      */
-    rangeType: "equal" | "not-equal" | "less-than" | "greater-than" | "at-most" | "at-least" | "between" | "not-between";
+    rangeType: import('@arcgis/core/widgets/HistogramRangeSlider/types').RangeType;
     /**
      * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
      *
@@ -147,30 +318,47 @@ export declare class ArcgisHistogramRangeSlider extends LitElement {
     referenceElement?: ArcgisReferenceElement | string;
     /**
      * Indicates the standard deviation of the dataset.
+     * When set, computed [dataLines](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#dataLines) will render on the histogram
+     * at the location of the given standard deviation
+     * above and below the `average`.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#standardDeviation)
+     * @example
+     * // stddev returned from summaryStatistics
+     * slider.standardDeviation = stats.stddev;
      */
-    standardDeviation: number | nullish;
+    standardDeviation: number | null | undefined;
     /**
      * Indicates the number of standard deviation lines to render on the histogram
      * from the [average].
      *
      * @default 1
+     * @example slider.standardDeviationCount = 2;
      */
     standardDeviationCount: number;
     /** The current state of the component. */
-    readonly state: "ready" | "disabled";
+    readonly state: import('@arcgis/core/widgets/Slider/SliderViewModel').SliderViewModelState;
     /**
      * An array of either one or two numbers representing thumb positions on the slider.
+     * The number of values that should be indicated here depends on the associated [rangeType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType).
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#values)
+     * @see [rangeType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType)
+     * @example
+     * const slider = new HistogramRangeSlider({
+     *   min: 20,
+     *   max: 100,  // data range of 80
+     *   values: [50.4331],
+     *   rangeType: "at-least"
+     *   container: "sliderDiv"
+     * });
      */
-    values: number[] | nullish;
+    values: number[] | null | undefined;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
     /**
      * Generates a SQL where clause based on a given field and the slider's
      * rangeType
+     *
+     * @param field
      */
     generateWhereClause(field: string): Promise<nullish | string>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
@@ -182,7 +370,12 @@ export declare class ArcgisHistogramRangeSlider extends LitElement {
     private widget: HistogramRangeSlider;
     readonly _setterTypes: {
         excludedBarColor?: __esri.ColorProperties;
+        icon?: IconName;
         includedBarColor?: __esri.ColorProperties;
     };
+    "@eventTypes": {
+        "arcgisPropertyChange": ArcgisHistogramRangeSlider["arcgisPropertyChange"]["detail"];
+        "arcgisReady": ArcgisHistogramRangeSlider["arcgisReady"]["detail"];
+    };
 }
 export {};