@luzmo/analytics-components-kit 1.0.8 → 1.0.9-beta.2

package/components/filter-expression-picker-3xcrAACt.js

@@ -0,0 +1,434 @@
+/*! * 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-DaLXe5J9.js";
+import { html as n, unsafeCSS as r } from "lit";
+import { property as i, state as a } from "lit/decorators.js";
+import { localized as o, msg as s } from "@lit/localize";
+import "@luzmo/lucero/select";
+import "@luzmo/lucero/field-label";
+import "@luzmo/lucero/menu";
+import { ElementSizes as c, LuzmoElement as l, SizedMixin as u } from "@luzmo/lucero/utils";
+//#region src/utils/filters/expressions.ts
+var d = () => [
+	{
+		id: "? = ?",
+		key: "? = ?",
+		expression: "? = ?",
+		name: s("equals", { desc: "Filter expression for equals comparison" }),
+		description: s("equals", { desc: "Filter expression for equals comparison" }),
+		tiny: s("eq", { desc: "Short form of equals comparison" }),
+		type: ["numeric", "hierarchy"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? != ?",
+		key: "? != ?",
+		expression: "? != ?",
+		name: s("not equals", { desc: "Filter expression for not equals comparison" }),
+		description: s("not equals", { desc: "Filter expression for not equals comparison" }),
+		tiny: s("not eq", { desc: "Short form of not equals comparison" }),
+		type: ["numeric", "hierarchy"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? in ?",
+		key: "? in ?",
+		expression: "? in ?",
+		name: s("is in", { desc: "Filter expression for in comparison" }),
+		description: s("is in", { desc: "Filter expression for in comparison" }),
+		tiny: s("is in", { desc: "Filter expression for in comparison" }),
+		type: ["numeric", "hierarchy"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? not in ?",
+		key: "? not in ?",
+		expression: "? not in ?",
+		name: s("is not in", { desc: "Filter expression for not in comparison" }),
+		description: s("is not in", { desc: "Filter expression for not in comparison" }),
+		tiny: s("is not in", { desc: "Filter expression for not in comparison" }),
+		type: ["numeric", "hierarchy"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? like ?",
+		key: "? like ?",
+		expression: "? like ?",
+		name: s("contains", { desc: "Filter expression for contains comparison" }),
+		description: s("contains", { desc: "Filter expression for contains comparison" }),
+		tiny: s("cont", { desc: "Short form of contains comparison in filter expression" }),
+		type: ["hierarchy"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? not like ?",
+		key: "? not like ?",
+		expression: "? not like ?",
+		name: s("does not contain", { desc: "Filter expression for does not contain comparison" }),
+		description: s("does not contain", { desc: "Filter expression for does not contain comparison" }),
+		tiny: s("not cont", { desc: "Short form of does not contain comparison in filter expression" }),
+		type: ["hierarchy"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? starts with ?",
+		key: "? starts with ?",
+		expression: "? starts with ?",
+		name: s("starts with", { desc: "Filter expression for starts with comparison" }),
+		description: s("starts with", { desc: "Filter expression for starts with comparison" }),
+		tiny: s("starts with", { desc: "Filter expression for starts with comparison" }),
+		type: ["hierarchy"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? not starts with ?",
+		key: "? not starts with ?",
+		expression: "? not starts with ?",
+		name: s("does not start with", { desc: "Filter expression for does not start with comparison" }),
+		description: s("does not start with", { desc: "Filter expression for does not start with comparison" }),
+		tiny: s("not starts with", { desc: "Short form of does not start with comparison in filter expression" }),
+		type: ["hierarchy"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? ends with ?",
+		key: "? ends with ?",
+		expression: "? ends with ?",
+		name: s("ends with", { desc: "Filter expression for ends with comparison" }),
+		description: s("ends with", { desc: "Filter expression for ends with comparison" }),
+		tiny: s("ends with", { desc: "Filter expression for ends with comparison" }),
+		type: ["hierarchy"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? not ends with ?",
+		key: "? not ends with ?",
+		expression: "? not ends with ?",
+		name: s("does not end with", { desc: "Filter expression for does not end with comparison" }),
+		description: s("does not end with", { desc: "Filter expression for does not end with comparison" }),
+		tiny: s("not ends with", { desc: "Short form of does not end with comparison in filter expression" }),
+		type: ["hierarchy"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? < ?",
+		key: "? < ?",
+		expression: "? < ?",
+		name: s("less than", { desc: "Filter expression for less than comparison" }),
+		description: s("less than", { desc: "Filter expression for less than comparison" }),
+		tiny: "<",
+		type: ["numeric", "datetime"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? <= ?",
+		key: "? <= ?",
+		expression: "? <= ?",
+		name: s("less than or equal", { desc: "Filter expression for less than or equal comparison" }),
+		description: s("less than or equal", { desc: "Filter expression for less than or equal comparison" }),
+		tiny: "<=",
+		type: ["numeric", "datetime"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? > ?",
+		key: "? > ?",
+		expression: "? > ?",
+		name: s("greater than", { desc: "Filter expression for greater than comparison" }),
+		description: s("greater than", { desc: "Filter expression for greater than comparison" }),
+		tiny: ">",
+		type: ["numeric", "datetime"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? >= ?",
+		key: "? >= ?",
+		expression: "? >= ?",
+		name: s("greater than or equal", { desc: "Filter expression for greater than or equal comparison" }),
+		description: s("greater than or equal", { desc: "Filter expression for greater than or equal comparison" }),
+		tiny: ">=",
+		type: ["numeric", "datetime"],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? between ?",
+		key: "? between ?",
+		expression: "? between ?",
+		name: s("is between", { desc: "Filter expression for between comparison" }),
+		description: s("is between", { desc: "Filter expression for between comparison" }),
+		tiny: s("between", { desc: "Short form of between comparison in filter expression" }),
+		type: [],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "last_now",
+		key: "last_now",
+		expression: "last_now",
+		name: s("last (x) periods", { desc: "Filter expression for last (x) periods" }),
+		description: s("last (x) periods", { desc: "Filter expression for last (x) periods" }),
+		tiny: s("last", { desc: "Short form of last (x) periods in filter expression" }),
+		type: ["datetime"]
+	},
+	{
+		id: "last_available",
+		key: "last_available",
+		expression: "last_available",
+		name: s("last (x) available periods", { desc: "Filter expression for last (x) available periods" }),
+		description: s("last (x) available periods", { desc: "Filter expression for last (x) available periods" }),
+		tiny: s("last available", { desc: "Short form of last (x) available periods in filter expression" }),
+		type: ["datetime"]
+	},
+	{
+		id: "last_completed",
+		key: "last_completed",
+		expression: "last_completed",
+		name: s("last completed period", { desc: "Filter expression for last completed period" }),
+		description: s("last completed (period)", { desc: "Filter expression for last completed period" }),
+		tiny: s("last completed", { desc: "Short form of last completed period in filter expression" }),
+		type: ["datetime"]
+	},
+	{
+		id: "next_now",
+		key: "next_now",
+		expression: "next_now",
+		name: s("next (x) periods", { desc: "Filter expression for next (x) periods" }),
+		description: s("next (x) periods", { desc: "Filter expression for next (x) periods" }),
+		tiny: s("next", { desc: "Short form of next (x) periods in filter expression" }),
+		type: ["datetime"]
+	},
+	{
+		id: "more_than_ago",
+		key: "more_than_ago",
+		expression: "more_than_ago",
+		name: s("more than (x) periods ago", { desc: "Filter expression for more than (x) periods ago" }),
+		description: s("more than (x) periods ago", { desc: "Filter expression for more than (x) periods ago" }),
+		tiny: s("more than ago", { desc: "Short form of more than (x) periods ago in filter expression" }),
+		type: ["datetime"]
+	},
+	{
+		id: "or_more_ago",
+		key: "or_more_ago",
+		expression: "or_more_ago",
+		name: s("(x) periods or more ago", { desc: "Filter expression for (x) periods or more ago" }),
+		description: s("(x) periods or more ago", { desc: "Filter expression for (x) periods or more ago" }),
+		tiny: s("or more ago", { desc: "Short form of (x) periods or more ago in filter expression" }),
+		type: ["datetime"]
+	},
+	{
+		id: "next_full",
+		key: "next_full",
+		expression: "next_full",
+		name: s("next full (period)", { desc: "Filter expression for next full period" }),
+		description: s("next full (period)", { desc: "Filter expression for next full period" }),
+		tiny: s("next full", { desc: "Short form of next full period in filter expression" }),
+		type: ["datetime"]
+	},
+	{
+		id: "WTD",
+		key: "to_date",
+		expression: "to_date",
+		unit: 4,
+		name: s("week to date", { desc: "Filter expression for week to date" }),
+		description: s("week to date", { desc: "Filter expression for week to date" }),
+		tiny: s("WTD", { desc: "Short form of week to date in filter expression" }),
+		type: ["datetime"]
+	},
+	{
+		id: "MTD",
+		key: "to_date",
+		expression: "to_date",
+		unit: 3,
+		name: s("month to date", { desc: "Filter expression for month to date" }),
+		description: s("month to date", { desc: "Filter expression for month to date" }),
+		tiny: s("MTD", { desc: "Short form of month to date in filter expression" }),
+		type: ["datetime"]
+	},
+	{
+		id: "QTD",
+		key: "to_date",
+		expression: "to_date",
+		unit: 2,
+		name: s("quarter to date", { desc: "Filter expression for quarter to date" }),
+		description: s("quarter to date", { desc: "Filter expression for quarter to date" }),
+		tiny: s("QTD", { desc: "Short form of quarter to date in filter expression" }),
+		type: ["datetime"]
+	},
+	{
+		id: "YTD",
+		key: "to_date",
+		expression: "to_date",
+		unit: 1,
+		name: s("year to date", { desc: "Filter expression for year to date" }),
+		description: s("year to date", { desc: "Filter expression for year to date" }),
+		tiny: s("YTD", { desc: "Short form of year to date in filter expression" }),
+		type: ["datetime"]
+	},
+	{
+		id: "? is null",
+		key: "? is null",
+		expression: "? is null",
+		name: s("is missing", { desc: "Filter expression for is missing" }),
+		description: s("is missing", { desc: "Filter expression for is missing" }),
+		tiny: s("missing", { desc: "Short form of is missing in filter expression" }),
+		type: [
+			"numeric",
+			"datetime",
+			"hierarchy",
+			"spatial"
+		],
+		subtype: ["ip_address"]
+	},
+	{
+		id: "? is not null",
+		key: "? is not null",
+		expression: "? is not null",
+		name: s("is not missing", { desc: "Filter expression for is not missing" }),
+		description: s("is not missing", { desc: "Filter expression for is not missing" }),
+		tiny: s("not missing", { desc: "Short form of is not missing in filter expression" }),
+		type: [
+			"numeric",
+			"datetime",
+			"hierarchy",
+			"spatial"
+		],
+		subtype: ["ip_address"]
+	}
+], f = (e, t, n) => {
+	let r = /* @__PURE__ */ new Set(["? in ?", "? not in ?"]);
+	return !e && !t ? d() : d().filter((i) => (e && i.type.includes(e) || t && i.subtype?.includes(t)) && !(n && r.has(i.key)));
+}, p = ":host{font-family:var(--luzmo-font-family)}luzmo-select{width:100%}:host{--var:blue}", m = class extends t(u(l, { validSizes: Object.values(c) })) {
+	constructor(...e) {
+		super(...e), this.hasLabel = !1, this.allowEmpty = !1, this.placeholder = "", this.disabled = !1, this.readonly = !1, this.quiet = !1, this.invalid = !1, this.isFormula = !1, this._expressionConfigurations = d();
+	}
+	static get styles() {
+		return [r(p)];
+	}
+	_sendChangeEvent() {
+		if (this.disabled || this.readonly) return;
+		let e = { expression: this.filter?.expression };
+		this.filter?.parameters?.[1]?.unit && (e.unit = this.filter?.parameters?.[1]?.unit), this.dispatchEvent(new CustomEvent("luzmo-expression-selected", {
+			bubbles: !0,
+			composed: !0,
+			cancelable: !0,
+			detail: e
+		}));
+	}
+	setExpression(e) {
+		this._richExpression = e?.detail?.value?.[0];
+		let t = this._expressionConfigurations.find((e) => e.id === this._richExpression), n = structuredClone(this.filter);
+		n.expression = t?.expression, t?.unit && (this._unit = t.unit, n?.parameters[0] && (n.parameters[1] = { unit: this._unit })), this.filter = n, this._sendChangeEvent();
+	}
+	willUpdate(e) {
+		super.willUpdate(e);
+		let t = e.has("filter"), n = e.has("type"), r = e.has("subtype"), i = e.has("isFormula"), a = f(this.type, this.subtype, this.isFormula), o = [
+			"YTD",
+			"QTD",
+			"MTD",
+			"WTD"
+		];
+		if (this.filter?.expression === "to_date") {
+			let e = this.filter?.parameters[1]?.unit ?? 1;
+			this._unit = e, this._richExpression = o[e - 1] ?? "YTD";
+		} else this._richExpression = this.filter?.expression;
+		(n || r || i || t) && this.filter && !this.disabled && !this.readonly && !a?.find((e) => e.expression === this.filter?.expression) ? (this.invalid = !0, console.warn(`Warning: ${this.filter?.expression} is not valid given the type: ${this.type} and subtype: ${this.subtype}`)) : this.invalid = !1, !this.filter?.expression && !this.allowEmpty && (this._richExpression = a?.[0]?.id, this.filter = {
+			...this.filter,
+			expression: this._richExpression
+		}, this._sendChangeEvent());
+	}
+	render() {
+		let e = f(this.type, this.subtype, this.isFormula)?.map((e) => ({
+			value: e.id,
+			label: e.description,
+			shortLabel: e.tiny
+		})), t = this.disabled || !this.filter?.expression && !this.allowEmpty, r = n`<luzmo-field-label
+      for="expression"
+      size=${this.size}
+      >${this.label ?? s("Select an expression", { desc: "Label for expression picker" })}</luzmo-field-label
+    >`, i = this.hasLabel ? this.placeholder ?? s("Select...") : this.placeholder || this.label || s("Filter expression", { desc: "Accessible label for expression picker" });
+		return n`${this.hasLabel ? r : ""}
+      <luzmo-select
+        label=${i}
+        id="expression"
+        size=${this.size}
+        variant="highlight"
+        .quiet=${this.quiet}
+        selects="single"
+        .language=${this.language}
+        ?disabled=${t}
+        .readonly=${this.readonly}
+        ?invalid=${this.invalid}
+        .options=${e}
+        .value=${[this._richExpression]}
+        @change=${this.setExpression}
+      >
+      </luzmo-select>`;
+	}
+};
+//#endregion
+//#region src/components/filter-expression-picker/index.ts
+e([i({
+	type: String,
+	reflect: !0
+})], m.prototype, "filter", void 0), e([i({
+	type: Boolean,
+	attribute: "has-label",
+	reflect: !0
+})], m.prototype, "hasLabel", void 0), e([i({
+	type: String,
+	reflect: !0
+})], m.prototype, "label", void 0), e([i({
+	type: Boolean,
+	attribute: "allow-empty",
+	reflect: !0
+})], m.prototype, "allowEmpty", void 0), e([i({
+	type: String,
+	attribute: "placeholder",
+	reflect: !0
+})], m.prototype, "placeholder", void 0), e([i({
+	type: Boolean,
+	attribute: "disabled",
+	reflect: !0
+})], m.prototype, "disabled", void 0), e([i({
+	type: Boolean,
+	reflect: !0
+})], m.prototype, "readonly", void 0), e([i({
+	type: Boolean,
+	reflect: !0
+})], m.prototype, "quiet", void 0), e([i({
+	type: String,
+	attribute: "type",
+	reflect: !0
+})], m.prototype, "type", void 0), e([i({
+	type: String,
+	attribute: "subtype",
+	reflect: !0
+})], m.prototype, "subtype", void 0), e([i({
+	type: Boolean,
+	attribute: "invalid",
+	reflect: !0
+})], m.prototype, "invalid", void 0), e([i({
+	type: Boolean,
+	attribute: "is-formula",
+	reflect: !0
+})], m.prototype, "isFormula", void 0), e([a()], m.prototype, "_richExpression", void 0), e([a()], m.prototype, "_unit", void 0), m = e([o()], m), customElements.get("luzmo-filter-expression-picker") || customElements.define("luzmo-filter-expression-picker", m);
+//#endregion
+export { d as n, f as r, m as t };

