@qrvey/utils 1.17.4 → 1.17.6

package/README.md

@@ -1,4 +1,4 @@
-# [@qrvey/utils](https://bitbucket.org/qrvey/qrvey_utils/wiki/Home) *1.17.4*
+# [@qrvey/utils](https://bitbucket.org/qrvey/qrvey_utils/wiki/Home) *1.17.6*
 
 > Helper, Utils for all Qrvey Projects
 

package/dist/cjs/comparativeAnalysis/index.js

@@ -0,0 +1,368 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REFERENCE_COLUMN_MARKER = exports.DELTA_COLUMN_PREFIX = void 0;
+exports.formatDeltaColumnCaption = formatDeltaColumnCaption;
+exports.formatReferenceColumnCaption = formatReferenceColumnCaption;
+exports.resolveComparativeColumnCaption = resolveComparativeColumnCaption;
+exports.formatComparativePeriodCaption = formatComparativePeriodCaption;
+exports.formatDeltaDefaultCaption = formatDeltaDefaultCaption;
+exports.computeComparativeVirtualColumns = computeComparativeVirtualColumns;
+exports.expandColumnListWithComparativeColumns = expandColumnListWithComparativeColumns;
+exports.applyComparativeHeaderBorders = applyComparativeHeaderBorders;
+exports.mapOperatorToValidationType = mapOperatorToValidationType;
+exports.buildComparisonExpressionValue = buildComparisonExpressionValue;
+exports.buildComparativeChartComparison = buildComparativeChartComparison;
+exports.resolveDeltaDiffInfo = resolveDeltaDiffInfo;
+const get_1 = require("../general/object/get");
+exports.DELTA_COLUMN_PREFIX = "\u0394";
+exports.REFERENCE_COLUMN_MARKER = "\u25CF";
+function formatDeltaColumnCaption(caption) {
+    return `${exports.DELTA_COLUMN_PREFIX} ${caption}`;
+}
+function formatReferenceColumnCaption(caption) {
+    return `${exports.REFERENCE_COLUMN_MARKER} ${caption}`;
+}
+function resolveComparativeColumnCaption(chartModel, columnKey, allDatesText) {
+    const fallbackAllDates = allDatesText || "All dates";
+    const columnsList = chartModel?.chart?.fields?.columnsList ??
+        (0, get_1._get)(chartModel, "data.chart.fields.columnsList") ??
+        [];
+    const comparativeAnalisis = (0, get_1._get)(chartModel, "store.comparativeAnalisis") ??
+        chartModel?.v2?.comparativeAnalisis ??
+        (0, get_1._get)(chartModel, "data.v2.comparativeAnalisis") ??
+        {};
+    const suffixMatch = columnKey.match(/^(.+?)__(comp|delta(?:_(\d+))?)$/);
+    if (!suffixMatch) {
+        const col = columnsList.find((c) => c.data?.uniqueCode === columnKey) ??
+            columnsList.find((c) => c.dataField === columnKey);
+        return col?.label || col?.data?.text || columnKey;
+    }
+    const baseKey = suffixMatch[1];
+    const suffixType = suffixMatch[2];
+    const deltaIndexStr = suffixMatch[3];
+    const deltaIndex = deltaIndexStr ? parseInt(deltaIndexStr, 10) : 0;
+    const refCol = columnsList.find((c) => c.data?.uniqueCode === baseKey) ??
+        columnsList.find((c) => c.dataField === baseKey);
+    if (!refCol)
+        return columnKey;
+    const defaultName = refCol.data?.text ?? "";
+    const uniqueCode = refCol.data?.uniqueCode ?? "";
+    const refDataField = refCol.dataField ?? "";
+    const customLabels = (0, get_1._get)(comparativeAnalisis, "customColumnLabels") ?? {};
+    const dataFieldKey = refDataField
+        ? `${refDataField}__${suffixType}`
+        : columnKey;
+    if (suffixType === "comp") {
+        return (customLabels[dataFieldKey] ??
+            formatComparativePeriodCaption(comparativeAnalisis.compareTo, fallbackAllDates, defaultName));
+    }
+    const diffCols = comparativeAnalisis?.styles?.columnDiffs?.[uniqueCode] ?? [];
+    const diffCol = diffCols[deltaIndex];
+    const hasConfiguredDiffs = comparativeAnalisis?.styles?.columnDiffs?.[uniqueCode] != null;
+    const diffName = diffCol?.name?.trim() || null;
+    if (hasConfiguredDiffs) {
+        if (diffName)
+            return formatDeltaColumnCaption(diffName);
+        return formatDeltaDefaultCaption(comparativeAnalisis.referencePeriod, comparativeAnalisis.compareTo, fallbackAllDates, defaultName);
+    }
+    if (diffName)
+        return formatDeltaColumnCaption(diffName);
+    if (customLabels[dataFieldKey])
+        return formatDeltaColumnCaption(customLabels[dataFieldKey]);
+    return formatDeltaDefaultCaption(comparativeAnalisis.referencePeriod, comparativeAnalisis.compareTo, fallbackAllDates, defaultName);
+}
+function formatComparativePeriodCaption(period, allDatesText, colLabel = "") {
+    if (!period?.date1) {
+        return colLabel ? `${colLabel} - ${allDatesText}` : allDatesText;
+    }
+    const dateRange = period.date2
+        ? `${period.date1}-${period.date2}`
+        : period.date1;
+    return colLabel ? `${colLabel} - ${dateRange}` : dateRange;
+}
+function formatDeltaDefaultCaption(referencePeriod, compareTo, allDatesText, colLabel = "") {
+    const fmtPeriodFn = (p) => {
+        if (!p?.date1)
+            return allDatesText;
+        return p.date2 ? `${p.date1}-${p.date2}` : p.date1;
+    };
+    const ref = fmtPeriodFn(referencePeriod);
+    const cmp = fmtPeriodFn(compareTo);
+    const comparison = ref && cmp ? `${ref} vs ${cmp}` : ref || cmp;
+    const prefix = colLabel ? `${exports.DELTA_COLUMN_PREFIX} ${colLabel}` : exports.DELTA_COLUMN_PREFIX;
+    return comparison ? `${prefix} - ${comparison}` : prefix;
+}
+function computeComparativeVirtualColumns(isGrouped, myBus, chart, getChartColumns) {
+    if (!isGrouped)
+        return [];
+    const isActive = (0, get_1._get)(myBus, "store.comparativeAnalisis.enabled", (0, get_1._get)(chart, "data.v2.comparativeAnalisis.enabled")) === true;
+    const compareVisible = (0, get_1._get)(myBus, "store.comparativeAnalisis.compareVisible", (0, get_1._get)(chart, "data.v2.comparativeAnalisis.compareVisible", true));
+    if (!isActive || compareVisible === false)
+        return [];
+    const referenceColumnCodes = (0, get_1._get)(myBus, "store.comparativeAnalisis.referenceColumns", (0, get_1._get)(chart, "data.v2.comparativeAnalisis.referenceColumns", [])) || [];
+    if (!referenceColumnCodes.length)
+        return [];
+    const ca = (0, get_1._get)(myBus, "store.comparativeAnalisis") ??
+        (0, get_1._get)(chart, "data.v2.comparativeAnalisis") ??
+        {};
+    const columnList = getChartColumns();
+    const result = [];
+    columnList.forEach((col, i) => {
+        if (!referenceColumnCodes.includes(col.data?.uniqueCode))
+            return;
+        const uniqueCode = col.data?.uniqueCode;
+        const colDiffs = ca?.styles != null
+            ? (ca.styles.columnDiffs?.[uniqueCode] ?? [{ id: "default" }])
+            : [{ id: "default" }];
+        const extraDeltaDataFields = colDiffs
+            .slice(1)
+            .map((_, j) => `${col.dataField}__delta_${j + 1}`);
+        result.push({
+            originalDataField: col.dataField,
+            originalIndex: i,
+            compDataField: `${col.dataField}__comp`,
+            ...(colDiffs.length > 0
+                ? {
+                    deltaDataField: `${col.dataField}__delta`,
+                    extraDeltaDataFields: extraDeltaDataFields.length
+                        ? extraDeltaDataFields
+                        : undefined,
+                }
+                : {}),
+        });
+    });
+    return result;
+}
+function expandColumnListWithComparativeColumns(columnList, comparativeVirtualColumns, myBus, chart, allDatesText) {
+    if (!comparativeVirtualColumns?.length)
+        return columnList;
+    const comparativeData = (0, get_1._get)(myBus, "store.comparativeAnalisis", (0, get_1._get)(chart, "data.v2.comparativeAnalisis", {})) || {};
+    const fallbackAllDates = allDatesText || "All dates";
+    const result = [];
+    for (const col of columnList) {
+        const vc = comparativeVirtualColumns.find((v) => v.originalDataField === col.dataField);
+        if (!vc) {
+            result.push(col);
+        }
+        else {
+            const defaultName = col.data?.text ?? "";
+            const hasCustomLabel = typeof col.label === "string" &&
+                col.label.trim().length > 0 &&
+                col.label.trim() !== defaultName.trim();
+            const refLabel = hasCustomLabel
+                ? col.label
+                : formatComparativePeriodCaption(comparativeData.referencePeriod, fallbackAllDates, defaultName);
+            const customLabels = (0, get_1._get)(myBus, "store.comparativeAnalisis.customColumnLabels") ??
+                (0, get_1._get)(chart, "data.v2.comparativeAnalisis.customColumnLabels") ??
+                {};
+            const uniqueCode = col.data?.uniqueCode ?? "";
+            const diffCols = comparativeData?.styles != null
+                ? (comparativeData.styles.columnDiffs?.[uniqueCode] ?? [
+                    { id: "default", name: "" },
+                ])
+                : [{ id: "default", name: "" }];
+            const hasConfiguredDiffs = comparativeData?.styles?.columnDiffs?.[uniqueCode] != null;
+            const compLabel = customLabels[vc.compDataField] ??
+                formatComparativePeriodCaption(comparativeData.compareTo, fallbackAllDates, defaultName);
+            result.push({
+                ...col,
+                _comparativeLabel: refLabel,
+                _originalColIndex: vc.originalIndex,
+            });
+            result.push({
+                ...col,
+                dataField: vc.compDataField,
+                label: compLabel,
+                _isVirtualComparative: true,
+                _virtualType: "comp",
+                _originalDataField: vc.originalDataField,
+                _originalColIndex: vc.originalIndex,
+            });
+            if (vc.deltaDataField) {
+                const firstDiffName = diffCols[0]?.name?.trim() || "";
+                const resolvedFirstName = firstDiffName || null;
+                const deltaLabel = hasConfiguredDiffs
+                    ? (resolvedFirstName ??
+                        formatDeltaDefaultCaption(comparativeData.referencePeriod, comparativeData.compareTo, fallbackAllDates, defaultName))
+                    : (resolvedFirstName ??
+                        customLabels[vc.deltaDataField] ??
+                        formatDeltaDefaultCaption(comparativeData.referencePeriod, comparativeData.compareTo, fallbackAllDates, defaultName));
+                result.push({
+                    ...col,
+                    dataField: vc.deltaDataField,
+                    label: deltaLabel,
+                    _isVirtualComparative: true,
+                    _virtualType: "delta",
+                    _diffColStyleIndex: 0,
+                    _originalDataField: vc.originalDataField,
+                    _originalColIndex: vc.originalIndex,
+                });
+            }
+            (vc.extraDeltaDataFields ?? []).forEach((df, j) => {
+                const styleIndex = j + 1;
+                const extraDiffName = diffCols[styleIndex]?.name?.trim() || "";
+                const resolvedExtraName = extraDiffName || null;
+                const extraLabel = hasConfiguredDiffs
+                    ? (resolvedExtraName ??
+                        formatDeltaDefaultCaption(comparativeData.referencePeriod, comparativeData.compareTo, fallbackAllDates, defaultName))
+                    : (resolvedExtraName ??
+                        customLabels[df] ??
+                        formatDeltaDefaultCaption(comparativeData.referencePeriod, comparativeData.compareTo, fallbackAllDates, defaultName));
+                result.push({
+                    ...col,
+                    dataField: df,
+                    label: extraLabel,
+                    _isVirtualComparative: true,
+                    _virtualType: "delta",
+                    _diffColStyleIndex: styleIndex,
+                    _originalDataField: vc.originalDataField,
+                    _originalColIndex: vc.originalIndex,
+                });
+            });
+        }
+    }
+    return result;
+}
+function applyComparativeHeaderBorders(columns, myBus, chart) {
+    const tableBodyStyle = (0, get_1._get)(myBus, "store.stylesSettings.tableBodyStyle") ||
+        (0, get_1._get)(chart, "data.v2.stylesSettings.tableBodyStyle") ||
+        {};
+    const hasVerticalBorder = tableBodyStyle.verticalBorder === undefined ||
+        tableBodyStyle.verticalBorder === null
+        ? true
+        : tableBodyStyle.verticalBorder;
+    const borderColor = tableBodyStyle.borderColor || "#CACFD6";
+    return columns.map((col) => {
+        if (!col?.headerCellTemplate)
+            return col;
+        const origTemplate = col.headerCellTemplate;
+        return {
+            ...col,
+            headerCellTemplate: (columnHeader, cellInfo) => {
+                origTemplate(columnHeader, cellInfo);
+                if (col._comparativeLabel) {
+                    const titleEl = columnHeader.querySelector(".an-header-title-text");
+                    if (titleEl)
+                        titleEl.textContent = `${exports.REFERENCE_COLUMN_MARKER} ${col._comparativeLabel}`;
+                }
+                const totalCols = cellInfo.component?.columnCount?.() ?? 0;
+                if (hasVerticalBorder && cellInfo.columnIndex < totalCols - 1) {
+                    columnHeader.parentElement?.style.setProperty("border-right", `1px solid ${borderColor}`);
+                }
+                else {
+                    columnHeader.parentElement?.style.setProperty("border-right", "1px solid transparent");
+                }
+            },
+        };
+    });
+}
+function mapOperatorToValidationType(operatorLabel) {
+    if (!operatorLabel)
+        return "EQUAL";
+    switch (operatorLabel) {
+        case "EQUAL":
+            return "EQUAL";
+        case "DOES_NOT_EQUAL":
+            return "NOT_EQUAL";
+        case "BETWEEN_INCLUSIVE":
+        case "BETWEEN_EXCLUSIVE":
+        case "BETWEEN":
+        case "GREATER_THAN":
+        case "LESS_THAN":
+        case "GREATER_THAN_OR_EQUAL":
+        case "LESS_THAN_OR_EQUAL":
+        case "BEFORE":
+        case "AFTER":
+        case "BEFORE_OR_ON":
+        case "AFTER_OR_ON":
+            return "RANGE";
+        case "IS_NULL":
+            return "IS_EMPTY";
+        case "IS_NOT_NULL":
+            return "IS_NOT_EMPTY";
+        default:
+            return "EQUAL";
+    }
+}
+function buildComparisonExpressionValue(date1, date2, operatorLabel) {
+    switch (operatorLabel) {
+        case "EQUAL":
+        case "DOES_NOT_EQUAL":
+            return date1 ? [date1] : [];
+        case "BETWEEN_INCLUSIVE":
+            return date1 && date2 ? [{ gte: date1, lte: date2 }] : [];
+        case "BETWEEN_EXCLUSIVE":
+        case "BETWEEN":
+            return date1 && date2 ? [{ gt: date1, lt: date2 }] : [];
+        case "GREATER_THAN":
+        case "AFTER":
+            return date1 ? [{ gt: date1 }] : [];
+        case "GREATER_THAN_OR_EQUAL":
+        case "AFTER_OR_ON":
+            return date1 ? [{ gte: date1 }] : [];
+        case "LESS_THAN":
+        case "BEFORE":
+            return date1 ? [{ lt: date1 }] : [];
+        case "LESS_THAN_OR_EQUAL":
+        case "BEFORE_OR_ON":
+            return date1 ? [{ lte: date1 }] : [];
+        default:
+            return [];
+    }
+}
+function buildComparativeChartComparison(myBus, chart, groups) {
+    const comparativeData = (0, get_1._get)(myBus, "store.comparativeAnalisis", (0, get_1._get)(chart, "data.v2.comparativeAnalisis", {})) || {};
+    const { dateColumn, referencePeriod, compareTo } = comparativeData;
+    if (!dateColumn)
+        return undefined;
+    const dateGroup = groups.find((g) => g.data.id === dateColumn);
+    const qrveyid = dateGroup?.data?.qrveyid;
+    const questionType = dateGroup?.data?.type || "DATE";
+    const buildExpression = (periodData) => {
+        if (!periodData || !periodData.operator)
+            return null;
+        const operatorLabel = periodData.operator.label;
+        const isNullType = operatorLabel === "IS_NULL" || operatorLabel === "IS_NOT_NULL";
+        if (!isNullType && !periodData.date1)
+            return null;
+        const validationType = mapOperatorToValidationType(operatorLabel);
+        const expression = {
+            groupValue: "day",
+            questionid: dateColumn,
+            qrveyid,
+            questionType,
+            validationType,
+            enabled: true,
+        };
+        if (!isNullType) {
+            expression.value = buildComparisonExpressionValue(periodData.date1, periodData.date2, operatorLabel);
+        }
+        return expression;
+    };
+    return {
+        comparison: buildExpression(compareTo),
+        period: buildExpression(referencePeriod),
+    };
+}
+function resolveDeltaDiffInfo(dataField, comparativeVirtualColumns, getChartColumns) {
+    for (const vc of comparativeVirtualColumns) {
+        if (vc.deltaDataField === dataField) {
+            const chartCols = getChartColumns();
+            const refCol = chartCols.find((c) => c.dataField === vc.originalDataField);
+            return {
+                origUniqueCode: refCol?.data?.uniqueCode ?? "",
+                diffIndex: 0,
+            };
+        }
+        const extraIdx = (vc.extraDeltaDataFields ?? []).indexOf(dataField);
+        if (extraIdx !== -1) {
+            const chartCols = getChartColumns();
+            const refCol = chartCols.find((c) => c.dataField === vc.originalDataField);
+            return {
+                origUniqueCode: refCol?.data?.uniqueCode ?? "",
+                diffIndex: extraIdx + 1,
+            };
+        }
+    }
+    return { origUniqueCode: "", diffIndex: -1 };
+}

