@luzmo/analytics-components-kit 1.0.6 → 1.0.7

package/components/display-settings-numeric-C4X7oOEU.cjs

@@ -0,0 +1,190 @@
+/*! * 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("./calculate-data-field-icon-DenGmW74.cjs"),i=require("./localize-D3i4Epy_.cjs"),a=require("./decompose-numeric-format-DGJua3rU.cjs");let o=require("@luzmo/icons"),s=require("@luzmo/lucero/overlay");require("@luzmo/lucero/popover");let c=require("lit"),l=require("lit/decorators.js"),u=require("@lit/localize");require("@luzmo/lucero/action-button"),require("@luzmo/lucero/tooltip"),require("@luzmo/lucero/action-group"),require("@luzmo/lucero/field-label"),require("@luzmo/lucero/number-field"),require("@luzmo/lucero/picker"),require("@luzmo/lucero/menu");var d=`:host .settings-container{gap:var(--luzmo-display-settings-vertical-gap,var(--luzmo-spacing-2));flex-direction:column;display:flex}:host .settings-row{justify-content:flex-start;align-items:center;gap:var(--luzmo-display-settings-numeric-gap,var(--display-settings-numeric-gap));display:flex}.duration-angle-down-icon{margin-inline-start:var(--luzmo-numeric-duration-levels-dropdown-icon-margin-inline-start,var(--numeric-duration-levels-dropdown-icon-margin-inline-start))}.dataset-header{white-space:nowrap;text-overflow:ellipsis;text-transform:uppercase;max-width:100%;color:var(--luzmo-font-color);white-space:nowrap;cursor:default;margin:.5rem 1rem;font-weight:600;overflow:hidden}.no-weight-label{margin-left:1rem}.with-secondary-icon{clip-path:polygon(0 0,60% 0,65% 60%,100% 65%,100% 100%,0 100%)}.secondary-icon{width:auto;font-size:.75em;line-height:1;position:absolute;bottom:45%;left:60%}.data-icon-type{text-align:center;width:1.5rem;display:inline-block;position:relative}:host{--display-settings-numeric-gap:var(--luzmo-spacing-3);--numeric-duration-levels-dropdown-icon-margin-inline-start:var(--luzmo-spacing-2)}:host([size=s]){--display-settings-numeric-gap:var(--luzmo-spacing-3);--numeric-duration-levels-dropdown-icon-margin-inline-start:var(--luzmo-spacing-1)}:host([size=l]){--display-settings-numeric-gap:var(--luzmo-spacing-4);--numeric-duration-levels-dropdown-icon-margin-inline-start:var(--luzmo-spacing-3)}:host([size=xl]){--display-settings-numeric-gap:var(--luzmo-spacing-5);--numeric-duration-levels-dropdown-icon-margin-inline-start:var(--luzmo-spacing-4)}`,f={sum:()=>(0,u.msg)(`Sum`,{desc:`Aggregation label`}),cumulativesum:()=>(0,u.msg)(`Cumulative sum`,{desc:`Aggregation label`}),average:()=>(0,u.msg)(`Average`,{desc:`Aggregation label`}),median:()=>(0,u.msg)(`Median`,{desc:`Aggregation label`}),count:()=>(0,u.msg)(`Count rows`,{desc:`Aggregation label`}),distinctcount:()=>(0,u.msg)(`Count distinct`,{desc:`Aggregation label`}),min:()=>(0,u.msg)(`Minimum`,{desc:`Aggregation label`}),max:()=>(0,u.msg)(`Maximum`,{desc:`Aggregation label`}),stddev:()=>(0,u.msg)(`Standard deviation`,{desc:`Aggregation label`}),rate:()=>(0,u.msg)(`Rate`,{desc:`Aggregation label`})},p={general:`123`,percentage:`%`,scientific:`SI`},m={time:()=>(0,u.msg)(`Time`,{desc:`Time format option`}),short:()=>(0,u.msg)(`Short`,{desc:`Short format option`}),long:()=>(0,u.msg)(`Long`,{desc:`Long format option`})},h={Auto:{auto:!0,label:()=>(0,u.msg)(`Auto`,{desc:`Automatic setting of the option`})},"1,000.00":{auto:!1,label:()=>`1,000.00`,thousandSeparator:`,`,decimalSeparator:`.`,hiddenFor:`scientific`},"1.000,00":{auto:!1,label:()=>`1.000,00`,thousandSeparator:`.`,decimalSeparator:`,`,hiddenFor:`scientific`},"1000.00":{auto:!1,label:()=>`1000.00`,decimalSeparator:`.`},"1000,00":{auto:!1,label:()=>`1000,00`,decimalSeparator:`,`}},g={levels:[{level:1,label:`years`},{level:2,label:`quarters`},{level:3,label:`months`},{level:4,label:`weeks`},{level:5,label:`days`},{level:6,label:`hours`},{level:7,label:`minutes`},{level:8,label:`seconds`},{level:9,label:`milliseconds`}]},_=class extends n.t(e.n(e.i,{validSizes:Object.values(e.t)})){constructor(...e){super(...e),this.slotContent={},this.measureColumns=[],this._durationLevels=[],this._renderDurationLevelMenu=!1,this._handleSlottableRequest=e=>{this._renderDurationLevelMenu=e.data!==s.removeSlottableRequest},this._sendEvent=()=>{let e={...this.slotContent,format:this._format,aggregationFunc:this._aggregationFunc};this._aggregationWeightColumn?e.aggregationWeight={...this._aggregationWeightColumn}:delete e.aggregationWeight,this._displayMode===`duration`?(e.duration=e.duration??{},e.duration.format=this._durationFormat,e.duration.levels=this._durationLevels):delete e.duration,this.dispatchEvent(new CustomEvent(`luzmo-slot-content-changed`,{bubbles:!0,composed:!0,cancelable:!0,detail:{slotContent:e}}))}}static get styles(){return[(0,c.unsafeCSS)(d)]}_parseSavedNumericFormatSettings(){if(this._displayMode=this.slotContent?.subtype===`duration`?`duration`:`numeric`,this._durationFormat=this.slotContent?.duration?.format??`short`,this._durationLevels=this.slotContent?.duration?.levels??[1],this._displayMode===`duration`)this._precision=2,this._commaDecimals=!1,this._thousandSeparator=!1;else{this._format=this.slotContent?.format??`.0f`;let e=a.t(this._format??`.0f`);this._isAuto=e.typeFormat?.includes(`a`)??!1,[`%`,`a%`,`y`,`ay`].includes(e.typeFormat)?this._displayAs=`percentage`:[`s`,`as`,`w`,`aw`].includes(e.typeFormat)?this._displayAs=`scientific`:this._displayAs=`general`,this._precision=e.precision?Number.parseInt(e.precision.replace(`.`,``),10):+(this._displayAs===`scientific`),this._commaDecimals=[`z`,`az`,`y`,`ay`,`w`,`aw`].includes(e.typeFormat),this._thousandSeparator=e.comma===`,`,this._isAuto?this._numericFormatGroup=`Auto`:this._commaDecimals&&this._thousandSeparator?this._numericFormatGroup=`1.000,00`:!this._commaDecimals&&this._thousandSeparator?this._numericFormatGroup=`1,000.00`:this._commaDecimals&&!this._thousandSeparator?this._numericFormatGroup=`1000,00`:!this._commaDecimals&&!this._thousandSeparator&&(this._numericFormatGroup=`1000.00`)}}_setNumericDisplayAs(){this._displayAs=this._displayAsElement?.selected?.[0]??`general`,this._displayAs===`scientific`&&(this._precision=Math.max(this._precision??0,1),this._thousandSeparator=!1),this._setNumericFormat(),this._sendEvent(),this.requestUpdate()}_setNumericSeparators(e){let t=h[e?.detail??`Auto`];this._thousandSeparator=[`,`,`.`].includes(t?.thousandSeparator??``),this._commaDecimals=t?.decimalSeparator===`,`,this._isAuto=t?.auto,this._setNumericFormat(),this._sendEvent()}_setPrecision(){Number.isNaN(this._precisionElement.value)&&(this._precisionElement.value=+(this._displayAs===`scientific`)),this._precision=this._precisionElement.value,this._setNumericFormat(),this._sendEvent()}_setNumericFormat(){let e=`f`,t=this.slotContent.subtype===`duration`?this._durationLevels&&this._durationLevels?.length===1?`numeric`:`duration`:`numeric`;if(this._maxDurationLevel=Math.min(...this._durationLevels),t===`duration`)(![`time`,`short`,`long`].includes(this._durationFormat??``)||this._maxDurationLevel<6&&this._durationFormat===`time`)&&(this._durationFormat=`short`);else{let t=this._displayAs??`general`;t===`general`&&this._commaDecimals?e=`z`:t===`percentage`&&this._commaDecimals?e=`y`:t===`scientific`&&this._commaDecimals?e=`w`:t===`percentage`?e=`%`:t===`scientific`&&(e=`s`),this._format=(this._thousandSeparator||this._isAuto?`,`:``)+`.`+this._precision+(this._isAuto?`a`:``)+e}}_setAggregationFunc(){let e=this._aggregationElement.value,t=this._aggregationFunc,n=this.slotContent.format;if(e!==(t===`weightedaverage`?`average`:t)){if(this._aggregationFunc=e===`average`&&this._aggregationWeightColumn?.column?`weightedaverage`:e,t===`rate`){let e=a.t(n),t=[`%`,`y`,`a%`,`ay`].includes(e.typeFormat);this.slotContent.subtype===`currency`&&t&&this._setNumericDisplayAs()}this._sendEvent(),(this._aggregationFunc===`rate`||t===`rate`)&&this.requestUpdate()}}_setAggregationWeight(){let e=this._aggregationWeightElement.value,t=this._aggregationFunc;if(e===`none`)this._aggregationWeightColumn=void 0,this._aggregationFunc===`weightedaverage`&&(this._aggregationFunc=`average`);else{let t,n;for(let r of this.measureColumns??[]){let i=r.columns?.find(t=>t.id===e);if(i){t=i,n=r.datasetId;break}}t&&(this._aggregationWeightColumn={column:t.id,set:n,columnSubType:t.subtype}),this._aggregationFunc===`average`&&(this._aggregationFunc=`weightedaverage`)}this._sendEvent(),this.requestUpdate(),(t===`weightedaverage`&&this._aggregationFunc===`average`||t===`average`&&this._aggregationFunc===`weightedaverage`)&&this.requestUpdate()}_setDurationLevels(){let e=this._durationLevels,t=this._durationLevelsElement.value.split(`,`).filter(e=>e!==``).map(e=>Number.parseInt(e,10));this._durationLevels=(t?.length??0)>=1?t:e,this._maxDurationLevel=Math.min(...this._durationLevels),this._fillTimeDurationLevels(),this._setNumericFormat(),this._sendEvent(),this.requestUpdate()}_setDurationFormat(){this._durationFormat=this._durationFormatElement?.selected?.[0],this._fillTimeDurationLevels(),this._setNumericFormat(),this._sendEvent(),this.requestUpdate()}_fillTimeDurationLevels(){if(this._durationFormat===`time`){let e=this._durationLevels.sort().at(-1);if([7,8,9].includes(e)){for(let t of{lev7:[6],lev8:[6,7],lev9:[6,7,8]}[`lev`+e])this._durationLevels.includes(t)||this._durationLevels.push(t);this._durationLevels=[...this._durationLevels].sort()}}}willUpdate(e){super.willUpdate(e),e.has(`slotContent`)&&(this._parseSavedNumericFormatSettings(),this._aggregationFunc=this.slotContent?.aggregationFunc??(this.slotContent?.type===`numeric`?`sum`:`count`),this._aggregationWeightColumn=this.slotContent?.aggregationWeight,this._isFormula=this.slotContent?.formula||this.slotContent?.formulaId)}_renderDurationLevelsSettings(){let e=g.levels.map(e=>{let t=!1;return this._durationFormat===`time`&&e.level>=6&&this._durationLevels.includes(e.level)&&e.level!==Math.max(...this._durationLevels)&&(t=!0),this._durationLevels.length===1&&this._durationLevels.includes(e.level)&&(t=!0),c.html`<luzmo-menu-item
+        value=${e.level}
+        ?selected=${this._durationLevels.includes(e.level)}
+        ?disabled=${t}
+      >
+        ${e.label}
+      </luzmo-menu-item>`});return c.html` <div class="setting">
+      <luzmo-field-label .size=${this.size} for="duration-levels">
+        ${(0,u.msg)(`Duration levels`,{desc:`Label for duration levels setting`})}
+      </luzmo-field-label>
+      <luzmo-action-button id="duration-levels-trigger" size=${this.size} aria-haspopup="true" aria-expanded=${this._renderDurationLevelMenu?`true`:`false`}>
+        ${this._durationLevels.length}
+        ${this._durationLevels.length===1?(0,u.msg)(`level`,{desc:`Singular form of level for duration levels`}):(0,u.msg)(`levels`,{desc:`Plural form of level for duration levels`})} ${(0,u.msg)(`active`,{desc:`Active suffix for duration levels count`})}
+        <span class="duration-angle-down-icon">
+          ${(0,o.luzmoIcon)(o.luzmoAngleDown)}
+        </span>
+      </luzmo-action-button>
+      <luzmo-overlay
+        id="duration-levels-overlay"
+        trigger="duration-levels-trigger@click"
+        type="auto"
+        placement="bottom-start"
+        type="page"
+        @slottable-request=${this._handleSlottableRequest}
+      >
+        <luzmo-popover style="position: relative">
+          ${this._renderDurationLevelMenu?c.html` <luzmo-menu
+                id="duration-levels"
+                size=${this.size}
+                selects="multiple"
+                .value=${this._durationLevels.join(`,`)}
+                @change=${this._setDurationLevels}
+              >
+                ${e}
+              </luzmo-menu>`:``}
+        </luzmo-popover>
+      </luzmo-overlay>
+    </div>`}_renderDurationFormatSettings(){let e=Object.keys(m).map(e=>e===`time`&&(this._maxDurationLevel??1)<6?``:c.html`<luzmo-action-button value=${e}>
+        ${m[e]()}
+      </luzmo-action-button>`);return c.html` <div class="setting">
+      <luzmo-field-label .size=${this.size} for="duration-format">
+        ${(0,u.msg)(`Format`,{desc:`Label for format setting`})}
+      </luzmo-field-label>
+      <luzmo-action-group
+        emphasized
+        id="duration-format"
+        size=${this.size}
+        compact=""
+        .selected=${[this._durationFormat??`short`]}
+        selects="single"
+        @change=${this._setDurationFormat}
+      >
+        ${e}
+      </luzmo-action-group>
+    </div>`}_renderNumericDisplayAsSettings(){let e=Object.keys(p).filter(e=>e!==`percentage`||(this.slotContent.subtype!==`currency`||this.slotContent.aggregationFunc===`rate`)&&this.slotContent.periodOverPeriod?.type!==`percentageChange`).map(e=>c.html`<luzmo-action-button value=${e}
+            >${p[e]}</luzmo-action-button
+          >`);return c.html`<div class="setting">
+      <luzmo-field-label .size=${this.size} for="display-as">
+        ${(0,u.msg)(`Display as`,{desc:`Label for display as setting for the datetime field`})}
+      </luzmo-field-label>
+      <luzmo-action-group
+        emphasized
+        id="display-as"
+        size=${this.size}
+        compact=""
+        .selected=${[this._displayAs]}
+        selects="single"
+        @change=${this._setNumericDisplayAs}
+      >
+        ${e}
+      </luzmo-action-group>
+    </div>`}_renderNumericFormatSettings(){let e=Object.entries(h).filter(([,{hiddenFor:e}])=>!e||e!==this._displayAs).map(([e,{label:t}])=>c.html`<luzmo-menu-item value=${e}>${t()}</luzmo-menu-item>`);return c.html` <div class="setting">
+        <luzmo-field-label .size=${this.size} for="format">
+          ${(0,u.msg)(`Format`,{desc:`Label for format setting`})}
+        </luzmo-field-label>
+        <luzmo-picker
+          id="format"
+          size=${this.size}
+          variant="highlight"
+          value=${this._numericFormatGroup??`Auto`}
+          @change=${this._setNumericSeparators}
+        >
+          ${e}
+        </luzmo-picker>
+      </div>
+      <div class="setting">
+        <luzmo-field-label .size=${this.size} for="precision" id="precision-label">
+          ${this._displayAs===`scientific`?(0,u.msg)(`Precision`,{desc:`Label for precision setting`}):(0,u.msg)(`Decimals`,{desc:`Label for decimals setting`})}
+        </luzmo-field-label>
+        <luzmo-number-field
+          id="precision"
+          label=${this._displayAs===`scientific`?(0,u.msg)(`Precision`,{desc:`Label for precision setting`}):(0,u.msg)(`Decimals`,{desc:`Label for decimals setting`})}
+          min=${+(this._displayAs===`scientific`)}
+          max="22"
+          size=${this.size}
+          value=${this._precision??+(this._displayAs===`scientific`)}
+          @change=${this._setPrecision}
+        ></luzmo-number-field>
+      </div>`}_renderAggregationSettings(){let e=Object.entries(f).filter(([e])=>[`count`,`distinctcount`].includes(e)||this.slotContent?.type===`numeric`).filter(([e])=>e!==`cumulativesum`||this.isCumulativeSumEnabled).map(([e,t])=>c.html`<luzmo-menu-item value=${e}>${t()}</luzmo-menu-item>`),t=[c.html`
+        <luzmo-menu-item
+          value="none"
+          class="no-weight"
+        >
+          <span class="no-weight-label">${(0,u.msg)(`No weight`,{desc:`Label for no weight option`})}</span>
+        </luzmo-menu-item>
+      `,...(this.measureColumns??[]).flatMap(e=>{let t=typeof e.datasetName==`object`?i.t(e.datasetName,this.language):e.datasetName;return[c.html`<div class="dataset-header" role="group" aria-label=${t}>
+          ${t}
+          <luzmo-tooltip self-managed placement="right" size=${this.size}>
+            ${t}
+          </luzmo-tooltip>
+        </div>`,...(e.columns??[]).map(e=>{let t=typeof e.name==`object`?i.t(e.name,this.language):e.name,n=(0,o.luzmoIcon)(r.t(e,`s`)),a=e.expression?o.luzmoTypeDerived12:void 0,s=!!a,l=s?c.html`<span class="secondary-icon"
+                >${(0,o.luzmoIcon)(a)}</span
+              >`:c.nothing;return c.html`<luzmo-menu-item value=${e.id}>
+            <span class="data-icon-type" slot="icon">
+              <span class=${s?`with-secondary-icon`:``}
+                >${n}</span
+              >
+              ${l}
+            </span>
+            <span class="column-label text-truncate">${t}</span>
+            <luzmo-tooltip self-managed placement="right" size=${this.size}>
+              ${t}
+            </luzmo-tooltip>
+          </luzmo-menu-item>`})]})];return c.html`<div class="settings-row">
+      <div class="setting">
+        <luzmo-field-label .size=${this.size} for="aggregation">
+          ${(0,u.msg)(`Aggregation`,{desc:`Label for aggregation setting`})}
+        </luzmo-field-label>
+        <luzmo-picker
+          id="aggregation"
+          size=${this.size}
+          variant="highlight"
+          value=${(()=>{let e=this.slotContent?.type===`numeric`?`sum`:`count`;return this._aggregationFunc===`weightedaverage`?`average`:this._aggregationFunc??e})()}
+          @change=${this._setAggregationFunc}
+        >
+          ${e}
+        </luzmo-picker>
+      </div>
+      ${[`rate`,`average`,`weightedaverage`].includes(this._aggregationFunc??``)?c.html`<div class="setting">
+            <luzmo-field-label .size=${this.size} for="weighting-column">
+              ${this._aggregationFunc===`rate`?(0,u.msg)(`Denominator`,{desc:`Label for denominator field`}):(0,u.msg)(`Weight`,{desc:`Label for weight field`})}
+            </luzmo-field-label>
+            ${this.measureColumns.length>0?c.html`
+                  <luzmo-picker
+                    id="weighting-column"
+                    size=${this.size}
+                    variant="highlight"
+                    icons="none"
+                    value=${this._aggregationWeightColumn?.column??`none`}
+                    @change=${this._setAggregationWeight}
+                  >
+                    ${t}
+                  </luzmo-picker>
+                `:c.html`<luzmo-picker
+                  id="weighting-column"
+                  size=${this.size}
+                  variant="highlight"
+                  icons="none"
+                  value="none"
+                >
+                  <luzmo-menu-item value="none">${(0,u.msg)(`No weight`,{desc:`Label for no weight option`})}</luzmo-menu-item>
+                </luzmo-picker>`}
+          </div>`:``}
+    </div>`}render(){return c.html`<div class="settings-container">
+      <div class="settings-row">
+      ${this._displayMode===`duration`?this._renderDurationLevelsSettings():this._renderNumericDisplayAsSettings()}
+      ${this._durationLevels?.length>1?this._renderDurationFormatSettings():this._renderNumericFormatSettings()}
+      </div>
+      ${this._isFormula||this.isAggregationDisabled?c.nothing:this._renderAggregationSettings()}
+      </div>
+    </div>`}};t.t([(0,l.property)({type:Object,attribute:!1})],_.prototype,`slotContent`,void 0),t.t([(0,l.property)({type:Array,reflect:!1})],_.prototype,`measureColumns`,void 0),t.t([(0,l.property)({type:Boolean})],_.prototype,`isAggregationDisabled`,void 0),t.t([(0,l.property)({type:Boolean})],_.prototype,`isCumulativeSumEnabled`,void 0),t.t([(0,l.query)(`#display-as`)],_.prototype,`_displayAsElement`,void 0),t.t([(0,l.query)(`#precision`)],_.prototype,`_precisionElement`,void 0),t.t([(0,l.query)(`#aggregation`)],_.prototype,`_aggregationElement`,void 0),t.t([(0,l.query)(`#weighting-column`)],_.prototype,`_aggregationWeightElement`,void 0),t.t([(0,l.query)(`#duration-levels`)],_.prototype,`_durationLevelsElement`,void 0),t.t([(0,l.query)(`#duration-format`)],_.prototype,`_durationFormatElement`,void 0),t.t([(0,l.state)()],_.prototype,`_renderDurationLevelMenu`,void 0),_=t.t([(0,u.localized)()],_),customElements.get(`luzmo-display-settings-numeric`)||customElements.define(`luzmo-display-settings-numeric`,_),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return _}});

package/components/display-settings-period-over-period/display-settings-period-over-period.d.ts

@@ -0,0 +1,68 @@
+import { Column } from '@luzmo/dashboard-contents-types';
+import '@luzmo/lucero/accordion';
+import '@luzmo/lucero/action-button';
+import '@luzmo/lucero/action-group';
+import '@luzmo/lucero/checkbox';
+import '@luzmo/lucero/field-label';
+import '@luzmo/lucero/menu';
+import '@luzmo/lucero/number-field';
+import '@luzmo/lucero/picker';
+import { LuzmoElement } from '../../utils/base';
+import { CSSResultArray, PropertyValues, TemplateResult } from 'lit';
+import { PeriodOverPeriodCondition } from '../../utils/time/period-over-period-condition.const';
+declare const LuzmoDisplaySettingsPeriodOverPeriod_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement & {
+    new (...args: any[]): import("../../utils/base/sized-mixin").SizedElementInterface;
+    prototype: import("../../utils/base/sized-mixin").SizedElementInterface;
+};
+/**
+ * @customElement luzmo-display-settings-period-over-period
+ * @fires {CustomEvent<DisplaySettingsSlotContentChangedEventDetail>} luzmo-slot-content-changed - Event that is fired when the slot content is changed
+ */
+export declare class LuzmoDisplaySettingsPeriodOverPeriod extends LuzmoDisplaySettingsPeriodOverPeriod_base {
+    static get styles(): CSSResultArray;
+    /**
+     * The slotContent that is passed to the settings
+     */
+    slotContent: any;
+    /** Which period-over-period UI variant to render, based on available datetime columns and comparison filters. */
+    periodOverPeriodUiType: PeriodOverPeriodCondition;
+    /** Datetime columns from the linked dataset available as offset/comparison date columns. */
+    linkedDatasetDatetimeColumns: (Column & {
+        datasetId: string;
+    })[];
+    private _periodComparisonElement;
+    private _numberPeriodsElement;
+    private _periodLevelElement;
+    private _offsetDateColumnElement;
+    private _incompletePeriodsElement;
+    private _periodComparison?;
+    private _rangeType?;
+    private _numberPeriods?;
+    private _periodLevel?;
+    private _incompletePeriods?;
+    private _minLevel?;
+    private _offsetDateColumn?;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    private setPeriodComparison;
+    private setNumberOfPeriods;
+    private setPeriodLevel;
+    private setOffsetDateColumn;
+    private setIncompletePeriods;
+    private setRangeType;
+    private sendEvent;
+    private incompletePeriodsSetting;
+    private relativeOffsetSetting;
+    private rangeTypeSetting;
+    private _handleRangeTypeClick;
+    private offsetDateColumnSetting;
+    private typeOfComparisonSetting;
+    private renderPeriodSettings;
+    private renderOldUiPeriodSettings;
+    renderOldUi(): TemplateResult;
+    protected render(): TemplateResult;
+    private needsOffsetDatetimeColumn;
+    private setInitialOffsetDateColumn;
+}
+export {};

