@luzmo/analytics-components-kit 1.0.1-alpha.15 → 1.0.1-alpha.150

package/components/data-field-panel-CKc74BFY.js

@@ -0,0 +1,377 @@
+/*! * 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 { i as LuzmoElement, n as SizedMixin } from "./base-rg2x95aL.js";
+import { t as __decorate } from "./decorate-Da6S_xrw.js";
+import { t as LocalizedMixin } from "./localized-mixin-rjHF23Hg.js";
+import { t as localize } from "./localize-Dlt3EN5i.js";
+import { t as dataBroker } from "./data-broker-cLR-t5LM.js";
+import { t as loadDataFieldsForDatasets } from "./load-data-fields-for-datasets-CW4n0Pvf.js";
+import { html, nothing, unsafeCSS } from "lit";
+import { property, state } from "lit/decorators.js";
+import { localized, msg } from "@lit/localize";
+import { repeat } from "lit/directives/repeat.js";
+import { Task, TaskStatus } from "@lit/task";
+import "@luzmo/lucero/progress-circle";
+import "@luzmo/lucero/search";
+import "@luzmo/lucero/select";
+var data_field_panel_module_default = ":host{--data-field-panel-items-gap:var(--luzmo-spacing-2);--data-field-panel-search-edge-to-visual:var(--luzmo-spacing-5);--data-field-panel-search-text-to-icon:calc(var(--luzmo-spacing-4) + var(--luzmo-spacing-1));--data-field-panel-search-quiet-block-size:calc(var(--luzmo-component-height) + var(--luzmo-spacing-3));--data-field-panel-dataset-picker-margin-bottom:var(--luzmo-spacing-3)}:host([size=s]){--data-field-panel-items-gap:var(--luzmo-spacing-1);--data-field-panel-search-edge-to-visual:var(--luzmo-spacing-4);--data-field-panel-search-text-to-icon:calc(var(--luzmo-spacing-3) + var(--luzmo-spacing-1));--data-field-panel-search-quiet-block-size:calc(var(--luzmo-component-height-s) + var(--luzmo-spacing-3));--data-field-panel-dataset-picker-margin-bottom:var(--luzmo-spacing-2)}:host([size=l]){--data-field-panel-items-gap:var(--luzmo-spacing-2);--data-field-panel-search-text-to-icon:calc(var(--luzmo-spacing-5) + var(--luzmo-spacing-1));--data-field-panel-search-quiet-block-size:calc(var(--luzmo-component-height-l) + var(--luzmo-spacing-3));--data-field-panel-dataset-picker-margin-bottom:var(--luzmo-spacing-3)}:host([size=xl]){--data-field-panel-items-gap:var(--luzmo-spacing-3);--data-field-panel-search-text-to-icon:calc(var(--luzmo-spacing-5) + var(--luzmo-spacing-2));--data-field-panel-search-quiet-block-size:calc(var(--luzmo-component-height-xl) + var(--luzmo-spacing-3));--data-field-panel-dataset-picker-margin-bottom:var(--luzmo-spacing-4)}:host([dataset-picker][search-quiet]):has(.search-container){--data-field-panel-dataset-picker-margin-bottom:0}:host{box-sizing:border-box;height:100%;font-family:var(--luzmo-font-family,sans-serif);color:var(--luzmo-font-color,inherit);flex-direction:column;display:flex}.container{flex-direction:column;height:100%;display:flex}.dataset-picker{border-bottom-style:solid;border-bottom-width:var(--data-field-panel-dataset-picker-divider-height,1px);border-bottom-color:var(--luzmo-data-field-panel-dataset-picker-divider-color,var(--data-field-panel-dataset-picker-divider-color,var(--luzmo-border-color)));flex-shrink:0;margin-block-end:var(--luzmo-data-field-panel-dataset-picker-margin-block-end,var(--data-field-panel-dataset-picker-margin-bottom));padding-block-end:var(--luzmo-data-field-panel-dataset-picker-padding-block-end,var(--luzmo-spacing-3))}.dataset-picker luzmo-select{width:100%}.search-container{width:100%;flex-shrink:0;margin-block-end:var(--luzmo-data-field-panel-search-margin-block-end,var(--luzmo-spacing-3,.75rem))}.search-container luzmo-search{--luzmo-search-edge-to-visual:var(--luzmo-data-field-panel-search-edge-to-visual,var(--data-field-panel-search-edge-to-visual));--luzmo-search-text-to-icon:var(--luzmo-data-field-panel-search-text-to-icon,var(--data-field-panel-search-text-to-icon));width:100%}.data-fields-list{gap:var(--luzmo-data-field-panel-data-fields-gap,var(--data-field-panel-items-gap));flex-direction:column;flex:1;min-height:0;display:flex;overflow:hidden auto}.data-fields-list::-webkit-scrollbar{width:var(--luzmo-data-field-panel-scrollbar-width,var(--luzmo-scrollbar-size))}.data-fields-list::-webkit-scrollbar-track{background:var(--luzmo-data-field-panel-scrollbar-track-background,var(--luzmo-scrollbar-track-background));border-radius:var(--luzmo-scrollbar-track-border-radius)}.data-fields-list::-webkit-scrollbar-thumb{background:var(--luzmo-data-field-panel-scrollbar-thumb-background,var(--luzmo-scrollbar-thumb-background));border-radius:var(--luzmo-scrollbar-thumb-border-radius)}.data-fields-list::-webkit-scrollbar-thumb:hover{background:var(--luzmo-data-field-panel-scrollbar-thumb-hover-background),var(--luzmo-scrollbar-thumb-hover-background)}.data-fields-list{scrollbar-width:var(--luzmo-scrollbar-width);scrollbar-color:var(--luzmo-data-field-panel-scrollbar-thumb-background,var(--luzmo-scrollbar-thumb-background))var(--luzmo-data-field-panel-scrollbar-track-background,var(--luzmo-scrollbar-track-background))}.empty-state{color:var(--luzmo-font-color-tertiary,#999);font-size:var(--luzmo-font-size);text-align:center;padding:var(--luzmo-spacing-4);flex:1;justify-content:center;align-items:center;display:flex}.pending-state{padding:var(--luzmo-spacing-4);flex:1;justify-content:center;align-items:center;display:flex}:host([search-quiet]){--luzmo-search-block-size:var(--luzmo-data-field-panel-search-quiet-block-size,var(--data-field-panel-search-quiet-block-size))}:host([dataset-picker][search-quiet]):has(.search-container){--data-field-panel-dataset-picker-divider-color:transparent;--data-field-panel-dataset-picker-divider-height:1px}", DATASETS_PAGE_SIZE = 50, LuzmoDataFieldPanel = class extends LocalizedMixin(SizedMixin(LuzmoElement, {
+	validSizes: [
+		"s",
+		"m",
+		"l",
+		"xl"
+	],
+	noDefaultSize: !0
+})) {
+	constructor(...e) {
+		super(...e), this._handleDataFieldDropped = (e) => {
+			e.target !== this && (e.stopPropagation(), this.dispatchEvent(new CustomEvent("luzmo-data-field-dropped", {
+				bubbles: !0,
+				composed: !0,
+				detail: e.detail
+			})));
+		}, this._handleDataFieldDragStarted = (e) => {
+			e.target !== this && (e.stopPropagation(), this.dispatchEvent(new CustomEvent("luzmo-data-field-drag-started", {
+				bubbles: !0,
+				composed: !0,
+				detail: e.detail
+			})));
+		}, this.datasetIds = [], this.datasetsDataFields = [], this.datasetPicker = !1, this.disabled = !1, this.pending = !1, this.dataFieldVariant = "highlight", this.searchQuiet = !1, this.hideTypeIcon = !1, this.hideSublevels = !1, this.apiUrl = "https://api.luzmo.com", this.search = "auto", this.searchThreshold = 20, this._searchQuery = "", this._failedDatasetIds = /* @__PURE__ */ new Set(), this._loadDataFieldsTask = new Task(this, {
+			args: () => [
+				this._currentDatasetId,
+				this.apiUrl,
+				this.authKey,
+				this.authToken,
+				this.datasetsDataFields.length
+			],
+			task: async ([e, u, d, f, p]) => {
+				if (p > 0 || !e || this._failedDatasetIds.has(e)) return null;
+				let m = await loadDataFieldsForDatasets([e], { dataBrokerConfig: {
+					apiUrl: u,
+					authKey: d,
+					authToken: f
+				} });
+				return m.length === 0 ? (this._failedDatasetIds.add(e), null) : m[0];
+			}
+		}), this._datasetListItems = [], this._datasetListRetrieving = !1, this._datasetListPending = !1, this._datasetNamesFetchAttempted = !1, this._hasMoreDatasets = !0;
+	}
+	static {
+		this.styles = unsafeCSS(data_field_panel_module_default);
+	}
+	connectedCallback() {
+		super.connectedCallback(), this.addEventListener("luzmo-data-field-dropped", this._handleDataFieldDropped), this.addEventListener("luzmo-data-field-drag-started", this._handleDataFieldDragStarted);
+	}
+	disconnectedCallback() {
+		super.disconnectedCallback(), this.removeEventListener("luzmo-data-field-dropped", this._handleDataFieldDropped), this.removeEventListener("luzmo-data-field-drag-started", this._handleDataFieldDragStarted);
+	}
+	get _isDataFieldsPending() {
+		return this.pending || this._loadDataFieldsTask.status === TaskStatus.PENDING;
+	}
+	get _error() {
+		if (this._loadDataFieldsTask.status === TaskStatus.ERROR) {
+			let e = this._loadDataFieldsTask.error, u = e instanceof Error ? e.message : "Unknown error";
+			return `${msg("Could not retrieve data")}: ${u}`;
+		}
+	}
+	get _availableDatasets() {
+		return this.datasetsDataFields.length > 0 ? this.datasetsDataFields : this.datasetIds.length > 0 ? this.datasetIds.map((e) => {
+			let u = this._datasetListItems.find((u) => u.id === e);
+			return u ? {
+				id: u.id,
+				name: u.name,
+				description: u.description,
+				dataFields: []
+			} : {
+				id: e,
+				name: { en: e },
+				dataFields: []
+			};
+		}) : this._datasetListItems.length > 0 ? this._datasetListItems.map((e) => ({
+			id: e.id,
+			name: e.name,
+			description: e.description,
+			dataFields: []
+		})) : [];
+	}
+	get _selectedDataset() {
+		return this._availableDatasets.find((e) => e.id === this._currentDatasetId);
+	}
+	get _dataFields() {
+		let e = this._loadDataFieldsTask.value;
+		if (e && e.dataFields?.length > 0) return e.dataFields;
+		let u = this._selectedDataset;
+		if (!u) return [];
+		if ("dataFields" in u && Array.isArray(u.dataFields) && u.dataFields.length > 0) return u.dataFields;
+		let d = [];
+		if ("columns" in u && Array.isArray(u.columns)) for (let e of u.columns) d.push({
+			...e,
+			datasetId: u.id
+		});
+		if ("formulas" in u && Array.isArray(u.formulas)) for (let e of u.formulas) d.push({
+			...e,
+			datasetId: u.id
+		});
+		return d;
+	}
+	get _shouldFetchDatasetList() {
+		return this.datasetPicker && this.datasetsDataFields.length === 0;
+	}
+	get _showSearch() {
+		return this.search === "off" ? !1 : this.search === "on" ? !0 : this._dataFields.length > this.searchThreshold;
+	}
+	get _filteredDataFields() {
+		let e = this._dataFields;
+		if (!this._searchQuery.trim()) return e;
+		let u = this._searchQuery.toLowerCase().trim();
+		return e.filter((e) => (localize(e.name, this.language) || "").toLowerCase().includes(u));
+	}
+	willUpdate(e) {
+		super.willUpdate(e);
+		let u = e.has("selectedDatasetId"), d = e.has("datasetsDataFields"), f = e.has("datasetIds"), p = e.has("datasetPicker"), h = e.has("authKey"), g = e.has("authToken"), _ = e.has("apiUrl");
+		(f || h || g || _) && (this._datasetListItems = [], this._hasMoreDatasets = !0, this._failedDatasetIds.clear(), this._datasetNamesFetchAttempted = !1, dataBroker.configure({
+			apiUrl: this.apiUrl,
+			authKey: this.authKey ?? "",
+			authToken: this.authToken ?? ""
+		})), d && this.datasetsDataFields.length > 0 && (this._datasetListItems = [], this._hasMoreDatasets = !0, this._failedDatasetIds.clear()), (u || d || f) && this._updateCurrentDatasetId(), (f || h || g || _ || p) && this.datasetIds.length > 0 && this.datasetPicker && this.datasetsDataFields.length === 0 && this._datasetListItems.length === 0 && this._fetchDatasetNamesForPicker();
+	}
+	async _fetchDatasetNamesForPicker() {
+		if (this.datasetIds.length !== 0) {
+			this._datasetListPending = !0;
+			try {
+				this._datasetListItems = await dataBroker.fetchDatasetNames(this.datasetIds);
+			} catch (e) {
+				console.warn("Failed to fetch dataset names:", e);
+			} finally {
+				this._datasetListPending = !1, this._datasetNamesFetchAttempted = !0;
+			}
+		}
+	}
+	async _loadMoreDatasets(e) {
+		if (!(this._datasetListRetrieving || !this._hasMoreDatasets)) {
+			this._datasetListRetrieving = !0, e && (e.retrieving = !0);
+			try {
+				let e = this._datasetListItems.length, u = await dataBroker.fetchAllDatasets({
+					offset: e,
+					limit: DATASETS_PAGE_SIZE
+				});
+				this._datasetListItems = [...this._datasetListItems, ...u.data], this._hasMoreDatasets = e + DATASETS_PAGE_SIZE < (u.pagination?.total ?? 0), !this._currentDatasetId && this._datasetListItems.length > 0 && this._updateCurrentDatasetId();
+			} catch (e) {
+				console.warn("Failed to load dataset list:", e), this._hasMoreDatasets = !1;
+			} finally {
+				this._datasetListRetrieving = !1, e && (e.retrieving = !1);
+			}
+		}
+	}
+	_handlePickerScrolled(e) {
+		if (this.datasetIds.length > 0) return;
+		let u = e.target, { last: d } = e.detail;
+		d >= this._datasetListItems.length - 10 && this._hasMoreDatasets && this._loadMoreDatasets(u);
+	}
+	async _handlePickerOpened(e) {
+		let u = e.target;
+		if (this._datasetListItems.length === 0 && this._shouldFetchDatasetList && this.datasetIds.length === 0 && this._hasMoreDatasets) {
+			u.pending = !0;
+			try {
+				await this._loadMoreDatasets(u);
+			} finally {
+				u.pending = !1;
+			}
+		}
+	}
+	_updateCurrentDatasetId() {
+		let e = this._availableDatasets;
+		if (this.selectedDatasetId && e.some((e) => e.id === this.selectedDatasetId)) {
+			this._currentDatasetId = this.selectedDatasetId;
+			return;
+		}
+		if (this.selectedDatasetId && this.datasetIds.includes(this.selectedDatasetId)) {
+			this._currentDatasetId = this.selectedDatasetId;
+			return;
+		}
+		this._currentDatasetId = e.length > 0 ? e[0].id : void 0;
+	}
+	_handleDatasetChange(e) {
+		let u = e.detail?.value?.[0];
+		u && u !== this._currentDatasetId && (this._currentDatasetId = u, this._searchQuery = "", this.dispatchEvent(new CustomEvent("luzmo-dataset-changed", {
+			bubbles: !0,
+			composed: !0,
+			detail: { datasetId: u }
+		})));
+	}
+	_getDataFieldKey(e) {
+		return "columnId" in e && e.columnId ? `col-${e.columnId}` : "formulaId" in e && e.formulaId ? `formula-${e.formulaId}` : "formula" in e && e.formula ? `adhoc-${e.formula}` : `field-${e.datasetId}-${Math.random().toString(36).slice(2, 11)}`;
+	}
+	_handleSearchInput(e) {
+		this._searchQuery = e.target.value;
+	}
+	_renderDatasetPicker() {
+		if (!this.datasetPicker) return nothing;
+		let e = this._availableDatasets, u = e.length > 1, d = this.datasetIds.length > 0, f = this._shouldFetchDatasetList;
+		if (!u && !d && !f) return nothing;
+		let m = this._datasetListPending || this.datasetIds.length > 0 && this._datasetListItems.length === 0 && this.datasetsDataFields.length === 0 && !this._datasetNamesFetchAttempted, h = m ? [] : e.map((e) => ({
+			value: e.id,
+			label: localize(e.name, this.language) || e.id
+		})), v = m ? [] : this._currentDatasetId ? [this._currentDatasetId] : [], y = m ? msg("Loading datasets...") : this.datasetPickerPlaceholder ?? msg("Select dataset...");
+		return html`
+      <div class="dataset-picker" part="dataset-picker">
+        <luzmo-select
+          selects="single"
+          variant="highlight"
+          .size=${this.size}
+          .options=${h}
+          .value=${v}
+          .label=${y}
+          ?disabled=${this.disabled}
+          ?pending=${m}
+          @change=${this._handleDatasetChange}
+          @luzmo-opened=${this._handlePickerOpened}
+          @luzmo-scrolled=${this._handlePickerScrolled}
+        ></luzmo-select>
+      </div>
+    `;
+	}
+	_renderSearch() {
+		return !this._showSearch || this._isDataFieldsPending ? nothing : html`
+      <div class="search-container" part="search">
+        <luzmo-search
+          .size=${this.size}
+          .placeholder=${this.searchPlaceholder ?? msg("Search...")}
+          .value=${this._searchQuery}
+          ?disabled=${this.disabled}
+          ?quiet=${this.searchQuiet}
+          @input=${this._handleSearchInput}
+        ></luzmo-search>
+      </div>
+    `;
+	}
+	_renderPendingState() {
+		return html`
+      <div class="pending-state" part="pending-state">
+        <luzmo-progress-circle
+          indeterminate
+          .size=${this.size}
+        ></luzmo-progress-circle>
+      </div>
+    `;
+	}
+	_renderErrorState() {
+		return html`
+      <div class="empty-state" part="empty-state">
+        ${this._error}
+      </div>
+    `;
+	}
+	_renderDataFields() {
+		if (this._error) return this._renderErrorState();
+		if (this._dataFields.length === 0) return html`
+        <div class="empty-state" part="empty-state">
+          ${msg("No data available", { desc: "Empty state message shown when the selected dataset has no data fields (columns or formulas)" })}
+        </div>
+      `;
+		let e = this._filteredDataFields;
+		return e.length === 0 ? html`
+        <div class="empty-state" part="empty-state">
+          ${msg("No results found")}
+        </div>
+      ` : html`
+      <div class="data-fields-list" part="data-fields-list">
+        ${repeat(e, (e) => this._getDataFieldKey(e), (e) => html`
+            <luzmo-data-field
+              .data=${e}
+              .language=${this.language}
+              .size=${this.size}
+              .variant=${this.dataFieldVariant}
+              ?disabled=${this.disabled}
+              ?hide-type-icon=${this.hideTypeIcon}
+              ?hide-sublevels=${this.hideSublevels}
+            ></luzmo-data-field>
+          `)}
+      </div>
+    `;
+	}
+	render() {
+		return html`
+      <div class="container" part="container">
+        ${this._renderDatasetPicker()}
+        ${this._renderSearch()}
+        ${this._isDataFieldsPending ? this._renderPendingState() : this._renderDataFields()}
+      </div>
+    `;
+	}
+};
+__decorate([property({
+	type: Array,
+	attribute: "dataset-ids"
+})], LuzmoDataFieldPanel.prototype, "datasetIds", void 0), __decorate([property({
+	type: Array,
+	attribute: !1
+})], LuzmoDataFieldPanel.prototype, "datasetsDataFields", void 0), __decorate([property({
+	type: String,
+	attribute: "selected-dataset-id",
+	reflect: !0
+})], LuzmoDataFieldPanel.prototype, "selectedDatasetId", void 0), __decorate([property({
+	type: Boolean,
+	attribute: "dataset-picker",
+	reflect: !0
+})], LuzmoDataFieldPanel.prototype, "datasetPicker", void 0), __decorate([property({
+	type: Boolean,
+	reflect: !0
+})], LuzmoDataFieldPanel.prototype, "disabled", void 0), __decorate([property({
+	type: Boolean,
+	reflect: !0
+})], LuzmoDataFieldPanel.prototype, "pending", void 0), __decorate([property({
+	type: String,
+	attribute: "data-field-variant",
+	reflect: !0
+})], LuzmoDataFieldPanel.prototype, "dataFieldVariant", void 0), __decorate([property({
+	type: Boolean,
+	attribute: "search-quiet",
+	reflect: !0
+})], LuzmoDataFieldPanel.prototype, "searchQuiet", void 0), __decorate([property({
+	type: Boolean,
+	attribute: "hide-type-icon",
+	reflect: !0
+})], LuzmoDataFieldPanel.prototype, "hideTypeIcon", void 0), __decorate([property({
+	type: Boolean,
+	attribute: "hide-sublevels",
+	reflect: !0
+})], LuzmoDataFieldPanel.prototype, "hideSublevels", void 0), __decorate([property({
+	type: String,
+	attribute: "dataset-picker-placeholder"
+})], LuzmoDataFieldPanel.prototype, "datasetPickerPlaceholder", void 0), __decorate([property({
+	type: String,
+	attribute: "api-url"
+})], LuzmoDataFieldPanel.prototype, "apiUrl", void 0), __decorate([property({
+	type: String,
+	attribute: "auth-key"
+})], LuzmoDataFieldPanel.prototype, "authKey", void 0), __decorate([property({
+	type: String,
+	attribute: "auth-token"
+})], LuzmoDataFieldPanel.prototype, "authToken", void 0), __decorate([property({
+	type: String,
+	reflect: !0
+})], LuzmoDataFieldPanel.prototype, "search", void 0), __decorate([property({
+	type: String,
+	attribute: "search-placeholder"
+})], LuzmoDataFieldPanel.prototype, "searchPlaceholder", void 0), __decorate([property({
+	type: Number,
+	attribute: "search-threshold"
+})], LuzmoDataFieldPanel.prototype, "searchThreshold", void 0), __decorate([state()], LuzmoDataFieldPanel.prototype, "_currentDatasetId", void 0), __decorate([state()], LuzmoDataFieldPanel.prototype, "_searchQuery", void 0), __decorate([state()], LuzmoDataFieldPanel.prototype, "_datasetListItems", void 0), __decorate([state()], LuzmoDataFieldPanel.prototype, "_datasetListRetrieving", void 0), __decorate([state()], LuzmoDataFieldPanel.prototype, "_datasetListPending", void 0), LuzmoDataFieldPanel = __decorate([localized()], LuzmoDataFieldPanel), customElements.get("luzmo-data-field-panel") || customElements.define("luzmo-data-field-panel", LuzmoDataFieldPanel);
+export { LuzmoDataFieldPanel as t };

