@levi-gemcommerce/analytics 3.0.1-dev.2 → 3.0.1-dev.4

package/dist/esm/utils/analytics.mjs

@@ -0,0 +1,71 @@
+import { cleanDecimal } from './number.mjs';
+import { dayjsTz } from './dayjs.mjs';
+import '../types/template.mjs';
+
+var AnalyticInterval;
+(function (AnalyticInterval) {
+    AnalyticInterval["DAY"] = "DAY";
+    AnalyticInterval["HOUR"] = "HOUR";
+    AnalyticInterval["MONTH"] = "MONTH";
+    AnalyticInterval["QUARTER"] = "QUARTER";
+    AnalyticInterval["WEEK"] = "WEEK";
+    AnalyticInterval["YEAR"] = "YEAR";
+})(AnalyticInterval || (AnalyticInterval = {}));
+const SECONDS_IN_MINUTE = 60;
+const SECONDS_IN_HOUR = SECONDS_IN_MINUTE * SECONDS_IN_MINUTE;
+const getTimeDurationLabel = (valueInSeconds) => {
+    let data = valueInSeconds;
+    if (!Number.isFinite(valueInSeconds) || valueInSeconds == null) {
+        data = 0;
+    }
+    const fixedValue = cleanDecimal(data);
+    if (data >= SECONDS_IN_HOUR) {
+        const hours = Math.floor(data / SECONDS_IN_HOUR);
+        const minutes = Math.floor((data % SECONDS_IN_HOUR) / SECONDS_IN_MINUTE);
+        const seconds = Math.floor(data % SECONDS_IN_MINUTE);
+        return `${hours}h ${minutes}m ${seconds}s`;
+    }
+    else if (data >= SECONDS_IN_MINUTE) {
+        const minutes = Math.floor(data / SECONDS_IN_MINUTE);
+        const seconds = Math.floor(data % SECONDS_IN_MINUTE);
+        return `${minutes}m ${seconds}s`;
+    }
+    else {
+        return `${fixedValue}s`;
+    }
+};
+const getFormattedByInterval = (value, interval, options) => {
+    if (!value)
+        return '';
+    const optionFormat = options?.isExpandDetail
+        ? {
+            formatHouse: 'MMM D, h:mm A',
+            formatDay: 'MMM D, YYYY',
+            formatMonth: 'MMM YYYY',
+            formatYear: 'MMM YYYY',
+        }
+        : {
+            formatHouse: 'h A',
+            formatDay: 'MMM D',
+            formatMonth: 'MMM YYYY',
+            formatYear: 'YYYY',
+        };
+    switch (interval) {
+        case AnalyticInterval.HOUR:
+            return dayjsTz(value).format(optionFormat.formatHouse);
+        case AnalyticInterval.DAY:
+        case AnalyticInterval.WEEK:
+            return dayjsTz(value).format(optionFormat.formatDay);
+        case AnalyticInterval.MONTH:
+            return dayjsTz(value).format(optionFormat.formatMonth);
+        case AnalyticInterval.QUARTER: {
+            const d = dayjsTz(value);
+            return `Q${d.quarter()} ${d.format('YYYY')}`;
+        }
+        case AnalyticInterval.YEAR:
+            return dayjsTz(value).format(optionFormat.formatYear);
+    }
+    return dayjsTz(value).format(optionFormat.formatMonth);
+};
+
+export { AnalyticInterval, getFormattedByInterval, getTimeDurationLabel };

package/dist/esm/utils/array.d.ts

@@ -0,0 +1 @@
+export declare function findLastIndex<T>(array: T[], predicate: (value: T, index: number, array: T[]) => boolean, thisArg?: unknown): number;

package/dist/esm/utils/array.js

@@ -0,0 +1,10 @@
+function findLastIndex(array, predicate, thisArg) {
+    for (let i = array.length - 1; i >= 0; i--) {
+        if (predicate.call(thisArg, array[i], i, array)) {
+            return i;
+        }
+    }
+    return -1;
+}
+
+export { findLastIndex };

