@luzmo/analytics-components-kit 1.1.1 → 1.3.0

package/components/interactive-viz-item-ojdH1uk0.cjs

@@ -0,0 +1,268 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+require("./tokens-BWMfo_w4.cjs");const e=require("./base-CGDNY_7v.cjs"),t=require("./decorate-DCJt-2rt.cjs"),n=require("./localized-mixin-EoNvtTBG.cjs"),r=require("./is-same-option-value-Cf6BQcs7.cjs"),i=require("./chart-helpers-fMnqHRzC.cjs"),a=require("./create-lazy-loader-DYPgQh0L.cjs");let o=require("@luzmo/icons");require("@luzmo/lucero/action-button"),require("@luzmo/lucero/icon"),require("@luzmo/lucero/overlay"),require("@luzmo/lucero/popover");let s=require("lit"),c=require("lit/decorators.js"),l=require("@lit/localize");require("@luzmo/embed"),require("@luzmo/lucero/action-group"),require("@luzmo/lucero/field-label"),require("@luzmo/lucero/number-field"),require("@luzmo/lucero/picker"),require("@luzmo/lucero/progress-circle"),require("@luzmo/lucero/tabs");var u=`:host{box-sizing:border-box;display:block;container-type:inline-size}.answer{width:100%;display:block}.chart-actions-bar{justify-content:space-between;align-items:flex-start;gap:var(--luzmo-interactive-viz-item-actions-gap,var(--interactive-viz-item-actions-gap));padding-block:var(--luzmo-interactive-viz-item-actions-padding-block,var(--interactive-viz-item-actions-padding-block));flex-wrap:nowrap;margin-block-start:var(--luzmo-interactive-viz-item-actions-margin-block-start,var(--interactive-viz-item-actions-margin-block-start));display:flex}.chart-actions-primary{gap:var(--luzmo-interactive-viz-item-actions-gap,var(--interactive-viz-item-actions-gap));flex-wrap:wrap;flex:1;align-items:center;min-width:0;display:flex}.ranking-content{gap:var(--luzmo-spacing-3);padding:var(--luzmo-spacing-3);flex-direction:column;display:flex}.ranking-row{gap:var(--luzmo-spacing-3);align-items:center;display:flex}.ranking-number{width:4rem}.icon-flipped{transform:scaleY(-1)}.chart-container{border-radius:var(--luzmo-interactive-viz-item-chart-border-radius,var(--interactive-viz-item-chart-border-radius));height:var(--luzmo-interactive-viz-item-chart-height,var(--interactive-viz-item-chart-height));overflow:hidden}.chart-container luzmo-embed-viz-item{width:100%;height:100%;display:block}.feedback-row{padding-block:var(--luzmo-interactive-viz-item-feedback-padding-block,var(--interactive-viz-item-feedback-padding-block));justify-content:space-between;align-items:center;display:flex}.rating-btn-positive{--luzmo-action-button-content-color-default-selected:var(--luzmo-interactive-viz-item-rating-positive-color,var(--interactive-viz-item-rating-positive-color));--luzmo-action-button-content-color-hover-selected:var(--luzmo-interactive-viz-item-rating-positive-color,var(--interactive-viz-item-rating-positive-color));--luzmo-action-button-content-color-down-selected:var(--luzmo-interactive-viz-item-rating-positive-color,var(--interactive-viz-item-rating-positive-color));--luzmo-action-button-content-color-focus-selected:var(--luzmo-interactive-viz-item-rating-positive-color,var(--interactive-viz-item-rating-positive-color));--luzmo-action-button-background-color-default-selected:var(--luzmo-interactive-viz-item-rating-selected-background,var(--interactive-viz-item-rating-selected-background));--luzmo-action-button-background-color-hover-selected:var(--luzmo-interactive-viz-item-rating-selected-background,var(--interactive-viz-item-rating-selected-background));--luzmo-action-button-background-color-down-selected:var(--luzmo-interactive-viz-item-rating-selected-background,var(--interactive-viz-item-rating-selected-background));--luzmo-action-button-background-color-focus-selected:var(--luzmo-interactive-viz-item-rating-selected-background,var(--interactive-viz-item-rating-selected-background))}.rating-btn-negative{--luzmo-action-button-content-color-default-selected:var(--luzmo-interactive-viz-item-rating-negative-color,var(--interactive-viz-item-rating-negative-color));--luzmo-action-button-content-color-hover-selected:var(--luzmo-interactive-viz-item-rating-negative-color,var(--interactive-viz-item-rating-negative-color));--luzmo-action-button-content-color-down-selected:var(--luzmo-interactive-viz-item-rating-negative-color,var(--interactive-viz-item-rating-negative-color));--luzmo-action-button-content-color-focus-selected:var(--luzmo-interactive-viz-item-rating-negative-color,var(--interactive-viz-item-rating-negative-color));--luzmo-action-button-background-color-default-selected:var(--luzmo-interactive-viz-item-rating-selected-background,var(--interactive-viz-item-rating-selected-background));--luzmo-action-button-background-color-hover-selected:var(--luzmo-interactive-viz-item-rating-selected-background,var(--interactive-viz-item-rating-selected-background));--luzmo-action-button-background-color-down-selected:var(--luzmo-interactive-viz-item-rating-selected-background,var(--interactive-viz-item-rating-selected-background));--luzmo-action-button-background-color-focus-selected:var(--luzmo-interactive-viz-item-rating-selected-background,var(--interactive-viz-item-rating-selected-background))}.config-toggle{--luzmo-action-button-border-radius:32px;margin-inline-start:auto}.sr-only{clip-path:inset(50%);white-space:nowrap;border:0;width:1px;height:1px;margin:-1px;padding:0;position:absolute;overflow:hidden}.config-panel{border:1px solid var(--luzmo-interactive-viz-item-config-panel-border-color,var(--interactive-viz-item-config-panel-border-color));border-radius:var(--luzmo-interactive-viz-item-config-panel-border-radius,var(--interactive-viz-item-config-panel-border-radius));padding:var(--luzmo-interactive-viz-item-config-panel-padding,var(--interactive-viz-item-config-panel-padding));background:var(--luzmo-interactive-viz-item-config-panel-background,var(--interactive-viz-item-config-panel-background));margin-block-start:var(--luzmo-spacing-2)}.config-panel luzmo-tab-panel[selected]{padding-block-start:var(--luzmo-spacing-4);display:block}.config-panel luzmo-item-option-panel,.config-panel luzmo-item-slot-picker-panel,.config-panel luzmo-filters{width:100%;max-height:15rem;scrollbar-width:thin;scrollbar-color:var(--luzmo-interactive-viz-item-config-panel-border-color,var(--interactive-viz-item-config-panel-border-color)) transparent;padding-inline-end:var(--luzmo-spacing-3);overflow-y:auto}.edit-grid{min-height:12.5rem;display:flex}.edit-column{gap:var(--luzmo-spacing-3);flex-direction:column;display:flex}.edit-column:first-child{flex-shrink:0;max-width:15rem}.edit-column-filters{border-inline-start:1px solid var(--luzmo-interactive-viz-item-config-panel-border-color,var(--interactive-viz-item-config-panel-border-color));flex:1;min-width:18.75rem;padding-inline-start:var(--luzmo-spacing-5)}@container (width<=520px){.edit-grid{flex-direction:column}.edit-column,.edit-column:first-child{width:100%;min-width:0;max-width:100%}.edit-column-filters{border-inline-start:none;border-block-start:1px solid var(--luzmo-interactive-viz-item-config-panel-border-color,var(--interactive-viz-item-config-panel-border-color));min-width:0;margin-block-start:var(--luzmo-spacing-3);padding-block-start:var(--luzmo-spacing-4);padding-inline-start:0}}@container (width<=768px){.chart-container{height:calc(var(--luzmo-interactive-viz-item-chart-height,var(--interactive-viz-item-chart-height)) - var(--luzmo-interactive-viz-item-chart-narrow-offset,var(--interactive-viz-item-chart-narrow-offset)))}}:host{--interactive-viz-item-actions-gap:var(--luzmo-spacing-3);--interactive-viz-item-actions-padding-block:var(--luzmo-spacing-3);--interactive-viz-item-actions-margin-block-start:var(--luzmo-spacing-5);--interactive-viz-item-chart-height:20rem;--interactive-viz-item-chart-narrow-offset:2.5rem;--interactive-viz-item-chart-border-radius:var(--luzmo-border-radius);--interactive-viz-item-feedback-padding-block:var(--luzmo-spacing-4);--interactive-viz-item-config-panel-padding:var(--luzmo-spacing-5);--interactive-viz-item-config-panel-border-color:var(--luzmo-border-color);--interactive-viz-item-config-panel-border-radius:var(--luzmo-border-radius);--interactive-viz-item-config-panel-background:var(--luzmo-background-color);--interactive-viz-item-rating-positive-color:var(--luzmo-positive-color,#12855a);--interactive-viz-item-rating-negative-color:var(--luzmo-negative-color,#ca221c);--interactive-viz-item-rating-selected-background:var(--luzmo-background-color-focus,#0000000f)}:host([size=s]){--interactive-viz-item-chart-height:17.5rem}:host([size=l]){--interactive-viz-item-chart-height:22rem}:host([size=xl]){--interactive-viz-item-chart-height:24rem}`,d=a.t(()=>Promise.resolve().then(()=>require("./add-to-dashboard/index.cjs"))).load,f=[`luzmo-filters`,`luzmo-item-option-panel`,`luzmo-item-slot-picker-panel`],p=a.t(()=>Promise.all([Promise.resolve().then(()=>require("./filters/index.cjs")),Promise.resolve().then(()=>require("./item-option-panel/index.cjs")),Promise.resolve().then(()=>require("./item-slot-picker-panel/index.cjs"))])),m=p.load,h=()=>p.isLoaded()||f.every(e=>customElements.get(e)!==void 0),g=0,_={},v=(e,t)=>t!==null&&r.n(JSON.parse(JSON.stringify(e)),JSON.parse(JSON.stringify(t))),y=class extends n.t(e.n(e.i,{validSizes:Object.values(e.t)})){constructor(...e){super(...e),this.chart=null,this.feedback=null,this.messageId=``,this.authKey=``,this.authToken=``,this.apiUrl=`https://api.luzmo.com`,this.appServer=`https://app.luzmo.com`,this.contentLanguage=``,this.hideActions=!1,this.hideFeedback=!1,this.hideConfigPanel=!1,this.addToDashboard=!1,this.dashboardActions=null,this.controlled=!1,this.liveInteractions=!1,this._configPanelOpen=!1,this._configPanelPending=!1,this._configPanelLoadFailed=!1,this._rankingTriggerId=`interactive-viz-item-ranking-${++g}`,this._interactionGeneration=0,this._openInteractions=new Map,this._ownCharts=[],this._handleSlotsChanged=e=>{this.chart&&this._emitChart({...this.chart,slots:e.detail.slotsContents})},this._handleFiltersChanged=e=>{this.chart&&this._emitChart({...this.chart,filters:e.detail.filters})},this._handleOptionsChanged=e=>{if(!this.chart)return;let{options:t,interaction:n}=e.detail;if(!t)return;if(n){let e=this._openInteractions.get(n.id);if(!e||!this._isCurrentContext(e)){e?.generation===this._interactionGeneration&&this._invalidateInteractions();return}}let r=this.chart.options.theme??{};this._emitChart({...this.chart,options:{...t,theme:r}},n)},this._handleInteractionStart=e=>{if(!this.chart)return;let t={chart:this.chart,generation:this._interactionGeneration,auth:this._auth};this._openInteractions.set(e.detail.id,t),this._dispatchInteraction(e,t)},this._handleInteractionClosed=e=>{let t=this._openInteractions.get(e.detail.id);this._openInteractions.delete(e.detail.id),this._openInteractions.size===0&&(this._ownCharts=this._ownCharts.slice(-1)),t&&this._dispatchInteraction(e,t)}}static get styles(){return[(0,s.unsafeCSS)(u)]}get _effectiveContentLanguage(){return this.contentLanguage||this.language}_dispatch(e,t){let n=new CustomEvent(e,{detail:t,bubbles:!0,composed:!0});this.dispatchEvent(n)}get _chartActions(){return this.chart?i.n(i.o(this.chart)):[]}get _rating(){return this.feedback?.rating??0}get _canShowConfigPanel(){return!this.chart||this.hideConfigPanel?!1:!this.chart.inlineData||i.i(i.o(this.chart).slots).length>0}async _toggleConfigPanel(){if(this._configPanelLoadFailed=!1,this._configPanelOpen)this.endInteraction(),this._configPanelOpen=!1;else if(!this._configPanelPending){if(!h()){this._configPanelPending=!0;try{await m()}catch(e){console.warn(`Failed to load the chart configuration panel:`,e),this._configPanelLoadFailed=!0;return}finally{this._configPanelPending=!1}}this.isConnected&&this._canShowConfigPanel&&(this._configPanelOpen=!0)}}endInteraction(){this.renderRoot?.querySelector(`luzmo-item-option-panel`)?.endInteraction?.()}willUpdate(e){super.willUpdate(e),this._openInteractions.size>0&&this._invalidatesInteractions(e)&&this._invalidateInteractions(),e.has(`addToDashboard`)&&this.addToDashboard&&d().catch(e=>console.warn(`Failed to load add to dashboard:`,e))}_emitOptions(e){!this.controlled&&this.chart&&(this.chart={...this.chart,options:e}),this._dispatch(`luzmo-chart-options-changed`,{options:e})}_invalidatesInteractions(e){return e.has(`authKey`)||e.has(`authToken`)||e.has(`apiUrl`)||e.has(`hideConfigPanel`)?!0:e.has(`chart`)&&[...this._openInteractions.values()].some(e=>!this._isCurrentChart(e))}_invalidateInteractions(){this._interactionGeneration++,this.endInteraction()}get _auth(){return[this.authKey,this.authToken,this.apiUrl]}_isCurrentChart(e){let t=this.chart;return t===e.chart||this._ownCharts.some(e=>e===t)||[...this._ownCharts].reverse().some(e=>v(e,t))||v(e.chart,t)}_isCurrentContext(e){return e.generation===this._interactionGeneration&&e.auth.every((e,t)=>e===this._auth[t])&&this._isCurrentChart(e)}_emitChart(e,t){this._ownCharts=this._openInteractions.size>0?[...this._ownCharts,e]:[e],this.controlled||(this.chart=e),this._dispatch(`luzmo-chart-changed`,t?{chart:e,interaction:t}:{chart:e})}_handleDropdownChange(e,t){if(!this.chart)return;t.stopPropagation();let n=t.detail,r=typeof n==`string`?n:n?.value??t.target?.value;if(!r)return;let a=i.t({...i.o(this.chart),options:this.chart.options},{type:`chartAction`,actionType:e.mutationType,key:r});this._emitOptions(a.options)}_currentRanking(e){return e.ranking??{active:!1,number:5,direction:i.c.Top}}_currentSort(e){return e.sort??{direction:i.u.Desc,by:i.l.Measure}}_emitRankAndSort(e,t){this.chart&&this._emitOptions({...this.chart.options,ranking:e,sort:t})}_renderOptionDropdown(e){let t=e.values??[],n=e.currentValue||t[0]?.key||``;return s.html`
+      <luzmo-picker
+        size=${this.size}
+        variant="highlight"
+        value=${n}
+        @change=${t=>this._handleDropdownChange(e,t)}
+      >
+        ${t.map(e=>s.html`<luzmo-menu-item value=${e.key}>${e.label}</luzmo-menu-item>`)}
+      </luzmo-picker>
+    `}_renderRankingPicker(e){let t=this._currentRanking(e),n=this._currentSort(e);if(!t.active)return s.html`
+        <luzmo-action-button
+          size=${this.size}
+          @click=${()=>this._emitRankAndSort({active:!0,number:5,direction:i.c.Top},n)}
+        >
+          <luzmo-icon slot="icon" size="xs" .icon=${o.luzmoAlignLeft}></luzmo-icon>
+          ${(0,l.msg)(`Show top 5`,{desc:`Label to activate top-N ranking on a chart`})}
+        </luzmo-action-button>
+      `;let r=t.direction===i.c.Bottom?(0,l.msg)(`Bottom`,{desc:`Ranking direction: keep the lowest values`}):(0,l.msg)(`Top`,{desc:`Ranking direction: keep the highest values`});return s.html`
+      <luzmo-action-button size=${this.size} id=${this._rankingTriggerId}>
+        <luzmo-icon slot="icon" size="xs" .icon=${o.luzmoAlignLeft}></luzmo-icon>
+        ${r} ${t.number||5}
+      </luzmo-action-button>
+
+      <luzmo-overlay type="auto" placement="bottom-start" trigger=${`${this._rankingTriggerId}@click`}>
+        <luzmo-popover>
+          <div class="ranking-content">
+            <div class="ranking-row">
+              <luzmo-action-group
+                size=${this.size}
+                compact
+                selects="single"
+                .selected=${[t.direction]}
+                @change=${t=>this._handleDirectionChange(e,t)}
+              >
+                <luzmo-action-button value="top" emphasized
+                  >${(0,l.msg)(`Top`,{desc:`Ranking direction: keep the highest values`})}</luzmo-action-button
+                >
+                <luzmo-action-button value="bottom" emphasized
+                  >${(0,l.msg)(`Bottom`,{desc:`Ranking direction: keep the lowest values`})}</luzmo-action-button
+                >
+              </luzmo-action-group>
+
+              <luzmo-number-field
+                class="ranking-number"
+                size=${this.size}
+                hide-stepper
+                min="1"
+                max="100"
+                step="1"
+                .value=${t.number}
+                @change=${t=>this._handleNumberChange(e,t)}
+                @input=${t=>this._handleNumberChange(e,t)}
+              ></luzmo-number-field>
+            </div>
+
+            <div class="ranking-row">
+              <luzmo-action-group
+                size=${this.size}
+                compact
+                selects="single"
+                .selected=${[n.by]}
+                @change=${t=>this._handleSortByChange(e,t)}
+              >
+                <luzmo-action-button value="measure" emphasized>123</luzmo-action-button>
+                <luzmo-action-button value="category" emphasized>ABC</luzmo-action-button>
+              </luzmo-action-group>
+
+              <luzmo-action-group
+                size=${this.size}
+                compact
+                selects="single"
+                .selected=${[n.direction]}
+                @change=${t=>this._handleSortDirectionChange(e,t)}
+              >
+                <luzmo-action-button
+                  value="desc"
+                  emphasized
+                  label=${(0,l.msg)(`Sort descending`,{desc:`Sort chart values in descending order`})}
+                >
+                  <luzmo-icon slot="icon" size="xs" .icon=${o.luzmoAlignLeft}></luzmo-icon>
+                </luzmo-action-button>
+                <luzmo-action-button
+                  value="asc"
+                  emphasized
+                  label=${(0,l.msg)(`Sort ascending`,{desc:`Sort chart values in ascending order`})}
+                >
+                  <luzmo-icon slot="icon" size="xs" class="icon-flipped" .icon=${o.luzmoAlignLeft}></luzmo-icon>
+                </luzmo-action-button>
+              </luzmo-action-group>
+            </div>
+          </div>
+        </luzmo-popover>
+      </luzmo-overlay>
+    `}_handleDirectionChange(e,t){t.stopPropagation();let n=t.target?.selected;n?.length&&this._emitRankAndSort({...this._currentRanking(e),direction:n[0]},this._currentSort(e))}_handleNumberChange(e,t){t.stopPropagation();let n=t.target?.value,r=typeof n==`number`?n:Number.parseInt(String(n),10);!Number.isNaN(r)&&r>=1&&this._emitRankAndSort({...this._currentRanking(e),number:r},this._currentSort(e))}_handleSortByChange(e,t){t.stopPropagation();let n=t.target?.selected;n?.length&&this._emitRankAndSort(this._currentRanking(e),{...this._currentSort(e),by:n[0]})}_handleSortDirectionChange(e,t){t.stopPropagation();let n=t.target?.selected;n?.length&&this._emitRankAndSort(this._currentRanking(e),{...this._currentSort(e),direction:n[0]})}_renderAddToDashboard(){return this.addToDashboard?s.html`
+      <luzmo-add-to-dashboard
+        size=${this.size}
+        language=${this.language}
+        .chart=${this.chart}
+        .dashboardActions=${this.dashboardActions}
+        .authKey=${this.authKey}
+        .authToken=${this.authToken}
+        .apiUrl=${this.apiUrl}
+      ></luzmo-add-to-dashboard>
+    `:s.nothing}_renderActions(){return this.hideActions?s.html`
+        <div class="chart-actions-bar">
+          <div class="chart-actions-primary"></div>
+          <slot name="chart-actions-extra"></slot>
+          ${this._renderAddToDashboard()}
+        </div>
+      `:s.html`
+      <div class="chart-actions-bar">
+        <div class="chart-actions-primary">
+          ${this._chartActions.map(e=>e.type===`optionDropdown`?this._renderOptionDropdown(e):this._renderRankingPicker(e))}
+        </div>
+        <slot name="chart-actions-extra"></slot>
+        ${this._renderAddToDashboard()}
+      </div>
+    `}_renderChart(){if(!this.chart)return s.nothing;let e=i.o(this.chart);return s.html`
+      <div class="chart-container" part="chart-container">
+        <luzmo-embed-viz-item
+          .type=${e.type}
+          .options=${e.options}
+          .slots=${e.slots}
+          .filters=${e.filters??[]}
+          .inlineData=${e.inlineData}
+          .authKey=${this.authKey}
+          .authToken=${this.authToken}
+          .apiHost=${this.apiUrl}
+          .appServer=${this.appServer}
+          .language=${this._effectiveContentLanguage}
+          .canFilter=${this.canFilter??!1}
+        ></luzmo-embed-viz-item>
+      </div>
+    `}_renderFeedback(){let e=!this.hideFeedback&&!!this.messageId,t=this._canShowConfigPanel,n=(0,l.msg)(`Loading`,{desc:`Loading spinner label`});return!e&&!t?s.nothing:s.html`
+      <div class="feedback-row">
+        ${e?s.html`
+                <luzmo-action-group quiet size=${this.size}>
+                  <luzmo-action-button
+                    class="rating-btn-positive"
+                    value="positive"
+                    quiet
+                    label=${(0,l.msg)(`Good response`,{desc:`Accessible label for the positive feedback button`})}
+                    ?selected=${this._rating===1}
+                    @click=${()=>this._toggleRating(!0)}
+                  >
+                    <luzmo-icon slot="icon" size="s" .icon=${o.luzmoThumbsUp}></luzmo-icon>
+                  </luzmo-action-button>
+                  <luzmo-action-button
+                    class="rating-btn-negative"
+                    value="negative"
+                    quiet
+                    label=${(0,l.msg)(`Bad response`,{desc:`Accessible label for the negative feedback button`})}
+                    ?selected=${this._rating===-1}
+                    @click=${()=>this._toggleRating(!1)}
+                  >
+                    <luzmo-icon slot="icon" size="s" .icon=${o.luzmoThumbsDown}></luzmo-icon>
+                  </luzmo-action-button>
+                </luzmo-action-group>
+              `:s.nothing}
+        ${t?s.html`
+                <luzmo-action-button
+                  class="config-toggle"
+                  size=${this.size}
+                  quiet
+                  ?selected=${this._configPanelOpen}
+                  aria-expanded=${this._configPanelOpen}
+                  aria-label=${this._configPanelPending?n:(0,l.msg)(`Configure chart`,{desc:`Accessible label for the chart config toggle`})}
+                  @click=${()=>this._toggleConfigPanel()}
+                >
+                  ${this._configPanelPending?s.html`<luzmo-progress-circle slot="icon" size="s" indeterminate .label=${n}></luzmo-progress-circle>`:s.html`<luzmo-icon slot="icon" size="s" .icon=${o.luzmoInfoCircle}></luzmo-icon>`}
+                </luzmo-action-button>
+                <span class="sr-only" role="status" aria-live="polite">${this._configPanelPending?n:``}</span>
+                <span class="sr-only" role="alert">${this._configPanelLoadFailed?(0,l.msg)(`Failed to load the chart configuration. Please try again.`,{desc:`Error message when the chart config panel fails to load`}):``}</span>
+              `:s.nothing}
+      </div>
+    `}_toggleRating(e){let t=e?1:-1,n=this._rating===t?0:t;this._dispatch(`luzmo-feedback-changed`,{rating:n,comment:this.feedback?.comment})}_renderFilters(e,t){return e.inlineData?s.nothing:s.html`
+      <div class="edit-column edit-column-filters">
+        <luzmo-field-label size=${this.size}
+          >${(0,l.msg)(`Filters`,{desc:`Label for the filters section`})}</luzmo-field-label
+        >
+        <luzmo-filters
+          size=${this.size}
+          .datasetIds=${t}
+          .filters=${e.filters??[]}
+          .authKey=${this.authKey}
+          .authToken=${this.authToken}
+          .apiUrl=${this.apiUrl}
+          .language=${this.language}
+          .contentLanguage=${this._effectiveContentLanguage}
+          @luzmo-filters-changed=${this._handleFiltersChanged}
+        ></luzmo-filters>
+      </div>
+    `}_renderConfigPanel(){if(!this.chart||!this._canShowConfigPanel||!this._configPanelOpen)return s.nothing;let e=this.chart,t=i.r(e.slots??[]),n=i.i(t),r=e.options.theme??_;return s.html`
+      <div class="config-panel" part="config-panel">
+        <luzmo-tabs selected="data" size=${this.size}>
+          <luzmo-tab value="data">${(0,l.msg)(`Data`,{desc:`Label for the data section`})}</luzmo-tab>
+          <luzmo-tab value="options">${(0,l.msg)(`Options`,{desc:`Label for the options section`})}</luzmo-tab>
+
+          <luzmo-tab-panel value="data">
+            <div class="edit-grid">
+              <div class="edit-column">
+                <luzmo-item-slot-picker-panel
+                  size=${this.size}
+                  slot-menu-placement="bottom-end"
+                  .itemType=${e.type}
+                  .slotsContents=${t}
+                  .datasetIds=${n}
+                  .authKey=${this.authKey}
+                  .authToken=${this.authToken}
+                  .apiUrl=${this.apiUrl}
+                  .language=${this.language}
+                  .contentLanguage=${this._effectiveContentLanguage}
+                  @luzmo-slots-contents-changed=${this._handleSlotsChanged}
+                ></luzmo-item-slot-picker-panel>
+              </div>
+              ${this._renderFilters(e,n)}
+            </div>
+          </luzmo-tab-panel>
+
+          <luzmo-tab-panel value="options">
+            <luzmo-item-option-panel
+              size=${this.size}
+              .itemType=${e.type}
+              .options=${e.options||{}}
+              .slots=${t}
+              .theme=${r}
+              .authKey=${this.authKey}
+              .authToken=${this.authToken}
+              .apiUrl=${this.apiUrl}
+              .language=${this.language}
+              ?live-interactions=${this.liveInteractions}
+              @luzmo-options-changed=${this._handleOptionsChanged}
+              @luzmo-option-interaction-start=${this._handleInteractionStart}
+              @luzmo-option-interaction-end=${this._handleInteractionClosed}
+              @luzmo-option-interaction-cancel=${this._handleInteractionClosed}
+            ></luzmo-item-option-panel>
+          </luzmo-tab-panel>
+        </luzmo-tabs>
+      </div>
+    `}_dispatchInteraction(e,{chart:t,generation:n}){e.stopPropagation(),this._dispatch(e.type,{...e.detail,chart:t,generation:n})}render(){return this.chart?s.html`
+      <div class="answer" part="container">
+        ${this._renderActions()} ${this._renderChart()} ${this._renderFeedback()} ${this._renderConfigPanel()}
+      </div>
+    `:s.html`
+        <div
+          class="answer"
+          part="container"
+        ></div>
+      `}};t.t([(0,c.property)({type:Object})],y.prototype,`chart`,void 0),t.t([(0,c.property)({type:Object})],y.prototype,`feedback`,void 0),t.t([(0,c.property)({type:String,attribute:`message-id`})],y.prototype,`messageId`,void 0),t.t([(0,c.property)({type:String,attribute:`auth-key`})],y.prototype,`authKey`,void 0),t.t([(0,c.property)({type:String,attribute:`auth-token`})],y.prototype,`authToken`,void 0),t.t([(0,c.property)({type:String,attribute:`api-url`})],y.prototype,`apiUrl`,void 0),t.t([(0,c.property)({type:String,attribute:`app-server`})],y.prototype,`appServer`,void 0),t.t([(0,c.property)({type:String,attribute:`content-language`})],y.prototype,`contentLanguage`,void 0),t.t([(0,c.property)({type:Boolean,attribute:`hide-actions`,reflect:!0})],y.prototype,`hideActions`,void 0),t.t([(0,c.property)({type:Boolean,attribute:`hide-feedback`,reflect:!0})],y.prototype,`hideFeedback`,void 0),t.t([(0,c.property)({type:Boolean,attribute:`hide-config-panel`,reflect:!0})],y.prototype,`hideConfigPanel`,void 0),t.t([(0,c.property)({type:Boolean,attribute:`add-to-dashboard`,reflect:!0})],y.prototype,`addToDashboard`,void 0),t.t([(0,c.property)({attribute:!1})],y.prototype,`dashboardActions`,void 0),t.t([(0,c.property)({type:Boolean,reflect:!0})],y.prototype,`controlled`,void 0),t.t([(0,c.property)({attribute:`can-filter`,converter:{fromAttribute:e=>e===null?void 0:`all`}})],y.prototype,`canFilter`,void 0),t.t([(0,c.property)({type:Boolean,reflect:!0,attribute:`live-interactions`})],y.prototype,`liveInteractions`,void 0),t.t([(0,c.state)()],y.prototype,`_configPanelOpen`,void 0),t.t([(0,c.state)()],y.prototype,`_configPanelPending`,void 0),t.t([(0,c.state)()],y.prototype,`_configPanelLoadFailed`,void 0),customElements.get(`luzmo-interactive-viz-item`)||customElements.define(`luzmo-interactive-viz-item`,y),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return y}});