package/components/display-settings-period-over-period/helpers/constants.d.ts

@@ -0,0 +1,44 @@
+export declare const PERIOD_OVER_PERIOD_VALUES: Record<PeriodOverPeriodType, () => string>;
+export declare const LEVEL_LIST: {
+    key: string;
+    i18n: () => string;
+}[];
+export declare enum RangeTypeListKeys {
+    Relative = "relative",
+    UserDefined = "user-defined"
+}
+export declare const RANGE_TYPE_LIST: {
+    key: RangeTypeListKeys;
+    i18n: () => string;
+}[];
+/**
+ * Period over period comparison type:
+ * 'none' - turned off,
+ * 'past' - absolute value comparison to the past,
+ * 'absoluteChange' - absolute change comparison to the past,
+ * 'percentageChange' - percentage change comparison to the past
+ */
+export type PeriodOverPeriodType = 'none' | 'past' | 'absoluteChange' | 'percentageChange';
+export interface PeriodOverPeriod {
+    /**
+     * Period over period comparison type
+     */
+    type: PeriodOverPeriodType;
+    /**
+     * Period of time level
+     * 0 - period, 1 - year, 2 - quarter, 3 - month, 4 - week, 5 - day... 9 - millisecond
+     */
+    level: number;
+    /**
+     * Number of periods
+     */
+    quantity: number;
+    /**
+     * Turn ON/OFF period to date comparison
+     */
+    periodToDate: boolean;
+    /**
+     * Category date level to disallow smaller Period-Over-Period levels. For internal use only
+     */
+    minLevel: number;
+}

