@luzmo/analytics-components-kit 1.0.3-beta.1 → 1.0.3-beta.10

package/components/formula/formula.d.ts

@@ -0,0 +1,65 @@
+import '@luzmo/lucero/icon';
+import '@luzmo/lucero/progress-circle';
+import { type PropertyValues, type TemplateResult } from 'lit';
+import { LuzmoFormulaBase } from '@utils/formula/base/formula-base';
+import { FormulaDisplayStore } from '@utils/formula/store/formula-display-store';
+/**
+ * @customElement luzmo-formula
+ * @description A read-only display of a formula. The default `display="rich"`
+ * renders the expression as inline column / aggregation pills (no CodeMirror);
+ * `display="text"` renders it as plain text with an inline column-type icon per
+ * column reference. Column references resolve to their names from the datasets
+ * provided via `datasetsDataFields` or fetched from the Luzmo API via
+ * `dataset-ids` (+ auth). To edit a formula use `luzmo-formula-field` (a single
+ * field) or `luzmo-formula-editor` (the full builder with lists).
+ *
+ * @fires {CustomEvent<DatasetsErrorEventDetail>} luzmo-datasets-error - Fired when fetching datasets by id fails.
+ */
+export declare class LuzmoFormula extends LuzmoFormulaBase {
+    static styles: import("lit").CSSResult;
+    /**
+     * Rendering mode. `rich` (default) renders read-only column / aggregation
+     * pills; `text` renders plain text with an inline type icon per column. Both
+     * are always read-only.
+     */
+    display: 'rich' | 'text';
+    private readonly _groupingDataMap;
+    /** A display uses the lightweight, CodeMirror-free store. */
+    protected _createStore(): FormulaDisplayStore;
+    /** A display never loads (or needs) the CodeMirror input. */
+    protected _shouldLoadInput(): boolean;
+    /** A display is read-only and never emits expression changes. */
+    protected _canEmitExpression(): boolean;
+    /**
+     * Parses the expression into aggregation widgets for the `rich` mode so the
+     * recursive renderer can resolve nested content. The `text` mode renders the
+     * raw expression directly, so it needs no store transform.
+     */
+    protected _applyExternalExpression(): void;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    protected render(): TemplateResult;
+    private _renderPillFormula;
+    /**
+     * Recursively renders an aggregation-widget-syntax string: column references
+     * become column pills, aggregation placeholders become read-only aggregation
+     * pills (with their nested content rendered recursively) and everything else
+     * (operators, parentheses, literals) renders as plain text.
+     */
+    private _renderPillNodes;
+    private _renderOperatorText;
+    /**
+     * Renders a column reference as an inline column pill (data-type icon +
+     * localized label). The markup + styles are duplicated here and in the
+     * CodeMirror column-pill widget; only the icon/label resolution is shared (via
+     * `resolveColumnPresentation`). While datasets are still loading and the column
+     * is unresolved, a spinner is shown instead of the (raw column id) label.
+     */
+    private _renderColumnPill;
+    private _renderAggregationPill;
+    /**
+     * Renders the expression as plain text, replacing every `{datasetId:columnId}`
+     * reference with an inline type icon + column name.
+     */
+    private _renderTextFormula;
+    private _renderColumnReference;
+}

package/components/formula/index.cjs

@@ -0,0 +1,20 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../formula-CHD4rr5_.cjs");Object.defineProperty(exports,"LuzmoFormula",{enumerable:!0,get:function(){return e.t}});

package/components/formula/index.d.ts

@@ -0,0 +1,7 @@
+import { LuzmoFormula } from './formula';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-formula': LuzmoFormula;
+    }
+}
+export { LuzmoFormula } from './formula';

package/components/formula/index.js