package/dist/esm/utils/array.mjs

@@ -0,0 +1,10 @@
+function findLastIndex(array, predicate, thisArg) {
+    for (let i = array.length - 1; i >= 0; i--) {
+        if (predicate.call(thisArg, array[i], i, array)) {
+            return i;
+        }
+    }
+    return -1;
+}
+
+export { findLastIndex };

package/dist/esm/utils/cls.js

@@ -0,0 +1,18 @@
+function toVal(mix) {
+    if (typeof mix === 'string') {
+        return mix;
+    }
+    else if (typeof mix === 'object' && mix !== null) {
+        return Object.keys(mix)
+            .filter((key) => mix[key])
+            .join(' ');
+    }
+    else {
+        return false;
+    }
+}
+function cls(...classes) {
+    return classes.map(toVal).filter(Boolean).join(' ');
+}
+
+export { cls };

package/dist/esm/utils/cls.mjs

@@ -0,0 +1,18 @@
+function toVal(mix) {
+    if (typeof mix === 'string') {
+        return mix;
+    }
+    else if (typeof mix === 'object' && mix !== null) {
+        return Object.keys(mix)
+            .filter((key) => mix[key])
+            .join(' ');
+    }
+    else {
+        return false;
+    }
+}
+function cls(...classes) {
+    return classes.map(toVal).filter(Boolean).join(' ');
+}
+
+export { cls };

package/dist/esm/utils/currency.js

@@ -0,0 +1,35 @@
+import '../constants/analytic-metric-tooltip.js';
+import '../constants/breakdown-targets.js';
+import { DEFAULT_CURRENCY_ANALYTIC } from '../constants/currency.js';
+
+const getPriceByCurrency = (price, currency = DEFAULT_CURRENCY_ANALYTIC, options) => {
+    if (typeof price === 'string')
+        return price;
+    if (typeof price !== 'number')
+        return;
+    // Support legacy 3rd arg as locale string
+    const opts = typeof options === 'string' ? { locale: options } : options;
+    const locale = opts?.locale ?? 'en-US';
+    // Currency's natural minimum (USD → 2, JPY/KRW/VND → 0); used as the floor for scaled tiers.
+    const currencyMinDigits = new Intl.NumberFormat(locale, { style: 'currency', currency }).resolvedOptions().minimumFractionDigits ?? 0;
+    // For scaled tiers, allow extra precision but never force decimals on zero-decimal currencies.
+    const formatCurrency = (value, maxDigits) => new Intl.NumberFormat(locale, {
+        style: 'currency',
+        currency,
+        ...(maxDigits != null && {
+            minimumFractionDigits: Math.min(currencyMinDigits, maxDigits),
+            maximumFractionDigits: maxDigits,
+        }),
+    }).format(value);
+    const magnitude = Math.abs(price);
+    if (magnitude >= 1_000_000_000)
+        return `${formatCurrency(price / 1_000_000_000, 2)}B`;
+    if (magnitude >= 1_000_000)
+        return `${formatCurrency(price / 1_000_000, 2)}M`;
+    if (opts?.compact && magnitude >= 1_000)
+        return `${formatCurrency(price / 1_000, 1)}K`;
+    // Let Intl pick fraction digits per currency (e.g. JPY/KRW have 0) instead of hardcoding.
+    return formatCurrency(price);
+};
+
+export { getPriceByCurrency };

package/dist/esm/utils/currency.mjs