package/components/data-field-panel-VgFkJ0aL.cjs

@@ -0,0 +1,86 @@
+/*! * 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(`./chunk-350yNsax.cjs`),t=require(`./base-C_azywlB.cjs`),n=require(`./decorate-Dq4-zbi1.cjs`),r=require(`./localized-mixin-DD2Hm1jz.cjs`),i=require(`./localize-BBuZJf_h.cjs`),a=require(`./data-broker-BUIUM5hr.cjs`),o=require(`./load-data-fields-for-datasets-B6cGgPld.cjs`);let s=require(`lit`),c=require(`lit/decorators.js`),l=require(`@lit/localize`),u=require(`lit/directives/repeat.js`),d=require(`@lit/task`);require(`@luzmo/lucero/progress-circle`),require(`@luzmo/lucero/search`),require(`@luzmo/lucero/select`);var f=`:host{--data-field-panel-items-gap:var(--luzmo-spacing-2);--data-field-panel-search-edge-to-visual:var(--luzmo-spacing-5);--data-field-panel-search-text-to-icon:calc(var(--luzmo-spacing-4) + var(--luzmo-spacing-1));--data-field-panel-search-quiet-block-size:calc(var(--luzmo-component-height) + var(--luzmo-spacing-3));--data-field-panel-dataset-picker-margin-bottom:var(--luzmo-spacing-3)}:host([size=s]){--data-field-panel-items-gap:var(--luzmo-spacing-1);--data-field-panel-search-edge-to-visual:var(--luzmo-spacing-4);--data-field-panel-search-text-to-icon:calc(var(--luzmo-spacing-3) + var(--luzmo-spacing-1));--data-field-panel-search-quiet-block-size:calc(var(--luzmo-component-height-s) + var(--luzmo-spacing-3));--data-field-panel-dataset-picker-margin-bottom:var(--luzmo-spacing-2)}:host([size=l]){--data-field-panel-items-gap:var(--luzmo-spacing-2);--data-field-panel-search-text-to-icon:calc(var(--luzmo-spacing-5) + var(--luzmo-spacing-1));--data-field-panel-search-quiet-block-size:calc(var(--luzmo-component-height-l) + var(--luzmo-spacing-3));--data-field-panel-dataset-picker-margin-bottom:var(--luzmo-spacing-3)}:host([size=xl]){--data-field-panel-items-gap:var(--luzmo-spacing-3);--data-field-panel-search-text-to-icon:calc(var(--luzmo-spacing-5) + var(--luzmo-spacing-2));--data-field-panel-search-quiet-block-size:calc(var(--luzmo-component-height-xl) + var(--luzmo-spacing-3));--data-field-panel-dataset-picker-margin-bottom:var(--luzmo-spacing-4)}:host([dataset-picker][search-quiet]):has(.search-container){--data-field-panel-dataset-picker-margin-bottom:0}:host{box-sizing:border-box;height:100%;font-family:var(--luzmo-font-family,sans-serif);color:var(--luzmo-font-color,inherit);flex-direction:column;display:flex}.container{flex-direction:column;height:100%;display:flex}.dataset-picker{border-bottom-style:solid;border-bottom-width:var(--data-field-panel-dataset-picker-divider-height,1px);border-bottom-color:var(--luzmo-data-field-panel-dataset-picker-divider-color,var(--data-field-panel-dataset-picker-divider-color,var(--luzmo-border-color)));flex-shrink:0;margin-block-end:var(--luzmo-data-field-panel-dataset-picker-margin-block-end,var(--data-field-panel-dataset-picker-margin-bottom));padding-block-end:var(--luzmo-data-field-panel-dataset-picker-padding-block-end,var(--luzmo-spacing-3))}.dataset-picker luzmo-select{width:100%}.search-container{width:100%;flex-shrink:0;margin-block-end:var(--luzmo-data-field-panel-search-margin-block-end,var(--luzmo-spacing-3,.75rem))}.search-container luzmo-search{--luzmo-search-edge-to-visual:var(--luzmo-data-field-panel-search-edge-to-visual,var(--data-field-panel-search-edge-to-visual));--luzmo-search-text-to-icon:var(--luzmo-data-field-panel-search-text-to-icon,var(--data-field-panel-search-text-to-icon));width:100%}.data-fields-list{gap:var(--luzmo-data-field-panel-data-fields-gap,var(--data-field-panel-items-gap));flex-direction:column;flex:1;min-height:0;display:flex;overflow:hidden auto}.data-fields-list::-webkit-scrollbar{width:var(--luzmo-data-field-panel-scrollbar-width,var(--luzmo-scrollbar-size))}.data-fields-list::-webkit-scrollbar-track{background:var(--luzmo-data-field-panel-scrollbar-track-background,var(--luzmo-scrollbar-track-background));border-radius:var(--luzmo-scrollbar-track-border-radius)}.data-fields-list::-webkit-scrollbar-thumb{background:var(--luzmo-data-field-panel-scrollbar-thumb-background,var(--luzmo-scrollbar-thumb-background));border-radius:var(--luzmo-scrollbar-thumb-border-radius)}.data-fields-list::-webkit-scrollbar-thumb:hover{background:var(--luzmo-data-field-panel-scrollbar-thumb-hover-background),var(--luzmo-scrollbar-thumb-hover-background)}.data-fields-list{scrollbar-width:var(--luzmo-scrollbar-width);scrollbar-color:var(--luzmo-data-field-panel-scrollbar-thumb-background,var(--luzmo-scrollbar-thumb-background))var(--luzmo-data-field-panel-scrollbar-track-background,var(--luzmo-scrollbar-track-background))}.empty-state{color:var(--luzmo-font-color-tertiary,#999);font-size:var(--luzmo-font-size);text-align:center;padding:var(--luzmo-spacing-4);flex:1;justify-content:center;align-items:center;display:flex}.pending-state{padding:var(--luzmo-spacing-4);flex:1;justify-content:center;align-items:center;display:flex}:host([search-quiet]){--luzmo-search-block-size:var(--luzmo-data-field-panel-search-quiet-block-size,var(--data-field-panel-search-quiet-block-size))}:host([dataset-picker][search-quiet]):has(.search-container){--data-field-panel-dataset-picker-divider-color:transparent;--data-field-panel-dataset-picker-divider-height:1px}`,p=50,m=class extends r.t(t.n(t.i,{validSizes:[`s`,`m`,`l`,`xl`],noDefaultSize:!0})){constructor(...e){super(...e),this._handleDataFieldDropped=e=>{e.target!==this&&(e.stopPropagation(),this.dispatchEvent(new CustomEvent(`luzmo-data-field-dropped`,{bubbles:!0,composed:!0,detail:e.detail})))},this._handleDataFieldDragStarted=e=>{e.target!==this&&(e.stopPropagation(),this.dispatchEvent(new CustomEvent(`luzmo-data-field-drag-started`,{bubbles:!0,composed:!0,detail:e.detail})))},this.datasetIds=[],this.datasetsDataFields=[],this.datasetPicker=!1,this.disabled=!1,this.pending=!1,this.dataFieldVariant=`highlight`,this.searchQuiet=!1,this.hideTypeIcon=!1,this.hideSublevels=!1,this.apiUrl=`https://api.luzmo.com`,this.search=`auto`,this.searchThreshold=20,this._searchQuery=``,this._failedDatasetIds=new Set,this._loadDataFieldsTask=new d.Task(this,{args:()=>[this._currentDatasetId,this.apiUrl,this.authKey,this.authToken,this.datasetsDataFields.length],task:async([e,t,n,r,i])=>{if(i>0||!e||this._failedDatasetIds.has(e))return null;let a=await o.t([e],{dataBrokerConfig:{apiUrl:t,authKey:n,authToken:r}});return a.length===0?(this._failedDatasetIds.add(e),null):a[0]}}),this._datasetListItems=[],this._datasetListRetrieving=!1,this._datasetListPending=!1,this._datasetNamesFetchAttempted=!1,this._hasMoreDatasets=!0}static{this.styles=(0,s.unsafeCSS)(f)}connectedCallback(){super.connectedCallback(),this.addEventListener(`luzmo-data-field-dropped`,this._handleDataFieldDropped),this.addEventListener(`luzmo-data-field-drag-started`,this._handleDataFieldDragStarted)}disconnectedCallback(){super.disconnectedCallback(),this.removeEventListener(`luzmo-data-field-dropped`,this._handleDataFieldDropped),this.removeEventListener(`luzmo-data-field-drag-started`,this._handleDataFieldDragStarted)}get _isDataFieldsPending(){return this.pending||this._loadDataFieldsTask.status===d.TaskStatus.PENDING}get _error(){if(this._loadDataFieldsTask.status===d.TaskStatus.ERROR){let e=this._loadDataFieldsTask.error,t=e instanceof Error?e.message:`Unknown error`;return`${(0,l.msg)(`Could not retrieve data`)}: ${t}`}}get _availableDatasets(){return this.datasetsDataFields.length>0?this.datasetsDataFields:this.datasetIds.length>0?this.datasetIds.map(e=>{let t=this._datasetListItems.find(t=>t.id===e);return t?{id:t.id,name:t.name,description:t.description,dataFields:[]}:{id:e,name:{en:e},dataFields:[]}}):this._datasetListItems.length>0?this._datasetListItems.map(e=>({id:e.id,name:e.name,description:e.description,dataFields:[]})):[]}get _selectedDataset(){return this._availableDatasets.find(e=>e.id===this._currentDatasetId)}get _dataFields(){let e=this._loadDataFieldsTask.value;if(e&&e.dataFields?.length>0)return e.dataFields;let t=this._selectedDataset;if(!t)return[];if(`dataFields`in t&&Array.isArray(t.dataFields)&&t.dataFields.length>0)return t.dataFields;let n=[];if(`columns`in t&&Array.isArray(t.columns))for(let e of t.columns)n.push({...e,datasetId:t.id});if(`formulas`in t&&Array.isArray(t.formulas))for(let e of t.formulas)n.push({...e,datasetId:t.id});return n}get _shouldFetchDatasetList(){return this.datasetPicker&&this.datasetsDataFields.length===0}get _showSearch(){return this.search===`off`?!1:this.search===`on`?!0:this._dataFields.length>this.searchThreshold}get _filteredDataFields(){let e=this._dataFields;if(!this._searchQuery.trim())return e;let t=this._searchQuery.toLowerCase().trim();return e.filter(e=>(i.t(e.name,this.language)||``).toLowerCase().includes(t))}willUpdate(e){super.willUpdate(e);let t=e.has(`selectedDatasetId`),n=e.has(`datasetsDataFields`),r=e.has(`datasetIds`),i=e.has(`datasetPicker`),o=e.has(`authKey`),s=e.has(`authToken`),c=e.has(`apiUrl`);(r||o||s||c)&&(this._datasetListItems=[],this._hasMoreDatasets=!0,this._failedDatasetIds.clear(),this._datasetNamesFetchAttempted=!1,a.t.configure({apiUrl:this.apiUrl,authKey:this.authKey??``,authToken:this.authToken??``})),n&&this.datasetsDataFields.length>0&&(this._datasetListItems=[],this._hasMoreDatasets=!0,this._failedDatasetIds.clear()),(t||n||r)&&this._updateCurrentDatasetId(),(r||o||s||c||i)&&this.datasetIds.length>0&&this.datasetPicker&&this.datasetsDataFields.length===0&&this._datasetListItems.length===0&&this._fetchDatasetNamesForPicker()}async _fetchDatasetNamesForPicker(){if(this.datasetIds.length!==0){this._datasetListPending=!0;try{this._datasetListItems=await a.t.fetchDatasetNames(this.datasetIds)}catch(e){console.warn(`Failed to fetch dataset names:`,e)}finally{this._datasetListPending=!1,this._datasetNamesFetchAttempted=!0}}}async _loadMoreDatasets(e){if(!(this._datasetListRetrieving||!this._hasMoreDatasets)){this._datasetListRetrieving=!0,e&&(e.retrieving=!0);try{let e=this._datasetListItems.length,t=await a.t.fetchAllDatasets({offset:e,limit:p});this._datasetListItems=[...this._datasetListItems,...t.data],this._hasMoreDatasets=e+p<(t.pagination?.total??0),!this._currentDatasetId&&this._datasetListItems.length>0&&this._updateCurrentDatasetId()}catch(e){console.warn(`Failed to load dataset list:`,e),this._hasMoreDatasets=!1}finally{this._datasetListRetrieving=!1,e&&(e.retrieving=!1)}}}_handlePickerScrolled(e){if(this.datasetIds.length>0)return;let t=e.target,{last:n}=e.detail;n>=this._datasetListItems.length-10&&this._hasMoreDatasets&&this._loadMoreDatasets(t)}async _handlePickerOpened(e){let t=e.target;if(this._datasetListItems.length===0&&this._shouldFetchDatasetList&&this.datasetIds.length===0&&this._hasMoreDatasets){t.pending=!0;try{await this._loadMoreDatasets(t)}finally{t.pending=!1}}}_updateCurrentDatasetId(){let e=this._availableDatasets;if(this.selectedDatasetId&&e.some(e=>e.id===this.selectedDatasetId)){this._currentDatasetId=this.selectedDatasetId;return}if(this.selectedDatasetId&&this.datasetIds.includes(this.selectedDatasetId)){this._currentDatasetId=this.selectedDatasetId;return}this._currentDatasetId=e.length>0?e[0].id:void 0}_handleDatasetChange(e){let t=e.detail?.value?.[0];t&&t!==this._currentDatasetId&&(this._currentDatasetId=t,this._searchQuery=``,this.dispatchEvent(new CustomEvent(`luzmo-dataset-changed`,{bubbles:!0,composed:!0,detail:{datasetId:t}})))}_getDataFieldKey(e){return`columnId`in e&&e.columnId?`col-${e.columnId}`:`formulaId`in e&&e.formulaId?`formula-${e.formulaId}`:`formula`in e&&e.formula?`adhoc-${e.formula}`:`field-${e.datasetId}-${Math.random().toString(36).slice(2,11)}`}_handleSearchInput(e){this._searchQuery=e.target.value}_renderDatasetPicker(){if(!this.datasetPicker)return s.nothing;let e=this._availableDatasets,t=e.length>1,n=this.datasetIds.length>0,r=this._shouldFetchDatasetList;if(!t&&!n&&!r)return s.nothing;let a=this._datasetListPending||this.datasetIds.length>0&&this._datasetListItems.length===0&&this.datasetsDataFields.length===0&&!this._datasetNamesFetchAttempted,o=a?[]:e.map(e=>({value:e.id,label:i.t(e.name,this.language)||e.id})),c=a?[]:this._currentDatasetId?[this._currentDatasetId]:[],u=a?(0,l.msg)(`Loading datasets...`):this.datasetPickerPlaceholder??(0,l.msg)(`Select dataset...`);return s.html`
+      <div class="dataset-picker" part="dataset-picker">
+        <luzmo-select
+          selects="single"
+          variant="highlight"
+          .size=${this.size}
+          .options=${o}
+          .value=${c}
+          .label=${u}
+          ?disabled=${this.disabled}
+          ?pending=${a}
+          @change=${this._handleDatasetChange}
+          @luzmo-opened=${this._handlePickerOpened}
+          @luzmo-scrolled=${this._handlePickerScrolled}
+        ></luzmo-select>
+      </div>
+    `}_renderSearch(){return!this._showSearch||this._isDataFieldsPending?s.nothing:s.html`
+      <div class="search-container" part="search">
+        <luzmo-search
+          .size=${this.size}
+          .placeholder=${this.searchPlaceholder??(0,l.msg)(`Search...`)}
+          .value=${this._searchQuery}
+          ?disabled=${this.disabled}
+          ?quiet=${this.searchQuiet}
+          @input=${this._handleSearchInput}
+        ></luzmo-search>
+      </div>
+    `}_renderPendingState(){return s.html`
+      <div class="pending-state" part="pending-state">
+        <luzmo-progress-circle
+          indeterminate
+          .size=${this.size}
+        ></luzmo-progress-circle>
+      </div>
+    `}_renderErrorState(){return s.html`
+      <div class="empty-state" part="empty-state">
+        ${this._error}
+      </div>
+    `}_renderDataFields(){if(this._error)return this._renderErrorState();if(this._dataFields.length===0)return s.html`
+        <div class="empty-state" part="empty-state">
+          ${(0,l.msg)(`No data available`,{desc:`Empty state message shown when the selected dataset has no data fields (columns or formulas)`})}
+        </div>
+      `;let e=this._filteredDataFields;return e.length===0?s.html`
+        <div class="empty-state" part="empty-state">
+          ${(0,l.msg)(`No results found`)}
+        </div>
+      `:s.html`
+      <div class="data-fields-list" part="data-fields-list">
+        ${(0,u.repeat)(e,e=>this._getDataFieldKey(e),e=>s.html`
+            <luzmo-data-field
+              .data=${e}
+              .language=${this.language}
+              .size=${this.size}
+              .variant=${this.dataFieldVariant}
+              ?disabled=${this.disabled}
+              ?hide-type-icon=${this.hideTypeIcon}
+              ?hide-sublevels=${this.hideSublevels}
+            ></luzmo-data-field>
+          `)}
+      </div>
+    `}render(){return s.html`
+      <div class="container" part="container">
+        ${this._renderDatasetPicker()}
+        ${this._renderSearch()}
+        ${this._isDataFieldsPending?this._renderPendingState():this._renderDataFields()}
+      </div>
+    `}};n.t([(0,c.property)({type:Array,attribute:`dataset-ids`})],m.prototype,`datasetIds`,void 0),n.t([(0,c.property)({type:Array,attribute:!1})],m.prototype,`datasetsDataFields`,void 0),n.t([(0,c.property)({type:String,attribute:`selected-dataset-id`,reflect:!0})],m.prototype,`selectedDatasetId`,void 0),n.t([(0,c.property)({type:Boolean,attribute:`dataset-picker`,reflect:!0})],m.prototype,`datasetPicker`,void 0),n.t([(0,c.property)({type:Boolean,reflect:!0})],m.prototype,`disabled`,void 0),n.t([(0,c.property)({type:Boolean,reflect:!0})],m.prototype,`pending`,void 0),n.t([(0,c.property)({type:String,attribute:`data-field-variant`,reflect:!0})],m.prototype,`dataFieldVariant`,void 0),n.t([(0,c.property)({type:Boolean,attribute:`search-quiet`,reflect:!0})],m.prototype,`searchQuiet`,void 0),n.t([(0,c.property)({type:Boolean,attribute:`hide-type-icon`,reflect:!0})],m.prototype,`hideTypeIcon`,void 0),n.t([(0,c.property)({type:Boolean,attribute:`hide-sublevels`,reflect:!0})],m.prototype,`hideSublevels`,void 0),n.t([(0,c.property)({type:String,attribute:`dataset-picker-placeholder`})],m.prototype,`datasetPickerPlaceholder`,void 0),n.t([(0,c.property)({type:String,attribute:`api-url`})],m.prototype,`apiUrl`,void 0),n.t([(0,c.property)({type:String,attribute:`auth-key`})],m.prototype,`authKey`,void 0),n.t([(0,c.property)({type:String,attribute:`auth-token`})],m.prototype,`authToken`,void 0),n.t([(0,c.property)({type:String,reflect:!0})],m.prototype,`search`,void 0),n.t([(0,c.property)({type:String,attribute:`search-placeholder`})],m.prototype,`searchPlaceholder`,void 0),n.t([(0,c.property)({type:Number,attribute:`search-threshold`})],m.prototype,`searchThreshold`,void 0),n.t([(0,c.state)()],m.prototype,`_currentDatasetId`,void 0),n.t([(0,c.state)()],m.prototype,`_searchQuery`,void 0),n.t([(0,c.state)()],m.prototype,`_datasetListItems`,void 0),n.t([(0,c.state)()],m.prototype,`_datasetListRetrieving`,void 0),n.t([(0,c.state)()],m.prototype,`_datasetListPending`,void 0),m=n.t([(0,l.localized)()],m),customElements.get(`luzmo-data-field-panel`)||customElements.define(`luzmo-data-field-panel`,m),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return m}});

package/components/data-fields-select/data-fields-select.d.ts

@@ -0,0 +1,122 @@
+import '@luzmo/lucero/select';
+import { CSSResultArray, PropertyValues, TemplateResult } from 'lit';
+import type { AdHocFormulaInput } from '../../types/dataset-data-field.types';
+import type { Placement } from '@luzmo/lucero';
+import { LuzmoElement } from '@luzmo/lucero/utils';
+import type { DatasetFormulaMetadata, DatasetMetadata } from '@utils/data-broker';
+/** A formula entry is either a saved formula (with `id`) or an ad hoc formula (with `formula` expression). */
+type FormulaEntry = DatasetFormulaMetadata | AdHocFormulaInput;
+declare const LuzmoDataFieldsSelect_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement & {
+    new (...args: any[]): import("@luzmo/lucero").SizedElementInterface;
+    prototype: import("@luzmo/lucero").SizedElementInterface;
+};
+/**
+ * @name luzmo-data-fields-select
+ * @fires luzmo-data-fields-selected - Emitted when data fields are selected. Event detail contains `{ dataFields: DatasetDataField[] }`
+ */
+export declare class LuzmoDataFieldsSelect extends LuzmoDataFieldsSelect_base {
+    static get styles(): CSSResultArray;
+    /**
+     * The language to use for locale-aware formatting and labels
+     */
+    contentLanguage: string;
+    /**
+     * The accessible label for the select (used for aria-label)
+     */
+    label?: string;
+    /**
+     * Where to show icons
+     */
+    icons?: 'none' | 'menu-only' | 'all';
+    /**
+     * Allow no selection. If true, the picker will not show a value when no item is selected. Else if no value is provided it will pick the first item.
+     */
+    allowEmpty: boolean;
+    /**
+     * The placeholder text for the picker is no value selected. If allowEmpty is true, this will be used as the label.
+     */
+    placeholder?: string;
+    /**
+     * Whether the picker allows single or multiple selections.
+     * @default 'single'
+     */
+    selects: 'single' | 'multiple';
+    /**
+     * The IDs of the selected data fields. If not provided, the first item will be selected (when allowEmpty is false).
+     */
+    value: string[];
+    /**
+     * Whether the picker is in retrieving state (shows loading indicator)
+     */
+    retrieving: boolean;
+    /**
+     * Whether the picker is invalid - eg. the dataFieldId is not found in the datasetsDataFields or query failed to fetch data
+     */
+    invalid: boolean;
+    /**
+     * Whether the picker is clearable
+     */
+    clearable: boolean;
+    /**
+     * Whether the picker is in pending state
+     */
+    pending: boolean;
+    /**
+     * Whether the picker is disabled
+     */
+    disabled: boolean;
+    /**
+     * Whether to show a search field in the dropdown
+     */
+    search?: 'on' | 'off' | 'auto';
+    /**
+     * The placement of the dropdown menu
+     */
+    placement: Placement;
+    /**
+     * The datasets and their dataFields to display.
+     * The `formulas` array accepts both saved formulas (with `id`) and ad hoc formulas
+     * (with a `formula` expression string). Ad hoc formulas render inline with a formula icon.
+     */
+    datasetsDataFields: (Pick<DatasetMetadata, 'id' | 'name' | 'columns'> & {
+        formulas: FormulaEntry[];
+    })[];
+    private _dataFieldsSelected;
+    /** Type guard: returns true when the formula entry is an ad hoc formula (has `formula` expression). */
+    private _isAdHocFormula;
+    private _sendChangeEvent;
+    private _toDataFieldData;
+    private _toAdHocFormulaFieldData;
+    /**
+     * Searches the formulas array (which may contain both saved and ad hoc formulas) for a match.
+     */
+    private _findFormulaMatch;
+    /**
+     * Resolves a selected value (which may be a compound sublevel value) to a DatasetDataField.
+     * Returns the resolved field and whether a dataset match was found.
+     */
+    private _resolveDataFieldFromValue;
+    setDataField(event: CustomEvent): void;
+    private _findDataFieldsInDatasetsDataFields;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    /**
+     * Build expandable children for a datetime column based on its highestLevel / lowestLevel range.
+     */
+    private _buildDatetimeChildren;
+    /**
+     * Build expandable children for a hierarchy column based on its hierarchyLevels.
+     */
+    private _buildHierarchyChildren;
+    /**
+     * Returns true when a column should render expandable datetime children.
+     */
+    private _isExpandableDatetime;
+    /**
+     * Returns true when a column should render expandable hierarchy children.
+     */
+    private _isExpandableHierarchy;
+    protected render(): TemplateResult;
+}
+export {};

package/components/data-fields-select/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`}),require(`../set-locale-C9s0jVjQ.cjs`),require(`../localized-mixin-DD2Hm1jz.cjs`),require(`../periods.const-CX2ZWWrf.cjs`),require(`../calculate-data-field-icon-BhiGlh0u.cjs`);const e=require(`../data-fields-select-cqu8GYXD.cjs`);Object.defineProperty(exports,`LuzmoDataFieldsSelect`,{enumerable:!0,get:function(){return e.t}});

package/components/data-fields-select/index.d.ts

@@ -0,0 +1,8 @@
+import { LuzmoDataFieldsSelect } from './data-fields-select';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-data-fields-select': LuzmoDataFieldsSelect;
+    }
+}
+export { LuzmoDataFieldsSelect } from './data-fields-select';
+export type { AdHocFormulaFieldData, AdHocFormulaInput } from '../../types/dataset-data-field.types';