@@ -0,0 +1,28 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+// Auto-generated initialization code
+(function() {
+	if (typeof document < "u" && !document.querySelector("style[data-luzmo-vars]")) {
+		let e = document.createElement("style");
+		e.setAttribute("data-luzmo-vars", ""), e.textContent = "html{--luzmo-animation-duration: 0.15s;--luzmo-border-color: rgba(var(--luzmo-border-color-rgb), 0.1);--luzmo-border-color-hover: rgba(var(--luzmo-border-color-rgb), 0.15);--luzmo-border-color-down: rgba(var(--luzmo-border-color-rgb), 0.3);--luzmo-border-color-focus: rgba(var(--luzmo-border-color-rgb), 0.15);--luzmo-border-color-rgb: 0, 0, 0;--luzmo-border-color-full: rgb(180, 180, 180);--luzmo-border-color-full-hover: color-mix(in oklch, var(--luzmo-border-color-full), black 25%);--luzmo-border-color-full-down: color-mix(in oklch, var(--luzmo-border-color-full), black 45%);--luzmo-border-color-full-focus: color-mix(in oklch, var(--luzmo-border-color-full), black 25%);--luzmo-border-color-disabled: #dddddd;--luzmo-border-radius: 6px;--luzmo-border-radius-s: 4px;--luzmo-border-radius-l: 8px;--luzmo-border-radius-xl: 12px;--luzmo-border-radius-full: 999rem;--luzmo-background-color: #ffffff;--luzmo-background-color-rgb: 255, 255, 255;--luzmo-background-color-disabled: #eeeeee;--luzmo-background-color-hover: color-mix( in oklch, color-mix(in oklch, var(--luzmo-background-color), var(--luzmo-primary) 5%), black 1.5% );--luzmo-background-color-down: color-mix(in oklch, color-mix(in oklch, var(--luzmo-background-color), var(--luzmo-primary) 7%), black 1%);--luzmo-background-color-focus: color-mix( in oklch, color-mix(in oklch, var(--luzmo-background-color), var(--luzmo-primary) 5%), black 1.5% );--luzmo-background-color-highlight: rgb(240, 240, 240);--luzmo-background-color-highlight-disabled: rgb(245, 245, 245);--luzmo-background-color-highlight-hover: color-mix(in oklch, var(--luzmo-background-color-highlight), black 25%);--luzmo-background-color-highlight-down: color-mix(in oklch, var(--luzmo-background-color-highlight), black 45%);--luzmo-background-color-highlight-focus: color-mix(in oklch, var(--luzmo-background-color-highlight), black 25%);--luzmo-background-color-alt-1: rgb(250, 250, 250);--luzmo-background-color-alt-2: rgb(239, 239, 239);--luzmo-border-width: 1px;--luzmo-font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen-Sans, Ubuntu, Cantarell, 'Helvetica Neue', Helvetica, Arial, sans-serif;--luzmo-font-size-xs: 10px;--luzmo-font-size-s: 12px;--luzmo-font-size-m: 14px;--luzmo-font-size: 14px;--luzmo-font-size-l: 16px;--luzmo-font-size-xl: 18px;--luzmo-font-size-xxl: 20px;--luzmo-font-style: normal;--luzmo-line-height: normal;--luzmo-font-weight: 400;--luzmo-font-weight-semibold: 500;--luzmo-font-weight-bold: 600;--luzmo-font-color: #333;--luzmo-font-color-hard: #000;--luzmo-font-color-disabled: var(--luzmo-color-disabled);--luzmo-font-color-extra-dimmed: #888;--luzmo-font-color-hover: color-mix(in oklch, var(--luzmo-font-color), black 8%);--luzmo-font-color-down: color-mix(in oklch, var(--luzmo-font-color), black 20%);--luzmo-font-color-focus: color-mix(in oklch, var(--luzmo-font-color), black 8%);--luzmo-scrollbar-size: 6px;--luzmo-scrollbar-width: thin;--luzmo-scrollbar-track-background: transparent;--luzmo-scrollbar-track-border-radius: var(--luzmo-border-radius-s);--luzmo-scrollbar-thumb-background: rgba(var(--luzmo-border-color-rgb), 0.3);--luzmo-scrollbar-thumb-border-radius: var(--luzmo-border-radius-s);--luzmo-scrollbar-thumb-hover-background: rgba(var(--luzmo-border-color-rgb), 0.4);--luzmo-primary: #4434ff;--luzmo-primary-hover: color-mix(in oklch, var(--luzmo-primary), black 8%);--luzmo-primary-down: color-mix(in oklch, var(--luzmo-primary), black 20%);--luzmo-primary-focus: color-mix(in oklch, var(--luzmo-primary), black 8%);--luzmo-primary-inverse-color: #ffffff;--luzmo-primary-rgb: 68, 52, 255;--luzmo-secondary: #ff00ff;--luzmo-secondary-hover: color-mix(in oklch, var(--luzmo-secondary), black 8%);--luzmo-secondary-down: color-mix(in oklch, var(--luzmo-secondary), black 20%);--luzmo-secondary-focus: color-mix(in oklch, var(--luzmo-secondary), black 8%);--luzmo-secondary-inverse-color: #ffffff;--luzmo-secondary-rgb: 255, 0, 255;--luzmo-secondary-outline: rgba(255, 0, 255, 0.2);--luzmo-negative-color: #ca221c;--luzmo-negative-color-hover: color-mix(in oklch, var(--luzmo-negative-color), black 8%);--luzmo-negative-color-down: color-mix(in oklch, var(--luzmo-negative-color), black 20%);--luzmo-negative-color-focus: color-mix(in oklch, var(--luzmo-negative-color), black 8%);--luzmo-negative-color-rgb: 202, 34, 28;--luzmo-positive-color: rgb(20, 150, 101);--luzmo-positive-color-hover: color-mix(in oklch, var(--luzmo-positive-color), black 8%);--luzmo-positive-color-down: color-mix(in oklch, var(--luzmo-positive-color), black 20%);--luzmo-positive-color-focus: color-mix(in oklch, var(--luzmo-positive-color), black 8%);--luzmo-positive-color-rgb: 20, 150, 101;--luzmo-selected-color: rgb(110, 110, 110);--luzmo-selected-color-hover: color-mix(in oklch, var(--luzmo-selected-color), black 25%);--luzmo-selected-color-down: color-mix(in oklch, var(--luzmo-selected-color), black 45%);--luzmo-selected-color-focus: color-mix(in oklch, var(--luzmo-selected-color), black 25%);--luzmo-selected-color-hard: #1e1e1e;--luzmo-selected-color-hard-hover: color-mix(in oklch, var(--luzmo-selected-color-hard), black 25%);--luzmo-selected-color-hard-down: color-mix(in oklch, var(--luzmo-selected-color-hard), black 45%);--luzmo-selected-color-hard-focus: color-mix(in oklch, var(--luzmo-selected-color-hard), black 25%);--luzmo-color-informative: #1a77e9;--luzmo-color-informative-rgb: 26, 119, 233;--luzmo-color-disabled: #aaaaaa;--luzmo-spacing-1: 2px;--luzmo-spacing-2: 4px;--luzmo-spacing-3: 8px;--luzmo-spacing-4: 12px;--luzmo-spacing-5: 16px;--luzmo-indicator-gap: 2px;--luzmo-indicator-width: 1px;--luzmo-indicator-color: var(--luzmo-primary);--luzmo-component-height-xxs: 20px;--luzmo-component-height-xs: 24px;--luzmo-component-height-s: 28px;--luzmo-component-height: 32px;--luzmo-component-height-l: 40px;--luzmo-component-height-xl: 48px;--luzmo-component-height-xxl: 64px;--luzmo-icon-size-xxs: 12px;--luzmo-icon-size-xs: 14px;--luzmo-icon-size-s: 16px;--luzmo-icon-size-m: 18px;--luzmo-icon-size-l: 20px;--luzmo-icon-size-xl: 22px;--luzmo-icon-size-xxl: 32px}", document.head.appendChild(e);
+	}
+})();
+import { t as e } from "../formula-CB0-0Hfu.js";
+export { e as LuzmoFormula };