@@ -0,0 +1,35 @@
+import '../constants/analytic-metric-tooltip.mjs';
+import '../constants/breakdown-targets.mjs';
+import { DEFAULT_CURRENCY_ANALYTIC } from '../constants/currency.mjs';
+
+const getPriceByCurrency = (price, currency = DEFAULT_CURRENCY_ANALYTIC, options) => {
+    if (typeof price === 'string')
+        return price;
+    if (typeof price !== 'number')
+        return;
+    // Support legacy 3rd arg as locale string
+    const opts = typeof options === 'string' ? { locale: options } : options;
+    const locale = opts?.locale ?? 'en-US';
+    // Currency's natural minimum (USD → 2, JPY/KRW/VND → 0); used as the floor for scaled tiers.
+    const currencyMinDigits = new Intl.NumberFormat(locale, { style: 'currency', currency }).resolvedOptions().minimumFractionDigits ?? 0;
+    // For scaled tiers, allow extra precision but never force decimals on zero-decimal currencies.
+    const formatCurrency = (value, maxDigits) => new Intl.NumberFormat(locale, {
+        style: 'currency',
+        currency,
+        ...(maxDigits != null && {
+            minimumFractionDigits: Math.min(currencyMinDigits, maxDigits),
+            maximumFractionDigits: maxDigits,
+        }),
+    }).format(value);
+    const magnitude = Math.abs(price);
+    if (magnitude >= 1_000_000_000)
+        return `${formatCurrency(price / 1_000_000_000, 2)}B`;
+    if (magnitude >= 1_000_000)
+        return `${formatCurrency(price / 1_000_000, 2)}M`;
+    if (opts?.compact && magnitude >= 1_000)
+        return `${formatCurrency(price / 1_000, 1)}K`;
+    // Let Intl pick fraction digits per currency (e.g. JPY/KRW have 0) instead of hardcoding.
+    return formatCurrency(price);
+};
+
+export { getPriceByCurrency };

package/dist/esm/utils/date-time.d.ts

@@ -0,0 +1 @@
+export declare const formatDateBy: (format: string, date?: string | Date) => string;

package/dist/esm/utils/date-time.js

@@ -0,0 +1,9 @@
+import { dayjsTz } from './dayjs.js';
+
+const formatDateBy = (format, date) => {
+    if (!date)
+        date = new Date();
+    return dayjsTz(date).format(format) ?? '-';
+};
+
+export { formatDateBy };

package/dist/esm/utils/date-time.mjs

@@ -0,0 +1,9 @@
+import { dayjsTz } from './dayjs.mjs';
+
+const formatDateBy = (format, date) => {
+    if (!date)
+        date = new Date();
+    return dayjsTz(date).format(format) ?? '-';
+};
+
+export { formatDateBy };

package/dist/esm/utils/dayjs.js

@@ -0,0 +1,43 @@
+import dayjs from 'dayjs';
+export { default as dayjs } from 'dayjs';
+import quarterOfYear from 'dayjs/plugin/quarterOfYear.js';
+import timezone from 'dayjs/plugin/timezone.js';
+import utc from 'dayjs/plugin/utc.js';
+
+dayjs.extend(utc);
+dayjs.extend(timezone);
+dayjs.extend(quarterOfYear);
+// Stored on `globalThis` (not a module-local `let`): each entry-point bundle gets its
+// own copy of this module, so a local var would let `setTz` and the query builder read
+// different copies. A shared global slot keeps every bundle in sync.
+const TZ_GLOBAL_KEY = '__GEM_SDK_ANALYTICS_TZ__';
+const DEFAULT_DATE_FORMAT = 'YYYY-MM-DD HH:mm:ss';
+function getInitialTimezone() {
+    return globalThis[TZ_GLOBAL_KEY] ?? 'UTC';
+}
+function setTz(value) {
+    globalThis[TZ_GLOBAL_KEY] = value;
+    dayjs.tz.setDefault(value);
+}
+const dayjsTz = (date) => {
+    const tz = getInitialTimezone();
+    if (!date)
+        return dayjs().tz(tz);
+    return dayjs(date).tz(tz);
+};
+const convertDateToTz = (date) => {
+    const tz = getInitialTimezone();
+    if (!date)
+        return dayjs.tz(dayjs().format(DEFAULT_DATE_FORMAT), tz);
+    return dayjs.tz(dayjs(date).format(DEFAULT_DATE_FORMAT), tz);
+};
+const dayjsTzToLocalTZ = (date) => {
+    if (!date)
+        return dayjs(dayjsTz().format(DEFAULT_DATE_FORMAT));
+    return dayjs(dayjsTz(date).format(DEFAULT_DATE_FORMAT));
+};
+const dayjsTzToDate = (date) => {
+    return dayjsTzToLocalTZ(date).toDate();
+};
+
+export { convertDateToTz, dayjsTz, dayjsTzToDate, dayjsTzToLocalTZ, getInitialTimezone, setTz };