package/components/filter-expression-picker-BrtXMSBv.cjs

@@ -0,0 +1,40 @@
+/*! * 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-DiUJOd06.cjs");let n=require("lit"),r=require("lit/decorators.js"),i=require("@lit/localize");require("@luzmo/lucero/select"),require("@luzmo/lucero/field-label"),require("@luzmo/lucero/menu");let a=require("@luzmo/lucero/utils");var o=()=>[{id:`? = ?`,key:`? = ?`,expression:`? = ?`,name:(0,i.msg)(`equals`,{desc:`Filter expression for equals comparison`}),description:(0,i.msg)(`equals`,{desc:`Filter expression for equals comparison`}),tiny:(0,i.msg)(`eq`,{desc:`Short form of equals comparison`}),type:[`numeric`,`hierarchy`],subtype:[`ip_address`]},{id:`? != ?`,key:`? != ?`,expression:`? != ?`,name:(0,i.msg)(`not equals`,{desc:`Filter expression for not equals comparison`}),description:(0,i.msg)(`not equals`,{desc:`Filter expression for not equals comparison`}),tiny:(0,i.msg)(`not eq`,{desc:`Short form of not equals comparison`}),type:[`numeric`,`hierarchy`],subtype:[`ip_address`]},{id:`? in ?`,key:`? in ?`,expression:`? in ?`,name:(0,i.msg)(`is in`,{desc:`Filter expression for in comparison`}),description:(0,i.msg)(`is in`,{desc:`Filter expression for in comparison`}),tiny:(0,i.msg)(`is in`,{desc:`Filter expression for in comparison`}),type:[`numeric`,`hierarchy`],subtype:[`ip_address`]},{id:`? not in ?`,key:`? not in ?`,expression:`? not in ?`,name:(0,i.msg)(`is not in`,{desc:`Filter expression for not in comparison`}),description:(0,i.msg)(`is not in`,{desc:`Filter expression for not in comparison`}),tiny:(0,i.msg)(`is not in`,{desc:`Filter expression for not in comparison`}),type:[`numeric`,`hierarchy`],subtype:[`ip_address`]},{id:`? like ?`,key:`? like ?`,expression:`? like ?`,name:(0,i.msg)(`contains`,{desc:`Filter expression for contains comparison`}),description:(0,i.msg)(`contains`,{desc:`Filter expression for contains comparison`}),tiny:(0,i.msg)(`cont`,{desc:`Short form of contains comparison in filter expression`}),type:[`hierarchy`],subtype:[`ip_address`]},{id:`? not like ?`,key:`? not like ?`,expression:`? not like ?`,name:(0,i.msg)(`does not contain`,{desc:`Filter expression for does not contain comparison`}),description:(0,i.msg)(`does not contain`,{desc:`Filter expression for does not contain comparison`}),tiny:(0,i.msg)(`not cont`,{desc:`Short form of does not contain comparison in filter expression`}),type:[`hierarchy`],subtype:[`ip_address`]},{id:`? starts with ?`,key:`? starts with ?`,expression:`? starts with ?`,name:(0,i.msg)(`starts with`,{desc:`Filter expression for starts with comparison`}),description:(0,i.msg)(`starts with`,{desc:`Filter expression for starts with comparison`}),tiny:(0,i.msg)(`starts with`,{desc:`Filter expression for starts with comparison`}),type:[`hierarchy`],subtype:[`ip_address`]},{id:`? not starts with ?`,key:`? not starts with ?`,expression:`? not starts with ?`,name:(0,i.msg)(`does not start with`,{desc:`Filter expression for does not start with comparison`}),description:(0,i.msg)(`does not start with`,{desc:`Filter expression for does not start with comparison`}),tiny:(0,i.msg)(`not starts with`,{desc:`Short form of does not start with comparison in filter expression`}),type:[`hierarchy`],subtype:[`ip_address`]},{id:`? ends with ?`,key:`? ends with ?`,expression:`? ends with ?`,name:(0,i.msg)(`ends with`,{desc:`Filter expression for ends with comparison`}),description:(0,i.msg)(`ends with`,{desc:`Filter expression for ends with comparison`}),tiny:(0,i.msg)(`ends with`,{desc:`Filter expression for ends with comparison`}),type:[`hierarchy`],subtype:[`ip_address`]},{id:`? not ends with ?`,key:`? not ends with ?`,expression:`? not ends with ?`,name:(0,i.msg)(`does not end with`,{desc:`Filter expression for does not end with comparison`}),description:(0,i.msg)(`does not end with`,{desc:`Filter expression for does not end with comparison`}),tiny:(0,i.msg)(`not ends with`,{desc:`Short form of does not end with comparison in filter expression`}),type:[`hierarchy`],subtype:[`ip_address`]},{id:`? < ?`,key:`? < ?`,expression:`? < ?`,name:(0,i.msg)(`less than`,{desc:`Filter expression for less than comparison`}),description:(0,i.msg)(`less than`,{desc:`Filter expression for less than comparison`}),tiny:`<`,type:[`numeric`,`datetime`],subtype:[`ip_address`]},{id:`? <= ?`,key:`? <= ?`,expression:`? <= ?`,name:(0,i.msg)(`less than or equal`,{desc:`Filter expression for less than or equal comparison`}),description:(0,i.msg)(`less than or equal`,{desc:`Filter expression for less than or equal comparison`}),tiny:`<=`,type:[`numeric`,`datetime`],subtype:[`ip_address`]},{id:`? > ?`,key:`? > ?`,expression:`? > ?`,name:(0,i.msg)(`greater than`,{desc:`Filter expression for greater than comparison`}),description:(0,i.msg)(`greater than`,{desc:`Filter expression for greater than comparison`}),tiny:`>`,type:[`numeric`,`datetime`],subtype:[`ip_address`]},{id:`? >= ?`,key:`? >= ?`,expression:`? >= ?`,name:(0,i.msg)(`greater than or equal`,{desc:`Filter expression for greater than or equal comparison`}),description:(0,i.msg)(`greater than or equal`,{desc:`Filter expression for greater than or equal comparison`}),tiny:`>=`,type:[`numeric`,`datetime`],subtype:[`ip_address`]},{id:`? between ?`,key:`? between ?`,expression:`? between ?`,name:(0,i.msg)(`is between`,{desc:`Filter expression for between comparison`}),description:(0,i.msg)(`is between`,{desc:`Filter expression for between comparison`}),tiny:(0,i.msg)(`between`,{desc:`Short form of between comparison in filter expression`}),type:[],subtype:[`ip_address`]},{id:`last_now`,key:`last_now`,expression:`last_now`,name:(0,i.msg)(`last (x) periods`,{desc:`Filter expression for last (x) periods`}),description:(0,i.msg)(`last (x) periods`,{desc:`Filter expression for last (x) periods`}),tiny:(0,i.msg)(`last`,{desc:`Short form of last (x) periods in filter expression`}),type:[`datetime`]},{id:`last_available`,key:`last_available`,expression:`last_available`,name:(0,i.msg)(`last (x) available periods`,{desc:`Filter expression for last (x) available periods`}),description:(0,i.msg)(`last (x) available periods`,{desc:`Filter expression for last (x) available periods`}),tiny:(0,i.msg)(`last available`,{desc:`Short form of last (x) available periods in filter expression`}),type:[`datetime`]},{id:`last_completed`,key:`last_completed`,expression:`last_completed`,name:(0,i.msg)(`last completed period`,{desc:`Filter expression for last completed period`}),description:(0,i.msg)(`last completed (period)`,{desc:`Filter expression for last completed period`}),tiny:(0,i.msg)(`last completed`,{desc:`Short form of last completed period in filter expression`}),type:[`datetime`]},{id:`next_now`,key:`next_now`,expression:`next_now`,name:(0,i.msg)(`next (x) periods`,{desc:`Filter expression for next (x) periods`}),description:(0,i.msg)(`next (x) periods`,{desc:`Filter expression for next (x) periods`}),tiny:(0,i.msg)(`next`,{desc:`Short form of next (x) periods in filter expression`}),type:[`datetime`]},{id:`more_than_ago`,key:`more_than_ago`,expression:`more_than_ago`,name:(0,i.msg)(`more than (x) periods ago`,{desc:`Filter expression for more than (x) periods ago`}),description:(0,i.msg)(`more than (x) periods ago`,{desc:`Filter expression for more than (x) periods ago`}),tiny:(0,i.msg)(`more than ago`,{desc:`Short form of more than (x) periods ago in filter expression`}),type:[`datetime`]},{id:`or_more_ago`,key:`or_more_ago`,expression:`or_more_ago`,name:(0,i.msg)(`(x) periods or more ago`,{desc:`Filter expression for (x) periods or more ago`}),description:(0,i.msg)(`(x) periods or more ago`,{desc:`Filter expression for (x) periods or more ago`}),tiny:(0,i.msg)(`or more ago`,{desc:`Short form of (x) periods or more ago in filter expression`}),type:[`datetime`]},{id:`next_full`,key:`next_full`,expression:`next_full`,name:(0,i.msg)(`next full (period)`,{desc:`Filter expression for next full period`}),description:(0,i.msg)(`next full (period)`,{desc:`Filter expression for next full period`}),tiny:(0,i.msg)(`next full`,{desc:`Short form of next full period in filter expression`}),type:[`datetime`]},{id:`WTD`,key:`to_date`,expression:`to_date`,unit:4,name:(0,i.msg)(`week to date`,{desc:`Filter expression for week to date`}),description:(0,i.msg)(`week to date`,{desc:`Filter expression for week to date`}),tiny:(0,i.msg)(`WTD`,{desc:`Short form of week to date in filter expression`}),type:[`datetime`]},{id:`MTD`,key:`to_date`,expression:`to_date`,unit:3,name:(0,i.msg)(`month to date`,{desc:`Filter expression for month to date`}),description:(0,i.msg)(`month to date`,{desc:`Filter expression for month to date`}),tiny:(0,i.msg)(`MTD`,{desc:`Short form of month to date in filter expression`}),type:[`datetime`]},{id:`QTD`,key:`to_date`,expression:`to_date`,unit:2,name:(0,i.msg)(`quarter to date`,{desc:`Filter expression for quarter to date`}),description:(0,i.msg)(`quarter to date`,{desc:`Filter expression for quarter to date`}),tiny:(0,i.msg)(`QTD`,{desc:`Short form of quarter to date in filter expression`}),type:[`datetime`]},{id:`YTD`,key:`to_date`,expression:`to_date`,unit:1,name:(0,i.msg)(`year to date`,{desc:`Filter expression for year to date`}),description:(0,i.msg)(`year to date`,{desc:`Filter expression for year to date`}),tiny:(0,i.msg)(`YTD`,{desc:`Short form of year to date in filter expression`}),type:[`datetime`]},{id:`? is null`,key:`? is null`,expression:`? is null`,name:(0,i.msg)(`is missing`,{desc:`Filter expression for is missing`}),description:(0,i.msg)(`is missing`,{desc:`Filter expression for is missing`}),tiny:(0,i.msg)(`missing`,{desc:`Short form of is missing in filter expression`}),type:[`numeric`,`datetime`,`hierarchy`,`spatial`],subtype:[`ip_address`]},{id:`? is not null`,key:`? is not null`,expression:`? is not null`,name:(0,i.msg)(`is not missing`,{desc:`Filter expression for is not missing`}),description:(0,i.msg)(`is not missing`,{desc:`Filter expression for is not missing`}),tiny:(0,i.msg)(`not missing`,{desc:`Short form of is not missing in filter expression`}),type:[`numeric`,`datetime`,`hierarchy`,`spatial`],subtype:[`ip_address`]}],s=(e,t,n)=>{let r=new Set([`? in ?`,`? not in ?`]);return!e&&!t?o():o().filter(i=>(e&&i.type.includes(e)||t&&i.subtype?.includes(t))&&!(n&&r.has(i.key)))},c=`:host{font-family:var(--luzmo-font-family)}luzmo-select{width:100%}:host{--var:blue}`,l=class extends t.t((0,a.SizedMixin)(a.LuzmoElement,{validSizes:Object.values(a.ElementSizes)})){constructor(...e){super(...e),this.hasLabel=!1,this.allowEmpty=!1,this.placeholder=``,this.disabled=!1,this.readonly=!1,this.quiet=!1,this.invalid=!1,this.isFormula=!1,this._expressionConfigurations=o()}static get styles(){return[(0,n.unsafeCSS)(c)]}_sendChangeEvent(){if(this.disabled||this.readonly)return;let e={expression:this.filter?.expression};this.filter?.parameters?.[1]?.unit&&(e.unit=this.filter?.parameters?.[1]?.unit),this.dispatchEvent(new CustomEvent(`luzmo-expression-selected`,{bubbles:!0,composed:!0,cancelable:!0,detail:e}))}setExpression(e){this._richExpression=e?.detail?.value?.[0];let t=this._expressionConfigurations.find(e=>e.id===this._richExpression),n=structuredClone(this.filter);n.expression=t?.expression,t?.unit&&(this._unit=t.unit,n?.parameters[0]&&(n.parameters[1]={unit:this._unit})),this.filter=n,this._sendChangeEvent()}willUpdate(e){super.willUpdate(e);let t=e.has(`filter`),n=e.has(`type`),r=e.has(`subtype`),i=e.has(`isFormula`),a=s(this.type,this.subtype,this.isFormula),o=[`YTD`,`QTD`,`MTD`,`WTD`];if(this.filter?.expression===`to_date`){let e=this.filter?.parameters[1]?.unit??1;this._unit=e,this._richExpression=o[e-1]??`YTD`}else this._richExpression=this.filter?.expression;(n||r||i||t)&&this.filter&&!this.disabled&&!this.readonly&&!a?.find(e=>e.expression===this.filter?.expression)?(this.invalid=!0,console.warn(`Warning: ${this.filter?.expression} is not valid given the type: ${this.type} and subtype: ${this.subtype}`)):this.invalid=!1,!this.filter?.expression&&!this.allowEmpty&&(this._richExpression=a?.[0]?.id,this.filter={...this.filter,expression:this._richExpression},this._sendChangeEvent())}render(){let e=s(this.type,this.subtype,this.isFormula)?.map(e=>({value:e.id,label:e.description,shortLabel:e.tiny})),t=this.disabled||!this.filter?.expression&&!this.allowEmpty,r=n.html`<luzmo-field-label
+      for="expression"
+      size=${this.size}
+      >${this.label??(0,i.msg)(`Select an expression`,{desc:`Label for expression picker`})}</luzmo-field-label
+    >`,a=this.hasLabel?this.placeholder??(0,i.msg)(`Select...`):this.placeholder||this.label||(0,i.msg)(`Filter expression`,{desc:`Accessible label for expression picker`});return n.html`${this.hasLabel?r:``}
+      <luzmo-select
+        label=${a}
+        id="expression"
+        size=${this.size}
+        variant="highlight"
+        .quiet=${this.quiet}
+        selects="single"
+        .language=${this.language}
+        ?disabled=${t}
+        .readonly=${this.readonly}
+        ?invalid=${this.invalid}
+        .options=${e}
+        .value=${[this._richExpression]}
+        @change=${this.setExpression}
+      >
+      </luzmo-select>`}};e.t([(0,r.property)({type:String,reflect:!0})],l.prototype,`filter`,void 0),e.t([(0,r.property)({type:Boolean,attribute:`has-label`,reflect:!0})],l.prototype,`hasLabel`,void 0),e.t([(0,r.property)({type:String,reflect:!0})],l.prototype,`label`,void 0),e.t([(0,r.property)({type:Boolean,attribute:`allow-empty`,reflect:!0})],l.prototype,`allowEmpty`,void 0),e.t([(0,r.property)({type:String,attribute:`placeholder`,reflect:!0})],l.prototype,`placeholder`,void 0),e.t([(0,r.property)({type:Boolean,attribute:`disabled`,reflect:!0})],l.prototype,`disabled`,void 0),e.t([(0,r.property)({type:Boolean,reflect:!0})],l.prototype,`readonly`,void 0),e.t([(0,r.property)({type:Boolean,reflect:!0})],l.prototype,`quiet`,void 0),e.t([(0,r.property)({type:String,attribute:`type`,reflect:!0})],l.prototype,`type`,void 0),e.t([(0,r.property)({type:String,attribute:`subtype`,reflect:!0})],l.prototype,`subtype`,void 0),e.t([(0,r.property)({type:Boolean,attribute:`invalid`,reflect:!0})],l.prototype,`invalid`,void 0),e.t([(0,r.property)({type:Boolean,attribute:`is-formula`,reflect:!0})],l.prototype,`isFormula`,void 0),e.t([(0,r.state)()],l.prototype,`_richExpression`,void 0),e.t([(0,r.state)()],l.prototype,`_unit`,void 0),l=e.t([(0,i.localized)()],l),customElements.get(`luzmo-filter-expression-picker`)||customElements.define(`luzmo-filter-expression-picker`,l),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return l}});

package/components/filter-item/filter-item.d.ts

@@ -0,0 +1,142 @@
+import { CSSResultArray, PropertyValues, TemplateResult } from 'lit';
+import '@luzmo/lucero/badge';
+import '@luzmo/lucero/icon';
+import '@luzmo/lucero/progress-circle';
+import '@luzmo/lucero/tooltip';
+import { LuzmoElement } from '@luzmo/lucero/utils';
+import { type FilterTextContext } from '../../utils/filters/filter-text';
+import type { FilterColumnDisplay, FilterItemDisplay } from './../../utils/filters/presentation';
+import './../data-fields-select';
+import './../filter-expression-picker';
+import './../filter-value-picker';
+import type { FilterParameter } from './../filters/types';
+declare const LuzmoFilterItem_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement & {
+    new (...args: any[]): import("@luzmo/lucero").SizedElementInterface;
+    prototype: import("@luzmo/lucero").SizedElementInterface;
+};
+/**
+ * @customElement luzmo-filter-item
+ * @attr column-display - Visual treatment of the column or formula reference in text display.
+ * @fires {CustomEvent} luzmo-filter-changed - Fired when any part of the filter changes; `detail.filter` holds the updated filter.
+ * @csspart filter-item-text - The read-only filter sentence rendered by `display="text"`.
+ * @csspart filter-item-text-field - A column or formula reference in the read-only sentence.
+ * @cssprop --luzmo-filter-item-column-badge-color - Border for outline badges, tint for subtle badges, and background for filled badges.
+ * @cssprop --luzmo-filter-item-column-badge-font-color - Label and icon color for column badges.
+ * @cssprop --luzmo-filter-item-text-font-size - Font size of the text display. Defaults follow `size` (`--luzmo-font-size-s` through `--luzmo-font-size-xl`).
+ * @cssprop --luzmo-filter-item-text-expression-color - Color of the expression in a text display. Defaults to the sentence color.
+ * @cssprop --luzmo-filter-item-text-expression-font-weight - Weight of the expression in a text display. Defaults to normal.
+ * @cssprop --luzmo-filter-item-text-icon-gap - Space between a field icon and its name in a text display. Defaults to `--luzmo-spacing-1`, and `--luzmo-spacing-2` at `l` and `xl`.
+ * @cssprop --luzmo-filter-item-gap - Gap between the field, expression and value controls of a filter row.
+ * @cssprop --luzmo-filter-item-field-width - Width of the data field column. Defaults to its content width.
+ * @cssprop --luzmo-filter-item-expression-width - Width of the expression column. Defaults to its content width.
+ * @cssprop --luzmo-filter-item-value-width - Width of the value and parameter button cell. Defaults to its content width.
+ * @cssprop --luzmo-filter-item-value-grow - Whether the value cell absorbs remaining row width. Set to `1` to grow; defaults to `0`.
+ * @cssprop --luzmo-filter-item-field-min-width - Smallest width the data field select may shrink to in a narrow filter row.
+ * @cssprop --luzmo-filter-item-value-min-width - Smallest width of the value and parameter button cell in a narrow filter row.
+ */
+export declare class LuzmoFilterItem extends LuzmoFilterItem_base {
+    static get styles(): CSSResultArray;
+    /**
+     * The API URL of the databroker
+     * @default https://api.luzmo.com
+     * @description The URL of the databroker API
+     */
+    apiUrl?: string;
+    /**
+     * The auth key of the databroker
+     */
+    authKey?: string;
+    /**
+     * The auth token of the databroker
+     */
+    authToken?: string;
+    /**
+     * The cache time of the databroker
+     * @default 30000
+     * @description The time to cache the data in milliseconds
+     */
+    cacheTime?: number;
+    /**
+     * The language of the content
+     */
+    contentLanguage: string;
+    /**
+     * The time zone to use for the date picker
+     */
+    timeZone?: string;
+    /**
+     * The dataset ids to fetch columns & formulas
+     */
+    datasetIds?: string[];
+    /**
+     * The filter to display
+     */
+    filter: any;
+    /** Presentation of the filter item: editable controls or a read-only sentence. */
+    display: FilterItemDisplay;
+    /** Presentation of column and formula references in text display. */
+    columnDisplay: FilterColumnDisplay;
+    /** Removes rich-editor control chrome while keeping the controls editable. */
+    quiet: boolean;
+    /** Prevents changes while preserving the selected display and visual treatment. */
+    readonly: boolean;
+    /** Disables every rich-editor control and applies its disabled treatment. */
+    disabled: boolean;
+    /** @internal Shared context supplied by `luzmo-filters` to avoid duplicate metadata and hierarchy requests. */
+    textContext?: FilterTextContext;
+    /**
+     * Whether parameter-backed filter values can be created and selected.
+     */
+    allowParameters: boolean;
+    /**
+     * Consumer-owned parameter definitions available for selection.
+     */
+    parameters: FilterParameter[];
+    private _type?;
+    private _subType?;
+    private _isFormula?;
+    private _error?;
+    private _loading;
+    private _datasetsDataFields;
+    private _hierarchyLabels;
+    private _hierarchyLabelsLoading;
+    private _hierarchyRequest;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Clears the type, subtype, and formula state
+     */
+    private _clearTypeState;
+    /**
+     * Fetches hierarchy values from the databroker
+     */
+    private _fetchDatasetDataFields;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    private _loadHierarchyLabelsForText;
+    private _sendChangeEvent;
+    private setFilterDataField;
+    private setFilterExpression;
+    private setFilterValue;
+    private handleFilterParameterSelected;
+    private handleFilterParameterRemoved;
+    /**
+     * Check if the column/formula in the filter cannot be referenced
+     * (because datasetIds is empty or the column doesn't exist in loaded datasets)
+     */
+    private _cannotReferenceColumn;
+    protected renderDataFieldPicker(): TemplateResult<1>;
+    protected renderExpressionPicker(): TemplateResult<1>;
+    protected renderValuePicker(): TemplateResult<1>;
+    protected renderParameterPicker(): TemplateResult | null;
+    private _filterTextContext;
+    /** Column badges sit one step below the component size. Badge sizes start at xs and end at xl. */
+    private get _columnBadgeSize();
+    private _textFieldIcon;
+    private _renderTextField;
+    private _renderTextValue;
+    private _renderTextDisplay;
+    protected render(): TemplateResult;
+}
+export {};

package/components/filter-item/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("../filter-item-C_h4rbuL.cjs");Object.defineProperty(exports,"LuzmoFilterItem",{enumerable:!0,get:function(){return e.t}});

package/components/filter-item/index.d.ts

@@ -0,0 +1,8 @@
+import { LuzmoFilterItem } from './filter-item';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-filter-item': LuzmoFilterItem;
+    }
+}
+export { LuzmoFilterItem } from './filter-item';
+export type { FilterColumnDisplay, FilterItemDisplay } from '../../utils/filters/presentation';