package/components/formula-CB0-0Hfu.js

@@ -0,0 +1,134 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+import { t as e } from "./decorate-CaYbmmmm.js";
+import { t } from "./calculate-data-field-icon-DrSg1PuD.js";
+import { t as n } from "./localize-BT7REYBY.js";
+import { f as r, g as i, h as a, o, t as s } from "./formula-display-store-lENPCY-p.js";
+import { n as c } from "./groupings-FgSCJQwV.js";
+import { t as l } from "./resolve-column-presentation-BaEP1mvs.js";
+import { luzmoIcon as u } from "@luzmo/icons";
+import { html as d, nothing as f, unsafeCSS as p } from "lit";
+import { property as m } from "lit/decorators.js";
+import { localized as h, msg as g } from "@lit/localize";
+import "@luzmo/lucero/icon";
+import "@luzmo/lucero/progress-circle";
+//#region src/components/formula/formula.module.scss?inline
+var _ = ":host{box-sizing:border-box;font-family:var(--luzmo-font-family);color:var(--luzmo-font-color);display:inline-block}.formula-text{font-size:var(--luzmo-formula-font-size,var(--luzmo-font-size));white-space:pre-wrap;word-break:break-word;line-height:1.5}.formula-text-column{align-items:center;gap:var(--luzmo-spacing-1);vertical-align:middle;display:inline-flex}.formula-text-column-icon{flex:none;display:inline-flex}.formula-pills{align-items:center;gap:var(--luzmo-spacing-1) 0;font-size:var(--luzmo-formula-font-size,var(--luzmo-font-size));flex-wrap:wrap;line-height:1.5;display:inline-flex}.formula-operator{white-space:pre-wrap}.column-pill-wrapper{vertical-align:middle;padding-inline-end:var(--luzmo-formula-column-pill-trailing-space,var(--luzmo-spacing-1));display:inline-flex}.column-pill{justify-content:center;align-items:center;gap:var(--luzmo-spacing-2);box-sizing:border-box;max-width:16rem;min-height:var(--luzmo-formula-control-height,1.375rem);padding:0 var(--luzmo-formula-column-pill-padding-inline,calc(var(--luzmo-spacing-2) + var(--luzmo-spacing-1)));border-radius:var(--luzmo-border-radius-s);background-color:var(--luzmo-formula-column-pill-background,var(--luzmo-background-color-highlight));color:var(--luzmo-font-color);white-space:nowrap;font-size:.85em;line-height:1.2;display:inline-flex}.column-pill-icon{flex:none;display:inline-flex}.column-pill-label{text-overflow:ellipsis;overflow:hidden}.column-pill-loading{--luzmo-progress-circle-size:1em;align-items:center;display:inline-flex}.agg-pill{padding:var(--luzmo-spacing-1);border-radius:var(--luzmo-border-radius);background-color:var(--agg-accent,var(--luzmo-primary));color:var(--luzmo-primary-inverse-color);font-size:var(--luzmo-formula-font-size,var(--luzmo-font-size));vertical-align:middle;display:inline-flex}.agg-pill-row{align-items:center;gap:var(--luzmo-spacing-1);min-height:var(--luzmo-formula-control-height,1.375rem);display:inline-flex}.agg-fn{padding-inline:var(--luzmo-spacing-2) var(--luzmo-spacing-1);font-weight:var(--luzmo-font-weight-bold);text-transform:uppercase}.agg-value{min-height:var(--luzmo-formula-control-height,1.375rem);padding:0 var(--luzmo-spacing-2);border-radius:var(--luzmo-border-radius-s);background-color:var(--luzmo-background-color);color:var(--luzmo-font-color);--luzmo-formula-column-pill-background:transparent;--luzmo-formula-column-pill-padding-inline:0px;align-items:center;line-height:1;display:inline-flex}.agg-grouping{align-items:center;gap:var(--luzmo-spacing-1);padding-inline:var(--luzmo-spacing-1) var(--luzmo-spacing-2);font-size:var(--luzmo-formula-grouping-icon-size,var(--luzmo-icon-size-m));display:inline-flex}.agg-grouping-count{border-radius:var(--luzmo-border-radius-full,999rem);background:var(--luzmo-primary-inverse-color);min-width:1.25em;color:var(--agg-accent,var(--luzmo-primary));font-size:.6875rem;font-weight:var(--luzmo-font-weight-bold);justify-content:center;align-items:center;padding:0 .25em;line-height:1.4;display:inline-flex}:host{--luzmo-formula-font-size:var(--luzmo-font-size);--luzmo-formula-grouping-icon-size:var(--luzmo-icon-size-m);--luzmo-formula-control-height:calc(var(--luzmo-component-height) - 2 * var(--luzmo-spacing-1))}:host([size=s]){--luzmo-formula-font-size:var(--luzmo-font-size-s);--luzmo-formula-grouping-icon-size:var(--luzmo-icon-size-s);--luzmo-formula-control-height:calc(var(--luzmo-component-height-s) - 2 * var(--luzmo-spacing-1))}:host([size=l]){--luzmo-formula-font-size:var(--luzmo-font-size-l);--luzmo-formula-grouping-icon-size:var(--luzmo-icon-size-l);--luzmo-formula-control-height:calc(var(--luzmo-component-height-l) - 2 * var(--luzmo-spacing-1))}:host([size=xl]){--luzmo-formula-font-size:var(--luzmo-font-size-xl);--luzmo-formula-grouping-icon-size:var(--luzmo-icon-size-xl);--luzmo-formula-control-height:calc(var(--luzmo-component-height-xl) - 2 * var(--luzmo-spacing-1))}", v = class extends o {
+	constructor(...e) {
+		super(...e), this.display = "rich", this._groupingDataMap = c();
+	}
+	static {
+		this.styles = p(_);
+	}
+	_createStore() {
+		return new s();
+	}
+	_shouldLoadInput() {
+		return !1;
+	}
+	_canEmitExpression() {
+		return !1;
+	}
+	_applyExternalExpression() {
+		if (this.display === "text") {
+			this._rootContent = "";
+			return;
+		}
+		this._store.clearWidgets(), this._rootContent = this._store.transformToAggregationWidgetSyntax(this.expression ?? "");
+	}
+	willUpdate(e) {
+		super.willUpdate(e), e.has("display") && !e.has("expression") && this._applyExternalExpression();
+	}
+	render() {
+		return this.display === "text" ? this._renderTextFormula() : this._renderPillFormula();
+	}
+	_renderPillFormula() {
+		return d`<span class="formula-pills" part="formula">${this._renderPillNodes(this._rootContent)}</span>`;
+	}
+	_renderPillNodes(e) {
+		let t = [], n = new RegExp(a.source, "gm"), r = 0, i;
+		for (; (i = n.exec(e)) !== null;) {
+			i.index > r && t.push(this._renderOperatorText(e.slice(r, i.index)));
+			let a = i[2], o = i[3];
+			a ? t.push(this._renderColumnPill(a)) : o && t.push(this._renderAggregationPill(o)), r = n.lastIndex;
+		}
+		return r < e.length && t.push(this._renderOperatorText(e.slice(r))), t;
+	}
+	_renderOperatorText(e) {
+		return d`<span class="formula-operator">${e}</span>`;
+	}
+	_renderColumnPill(e) {
+		let [t, n] = e.split(":"), r = this._datasets.find((e) => e.id === t)?.columns.find((e) => e.columnId === n);
+		if (this._store.loading && !r) {
+			let e = g("Loading column", { desc: "Accessible label for a column pill whose label is still loading" });
+			return d`<span class="column-pill-wrapper"
+        ><span class="column-pill" title=${e}
+          ><span class="column-pill-loading">
+            <luzmo-progress-circle indeterminate size="s" .label=${e}></luzmo-progress-circle></span
+        ></span
+      ></span>`;
+		}
+		let { icon: i, label: a } = l(r, this.contentLanguage, n);
+		return d`<span class="column-pill-wrapper"
+      ><span class="column-pill" title=${a}
+        ><span class="column-pill-icon">${u(i)}</span
+        ><span class="column-pill-label">${a}</span></span
+    ></span>`;
+	}
+	_renderAggregationPill(e) {
+		let t = this._store.getWidget(e);
+		if (!t) return d`${f}`;
+		let n = this._groupingDataMap[t.grouping], r = n?.color ?? "", a = this._store.aggregationFunctionDataMap[t.aggregationFunction]?.arity ?? 0, o = n?.label() ?? "", s = t.grouping === i.GROUPINEX ? (t.includedColumns?.length ?? 0) + (t.excludedColumns?.length ?? 0) : 0;
+		return d`<span class="agg-pill" style=${r ? `--agg-accent: ${r}` : ""}>
+      <span class="agg-pill-row">
+        <span class="agg-fn">${t.aggregationFunction}</span>
+        ${a > 0 ? d`<span class="agg-value">${this._renderPillNodes(t.content)}</span>` : f}
+        <span class="agg-grouping" title=${o} aria-label=${o}>
+          ${n?.icon ? u(n.icon) : f}
+          ${s > 0 ? d`<span class="agg-grouping-count">${s}</span>` : f}
+        </span>
+      </span>
+    </span>`;
+	}
+	_renderTextFormula() {
+		let e = this.expression ?? "", t = [], n = new RegExp(r.source, "g"), i = 0, a;
+		for (; (a = n.exec(e)) !== null;) {
+			a.index > i && t.push(e.slice(i, a.index));
+			let [r, o] = a[1].split(":");
+			t.push(this._renderColumnReference(r, o)), i = n.lastIndex;
+		}
+		return i < e.length && t.push(e.slice(i)), d`<span class="formula-text" part="formula-text">${t}</span>`;
+	}
+	_renderColumnReference(e, r) {
+		let i = this._datasets.find((t) => t.id === e), a = i?.columns.find((e) => e.columnId === r), o = a ? n(a.name, this.contentLanguage) : r, s = i ? n(i.name, this.contentLanguage) : "";
+		return d`<span class="formula-text-column" part="formula-text-column" title=${s ? `${s} · ${o}` : o}>
+      <span class="formula-text-column-icon">${u(t({ type: a?.type ?? "hierarchy" }, "s"))}</span>
+      <span class="formula-text-column-name">${o}</span>
+    </span>`;
+	}
+};
+//#endregion
+//#region src/components/formula/index.ts
+e([m({
+	type: String,
+	reflect: !0
+})], v.prototype, "display", void 0), v = e([h()], v), customElements.get("luzmo-formula") || customElements.define("luzmo-formula", v);
+//#endregion
+export { v as t };