package/dist/esm/utils/dayjs.mjs

@@ -0,0 +1,43 @@
+import dayjs from 'dayjs';
+export { default as dayjs } from 'dayjs';
+import quarterOfYear from 'dayjs/plugin/quarterOfYear.js';
+import timezone from 'dayjs/plugin/timezone.js';
+import utc from 'dayjs/plugin/utc.js';
+
+dayjs.extend(utc);
+dayjs.extend(timezone);
+dayjs.extend(quarterOfYear);
+// Stored on `globalThis` (not a module-local `let`): each entry-point bundle gets its
+// own copy of this module, so a local var would let `setTz` and the query builder read
+// different copies. A shared global slot keeps every bundle in sync.
+const TZ_GLOBAL_KEY = '__GEM_SDK_ANALYTICS_TZ__';
+const DEFAULT_DATE_FORMAT = 'YYYY-MM-DD HH:mm:ss';
+function getInitialTimezone() {
+    return globalThis[TZ_GLOBAL_KEY] ?? 'UTC';
+}
+function setTz(value) {
+    globalThis[TZ_GLOBAL_KEY] = value;
+    dayjs.tz.setDefault(value);
+}
+const dayjsTz = (date) => {
+    const tz = getInitialTimezone();
+    if (!date)
+        return dayjs().tz(tz);
+    return dayjs(date).tz(tz);
+};
+const convertDateToTz = (date) => {
+    const tz = getInitialTimezone();
+    if (!date)
+        return dayjs.tz(dayjs().format(DEFAULT_DATE_FORMAT), tz);
+    return dayjs.tz(dayjs(date).format(DEFAULT_DATE_FORMAT), tz);
+};
+const dayjsTzToLocalTZ = (date) => {
+    if (!date)
+        return dayjs(dayjsTz().format(DEFAULT_DATE_FORMAT));
+    return dayjs(dayjsTz(date).format(DEFAULT_DATE_FORMAT));
+};
+const dayjsTzToDate = (date) => {
+    return dayjsTzToLocalTZ(date).toDate();
+};
+
+export { convertDateToTz, dayjsTz, dayjsTzToDate, dayjsTzToLocalTZ, getInitialTimezone, setTz };

package/dist/esm/utils/deep-copy.js

@@ -0,0 +1,7 @@
+const deepCopy = (obj) => {
+    if (typeof obj !== 'object' || obj === null)
+        return obj;
+    return structuredClone(obj);
+};
+
+export { deepCopy };

package/dist/esm/utils/deep-copy.mjs

@@ -0,0 +1,7 @@
+const deepCopy = (obj) => {
+    if (typeof obj !== 'object' || obj === null)
+        return obj;
+    return structuredClone(obj);
+};
+
+export { deepCopy };

package/dist/esm/utils/index.d.ts

@@ -7,3 +7,6 @@ export * from './analytics';
 export * from './deep-copy';
 export * from './template-type';
 export * from './string';
+export * from './array';
+export * from './is-browser';
+export * from './date-time';

package/dist/esm/utils/is-browser.d.ts

@@ -0,0 +1 @@
+export declare const isBrowser: () => boolean;

package/dist/esm/utils/is-browser.js

@@ -0,0 +1,5 @@
+const isBrowser = () => {
+    return typeof window !== 'undefined';
+};
+
+export { isBrowser };

package/dist/esm/utils/is-browser.mjs

@@ -0,0 +1,5 @@
+const isBrowser = () => {
+    return typeof window !== 'undefined';
+};
+
+export { isBrowser };

package/dist/esm/utils/number.js