package/dist/cjs/index.js

@@ -20,3 +20,4 @@ tslib_1.__exportStar(require("./tokens/index"), exports);
 tslib_1.__exportStar(require("./column_format/index"), exports);
 tslib_1.__exportStar(require("./themes/index"), exports);
 tslib_1.__exportStar(require("./elements/index"), exports);
+tslib_1.__exportStar(require("./comparativeAnalysis/index"), exports);

package/dist/comparativeAnalysis/index.d.ts

@@ -0,0 +1,24 @@
+export declare const DELTA_COLUMN_PREFIX = "\u0394";
+export declare const REFERENCE_COLUMN_MARKER = "\u25CF";
+export declare function formatDeltaColumnCaption(caption: string): string;
+export declare function formatReferenceColumnCaption(caption: string): string;
+export declare function resolveComparativeColumnCaption(chartModel: any, columnKey: string, allDatesText?: string): string;
+export interface ComparativeVirtualColumn {
+    originalDataField: string;
+    originalIndex: number;
+    compDataField: string;
+    deltaDataField?: string;
+    extraDeltaDataFields?: string[];
+}
+export declare function formatComparativePeriodCaption(period: any, allDatesText: string, colLabel?: string): string;
+export declare function formatDeltaDefaultCaption(referencePeriod: any, compareTo: any, allDatesText: string, colLabel?: string): string;
+export declare function computeComparativeVirtualColumns(isGrouped: boolean, myBus: any, chart: any, getChartColumns: () => any[]): ComparativeVirtualColumn[];
+export declare function expandColumnListWithComparativeColumns(columnList: any[], comparativeVirtualColumns: ComparativeVirtualColumn[], myBus: any, chart: any, allDatesText?: string): any[];
+export declare function applyComparativeHeaderBorders(columns: any[], myBus: any, chart: any): any[];
+export declare function mapOperatorToValidationType(operatorLabel: string): string;
+export declare function buildComparisonExpressionValue(date1: string | null, date2: string | null, operatorLabel: string): Array<string | Record<string, string>>;
+export declare function buildComparativeChartComparison(myBus: any, chart: any, groups: any[]): object | undefined;
+export declare function resolveDeltaDiffInfo(dataField: string, comparativeVirtualColumns: ComparativeVirtualColumn[], getChartColumns: () => any[]): {
+    origUniqueCode: string;
+    diffIndex: number;
+};