package/components/formula-CHD4rr5_.cjs

@@ -0,0 +1,41 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+const e=require("./decorate-DCJt-2rt.cjs"),t=require("./calculate-data-field-icon-DenGmW74.cjs"),n=require("./localize-D3i4Epy_.cjs"),r=require("./formula-display-store-ianfhYAz.cjs"),i=require("./groupings-Cm5tMojA.cjs"),a=require("./resolve-column-presentation-DUETRVCH.cjs");let o=require("@luzmo/icons"),s=require("lit"),c=require("lit/decorators.js"),l=require("@lit/localize");require("@luzmo/lucero/icon"),require("@luzmo/lucero/progress-circle");var u=`:host{box-sizing:border-box;font-family:var(--luzmo-font-family);color:var(--luzmo-font-color);display:inline-block}.formula-text{font-size:var(--luzmo-formula-font-size,var(--luzmo-font-size));white-space:pre-wrap;word-break:break-word;line-height:1.5}.formula-text-column{align-items:center;gap:var(--luzmo-spacing-1);vertical-align:middle;display:inline-flex}.formula-text-column-icon{flex:none;display:inline-flex}.formula-pills{align-items:center;gap:var(--luzmo-spacing-1) 0;font-size:var(--luzmo-formula-font-size,var(--luzmo-font-size));flex-wrap:wrap;line-height:1.5;display:inline-flex}.formula-operator{white-space:pre-wrap}.column-pill-wrapper{vertical-align:middle;padding-inline-end:var(--luzmo-formula-column-pill-trailing-space,var(--luzmo-spacing-1));display:inline-flex}.column-pill{justify-content:center;align-items:center;gap:var(--luzmo-spacing-2);box-sizing:border-box;max-width:16rem;min-height:var(--luzmo-formula-control-height,1.375rem);padding:0 var(--luzmo-formula-column-pill-padding-inline,calc(var(--luzmo-spacing-2) + var(--luzmo-spacing-1)));border-radius:var(--luzmo-border-radius-s);background-color:var(--luzmo-formula-column-pill-background,var(--luzmo-background-color-highlight));color:var(--luzmo-font-color);white-space:nowrap;font-size:.85em;line-height:1.2;display:inline-flex}.column-pill-icon{flex:none;display:inline-flex}.column-pill-label{text-overflow:ellipsis;overflow:hidden}.column-pill-loading{--luzmo-progress-circle-size:1em;align-items:center;display:inline-flex}.agg-pill{padding:var(--luzmo-spacing-1);border-radius:var(--luzmo-border-radius);background-color:var(--agg-accent,var(--luzmo-primary));color:var(--luzmo-primary-inverse-color);font-size:var(--luzmo-formula-font-size,var(--luzmo-font-size));vertical-align:middle;display:inline-flex}.agg-pill-row{align-items:center;gap:var(--luzmo-spacing-1);min-height:var(--luzmo-formula-control-height,1.375rem);display:inline-flex}.agg-fn{padding-inline:var(--luzmo-spacing-2) var(--luzmo-spacing-1);font-weight:var(--luzmo-font-weight-bold);text-transform:uppercase}.agg-value{min-height:var(--luzmo-formula-control-height,1.375rem);padding:0 var(--luzmo-spacing-2);border-radius:var(--luzmo-border-radius-s);background-color:var(--luzmo-background-color);color:var(--luzmo-font-color);--luzmo-formula-column-pill-background:transparent;--luzmo-formula-column-pill-padding-inline:0px;align-items:center;line-height:1;display:inline-flex}.agg-grouping{align-items:center;gap:var(--luzmo-spacing-1);padding-inline:var(--luzmo-spacing-1) var(--luzmo-spacing-2);font-size:var(--luzmo-formula-grouping-icon-size,var(--luzmo-icon-size-m));display:inline-flex}.agg-grouping-count{border-radius:var(--luzmo-border-radius-full,999rem);background:var(--luzmo-primary-inverse-color);min-width:1.25em;color:var(--agg-accent,var(--luzmo-primary));font-size:.6875rem;font-weight:var(--luzmo-font-weight-bold);justify-content:center;align-items:center;padding:0 .25em;line-height:1.4;display:inline-flex}:host{--luzmo-formula-font-size:var(--luzmo-font-size);--luzmo-formula-grouping-icon-size:var(--luzmo-icon-size-m);--luzmo-formula-control-height:calc(var(--luzmo-component-height) - 2 * var(--luzmo-spacing-1))}:host([size=s]){--luzmo-formula-font-size:var(--luzmo-font-size-s);--luzmo-formula-grouping-icon-size:var(--luzmo-icon-size-s);--luzmo-formula-control-height:calc(var(--luzmo-component-height-s) - 2 * var(--luzmo-spacing-1))}:host([size=l]){--luzmo-formula-font-size:var(--luzmo-font-size-l);--luzmo-formula-grouping-icon-size:var(--luzmo-icon-size-l);--luzmo-formula-control-height:calc(var(--luzmo-component-height-l) - 2 * var(--luzmo-spacing-1))}:host([size=xl]){--luzmo-formula-font-size:var(--luzmo-font-size-xl);--luzmo-formula-grouping-icon-size:var(--luzmo-icon-size-xl);--luzmo-formula-control-height:calc(var(--luzmo-component-height-xl) - 2 * var(--luzmo-spacing-1))}`,d=class extends r.o{constructor(...e){super(...e),this.display=`rich`,this._groupingDataMap=i.n()}static{this.styles=(0,s.unsafeCSS)(u)}_createStore(){return new r.t}_shouldLoadInput(){return!1}_canEmitExpression(){return!1}_applyExternalExpression(){if(this.display===`text`){this._rootContent=``;return}this._store.clearWidgets(),this._rootContent=this._store.transformToAggregationWidgetSyntax(this.expression??``)}willUpdate(e){super.willUpdate(e),e.has(`display`)&&!e.has(`expression`)&&this._applyExternalExpression()}render(){return this.display===`text`?this._renderTextFormula():this._renderPillFormula()}_renderPillFormula(){return s.html`<span class="formula-pills" part="formula">${this._renderPillNodes(this._rootContent)}</span>`}_renderPillNodes(e){let t=[],n=new RegExp(r.h.source,`gm`),i=0,a;for(;(a=n.exec(e))!==null;){a.index>i&&t.push(this._renderOperatorText(e.slice(i,a.index)));let r=a[2],o=a[3];r?t.push(this._renderColumnPill(r)):o&&t.push(this._renderAggregationPill(o)),i=n.lastIndex}return i<e.length&&t.push(this._renderOperatorText(e.slice(i))),t}_renderOperatorText(e){return s.html`<span class="formula-operator">${e}</span>`}_renderColumnPill(e){let[t,n]=e.split(`:`),r=this._datasets.find(e=>e.id===t)?.columns.find(e=>e.columnId===n);if(this._store.loading&&!r){let e=(0,l.msg)(`Loading column`,{desc:`Accessible label for a column pill whose label is still loading`});return s.html`<span class="column-pill-wrapper"
+        ><span class="column-pill" title=${e}
+          ><span class="column-pill-loading">
+            <luzmo-progress-circle indeterminate size="s" .label=${e}></luzmo-progress-circle></span
+        ></span
+      ></span>`}let{icon:i,label:c}=a.t(r,this.contentLanguage,n);return s.html`<span class="column-pill-wrapper"
+      ><span class="column-pill" title=${c}
+        ><span class="column-pill-icon">${(0,o.luzmoIcon)(i)}</span
+        ><span class="column-pill-label">${c}</span></span
+    ></span>`}_renderAggregationPill(e){let t=this._store.getWidget(e);if(!t)return s.html`${s.nothing}`;let n=this._groupingDataMap[t.grouping],i=n?.color??``,a=this._store.aggregationFunctionDataMap[t.aggregationFunction]?.arity??0,c=n?.label()??``,l=t.grouping===r.g.GROUPINEX?(t.includedColumns?.length??0)+(t.excludedColumns?.length??0):0;return s.html`<span class="agg-pill" style=${i?`--agg-accent: ${i}`:``}>
+      <span class="agg-pill-row">
+        <span class="agg-fn">${t.aggregationFunction}</span>
+        ${a>0?s.html`<span class="agg-value">${this._renderPillNodes(t.content)}</span>`:s.nothing}
+        <span class="agg-grouping" title=${c} aria-label=${c}>
+          ${n?.icon?(0,o.luzmoIcon)(n.icon):s.nothing}
+          ${l>0?s.html`<span class="agg-grouping-count">${l}</span>`:s.nothing}
+        </span>
+      </span>
+    </span>`}_renderTextFormula(){let e=this.expression??``,t=[],n=new RegExp(r.f.source,`g`),i=0,a;for(;(a=n.exec(e))!==null;){a.index>i&&t.push(e.slice(i,a.index));let[r,o]=a[1].split(`:`);t.push(this._renderColumnReference(r,o)),i=n.lastIndex}return i<e.length&&t.push(e.slice(i)),s.html`<span class="formula-text" part="formula-text">${t}</span>`}_renderColumnReference(e,r){let i=this._datasets.find(t=>t.id===e),a=i?.columns.find(e=>e.columnId===r),c=a?n.t(a.name,this.contentLanguage):r,l=i?n.t(i.name,this.contentLanguage):``;return s.html`<span class="formula-text-column" part="formula-text-column" title=${l?`${l} · ${c}`:c}>
+      <span class="formula-text-column-icon">${(0,o.luzmoIcon)(t.t({type:a?.type??`hierarchy`},`s`))}</span>
+      <span class="formula-text-column-name">${c}</span>
+    </span>`}};e.t([(0,c.property)({type:String,reflect:!0})],d.prototype,`display`,void 0),d=e.t([(0,l.localized)()],d),customElements.get(`luzmo-formula`)||customElements.define(`luzmo-formula`,d),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return d}});