package/components/is-same-option-value-B2oyvEqT.js

@@ -0,0 +1,42 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+import { t as e } from "./color-CQcCK-_O.js";
+// src/utils/option-interaction/is-same-option-value.ts
+var t = 1e-9, n = (e, n) => Object.is(e, n) || Math.abs(e - n) <= t, r = (t) => {
+	try {
+		let n = new e(t).to("srgb");
+		return [...n.coords.map((e) => e ?? 0), n.alpha ?? 1];
+	} catch {
+		return;
+	}
+}, i = (e) => typeof e == "object" && !!e && Object.getPrototypeOf(e) === Object.prototype, a = (e, t) => {
+	if (Object.is(e, t)) return !0;
+	if (Array.isArray(e) && Array.isArray(t)) return e.length === t.length && e.every((e, n) => a(e, t[n]));
+	if (i(e) && i(t)) {
+		let n = Object.keys(e);
+		return n.length === Object.keys(t).length && n.every((n) => Object.hasOwn(t, n) && a(e[n], t[n]));
+	}
+	return !1;
+}, o = (e, t) => {
+	if (typeof e != "string" || typeof t != "string" || e === t) return a(e, t);
+	let i = r(e), o = r(t);
+	return !!i && !!o && i.every((e, t) => n(e, o[t]));
+};
+export { a as n, o as t };

