@luzmo/analytics-components-kit 1.0.6 → 1.0.7

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

@@ -0,0 +1,87 @@
+/*! * 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("./base-DYRe99_q.cjs"),t=require("./decorate-DCJt-2rt.cjs"),n=require("./localized-mixin-BForHr3t.cjs"),r=require("./data-broker-DWEXs6-2.cjs"),i=require("./localize-D3i4Epy_.cjs"),a=require("./load-data-fields-for-datasets-CW4Voiex.cjs");require("./data-field-lGJ557o4.cjs");let o=require("lit"),s=require("lit/decorators.js"),c=require("@lit/localize");require("@luzmo/lucero/select");let l=require("lit/directives/repeat.js"),u=require("@lit/task");require("@luzmo/lucero/progress-circle"),require("@luzmo/lucero/search");var d=`: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);--data-field-panel-scrollbar-width:var(--luzmo-scrollbar-size);--data-field-panel-scrollbar-track-background:var(--luzmo-scrollbar-track-background);--data-field-panel-scrollbar-track-border-radius:var(--luzmo-scrollbar-track-border-radius);--data-field-panel-scrollbar-thumb-background:var(--luzmo-scrollbar-thumb-background);--data-field-panel-scrollbar-thumb-border-radius:var(--luzmo-scrollbar-thumb-border-radius);--data-field-panel-scrollbar-thumb-hover-background:var(--luzmo-scrollbar-thumb-hover-background)}: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(--data-field-panel-scrollbar-width))}.data-fields-list::-webkit-scrollbar-track{background:var(--luzmo-data-field-panel-scrollbar-track-background,var(--data-field-panel-scrollbar-track-background));border-radius:var(--luzmo-data-field-panel-scrollbar-track-border-radius,var(--data-field-panel-scrollbar-track-border-radius))}.data-fields-list::-webkit-scrollbar-thumb{background:var(--luzmo-data-field-panel-scrollbar-thumb-background,var(--data-field-panel-scrollbar-thumb-background));border-radius:var(--luzmo-data-field-panel-scrollbar-thumb-border-radius,var(--data-field-panel-scrollbar-thumb-border-radius))}.data-fields-list::-webkit-scrollbar-thumb:hover{background:var(--luzmo-data-field-panel-scrollbar-thumb-hover-background,var(--data-field-panel-scrollbar-thumb-hover-background))}.data-fields-list{scrollbar-width:var(--luzmo-scrollbar-width,thin);scrollbar-color:var(--luzmo-data-field-panel-scrollbar-thumb-background,var(--data-field-panel-scrollbar-thumb-background)) var(--luzmo-data-field-panel-scrollbar-track-background,var(--data-field-panel-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}`,f=50,p=class extends n.t(e.n(e.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 u.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 o=await a.t([e],{dataBrokerConfig:{apiUrl:t,authKey:n,authToken:r}});return o.length===0?(this._failedDatasetIds.add(e),null):o[0]}}),this._datasetListItems=[],this._datasetListRetrieving=!1,this._datasetListPending=!1,this._datasetNamesFetchAttempted=!1,this._hasMoreDatasets=!0}static{this.styles=(0,o.unsafeCSS)(d)}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===u.TaskStatus.PENDING}get _error(){if(this._loadDataFieldsTask.status===u.TaskStatus.ERROR){let e=this._loadDataFieldsTask.error,t=e instanceof Error?e.message:`Unknown error`;return`${(0,c.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`||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`),i=e.has(`datasetIds`),a=e.has(`datasetPicker`),o=e.has(`authKey`),s=e.has(`authToken`),c=e.has(`apiUrl`);(i||o||s||c)&&(this._datasetListItems=[],this._hasMoreDatasets=!0,this._failedDatasetIds.clear(),this._datasetNamesFetchAttempted=!1,r.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||i)&&this._updateCurrentDatasetId(),(i||o||s||c||a)&&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{let e=await r.t.fetchDatasetNames(this.datasetIds);this._datasetListItems=e}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 r.t.fetchAllDatasets({offset:e,limit:f});this._datasetListItems=[...this._datasetListItems,...t.data],this._hasMoreDatasets=e+f<(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){let t=e.target;this._searchQuery=t.value}_renderDatasetPicker(){if(!this.datasetPicker)return o.nothing;let e=this._availableDatasets,t=e.length>1,n=this.datasetIds.length>0,r=this._shouldFetchDatasetList;if(!t&&!n&&!r)return o.nothing;let a=this._datasetListPending||this.datasetIds.length>0&&this._datasetListItems.length===0&&this.datasetsDataFields.length===0&&!this._datasetNamesFetchAttempted,s=a?[]:e.map(e=>({value:e.id,label:i.t(e.name,this.language)||e.id})),l=a?[]:this._currentDatasetId?[this._currentDatasetId]:[],u=a?(0,c.msg)(`Loading datasets...`):this.datasetPickerPlaceholder??(0,c.msg)(`Select dataset...`);return o.html`
+      <div class="dataset-picker" part="dataset-picker">
+        <luzmo-select
+          selects="single"
+          variant="highlight"
+          .size=${this.size}
+          .options=${s}
+          .value=${l}
+          .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?o.nothing:o.html`
+      <div class="search-container" part="search">
+        <luzmo-search
+          .size=${this.size}
+          .placeholder=${this.searchPlaceholder??(0,c.msg)(`Search...`)}
+          .value=${this._searchQuery}
+          ?disabled=${this.disabled}
+          ?quiet=${this.searchQuiet}
+          @input=${this._handleSearchInput}
+        ></luzmo-search>
+      </div>
+    `}_renderPendingState(){return o.html`
+      <div class="pending-state" role="status" part="pending-state">
+        <luzmo-progress-circle
+          indeterminate
+          .label=${(0,c.msg)(`Loading`,{desc:`Loading spinner label`})}
+          .size=${this.size}
+        ></luzmo-progress-circle>
+      </div>
+    `}_renderErrorState(){return o.html`
+      <div class="empty-state" role="alert" part="empty-state">
+        ${this._error}
+      </div>
+    `}_renderDataFields(){if(this._error)return this._renderErrorState();if(this._dataFields.length===0)return o.html`
+        <div class="empty-state" part="empty-state">
+          ${(0,c.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?o.html`
+        <div class="empty-state" part="empty-state">
+          ${(0,c.msg)(`No results found`)}
+        </div>
+      `:o.html`
+      <div class="data-fields-list" part="data-fields-list" role="list">
+        ${(0,l.repeat)(e,e=>this._getDataFieldKey(e),e=>o.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 o.html`
+      <div class="container" part="container" aria-busy=${this._isDataFieldsPending?`true`:`false`}>
+        ${this._renderDatasetPicker()}
+        ${this._renderSearch()}
+        ${this._isDataFieldsPending?this._renderPendingState():this._renderDataFields()}
+      </div>
+    `}};t.t([(0,s.property)({type:Array,attribute:`dataset-ids`})],p.prototype,`datasetIds`,void 0),t.t([(0,s.property)({type:Array,attribute:!1})],p.prototype,`datasetsDataFields`,void 0),t.t([(0,s.property)({type:String,attribute:`selected-dataset-id`,reflect:!0})],p.prototype,`selectedDatasetId`,void 0),t.t([(0,s.property)({type:Boolean,attribute:`dataset-picker`,reflect:!0})],p.prototype,`datasetPicker`,void 0),t.t([(0,s.property)({type:Boolean,reflect:!0})],p.prototype,`disabled`,void 0),t.t([(0,s.property)({type:Boolean,reflect:!0})],p.prototype,`pending`,void 0),t.t([(0,s.property)({type:String,attribute:`data-field-variant`,reflect:!0})],p.prototype,`dataFieldVariant`,void 0),t.t([(0,s.property)({type:Boolean,attribute:`search-quiet`,reflect:!0})],p.prototype,`searchQuiet`,void 0),t.t([(0,s.property)({type:Boolean,attribute:`hide-type-icon`,reflect:!0})],p.prototype,`hideTypeIcon`,void 0),t.t([(0,s.property)({type:Boolean,attribute:`hide-sublevels`,reflect:!0})],p.prototype,`hideSublevels`,void 0),t.t([(0,s.property)({type:String,attribute:`dataset-picker-placeholder`})],p.prototype,`datasetPickerPlaceholder`,void 0),t.t([(0,s.property)({type:String,attribute:`api-url`})],p.prototype,`apiUrl`,void 0),t.t([(0,s.property)({type:String,attribute:`auth-key`})],p.prototype,`authKey`,void 0),t.t([(0,s.property)({type:String,attribute:`auth-token`})],p.prototype,`authToken`,void 0),t.t([(0,s.property)({type:String,reflect:!0})],p.prototype,`search`,void 0),t.t([(0,s.property)({type:String,attribute:`search-placeholder`})],p.prototype,`searchPlaceholder`,void 0),t.t([(0,s.property)({type:Number,attribute:`search-threshold`})],p.prototype,`searchThreshold`,void 0),t.t([(0,s.state)()],p.prototype,`_currentDatasetId`,void 0),t.t([(0,s.state)()],p.prototype,`_searchQuery`,void 0),t.t([(0,s.state)()],p.prototype,`_datasetListItems`,void 0),t.t([(0,s.state)()],p.prototype,`_datasetListRetrieving`,void 0),t.t([(0,s.state)()],p.prototype,`_datasetListPending`,void 0),p=t.t([(0,c.localized)()],p),customElements.get(`luzmo-data-field-panel`)||customElements.define(`luzmo-data-field-panel`,p),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return p}});

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

@@ -0,0 +1,385 @@
+/*! * 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 e, n as t } from "./base-2sulw8ws.js";
+import { t as n } from "./decorate-DyMgX_Uh.js";
+import { t as r } from "./localized-mixin-D-vXCJuU.js";
+import { t as i } from "./data-broker-Bdv5V8Yp.js";
+import { t as a } from "./localize-BT7REYBY.js";
+import { t as o } from "./load-data-fields-for-datasets-BNnr8x3m.js";
+import "./data-field-Dz0XFrep.js";
+import { html as s, nothing as c, unsafeCSS as l } from "lit";
+import { property as u, state as d } from "lit/decorators.js";
+import { localized as f, msg as p } from "@lit/localize";
+import "@luzmo/lucero/select";
+import { repeat as m } from "lit/directives/repeat.js";
+import { Task as h, TaskStatus as g } from "@lit/task";
+import "@luzmo/lucero/progress-circle";
+import "@luzmo/lucero/search";
+//#region src/components/data-field-panel/data-field-panel.module.scss?inline
+var _ = ":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);--data-field-panel-scrollbar-width:var(--luzmo-scrollbar-size);--data-field-panel-scrollbar-track-background:var(--luzmo-scrollbar-track-background);--data-field-panel-scrollbar-track-border-radius:var(--luzmo-scrollbar-track-border-radius);--data-field-panel-scrollbar-thumb-background:var(--luzmo-scrollbar-thumb-background);--data-field-panel-scrollbar-thumb-border-radius:var(--luzmo-scrollbar-thumb-border-radius);--data-field-panel-scrollbar-thumb-hover-background:var(--luzmo-scrollbar-thumb-hover-background)}: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(--data-field-panel-scrollbar-width))}.data-fields-list::-webkit-scrollbar-track{background:var(--luzmo-data-field-panel-scrollbar-track-background,var(--data-field-panel-scrollbar-track-background));border-radius:var(--luzmo-data-field-panel-scrollbar-track-border-radius,var(--data-field-panel-scrollbar-track-border-radius))}.data-fields-list::-webkit-scrollbar-thumb{background:var(--luzmo-data-field-panel-scrollbar-thumb-background,var(--data-field-panel-scrollbar-thumb-background));border-radius:var(--luzmo-data-field-panel-scrollbar-thumb-border-radius,var(--data-field-panel-scrollbar-thumb-border-radius))}.data-fields-list::-webkit-scrollbar-thumb:hover{background:var(--luzmo-data-field-panel-scrollbar-thumb-hover-background,var(--data-field-panel-scrollbar-thumb-hover-background))}.data-fields-list{scrollbar-width:var(--luzmo-scrollbar-width,thin);scrollbar-color:var(--luzmo-data-field-panel-scrollbar-thumb-background,var(--data-field-panel-scrollbar-thumb-background)) var(--luzmo-data-field-panel-scrollbar-track-background,var(--data-field-panel-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}", v = 50, y = class extends r(t(e, {
+	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 h(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([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 = l(_);
+	}
+	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 === g.PENDING;
+	}
+	get _error() {
+		if (this._loadDataFieldsTask.status === g.ERROR) {
+			let e = this._loadDataFieldsTask.error, t = e instanceof Error ? e.message : "Unknown error";
+			return `${p("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" || 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) => (a(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"), a = 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, i.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 || a) && 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 {
+				let e = await i.fetchDatasetNames(this.datasetIds);
+				this._datasetListItems = e;
+			} 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 i.fetchAllDatasets({
+					offset: e,
+					limit: v
+				});
+				this._datasetListItems = [...this._datasetListItems, ...t.data], this._hasMoreDatasets = e + v < (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) {
+		let t = e.target;
+		this._searchQuery = t.value;
+	}
+	_renderDatasetPicker() {
+		if (!this.datasetPicker) return c;
+		let e = this._availableDatasets, t = e.length > 1, n = this.datasetIds.length > 0, r = this._shouldFetchDatasetList;
+		if (!t && !n && !r) return c;
+		let i = this._datasetListPending || this.datasetIds.length > 0 && this._datasetListItems.length === 0 && this.datasetsDataFields.length === 0 && !this._datasetNamesFetchAttempted, o = i ? [] : e.map((e) => ({
+			value: e.id,
+			label: a(e.name, this.language) || e.id
+		})), l = i ? [] : this._currentDatasetId ? [this._currentDatasetId] : [], u = i ? p("Loading datasets...") : this.datasetPickerPlaceholder ?? p("Select dataset...");
+		return s`
+      <div class="dataset-picker" part="dataset-picker">
+        <luzmo-select
+          selects="single"
+          variant="highlight"
+          .size=${this.size}
+          .options=${o}
+          .value=${l}
+          .label=${u}
+          ?disabled=${this.disabled}
+          ?pending=${i}
+          @change=${this._handleDatasetChange}
+          @luzmo-opened=${this._handlePickerOpened}
+          @luzmo-scrolled=${this._handlePickerScrolled}
+        ></luzmo-select>
+      </div>
+    `;
+	}
+	_renderSearch() {
+		return !this._showSearch || this._isDataFieldsPending ? c : s`
+      <div class="search-container" part="search">
+        <luzmo-search
+          .size=${this.size}
+          .placeholder=${this.searchPlaceholder ?? p("Search...")}
+          .value=${this._searchQuery}
+          ?disabled=${this.disabled}
+          ?quiet=${this.searchQuiet}
+          @input=${this._handleSearchInput}
+        ></luzmo-search>
+      </div>
+    `;
+	}
+	_renderPendingState() {
+		return s`
+      <div class="pending-state" role="status" part="pending-state">
+        <luzmo-progress-circle
+          indeterminate
+          .label=${p("Loading", { desc: "Loading spinner label" })}
+          .size=${this.size}
+        ></luzmo-progress-circle>
+      </div>
+    `;
+	}
+	_renderErrorState() {
+		return s`
+      <div class="empty-state" role="alert" part="empty-state">
+        ${this._error}
+      </div>
+    `;
+	}
+	_renderDataFields() {
+		if (this._error) return this._renderErrorState();
+		if (this._dataFields.length === 0) return s`
+        <div class="empty-state" part="empty-state">
+          ${p("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`
+        <div class="empty-state" part="empty-state">
+          ${p("No results found")}
+        </div>
+      ` : s`
+      <div class="data-fields-list" part="data-fields-list" role="list">
+        ${m(e, (e) => this._getDataFieldKey(e), (e) => s`
+            <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`
+      <div class="container" part="container" aria-busy=${this._isDataFieldsPending ? "true" : "false"}>
+        ${this._renderDatasetPicker()}
+        ${this._renderSearch()}
+        ${this._isDataFieldsPending ? this._renderPendingState() : this._renderDataFields()}
+      </div>
+    `;
+	}
+};
+//#endregion
+//#region src/components/data-field-panel/index.ts
+n([u({
+	type: Array,
+	attribute: "dataset-ids"
+})], y.prototype, "datasetIds", void 0), n([u({
+	type: Array,
+	attribute: !1
+})], y.prototype, "datasetsDataFields", void 0), n([u({
+	type: String,
+	attribute: "selected-dataset-id",
+	reflect: !0
+})], y.prototype, "selectedDatasetId", void 0), n([u({
+	type: Boolean,
+	attribute: "dataset-picker",
+	reflect: !0
+})], y.prototype, "datasetPicker", void 0), n([u({
+	type: Boolean,
+	reflect: !0
+})], y.prototype, "disabled", void 0), n([u({
+	type: Boolean,
+	reflect: !0
+})], y.prototype, "pending", void 0), n([u({
+	type: String,
+	attribute: "data-field-variant",
+	reflect: !0
+})], y.prototype, "dataFieldVariant", void 0), n([u({
+	type: Boolean,
+	attribute: "search-quiet",
+	reflect: !0
+})], y.prototype, "searchQuiet", void 0), n([u({
+	type: Boolean,
+	attribute: "hide-type-icon",
+	reflect: !0
+})], y.prototype, "hideTypeIcon", void 0), n([u({
+	type: Boolean,
+	attribute: "hide-sublevels",
+	reflect: !0
+})], y.prototype, "hideSublevels", void 0), n([u({
+	type: String,
+	attribute: "dataset-picker-placeholder"
+})], y.prototype, "datasetPickerPlaceholder", void 0), n([u({
+	type: String,
+	attribute: "api-url"
+})], y.prototype, "apiUrl", void 0), n([u({
+	type: String,
+	attribute: "auth-key"
+})], y.prototype, "authKey", void 0), n([u({
+	type: String,
+	attribute: "auth-token"
+})], y.prototype, "authToken", void 0), n([u({
+	type: String,
+	reflect: !0
+})], y.prototype, "search", void 0), n([u({
+	type: String,
+	attribute: "search-placeholder"
+})], y.prototype, "searchPlaceholder", void 0), n([u({
+	type: Number,
+	attribute: "search-threshold"
+})], y.prototype, "searchThreshold", void 0), n([d()], y.prototype, "_currentDatasetId", void 0), n([d()], y.prototype, "_searchQuery", void 0), n([d()], y.prototype, "_datasetListItems", void 0), n([d()], y.prototype, "_datasetListRetrieving", void 0), n([d()], y.prototype, "_datasetListPending", void 0), y = n([f()], y), customElements.get("luzmo-data-field-panel") || customElements.define("luzmo-data-field-panel", y);
+//#endregion
+export { y as t };

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

@@ -0,0 +1,133 @@
+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;
+};
+/**
+ * @customElement luzmo-data-fields-select
+ * @fires {CustomEvent<DataFieldsSelectedEventDetail>} luzmo-data-fields-selected - Emitted when data fields are selected
+ */
+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';
+    /**
+     * Whether datetime and hierarchy columns expand into selectable sublevels. Turn this off in
+     * contexts that address the column as a whole, so the column stays selectable by its own id.
+     */
+    levels: 'on' | 'off';
+    /**
+     * 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;
+    private _lastEmittedValue;
+    private _pendingAutoSelectEvent;
+    /** 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 _normalizeValueForLevels;
+    private _findDataFieldsInDatasetsDataFields;
+    private _getAutoSelectValue;
+    private _autoSelectInitialDataField;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    protected updated(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`});const e=require("../data-fields-select-BBzzUG2u.cjs");Object.defineProperty(exports,"LuzmoDataFieldsSelect",{enumerable:!0,get:function(){return e.t}});