package/components/formula-codemirror/formula-codemirror.d.ts

@@ -0,0 +1,79 @@
+import { type Completion } from '@codemirror/autocomplete';
+import { type PropertyValues, type TemplateResult } from 'lit';
+import { LuzmoElement } from '@utils/base';
+import type { FormulaEditorStore } from '@utils/formula/store/formula-editor-store';
+import type { FormulaEditorDataset } from '../../types/formula.types';
+import '@luzmo/lucero/progress-circle';
+import './pills/formula-empty-argument-pill';
+import './pills/formula-aggregation';
+declare const LuzmoFormulaCodeMirror_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement;
+/**
+ * @customElement luzmo-formula-codemirror
+ * @description Internal CodeMirror-backed expression engine for the formula
+ * family. Renders columns, empty arguments and aggregation widgets as inline pills,
+ * supports drag-to-insert at the cursor and autocompletion. Used as the editing
+ * surface of `luzmo-formula-field` and `luzmo-formula-editor`, and inside nested
+ * aggregation widgets. Not part of the public API - prefer `luzmo-formula-field`
+ * / `luzmo-formula-editor`, which wire its store + autocompletion for you.
+ *
+ * @fires {CustomEvent<{ content: string }>} luzmo-input-content-changed - Fired when the editor content changes.
+ * @fires {CustomEvent<void>} luzmo-input-focused - Fired when the editor gains focus.
+ */
+export declare class LuzmoFormulaCodeMirror extends LuzmoFormulaCodeMirror_base {
+    static styles: import("lit").CSSResult;
+    /** The shared formula editor store. */
+    store?: FormulaEditorStore;
+    /** Id of the aggregation widget this input belongs to, or null for the root editor. */
+    aggregationWidgetId: string | null;
+    /** Datasets used to render column pills. */
+    datasets: FormulaEditorDataset[];
+    contentLanguage: string;
+    placeholder: string;
+    readonly: boolean;
+    singleLine: boolean;
+    hasError: boolean;
+    editorHeight?: string;
+    /** Number of text lines the input is sized to start with. Defaults to 3. */
+    rows: number;
+    /** Maximum number of text lines before a scrollbar appears (only when `grows`). */
+    maxRows?: number;
+    /** Whether the input grows in height with its content (up to `maxRows` if set). */
+    grows: boolean;
+    /** The autocompletion options to offer. */
+    autoCompletionList: Completion[];
+    private _view?;
+    private _pendingContent;
+    private readonly _themeCompartment;
+    private readonly _readonlyCompartment;
+    get content(): string;
+    /** Replaces the whole editor content. */
+    setContent(content: string): void;
+    focusEditor(): void;
+    /** Forces the inline pill decorations to be recomputed. */
+    refresh(): void;
+    disconnectedCallback(): void;
+    /** Rebuilds pill decorations when the store signals a refresh (e.g. loading state changed). */
+    private _handleStoreRefresh;
+    protected firstUpdated(_changedProperties: PropertyValues): void;
+    protected updated(changedProperties: PropertyValues): void;
+    /**
+     * Read-only extensions, kept in a compartment so toggling `readonly` after the
+     * view is created can reconfigure them. `readOnly` blocks edits but the view
+     * stays focusable and keeps painting a blinking caret; `editable.of(false)`
+     * also drops the caret (and the contenteditable), which is what a read-only
+     * rendering should show.
+     */
+    private _readonlyExtensions;
+    private _buildDynamicTheme;
+    private _buildExtensions;
+    private _buildDecorations;
+    private _autoComplete;
+    private _cleanupDroppable;
+    private _attachDroppable;
+    private _canDrop;
+    private _handleDrop;
+    protected render(): TemplateResult;
+}
+export {};

