@arcgis/map-components 4.33.0-next.12 → 4.33.0-next.120

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

@@ -0,0 +1,214 @@
+import { c as S } from "../../chunks/runtime.js";
+import { html as n } from "lit-html";
+import { ref as f } from "lit-html/directives/ref.js";
+import { g as _ } from "../../chunks/globalCss.js";
+import C from "@arcgis/core/views/Theme.js";
+import { u as I } from "../../chunks/useT9n.js";
+import { generateGuid as M, classes as g } from "@arcgis/components-utils";
+import { usePropertyChange as T } from "@arcgis/lumina/controllers";
+import { m as E } from "../../chunks/useViewModel.js";
+import h from "@arcgis/core/Color.js";
+import { LitElement as x, createEvent as P, noShadowRoot as R, safeClassMap as d, nothing as u } from "@arcgis/lumina";
+import { css as k } from "@lit/reactive-element/css-tag.js";
+import { substitute as O } from "@arcgis/core/intl.js";
+import { watch as D } from "@arcgis/core/core/reactiveUtils.js";
+import L from "@arcgis/core/widgets/support/GridControls/GridControlsViewModel.js";
+/*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
+See https://js.arcgis.com/4.33/esri/copyright.txt for details.
+v4.33.0-next.120 */
+function B(o) {
+  if (o == null || Number.isNaN(o))
+    return 0;
+  const e = o + 180;
+  return Math.trunc(w(e, 360));
+}
+function N(o) {
+  let e = o;
+  return e == null || (typeof e == "string" && (e = Number.parseInt(e, 10)), Number.isNaN(e)) ? 0 : w(Math.trunc(e), 360) - 180;
+}
+function w(o, e) {
+  return (o % e + e) % e;
+}
+const $ = {
+  fromAttribute: (o) => h.fromHex(o),
+  toAttribute: (o) => typeof o == "string" ? o : o?.toHex() ?? ""
+}, W = k`@layer{calcite-block>.arcgis-grid-controls{background:none;padding:0}.arcgis-ui-corner .arcgis-expand .arcgis-widget--panel .arcgis-widget--panel.arcgis-grid-controls{overflow-y:visible}.arcgis-grid-controls{user-select:none;display:flex;flex-flow:column wrap;padding:var(--calcite-spacing-sm);.container{display:flex;flex:1 1 auto;flex-direction:column;gap:var(--calcite-spacing-sm)}.numeric-inputs-container{display:grid;grid-auto-columns:1fr;grid-auto-flow:column;gap:var(--calcite-spacing-sm)}arcgis-labeled-switch{margin-block-end:var(--calcite-spacing-sm)}.switch--bordered{border-width:0 0 var(--calcite-spacing-px) 0;border-style:solid;border-color:var(--calcite-color-border-1);padding-block-end:var(--calcite-spacing-sm)}.tile-group{display:flex;column-gap:var(--calcite-spacing-md);align-items:start;margin-bottom:calc(0px - var(--calcite-spacing-sm))}.tile{position:relative;.content{display:flex;flex-direction:column;row-gap:var(--calcite-spacing-md);align-items:center;padding:var(--calcite-spacing-md);color:var(--calcite-color-text-2)}&.disabled{opacity:var(--calcite-opacity-disabled)}&:focus-within{outline:var(--calcite-spacing-base) solid var(--calcite-color-brand);outline-offset:var(--calcite-spacing-base)}input[type=radio]{appearance:none;position:absolute;inset:0;opacity:.001;border:var(--calcite-spacing-px) solid transparent;cursor:pointer;&:checked+.content{border:var(--calcite-spacing-px) solid var(--calcite-color-brand)}+.content{border:var(--calcite-spacing-px) solid transparent;calcite-label{margin-bottom:calc(0px - var(--calcite-label-margin-bottom, .75rem));font-weight:var(--calcite-font-weight-medium)}}}}.inline-icon{margin-left:var(--calcite-spacing-xs);vertical-align:top;color:var(--calcite-color-status-warning)}}}`, G = "arcgis-grid-controls", r = {
+  base: G,
+  borderedSwitch: "switch--bordered",
+  container: "container",
+  numericInputsContainer: "numeric-inputs-container",
+  tileGroup: "tile-group",
+  tile: "tile",
+  tileDisabled: "disabled",
+  tileContent: "content",
+  inlineIcon: "inline-icon"
+}, m = {
+  componentIcon: "grid-unit",
+  gridTheme: { light: "circle", dark: "circle-area", custom: "palette" },
+  placementState: { interactive: "maximum-territory-distance", place: "move", rotate: "rotate" },
+  warning: "exclamation-mark-triangle"
+}, b = h.fromArray([115, 115, 115]), v = h.fromArray([200, 200, 200]), A = ["interactive", "place", "rotate"], j = E(L);
+class V extends x {
+  constructor() {
+    super(...arguments), this._labelUid = M(), this._messages = I({}), this._viewModel = j(this), this._placementModeButtonRefs = /* @__PURE__ */ new Map(), this._warningIconTooltipRef = void 0, this._themePopoverRef = void 0, this.numericSpacingInputShouldBeVisible = this._viewModel.numericSpacingInputShouldBeVisible, this.position = "bottom-right", this.icon = m.componentIcon, this.customColor = null, 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 = T()("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, referenceElement: 1, position: 3, icon: 1, customColor: [3, { converter: $ }], 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: $ }], 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 = W;
+  }
+  static {
+    this.shadowRootOptions = R;
+  }
+  get theme() {
+    const e = this.gridColor;
+    return !e || b.equals(e) ? "dark" : v.equals(e) ? "light" : "custom";
+  }
+  set theme(e) {
+    const t = this._viewModel.view;
+    switch (e) {
+      case "dark":
+        this.gridColor = b;
+        break;
+      case "custom":
+        this.customColor == null && (this.customColor = t?.theme?.accentColor ?? new C().accentColor), this.gridColor = this.customColor;
+        break;
+      case "light":
+      default:
+        this.gridColor = v;
+        break;
+    }
+  }
+  async destroy() {
+    await this.manager.destroy();
+  }
+  trySetDisplayEnabled(e) {
+    this._viewModel.trySetDisplayEnabled(e);
+  }
+  loaded() {
+    this.manager.onLifecycle(() => [
+      // Move focus when movement angle changed by touch/mouse (not keyboard!)
+      D(() => this._viewModel.gridColor, (e) => {
+        const t = e instanceof h ? e : typeof e == "string" ? h.fromHex(e) : null;
+        t && !b.equals(e) && !v.equals(t) ? this.customColor = t : b.equals(t) ? this.theme = "dark" : v.equals(t) && (this.theme = "light");
+      })
+    ]);
+  }
+  _togglePlacementState(e) {
+    this.interactivePlacementState = this.interactivePlacementState === e ? null : e;
+  }
+  _setWarningIconRef(e) {
+    this._warningIconTooltipRef = e;
+  }
+  _setPopoverRef(e) {
+    this._themePopoverRef = e;
+  }
+  _emptyFunction(e) {
+  }
+  _setPlacementButtonRef(e) {
+    if (e) {
+      const t = e.dataset.placementAction;
+      this._placementModeButtonRefs.set(t, e);
+    } else
+      this._placementModeButtonRefs.clear();
+  }
+  render() {
+    return n`<div class=${d(g(r.base, _.widget, _.panel))}><div class=${d(r.container)}>${this._renderContent()}</div></div>`;
+  }
+  _renderContent() {
+    const { hideGridEnabledToggle: e, hidePlacementButtons: t, hideNumericInputs: i, hideLineIntervalInput: a, hideGridSnapEnabledToggle: l, hideDynamicScaleToggle: s, hideRotateWithMapToggle: c, hideColorSelection: p } = this;
+    return [
+      e ? void 0 : this._renderEnabledToggle(),
+      t ? void 0 : this._renderGridPlacementButtons(),
+      i ? void 0 : this._renderNumericInputs(),
+      a ? void 0 : this._renderIntervalInput(),
+      !l && this.snappingOptions ? this._renderSnappingToggle() : void 0,
+      s ? void 0 : this._renderDynamicScaleToggle(),
+      c ? void 0 : this._renderRotateToggle(),
+      p ? void 0 : this._renderColorSelection()
+    ];
+  }
+  _renderGridPlacementButtons() {
+    const { interactivePlacementState: e, placementDisabled: t, gridControlsEnabled: i } = this, a = t || !i;
+    return n`<calcite-label scale=s>${this._messages.placementOptions}<calcite-action-bar expand-disabled layout=horizontal>${A.map((l) => this._renderPlacementModeButton(l, a, e))}</calcite-action-bar></calcite-label>`;
+  }
+  _renderPlacementModeButton(e, t, i) {
+    const a = this._messages?.placementState?.[e], l = this._placementModeButtonRefs.get(e);
+    return n`<div><calcite-action .active=${i === e} alignment=center .disabled=${t} .icon=${m.placementState[e]} data-placement-action=${e ?? u} @click=${() => this._togglePlacementState(e)} .text=${a ?? ""} ${f(this._setPlacementButtonRef)}></calcite-action>${l ? n`<calcite-tooltip overlay-positioning=fixed placement=top .referenceElement=${l}>${a}</calcite-tooltip>` : void 0}</div>`;
+  }
+  _renderNumericInputs() {
+    const { rotation: e, spacing: t, effectiveSpacingAfterDynamicScaling: i, numericSpacingInputShouldBeVisible: a, gridControlsEnabled: l } = this, s = i != null && i !== t;
+    return n`<div class=${d(g(r.numericInputsContainer))}>${[
+      a ? n`<calcite-label scale=s><span>${this._messages?.inputLabel?.spacing}${s ? n`<calcite-icon class=${d(g(r.inlineIcon))} .icon=${m.warning} scale=s tabindex=0 ${f(this._setWarningIconRef)}></calcite-icon>` : void 0}</span><calcite-input-number .disabled=${!l} number-button-type=none .value=${t?.toFixed(2)} @calciteInputNumberChange=${({ currentTarget: c }) => {
+        const p = Number.parseFloat(c.value);
+        this.spacing = p, p !== this.spacing && (c.value = `${this.spacing}`);
+      }}></calcite-input-number>${s && this._warningIconTooltipRef ? n`<calcite-tooltip overlay-positioning=fixed placement=leading .referenceElement=${this._warningIconTooltipRef}>${O(this._messages?.warnings?.dynamicSpacing ?? "", { actualSpacingIncludingUnit: i }, {
+        format: {
+          actualSpacingIncludingUnit: {
+            type: "number",
+            intlOptions: {
+              minimumFractionDigits: 2,
+              maximumFractionDigits: 2,
+              unit: this.unit ?? "meters",
+              style: "decimal"
+            }
+          }
+        }
+      })}</calcite-tooltip>` : void 0}</calcite-label>` : void 0,
+      n`<calcite-label scale=s>${this._messages?.inputLabel?.angle}<calcite-input-number .disabled=${!l} integer number-button-type=none suffix-text=\u00B0 .value=${`${B(e)}`} @calciteInputNumberChange=${({ currentTarget: c }) => this.rotation = N(c.value)}></calcite-input-number></calcite-label>`
+    ]}</div>`;
+  }
+  _renderIntervalInput() {
+    const { majorLineInterval: e, gridControlsEnabled: t } = this;
+    return n`<div class=${d(g(r.numericInputsContainer))}><calcite-label scale=s>${this._messages?.inputLabel?.interval}<calcite-input-number .disabled=${!t} integer max=15 min=1 number-button-type=vertical .value=${`${e}`} @calciteInputNumberChange=${({ currentTarget: i }) => {
+      const a = Number.parseInt(i.value, 10);
+      this.majorLineInterval = a, a !== this.majorLineInterval && (i.value = `${this.majorLineInterval}`);
+    }}></calcite-input-number></calcite-label></div>`;
+  }
+  _renderSnappingToggle() {
+    const { snappingOptions: e, gridControlsEnabled: t } = this, i = e?.gridEnabled ?? !1;
+    return n`<arcgis-labeled-switch .checked=${!!i} .disabled=${!(t && !!e)} .label=${this._messages?.switchLabel?.snap} @arcgisCheckedChanged=${(l) => {
+      l.stopPropagation(), this.snappingOptions?.set("gridEnabled", l.detail);
+    }}></arcgis-labeled-switch>`;
+  }
+  _renderDynamicScaleToggle() {
+    const { _messages: e, gridOutOfScale: t, dynamicScaling: i, gridControlsEnabled: a } = this, l = !this.hideOutOfScaleWarning && t;
+    return n`<arcgis-labeled-switch .checked=${i} .disabled=${!a} .hint=${l ? e?.warnings?.outOfScale : void 0} .hintIcon=${m.warning} hint-kind=warning .label=${e?.switchLabel?.scaling} @arcgisCheckedChanged=${(s) => {
+      s.stopPropagation(), this.dynamicScaling = s.detail;
+    }}></arcgis-labeled-switch>`;
+  }
+  _renderRotateToggle() {
+    const { gridControlsEnabled: e, rotateWithMap: t } = this;
+    return n`<arcgis-labeled-switch .checked=${t} .disabled=${!e} .label=${this._messages?.switchLabel?.rotateWithMap ?? ""} @arcgisCheckedChanged=${(i) => {
+      i.stopPropagation(), this.rotateWithMap = i.detail;
+    }}></arcgis-labeled-switch>`;
+  }
+  _renderEnabledToggle() {
+    return n`<div class=${d(r.borderedSwitch)}><arcgis-labeled-switch .checked=${this.displayEnabled} .disabled=${!!this.interactivePlacementState} .label=${this._messages?.switchLabel?.display} @arcgisCheckedChanged=${(e) => {
+      e.stopPropagation(), this.trySetDisplayEnabled(e.detail);
+    }}></arcgis-labeled-switch></div>`;
+  }
+  _renderColorSelection() {
+    const { customColor: e } = this;
+    return n`<calcite-label scale=s>${this._messages?.inputLabel?.theme}<div class=${d(r.tileGroup)}>${[
+      this._renderThemeTile({ value: "dark" }),
+      this._renderThemeTile({ value: "light" }),
+      this._renderThemeTile({ value: "custom" }),
+      this._themePopoverRef ? n`<calcite-popover auto-close .label=${this._messages?.gridLineColorPopoverLabel ?? ""} overlay-positioning=fixed .referenceElement=${this._themePopoverRef}><calcite-color-picker alpha-channel saved-disabled .value=${e?.toHex({ digits: 8 }) ?? "#000000ff"} @calciteColorPickerChange=${(t) => {
+        const i = h.fromHex(t.currentTarget.value);
+        i && (this.customColor = i, this.theme = "custom");
+      }}></calcite-color-picker></calcite-popover>` : void 0
+    ]}</div></calcite-label>`;
+  }
+  _renderThemeTile(e) {
+    const { theme: t, gridControlsEnabled: i } = this, { value: a } = e, l = this._messages?.gridTheme?.[a], s = `${this._labelUid}--theme_tile_${a}`, c = `${s}__label`, p = m.gridTheme[a];
+    return n`<div class=${d(g({ [r.tile]: !0, [r.tileDisabled]: !i }))} role=button ${f(a === "custom" ? this._setPopoverRef : this._emptyFunction)}><input aria-labelledby=${c ?? u} .checked=${t === a} .disabled=${!i} id=${s ?? u} .name=${`${this._labelUid}--theme`} @change=${(y) => {
+      this.theme = a, y.currentTarget.focus();
+    }} tabindex=0 type=radio><div class=${d(r.tileContent)}><calcite-icon .icon=${p} scale=l></calcite-icon><calcite-label .for=${s} id=${c ?? u}>${l}</calcite-label></div></div>`;
+  }
+}
+S("arcgis-grid-controls", V);
+export {
+  V as ArcgisGridControls
+};

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

@@ -0,0 +1,16 @@
+import { Nil } from '@arcgis/components-utils';
+import { default as Color } from '@arcgis/core/Color.js';
+/** Convert grid rotation value to user-facing degrees value. */
+export declare function gridRotationToDegrees(rotationFromGrid: Nil | number): number;
+/**
+ * Takes a number or string representation of grid rotation in degrees,
+ * and transforms to the equivalent MeasuredGrid rotation value.
+ */
+export declare function userInputToGridRotation(rotationFromAnywhere: Nil | number | string): number;
+/** Applies a single color to a grid; major line gets color as-is, minor line gets color with half opacity. */
+export declare function applyColorToGrid(grid: Nil | object, color: number[]): void;
+export declare function moduloPositive(a: number, n: number): number;
+export declare const ColorPropertyConverter: {
+    fromAttribute: (value: string) => Color | Nil;
+    toAttribute: (value: Color | Nil | string) => string;
+};

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

@@ -0,0 +1,10 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-action-bar";
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-tooltip";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-input-number";
+import "../arcgis-labeled-switch/index.js";
+import "@esri/calcite-components/components/calcite-popover";
+import "@esri/calcite-components/components/calcite-color-picker";
+export * from "./customElement.js";

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

@@ -0,0 +1,10 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-action-bar";
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-tooltip";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-input-number";
+import "../arcgis-labeled-switch/index.js";
+import "@esri/calcite-components/components/calcite-popover";
+import "@esri/calcite-components/components/calcite-color-picker";
+export * from "./customElement.js";

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

@@ -0,0 +1,2 @@
+export type GridPlacementState = "interactive" | "place" | "rotate";
+export type GridTheme = "custom" | "dark" | "light";

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

@@ -1,33 +1,28 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
-import { Use } from '@arcgis/components-controllers';
+import { Use } from '@arcgis/lumina/controllers';
 import { Nil } from '@arcgis/components-utils';
 import { default as HistogramRangeSlider } from '@arcgis/core/widgets/HistogramRangeSlider.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useHistogramRangeSliderWidget: (component: import('@arcgis/components-controllers').StencilLifecycles & {
-    manager: import('@arcgis/components-controllers').ControllerManager;
-    el: HTMLElement;
-    autoDestroyDisabled?: boolean;
-    destroy?: () => Promise<void>;
-} & Pick<HistogramRangeSlider, never> & {
-    reactiveUtils?: typeof __esri.reactiveUtils;
+declare const useHistogramRangeSliderWidget: (component: LitElement & Pick<HistogramRangeSlider, never> & {
     state?: unknown;
     viewModel?: __esri.HistogramRangeSliderViewModel | undefined;
+    closed?: boolean;
     icon: Nil | string;
     label: Nil | string;
     referenceElement: ArcgisReferenceElement | Nil | string;
     position: __esri.UIPosition;
-    arcgisReady: import('@arcgis/components-controllers').EventEmitter;
-    arcgisPropertyChange: import('@arcgis/components-controllers').EventEmitter<{
+    arcgisReady: import('@arcgis/lumina').EventEmitter;
+    arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
         name: string;
     }> | undefined;
     el: HTMLElement & {
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.MapView | __esri.SceneView | Nil;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView | Nil;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
@@ -35,6 +30,8 @@ declare const useHistogramRangeSliderWidget: (component: import('@arcgis/compone
     editConstructorProperties(props: __esri.HistogramRangeSliderProperties | undefined): __esri.HistogramRangeSliderProperties | Promise<__esri.HistogramRangeSliderProperties | undefined> | undefined;
 } | undefined) => HistogramRangeSlider;
 /**
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-histogram-range-slider/)
+ *
  * @internal
  */
 export declare class ArcgisHistogramRangeSlider extends LitElement {
@@ -42,46 +39,157 @@ export declare class ArcgisHistogramRangeSlider extends LitElement {
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the
      * component to a different place on the page, or temporarily hide it. If this
-     * is set, make sure to call the \`destroy\` method when you are done to prevent
-     * memory leaks.
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-histogram-range-slider/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * The statistical average of the data in the histogram.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#average)
+     */
     average: number | nullish;
+    /**
+     * Function for styling bars representing histogram bins.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#barCreatedFunction)
+     */
     barCreatedFunction: nullish | __esri.BarCreatedFunction;
-    bins: nullish | __esri.Bin[];
+    /**
+     * An array of objects representing each bin in the histogram.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#bins)
+     */
+    bins: nullish | __esri.HistogramBin[];
+    /**
+     * Function that fires each time a data line is created.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#dataLineCreatedFunction)
+     */
     dataLineCreatedFunction: nullish | __esri.DataLineCreatedFunction;
+    /**
+     * 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)
+     */
     dataLines: nullish | __esri.HistogramRangeSliderDataLines[];
-    excludedBarColor: __esri.Color;
     /**
-     * Icon which represents the component.
-     * Typically used when the component is controlled by another component (e.g. by the Expand component).
-     * Search [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/) for possible values.
+     * 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).
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#excludedBarColor)
+     *
+     * @default "#d7e5f0"
+     */
+    get excludedBarColor(): typeof this.widget.excludedBarColor;
+    set excludedBarColor(value: __esri.ColorProperties);
+    /**
+     * Icon displayed in the widget's button.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#icon)
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "arrow-double-horizontal"
      */
     icon: string;
-    includedBarColor: __esri.Color;
-    /** The component's default label. */
+    /**
+     * 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).
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#includedBarColor)
+     *
+     * @default "#599dd4"
+     */
+    get includedBarColor(): typeof this.widget.includedBarColor;
+    set includedBarColor(value: __esri.ColorProperties);
+    /**
+     * The widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#label)
+     */
     label: string;
+    /**
+     * A function used to format labels.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#labelFormatFunction)
+     */
     labelFormatFunction: __esri.SliderLabelFormatter;
+    /**
+     * The maximum value or upper bound of the slider.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#max)
+     */
     max: number | nullish;
+    /**
+     * The minimum value or lower bound of the slider.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#min)
+     */
     min: number | nullish;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
+    /**
+     * Defines how slider thumb values should be rounded.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#precision)
+     *
+     * @default 4
+     */
     precision: number;
+    /**
+     * Indicates how the histogram bins should be rendered as the user slides the thumbs.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType)
+     */
     rangeType: "equal" | "not-equal" | "less-than" | "greater-than" | "at-most" | "at-least" | "between" | "not-between";
     referenceElement: ArcgisReferenceElement | Nil | string;
+    /**
+     * Indicates the standard deviation of the dataset.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#standardDeviation)
+     */
     standardDeviation: number | nullish;
+    /**
+     * Indicates the number of standard deviation lines to render on the histogram
+     * from the [average].
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#standardDeviationCount)
+     *
+     * @default 1
+     */
     standardDeviationCount: number;
+    /**
+     * The state of the view model.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider-SliderViewModel.html#state)
+     */
     readonly state: "ready" | "disabled";
+    /**
+     * An array of either one or two numbers representing thumb positions on the slider.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#values)
+     */
     values: nullish | number[];
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     /**
      * Generates a SQL where clause based on a given field and the slider's
      * rangeType
      */
     generateWhereClause(field: string): Promise<nullish | string>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, undefined>;
+    private widget: HistogramRangeSlider;
+    readonly _setterTypes: {
+        excludedBarColor?: __esri.ColorProperties;
+        includedBarColor?: __esri.ColorProperties;
+    };
 }
 export {};

package/dist/components/arcgis-histogram-range-slider/customElement.js

@@ -1,19 +1,19 @@
 import { c as i } from "../../chunks/runtime.js";
-import { usePropertyChange as e } from "@arcgis/components-controllers";
+import { usePropertyChange as e } from "@arcgis/lumina/controllers";
 import s from "@arcgis/core/widgets/HistogramRangeSlider.js";
 import { LitElement as a, createEvent as r, noShadowRoot as o } from "@arcgis/lumina";
 import { m as n } from "../../chunks/useWidget.js";
 import { css as d } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.12 */
+v4.33.0-next.120 */
 const h = d`@layer{arcgis-histogram-range-slider{display:block}}`, l = n(s);
 class g extends a {
   constructor() {
     super(...arguments), this.widget = l(this), this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.average = this.widget.average, this.barCreatedFunction = this.widget.barCreatedFunction, this.bins = this.widget.bins, this.dataLineCreatedFunction = this.widget.dataLineCreatedFunction, this.dataLines = this.widget.dataLines, this.excludedBarColor = this.widget.excludedBarColor, this.icon = this.widget.icon, this.includedBarColor = this.widget.includedBarColor, this.label = this.widget.label, this.labelFormatFunction = this.widget.labelFormatFunction, this.max = this.widget.max, this.min = this.widget.min, this.position = "bottom-left", this.precision = this.widget.precision, this.rangeType = this.widget.rangeType, this.standardDeviation = this.widget.standardDeviation, this.standardDeviationCount = this.widget.standardDeviationCount, this.state = this.viewModel.state, this.values = this.widget.values, this.arcgisPropertyChange = e()("state"), this.arcgisReady = r();
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, average: 9, barCreatedFunction: 0, bins: 0, dataLineCreatedFunction: 0, dataLines: 0, excludedBarColor: 0, icon: 1, includedBarColor: 0, label: 1, labelFormatFunction: 0, max: 9, min: 9, position: 1, precision: 9, rangeType: 1, referenceElement: 1, standardDeviation: 9, standardDeviationCount: 9, state: 3, values: 0 };
+    this.properties = { autoDestroyDisabled: 5, average: 9, barCreatedFunction: 0, bins: 0, dataLineCreatedFunction: 0, dataLines: 0, excludedBarColor: 1, icon: 1, includedBarColor: 1, label: 1, labelFormatFunction: 0, max: 9, min: 9, position: 1, precision: 9, rangeType: 1, referenceElement: 1, standardDeviation: 9, standardDeviationCount: 9, state: 3, values: 0 };
   }
   static {
     this.shadowRootOptions = o;
@@ -21,16 +21,9 @@ class g extends a {
   static {
     this.styles = h;
   }
-  // #endregion
-  // #region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
-  /**
-   * Generates a SQL where clause based on a given field and the slider's
-   * rangeType
-   */
   async generateWhereClause(t) {
     return this.widget.generateWhereClause(t);
   }

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

@@ -1,51 +1,62 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
-import { Use } from '@arcgis/components-controllers';
+import { Use } from '@arcgis/lumina/controllers';
 import { Nil } from '@arcgis/components-utils';
 import { default as HomeViewModel } from '@arcgis/core/widgets/Home/HomeViewModel.js';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useHomeViewModel: (component: import('@arcgis/components-controllers').StencilLifecycles & {
-    manager: import('@arcgis/components-controllers').ControllerManager;
-    el: HTMLElement;
-    autoDestroyDisabled?: boolean;
-    destroy?: () => Promise<void>;
-} & Pick<HomeViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<HomeViewModel>, options?: {
+declare const useHomeViewModel: (component: LitElement & Pick<HomeViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<HomeViewModel>, options?: {
     editConstructorProperties(props: unknown): unknown;
 } | undefined) => HomeViewModel;
 /**
- * Provides a simple widget that switches the esri/views/View to its
- * initial esri/Viewpoint or a previously defined `viewpoint`.
+ * Home component is a button that switches the view to its
+ * initial [Viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-Viewpoint.html)
+ * or a previously defined `viewpoint`.
  *
- * @since 4.0
- */
-/** Home component enables switching the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html) to its initial [Viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-Viewpoint.html) or a previously defined viewpoint.
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-home/)
  */
 export declare class ArcgisHome extends LitElement {
-    private messages;
     /**
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the
      * component to a different place on the page, or temporarily hide it. If this
-     * is set, make sure to call the \`destroy\` method when you are done to prevent
-     * memory leaks.
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-home/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * This function provides the ability to override either the
+     * [MapView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo) or
+     * [SceneView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo) methods.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Home-HomeViewModel.html#goToOverride)
+     */
     goToOverride: nullish | __esri.GoToOverride;
     /**
-     * Icon displayed in the widget's button.
+     * Icon which represents the component.
+     * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
-     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
-     * @since 4.28
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "home"
      */
     icon: Nil | string;
     /** The component's default label. */
     label: Nil | string;
-    /** Overwrite localized strings for this component */
+    /** Replace localized message strings with your own strings. */
     messageOverrides?: typeof this.messages._overrides;
+    /** @default "top-left" */
     position: __esri.UIPosition;
     referenceElement: ArcgisReferenceElement | Nil | string;
+    /**
+     * The current state of the widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Home-HomeViewModel.html#state)
+     *
+     * @default "disabled"
+     */
     readonly state: "ready" | "disabled" | "going-home";
     /**
      * The esri/Viewpoint, or point of view, to zoom to when
@@ -64,8 +75,9 @@ export declare class ArcgisHome extends LitElement {
      *
      * // Sets the model's viewpoint to the Viewpoint based on a polygon geometry
      * home.viewpoint = vp;
+     * @default null
      */
-    viewpoint: __esri.Viewpoint | nullish;
+    viewpoint: nullish | __esri.Viewpoint;
     /**
      * This function provides the ability to interrupt and cancel the process
      * of navigating the view back to the view's initial extent.
@@ -73,7 +85,7 @@ export declare class ArcgisHome extends LitElement {
      * @since 4.9
      */
     cancelGo(): Promise<void>;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     /**
      * Animates the view to the initial Viewpoint of the view or the
@@ -89,9 +101,20 @@ export declare class ArcgisHome extends LitElement {
      * });
      */
     readonly arcgisGo: TargetedEvent<this, __esri.HomeViewModelGoEvent>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, undefined>;
+    private messages: Partial<{
+        componentLabel: string;
+        title: string;
+        cancel: string;
+    }> & import('@arcgis/lumina/controllers').T9nMeta<{
+        componentLabel: string;
+        title: string;
+        cancel: string;
+    }>;
 }
 export {};