@luzmo/analytics-components-kit 1.0.1-alpha.96 → 1.0.1-alpha.98

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

@@ -0,0 +1,184 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2025 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.
+ * */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("@lit/localize");require("@luzmo/lucero/action-button");require("@luzmo/lucero/action-group");require("@luzmo/lucero/field-label");require("@luzmo/lucero/menu");require("@luzmo/lucero/number-field");require("@luzmo/lucero/picker");require("@luzmo/lucero/popover");const f=require("../decompose-numeric-format-B3rVVHpO.cjs"),o=require("lit"),g=require("@luzmo/icons"),$=require("@luzmo/lucero/overlay");require("@luzmo/lucero/tooltip");const D=require("../calculate-data-item-icon-CEa82-5u.cjs"),y=require("../localize-r7ALOUy_.cjs"),m=require("lit/decorators.js"),N=require("../focusable-B3E_hQmm.cjs"),z=require("../sized-mixin-DcvJLFeo.cjs"),h=require("../set-locale-BRRalqne.cjs"),w=":host .settings-container{display:flex;flex-direction:column;gap:var(--luzmo-display-settings-vertical-gap, var(--luzmo-spacing-2))}:host .settings-row{display:flex;justify-content:flex-start;align-items:center;gap:var(--luzmo-display-settings-numeric-gap, var(--display-settings-numeric-gap))}.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{max-width:100%;font-weight:600;text-transform:uppercase;margin:.5rem 1rem;color:var(--luzmo-font-color);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;cursor:default}.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{position:absolute;bottom:45%;left:60%;width:auto;font-size:.75em;line-height:1}.data-icon-type{width:1.5rem;text-align:center;position:relative;display:inline-block}: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 )}",C={sum:()=>n.msg("Sum",{desc:"Numeric Aggregation option"}),cumulativesum:()=>n.msg("Cumulative sum",{desc:"Numeric Aggregation option"}),average:()=>n.msg("Average",{desc:"Numeric Aggregation option"}),median:()=>n.msg("Median",{desc:"Numeric Aggregation option"}),count:()=>n.msg("Count rows",{desc:"Numeric Aggregation option"}),distinctcount:()=>n.msg("Count distinct",{desc:"Numeric Aggregation option"}),min:()=>n.msg("Minimum",{desc:"Numeric Aggregation option"}),max:()=>n.msg("Maximum",{desc:"Numeric Aggregation option"}),stddev:()=>n.msg("Standard deviation",{desc:"Numeric Aggregation option"}),rate:()=>n.msg("Rate",{desc:"Numeric Aggregation option"})},b={general:"123",percentage:"%",scientific:"SI"},L={time:()=>n.msg("Time",{desc:"Time format option"}),short:()=>n.msg("Short",{desc:"Short format option"}),long:()=>n.msg("Long",{desc:"Long format option"})},S={Auto:{auto:!0,label:()=>n.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:","}},q={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"}]};var E=Object.defineProperty,I=Object.getOwnPropertyDescriptor,u=(d,t,e,i)=>{for(var s=i>1?void 0:i?I(t,e):t,a=d.length-1,r;a>=0;a--)(r=d[a])&&(s=(i?r(t,e,s):r(s))||s);return i&&s&&E(t,e,s),s};exports.LuzmoDisplaySettingsNumeric=class extends z.SizedMixin(N.LuzmoElement,{validSizes:Object.values(z.ElementSizes)}){constructor(){super(...arguments),this.language="en",this.slotContent={},this.measureColumns=[],this._durationLevels=[],this._renderDurationLevelMenu=!1,this._handleSlottableRequest=t=>{this._renderDurationLevelMenu=t.data!==$.removeSlottableRequest},this._sendEvent=()=>{const t={...this.slotContent,format:this._format,aggregationFunc:this._aggregationFunc};this._aggregationWeightColumn?t.aggregationWeight={...this._aggregationWeightColumn}:delete t.aggregationWeight,this._displayMode==="duration"?(t.duration=t.duration??{},t.duration.format=this._durationFormat,t.duration.levels=this._durationLevels):delete t.duration,this.dispatchEvent(new CustomEvent("slot-content-changed",{bubbles:!0,composed:!0,cancelable:!0,detail:{slotContent:t}}))}}static get styles(){return[o.unsafeCSS(w)]}_parseSavedNumericFormatSettings(){var t,e,i,s,a,r,c;if(this._displayMode=((t=this.slotContent)==null?void 0:t.subtype)==="duration"?"duration":"numeric",this._durationFormat=((i=(e=this.slotContent)==null?void 0:e.duration)==null?void 0:i.format)??"short",this._durationLevels=((a=(s=this.slotContent)==null?void 0:s.duration)==null?void 0:a.levels)??[1],this._displayMode==="duration")this._precision=2,this._commaDecimals=!1,this._thousandSeparator=!1;else{this._format=((r=this.slotContent)==null?void 0:r.format)??".0f";const l=f.decomposeNumericFormat(this._format??".0f");this._isAuto=((c=l.typeFormat)==null?void 0:c.includes("a"))??!1,["%","a%","y","ay"].includes(l.typeFormat)?this._displayAs="percentage":["s","as","w","aw"].includes(l.typeFormat)?this._displayAs="scientific":this._displayAs="general",this._precision=l.precision?Number.parseInt(l.precision.replace(".",""),10):this._displayAs==="scientific"?1:0,this._commaDecimals=["z","az","y","ay","w","aw"].includes(l.typeFormat),this._thousandSeparator=l.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(){var t,e;this._displayAs=((e=(t=this._displayAsElement)==null?void 0:t.selected)==null?void 0:e[0])??"general",this._displayAs==="scientific"&&(this._precision=Math.max(this._precision??0,1),this._thousandSeparator=!1),this._setNumericFormat(),this._sendEvent(),this.requestUpdate()}_setNumericSeparators(t){const e=S[(t==null?void 0:t.detail)??"Auto"];this._thousandSeparator=[",","."].includes((e==null?void 0:e.thousandSeparator)??""),this._commaDecimals=(e==null?void 0:e.decimalSeparator)===",",this._isAuto=e==null?void 0:e.auto,this._setNumericFormat(),this._sendEvent()}_setPrecision(){this._precision=this._precisionElement.value,this._setNumericFormat(),this._sendEvent()}_setNumericFormat(){var i;let t="f";const e=this.slotContent.subtype==="duration"?this._durationLevels&&((i=this._durationLevels)==null?void 0:i.length)===1?"numeric":"duration":"numeric";this._maxDurationLevel=Math.min(...this._durationLevels),e==="duration"?(!["time","short","long"].includes(this._durationFormat??"")||this._maxDurationLevel<6&&this._durationFormat==="time")&&(this._durationFormat="short"):(this._displayAs==="general"&&this._commaDecimals?t="z":this._displayAs==="percentage"&&this._commaDecimals?t="y":this._displayAs==="scientific"&&this._commaDecimals?t="w":this._displayAs==="percentage"?t="%":this._displayAs==="scientific"&&(t="s"),this._format=(this._thousandSeparator||this._isAuto?",":"")+"."+this._precision+(this._isAuto?"a":"")+t)}_setAggregationFunc(){var a;const t=this._aggregationElement.value,e=this._aggregationFunc,i=this.slotContent.format;if(t!==(e==="weightedaverage"?"average":e)){if(this._aggregationFunc=t==="average"&&((a=this._aggregationWeightColumn)!=null&&a.column)?"weightedaverage":t,e==="rate"){const r=f.decomposeNumericFormat(i),c=["%","y","a%","ay"].includes(r.typeFormat);this.slotContent.subtype==="currency"&&c&&this._setNumericDisplayAs()}this._sendEvent(),(this._aggregationFunc==="rate"||e==="rate")&&this.requestUpdate()}}_setAggregationWeight(){var i;const t=this._aggregationWeightElement.value,e=this._aggregationFunc;if(t==="none")this._aggregationWeightColumn=void 0,this._aggregationFunc==="weightedaverage"&&(this._aggregationFunc="average");else{let s,a;for(const r of this.measureColumns??[]){const c=(i=r.columns)==null?void 0:i.find(l=>l.id===t);if(c){s=c,a=r.datasetId;break}}s&&(this._aggregationWeightColumn={column:s.id,set:a,columnSubType:s.subtype}),this._aggregationFunc==="average"&&(this._aggregationFunc="weightedaverage")}this._sendEvent(),this.requestUpdate(),(e==="weightedaverage"&&this._aggregationFunc==="average"||e==="average"&&this._aggregationFunc==="weightedaverage")&&this.requestUpdate()}_setDurationLevels(){const t=this._durationLevels,e=this._durationLevelsElement.value.split(",").filter(i=>i!=="").map(i=>Number.parseInt(i,10));this._durationLevels=((e==null?void 0:e.length)??0)>=1?e:t,this._maxDurationLevel=Math.min(...this._durationLevels),this._fillTimeDurationLevels(),this._setNumericFormat(),this._sendEvent(),this.requestUpdate()}_setDurationFormat(){var t,e;this._durationFormat=(e=(t=this._durationFormatElement)==null?void 0:t.selected)==null?void 0:e[0],this._fillTimeDurationLevels(),this._setNumericFormat(),this._sendEvent(),this.requestUpdate()}_fillTimeDurationLevels(){if(this._durationFormat==="time"){const t=this._durationLevels.sort().at(-1);if([7,8,9].includes(t)){const e={lev7:[6],lev8:[6,7],lev9:[6,7,8]};for(const i of e["lev"+t])this._durationLevels.includes(i)||this._durationLevels.push(i);this._durationLevels=[...this._durationLevels].sort()}}}willUpdate(t){var e,i,s,a,r;t.has("slotContent")&&(this._parseSavedNumericFormatSettings(),this._aggregationFunc=((e=this.slotContent)==null?void 0:e.aggregationFunc)??(((i=this.slotContent)==null?void 0:i.type)==="numeric"?"sum":"count"),this._aggregationWeightColumn=(s=this.slotContent)==null?void 0:s.aggregationWeight,this._isFormula=((a=this.slotContent)==null?void 0:a.formula)||((r=this.slotContent)==null?void 0:r.formulaId)),t.has("language")&&this.language!==h.getLocale()&&([...h.targetLocales].includes(this.language??"en")||this.language==="en")&&h.setLocale(this.language)}_renderDurationLevelsSettings(){const t=q.levels.map(e=>{let i=!1;return this._durationFormat==="time"&&e.level>=6&&this._durationLevels.includes(e.level)&&e.level!==Math.max(...this._durationLevels)&&(i=!0),this._durationLevels.length===1&&this._durationLevels.includes(e.level)&&(i=!0),o.html`<luzmo-menu-item
+        value=${e.level}
+        ?selected=${this._durationLevels.includes(e.level)}
+        ?disabled=${i}
+      >
+        ${e.label}
+      </luzmo-menu-item>`});return o.html` <div class="setting">
+      <luzmo-field-label for="duration-levels">
+        ${n.msg("Duration levels",{desc:"Label for duration levels setting"})}
+      </luzmo-field-label>
+      <luzmo-action-button id="duration-levels-trigger" size=${this.size}>
+        ${this._durationLevels.length}
+        ${this._durationLevels.length===1?"level":"levels"} active
+        <span class="duration-angle-down-icon">
+          ${g.luzmoIcon(g.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?o.html` <luzmo-menu
+                id="duration-levels"
+                size=${this.size}
+                selects="multiple"
+                .value=${this._durationLevels.join(",")}
+                @change=${this._setDurationLevels}
+              >
+                ${t}
+              </luzmo-menu>`:""}
+        </luzmo-popover>
+      </luzmo-overlay>
+    </div>`}_renderDurationFormatSettings(){const t=Object.keys(L).map(e=>e==="time"&&(this._maxDurationLevel??1)<6?"":o.html`<luzmo-action-button value=${e}>
+        ${L[e]()}
+      </luzmo-action-button>`);return o.html` <div class="setting">
+      <luzmo-field-label for="duration-format">
+        ${n.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}
+      >
+        ${t}
+      </luzmo-action-group>
+    </div>`}_renderNumericDisplayAsSettings(){const t=Object.keys(b).filter(e=>{var i;return e!=="percentage"||(this.slotContent.subtype!=="currency"||this.slotContent.aggregationFunc==="rate")&&((i=this.slotContent.periodOverPeriod)==null?void 0:i.type)!=="percentageChange"}).map(e=>o.html`<luzmo-action-button value=${e}
+            >${b[e]}</luzmo-action-button
+          >`);return o.html`<div class="setting">
+      <luzmo-field-label for="display-as">
+        ${n.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}
+      >
+        ${t}
+      </luzmo-action-group>
+    </div>`}_renderNumericFormatSettings(){const t=Object.entries(S).filter(([,{hiddenFor:e}])=>!e||e!==this._displayAs).map(([e,{label:i}])=>o.html`<luzmo-menu-item value=${e}>${i()}</luzmo-menu-item>`);return o.html` <div class="setting">
+        <luzmo-field-label for="format">
+          ${n.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}
+        >
+          ${t}
+        </luzmo-picker>
+      </div>
+      <div class="setting">
+        <luzmo-field-label for="precision" id="precision-label">
+          ${this._displayAs==="scientific"?n.msg("Precision",{desc:"Label for precision setting"}):n.msg("Decimals",{desc:"Label for decimals setting"})}
+        </luzmo-field-label>
+        <luzmo-number-field
+          id="precision"
+          min=${this._displayAs==="scientific"?1:0}
+          max="22"
+          size=${this.size}
+          value=${this._precision??(this._displayAs==="scientific"?1:0)}
+          @change=${this._setPrecision}
+        ></luzmo-number-field>
+      </div>`}_renderAggregationSettings(){var i;const t=Object.entries(C).filter(([s])=>{var a;return["count","distinctcount"].includes(s)||((a=this.slotContent)==null?void 0:a.type)==="numeric"}).filter(([s])=>s!=="cumulativesum"||this.isCumulativeSumEnabled).map(([s,a])=>o.html`<luzmo-menu-item value=${s}>${a()}</luzmo-menu-item>`),e=[o.html`<luzmo-menu-item value="none" class="no-weight">
+        <span class="no-weight-label">No weight</span>
+      </luzmo-menu-item>`,...(this.measureColumns??[]).flatMap(s=>{const a=typeof s.datasetName=="object"?y.localize(s.datasetName,this.language):s.datasetName,r=o.html`<div class="dataset-header">
+          ${a}
+          <luzmo-tooltip self-managed placement="right" size=${this.size}>
+            ${a}
+          </luzmo-tooltip>
+        </div>`,c=(s.columns??[]).map(l=>{const p=typeof l.name=="object"?y.localize(l.name,this.language):l.name,A=g.luzmoIcon(D.calculateDataItemIcon(l,"s")),v=l.expression?g.luzmoTypeDerived12:void 0,_=!!v,F=_?o.html`<span class="secondary-icon"
+                >${g.luzmoIcon(v)}</span
+              >`:o.nothing;return o.html`<luzmo-menu-item value=${l.id}>
+            <span class="data-icon-type" slot="icon">
+              <span class=${_?"with-secondary-icon":""}
+                >${A}</span
+              >
+              ${F}
+            </span>
+            <span class="column-label text-truncate">${p}</span>
+            <luzmo-tooltip self-managed placement="right" size=${this.size}>
+              ${p}
+            </luzmo-tooltip>
+          </luzmo-menu-item>`});return[r,...c]})];return o.html`<div class="settings-row">
+      <div class="setting">
+        <luzmo-field-label for="aggregation">
+          ${n.msg("Aggregation",{desc:"Label for aggregation setting"})}
+        </luzmo-field-label>
+        <luzmo-picker
+          id="aggregation"
+          size=${this.size}
+          variant="highlight"
+          value=${(()=>{var a;const s=((a=this.slotContent)==null?void 0:a.type)==="numeric"?"sum":"count";return this._aggregationFunc==="weightedaverage"?"average":this._aggregationFunc??s})()}
+          @change=${this._setAggregationFunc}
+        >
+          ${t}
+        </luzmo-picker>
+      </div>
+      ${["rate","average","weightedaverage"].includes(this._aggregationFunc??"")?o.html`<div class="setting">
+            <luzmo-field-label for="weighting-column">
+              ${this._aggregationFunc==="rate"?"Denominator":"Weight"}
+            </luzmo-field-label>
+            ${this.measureColumns.length>0?o.html`
+                  <luzmo-picker
+                    id="weighting-column"
+                    size=${this.size}
+                    variant="highlight"
+                    icons="none"
+                    value=${((i=this._aggregationWeightColumn)==null?void 0:i.column)??"none"}
+                    @change=${this._setAggregationWeight}
+                  >
+                    ${e}
+                  </luzmo-picker>
+                `:o.html`<luzmo-picker
+                  id="weighting-column"
+                  size=${this.size}
+                  variant="highlight"
+                  icons="none"
+                  value="none"
+                >
+                  <luzmo-menu-item value="none">No weight</luzmo-menu-item>
+                </luzmo-picker>`}
+          </div>`:""}
+    </div>`}render(){var t;return o.html`<div class="settings-container">
+      <div class="settings-row">
+      ${this._displayMode==="duration"?this._renderDurationLevelsSettings():this._renderNumericDisplayAsSettings()}
+      ${((t=this._durationLevels)==null?void 0:t.length)>1?this._renderDurationFormatSettings():this._renderNumericFormatSettings()}
+      </div>
+      ${this._isFormula||this.isAggregationDisabled?o.nothing:this._renderAggregationSettings()}
+      </div>
+    </div>`}};u([m.property({type:String,reflect:!0})],exports.LuzmoDisplaySettingsNumeric.prototype,"language",2);u([m.property({type:Object,reflect:!0})],exports.LuzmoDisplaySettingsNumeric.prototype,"slotContent",2);u([m.property({type:Array,reflect:!1})],exports.LuzmoDisplaySettingsNumeric.prototype,"measureColumns",2);u([m.property({type:Boolean})],exports.LuzmoDisplaySettingsNumeric.prototype,"isAggregationDisabled",2);u([m.property({type:Boolean})],exports.LuzmoDisplaySettingsNumeric.prototype,"isCumulativeSumEnabled",2);u([m.query("#display-as")],exports.LuzmoDisplaySettingsNumeric.prototype,"_displayAsElement",2);u([m.query("#precision")],exports.LuzmoDisplaySettingsNumeric.prototype,"_precisionElement",2);u([m.query("#aggregation")],exports.LuzmoDisplaySettingsNumeric.prototype,"_aggregationElement",2);u([m.query("#weighting-column")],exports.LuzmoDisplaySettingsNumeric.prototype,"_aggregationWeightElement",2);u([m.query("#duration-levels")],exports.LuzmoDisplaySettingsNumeric.prototype,"_durationLevelsElement",2);u([m.query("#duration-format")],exports.LuzmoDisplaySettingsNumeric.prototype,"_durationFormatElement",2);u([m.state()],exports.LuzmoDisplaySettingsNumeric.prototype,"_renderDurationLevelMenu",2);exports.LuzmoDisplaySettingsNumeric=u([n.localized()],exports.LuzmoDisplaySettingsNumeric);customElements.get("luzmo-display-settings-numeric")||customElements.define("luzmo-display-settings-numeric",exports.LuzmoDisplaySettingsNumeric);

package/components/display-settings-numeric/index.d.ts

@@ -0,0 +1,7 @@
+import { LuzmoDisplaySettingsNumeric } from './display-settings-numeric';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-display-settings-numeric': LuzmoDisplaySettingsNumeric;
+    }
+}
+export { LuzmoDisplaySettingsNumeric } from './display-settings-numeric';

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 'src/types';
+declare const LuzmoDisplaySettingsPeriodOverPeriod_base: typeof LuzmoElement & {
+    new (...args: any[]): import("../../utils/base/sized-mixin").SizedElementInterface;
+    prototype: import("../../utils/base/sized-mixin").SizedElementInterface;
+};
+/**
+ * @element luzmo-display-settings-period-over-period
+ * @fires 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 language used in the settings
+     */
+    language: string;
+    /**
+     * The slotContent that is passed to the settings
+     */
+    slotContent: any;
+    periodOverPeriodUiType: PeriodOverPeriodCondition;
+    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,224 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2025 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.
+ * */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@lit/localize");require("@luzmo/lucero/accordion");require("@luzmo/lucero/action-button");require("@luzmo/lucero/action-group");require("@luzmo/lucero/checkbox");require("@luzmo/lucero/field-label");require("@luzmo/lucero/menu");require("@luzmo/lucero/number-field");require("@luzmo/lucero/picker");const q=require("../focusable-B3E_hQmm.cjs"),w=require("../sized-mixin-DcvJLFeo.cjs"),I=require("../decompose-numeric-format-B3rVVHpO.cjs"),N=require("../localize-r7ALOUy_.cjs"),y=require("../set-locale-BRRalqne.cjs"),o=require("lit"),l=require("lit/decorators.js"),p=require("../types-VPf7E5dD.cjs"),f={none:()=>t.msg("None"),past:()=>t.msg("Past value",{desc:"Period option"}),absoluteChange:()=>t.msg("Absolute change",{desc:"Period option"}),percentageChange:()=>t.msg("% change",{desc:"Period option"})},g=[{key:"periods",i18n:()=>t.msg("Periods",{desc:"Period option"})},{key:"years",i18n:()=>t.msg("Years",{desc:"Period option"})},{key:"quarters",i18n:()=>t.msg("Quarters",{desc:"Period option"})},{key:"months",i18n:()=>t.msg("Months",{desc:"Period option"})},{key:"weeks",i18n:()=>t.msg("Weeks",{desc:"Period option"})},{key:"days",i18n:()=>t.msg("Days",{desc:"Period option"})},{key:"hours",i18n:()=>t.msg("Hours",{desc:"Period option"})},{key:"minutes",i18n:()=>t.msg("Minutes",{desc:"Period option"})},{key:"seconds",i18n:()=>t.msg("Seconds",{desc:"Period option"})}];var z=(m=>(m.Relative="relative",m.UserDefined="user-defined",m))(z||{});const R=[{key:"relative",i18n:()=>t.msg("Relative",{desc:"Range type option"})},{key:"user-defined",i18n:()=>t.msg("User-defined",{desc:"Range type option"})}],U=":host{font-family:var(--luzmo-display-settings-period-over-period-font-family, var(--luzmo-font-family));font-size:var(--luzmo-display-settings-period-over-period-font-size, var(--display-settings-period-over-period-font-size));color:var(--luzmo-display-settings-period-over-period-color, var(--luzmo-font-color))}:host .settings-container{display:flex;flex-direction:column;gap:var(--luzmo-display-settings-vertical-gap, 0)}:host .settings-container:first-of-type{margin-right:var(--luzmo-spacing-4)}:host .settings-row{display:flex;justify-content:flex-start;align-items:center;gap:var(--luzmo-display-settings-period-over-period-gap, var(--display-settings-period-over-period-gap))}:host .wrap{flex-wrap:wrap}:host .setting.period-number-setting{display:flex;align-items:center}:host .dynamic-settings-container{max-width:var(--luzmo-display-setting-period-over-period-dynamic-max-width, var(--display-setting-period-over-period-dynamic-max-width))}:host luzmo-accordion{--luzmo-accordion-item-content-area-top-to-content: 0;--luzmo-accordion-item-content-padding-left: var(--luzmo-spacing-1);--luzmo-accordion-item-header-bottom-margin: 0;--luzmo-accordion-item-content-area-bottom-to-content: var(--luzmo-spacing-2);--accordion-item-header-font-size: var( --luzmo-display-settings-period-over-period-font-size, var(--display-settings-period-over-period-font-size) );--accordion-item-content-font-size: var( --luzmo-display-settings-period-over-period-font-size, var(--display-settings-period-over-period-font-size) );--field-label-font-size: var( --luzmo-display-settings-period-over-period-font-size, var(--display-settings-period-over-period-font-size) )}:host .label-container{display:flex;align-items:center;gap:var(--luzmo-spacing-2)}:host .academy-link{color:var(--luzmo-link-color);text-decoration:none;font-size:var(--luzmo-font-size-s);margin-left:var(--luzmo-spacing-2)}:host .academy-link:hover{color:var(--luzmo-link-color-hover)}:host(:focus){--luzmo-menu-item-label-icon-color-focus: var( --luzmo-menu-item-label-icon-color-focus, var(--luzmo-font-color) )}luzmo-menu-item{--luzmo-menu-item-tooltip-font-size: var( --luzmo-display-settings-tooltip-font-size )}luzmo-field-label{--field-label-font-size: var( --luzmo-display-settings-period-over-period-font-size, var(--display-settings-period-over-period-font-size) )}luzmo-checkbox{--checkbox-font-size: var( --luzmo-display-settings-period-over-period-font-size, var(--display-settings-period-over-period-font-size) )}luzmo-picker{--picker-font-size: var( --luzmo-display-settings-period-over-period-font-size, var(--display-settings-period-over-period-font-size) )}luzmo-number-field{--text-field-placeholder-font-size: var( --luzmo-display-settings-period-over-period-font-size, var(--display-settings-period-over-period-font-size) );--stepper-button-font-size: var( --luzmo-display-settings-period-over-period-font-size, var(--display-settings-period-over-period-font-size) )}:host{--display-settings-period-over-period-gap: var(--luzmo-spacing-3);--display-settings-period-over-period-font-size: var(--luzmo-font-size);--display-setting-period-over-period-dynamic-max-width: 22rem}:host([size=xs]){--display-settings-period-over-period-gap: var(--luzmo-spacing-2);--display-settings-period-over-period-font-size: var(--luzmo-font-size-xs);--display-setting-period-over-period-dynamic-max-width: 17rem}:host([size=s]){--display-settings-period-over-period-gap: var(--luzmo-spacing-3);--display-settings-period-over-period-font-size: var(--luzmo-font-size-s);--display-setting-period-over-period-dynamic-max-width: 19rem}:host([size=l]){--display-settings-period-over-period-gap: var(--luzmo-spacing-4);--display-settings-period-over-period-font-size: var(--luzmo-font-size-l);--display-setting-period-over-period-dynamic-max-width: 26rem}:host([size=xl]){--display-settings-period-over-period-gap: var(--luzmo-spacing-5);--display-settings-period-over-period-font-size: var(--luzmo-font-size-xl);--display-setting-period-over-period-dynamic-max-width: 30rem}";var F=Object.defineProperty,j=Object.getOwnPropertyDescriptor,n=(m,i,e,s)=>{for(var r=s>1?void 0:s?j(i,e):i,a=m.length-1,d;a>=0;a--)(d=m[a])&&(r=(s?d(i,e,r):d(r))||r);return s&&r&&F(i,e,r),r};exports.LuzmoDisplaySettingsPeriodOverPeriod=class extends w.SizedMixin(q.LuzmoElement,{validSizes:Object.values(w.ElementSizes)}){constructor(){super(...arguments),this.language="en",this.slotContent={},this.linkedDatasetDatetimeColumns=[],this.needsOffsetDatetimeColumn=()=>this.periodOverPeriodUiType===p.PeriodOverPeriodCondition.NoDatetimeColumnButComparisonFilters||this.periodOverPeriodUiType===p.PeriodOverPeriodCondition.NoDatetimeColumnAndNoComparisonFilters}static get styles(){return[o.unsafeCSS(U)]}willUpdate(i){var e,s,r,a,d,c,u,h,P,C,b,$,_,O,D,S,k,L,x,T,E;if(i.has("slotContent")){this._periodComparison=(s=(e=this.slotContent)==null?void 0:e.periodOverPeriod)==null?void 0:s.type,this._numberPeriods=(a=(r=this.slotContent)==null?void 0:r.periodOverPeriod)==null?void 0:a.quantity;const v=(c=(d=this.slotContent)==null?void 0:d.periodOverPeriod)==null?void 0:c.level;this._periodLevel=typeof v=="number"&&v>=0&&v<g.length?g[v].key:((h=(u=this.slotContent)==null?void 0:u.periodOverPeriod)==null?void 0:h.level)||"periods",this._incompletePeriods=(C=(P=this.slotContent)==null?void 0:P.periodOverPeriod)==null?void 0:C.periodToDate,this._offsetDateColumn=($=(b=this.slotContent)==null?void 0:b.periodOverPeriod)==null?void 0:$.offsetDateColumn,this._minLevel=((O=(_=this.slotContent)==null?void 0:_.periodOverPeriod)==null?void 0:O.minLevel)??((k=(S=(D=this.slotContent)==null?void 0:D.periodOverPeriod)==null?void 0:S.offsetDateColumn)==null?void 0:k.lowestLevel)??((L=this.slotContent)==null?void 0:L.lowestLevel)??(((x=this.slotContent)==null?void 0:x.subtype)==="date"?5:9),this._rangeType=(E=(T=this.slotContent)==null?void 0:T.periodOverPeriod)==null?void 0:E.rangeType}this._periodComparison=this._periodComparison??"none",this._numberPeriods=this._numberPeriods??1,this._periodLevel=this._periodLevel??"periods",this._incompletePeriods=this._incompletePeriods??!1,this._minLevel=this._minLevel??9,this._rangeType=this._rangeType??z.Relative,this._offsetDateColumn=this._offsetDateColumn||void 0,i.has("language")&&this.language!==y.getLocale()&&([...y.targetLocales].includes(this.language??"en")||this.language==="en")&&y.setLocale(this.language)}setPeriodComparison(){var h;const i={...this.slotContent};this.setInitialOffsetDateColumn(i),this._periodComparison=this._periodComparisonElement.value;const e=I.decomposeNumericFormat((h=this.slotContent)==null?void 0:h.format),s=["%","y","a%","ay"].includes(e.typeFormat),r=e.typeFormat.includes("a"),a=r?"a":"",d=e.comma===","||r?",":"",c=e.precision?Number.parseInt(e.precision.replace(".",""),10):0,u=["z","az","y","ay","w","aw"].includes(e.typeFormat);this._periodComparison==="percentageChange"&&!s?i.format=`${d}.${c}${a}${u?"y":"%"}`:this._periodComparison!=="percentageChange"&&i.subtype==="currency"&&s&&(i.format=`${d}.${c}${a}${u?"z":"f"}`),this.sendEvent(i)}setNumberOfPeriods(){this._numberPeriods=Number.parseInt(this._numberPeriodsElement.value,10);const i={...this.slotContent};this.sendEvent(i)}setPeriodLevel(){this._periodLevel=this._periodLevelElement.value;const i={...this.slotContent};this.sendEvent(i)}setOffsetDateColumn(){this._offsetDateColumn=this.linkedDatasetDatetimeColumns.find(e=>e.id===this._offsetDateColumnElement.value);const i={...this.slotContent};this.sendEvent(i)}setIncompletePeriods(){this._incompletePeriods=this._incompletePeriodsElement.checked;const i={...this.slotContent};this.sendEvent(i)}setRangeType(i){this._rangeType=i;const e={...this.slotContent};this.setInitialOffsetDateColumn(e),this.sendEvent(e)}sendEvent(i){const e={...i},s=g.findIndex(r=>r.key===this._periodLevel);e.periodOverPeriod={...i.periodOverPeriod,type:this._periodComparison,level:Math.max(s,0),quantity:this._numberPeriods,periodToDate:this._incompletePeriods,minLevel:this._minLevel,rangeType:this._rangeType,offsetDateColumn:this._offsetDateColumn},this._periodComparison==="none"&&delete e.periodOverPeriod,this.dispatchEvent(new CustomEvent("slot-content-changed",{bubbles:!0,composed:!0,cancelable:!0,detail:{slotContent:e}}))}incompletePeriodsSetting(){return o.html`
+      <div class="settings-row">
+        <div class="setting">
+          <luzmo-checkbox
+            id="incomplete-periods"
+            size=${this.size}
+            emphasized
+            ?checked=${this._incompletePeriods??!1}
+            @change=${this.setIncompletePeriods}
+          >
+            ${t.msg("Use period-to-date for incomplete periods",{desc:"Checkbox label for incomplete periods"})}
+          </luzmo-checkbox>
+        </div>
+      </div>
+    `}relativeOffsetSetting(){const i=g.slice(this.needsOffsetDatetimeColumn()?1:0,(this._minLevel??0)+1).map(e=>o.html`<luzmo-menu-item
+        value=${e.key}
+        tooltip=${e.key==="periods"?t.msg("Matches the date range visible in the chart or table",{desc:"Tooltip for periods"}):""}
+      >
+        ${e.i18n()}
+      </luzmo-menu-item>`);return o.html`
+      <div class="settings-container">
+        <luzmo-field-label for="period-comparison">
+          ${t.msg("Relative offset",{desc:"Label for relative offset"})}
+        </luzmo-field-label>
+
+        <div class="settings-row">
+          <div class="setting period-number-setting">
+            <luzmo-number-field
+              id="number-periods"
+              min="1"
+              size=${this.size}
+              max="9999999999"
+              value=${this._numberPeriods??1}
+              @change=${this.setNumberOfPeriods}
+            ></luzmo-number-field>
+          </div>
+
+          <div class="setting">
+            <luzmo-picker
+              id="period-level"
+              size=${this.size}
+              variant="highlight"
+              value=${this._periodLevel??"periods"}
+              @change=${this.setPeriodLevel}
+            >
+              ${i}
+            </luzmo-picker>
+          </div>
+        </div>
+      </div>
+    `}rangeTypeSetting(){const i=R.map(e=>o.html`<luzmo-action-button
+        data-range-type=${e.key}
+        @click=${this._handleRangeTypeClick}
+      >
+        ${e.i18n()}
+      </luzmo-action-button>`);return o.html`
+      <div class="settings-container">
+        <luzmo-field-label for="range-type">
+          ${t.msg("Range type",{desc:"Label for range type"})}
+        </luzmo-field-label>
+
+        <luzmo-action-group
+          size=${this.size}
+          compact
+          ?emphasized=${!0}
+          selected=${JSON.stringify([this._rangeType])}
+          selects="single"
+        >
+          ${i}
+        </luzmo-action-group>
+      </div>
+    `}_handleRangeTypeClick(i){var r;const e=i.currentTarget,s=(r=e==null?void 0:e.dataset)==null?void 0:r.rangeType;s&&this.setRangeType(s)}offsetDateColumnSetting(){var e;const i=this.linkedDatasetDatetimeColumns.map(s=>o.html`<luzmo-menu-item value=${s.id}>
+          ${N.localize(s.name,this.language)}
+        </luzmo-menu-item>`);return o.html`
+      <div class="settings-container">
+        <luzmo-field-label for="offset-date-column">
+          ${t.msg("Offset date column",{desc:"Label for offset date column"})}
+        </luzmo-field-label>
+
+        <div class="setting">
+          <luzmo-picker
+            id="offset-date-column"
+            size=${this.size}
+            variant="highlight"
+            value=${(e=this._offsetDateColumn)==null?void 0:e.id}
+            @change=${this.setOffsetDateColumn}
+          >
+            ${i}
+          </luzmo-picker>
+        </div>
+      </div>
+    `}typeOfComparisonSetting(){const i=Object.keys(f).map(e=>o.html`<luzmo-menu-item value=${e}>
+          ${f[e]()}
+        </luzmo-menu-item>`);return o.html`<div class="settings-container">
+      <luzmo-field-label for="period-comparison">
+        ${t.msg("Show")}
+      </luzmo-field-label>
+      <luzmo-picker
+        id="period-comparison"
+        size=${this.size}
+        variant="highlight"
+        value=${this._periodComparison??"none"}
+        @change=${this.setPeriodComparison}
+      >
+        ${i}
+      </luzmo-picker>
+    </div>`}renderPeriodSettings(){var e;const i={[p.PeriodOverPeriodCondition.HasDatetimeColumnAndNoComparisonFilters]:()=>o.html`
+            ${this.relativeOffsetSetting()} ${this.incompletePeriodsSetting()}
+          `,[p.PeriodOverPeriodCondition.NoDatetimeColumnAndNoComparisonFilters]:()=>o.html`
+            ${this.relativeOffsetSetting()} ${this.offsetDateColumnSetting()}
+            ${this.incompletePeriodsSetting()}
+          `,[p.PeriodOverPeriodCondition.HasDatetimeColumnAndComparisonFilters]:()=>this._rangeType===z.Relative?o.html`${this.rangeTypeSetting()} ${this.relativeOffsetSetting()}
+          ${this.incompletePeriodsSetting()} `:o.html` ${this.rangeTypeSetting()} `,[p.PeriodOverPeriodCondition.NoDatetimeColumnButComparisonFilters]:()=>this._rangeType===z.Relative?o.html`
+            ${this.rangeTypeSetting()} ${this.relativeOffsetSetting()}
+            ${this.offsetDateColumnSetting()} ${this.incompletePeriodsSetting()}
+          `:o.html` ${this.rangeTypeSetting()} `,[p.PeriodOverPeriodCondition.OldImplementation]:()=>""};return((e=i[this.periodOverPeriodUiType])==null?void 0:e.call(i))??""}renderOldUiPeriodSettings(){const i=g.slice(0,(this._minLevel??0)+1).map(e=>o.html`<luzmo-menu-item
+          value=${e.key}
+          tooltip=${e.key==="periods"?t.msg("Matches the date range visible in the chart or table",{desc:"Tooltip for periods"}):""}
+        >
+          ${e.i18n()}
+        </luzmo-menu-item>`);return o.html` <div class="settings-row">
+        <div class="setting period-number-setting">
+          ${["percentageChange","absoluteChange"].includes(this._periodComparison??"")?o.html`<luzmo-field-label for="number-periods" side-aligned="start">
+                ${t.msg("From",{desc:"Label for number of periods"})}
+              </luzmo-field-label>`:""}
+          <luzmo-number-field
+            id="number-periods"
+            min="1"
+            size=${this.size}
+            max="9999999999"
+            value=${this._numberPeriods??1}
+            @change=${this.setNumberOfPeriods}
+          ></luzmo-number-field>
+        </div>
+        <div class="setting">
+          <luzmo-picker
+            id="period-level"
+            size=${this.size}
+            variant="highlight"
+            value=${this._periodLevel??"periods"}
+            @change=${this.setPeriodLevel}
+          >
+            ${i}
+          </luzmo-picker>
+        </div>
+        <div>${t.msg("ago",{desc:"Label for period ago"})}</div>
+      </div>
+      <div class="settings-row">
+        <div class="setting">
+          <luzmo-checkbox
+            id="incomplete-periods"
+            size=${this.size}
+            emphasized
+            ?checked=${this._incompletePeriods??!1}
+            @change=${this.setIncompletePeriods}
+          >
+            ${t.msg("Use period-to-date for incomplete periods",{desc:"Checkbox label for incomplete periods"})}
+          </luzmo-checkbox>
+        </div>
+      </div>`}renderOldUi(){const i=Object.keys(f).map(e=>o.html`<luzmo-menu-item value=${e}>
+          ${f[e]()}
+        </luzmo-menu-item>`);return o.html`<div class="settings-container">
+      <div class="settings-row">
+        <div class="setting">
+          <div class="label-container">
+            <luzmo-field-label for="period-comparison">
+              ${t.msg("Period comparison",{desc:"Label for period comparison"})}
+            </luzmo-field-label>
+
+            <a
+              target="_blank"
+              href="https://academy.luzmo.com/article/yh728g3n"
+              class="academy-link"
+            >
+              ${t.msg("Learn more",{desc:"Label for academy link"})}
+            </a>
+          </div>
+
+          <luzmo-picker
+            id="period-comparison"
+            size=${this.size}
+            variant="highlight"
+            value=${this._periodComparison??"none"}
+            @change=${this.setPeriodComparison}
+          >
+            ${i}
+          </luzmo-picker>
+        </div>
+      </div>
+      ${this._periodComparison==="none"?"":this.renderOldUiPeriodSettings()}
+    </div>`}render(){return this.periodOverPeriodUiType===p.PeriodOverPeriodCondition.OldImplementation?this.renderOldUi():o.html`
+      <luzmo-accordion variant="highlight-child" class="setting">
+        <luzmo-accordion-item
+          ?open=${this._periodComparison!=="none"}
+          label=${t.msg("Period comparison",{desc:"Label for period comparison"})}
+        >
+          <div class="settings-container dynamic-settings-container">
+            <div class="settings-row wrap">
+              ${this.typeOfComparisonSetting()}
+              ${this._periodComparison==="none"?"":this.renderPeriodSettings()}
+            </div>
+          </div>
+        </luzmo-accordion-item>
+      </luzmo-accordion>
+    `}setInitialOffsetDateColumn(i){this._offsetDateColumn=this.needsOffsetDatetimeColumn()?this.linkedDatasetDatetimeColumns[0]:void 0,i.periodOverPeriod.offsetDateColumn=this._offsetDateColumn}};n([l.property({type:String,reflect:!0})],exports.LuzmoDisplaySettingsPeriodOverPeriod.prototype,"language",2);n([l.property({type:Object,attribute:"slot-content"})],exports.LuzmoDisplaySettingsPeriodOverPeriod.prototype,"slotContent",2);n([l.property({type:String,attribute:"period-over-period-type"})],exports.LuzmoDisplaySettingsPeriodOverPeriod.prototype,"periodOverPeriodUiType",2);n([l.property({type:Array,attribute:"linked-dataset-datetime-columns"})],exports.LuzmoDisplaySettingsPeriodOverPeriod.prototype,"linkedDatasetDatetimeColumns",2);n([l.query("#period-comparison")],exports.LuzmoDisplaySettingsPeriodOverPeriod.prototype,"_periodComparisonElement",2);n([l.query("#number-periods")],exports.LuzmoDisplaySettingsPeriodOverPeriod.prototype,"_numberPeriodsElement",2);n([l.query("#period-level")],exports.LuzmoDisplaySettingsPeriodOverPeriod.prototype,"_periodLevelElement",2);n([l.query("#offset-date-column")],exports.LuzmoDisplaySettingsPeriodOverPeriod.prototype,"_offsetDateColumnElement",2);n([l.query("#incomplete-periods")],exports.LuzmoDisplaySettingsPeriodOverPeriod.prototype,"_incompletePeriodsElement",2);n([l.state()],exports.LuzmoDisplaySettingsPeriodOverPeriod.prototype,"_periodComparison",2);n([l.state()],exports.LuzmoDisplaySettingsPeriodOverPeriod.prototype,"_rangeType",2);exports.LuzmoDisplaySettingsPeriodOverPeriod=n([t.localized()],exports.LuzmoDisplaySettingsPeriodOverPeriod);customElements.get("luzmo-display-settings-period-over-period")||customElements.define("luzmo-display-settings-period-over-period",exports.LuzmoDisplaySettingsPeriodOverPeriod);

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

@@ -0,0 +1,7 @@
+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';

package/components/donut-chart-options.config-tNpqBZfR.cjs

@@ -0,0 +1,20 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2025 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.
+ * */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=[{key:"general",type:"group",open:!0,children:[{key:"mode",control:{type:"picker",default:"donut",enum:["donut","pie"]}},{key:"slices.half",control:{type:"picker",default:"full",enum:["full","half"],parseValue:e=>e?"half":"full",toValue:e=>e==="half"}},{type:"divider"},{key:"display.title",control:{type:"switch",label:"Title",default:!0}},{key:"display.legend",control:{type:"switch",label:"Legend",default:!0,calculateValue:({options:e})=>{var l,r;return((l=e==null?void 0:e.display)==null?void 0:l.legend)!==!1||((r=e==null?void 0:e.display)==null?void 0:r.categoryLabels)===!0},toOptions:({options:e,value:l})=>({...e,display:{...e.display,legend:l,categoryLabels:!1}})}},{key:"display.categoryLabels",control:{type:"radio-button-group",enum:["list","labels"],parseValue:e=>e?"labels":"list",toOptions:({options:e,value:l})=>({...e,display:{...e.display,categoryLabels:l==="labels",legend:l!=="labels"}})},visibleIf:({options:e})=>{var l,r;return((l=e==null?void 0:e.display)==null?void 0:l.legend)!==!1||((r=e==null?void 0:e.display)==null?void 0:r.categoryLabels)===!0}}]},{key:"slices",type:"group",open:!0,children:[{key:"sort.by",control:{type:"picker",default:"measure",enum:["measure","category"]}},{key:"display.values",control:{type:"picker",default:"none",enum:["none","absolute","percentage"]}},{key:"slices.width",control:{type:"slider",default:.35,min:.05,max:.9,step:.01}},{key:"slices.maxNumber",control:{type:"number-field",default:12,min:0,max:50,step:1}},{key:"slices.minPercentage",control:{type:"number-field",default:3,min:0,max:100,step:1}},{key:"slices.roundedCorners",control:{type:"slider",default:8,min:0,max:24,step:1,extraLabel:({options:e,theme:l})=>{var r,a;if(typeof((r=l==null?void 0:l.itemSpecific)==null?void 0:r.rounding)=="number")return typeof((a=e==null?void 0:e.slices)==null?void 0:a.roundedCorners)!="number"?"auto":"reset"},extraLabelHasClickAction:({options:e,theme:l})=>{var r,a;return!(typeof((r=l==null?void 0:l.itemSpecific)==null?void 0:r.rounding)!="number"||typeof((a=e==null?void 0:e.slices)==null?void 0:a.roundedCorners)!="number")},extraLabelClickAction:({options:e})=>{var r;const l={...e};return((r=l==null?void 0:l.slices)==null?void 0:r.roundedCorners)!==void 0&&delete l.slices.roundedCorners,{value:null,options:l}}}},{key:"slices.padding",control:{type:"slider",default:5,min:0,max:20,step:1,extraLabel:({options:e,theme:l})=>{var r,a;if(typeof((r=l==null?void 0:l.itemSpecific)==null?void 0:r.padding)=="number")return typeof((a=e==null?void 0:e.slices)==null?void 0:a.padding)!="number"?"auto":"reset"},extraLabelHasClickAction:({options:e,theme:l})=>{var r,a;return!(typeof((r=l==null?void 0:l.itemSpecific)==null?void 0:r.padding)!="number"||typeof((a=e==null?void 0:e.slices)==null?void 0:a.padding)!="number")},extraLabelClickAction:({options:e})=>{var r;const l={...e};return((r=l==null?void 0:l.slices)==null?void 0:r.padding)!==void 0&&delete l.slices.padding,{value:null,options:l}}}}]}];exports.default=u;

package/components/donut-chart-options.de-LQ01wQGN.cjs

@@ -0,0 +1,20 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2025 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.
+ * */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e={name:"Ringdiagramm",groups:{general:{label:"Allgemein"},slices:{label:"Segmente"},legend:{label:"Legende"},annotate:{label:"Anmerkungen"}},options:{"display.title":{label:"Titel"},mode:{label:"Modus",enum:{pie:"Kreisdiagramm",donut:"Ringdiagramm"}},"display.legend":{label:"Legende"},"slices.half":{label:"Typ",enum:{full:"Vollständig",half:"Halbkreis"}},"display.categoryLabels":{label:"Kategorie-Beschriftungen",enum:{list:"Liste",labels:"Beschriftungen"}},"sort.by":{label:"Sortieren nach",enum:{measure:"Messwert",category:"Kategorie"}},"display.values":{label:"Werte anzeigen",tooltip:"Falls genügend Platz vorhanden",enum:{none:"Keine",absolute:"Absolut",percentage:"Prozent"}},"slices.width":{label:"Breite"},"slices.maxNumber":{label:"Max. Anzahl Segmente"},"slices.minPercentage":{label:"Segmente gruppieren < %"},"slices.roundedCorners":{label:"Abgerundete Ecken"},"slices.padding":{label:"Abstand"}}};exports.default=e;