package/components/formula-codemirror/index.d.ts

@@ -0,0 +1,7 @@
+import { LuzmoFormulaCodeMirror } from './formula-codemirror';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-formula-codemirror': LuzmoFormulaCodeMirror;
+    }
+}
+export { LuzmoFormulaCodeMirror } from './formula-codemirror';

package/components/formula-codemirror/pills/formula-aggregation/formula-aggregation.d.ts

@@ -0,0 +1,125 @@
+import '@luzmo/lucero/icon';
+import '@luzmo/lucero/overlay';
+import '@luzmo/lucero/popover';
+import '@luzmo/lucero/select';
+import { type PropertyValues, type TemplateResult } from 'lit';
+import { LuzmoElement } from '@utils/base';
+import type { FormulaEditorStore } from '@utils/formula/store/formula-editor-store';
+import { type AggregationWidgetConfig } from '../../../../types/formula.types';
+declare const LuzmoFormulaAggregation_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement;
+/**
+ * @customElement luzmo-formula-aggregation
+ * @description A nested aggregation widget rendered inline inside the formula
+ * editor: an aggregation-function selector, a grouping-scope selector, a nested
+ * expression input and (for `GROUPINEX`) an include / exclude column panel.
+ */
+export declare class LuzmoFormulaAggregation extends LuzmoFormulaAggregation_base {
+    static styles: import("lit").CSSResult;
+    /** Configuration for this aggregation widget (set by the CodeMirror widget). */
+    config: AggregationWidgetConfig['data'];
+    /** The shared formula editor store (set by the CodeMirror widget). */
+    store?: FormulaEditorStore;
+    private _nestedCodeMirror?;
+    private _groupingOverlay?;
+    private _functionSelect?;
+    /** The element the focus/blur listeners are currently bound to, for clean teardown. */
+    private _functionFocusTarget?;
+    /**
+     * Explicit page override for the grouping popover. When `null` the page is
+     * derived from the current grouping (include/exclude scope -> the detail page,
+     * any other scope -> the scope chooser). Deriving the page - rather than
+     * resetting a stored page on open/close - keeps the (still hidden) popover on
+     * the correct page, so reopening a configured include/exclude pill no longer
+     * flashes the scope chooser for a frame.
+     */
+    private _groupingPageOverride;
+    /** Autocompletion options offered while typing inside this aggregation's nested input. */
+    private _autoCompletionList;
+    /** Whether the CodeMirror-backed nested input module has finished loading. */
+    private _codeMirrorLoaded;
+    /**
+     * Whether the aggregation-function select currently holds keyboard-driven focus.
+     * The select's focusable button lives in its shadow DOM, so a pure CSS
+     * `:focus-visible` can't reach it from here; instead we read the browser's own
+     * `:focus-visible` verdict off the focused element so the focus ring only shows
+     * for keyboard users (not after a mouse switch).
+     */
+    private _functionKeyboardFocus;
+    private readonly _groupingTriggerId;
+    private readonly _aggregationDataMap;
+    private readonly _groupingDataMap;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Binds the keyboard-focus tracking to the `.function-select` element (not the
+     * host). The select swallows the bubbling focusin/focusout, so we use the
+     * capturing focus/blur events; and they must be bound to `.function-select`
+     * rather than the host so focus moving *within* the pill (e.g. Shift+Tab from
+     * the nested value input into the select) still crosses into the listener's
+     * subtree and is detected. Idempotent and safe to call before first render.
+     */
+    private _bindFunctionFocusListeners;
+    private _unbindFunctionFocusListeners;
+    private _handleFunctionFocus;
+    private _handleFunctionBlur;
+    private _handleWidgetsChanged;
+    /**
+     * Datasets reach the pill once (via `config.linkedDatasets`) when the widget
+     * is created. When the editor loads its datasets asynchronously the store is
+     * updated later, so this re-resolves the nested column labels and completions.
+     */
+    private _handleDatasetsRefresh;
+    /** The datasets to use for the nested input: the freshly loaded store ones take precedence. */
+    private get _linkedDatasets();
+    private _recomputeAutoCompletion;
+    private get _widget();
+    /** The grouping popover page: an explicit override (e.g. after pressing back), else derived from the grouping scope. */
+    private get _groupingPage();
+    protected willUpdate(changedProperties: PropertyValues): void;
+    /** Lazily loads the CodeMirror-backed input used for this aggregation's nested expression. */
+    private _ensureCodeMirrorLoaded;
+    protected firstUpdated(): void;
+    protected updated(_changedProperties: PropertyValues): void;
+    /**
+     * When this pill was just created via a list insert / autocomplete, move the
+     * cursor into its nested input so the user can immediately keep typing.
+     */
+    private _focusNestedIfPending;
+    private _updateWidget;
+    private _handleFunctionChange;
+    private _handleGroupingOptionClick;
+    private _handleGroupingBack;
+    private _handleGroupingMenuOpened;
+    private _handleGroupingMenuClosed;
+    /**
+     * Dismiss the grouping overlay on an outside pointerdown.
+     *
+     * The overlay is a `type="manual"` popover (see render) so the browser's native
+     * Popover-API light-dismiss never collapses it when a nested include / exclude
+     * select opens its own `auto` popover - the bug this works around. Manual
+     * overlays also opt out of the overlay stack's outside-pointer dismissal, so we
+     * reinstate it here. Clicks inside the popover - which include the DOM-nested
+     * include / exclude selects and their dropdowns - keep it open; a pointerdown on
+     * the trigger closes it (the click controller suppresses its own toggle while
+     * the overlay is already open). Escape still closes it through the stack's
+     * keydown handler, which does dismiss manual overlays.
+     */
+    private _handleDocumentPointerdown;
+    /**
+     * Whether a pointerdown landed inside the grouping popover content. The popover
+     * content is promoted to the top layer (native popover) but stays in the DOM
+     * tree, so we match the popover / panel by class along the composed path:
+     * after a nested select opens (and re-renders) an element reference can stop
+     * resolving, but the elements are still present in the click's composed path.
+     */
+    private _isPointerInsidePopover;
+    private _closeGroupingMenu;
+    private _handleNestedContentChanged;
+    private _handleIncludeExcludeChange;
+    private _renderGroupingTypesPage;
+    private _renderIncludeExcludePage;
+    protected render(): TemplateResult;
+}
+export {};

