@luzmo/analytics-components-kit 1.0.9-beta.7 → 1.0.9-beta.9

package/components/filter-value-picker-numeric-BRCpHan6.cjs

@@ -0,0 +1,54 @@
+/*! * 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.
+ * */
+require("./tokens-BWMfo_w4.cjs");const e=require("./decorate-DCJt-2rt.cjs"),t=require("./localized-mixin-B-kGsAm4.cjs"),n=require("./data-broker-DWgqaHoY.cjs");let r=require("lit"),i=require("lit/decorators.js"),a=require("@lit/localize");require("@luzmo/lucero/select"),require("@luzmo/lucero/number-field");let o=require("@luzmo/lucero/utils");var s=`:host{flex-direction:row;flex-shrink:1;min-width:0;display:flex}luzmo-number-field,luzmo-select{min-width:var(--luzmo-filter-value-picker-numeric-control-min-width,var(--filter-value-picker-numeric-control-min-width));flex:auto;max-width:100%}.missing-value{opacity:.4}:host{--filter-value-picker-numeric-control-min-width:0}`,c=5e3,l=class extends t.t((0,o.SizedMixin)(o.LuzmoElement,{validSizes:Object.values(o.ElementSizes)})){constructor(...e){super(...e),this.contentLanguage=`en`,this.quiet=!1,this.readonly=!1,this.disabled=!1,this._numericValues=[],this._retrieving=!0,this._search=``,this._error=null,this._allValuesRetrieved=!1,this._runningQueries=[]}static get styles(){return[(0,r.unsafeCSS)(s)]}connectedCallback(){super.connectedCallback();let e={};this.apiUrl&&(e.apiUrl=this.apiUrl),this.cacheTime&&(e.staleTime=this.cacheTime,e.gcTime=this.cacheTime*2),this.authKey&&this.authToken&&(e.authKey=this.authKey,e.authToken=this.authToken),n.n.configure(e)}willUpdate(e){if(super.willUpdate(e),e.has(`filter`)&&this.filter){let t=e.get(`filter`)?.expression,n=this.filter?.expression;((e.get(`filter`)?.parameters?.[0]?.columnId||e.get(`filter`)?.parameters?.[0]?.formulaId)!==(this.filter?.parameters?.[0]?.columnId||this.filter?.parameters?.[0]?.formulaId)||![`? in ?`,`? not in ?`].includes(t))&&[`? in ?`,`? not in ?`].includes(n)&&(this._numericValues=[],this._allValuesRetrieved=!1,this._retrieving=!0)}}async _fetchNumericValues(e=0){if(this._allValuesRetrieved){this._retrieving=!1;return}if(!this.filter?.parameters?.[0]){this._retrieving=!1,this._error=`Missing column parameters`;return}let t=this.filter.parameters[0],r=t.columnId,i=t.formulaId,a=t.datasetId;if(!r&&!i){this._retrieving=!1,this._error=`Missing column id or formula id`;return}else if(!a){this._retrieving=!1,this._error=`Missing dataset id`;return}this._retrieving=!0,this._error=null;let o={expression:`? like ?`,parameters:[{dataset_id:a,expression:`CAST({${a}:${r??i}},hierarchy)`},this._search]},s={dimensions:[{column_id:r,formula_id:i,dataset_id:a}],where:[],order:[{column_id:r,formula_id:i,dataset_id:a,order:`asc`}],limit:{by:c,offset:e}};this._search&&!this._allValuesRetrieved&&s.where.push(o);let l=new AbortController,u=new Promise((e,t)=>{n.n.fetchData(s).then(e).catch(t),l.signal.addEventListener(`abort`,()=>{console.warn(`Request aborted`),t({status:`aborted`})})}),d={promise:u,abortController:l};this._runningQueries.push(d);try{let t=await u,n=t&&Array.isArray(t.data)?t.data.map(e=>e[0]):[];this._search||(this._allValuesRetrieved=n.length<c),this._numericValues=e>0?[...this._numericValues,...n]:n}catch(e){if(e?.status===`aborted`)return;this._error=e instanceof Error?e.message:`Unknown error`,this._numericValues=[]}finally{this._runningQueries=this._runningQueries.filter(e=>e.promise!==u),this._retrieving=!1}}_sendChangeEvent(){this.dispatchEvent(new CustomEvent(`luzmo-filter-value-changed`,{bubbles:!0,composed:!0,cancelable:!0,detail:{value:this._value}}))}setValue(e){if(this.readonly||this.disabled)return;let t=[`? in ?`,`? not in ?`].includes(this.filter?.expression)?e?.detail?.value:e?.target?.value;this._value!==t&&(this._value=t,this.filter={...this.filter,parameters:[{...this.filter?.parameters?.[0]},t]},this._sendChangeEvent())}selectValue(e){if(this.readonly||this.disabled)return;let t=(e.detail?.value??``).map(e=>Number.parseFloat(e));this.filter={...this.filter,parameters:[{...this.filter?.parameters?.[0]},t]},this._value=t,this._sendChangeEvent()}onScrolled(e){!this._retrieving&&!this._allValuesRetrieved&&e?.detail?.last===this._numericValues.length-1&&this._fetchNumericValues(this._numericValues.length)}renderNumberField(){return r.html`<luzmo-number-field
+      label="Numeric filter value"
+      grows
+      .size=${this.size}
+      .quiet=${this.quiet}
+      .readonly=${this.readonly}
+      .disabled=${this.disabled}
+      @change=${this.setValue}
+      @input=${this.setValue}
+      .value=${this.filter?.parameters?.[1]}
+    ></luzmo-number-field>`}setSearchString(e){this._search=e?.detail?.string??``,this._allValuesRetrieved||(this._searchQueryTimeout&&(this._runningQueries.forEach(e=>{e?.abortController&&e.abortController.abort()}),this._runningQueries=[],clearTimeout(this._searchQueryTimeout)),this._searchQueryTimeout=setTimeout(()=>{this._fetchNumericValues()},500))}resetSearchString(){this._search=``}onOpened(){this._fetchNumericValues()}renderValuePicker(){if(this._error)return r.html`<div class="error" role="alert">${this._error}</div>`;let e=this._numericValues.filter(e=>e.toString().toLowerCase().includes(this._search.toLowerCase())).map(e=>({value:e,label:e})),t=(0,a.msg)(`Selected {count} items`),n=(0,a.msg)(`Search`),i=(0,a.msg)(`No data`),o=(0,a.msg)(`No results`),s=(0,a.msg)(`Select...`);return r.html`<luzmo-select
+      .size=${this.size}
+      .label=${s}
+      .retrieving=${this._retrieving}
+      selects="multiple"
+      variant="checkboxes"
+      ?emphasized=${!this.quiet}
+      .quiet=${this.quiet}
+      .readonly=${this.readonly}
+      .disabled=${this.disabled}
+      no-wrap
+      ?invalid=${!!this._error}
+      .multipleLabelTemplate=${t}
+      .searchLabel=${n}
+      .noDataLabel=${i}
+      .noResultsLabel=${o}
+      @change=${this.selectValue}
+      @luzmo-search=${this.setSearchString}
+      @luzmo-opened=${this.onOpened}
+      @luzmo-closed=${this.resetSearchString}
+      @luzmo-scrolled=${this.onScrolled}
+      .options=${e}
+      .value=${this.filter?.parameters?.[1]}
+    >
+    </luzmo-select>`}render(){let e=this.filter?.expression;return[`? in ?`,`? not in ?`].includes(e)?this.renderValuePicker():this.renderNumberField()}};e.t([(0,i.property)({type:String,attribute:`api-url`,reflect:!0})],l.prototype,`apiUrl`,void 0),e.t([(0,i.property)({type:String,attribute:`auth-key`,reflect:!0})],l.prototype,`authKey`,void 0),e.t([(0,i.property)({type:String,attribute:`auth-token`,reflect:!0})],l.prototype,`authToken`,void 0),e.t([(0,i.property)({type:Number,attribute:`cache-time`,reflect:!0})],l.prototype,`cacheTime`,void 0),e.t([(0,i.property)({type:String,attribute:`content-language`,reflect:!0})],l.prototype,`contentLanguage`,void 0),e.t([(0,i.property)({type:Object,reflect:!1})],l.prototype,`filter`,void 0),e.t([(0,i.property)({type:Boolean,reflect:!0})],l.prototype,`quiet`,void 0),e.t([(0,i.property)({type:Boolean,reflect:!0})],l.prototype,`readonly`,void 0),e.t([(0,i.property)({type:Boolean,reflect:!0})],l.prototype,`disabled`,void 0),e.t([(0,i.state)()],l.prototype,`_numericValues`,void 0),e.t([(0,i.state)()],l.prototype,`_retrieving`,void 0),e.t([(0,i.state)()],l.prototype,`_search`,void 0),e.t([(0,i.state)()],l.prototype,`_error`,void 0),l=e.t([(0,a.localized)()],l),customElements.get(`luzmo-filter-value-picker-numeric`)||customElements.define(`luzmo-filter-value-picker-numeric`,l),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return l}});