@@ -0,0 +1,17 @@
+const TRIM_DECIMAL_ZEROS_REGEX = /\.0+$/;
+const DEFAULT_DECIMALS = 2;
+const trimDecimalZeros = (number) => {
+    return `${number}`.replace(TRIM_DECIMAL_ZEROS_REGEX, '');
+};
+const cleanDecimal = (number, decimals = DEFAULT_DECIMALS) => {
+    return trimDecimalZeros(number.toFixed(decimals));
+};
+const semverToNum = (v) => {
+    const [major, minor, patch] = v.split('.').map((n) => Number(n));
+    return (major ?? 0) * 1_000_000 + (minor ?? 0) * 1_000 + (patch ?? 0);
+};
+const numberWithCommas = (x) => {
+    return x.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+};
+
+export { DEFAULT_DECIMALS, TRIM_DECIMAL_ZEROS_REGEX, cleanDecimal, numberWithCommas, semverToNum, trimDecimalZeros };

package/dist/esm/utils/number.mjs

@@ -0,0 +1,17 @@
+const TRIM_DECIMAL_ZEROS_REGEX = /\.0+$/;
+const DEFAULT_DECIMALS = 2;
+const trimDecimalZeros = (number) => {
+    return `${number}`.replace(TRIM_DECIMAL_ZEROS_REGEX, '');
+};
+const cleanDecimal = (number, decimals = DEFAULT_DECIMALS) => {
+    return trimDecimalZeros(number.toFixed(decimals));
+};
+const semverToNum = (v) => {
+    const [major, minor, patch] = v.split('.').map((n) => Number(n));
+    return (major ?? 0) * 1_000_000 + (minor ?? 0) * 1_000 + (patch ?? 0);
+};
+const numberWithCommas = (x) => {
+    return x.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+};
+
+export { DEFAULT_DECIMALS, TRIM_DECIMAL_ZEROS_REGEX, cleanDecimal, numberWithCommas, semverToNum, trimDecimalZeros };

package/dist/esm/utils/percentage.js

@@ -0,0 +1,37 @@
+import { cleanDecimal, DEFAULT_DECIMALS } from './number.js';
+
+/**
+ * Utility function to calculate percentage and format it.
+ * @param part - The part value.
+ * @param total - The total value.
+ * @param decimals - The number of decimal places to format the percentage to.
+ * @returns The formatted percentage as a string.
+ */
+const PERCENTAGE_THRESHOLD = 0.005;
+const PERCENTAGE_THRESHOLD_STRING = '~0%';
+const calcPercentage = (part, total, decimals = DEFAULT_DECIMALS) => {
+    if (typeof part !== 'number' || !total)
+        return undefined;
+    if (part === 0)
+        return 0;
+    const percentage = (part / total) * 100;
+    return parseFloat(cleanDecimal(percentage, decimals));
+};
+const isLessThanThreshold = (percentage) => percentage > 0 && percentage < PERCENTAGE_THRESHOLD;
+const calcPercentageString = (part, total, decimals = 2) => {
+    const percentage = calcPercentage(part, total, decimals);
+    if (typeof percentage !== 'number')
+        return undefined;
+    if (isLessThanThreshold(percentage)) {
+        return PERCENTAGE_THRESHOLD_STRING;
+    }
+    return `${percentage}%`;
+};
+const formatPercentage = (percentage, decimals = DEFAULT_DECIMALS) => {
+    if (isLessThanThreshold(percentage)) {
+        return PERCENTAGE_THRESHOLD_STRING;
+    }
+    return `${cleanDecimal(percentage, decimals)}%`;
+};
+
+export { calcPercentage, calcPercentageString, formatPercentage };

package/dist/esm/utils/percentage.mjs