package/components/is-same-option-value-Cf6BQcs7.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.
+ * */
+const e=require("./color-DKdzPrQX.cjs");var t=1e-9,n=(e,n)=>Object.is(e,n)||Math.abs(e-n)<=t,r=t=>{try{let n=new e.t(t).to(`srgb`);return[...n.coords.map(e=>e??0),n.alpha??1]}catch{return}},i=e=>typeof e==`object`&&!!e&&Object.getPrototypeOf(e)===Object.prototype,a=(e,t)=>{if(Object.is(e,t))return!0;if(Array.isArray(e)&&Array.isArray(t))return e.length===t.length&&e.every((e,n)=>a(e,t[n]));if(i(e)&&i(t)){let n=Object.keys(e);return n.length===Object.keys(t).length&&n.every(n=>Object.hasOwn(t,n)&&a(e[n],t[n]))}return!1},o=(e,t)=>{if(typeof e!=`string`||typeof t!=`string`||e===t)return a(e,t);let i=r(e),o=r(t);return!!i&&!!o&&i.every((e,t)=>n(e,o[t]))};Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return o}});

package/components/item-option/helpers/control-markup.d.ts

@@ -1,14 +1,21 @@
 import { ElementSize } from '../../../utils/base';
+import type { ItemOptionInteractionEventDetail } from '../types';
 export interface ControlMarkupArgs {
     controlType: string;
     optionKey: string;
     controlInfo: any;
     options: any;
+    /** Returns the latest options when a change is applied, which can be newer than `options`. */
+    getOptions?: () => Record<string, unknown>;
     slots: any;
     theme: any;
     language: string;
     translations: any;
     size: ElementSize;
     changeCallback: any;
+    /** Turns on live updates and interaction lifecycle events on controls that support them. */
+    liveInteractions?: boolean;
+    /** Receives the control's `luzmo-option-interaction-*` events. */
+    interactionCallback?: (event: CustomEvent<ItemOptionInteractionEventDetail>) => void;
 }
 export declare const controlMarkup: (args: ControlMarkupArgs) => import("lit-html").TemplateResult<1> | undefined;