package/components/formula-codemirror/pills/formula-aggregation/index.d.ts

@@ -0,0 +1,7 @@
+import { LuzmoFormulaAggregation } from './formula-aggregation';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-formula-aggregation': LuzmoFormulaAggregation;
+    }
+}
+export { LuzmoFormulaAggregation } from './formula-aggregation';

package/components/formula-codemirror/pills/formula-empty-argument-pill/formula-empty-argument-pill.d.ts

@@ -0,0 +1,27 @@
+import { type PropertyValues, type TemplateResult } from 'lit';
+import { LuzmoElement } from '@utils/base';
+import type { FormulaEditorStore } from '@utils/formula/store/formula-editor-store';
+declare const LuzmoFormulaEmptyArgumentPill_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement;
+/**
+ * @customElement luzmo-formula-empty-argument-pill
+ * @description An empty argument rendered inline inside the formula editor. Accepts
+ * dropped columns / functions / aggregations and lets the user type a literal value.
+ */
+export declare class LuzmoFormulaEmptyArgumentPill extends LuzmoFormulaEmptyArgumentPill_base {
+    static styles: import("lit").CSSResult;
+    emptyArgumentId: string;
+    parentAggregationWidgetId: string | null;
+    store?: FormulaEditorStore;
+    private _cleanupDroppable;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected firstUpdated(_changedProperties: PropertyValues): void;
+    private _attachDroppable;
+    private _canDrop;
+    private _handleDrop;
+    private _handleInput;
+    protected render(): TemplateResult;
+}
+export {};