@@ -0,0 +1,37 @@
+import { cleanDecimal, DEFAULT_DECIMALS } from './number.mjs';
+
+/**
+ * Utility function to calculate percentage and format it.
+ * @param part - The part value.
+ * @param total - The total value.
+ * @param decimals - The number of decimal places to format the percentage to.
+ * @returns The formatted percentage as a string.
+ */
+const PERCENTAGE_THRESHOLD = 0.005;
+const PERCENTAGE_THRESHOLD_STRING = '~0%';
+const calcPercentage = (part, total, decimals = DEFAULT_DECIMALS) => {
+    if (typeof part !== 'number' || !total)
+        return undefined;
+    if (part === 0)
+        return 0;
+    const percentage = (part / total) * 100;
+    return parseFloat(cleanDecimal(percentage, decimals));
+};
+const isLessThanThreshold = (percentage) => percentage > 0 && percentage < PERCENTAGE_THRESHOLD;
+const calcPercentageString = (part, total, decimals = 2) => {
+    const percentage = calcPercentage(part, total, decimals);
+    if (typeof percentage !== 'number')
+        return undefined;
+    if (isLessThanThreshold(percentage)) {
+        return PERCENTAGE_THRESHOLD_STRING;
+    }
+    return `${percentage}%`;
+};
+const formatPercentage = (percentage, decimals = DEFAULT_DECIMALS) => {
+    if (isLessThanThreshold(percentage)) {
+        return PERCENTAGE_THRESHOLD_STRING;
+    }
+    return `${cleanDecimal(percentage, decimals)}%`;
+};
+
+export { calcPercentage, calcPercentageString, formatPercentage };

package/dist/esm/utils/sort.js

@@ -0,0 +1,73 @@
+function compareValues(a, b, order = 'asc') {
+    if (a === b)
+        return 0;
+    if (a === undefined || b === undefined) {
+        if (a === undefined && b !== undefined)
+            return order === 'asc' ? -1 : 1;
+        if (b === undefined && a !== undefined)
+            return order === 'asc' ? 1 : -1;
+        return 0;
+    }
+    const isDate = (val) => typeof val !== 'boolean' && !isNaN(Date.parse(val));
+    const isString = (val) => typeof val === 'string';
+    let comparison = 0;
+    if (isDate(a) && isDate(b)) {
+        const dateA = a instanceof Date ? a : new Date(a);
+        const dateB = b instanceof Date ? b : new Date(b);
+        comparison = dateA > dateB ? 1 : -1;
+    }
+    else if (isString(a) && isString(b)) {
+        comparison = a > b ? 1 : -1;
+    }
+    else {
+        comparison = a > b ? 1 : -1;
+    }
+    return order === 'asc' ? -comparison : comparison;
+}
+function getNestedValue(obj, path) {
+    if (typeof path === 'string') {
+        return path
+            .replace(/\[(\d+)\]/g, '.$1')
+            .split('.')
+            .reduce((acc, key) => acc?.[key], obj);
+    }
+    return obj[path];
+}
+function sortByCondition(array, options) {
+    const { attr, order = 'asc', preferredValue, backupAttr, orderArrayAttr, orderArray } = options;
+    return array.slice().sort((a, b) => {
+        const valueA = getNestedValue(a, attr);
+        const valueB = getNestedValue(b, attr);
+        if (preferredValue !== undefined) {
+            if (valueA === preferredValue && valueB !== preferredValue)
+                return -1;
+            if (valueB === preferredValue && valueA !== preferredValue)
+                return 1;
+        }
+        if (orderArrayAttr === attr && orderArray) {
+            const orderArrayValue = orderArray[order];
+            return orderArrayValue.indexOf(valueA) - orderArrayValue.indexOf(valueB);
+        }
+        const primaryComparison = compareValues(valueA, valueB, order);
+        if (primaryComparison !== 0)
+            return primaryComparison;
+        if (backupAttr)
+            return compareValues(a[backupAttr], b[backupAttr], order);
+        return 0;
+    });
+}
+function sortByConditions(array, optionsArray) {
+    return optionsArray.reduce((sortedArray, options) => {
+        return sortByCondition(sortedArray, options);
+    }, array.slice());
+}
+function sortByArrayOrder(array, order, sortOrder = 'asc') {
+    return array.slice().sort((a, b) => {
+        const indexA = order.indexOf(a);
+        const indexB = order.indexOf(b);
+        const comparison = indexA - indexB;
+        return sortOrder === 'asc' ? comparison : -comparison;
+    });
+}
+
+export { compareValues, getNestedValue, sortByArrayOrder, sortByCondition, sortByConditions };