package/dist/comparativeAnalysis/index.js

@@ -0,0 +1,353 @@
+import { _get } from "../general/object/get";
+export const DELTA_COLUMN_PREFIX = "\u0394";
+export const REFERENCE_COLUMN_MARKER = "\u25CF";
+export function formatDeltaColumnCaption(caption) {
+    return `${DELTA_COLUMN_PREFIX} ${caption}`;
+}
+export function formatReferenceColumnCaption(caption) {
+    return `${REFERENCE_COLUMN_MARKER} ${caption}`;
+}
+export function resolveComparativeColumnCaption(chartModel, columnKey, allDatesText) {
+    const fallbackAllDates = allDatesText || "All dates";
+    const columnsList = chartModel?.chart?.fields?.columnsList ??
+        _get(chartModel, "data.chart.fields.columnsList") ??
+        [];
+    const comparativeAnalisis = _get(chartModel, "store.comparativeAnalisis") ??
+        chartModel?.v2?.comparativeAnalisis ??
+        _get(chartModel, "data.v2.comparativeAnalisis") ??
+        {};
+    const suffixMatch = columnKey.match(/^(.+?)__(comp|delta(?:_(\d+))?)$/);
+    if (!suffixMatch) {
+        const col = columnsList.find((c) => c.data?.uniqueCode === columnKey) ??
+            columnsList.find((c) => c.dataField === columnKey);
+        return col?.label || col?.data?.text || columnKey;
+    }
+    const baseKey = suffixMatch[1];
+    const suffixType = suffixMatch[2];
+    const deltaIndexStr = suffixMatch[3];
+    const deltaIndex = deltaIndexStr ? parseInt(deltaIndexStr, 10) : 0;
+    const refCol = columnsList.find((c) => c.data?.uniqueCode === baseKey) ??
+        columnsList.find((c) => c.dataField === baseKey);
+    if (!refCol)
+        return columnKey;
+    const defaultName = refCol.data?.text ?? "";
+    const uniqueCode = refCol.data?.uniqueCode ?? "";
+    const refDataField = refCol.dataField ?? "";
+    const customLabels = _get(comparativeAnalisis, "customColumnLabels") ?? {};
+    const dataFieldKey = refDataField
+        ? `${refDataField}__${suffixType}`
+        : columnKey;
+    if (suffixType === "comp") {
+        return (customLabels[dataFieldKey] ??
+            formatComparativePeriodCaption(comparativeAnalisis.compareTo, fallbackAllDates, defaultName));
+    }
+    const diffCols = comparativeAnalisis?.styles?.columnDiffs?.[uniqueCode] ?? [];
+    const diffCol = diffCols[deltaIndex];
+    const hasConfiguredDiffs = comparativeAnalisis?.styles?.columnDiffs?.[uniqueCode] != null;
+    const diffName = diffCol?.name?.trim() || null;
+    if (hasConfiguredDiffs) {
+        if (diffName)
+            return formatDeltaColumnCaption(diffName);
+        return formatDeltaDefaultCaption(comparativeAnalisis.referencePeriod, comparativeAnalisis.compareTo, fallbackAllDates, defaultName);
+    }
+    if (diffName)
+        return formatDeltaColumnCaption(diffName);
+    if (customLabels[dataFieldKey])
+        return formatDeltaColumnCaption(customLabels[dataFieldKey]);
+    return formatDeltaDefaultCaption(comparativeAnalisis.referencePeriod, comparativeAnalisis.compareTo, fallbackAllDates, defaultName);
+}
+export function formatComparativePeriodCaption(period, allDatesText, colLabel = "") {
+    if (!period?.date1) {
+        return colLabel ? `${colLabel} - ${allDatesText}` : allDatesText;
+    }
+    const dateRange = period.date2
+        ? `${period.date1}-${period.date2}`
+        : period.date1;
+    return colLabel ? `${colLabel} - ${dateRange}` : dateRange;
+}
+export function formatDeltaDefaultCaption(referencePeriod, compareTo, allDatesText, colLabel = "") {
+    const fmtPeriodFn = (p) => {
+        if (!p?.date1)
+            return allDatesText;
+        return p.date2 ? `${p.date1}-${p.date2}` : p.date1;
+    };
+    const ref = fmtPeriodFn(referencePeriod);
+    const cmp = fmtPeriodFn(compareTo);
+    const comparison = ref && cmp ? `${ref} vs ${cmp}` : ref || cmp;
+    const prefix = colLabel ? `${DELTA_COLUMN_PREFIX} ${colLabel}` : DELTA_COLUMN_PREFIX;
+    return comparison ? `${prefix} - ${comparison}` : prefix;
+}
+export function computeComparativeVirtualColumns(isGrouped, myBus, chart, getChartColumns) {
+    if (!isGrouped)
+        return [];
+    const isActive = _get(myBus, "store.comparativeAnalisis.enabled", _get(chart, "data.v2.comparativeAnalisis.enabled")) === true;
+    const compareVisible = _get(myBus, "store.comparativeAnalisis.compareVisible", _get(chart, "data.v2.comparativeAnalisis.compareVisible", true));
+    if (!isActive || compareVisible === false)
+        return [];
+    const referenceColumnCodes = _get(myBus, "store.comparativeAnalisis.referenceColumns", _get(chart, "data.v2.comparativeAnalisis.referenceColumns", [])) || [];
+    if (!referenceColumnCodes.length)
+        return [];
+    const ca = _get(myBus, "store.comparativeAnalisis") ??
+        _get(chart, "data.v2.comparativeAnalisis") ??
+        {};
+    const columnList = getChartColumns();
+    const result = [];
+    columnList.forEach((col, i) => {
+        if (!referenceColumnCodes.includes(col.data?.uniqueCode))
+            return;
+        const uniqueCode = col.data?.uniqueCode;
+        const colDiffs = ca?.styles != null
+            ? (ca.styles.columnDiffs?.[uniqueCode] ?? [{ id: "default" }])
+            : [{ id: "default" }];
+        const extraDeltaDataFields = colDiffs
+            .slice(1)
+            .map((_, j) => `${col.dataField}__delta_${j + 1}`);
+        result.push({
+            originalDataField: col.dataField,
+            originalIndex: i,
+            compDataField: `${col.dataField}__comp`,
+            ...(colDiffs.length > 0
+                ? {
+                    deltaDataField: `${col.dataField}__delta`,
+                    extraDeltaDataFields: extraDeltaDataFields.length
+                        ? extraDeltaDataFields
+                        : undefined,
+                }
+                : {}),
+        });
+    });
+    return result;
+}
+export function expandColumnListWithComparativeColumns(columnList, comparativeVirtualColumns, myBus, chart, allDatesText) {
+    if (!comparativeVirtualColumns?.length)
+        return columnList;
+    const comparativeData = _get(myBus, "store.comparativeAnalisis", _get(chart, "data.v2.comparativeAnalisis", {})) || {};
+    const fallbackAllDates = allDatesText || "All dates";
+    const result = [];
+    for (const col of columnList) {
+        const vc = comparativeVirtualColumns.find((v) => v.originalDataField === col.dataField);
+        if (!vc) {
+            result.push(col);
+        }
+        else {
+            const defaultName = col.data?.text ?? "";
+            const hasCustomLabel = typeof col.label === "string" &&
+                col.label.trim().length > 0 &&
+                col.label.trim() !== defaultName.trim();
+            const refLabel = hasCustomLabel
+                ? col.label
+                : formatComparativePeriodCaption(comparativeData.referencePeriod, fallbackAllDates, defaultName);
+            const customLabels = _get(myBus, "store.comparativeAnalisis.customColumnLabels") ??
+                _get(chart, "data.v2.comparativeAnalisis.customColumnLabels") ??
+                {};
+            const uniqueCode = col.data?.uniqueCode ?? "";
+            const diffCols = comparativeData?.styles != null
+                ? (comparativeData.styles.columnDiffs?.[uniqueCode] ?? [
+                    { id: "default", name: "" },
+                ])
+                : [{ id: "default", name: "" }];
+            const hasConfiguredDiffs = comparativeData?.styles?.columnDiffs?.[uniqueCode] != null;
+            const compLabel = customLabels[vc.compDataField] ??
+                formatComparativePeriodCaption(comparativeData.compareTo, fallbackAllDates, defaultName);
+            result.push({
+                ...col,
+                _comparativeLabel: refLabel,
+                _originalColIndex: vc.originalIndex,
+            });
+            result.push({
+                ...col,
+                dataField: vc.compDataField,
+                label: compLabel,
+                _isVirtualComparative: true,
+                _virtualType: "comp",
+                _originalDataField: vc.originalDataField,
+                _originalColIndex: vc.originalIndex,
+            });
+            if (vc.deltaDataField) {
+                const firstDiffName = diffCols[0]?.name?.trim() || "";
+                const resolvedFirstName = firstDiffName || null;
+                const deltaLabel = hasConfiguredDiffs
+                    ? (resolvedFirstName ??
+                        formatDeltaDefaultCaption(comparativeData.referencePeriod, comparativeData.compareTo, fallbackAllDates, defaultName))
+                    : (resolvedFirstName ??
+                        customLabels[vc.deltaDataField] ??
+                        formatDeltaDefaultCaption(comparativeData.referencePeriod, comparativeData.compareTo, fallbackAllDates, defaultName));
+                result.push({
+                    ...col,
+                    dataField: vc.deltaDataField,
+                    label: deltaLabel,
+                    _isVirtualComparative: true,
+                    _virtualType: "delta",
+                    _diffColStyleIndex: 0,
+                    _originalDataField: vc.originalDataField,
+                    _originalColIndex: vc.originalIndex,
+                });
+            }
+            (vc.extraDeltaDataFields ?? []).forEach((df, j) => {
+                const styleIndex = j + 1;
+                const extraDiffName = diffCols[styleIndex]?.name?.trim() || "";
+                const resolvedExtraName = extraDiffName || null;
+                const extraLabel = hasConfiguredDiffs
+                    ? (resolvedExtraName ??
+                        formatDeltaDefaultCaption(comparativeData.referencePeriod, comparativeData.compareTo, fallbackAllDates, defaultName))
+                    : (resolvedExtraName ??
+                        customLabels[df] ??
+                        formatDeltaDefaultCaption(comparativeData.referencePeriod, comparativeData.compareTo, fallbackAllDates, defaultName));
+                result.push({
+                    ...col,
+                    dataField: df,
+                    label: extraLabel,
+                    _isVirtualComparative: true,
+                    _virtualType: "delta",
+                    _diffColStyleIndex: styleIndex,
+                    _originalDataField: vc.originalDataField,
+                    _originalColIndex: vc.originalIndex,
+                });
+            });
+        }
+    }
+    return result;
+}
+export function applyComparativeHeaderBorders(columns, myBus, chart) {
+    const tableBodyStyle = _get(myBus, "store.stylesSettings.tableBodyStyle") ||
+        _get(chart, "data.v2.stylesSettings.tableBodyStyle") ||
+        {};
+    const hasVerticalBorder = tableBodyStyle.verticalBorder === undefined ||
+        tableBodyStyle.verticalBorder === null
+        ? true
+        : tableBodyStyle.verticalBorder;
+    const borderColor = tableBodyStyle.borderColor || "#CACFD6";
+    return columns.map((col) => {
+        if (!col?.headerCellTemplate)
+            return col;
+        const origTemplate = col.headerCellTemplate;
+        return {
+            ...col,
+            headerCellTemplate: (columnHeader, cellInfo) => {
+                origTemplate(columnHeader, cellInfo);
+                if (col._comparativeLabel) {
+                    const titleEl = columnHeader.querySelector(".an-header-title-text");
+                    if (titleEl)
+                        titleEl.textContent = `${REFERENCE_COLUMN_MARKER} ${col._comparativeLabel}`;
+                }
+                const totalCols = cellInfo.component?.columnCount?.() ?? 0;
+                if (hasVerticalBorder && cellInfo.columnIndex < totalCols - 1) {
+                    columnHeader.parentElement?.style.setProperty("border-right", `1px solid ${borderColor}`);
+                }
+                else {
+                    columnHeader.parentElement?.style.setProperty("border-right", "1px solid transparent");
+                }
+            },
+        };
+    });
+}
+export function mapOperatorToValidationType(operatorLabel) {
+    if (!operatorLabel)
+        return "EQUAL";
+    switch (operatorLabel) {
+        case "EQUAL":
+            return "EQUAL";
+        case "DOES_NOT_EQUAL":
+            return "NOT_EQUAL";
+        case "BETWEEN_INCLUSIVE":
+        case "BETWEEN_EXCLUSIVE":
+        case "BETWEEN":
+        case "GREATER_THAN":
+        case "LESS_THAN":
+        case "GREATER_THAN_OR_EQUAL":
+        case "LESS_THAN_OR_EQUAL":
+        case "BEFORE":
+        case "AFTER":
+        case "BEFORE_OR_ON":
+        case "AFTER_OR_ON":
+            return "RANGE";
+        case "IS_NULL":
+            return "IS_EMPTY";
+        case "IS_NOT_NULL":
+            return "IS_NOT_EMPTY";
+        default:
+            return "EQUAL";
+    }
+}
+export function buildComparisonExpressionValue(date1, date2, operatorLabel) {
+    switch (operatorLabel) {
+        case "EQUAL":
+        case "DOES_NOT_EQUAL":
+            return date1 ? [date1] : [];
+        case "BETWEEN_INCLUSIVE":
+            return date1 && date2 ? [{ gte: date1, lte: date2 }] : [];
+        case "BETWEEN_EXCLUSIVE":
+        case "BETWEEN":
+            return date1 && date2 ? [{ gt: date1, lt: date2 }] : [];
+        case "GREATER_THAN":
+        case "AFTER":
+            return date1 ? [{ gt: date1 }] : [];
+        case "GREATER_THAN_OR_EQUAL":
+        case "AFTER_OR_ON":
+            return date1 ? [{ gte: date1 }] : [];
+        case "LESS_THAN":
+        case "BEFORE":
+            return date1 ? [{ lt: date1 }] : [];
+        case "LESS_THAN_OR_EQUAL":
+        case "BEFORE_OR_ON":
+            return date1 ? [{ lte: date1 }] : [];
+        default:
+            return [];
+    }
+}
+export function buildComparativeChartComparison(myBus, chart, groups) {
+    const comparativeData = _get(myBus, "store.comparativeAnalisis", _get(chart, "data.v2.comparativeAnalisis", {})) || {};
+    const { dateColumn, referencePeriod, compareTo } = comparativeData;
+    if (!dateColumn)
+        return undefined;
+    const dateGroup = groups.find((g) => g.data.id === dateColumn);
+    const qrveyid = dateGroup?.data?.qrveyid;
+    const questionType = dateGroup?.data?.type || "DATE";
+    const buildExpression = (periodData) => {
+        if (!periodData || !periodData.operator)
+            return null;
+        const operatorLabel = periodData.operator.label;
+        const isNullType = operatorLabel === "IS_NULL" || operatorLabel === "IS_NOT_NULL";
+        if (!isNullType && !periodData.date1)
+            return null;
+        const validationType = mapOperatorToValidationType(operatorLabel);
+        const expression = {
+            groupValue: "day",
+            questionid: dateColumn,
+            qrveyid,
+            questionType,
+            validationType,
+            enabled: true,
+        };
+        if (!isNullType) {
+            expression.value = buildComparisonExpressionValue(periodData.date1, periodData.date2, operatorLabel);
+        }
+        return expression;
+    };
+    return {
+        comparison: buildExpression(compareTo),
+        period: buildExpression(referencePeriod),
+    };
+}
+export function resolveDeltaDiffInfo(dataField, comparativeVirtualColumns, getChartColumns) {
+    for (const vc of comparativeVirtualColumns) {
+        if (vc.deltaDataField === dataField) {
+            const chartCols = getChartColumns();
+            const refCol = chartCols.find((c) => c.dataField === vc.originalDataField);
+            return {
+                origUniqueCode: refCol?.data?.uniqueCode ?? "",
+                diffIndex: 0,
+            };
+        }
+        const extraIdx = (vc.extraDeltaDataFields ?? []).indexOf(dataField);
+        if (extraIdx !== -1) {
+            const chartCols = getChartColumns();
+            const refCol = chartCols.find((c) => c.dataField === vc.originalDataField);
+            return {
+                origUniqueCode: refCol?.data?.uniqueCode ?? "",
+                diffIndex: extraIdx + 1,
+            };
+        }
+    }
+    return { origUniqueCode: "", diffIndex: -1 };
+}

package/dist/index.d.ts

@@ -17,3 +17,4 @@ export * from "./tokens/index";
 export * from "./column_format/index";
 export * from "./themes/index";
 export * from "./elements/index";
+export * from "./comparativeAnalysis/index";

package/dist/index.js

@@ -17,3 +17,4 @@ export * from "./tokens/index";
 export * from "./column_format/index";
 export * from "./themes/index";
 export * from "./elements/index";
+export * from "./comparativeAnalysis/index";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qrvey/utils",
-  "version": "1.17.4",
+  "version": "1.17.6",
   "description": "Helper, Utils for all Qrvey Projects",
   "homepage": "https://bitbucket.org/qrvey/qrvey_utils/wiki/Home",
   "main": "dist/cjs/index.js",