@geoscene/common-components 5.0.19

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

@@ -0,0 +1,258 @@
+/// <reference path="../../index.d.ts" />
+import type { DataLine, HistogramColorStops, HistogramLayout } from "./types.js";
+import type { HistogramBin } from "@geoscene/core/smartMapping/statistics/types.js";
+import type { PublicLitElement as LitElement } from "@geoscene/lumina";
+import type { T9nMeta } from "@geoscene/lumina/controllers";
+
+/**
+ * Renders a histogram to visualize the spread of a dataset based on [bins](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-histogram/#bins) representing buckets, or sub-ranges, of
+ * data. Each [bin](https://doc.geoscene.cn/javascript/5.0/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://doc.geoscene.cn/javascript/5.0/references/core/smartMapping/statistics/histogram/)
+ * module, then apply them to the component, as shown in the example below.
+ *
+ * ```js
+ * const params = {
+ *   layer: povLayer,
+ *   field: "POP_POVERTY",
+ *   normalizationField: "TOTPOP_CY",
+ *   numBins: 30
+ * };
+ *
+ * const results = await histogram(params);
+ * const histogramElement = document.querySelector("geoscene-histogram");
+ *
+ * histogramElement.bins = results.bins;
+ * histogramElement.min = results.minValue;
+ * histogramElement.max = results.maxValue;
+ * ```
+ *
+ * Other properties of this component allow you to display meaningful values on the histogram, such as the [average](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-histogram/#average),
+ * [standardDeviation](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-histogram/#standardDeviation), and the [dataLines](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-histogram/#dataLines) properties.
+ *
+ * The [layout](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-histogram/#layout) property allows you to set the orientation of the histogram, and the [colorStops](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-histogram/#colorStops)
+ * property allows you to set a gradient or color scheme for the histogram bars.
+ *
+ * See the image below for a summary of the configurable options available on the histogram.
+ *
+ * ![Histogram with annotations](https://doc.geoscene.cn/javascript/5.0/assets/references/core/widgets/histogram-basic-labels.png "Histogram with annotations")
+ *
+ * The [colorStops](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-histogram/#colorStops) property may be used to define a color scheme for the histogram bars.
+ *
+ * ![Histogram with color](https://doc.geoscene.cn/javascript/5.0/assets/references/core/widgets/histogram-colors.png "Histogram with color")
+ *
+ * @cssproperty [--geoscene-histogram-bar-color] - Specifies the color of the histogram bars when the bin doesn't have a corresponding color stop.
+ * @cssproperty [--geoscene-histogram-stop-color] - Specifies the default color for color stops.
+ * @see [histogram module](https://doc.geoscene.cn/javascript/5.0/references/core/smartMapping/statistics/histogram/)
+ * @see [Sample - Histogram component](https://doc.geoscene.cn/javascript/5.0/sample-code/histogram/)
+ * @since 5.0
+ */
+export abstract class GeosceneHistogram extends LitElement {
+  /** @internal */
+  protected _messages: Partial<{
+      componentLabel: string;
+      barLabel: string;
+  }> & T9nMeta<{
+      componentLabel: string;
+      barLabel: string;
+  }>;
+  /**
+   * The statistical average of the data in the histogram. You would typically
+   * get this value from the `avg` property of
+   * [SummaryStatisticsResult](https://doc.geoscene.cn/javascript/5.0/references/core/smartMapping/statistics/summaryStatistics/#SummaryStatisticsResult),
+   * which is the result of the
+   * [summaryStatistics](https://doc.geoscene.cn/javascript/5.0/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://doc.geoscene.cn/javascript/5.0/references/core/smartMapping/statistics/summaryStatistics/#summaryStatistics)
+   * @example
+   * ```js
+   * // sets result returned from a smart mapping method
+   * // to the histogram
+   * histogram.average = response.statistics.avg;
+   * ```
+   * @example
+   * ```js
+   * histogram.average = 34.5;
+   * ```
+   */
+  accessor average: number | undefined;
+  /**
+   * An array of objects representing each bin in the histogram. This
+   * information is typically returned from the
+   * [histogram](https://doc.geoscene.cn/javascript/5.0/references/core/smartMapping/statistics/histogram/#histogram) function.
+   *
+   * @example
+   * ```js
+   * // sets the bins of the histogram from the bins in the histogram() result
+   * histogram.bins = histogramResult.bins;
+   * ```
+   * @example
+   * ```js
+   * // 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 }
+   * ];
+   * ```
+   */
+  accessor bins: HistogramBin[] | undefined;
+  /**
+   * 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](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-histogram/#colorStops) property is set to classed color stops.
+   *
+   * @default false
+   */
+  accessor colorBlendingEnabled: boolean;
+  /**
+   * An array of color stops used to define the color scheme for the histogram bars.
+   * There are two types of color stops:
+   * - **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 omitted, the bar will be colored using the CSS variable `--geoscene-histogram-stop-color`.
+   *
+   * When a bar is not covered by any color stop, it will be colored using the CSS variable `--geoscene-histogram-bar-color`.
+   *
+   * @example
+   * ```js
+   * // Define continuous color stops on the histogram.
+   * // The color of the bar is determined by interpolating between the colors of the stops surrounding the value of the bin.
+   * histogram.colorStops = [
+   *   { color: "#ff0000", value: 0 },
+   *   { color: "#ffff00", value: 50 },
+   *   { color: "#00ff00", value: 100 }
+   * ];
+   * ```
+   * @example
+   * ```js
+   * // Define classed color stops on the histogram.
+   * // The color of the bar is determined by the color of the stop that contains the value of the bin.
+   * histogram.colorStops = [
+   *   { color: "#ff0000", minValue: 0, maxValue: 50 },
+   *   { color: "#00ff00", minValue: 50, maxValue: 100 },
+   * ];
+   * ```
+   */
+  accessor colorStops: HistogramColorStops | undefined;
+  /**
+   * When set, renders lines on the histogram that indicate important or
+   * meaningful values to the end user.
+   *
+   * @example
+   * ```js
+   * // 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
+   * ```js
+   * // 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((stddev) => {
+   *   return {
+   *     value: stddev
+   *   };
+   * });
+   * ```
+   * @see [smartMappingUtils.getDeviationValues](https://doc.geoscene.cn/javascript/5.0/references/core/widgets/smartMapping/support/utils/#getDeviationValues)
+   */
+  accessor dataLines: DataLine[] | undefined;
+  /**
+   * 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://doc.geoscene.cn/calcite-design-system/icons/) for possible values.
+   *
+   * @default "graph-histogram"
+   */
+  accessor icon: string | undefined;
+  /** The component's default label. */
+  accessor label: string | undefined;
+  /**
+   * Determines the orientation of the histogram.
+   *
+   * @default "horizontal"
+   * @example
+   * ```js
+   * histogram.layout = "vertical";
+   * ```
+   */
+  accessor layout: HistogramLayout;
+  /**
+   * The maximum value or bound of the entire histogram. This
+   * should match the maximum bound of the last [bins](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-histogram/#bins).
+   *
+   * @example
+   * ```js
+   * histogram.max = 100;
+   * ```
+   * @example
+   * ```js
+   * // 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.
+   *
+   * _**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 [bins](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-histogram/#bins).
+   *
+   * @example
+   * ```js
+   * histogram.min = 0;
+   * ```
+   * @example
+   * ```js
+   * // 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://doc.geoscene.cn/javascript/5.0/references/core/smartMapping/statistics/summaryStatistics/#SummaryStatisticsResult),
+   * which is the result of the
+   * [summaryStatistics](https://doc.geoscene.cn/javascript/5.0/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://doc.geoscene.cn/javascript/5.0/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/geoscene-histogram/customElement.js

@@ -0,0 +1,194 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.0/LICENSE.txt */
+import { c as I } from "../../chunks/runtime.js";
+import { u as O } from "../../chunks/useT9n.js";
+import { substitute as S } from "@geoscene/core/intl.js";
+import { LitElement as k, safeClassMap as p, nothing as h, safeStyleMap as w } from "@geoscene/lumina";
+import { css as R, html as L, svg as b } 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;--geoscene-histogram-bar-color: var(--calcite-color-border-1);--geoscene-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)
+    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);
+  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, $];
+  });
+}
+function N(t, i, n, e, r) {
+  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;
+}
+function P(t, i, n, e, r) {
+  if (n == null)
+    return [0, 0, 0, 0];
+  const s = Math.round((r - n) / e * 100) / 100, [a, o] = t;
+  if (i === "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) {
+  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];
+}
+function A(t, i, n) {
+  if (!t || t.length === 0)
+    return null;
+  if (_(t)) {
+    const e = t.map((r) => ({
+      ...r,
+      color: D(r.color ?? n)
+    }));
+    return e.unshift({
+      color: i,
+      minValue: Number.NEGATIVE_INFINITY,
+      maxValue: e[0].minValue
+    }), e.push({
+      color: i,
+      minValue: e[e.length - 1].maxValue,
+      maxValue: Number.POSITIVE_INFINITY
+    }), e;
+  } else
+    return t.map((e) => ({
+      ...e,
+      color: D(e.color ?? n)
+    }));
+}
+function H(t, i, n, e) {
+  if (!t || t.length === 0)
+    return n;
+  if (_(t)) {
+    const r = W(t, i);
+    if (r.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;
+      return `color-mix(in srgb, ${s} ${a / c * 100}%, ${o} ${l / c * 100}%)`;
+    }
+    return r[0].color ?? n;
+  }
+  return G(t, i);
+}
+function W(t, i) {
+  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 });
+  }
+  return n.sort((e, r) => r.weight - e.weight);
+}
+function G(t, i) {
+  const n = (i.maxValue - i.minValue) / 2 + i.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;
+    if (n < s.value) {
+      const a = (n - r.value) / (s.value - r.value) * 100;
+      return `color-mix(in srgb, ${r.color}, ${s.color} ${a}%)`;
+    }
+  }
+  return t[t.length - 1].color;
+}
+function _(t) {
+  return t[0] != null && "minValue" in t[0];
+}
+function D(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})`;
+}
+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) => {
+    const l = o.length / 2, c = s > e ? "+" : "-", u = a >= l ? a - l + 1 : l - a;
+    return {
+      symbol: `${c}${u === 1 ? "" : u}σ`,
+      value: s
+    };
+  });
+}
+function U(t, i) {
+  if (i == null || t == null)
+    return [];
+  const n = 1, e = [];
+  for (let r = n * -1; r <= n; r++)
+    r !== 0 && e.push(i + r * t);
+  return e;
+}
+const V = "var(--geoscene-histogram-bar-color)", j = "var(--geoscene-histogram-stop-color)";
+class q extends k {
+  constructor() {
+    super(...arguments), this._messages = O(), this._normalizedStops = null, this._formatLabel = (i) => z(this._messages._lang, this._numberFormatterOptions).format(i), this._numberFormatterOptions = {
+      maximumFractionDigits: 2
+    }, this.containerDimensions = [0, 0], this.icon = "graph-histogram", this.layout = "horizontal", this.colorBlendingEnabled = !1;
+  }
+  static {
+    this.properties = { containerDimensions: 16, colorStops: 0, icon: 3, average: 11, messageOverrides: 0, standardDeviation: 11, bins: 0, dataLines: 0, label: 1, layout: 3, max: 11, min: 11, colorBlendingEnabled: 5 };
+  }
+  static {
+    this.styles = F;
+  }
+  loaded() {
+    const i = new ResizeObserver((r) => {
+      for (const s of r) {
+        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);
+  }
+  willUpdate(i) {
+    i.has("colorStops") && (this._normalizedStops = A(this.colorStops, V, j));
+  }
+  render() {
+    const { label: i } = this;
+    return this.containerDimensions ? L`<div role=img .ariaLabel=${i ?? void 0} class=${p(f.content)}>${this._renderContent()}</div>` : null;
+  }
+  _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>`;
+  }
+  _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)
+      })} .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 }));
+  }
+}
+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>`;
+};
+I("geoscene-histogram", q);
+export {
+  q as GeosceneHistogram
+};

package/dist/components/geoscene-histogram/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/geoscene-histogram/index.js

@@ -0,0 +1 @@
+export * from "./customElement.js";

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

@@ -0,0 +1,26 @@
+export type DataLine = {
+  value: number;
+  label?: number | string | null;
+};
+
+export type HistogramColorStops = HistogramClassedColorStop[] | HistogramContinuousColorStop[];
+
+export type HistogramLayout = "horizontal" | "vertical";
+
+export type HistogramContinuousColorStop = {
+  color: HistogramColor;
+  value: number;
+};
+
+export type HistogramClassedColorStop = {
+  color?: HistogramColor;
+  minValue: number;
+  maxValue: number;
+};
+
+export type HistogramColor = number[] | string | {
+    r?: number;
+    g?: number;
+    b?: number;
+    a?: number;
+};

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

@@ -0,0 +1,48 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@geoscene/lumina";
+import type { Button as Button } from "@geoscene/calcite-components/components/calcite-button";
+import type { InputNumber as InputNumber } from "@geoscene/calcite-components/components/calcite-input-number";
+
+/** @internal */
+export abstract class GeosceneLabelInput extends LitElement {
+  /**
+   * Specifies the alignment of the component's text elements.
+   *
+   * @default "center"
+   */
+  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()](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-label-input/#edit) is called.
+   * The value is always `false` when the component is in [readOnly](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-label-input/#readOnly) mode.
+   *
+   * @default false
+   * @see [edit()](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-label-input/#edit)
+   */
+  get editing(): boolean;
+  /** A function used to format the value. */
+  accessor labelFormatter: (value: number, defaultFormatter: (value: number) => string) => string | null | undefined;
+  /**
+   * Indicates whether the component is in read-only mode.
+   *
+   * @default false
+   */
+  accessor readOnly: boolean;
+  /**
+   * The value the component displays.
+   *
+   * @default 0
+   */
+  accessor value: number;
+  /**
+   * Initiates the edit mode for the component.
+   *
+   * @see [editing](https://doc.geoscene.cn/javascript/5.0/references/common-components/components/geoscene-label-input/#editing)
+   */
+  edit(): Promise<void>;
+  /** Fires each time a new value is typed and committed. */
+  readonly geosceneChange: import("@geoscene/lumina").TargetedEvent<this, void>;
+  readonly "@eventTypes": {
+    geosceneChange: GeosceneLabelInput["geosceneChange"]["detail"];
+  };
+}

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

@@ -0,0 +1,116 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.0/LICENSE.txt */
+import { c as o } from "../../chunks/runtime.js";
+import { formatNumber as u } from "@geoscene/core/intl.js";
+import { LitElement as c, createEvent as h, safeClassMap as d } from "@geoscene/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 = s(), this._inputRef = s(), this._labelRef = s(), this._formatOptions = {
+      style: "decimal",
+      useGrouping: !0,
+      minimumFractionDigits: 0,
+      maximumFractionDigits: 2
+    }, 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.geosceneChange = h({ cancelable: !1 });
+  }
+  static {
+    this.properties = { _displayedValue: 16, _editing: 16, alignment: 3, editing: 39, labelFormatter: 0, readOnly: 7, value: 11 };
+  }
+  static {
+    this.styles = m;
+  }
+  static {
+    this.shadowRootOptions = { mode: "open", delegatesFocus: !0 };
+  }
+  get editing() {
+    return this._editing;
+  }
+  async edit() {
+    this._enterEdit();
+  }
+  getLabelBoundingClientRect() {
+    return this._labelRef.value ? this._labelRef.value.getBoundingClientRect() : this.el.getBoundingClientRect();
+  }
+  willUpdate(t) {
+    if (t.has("value") || t.has("labelFormatter")) {
+      const e = this.value;
+      this._displayedValue = this._internalLabelFormatter(e);
+    }
+  }
+  updated(t) {
+    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 () => {
+      const t = this._inputRef.value;
+      await t?.setFocus(), await t?.selectText();
+    }));
+  }
+  _exitEdit(t, e = !1) {
+    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();
+    }));
+  }
+  _commitValue(t) {
+    const e = this._parseNumber(t?.value ?? "");
+    e !== null && this.value !== e && (this.value = e, this.geosceneChange.emit());
+  }
+  _parseNumber(t) {
+    if (t.trim() === "")
+      return null;
+    const e = Number(t);
+    return Number.isFinite(e) ? e : this.value ?? null;
+  }
+  _internalLabelFormatter(t) {
+    const e = this.labelFormatter;
+    if (!e)
+      return this._formatValue(t);
+    const i = e(t, this._formatValue);
+    return i ?? this._formatValue(t);
+  }
+  _onBlur() {
+    this._exitEdit(!0, !0);
+  }
+  _onValueChange(t) {
+    this._commitValue(t.currentTarget);
+  }
+  _onKeyDown(t) {
+    t.key === "Enter" ? (this._exitEdit(!0), t.stopPropagation(), t.preventDefault()) : t.key === "Escape" && (this._exitEdit(!1), t.stopPropagation(), t.preventDefault());
+  }
+  _onPointerDown(t) {
+    this._pointerDownPosition = { x: t.clientX, y: t.clientY };
+  }
+  _onClick(t) {
+    if (this._pointerDownPosition) {
+      const e = t.clientX - this._pointerDownPosition.x, i = t.clientY - this._pointerDownPosition.y;
+      if (Math.sqrt(e * e + i * i) > 2)
+        return;
+    }
+    this._enterEdit(), this._pointerDownPosition = null;
+  }
+  _onInput(t) {
+    const e = this._parseNumber(t.currentTarget.value ?? "");
+    if (e === null) {
+      this._displayedValue = "";
+      return;
+    }
+    this._displayedValue = this._internalLabelFormatter(e);
+  }
+  render() {
+    const { alignment: t, _displayedValue: e } = this, i = [
+      n`<span class="readOnlyLabel"><span ${l(this._labelRef)}>${e}</span></span>`
+    ];
+    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>`;
+  }
+}
+o("geoscene-label-input", f);
+export {
+  f as GeosceneLabelInput
+};

package/dist/components/geoscene-label-input/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/geoscene-label-input/index.js

@@ -0,0 +1,3 @@
+import "@geoscene/calcite-components/components/calcite-button";
+import "@geoscene/calcite-components/components/calcite-input-number";
+export * from "./customElement.js";