package/components/filter-value-picker-numeric-hFm7V2GV.js

@@ -0,0 +1,237 @@
+/*! * 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 "./tokens-Ov1pCR4Y.js";
+import { t as e } from "./decorate-DyMgX_Uh.js";
+import { t } from "./localized-mixin-a1sQVLdN.js";
+import { n } from "./data-broker-BNXS5_qc.js";
+import { html as r, unsafeCSS as i } from "lit";
+import { property as a, state as o } from "lit/decorators.js";
+import { localized as s, msg as c } from "@lit/localize";
+import "@luzmo/lucero/select";
+import "@luzmo/lucero/number-field";
+import { ElementSizes as l, LuzmoElement as u, SizedMixin as d } from "@luzmo/lucero/utils";
+//#region src/components/filter-value-picker-numeric/filter-value-picker-numeric.module.scss?inline
+var f = ":host{flex-direction:row;flex-shrink:1;min-width:0;display:flex}luzmo-number-field,luzmo-select{min-width:var(--luzmo-filter-value-picker-numeric-control-min-width,var(--filter-value-picker-numeric-control-min-width));flex:auto;max-width:100%}.missing-value{opacity:.4}:host{--filter-value-picker-numeric-control-min-width:0}", p = 5e3, m = class extends t(d(u, { validSizes: Object.values(l) })) {
+	constructor(...e) {
+		super(...e), this.contentLanguage = "en", this.quiet = !1, this.readonly = !1, this.disabled = !1, this._numericValues = [], this._retrieving = !0, this._search = "", this._error = null, this._allValuesRetrieved = !1, this._runningQueries = [];
+	}
+	static get styles() {
+		return [i(f)];
+	}
+	connectedCallback() {
+		super.connectedCallback();
+		let e = {};
+		this.apiUrl && (e.apiUrl = this.apiUrl), this.cacheTime && (e.staleTime = this.cacheTime, e.gcTime = this.cacheTime * 2), this.authKey && this.authToken && (e.authKey = this.authKey, e.authToken = this.authToken), n.configure(e);
+	}
+	willUpdate(e) {
+		if (super.willUpdate(e), e.has("filter") && this.filter) {
+			let t = e.get("filter")?.expression, n = this.filter?.expression;
+			((e.get("filter")?.parameters?.[0]?.columnId || e.get("filter")?.parameters?.[0]?.formulaId) !== (this.filter?.parameters?.[0]?.columnId || this.filter?.parameters?.[0]?.formulaId) || !["? in ?", "? not in ?"].includes(t)) && ["? in ?", "? not in ?"].includes(n) && (this._numericValues = [], this._allValuesRetrieved = !1, this._retrieving = !0);
+		}
+	}
+	async _fetchNumericValues(e = 0) {
+		if (this._allValuesRetrieved) {
+			this._retrieving = !1;
+			return;
+		}
+		if (!this.filter?.parameters?.[0]) {
+			this._retrieving = !1, this._error = "Missing column parameters";
+			return;
+		}
+		let t = this.filter.parameters[0], r = t.columnId, i = t.formulaId, a = t.datasetId;
+		if (!r && !i) {
+			this._retrieving = !1, this._error = "Missing column id or formula id";
+			return;
+		} else if (!a) {
+			this._retrieving = !1, this._error = "Missing dataset id";
+			return;
+		}
+		this._retrieving = !0, this._error = null;
+		let o = {
+			expression: "? like ?",
+			parameters: [{
+				dataset_id: a,
+				expression: `CAST({${a}:${r ?? i}},hierarchy)`
+			}, this._search]
+		}, s = {
+			dimensions: [{
+				column_id: r,
+				formula_id: i,
+				dataset_id: a
+			}],
+			where: [],
+			order: [{
+				column_id: r,
+				formula_id: i,
+				dataset_id: a,
+				order: "asc"
+			}],
+			limit: {
+				by: p,
+				offset: e
+			}
+		};
+		this._search && !this._allValuesRetrieved && s.where.push(o);
+		let c = new AbortController(), l = new Promise((e, t) => {
+			n.fetchData(s).then(e).catch(t), c.signal.addEventListener("abort", () => {
+				console.warn("Request aborted"), t({ status: "aborted" });
+			});
+		}), u = {
+			promise: l,
+			abortController: c
+		};
+		this._runningQueries.push(u);
+		try {
+			let t = await l, n = t && Array.isArray(t.data) ? t.data.map((e) => e[0]) : [];
+			this._search || (this._allValuesRetrieved = n.length < p), this._numericValues = e > 0 ? [...this._numericValues, ...n] : n;
+		} catch (e) {
+			if (e?.status === "aborted") return;
+			this._error = e instanceof Error ? e.message : "Unknown error", this._numericValues = [];
+		} finally {
+			this._runningQueries = this._runningQueries.filter((e) => e.promise !== l), this._retrieving = !1;
+		}
+	}
+	_sendChangeEvent() {
+		this.dispatchEvent(new CustomEvent("luzmo-filter-value-changed", {
+			bubbles: !0,
+			composed: !0,
+			cancelable: !0,
+			detail: { value: this._value }
+		}));
+	}
+	setValue(e) {
+		if (this.readonly || this.disabled) return;
+		let t = ["? in ?", "? not in ?"].includes(this.filter?.expression) ? e?.detail?.value : e?.target?.value;
+		this._value !== t && (this._value = t, this.filter = {
+			...this.filter,
+			parameters: [{ ...this.filter?.parameters?.[0] }, t]
+		}, this._sendChangeEvent());
+	}
+	selectValue(e) {
+		if (this.readonly || this.disabled) return;
+		let t = (e.detail?.value ?? "").map((e) => Number.parseFloat(e));
+		this.filter = {
+			...this.filter,
+			parameters: [{ ...this.filter?.parameters?.[0] }, t]
+		}, this._value = t, this._sendChangeEvent();
+	}
+	onScrolled(e) {
+		!this._retrieving && !this._allValuesRetrieved && e?.detail?.last === this._numericValues.length - 1 && this._fetchNumericValues(this._numericValues.length);
+	}
+	renderNumberField() {
+		return r`<luzmo-number-field
+      label="Numeric filter value"
+      grows
+      .size=${this.size}
+      .quiet=${this.quiet}
+      .readonly=${this.readonly}
+      .disabled=${this.disabled}
+      @change=${this.setValue}
+      @input=${this.setValue}
+      .value=${this.filter?.parameters?.[1]}
+    ></luzmo-number-field>`;
+	}
+	setSearchString(e) {
+		this._search = e?.detail?.string ?? "", this._allValuesRetrieved || (this._searchQueryTimeout && (this._runningQueries.forEach((e) => {
+			e?.abortController && e.abortController.abort();
+		}), this._runningQueries = [], clearTimeout(this._searchQueryTimeout)), this._searchQueryTimeout = setTimeout(() => {
+			this._fetchNumericValues();
+		}, 500));
+	}
+	resetSearchString() {
+		this._search = "";
+	}
+	onOpened() {
+		this._fetchNumericValues();
+	}
+	renderValuePicker() {
+		if (this._error) return r`<div class="error" role="alert">${this._error}</div>`;
+		let e = this._numericValues.filter((e) => e.toString().toLowerCase().includes(this._search.toLowerCase())).map((e) => ({
+			value: e,
+			label: e
+		})), t = c("Selected {count} items"), n = c("Search"), i = c("No data"), a = c("No results"), o = c("Select...");
+		return r`<luzmo-select
+      .size=${this.size}
+      .label=${o}
+      .retrieving=${this._retrieving}
+      selects="multiple"
+      variant="checkboxes"
+      ?emphasized=${!this.quiet}
+      .quiet=${this.quiet}
+      .readonly=${this.readonly}
+      .disabled=${this.disabled}
+      no-wrap
+      ?invalid=${!!this._error}
+      .multipleLabelTemplate=${t}
+      .searchLabel=${n}
+      .noDataLabel=${i}
+      .noResultsLabel=${a}
+      @change=${this.selectValue}
+      @luzmo-search=${this.setSearchString}
+      @luzmo-opened=${this.onOpened}
+      @luzmo-closed=${this.resetSearchString}
+      @luzmo-scrolled=${this.onScrolled}
+      .options=${e}
+      .value=${this.filter?.parameters?.[1]}
+    >
+    </luzmo-select>`;
+	}
+	render() {
+		let e = this.filter?.expression;
+		return ["? in ?", "? not in ?"].includes(e) ? this.renderValuePicker() : this.renderNumberField();
+	}
+};
+//#endregion
+//#region src/components/filter-value-picker-numeric/index.ts
+e([a({
+	type: String,
+	attribute: "api-url",
+	reflect: !0
+})], m.prototype, "apiUrl", void 0), e([a({
+	type: String,
+	attribute: "auth-key",
+	reflect: !0
+})], m.prototype, "authKey", void 0), e([a({
+	type: String,
+	attribute: "auth-token",
+	reflect: !0
+})], m.prototype, "authToken", void 0), e([a({
+	type: Number,
+	attribute: "cache-time",
+	reflect: !0
+})], m.prototype, "cacheTime", void 0), e([a({
+	type: String,
+	attribute: "content-language",
+	reflect: !0
+})], m.prototype, "contentLanguage", void 0), e([a({
+	type: Object,
+	reflect: !1
+})], m.prototype, "filter", void 0), e([a({
+	type: Boolean,
+	reflect: !0
+})], m.prototype, "quiet", void 0), e([a({
+	type: Boolean,
+	reflect: !0
+})], m.prototype, "readonly", void 0), e([a({
+	type: Boolean,
+	reflect: !0
+})], m.prototype, "disabled", void 0), e([o()], m.prototype, "_numericValues", void 0), e([o()], m.prototype, "_retrieving", void 0), e([o()], m.prototype, "_search", void 0), e([o()], m.prototype, "_error", void 0), m = e([s()], m), customElements.get("luzmo-filter-value-picker-numeric") || customElements.define("luzmo-filter-value-picker-numeric", m);
+//#endregion
+export { m as t };

package/components/filters/filters.d.ts

@@ -0,0 +1,182 @@
+import '@luzmo/lucero/action-button';
+import '@luzmo/lucero/button';
+import '@luzmo/lucero/icon';
+import '@luzmo/lucero/progress-circle';
+import '@luzmo/lucero/tooltip';
+import { LuzmoElement } from '@luzmo/lucero/utils';
+import { CSSResultArray, PropertyValues, TemplateResult } from 'lit';
+import type { FilterColumnDisplay } from '../../utils/filters/presentation';
+import '../filter-item';
+import type { FilterParameter, FiltersDisplay, FiltersFormat, FiltersInput } from './types';
+declare const LuzmoFilters_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement & {
+    new (...args: any[]): import("@luzmo/lucero").SizedElementInterface;
+    prototype: import("@luzmo/lucero").SizedElementInterface;
+};
+/**
+ * @customElement luzmo-filters
+ * @attr column-display - Visual treatment of column and formula references in text and outline displays.
+ * @csspart filters-text - The inline sentence shown when `display` is `text`.
+ * @csspart filters-outline - The bracket layout shown when `display` is `outline`.
+ * @csspart filters-outline-row - One filter row in the outline, including its delete button when shown.
+ * @cssprop --luzmo-filters-text-font-size - Font size of the text and outline displays. Defaults follow `size` (`--luzmo-font-size-s` through `--luzmo-font-size-xl`).
+ * @cssprop --luzmo-filters-text-part-gap - Space between the parts of an outline filter. Defaults follow `size` (`--luzmo-spacing-1` through `--luzmo-spacing-4`). The text display uses word spacing instead.
+ * @cssprop --luzmo-filters-text-icon-gap - Space between a field icon and its name in the text display. Defaults to `--luzmo-spacing-1` at `s` and `m`, and `--luzmo-spacing-2` at `l` and `xl`.
+ * @cssprop --luzmo-filters-outline-children-margin-inline-start - Indent of a nested outline group. Defaults follow `size` from `--luzmo-spacing-1` to `--luzmo-spacing-4`.
+ * @cssprop --luzmo-filters-outline-children-padding-inline-start - Padding inside an outline bracket. Sizes `s` and `m` use `--luzmo-spacing-3`, `l` uses `--luzmo-spacing-4`, and `xl` uses `--luzmo-spacing-5`.
+ * @cssprop --luzmo-filters-outline-bracket-inset - Inset of the outline bracket from the start edge of its children. Size `s` uses `--luzmo-spacing-1`, `m` and `l` use `--luzmo-spacing-2`, and `xl` uses `--luzmo-spacing-3`.
+ * @cssprop --luzmo-filters-expression-color - Color of an expression such as "is in" or ">". Defaults to the sentence color. Set it to `var(--luzmo-primary)` to use the primary color. An empty value uses the sentence color.
+ * @cssprop --luzmo-filters-expression-font-weight - Weight of an expression such as "is in" or ">". Defaults to normal (`--luzmo-font-weight`). Set it to `var(--luzmo-font-weight-bold)` for bold. An empty value uses normal.
+ * @cssprop --luzmo-filters-condition-color - Color of an AND/OR label. Defaults to the sentence color. Set it to `var(--luzmo-primary)` to use the primary color. An empty value uses the sentence color.
+ * @cssprop --luzmo-filters-condition-font-weight - Weight of an AND/OR label. The outline defaults to bold and the text sentence defaults to normal. Set the token to apply one weight to both. An empty value uses normal.
+ * @cssprop --luzmo-filters-outline-condition-font-size - Font size of the AND/OR label in the outline. Defaults one step below the sentence for the current `size`.
+ * @cssprop --luzmo-filters-column-badge-color - Border for outline badges, tint for subtle badges, and background for filled badges.
+ * @cssprop --luzmo-filters-column-badge-font-color - Label and icon color for column badges.
+ * @fires {CustomEvent<FiltersChangedEventDetail>} luzmo-filters-changed - Announces that the filters have changed,
+ * carrying the emitted groups and the format they are in. `display="text"` never fires this.
+ * Outline fires it after a filter is deleted.
+ * @fires {CustomEvent<{ parameter: FilterParameter }>} luzmo-parameter-created - Announces that a parameter was created and added to `parameters`.
+ * @fires {CustomEvent<{ parameter: FilterParameter }>} luzmo-parameter-removed - Announces that a parameter was detached from a filter.
+ */
+export declare class LuzmoFilters extends LuzmoFilters_base {
+    static get styles(): CSSResultArray;
+    /**
+     * The API URL of the databroker
+     * @default https://api.luzmo.com
+     */
+    apiUrl?: string;
+    /**
+     * The auth key of the databroker
+     */
+    authKey?: string;
+    /**
+     * The auth token of the databroker
+     */
+    authToken?: string;
+    /**
+     * The cache time of the databroker
+     */
+    cacheTime?: number;
+    /**
+     * The language to use for locale-aware formatting and labels
+     */
+    contentLanguage: string;
+    /**
+     * The time zone to use for the date picker
+     */
+    timeZone?: string;
+    /**
+     * The dataset ids to fetch columns & formulas
+     */
+    datasetIds?: string[];
+    /**
+     * The filter groups to display.
+     *
+     * Accepts both halves of the public `ItemFilterOutput` / `DashboardFilterOutput`
+     * unions: canonical `ItemFilterGroup[]` and clean clause groups with flattened
+     * leaves. Nested `and` / `or` groups are preserved either way.
+     */
+    filters: FiltersInput;
+    /**
+     * Output format for the `luzmo-filters-changed` event.
+     *
+     * `canonical` emits `ItemFilterGroup[]`; `clean` emits the clean clause groups
+     * that aligned hosts consume. A tree that cannot be represented cleanly falls
+     * back to canonical output, and the event says which format it carries.
+     * @default canonical
+     */
+    format: FiltersFormat;
+    /**
+     * How the filters are presented. `rich` is the editable group editor. `text` is a read-only
+     * sentence, with parentheses around nested AND/OR groups. `outline` is one wrapping filter per
+     * line inside bracket rails, and can delete a filter unless `readonly` is set.
+     * @default rich
+     */
+    display: FiltersDisplay;
+    /** Presentation of column and formula references in text and outline displays. */
+    columnDisplay: FilterColumnDisplay;
+    /**
+     * Removes rich-editor control chrome while keeping the filters editable.
+     * @default false
+     */
+    quiet: boolean;
+    /**
+     * Prevents changes while preserving the selected display and visual treatment.
+     * In `outline`, this hides the delete buttons.
+     * @default false
+     */
+    readonly: boolean;
+    /**
+     * Whether parameter-backed filter values can be created and selected.
+     * @default false
+     */
+    allowParameters: boolean;
+    /**
+     * Consumer-owned parameter definitions available to filter rows.
+     */
+    parameters: FilterParameter[];
+    /**
+     * Debounce time in milliseconds for the filters-changed event
+     * @default 300
+     */
+    debounce: number;
+    private _internalFilterGroup;
+    private _datasets;
+    private _datasetsLoading;
+    private _hierarchyLabels;
+    private _hierarchyLabelsLoading;
+    private _hasSyntheticRoot;
+    private _datasetRequest;
+    private _hierarchyRequest;
+    private _debounceTimeout;
+    /**
+     * Get a smaller size for the condition badges
+     */
+    private get _oneSizeSmaller();
+    /**
+     * Check if datasetIds is empty or undefined
+     */
+    private get _isDatasetIdsEmpty();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    private _loadDatasetsForDisplay;
+    private _configureDataBroker;
+    private _loadHierarchyLabelsForDisplay;
+    private _filterTextContext;
+    private _generateEmptyGroup;
+    private _generateEmptyFilter;
+    /**
+     * The root groups to export: either the wrapped children or the single group.
+     */
+    private _rootGroupsForExport;
+    private _getFiltersForExport;
+    private _sendChangeEvent;
+    private _isGroup;
+    /**
+     * A parameter created in one row becomes selectable in every row.
+     */
+    private _handleParameterCreated;
+    private _toggleCondition;
+    private _addFilter;
+    private _addSubGroup;
+    private _removeFilter;
+    private _updateFilter;
+    private _addGroup;
+    private _renderFilterItem;
+    private _renderGroup;
+    private _findParentGroup;
+    private _collapseIfNeeded;
+    private _collapseGroupsAfterDelete;
+    private _renderTextLeaf;
+    private _renderTextGroup;
+    private _renderDatasetLoading;
+    private _renderTextDisplay;
+    private _deleteOutlineFilter;
+    private _renderOutlineRow;
+    private _renderOutlineGroup;
+    private _renderOutlineDisplay;
+    protected render(): TemplateResult;
+}
+export {};

