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

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

@@ -5,10 +5,10 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
- * Renders a histogram to visualize the spread of a dataset based on [bins](#bins) representing buckets, or sub-ranges, of
- * data. Each [bin](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-statistics-types.html#HistogramBin) is defined by a minimum and maximum value and a total count.
+ * Renders a histogram to visualize the spread of a dataset based on [bins](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-histogram/#bins) representing buckets, or sub-ranges, of
+ * data. Each [bin](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/types/#HistogramBin) is defined by a minimum and maximum value and a total count.
  *
- * You can generate the underlying histogram's bins with the [histogram](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-statistics-histogram.html)
+ * You can generate the underlying histogram's bins with the [histogram](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/histogram/)
  * module, then apply them to the component, as shown in the example below.
  *
  * ```js
@@ -27,26 +27,25 @@ import type { T9nMeta } from "@arcgis/lumina/controllers";
  * histogramElement.max = results.maxValue;
  * ```
  *
- * Other properties of this component allow you to display meaningful values on the histogram, such as the [average](#average),
- * [one standard deviation](#standardDeviation), and the [dataLines](#dataLines) properties.
+ * Other properties of this component allow you to display meaningful values on the histogram, such as the [average](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-histogram/#average),
+ * [standardDeviation](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-histogram/#standardDeviation), and the [dataLines](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-histogram/#dataLines) properties.
  *
- * The [layout](#layout) property allows you to set the orientation of the histogram, and the [colorStops](#colorStops)
+ * The [layout](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-histogram/#layout) property allows you to set the orientation of the histogram, and the [colorStops](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-histogram/#colorStops)
  * property allows you to set a gradient or color scheme for the histogram bars.
  *
- * <a name="image-annotations"></a>
- * See the image below for a summary of the configurable options available on this slider.
+ * See the image below for a summary of the configurable options available on the histogram.
  *
- * ![Histogram with annotations](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/histogram-basic-labels.png "Histogram with annotations")
+ * ![Histogram with annotations](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/histogram-basic-labels.avif "Histogram with annotations")
  *
- * The [colorStops](#colorStops) property may be used to define a color scheme for the histogram bars.
+ * The [colorStops](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-histogram/#colorStops) property may be used to define a color scheme for the histogram bars.
  *
- * ![Histogram with color](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/histogram-colors.png "Histogram with color")
- *
- * **See also:**
- * - [histogram module](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-statistics-histogram.html)
+ * ![Histogram with color](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/histogram-colors.avif "Histogram with color")
  *
  * @cssproperty [--arcgis-histogram-bar-color] - Specifies the color of the histogram bars when the bin doesn't have a corresponding color stop.
  * @cssproperty [--arcgis-histogram-stop-color] - Specifies the default color for color stops.
+ * @see [histogram module](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/histogram/)
+ * @see [Sample - Histogram component](https://developers.arcgis.com/javascript/latest/sample-code/histogram/)
+ * @since 5.0
  */
 export abstract class ArcgisHistogram extends LitElement {
   /** @internal */
@@ -60,13 +59,13 @@ export abstract class ArcgisHistogram extends LitElement {
   /**
    * 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-summaryStatistics.html#SummaryStatisticsResult),
+   * [SummaryStatisticsResult](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/summaryStatistics/#SummaryStatisticsResult),
    * which is the result of the
-   * [summaryStatistics](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-statistics-summaryStatistics.html#summaryStatistics) function.
+   * [summaryStatistics](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/summaryStatistics/#summaryStatistics) function.
    *
    * When set, this value will render on the histogram with a symbol indicating it is the average.
    *
-   * @see [summaryStatistics](https://developers.arcgis.com/javascript/latest/api-reference/esri-smartMapping-statistics-summaryStatistics.html#summaryStatistics)
+   * @see [summaryStatistics](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/summaryStatistics/#summaryStatistics)
    * @example
    * ```js
    * // sets result returned from a smart mapping method
@@ -82,7 +81,7 @@ export abstract class ArcgisHistogram extends LitElement {
   /**
    * 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#histogram) function.
+   * [histogram](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/histogram/#histogram) function.
    *
    * @example
    * ```js
@@ -108,7 +107,7 @@ export abstract class ArcgisHistogram extends LitElement {
    * When set to `true`, overlapping classed color stops will be blended together to create the color of the bar.
    * This allows to show a if a bar representing a bin overlaps with multiple classed color stops.
    *
-   * This property is only applicable when the [colorStops](#colorStops) property is set to classed color stops.
+   * This property is only applicable when the [colorStops](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-histogram/#colorStops) property is set to classed color stops.
    *
    * @default false
    */
@@ -119,7 +118,7 @@ export abstract class ArcgisHistogram extends LitElement {
    * - **Continuous color stops**: Each stop is defined by a `color` and a value. The color of the bar is determined by interpolating between the
    *   colors of the stops surrounding the value of the bin.
    * - **Classed color stops**: Each stop is defined by a `color` and a `minValue` and `maxValue`. The color of the bar is determined by the color of the stop
-   *  that contains the value of the bin. If the `color` is ommitted, the bar will be colored using the CSS variable `--arcgis-histogram-stop-color`.
+   *  that contains the value of the bin. If the `color` is omitted, the bar will be colored using the CSS variable `--arcgis-histogram-stop-color`.
    *
    * When a bar is not covered by any color stop, it will be colored using the CSS variable `--arcgis-histogram-bar-color`.
    *
@@ -176,7 +175,7 @@ export abstract class ArcgisHistogram extends LitElement {
    *   };
    * });
    * ```
-   * @see [smartMappingUtils.getDeviationValues](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-smartMapping-support-utils.html#getDeviationValues)
+   * @see [smartMappingUtils.getDeviationValues](https://developers.arcgis.com/javascript/latest/references/core/widgets/smartMapping/support/utils/#getDeviationValues)
    */
   accessor dataLines: DataLine[] | undefined;
   /**
@@ -201,7 +200,7 @@ export abstract class ArcgisHistogram extends LitElement {
   accessor layout: HistogramLayout;
   /**
    * The maximum value or bound of the entire histogram. This
-   * should match the maximum bound of the last [bin](#bins).
+   * should match the maximum bound of the last [bins](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-histogram/#bins).
    *
    * @example
    * ```js
@@ -209,20 +208,23 @@ export abstract class ArcgisHistogram extends LitElement {
    * ```
    * @example
    * ```js
-   * // sets result returned from a smart mapping method
-   * // to the histogram
+   * // sets result returned from a smart mapping method to the histogram
    * histogram.max = response.statistics.max;
    * ```
    */
   accessor max: number | undefined;
-  /** Replace localized message strings with your own strings. */
+  /**
+   * Replace localized message strings with your own strings.
+   *
+   * _**Note**: Individual message keys may change between releases._
+   */
   accessor messageOverrides: {
       componentLabel?: string | undefined;
       barLabel?: string | undefined;
   };
   /**
    * The minimum value or bound of the entire histogram. This
-   * should match the minimum bound of the first [bin](#bins).
+   * should match the minimum bound of the first [bins](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-histogram/#bins).
    *
    * @example
    * ```js
@@ -230,11 +232,27 @@ export abstract class ArcgisHistogram extends LitElement {
    * ```
    * @example
    * ```js
-   * // sets result returned from a smart mapping method
-   * // to the histogram
+   * // sets result returned from a smart mapping method to the histogram
    * histogram.min = response.statistics.min;
    * ```
    */
   accessor min: number | undefined;
+  /**
+   * The statistical standard deviation of the data in the histogram. You would typically
+   * get this value from the `stddev` property of
+   * [SummaryStatisticsResult](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/summaryStatistics/#SummaryStatisticsResult),
+   * which is the result of the
+   * [summaryStatistics](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/summaryStatistics/#summaryStatistics) function.
+   *
+   * When set, this value will render on the histogram with symbols indicating standard deviation intervals from the mean.
+   *
+   * @see [summaryStatistics](https://developers.arcgis.com/javascript/latest/references/core/smartMapping/statistics/summaryStatistics/#summaryStatistics)
+   * @example
+   * ```js
+   * // sets result returned from a smart mapping method
+   * // to the histogram
+   * histogram.standardDeviation = response.statistics.stddev;
+   * ```
+   */
   accessor standardDeviation: number | undefined;
 }

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

@@ -1,130 +1,121 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { c as I } from "../../chunks/runtime.js";
-import { u as O } from "../../chunks/useT9n.js";
-import { substitute as S } from "@arcgis/core/intl.js";
-import { LitElement as k, safeClassMap as p, nothing as h, safeStyleMap as w } from "@arcgis/lumina";
-import { css as R, html as L, svg as b } from "lit";
+import { c as M } from "../../chunks/runtime.js";
+import { u as k } from "../../chunks/useT9n.js";
+import { substitute as E } from "@arcgis/core/intl.js";
+import { LitElement as I, nothing as h, safeStyleMap as v, safeClassMap as O } from "@arcgis/lumina";
+import { css as R, html as y, svg as f } from "lit";
 import { g as z } from "../../chunks/locale.js";
-const f = {
-  content: "content",
-  svg: "svg",
-  label: "label",
-  dataLine: "data-line",
-  averageDataLine: "average-data-line",
-  dataLineSymbol: "data-line-symbol"
-}, F = R`:host{display:flex;--arcgis-histogram-bar-color: var(--calcite-color-border-1);--arcgis-histogram-stop-color: color-mix(in srgb, var(--calcite-color-brand) 80%, transparent)}.content{display:flex;flex:1;direction:ltr}.svg{display:inline-block;flex:1;overflow:hidden}.data-line{stroke:#888;stroke-width:1px;shape-rendering:crispEdges}.average-data-line{stroke-width:1px;shape-rendering:crispEdges;stroke:#444}.label,.data-line-symbol{font-size:12px;stroke:#fff;stroke-width:2px;paint-order:stroke;unicode-bidi:plaintext}.data-line-symbol{font-family:"Georgia, serif",sans-serif;font-style:italic}`;
-function B(t, i, n, e, r) {
-  const [s, a] = r;
-  if (!t || a === 0 || s === 0 || n == null || i == null)
+const F = R`:host{display:block;--arcgis-histogram-bar-color: var(--calcite-color-border-1);--arcgis-histogram-stop-color: color-mix(in srgb, var(--calcite-color-brand) 80%, transparent)}.content{display:block;direction:ltr}.svg{display:block;width:100%;height:100%}.data-line{stroke:#888;stroke-width:1px;shape-rendering:crispEdges}.average-data-line{stroke-width:1px;shape-rendering:crispEdges;stroke:#444}.label,.data-line-symbol{font-size:12px;stroke:#fff;stroke-width:2px;paint-order:stroke;unicode-bidi:plaintext}.data-line-symbol{font-family:"Georgia, serif",sans-serif;font-style:italic}`;
+function S(t, r, n, e, i) {
+  const [s, a] = i;
+  if (!t || a === 0 || s === 0 || n == null || r == null)
     return null;
-  const o = n - i, c = (t.length > 1 ? t[t.length - 1].maxValue - t[0].minValue : 0) / o, [u, g] = e === "vertical" ? [a * c, s] : [a, s * c], x = t ? t.map((m) => m.count) : [], d = Math.max(...x);
+  const o = n - r, c = (t.length > 1 ? t[t.length - 1].maxValue - t[0].minValue : 0) / o, [u, g] = e === "vertical" ? [a * c, s] : [a, s * c], b = t ? t.map((m) => m.count) : [], d = Math.max(...b);
   return t.map((m) => {
-    const [$, v] = e === "vertical" ? [u / t.length, d !== 0 ? m.count / d * g : 0] : [d !== 0 ? m.count / d * u : 0, g / t.length], { maxValue: C } = m, y = n - C, [M, E] = e === "vertical" ? [0, y * (a / o)] : [s - v - y * (s / o), a - $];
-    return [M, E, v, $];
+    const [p, $] = e === "vertical" ? [u / t.length, d !== 0 ? m.count / d * g : 0] : [d !== 0 ? m.count / d * u : 0, g / t.length], { maxValue: D } = m, x = n - D, [_, C] = e === "vertical" ? [0, x * (a / o)] : [s - $ - x * (s / o), a - p];
+    return [_, C, $, p];
   });
 }
-function N(t, i, n, e, r) {
+function B(t, r, n, e, i) {
   const s = [];
   return t != null && s.push({
     value: t,
     symbol: "x̄",
-    lineClass: f.averageDataLine
-  }), i != null && n != null && e != null && s.push(...Y(n, e, i, t)), r && s.push(...r), s;
+    lineClass: "average-data-line"
+  }), r != null && n != null && e != null && s.push(...G(n, e, r, t)), i && s.push(...i), s;
 }
-function P(t, i, n, e, r) {
+function N(t, r, n, e, i) {
   if (n == null)
     return [0, 0, 0, 0];
-  const s = Math.round((r - n) / e * 100) / 100, [a, o] = t;
-  if (i === "vertical") {
+  const s = Math.round((i - n) / e * 100) / 100, [a, o] = t;
+  if (r === "vertical") {
     let c = o - s * o || 1;
     return c = Math.round(c) + 0.5, [0, "100%", c, c];
   }
   let l = s * a || 1;
   return l = Math.round(l) + 0.5, [l, l, "100%", 0];
 }
-function T(t, i, n, e, r) {
+function P(t, r, n, e, i) {
   if (n == null)
     return [0, 0];
-  const s = Math.round((r - n) / e * 100) / 100, [a, o] = t;
-  return i === "vertical" ? [a, o - s * o] : [0, s * a];
+  const s = Math.round((i - n) / e * 100) / 100, [a, o] = t;
+  return r === "vertical" ? [a, o - s * o] : [0, s * a];
 }
-function A(t, i, n) {
+function T(t, r, n) {
   if (!t || t.length === 0)
     return null;
-  if (_(t)) {
-    const e = t.map((r) => ({
-      ...r,
-      color: D(r.color ?? n)
+  if (L(t)) {
+    const e = t.map((i) => ({
+      ...i,
+      color: w(i.color ?? n)
     }));
     return e.unshift({
-      color: i,
+      color: r,
       minValue: Number.NEGATIVE_INFINITY,
       maxValue: e[0].minValue
     }), e.push({
-      color: i,
+      color: r,
       minValue: e[e.length - 1].maxValue,
       maxValue: Number.POSITIVE_INFINITY
     }), e;
   } else
     return t.map((e) => ({
       ...e,
-      color: D(e.color ?? n)
+      color: w(e.color ?? n)
     }));
 }
-function H(t, i, n, e) {
+function A(t, r, n, e) {
   if (!t || t.length === 0)
     return n;
-  if (_(t)) {
-    const r = W(t, i);
-    if (r.length === 0)
+  if (L(t)) {
+    const i = H(t, r);
+    if (i.length === 0)
       return n;
     if (e) {
-      const { color: s = n, weight: a } = r[0], { color: o = n, weight: l } = r[1] ?? r[0], c = a + l;
+      const { color: s = n, weight: a } = i[0], { color: o = n, weight: l } = i[1] ?? i[0], c = a + l;
       return `color-mix(in srgb, ${s} ${a / c * 100}%, ${o} ${l / c * 100}%)`;
     }
-    return r[0].color ?? n;
+    return i[0].color ?? n;
   }
-  return G(t, i);
+  return W(t, r);
 }
-function W(t, i) {
+function H(t, r) {
   const n = [];
   for (const e of t) {
-    const r = Math.max(0, Math.min(i.maxValue, e.maxValue) - Math.max(i.minValue, e.minValue));
-    r > 0 && n.push({ color: e.color, weight: r });
+    const i = Math.max(0, Math.min(r.maxValue, e.maxValue) - Math.max(r.minValue, e.minValue));
+    i > 0 && n.push({ color: e.color, weight: i });
   }
-  return n.sort((e, r) => r.weight - e.weight);
+  return n.sort((e, i) => i.weight - e.weight);
 }
-function G(t, i) {
-  const n = (i.maxValue - i.minValue) / 2 + i.minValue;
+function W(t, r) {
+  const n = (r.maxValue - r.minValue) / 2 + r.minValue;
   if (n > t[t.length - 1].value)
     return t[t.length - 1].color;
   for (let e = 0; e < t.length - 1; e++) {
-    const r = t[e], s = t[e + 1];
-    if (n <= r.value)
-      return r.color;
+    const i = t[e], s = t[e + 1];
+    if (n <= i.value)
+      return i.color;
     if (n < s.value) {
-      const a = (n - r.value) / (s.value - r.value) * 100;
-      return `color-mix(in srgb, ${r.color}, ${s.color} ${a}%)`;
+      const a = (n - i.value) / (s.value - i.value) * 100;
+      return `color-mix(in srgb, ${i.color}, ${s.color} ${a}%)`;
     }
   }
   return t[t.length - 1].color;
 }
-function _(t) {
+function L(t) {
   return t[0] != null && "minValue" in t[0];
 }
-function D(t) {
-  if (!t)
-    return;
+function w(t) {
   if (typeof t == "string")
     return t;
   if (Array.isArray(t))
     return `rgba(${t[0]}, ${t[1]}, ${t[2]}, ${t[3] ?? 1})`;
-  const { r: i, g: n, b: e, a: r = 1 } = t;
-  return `rgba(${i}, ${n}, ${e}, ${r})`;
+  const { r, g: n, b: e, a: i = 1 } = t;
+  return `rgba(${r}, ${n}, ${e}, ${i})`;
 }
-function Y(t, i, n, e) {
-  const r = 0.06 * (i - t);
-  return U(n, e).filter((s) => Math.abs(e - s) > r).map((s, a, o) => {
+function G(t, r, n, e) {
+  const i = 0.06 * (r - t);
+  return Y(n, e).filter((s) => Math.abs(e - s) > i).map((s, a, o) => {
     const l = o.length / 2, c = s > e ? "+" : "-", u = a >= l ? a - l + 1 : l - a;
     return {
       symbol: `${c}${u === 1 ? "" : u}σ`,
@@ -132,18 +123,18 @@ function Y(t, i, n, e) {
     };
   });
 }
-function U(t, i) {
-  if (i == null || t == null)
+function Y(t, r) {
+  if (r == null || t == null)
     return [];
   const n = 1, e = [];
-  for (let r = n * -1; r <= n; r++)
-    r !== 0 && e.push(i + r * t);
+  for (let i = n * -1; i <= n; i++)
+    i !== 0 && e.push(r + i * t);
   return e;
 }
-const V = "var(--arcgis-histogram-bar-color)", j = "var(--arcgis-histogram-stop-color)";
-class q extends k {
+const V = "var(--arcgis-histogram-bar-color)", U = "var(--arcgis-histogram-stop-color)";
+class j extends I {
   constructor() {
-    super(...arguments), this._messages = O(), this._normalizedStops = null, this._formatLabel = (i) => z(this._messages._lang, this._numberFormatterOptions).format(i), this._numberFormatterOptions = {
+    super(...arguments), this._messages = k(), this._normalizedStops = null, this._formatLabel = (r) => z(this._messages._lang, this._numberFormatterOptions).format(r), this._numberFormatterOptions = {
       maximumFractionDigits: 2
     }, this.containerDimensions = [0, 0], this.icon = "graph-histogram", this.layout = "horizontal", this.colorBlendingEnabled = !1;
   }
@@ -154,43 +145,43 @@ class q extends k {
     this.styles = F;
   }
   loaded() {
-    const i = new ResizeObserver((r) => {
-      for (const s of r) {
+    const r = new ResizeObserver((i) => {
+      for (const s of i) {
         const { width: a, height: o } = s.contentRect;
         this.containerDimensions = [a, o];
       }
     }), { width: n, height: e } = this.el.getBoundingClientRect();
-    this.containerDimensions = [n, e], i.observe(this.el);
+    this.containerDimensions = [n, e], r.observe(this.el);
   }
-  willUpdate(i) {
-    i.has("colorStops") && (this._normalizedStops = A(this.colorStops, V, j));
+  willUpdate(r) {
+    r.has("colorStops") && (this._normalizedStops = T(this.colorStops, V, U));
   }
   render() {
-    const { label: i } = this;
-    return this.containerDimensions ? L`<div role=img .ariaLabel=${i ?? void 0} class=${p(f.content)}>${this._renderContent()}</div>` : null;
+    const { label: r } = this;
+    return y`<div role=img .ariaLabel=${r ?? void 0} class="content">${this._renderContent()}</div>`;
   }
   _renderContent() {
-    const { containerDimensions: [i, n] } = this, e = "bg-fill";
-    return L`<svg class=${p(f.svg)} xmlns=http://www.w3.org/2000/svg>${b`<defs><clipPath id=${e}><rect height=${n ?? h} width=${i ?? h} x=0 y=0 /></clipPath></defs><g style=${w({ clipPath: `url(#${e})` })}><g>${this._renderBars()}</g></g><g>${this._renderLines()}</g>`}</svg>`;
+    const { containerDimensions: [r, n] } = this, e = "bg-fill";
+    return r ? y`<svg class="svg" xmlns=http://www.w3.org/2000/svg>${f`<defs><clipPath id=${e}><rect height=${n ?? h} width=${r ?? h} x=0 y=0 /></clipPath></defs><g style=${v({ clipPath: `url(#${e})` })}><g>${this._renderBars()}</g></g><g>${this._renderLines()}</g>`}</svg>` : null;
   }
   _renderBars() {
-    const { bins: i, _messages: n } = this, e = B(this.bins, this.min, this.max, this.layout, this.containerDimensions);
-    return !e || !i ? null : e.map((r, s) => {
-      const [a, o, l, c] = r, u = i[s], g = n?.barLabel ? S(n.barLabel, u) : "";
-      return b`<rect style=${w({
-        fill: H(this._normalizedStops, u, V, this.colorBlendingEnabled)
+    const { bins: r, _messages: n } = this, e = S(this.bins, this.min, this.max, this.layout, this.containerDimensions);
+    return !e || !r ? null : e.map((i, s) => {
+      const [a, o, l, c] = i, u = r[s], g = n?.barLabel ? E(n.barLabel, u) : "";
+      return f`<rect style=${v({
+        fill: A(this._normalizedStops, u, V, this.colorBlendingEnabled)
       })} .ariaLabel=${g} data-index=${s ?? h} height=${c ?? h} role=img shape-rendering=crispEdges stroke-width=0 width=${l ?? h} x=${a ?? h} y=${o ?? h} />`;
     });
   }
   _renderLines() {
-    return N(this.average, this.standardDeviation, this.min, this.max, this.dataLines)?.map((n) => J({ dataLine: n, containerDimensions: this.containerDimensions, layout: this.layout, min: this.min, max: this.max, labelFormatter: this._formatLabel }));
+    return B(this.average, this.standardDeviation, this.min, this.max, this.dataLines)?.map((n) => q({ dataLine: n, containerDimensions: this.containerDimensions, layout: this.layout, min: this.min, max: this.max, labelFormatter: this._formatLabel }));
   }
 }
-const J = (t) => {
-  const { containerDimensions: i, layout: n, min: e, max: r, dataLine: s, labelFormatter: a } = t, o = r != null && e != null ? r - e : 0, [l, c, u, g] = P(i, n, e, o, s.value), [x, d] = T(i, n, e, o, s.value), m = "symbol" in s ? [b`<tspan class=${p(f.dataLineSymbol)}>${s.symbol}</tspan>`, b`<tspan>${a(s.value)}</tspan>`] : s.label, $ = "lineClass" in s && s.lineClass ? s.lineClass : f.dataLine;
-  return b`<g><title>${s.value}</title><line class=${p($)} shape-rendering=crispEdges x1=${l ?? h} x2=${c ?? h} y1=${u ?? h} y2=${g ?? h} /><text class=${p(f.label)} text-anchor=end transform=${(n === "horizontal" ? "rotate(270)" : void 0) ?? h} x=${x ?? h} y=${d - 2}>${m}</text></g>`;
+const q = (t) => {
+  const { containerDimensions: r, layout: n, min: e, max: i, dataLine: s, labelFormatter: a } = t, o = i != null && e != null ? i - e : 0, [l, c, u, g] = N(r, n, e, o, s.value), [b, d] = P(r, n, e, o, s.value), m = "symbol" in s ? [f`<tspan class="data-line-symbol">${s.symbol}</tspan>`, f`<tspan>${a(s.value)}</tspan>`] : s.label, p = "lineClass" in s && s.lineClass ? s.lineClass : "data-line";
+  return f`<g><title>${s.value}</title><line class=${O(p)} shape-rendering=crispEdges x1=${l ?? h} x2=${c ?? h} y1=${u ?? h} y2=${g ?? h} /><text class="label" text-anchor=end transform=${(n === "horizontal" ? "rotate(270)" : void 0) ?? h} x=${b ?? h} y=${d - 2}>${m}</text></g>`;
 };
-I("arcgis-histogram", q);
+M("arcgis-histogram", j);
 export {
-  q as ArcgisHistogram
+  j as ArcgisHistogram
 };

package/dist/components/arcgis-histogram/types.d.ts

@@ -1,8 +1,6 @@
-/// <reference types="@arcgis/core/interfaces.d.ts" />
-
 export type DataLine = {
   value: number;
-  label?: nullish | number | string;
+  label?: number | string | null;
 };
 
 export type HistogramColorStops = HistogramClassedColorStop[] | HistogramContinuousColorStop[];

package/dist/components/arcgis-label-input/customElement.d.ts

@@ -1,9 +1,9 @@
 /// <reference path="../../index.d.ts" />
-/// <reference types="@arcgis/core/interfaces.d.ts" />
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { Button as Button } from "@esri/calcite-components/components/calcite-button";
 import type { InputNumber as InputNumber } from "@esri/calcite-components/components/calcite-input-number";
 
+/** @internal */
 export abstract class ArcgisLabelInput extends LitElement {
   /**
    * Specifies the alignment of the component's text elements.
@@ -13,15 +13,15 @@ export abstract class ArcgisLabelInput extends LitElement {
   accessor alignment: Button["alignment"] & InputNumber["alignment"];
   /**
    * Indicates whether the component is in edit mode.
-   * This value changes when user interacts with the component or when [edit()](#edit) is called.
-   * The value is always `false` when the component is in [read-only](#readOnly) mode.
+   * This value changes when user interacts with the component or when [edit()](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-label-input/#edit) is called.
+   * The value is always `false` when the component is in [readOnly](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-label-input/#readOnly) mode.
    *
    * @default false
-   * @see [edit()](#edit)
+   * @see [edit()](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-label-input/#edit)
    */
   get editing(): boolean;
   /** A function used to format the value. */
-  accessor labelFormatter: ((value: number, defaultFormatter: (value: number) => string) => nullish | string) | undefined;
+  accessor labelFormatter: (value: number, defaultFormatter: (value: number) => string) => string | null | undefined;
   /**
    * Indicates whether the component is in read-only mode.
    *
@@ -37,7 +37,7 @@ export abstract class ArcgisLabelInput extends LitElement {
   /**
    * Initiates the edit mode for the component.
    *
-   * @see [editing](#editing)
+   * @see [editing](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-label-input/#editing)
    */
   edit(): Promise<void>;
   /** Fires each time a new value is typed and committed. */

package/dist/components/arcgis-label-input/customElement.js

@@ -1,24 +1,24 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { c as l } from "../../chunks/runtime.js";
-import { formatNumber as r } from "@arcgis/core/intl.js";
-import { LitElement as o, createEvent as u } from "@arcgis/lumina";
-import { createRef as n, ref as a } from "lit/directives/ref.js";
-import { css as h, html as s } from "lit";
-const c = h`:host{display:block}:host([hidden]){display:none}.readOnlyLabel{display:block;font-size:var(--calcite-font-size-sm);font-variant-numeric:tabular-nums;line-height:var(--calcite-font-line-height-sm);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;padding-inline:.5rem;padding-block:3px;border-color:var(--calcite-color-transparent);border-style:solid;border-width:var(--calcite-button-border-size, 1px);color:var(--calcite-color-text-1)}:host(:not([read-only])) .readOnlyLabel{position:absolute;opacity:0}:host([alignment="start"]){.readOnlyLabel{text-align:start}}:host([alignment="end"]){.readOnlyLabel{text-align:end}}:host([alignment="center"]){.readOnlyLabel{text-align:center}}calcite-button{inline-size:100%;--calcite-offset-invert-focus: 1;--calcite-internal-animation-timing-fast: 0}calcite-input-number{inline-size:100%;--calcite-internal-animation-timing-fast: 0}`;
-class d extends o {
+import { c as o } from "../../chunks/runtime.js";
+import { formatNumber as u } from "@arcgis/core/intl.js";
+import { LitElement as c, createEvent as h, safeClassMap as d } from "@arcgis/lumina";
+import { createRef as s, ref as l } from "lit/directives/ref.js";
+import { css as p, html as n } from "lit";
+const m = p`:host{display:block}:host([hidden]){display:none}.content{display:flex;flex-direction:column}.readOnlyLabel{display:block;font-size:var(--calcite-font-size-sm);font-variant-numeric:tabular-nums;line-height:var(--calcite-font-line-height-sm);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;padding-inline:.5rem;padding-block:3px;border-color:var(--calcite-color-transparent);border-style:solid;border-width:var(--calcite-button-border-size, 1px);color:var(--calcite-color-text-1)}:host(:not([read-only])) .readOnlyLabel{position:absolute;opacity:0}:host([alignment="start"]){.content{align-items:start}.readOnlyLabel{text-align:start}}:host([alignment="end"]){.content{align-items:end}.readOnlyLabel{text-align:end}}:host([alignment="center"]){.content{align-items:center}.readOnlyLabel{text-align:center}}calcite-button{inline-size:100%;--calcite-offset-invert-focus: 1;--calcite-internal-animation-timing-fast: 0}calcite-input-number{inline-size:100%;--calcite-internal-animation-timing-fast: 0}`;
+class f extends c {
   constructor() {
-    super(...arguments), this._buttonRef = n(), this._inputRef = n(), this._labelRef = n(), this._formatOptions = {
+    super(...arguments), this._buttonRef = s(), this._inputRef = s(), this._labelRef = s(), this._formatOptions = {
       style: "decimal",
       useGrouping: !0,
       minimumFractionDigits: 0,
       maximumFractionDigits: 2
-    }, this._formatValue = (t) => r(t, this._formatOptions), this._pointerDownPosition = null, this._displayedValue = "", this._editing = !1, this.alignment = "center", this.readOnly = !1, this.value = 0, this.arcgisChange = u({ cancelable: !1 });
+    }, this._formatValue = (t) => u(t, this._formatOptions), this._pointerDownPosition = null, this._displayedValue = "", this._editing = !1, this.alignment = "center", this.readOnly = !1, this.value = 0, this.arcgisChange = h({ cancelable: !1 });
   }
   static {
     this.properties = { _displayedValue: 16, _editing: 16, alignment: 3, editing: 39, labelFormatter: 0, readOnly: 7, value: 11 };
   }
   static {
-    this.styles = c;
+    this.styles = m;
   }
   static {
     this.shadowRootOptions = { mode: "open", delegatesFocus: !0 };
@@ -39,8 +39,11 @@ class d extends o {
     }
   }
   updated(t) {
-    const e = this._inputRef.value, i = this.renderRoot.querySelector(".readOnlyLabel");
-    e && i && (e.style.width = `${i.offsetWidth}px`);
+    const e = this._inputRef.value, i = this._buttonRef.value, a = this.renderRoot.querySelector(".readOnlyLabel");
+    if (e && i && a) {
+      const r = a.offsetWidth;
+      i.style.width = `${r}px`, e.style.width = `${r}px`;
+    }
   }
   _enterEdit() {
     this._editing || this.readOnly || (this._editing = !0, this.requestUpdate("editing", !1), this.updateComplete.then(async () => {
@@ -49,7 +52,7 @@ class d extends o {
     }));
   }
   _exitEdit(t, e = !1) {
-    this._editing && (t ? this._commitValue(this._inputRef.value) : this._inputRef.value && (this._displayedValue = this._internalLabelFormatter(this.value), this._inputRef.value.value = `${this.value}`), this._editing = !1, this.requestUpdate("editing", !0), e || this.updateComplete.then(async () => {
+    this._editing && (t && this._commitValue(this._inputRef.value), this._displayedValue = this._internalLabelFormatter(this.value), this._inputRef.value && (this._inputRef.value.value = `${this.value}`), this._editing = !1, this.requestUpdate("editing", !0), e || this.updateComplete.then(async () => {
       await this._buttonRef.value?.setFocus();
     }));
   }
@@ -100,12 +103,14 @@ class d extends o {
   }
   render() {
     const { alignment: t, _displayedValue: e } = this, i = [
-      s`<span class="readOnlyLabel"><span ${a(this._labelRef)}>${e}</span></span>`
+      n`<span class="readOnlyLabel"><span ${l(this._labelRef)}>${e}</span></span>`
     ];
-    return this.readOnly || i.push(s`<calcite-button .alignment=${t} appearance=transparent .hidden=${this._editing} kind=neutral @pointerdown=${this._onPointerDown} @click=${this._onClick} scale=s width=full ${a(this._buttonRef)}>${e}</calcite-button>`, s`<calcite-input-number .alignment=${t} group-separator .hidden=${!this._editing} number-button-type=none @calciteInputNumberChange=${this._onValueChange} @keydown=${this._onKeyDown} @blur=${this._onBlur} @input=${this._onInput} scale=s status=idle .value=${`${this.value}`} ${a(this._inputRef)}></calcite-input-number>`), i;
+    return this.readOnly || i.push(n`<calcite-button .alignment=${t} appearance=transparent .hidden=${this._editing} kind=neutral @pointerdown=${this._onPointerDown} @click=${this._onClick} scale=s width=full ${l(this._buttonRef)}>${e}</calcite-button>`, n`<calcite-input-number .alignment=${t} group-separator .hidden=${!this._editing} number-button-type=none @calciteInputNumberChange=${this._onValueChange} @keydown=${this._onKeyDown} @blur=${this._onBlur} @input=${this._onInput} scale=s status=idle .value=${`${this.value}`} ${l(this._inputRef)}></calcite-input-number>`), n`<div class=${d({
+      content: !0
+    })}>${i}</div>`;
   }
 }
-l("arcgis-label-input", d);
+o("arcgis-label-input", f);
 export {
-  d as ArcgisLabelInput
+  f as ArcgisLabelInput
 };

package/dist/components/arcgis-picker-input/customElement.d.ts

@@ -1,8 +1,9 @@
 /// <reference path="../../index.d.ts" />
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { IPopoverProps } from "../../utils/types.js";
+import type { PopoverProps } from "../../utils/types.js";
 import type { Icon as Icon } from "@esri/calcite-components/components/calcite-icon";
 
+/** @internal */
 export abstract class ArcgisPickerInput extends LitElement {
   /**
    * If true, disables the component.
@@ -27,7 +28,7 @@ export abstract class ArcgisPickerInput extends LitElement {
    */
   accessor label: string;
   /** Convenience prop to specify common popover props. */
-  accessor popoverProps: IPopoverProps | undefined;
+  accessor popoverProps: PopoverProps | undefined;
   /** Close the component. */
   close(): Promise<void>;
   /** Set focus on the component. */