package/dist/esm/utils/sort.mjs

@@ -0,0 +1,73 @@
+function compareValues(a, b, order = 'asc') {
+    if (a === b)
+        return 0;
+    if (a === undefined || b === undefined) {
+        if (a === undefined && b !== undefined)
+            return order === 'asc' ? -1 : 1;
+        if (b === undefined && a !== undefined)
+            return order === 'asc' ? 1 : -1;
+        return 0;
+    }
+    const isDate = (val) => typeof val !== 'boolean' && !isNaN(Date.parse(val));
+    const isString = (val) => typeof val === 'string';
+    let comparison = 0;
+    if (isDate(a) && isDate(b)) {
+        const dateA = a instanceof Date ? a : new Date(a);
+        const dateB = b instanceof Date ? b : new Date(b);
+        comparison = dateA > dateB ? 1 : -1;
+    }
+    else if (isString(a) && isString(b)) {
+        comparison = a > b ? 1 : -1;
+    }
+    else {
+        comparison = a > b ? 1 : -1;
+    }
+    return order === 'asc' ? -comparison : comparison;
+}
+function getNestedValue(obj, path) {
+    if (typeof path === 'string') {
+        return path
+            .replace(/\[(\d+)\]/g, '.$1')
+            .split('.')
+            .reduce((acc, key) => acc?.[key], obj);
+    }
+    return obj[path];
+}
+function sortByCondition(array, options) {
+    const { attr, order = 'asc', preferredValue, backupAttr, orderArrayAttr, orderArray } = options;
+    return array.slice().sort((a, b) => {
+        const valueA = getNestedValue(a, attr);
+        const valueB = getNestedValue(b, attr);
+        if (preferredValue !== undefined) {
+            if (valueA === preferredValue && valueB !== preferredValue)
+                return -1;
+            if (valueB === preferredValue && valueA !== preferredValue)
+                return 1;
+        }
+        if (orderArrayAttr === attr && orderArray) {
+            const orderArrayValue = orderArray[order];
+            return orderArrayValue.indexOf(valueA) - orderArrayValue.indexOf(valueB);
+        }
+        const primaryComparison = compareValues(valueA, valueB, order);
+        if (primaryComparison !== 0)
+            return primaryComparison;
+        if (backupAttr)
+            return compareValues(a[backupAttr], b[backupAttr], order);
+        return 0;
+    });
+}
+function sortByConditions(array, optionsArray) {
+    return optionsArray.reduce((sortedArray, options) => {
+        return sortByCondition(sortedArray, options);
+    }, array.slice());
+}
+function sortByArrayOrder(array, order, sortOrder = 'asc') {
+    return array.slice().sort((a, b) => {
+        const indexA = order.indexOf(a);
+        const indexB = order.indexOf(b);
+        const comparison = indexA - indexB;
+        return sortOrder === 'asc' ? comparison : -comparison;
+    });
+}
+
+export { compareValues, getNestedValue, sortByArrayOrder, sortByCondition, sortByConditions };

package/dist/esm/utils/string.js

@@ -0,0 +1,7 @@
+const toCapitalize = (string) => {
+    if (!string)
+        return string;
+    return string.charAt(0).toUpperCase() + string.slice(1);
+};
+
+export { toCapitalize };

package/dist/esm/utils/string.mjs

@@ -0,0 +1,7 @@
+const toCapitalize = (string) => {
+    if (!string)
+        return string;
+    return string.charAt(0).toUpperCase() + string.slice(1);
+};
+
+export { toCapitalize };

package/dist/esm/utils/template-type.d.ts

@@ -1,2 +1,2 @@
-import { TemplateType } from '@/types/template';
+import { TemplateType } from '../types/template';
 export declare const parseTemplateType: (templateType?: TemplateType | string) => string;