package/components/filters/index.cjs

@@ -1,20 +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.
+/*! * 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("../filters-CGqIDlPK.cjs");exports.FilterUnrepresentableError=e.a,Object.defineProperty(exports,"LuzmoFilters",{enumerable:!0,get:function(){return e.t}}),exports.MAX_FILTER_NESTING_DEPTH=e.o,exports.detectFiltersFormat=e.s,exports.reverseTransformFilters=e.n,exports.toLogicalCondition=e.r,exports.transformFilters=e.i;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../filters-CS2JKt1Y.cjs");exports.FilterUnrepresentableError=e.a,Object.defineProperty(exports,"LuzmoFilters",{enumerable:!0,get:function(){return e.t}}),exports.MAX_FILTER_NESTING_DEPTH=e.o,exports.detectFiltersFormat=e.s,exports.reverseTransformFilters=e.n,exports.toLogicalCondition=e.r,exports.transformFilters=e.i;

package/components/filters/index.d.ts

@@ -0,0 +1,12 @@
+import { LuzmoFilters } from './filters';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-filters': LuzmoFilters;
+    }
+}
+export { LuzmoFilters } from './filters';
+export { detectFiltersFormat, FilterUnrepresentableError, MAX_FILTER_NESTING_DEPTH } from './transformations/filter-format';
+export { reverseTransformFilters, toLogicalCondition, transformFilters } from './transformations/transform-filters';
+export type { DetectedFiltersFormat, TransformFiltersOptions } from './transformations/transform-filters';
+export type { CleanFilter, CleanFilterClauseGroup, CleanFilterGroup, CleanRetrievedFilterGroup, DashboardFilterOutput, FilterClause, FilterCondition, FilterGroup, FilterParameter, FilterParameterEventDetail, FilterParameterType, FiltersChangedEventDetail, FiltersDisplay, FiltersFormat, FiltersInput, FiltersOutput, ItemFilterOutput } from './types';
+export type { FilterColumnDisplay } from '../../utils/filters/presentation';

package/components/filters/index.js

@@ -1,21 +1,21 @@
-/*! * 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.
+/*! * 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 { a as e, i as t, n, o as r, r as i, s as a, t as o } from "../filters-D5oua2IU.js";
+import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "../filters-CuB7alHb.js";
 export { e as FilterUnrepresentableError, o as LuzmoFilters, r as MAX_FILTER_NESTING_DEPTH, a as detectFiltersFormat, n as reverseTransformFilters, i as toLogicalCondition, t as transformFilters };

package/components/filters/transformations/clean-filters.d.ts

@@ -0,0 +1,37 @@
+import type { CleanFilter, CleanFilterClauseGroup, FilterClause, FilterCondition, FilterGroup as EditFilterGroup } from '../types';
+type UnknownRecord = Record<string, unknown>;
+/**
+ * A value that names a column rather than holding a literal. Mirrors the shared
+ * `isFilterColumnParam`: a named source stands on its own, while a bare
+ * `expression` needs a dataset to be a reference rather than a value. A reference
+ * missing its dataset still matches, so that clean emit rejects it instead of
+ * passing the raw canonical object through as a value.
+ */
+export declare function isFilterReference(value: unknown): value is UnknownRecord;
+/**
+ * Clean reference -> canonical `parameters[0]`. `columnId` wins over an ad-hoc
+ * expression, and `columnExpression` becomes the canonical reference `expression`.
+ */
+export declare function cleanReferenceToCanonical(reference: UnknownRecord, allowExpressionAlias?: boolean): UnknownRecord;
+/**
+ * Canonical `parameters[0]` -> clean inlined reference. Nested references inside
+ * `discretization.over` and `aggregation` are converted too, `lowestLevel` and
+ * null-valued optional members are dropped, and a reference that cannot be
+ * expressed publicly throws rather than leaking canonical keys into clean output.
+ */
+export declare function canonicalReferenceToClean(reference: UnknownRecord): UnknownRecord;
+/** Clean leaf -> editor condition, restoring the canonical `parameters` tuple. */
+export declare function cleanLeafToCondition(leaf: UnknownRecord, inheritedClause?: FilterClause): FilterCondition;
+/**
+ * Editor condition -> clean leaf. Returns `null` only for a leaf with no
+ * expression, matching the canonical exporter's drop rule. Anything else that
+ * cannot be expressed cleanly throws, the way the shared normalizer does:
+ * dropping a live predicate would silently widen the rows the host applies.
+ */
+export declare function conditionToCleanLeaf(condition: FilterCondition): CleanFilter | null;
+/**
+ * Editor group -> clean clause groups. A group holding both clauses becomes one
+ * `where` group and one `having` group; neither reuses the original group id.
+ */
+export declare function editGroupToCleanGroups(group: EditFilterGroup): CleanFilterClauseGroup[];
+export {};