package/components/item-option/index.cjs

@@ -17,4 +17,4 @@
  * 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("../item-option-CqGDFdPj.cjs");exports.LuzmoItemOption=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../item-option-DpLdospV.cjs");exports.LuzmoItemOption=e.t;

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

@@ -5,4 +5,4 @@ declare global {
     }
 }
 export { LuzmoItemOption } from './item-option';
-export type { ItemOptionChangedEventDetail, ItemOptionsChangedEventDetail } from './types';
+export type { ItemOptionChangedEventDetail, ItemOptionInteraction, ItemOptionInteractionEventDetail, ItemOptionInteractionEventName, ItemOptionsChangedEventDetail } from './types';

package/components/item-option/index.js

@@ -17,4 +17,4 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  * */
-export { t as LuzmoItemOption } from "../item-option-Cgx3c08E.js";
+export { t as LuzmoItemOption } from "../item-option-DKLRnicU.js";

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

@@ -1,8 +1,12 @@
 import type { OptionConfig, OptionsConfig, OptionTranslation, ThemeConfig, TranslationOverrides, TranslationsFile, VizItemType } from '@luzmo/dashboard-contents-types';
 import { ElementSize, LuzmoElement } from '../../utils/base';
+import type { ItemOptionInteraction } from './types';
 /**
  * @customElement luzmo-item-option
- * @fires {CustomEvent<ItemOptionsChangedEventDetail>} luzmo-options-changed - Announces that the `options` of the element have changed
+ * @fires {CustomEvent<ItemOptionsChangedEventDetail>} luzmo-options-changed - Announces that the `options` of the element have changed. With `live-interactions`, updates inside a gesture carry `interaction`.
+ * @fires {CustomEvent<ItemOptionInteractionEventDetail>} luzmo-option-interaction-start - With `live-interactions`: a drag or held key first changed the control's value, right before that options update. A press that never changes the value emits no lifecycle. `detail.optionKey` is set.
+ * @fires {CustomEvent<ItemOptionInteractionEventDetail>} luzmo-option-interaction-end - With `live-interactions`: the gesture ended, after its last options update. `detail.changed` is false when the value is back at its start.
+ * @fires {CustomEvent<ItemOptionInteractionEventDetail>} luzmo-option-interaction-cancel - With `live-interactions`: the gesture was cancelled and the control reverted to its start value.
  */
 export declare class LuzmoItemOption extends LuzmoElement {
     static styles: import("lit").CSSResult;
@@ -39,6 +43,11 @@ export declare class LuzmoItemOption extends LuzmoElement {
     authToken?: string;
     /** The size variant of the option control (`s`, `m`, `l`, `xl`). */
     size: ElementSize;
+    /**
+     * Emits options updates live, without the control's debounce, plus `luzmo-option-interaction-*` events
+     * around drags and held keys. Off by default.
+     */
+    liveInteractions: boolean;
     _controlTypeLoaded: string;
     _itemTypeLoaded?: string;
     _languageLoaded?: string;
@@ -47,8 +56,20 @@ export declare class LuzmoItemOption extends LuzmoElement {
     _translationOverrides?: TranslationOverrides;
     _effectiveTranslations: TranslationsFile;
     _fullTheme?: any;
+    /**
+     * @internal Returns the owner's latest options. Supplied by `luzmo-item-option-panel`, whose other options can change it
+     * before this one re-renders, so a change applies on top of theirs.
+     */
+    latestOptions?: () => Record<string, unknown> | undefined;
+    private _getLatestOptions;
     /** Callback that updates `options` and emits `luzmo-options-changed`; used internally by the rendered control. */
-    changedOptions: (options: any) => void;
+    changedOptions: (options: any, interaction?: ItemOptionInteraction) => void;
+    /** Ends the control's open gesture now, keeping its value. Call before removing or rebinding the element. */
+    endInteraction(): void;
+    private get _renderedOptionKey();
+    /** Option key per open gesture, so a gesture ended after the element was rebound still names the option it edited. */
+    private readonly _interactionOptionKeys;
+    private _handleInteraction;
     render(): import("lit-html").TemplateResult<1> | undefined;
     private _getTranslationOverrides;
     private _mergeOptionTranslations;

package/components/item-option/types.d.ts

@@ -1,8 +1,27 @@
 import type { OptionsConfig } from '@luzmo/dashboard-contents-types';
+/** Identifies the continuous gesture (drag or held key) that a live value update belongs to. */
+export interface ItemOptionInteraction {
+    /** Unique id of the gesture, shared by its lifecycle events and its value updates. */
+    id: string;
+}
 export interface ItemOptionChangedEventDetail {
     value?: unknown;
     values?: Record<string, number | undefined>;
+    /** Set only in live-interactions mode, on updates that belong to a gesture. */
+    interaction?: ItemOptionInteraction;
 }
 export interface ItemOptionsChangedEventDetail {
     options: OptionsConfig;
+    /** Set only in live-interactions mode, on updates that belong to a gesture. */
+    interaction?: ItemOptionInteraction;
+}
+/** Detail of `luzmo-option-interaction-start`, `luzmo-option-interaction-end` and `luzmo-option-interaction-cancel`. */
+export interface ItemOptionInteractionEventDetail {
+    /** Gesture id; matches `interaction.id` on the gesture's value updates. */
+    id: string;
+    /** Option key of the `luzmo-item-option` that hosts the control. Absent on events from a bare control. */
+    optionKey?: string;
+    /** On `end` and `cancel`: whether the final value differs from the value at `start` (normalized). */
+    changed?: boolean;
 }
+export type ItemOptionInteractionEventName = 'luzmo-option-interaction-start' | 'luzmo-option-interaction-end' | 'luzmo-option-interaction-cancel';