package/components/formula-codemirror/pills/formula-empty-argument-pill/index.d.ts

@@ -0,0 +1,7 @@
+import { LuzmoFormulaEmptyArgumentPill } from './formula-empty-argument-pill';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-formula-empty-argument-pill': LuzmoFormulaEmptyArgumentPill;
+    }
+}
+export { LuzmoFormulaEmptyArgumentPill } from './formula-empty-argument-pill';

package/components/formula-codemirror/pills/formula-include-exclude-panel.d.ts

@@ -0,0 +1,38 @@
+import '@luzmo/lucero/action-button';
+import '@luzmo/lucero/field-label';
+import '@luzmo/lucero/icon';
+import '@luzmo/lucero/select';
+import '@luzmo/lucero/tooltip';
+import { type TemplateResult } from 'lit';
+import { type ElementSize } from '@utils/base';
+import type { FormulaEditorDataset } from '../../../types/formula.types';
+export interface IncludeExcludePanelParams {
+    /** The linked datasets whose columns can be included / excluded. */
+    datasets: FormulaEditorDataset[];
+    /** Columns to always group by, as full `datasetId:columnId` references. */
+    includedColumns: string[];
+    /** Columns to never group by, as full `datasetId:columnId` references. */
+    excludedColumns: string[];
+    /** Language used to localize column names. */
+    contentLanguage: string;
+    /** Size of the surrounding editor. */
+    size?: ElementSize;
+    /** Renders the picker read-only (no adding, removing or moving). */
+    readonly?: boolean;
+    /** Shows a back button in the header to return to the grouping scope chooser. */
+    showBack?: boolean;
+    /** Called with the next included / excluded selection whenever it changes. */
+    onChange: (includedColumns: string[], excludedColumns: string[]) => void;
+    /** Called when the back button is activated. */
+    onBack: () => void;
+}
+/**
+ * Renders the included / excluded column picker for a `GROUPINEX` aggregation
+ * grouping. Replaces the former `luzmo-formula-include-exclude-panel` element:
+ * stateless markup driven by the aggregation pill, which owns the widget update.
+ *
+ * The root carries the `include-exclude-panel` class so the aggregation pill can
+ * detect pointerdowns inside the (DOM-nested) panel and keep its grouping
+ * popover open.
+ */
+export declare function renderIncludeExcludePanel(params: IncludeExcludePanelParams): TemplateResult;