package/components/display-settings-period-over-period/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("../display-settings-period-over-period-BG9YAcCw.cjs");Object.defineProperty(exports,"LuzmoDisplaySettingsPeriodOverPeriod",{enumerable:!0,get:function(){return e.t}});

package/components/display-settings-period-over-period/index.d.ts

@@ -0,0 +1,8 @@
+import { LuzmoDisplaySettingsPeriodOverPeriod } from './display-settings-period-over-period';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-display-settings-period-over-period': LuzmoDisplaySettingsPeriodOverPeriod;
+    }
+}
+export { LuzmoDisplaySettingsPeriodOverPeriod } from './display-settings-period-over-period';
+export type { DisplaySettingsSlotContentChangedEventDetail } from '../display-settings/types';

package/components/display-settings-period-over-period/index.js

@@ -0,0 +1,28 @@
+/*! * 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.
+ * */
+// Auto-generated initialization code
+(function() {
+	if (typeof document < "u" && !document.querySelector("style[data-luzmo-vars]")) {
+		let e = document.createElement("style");
+		e.setAttribute("data-luzmo-vars", ""), e.textContent = "html{--luzmo-animation-duration: 0.15s;--luzmo-border-color: rgba(var(--luzmo-border-color-rgb), 0.1);--luzmo-border-color-hover: rgba(var(--luzmo-border-color-rgb), 0.15);--luzmo-border-color-down: rgba(var(--luzmo-border-color-rgb), 0.3);--luzmo-border-color-focus: rgba(var(--luzmo-border-color-rgb), 0.15);--luzmo-border-color-rgb: 0, 0, 0;--luzmo-border-color-full: rgb(180, 180, 180);--luzmo-border-color-full-hover: color-mix(in oklch, var(--luzmo-border-color-full), black 25%);--luzmo-border-color-full-down: color-mix(in oklch, var(--luzmo-border-color-full), black 45%);--luzmo-border-color-full-focus: color-mix(in oklch, var(--luzmo-border-color-full), black 25%);--luzmo-border-color-disabled: #dddddd;--luzmo-border-radius: 6px;--luzmo-border-radius-s: 4px;--luzmo-border-radius-l: 8px;--luzmo-border-radius-xl: 12px;--luzmo-border-radius-full: 999rem;--luzmo-background-color: #ffffff;--luzmo-background-color-rgb: 255, 255, 255;--luzmo-background-color-disabled: #eeeeee;--luzmo-background-color-hover: color-mix( in oklch, color-mix(in oklch, var(--luzmo-background-color), var(--luzmo-primary) 5%), black 1.5% );--luzmo-background-color-down: color-mix(in oklch, color-mix(in oklch, var(--luzmo-background-color), var(--luzmo-primary) 7%), black 1%);--luzmo-background-color-focus: color-mix( in oklch, color-mix(in oklch, var(--luzmo-background-color), var(--luzmo-primary) 5%), black 1.5% );--luzmo-background-color-highlight: rgb(240, 240, 240);--luzmo-background-color-highlight-disabled: rgb(245, 245, 245);--luzmo-background-color-highlight-hover: color-mix(in oklch, var(--luzmo-background-color-highlight), black 10%);--luzmo-background-color-highlight-down: color-mix(in oklch, var(--luzmo-background-color-highlight), black 20%);--luzmo-background-color-highlight-focus: color-mix(in oklch, var(--luzmo-background-color-highlight), black 10%);--luzmo-background-color-alt-1: rgb(250, 250, 250);--luzmo-background-color-alt-2: rgb(239, 239, 239);--luzmo-border-width: 1px;--luzmo-shadow-color-rgb: 0, 0, 0;--luzmo-shadow-opacity: 0.1;--luzmo-shadow-color: rgba(var(--luzmo-shadow-color-rgb), var(--luzmo-shadow-opacity));--luzmo-font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen-Sans, Ubuntu, Cantarell, 'Helvetica Neue', Helvetica, Arial, sans-serif;--luzmo-font-size-xs: 10px;--luzmo-font-size-s: 12px;--luzmo-font-size-m: 14px;--luzmo-font-size: 14px;--luzmo-font-size-l: 16px;--luzmo-font-size-xl: 18px;--luzmo-font-size-xxl: 20px;--luzmo-font-style: normal;--luzmo-line-height: normal;--luzmo-font-weight: 400;--luzmo-font-weight-semibold: 500;--luzmo-font-weight-bold: 600;--luzmo-font-color: #333;--luzmo-font-color-hard: #000;--luzmo-font-color-disabled: var(--luzmo-color-disabled);--luzmo-font-color-extra-dimmed: #888;--luzmo-font-color-hover: color-mix(in oklch, var(--luzmo-font-color), black 8%);--luzmo-font-color-down: color-mix(in oklch, var(--luzmo-font-color), black 20%);--luzmo-font-color-focus: color-mix(in oklch, var(--luzmo-font-color), black 8%);--luzmo-scrollbar-size: 6px;--luzmo-scrollbar-width: thin;--luzmo-scrollbar-track-background: transparent;--luzmo-scrollbar-track-border-radius: var(--luzmo-border-radius-s);--luzmo-scrollbar-thumb-background: rgba(var(--luzmo-border-color-rgb), 0.3);--luzmo-scrollbar-thumb-border-radius: var(--luzmo-border-radius-s);--luzmo-scrollbar-thumb-hover-background: rgba(var(--luzmo-border-color-rgb), 0.4);--luzmo-primary: #4434ff;--luzmo-primary-hover: color-mix(in oklch, var(--luzmo-primary), black 8%);--luzmo-primary-down: color-mix(in oklch, var(--luzmo-primary), black 20%);--luzmo-primary-focus: color-mix(in oklch, var(--luzmo-primary), black 8%);--luzmo-primary-inverse-color: #ffffff;--luzmo-primary-rgb: 68, 52, 255;--luzmo-secondary: #ff00ff;--luzmo-secondary-hover: color-mix(in oklch, var(--luzmo-secondary), black 8%);--luzmo-secondary-down: color-mix(in oklch, var(--luzmo-secondary), black 20%);--luzmo-secondary-focus: color-mix(in oklch, var(--luzmo-secondary), black 8%);--luzmo-secondary-inverse-color: #ffffff;--luzmo-secondary-rgb: 255, 0, 255;--luzmo-secondary-outline: rgba(255, 0, 255, 0.2);--luzmo-negative-color: #ca221c;--luzmo-negative-color-hover: color-mix(in oklch, var(--luzmo-negative-color), black 8%);--luzmo-negative-color-down: color-mix(in oklch, var(--luzmo-negative-color), black 20%);--luzmo-negative-color-focus: color-mix(in oklch, var(--luzmo-negative-color), black 8%);--luzmo-negative-color-rgb: 202, 34, 28;--luzmo-positive-color: rgb(20, 150, 101);--luzmo-positive-color-hover: color-mix(in oklch, var(--luzmo-positive-color), black 8%);--luzmo-positive-color-down: color-mix(in oklch, var(--luzmo-positive-color), black 20%);--luzmo-positive-color-focus: color-mix(in oklch, var(--luzmo-positive-color), black 8%);--luzmo-positive-color-rgb: 20, 150, 101;--luzmo-selected-color: rgb(110, 110, 110);--luzmo-selected-color-hover: color-mix(in oklch, var(--luzmo-selected-color), black 25%);--luzmo-selected-color-down: color-mix(in oklch, var(--luzmo-selected-color), black 45%);--luzmo-selected-color-focus: color-mix(in oklch, var(--luzmo-selected-color), black 25%);--luzmo-selected-color-hard: #1e1e1e;--luzmo-selected-color-hard-hover: color-mix(in oklch, var(--luzmo-selected-color-hard), black 25%);--luzmo-selected-color-hard-down: color-mix(in oklch, var(--luzmo-selected-color-hard), black 45%);--luzmo-selected-color-hard-focus: color-mix(in oklch, var(--luzmo-selected-color-hard), black 25%);--luzmo-color-informative: #1a77e9;--luzmo-color-informative-rgb: 26, 119, 233;--luzmo-color-disabled: #aaaaaa;--luzmo-spacing-1: 2px;--luzmo-spacing-2: 4px;--luzmo-spacing-3: 8px;--luzmo-spacing-4: 12px;--luzmo-spacing-5: 16px;--luzmo-indicator-gap: 2px;--luzmo-indicator-width: 1px;--luzmo-indicator-color: var(--luzmo-primary);--luzmo-component-height-xxs: 20px;--luzmo-component-height-xs: 24px;--luzmo-component-height-s: 28px;--luzmo-component-height: 32px;--luzmo-component-height-l: 40px;--luzmo-component-height-xl: 48px;--luzmo-component-height-xxl: 64px;--luzmo-icon-size-xxs: 12px;--luzmo-icon-size-xs: 14px;--luzmo-icon-size-s: 16px;--luzmo-icon-size-m: 18px;--luzmo-icon-size-l: 20px;--luzmo-icon-size-xl: 22px;--luzmo-icon-size-xxl: 32px}", document.head.appendChild(e);
+	}
+})();
+import { t as e } from "../display-settings-period-over-period-B8UNYZ0I.js";
+export { e as LuzmoDisplaySettingsPeriodOverPeriod };