df-script 1.5.0 → 1.6.0

package/dist/utils/list.js

@@ -1,361 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toValidArray = toValidArray;
-exports.toValidStringArray = toValidStringArray;
-exports.isArrayOfType = isArrayOfType;
-exports.sortList = sortList;
-exports.getListStats = getListStats;
-exports.getUniqueListStats = getUniqueListStats;
-exports.stepSliceList = stepSliceList;
-exports.joinList = joinList;
-exports.fillSequence = fillSequence;
-const guards_1 = require("./guards");
-const date_1 = require("./date");
-const number_1 = require("./number");
-const string_1 = require("./string");
-function toValidArray(val) {
-    if (val == null)
-        return [];
-    if (Array.isArray(val))
-        return [...val];
-    if ((0, guards_1.isTypedArray)(val))
-        return Array.from(val);
-    return [val];
-}
-function toValidStringArray(val) {
-    const arr = toValidArray(val);
-    const len = arr.length;
-    const res = new Array(len);
-    for (let i = 0; i < len; i++) {
-        res[i] = String(arr[i]);
-    }
-    return res;
-}
-function isArrayOfType(arr, type, { mode = "every", allowNulls = false, allowEmpty = true } = {}) {
-    if (!(0, guards_1.isArrayOrTypedArray)(arr))
-        return false;
-    const len = arr.length;
-    if (len === 0) {
-        if (!allowEmpty)
-            return false;
-        return mode === "every";
-    }
-    const list = arr;
-    let check;
-    if (typeof type === "function") {
-        const isC = (0, guards_1.isClass)(type);
-        check = isC
-            ? (v) => v instanceof type
-            : type;
-    }
-    else {
-        switch (type) {
-            case "null":
-                check = (v) => v === null;
-                break;
-            case "undefined":
-                check = (v) => v === undefined;
-                break;
-            case "nullish":
-                check = (v) => v == null;
-                break;
-            case "any":
-                check = () => true;
-                break;
-            case "date":
-                check = date_1.isValidDateObj;
-                break;
-            case "object":
-                check = guards_1.isObj;
-                break;
-            case "plainObject":
-                check = guards_1.isPlainObj;
-                break;
-            case "number":
-                check = number_1.isValidNumber;
-                break;
-            default:
-                check = (v) => typeof v === type;
-                break;
-        }
-    }
-    if (allowNulls) {
-        const baseCheck = check;
-        check = (v) => v == null || baseCheck(v);
-    }
-    if (mode === "every") {
-        for (let i = 0; i < len; i++) {
-            if (!check(list[i]))
-                return false;
-        }
-        return true;
-    }
-    else {
-        for (let i = 0; i < len; i++) {
-            if (check(list[i]))
-                return true;
-        }
-        return false;
-    }
-}
-function sortList(arr, descending = false) {
-    if (!(0, guards_1.isArrayOrTypedArray)(arr))
-        return [];
-    const list = Array.from(arr);
-    list.sort((a, b) => {
-        if (a == null && b == null)
-            return 0;
-        if (a == null)
-            return 1;
-        if (b == null)
-            return -1;
-        if (a < b)
-            return descending ? 1 : -1;
-        if (a > b)
-            return descending ? -1 : 1;
-        return 0;
-    });
-    return list;
-}
-const DEFAULT_STATS = { sum: null, count: 0, min: null, max: null, mean: null, variance: 0, std: 0, nullCount: 0, len: 0, hasNulls: false, isNumeric: false };
-function getListStats(arr) {
-    if (!(0, guards_1.isArrayOrTypedArray)(arr)) {
-        return { ...DEFAULT_STATS };
-    }
-    const len = arr.length;
-    if (len === 0) {
-        return { ...DEFAULT_STATS };
-    }
-    let minVal = null;
-    let maxVal = null;
-    let count = 0;
-    let nullCount = 0;
-    let total = 0;
-    let sumCompensation = 0;
-    let mean = 0;
-    let M2 = 0;
-    for (let i = 0; i < len; i++) {
-        const val = arr[i];
-        if (val == null) {
-            nullCount++;
-            continue;
-        }
-        if (minVal == null || val < minVal)
-            minVal = val;
-        if (maxVal == null || val > maxVal)
-            maxVal = val;
-        const n = (0, number_1.toValidNumber)(val);
-        if (n !== null) {
-            // Neumaier sum
-            const t = total + n;
-            if (Math.abs(total) >= Math.abs(n)) {
-                sumCompensation += (total - t) + n;
-            }
-            else {
-                sumCompensation += (n - t) + total;
-            }
-            total = t;
-            count++;
-            const delta = n - mean;
-            mean += delta / count;
-            const delta2 = n - mean;
-            M2 += delta * delta2;
-        }
-    }
-    const variance = count > 1 ? M2 / (count - 1) : 0;
-    return {
-        sum: count > 0 ? total + sumCompensation : null,
-        count,
-        min: minVal,
-        max: maxVal,
-        mean: count > 0 ? (total + sumCompensation) / count : null,
-        variance,
-        std: Math.sqrt(variance),
-        nullCount,
-        len,
-        hasNulls: nullCount > 0,
-        isNumeric: count > 0 && count === (len - nullCount)
-    };
-}
-function getUniqueListStats(arr, { strict = false, keySelector } = {}) {
-    const list = Array.from(arr);
-    const frequencies = new Map();
-    if (strict) {
-        const selector = keySelector ?? string_1.toCanonicalString;
-        const seen = new Map();
-        const len = list.length;
-        for (let i = 0; i < len; i++) {
-            const val = list[i];
-            const key = selector(val);
-            const entry = seen.get(key);
-            if (entry === undefined) {
-                seen.set(key, { val, count: 1 });
-            }
-            else {
-                entry.count++;
-            }
-        }
-        const values = [];
-        for (const entry of seen.values()) {
-            values.push(entry.val);
-        }
-        for (let i = 0; i < len; i++) {
-            const val = list[i];
-            const key = selector(val);
-            const entry = seen.get(key);
-            frequencies.set(val, entry.count);
-        }
-        return {
-            values,
-            count: values.length,
-            frequencies
-        };
-    }
-    const len = list.length;
-    for (let i = 0; i < len; i++) {
-        const val = list[i];
-        frequencies.set(val, (frequencies.get(val) ?? 0) + 1);
-    }
-    return {
-        values: Array.from(frequencies.keys()),
-        count: frequencies.size,
-        frequencies
-    };
-}
-function stepSliceList(arr, { step = 1, offsetStart = 0, offsetEnd, maxItemsGathered, null_on_oob = true } = {}) {
-    if (arr == null) {
-        return null;
-    }
-    if (maxItemsGathered !== undefined && maxItemsGathered <= 0) {
-        return [];
-    }
-    if (step === 0) {
-        throw new Error("Step size step cannot be zero");
-    }
-    const len = arr.length;
-    const isOob = len === 0
-        ? (offsetStart !== 0)
-        : (offsetStart >= len || offsetStart < -len);
-    if (isOob) {
-        if (!null_on_oob) {
-            throw new Error(`Start offset ${offsetStart} is out of bounds for list of length ${len}`);
-        }
-        return null;
-    }
-    const start = offsetStart < 0 ? len + offsetStart : offsetStart;
-    const end = offsetEnd !== undefined
-        ? (offsetEnd < 0 ? len + offsetEnd : offsetEnd)
-        : (step > 0 ? len : -1);
-    const res = [];
-    if (step > 0) {
-        for (let i = start; i < end && i < len; i += step) {
-            if (i >= 0) {
-                res.push(arr[i]);
-                if (maxItemsGathered !== undefined && res.length >= maxItemsGathered) {
-                    break;
-                }
-            }
-        }
-    }
-    else {
-        for (let i = start; i > end && i >= 0; i += step) {
-            if (i < len) {
-                res.push(arr[i]);
-                if (maxItemsGathered !== undefined && res.length >= maxItemsGathered) {
-                    break;
-                }
-            }
-        }
-    }
-    return res;
-}
-/**
- * Joins the elements of an array-like structure into a string using a separator.
- * Excludes nullish checks and formats nested arrays cleanly.
- */
-function joinList(arr, separator = ",", { ignoreNulls = false, nullValue = "", prefix = "", suffix = "", limit, truncationMarker = "...", valueFormatter } = {}) {
-    const len = arr.length;
-    const strList = [];
-    const maxLimit = limit !== undefined ? Math.max(0, limit) : len;
-    let truncated = false;
-    for (let i = 0; i < len; i++) {
-        if (strList.length >= maxLimit) {
-            truncated = true;
-            break;
-        }
-        const x = arr[i];
-        if (x != null) {
-            strList.push(valueFormatter ? valueFormatter(x, i) : String(x));
-        }
-        else if (!ignoreNulls) {
-            strList.push(nullValue);
-        }
-    }
-    return prefix + strList.join(separator) + (truncated ? truncationMarker : "") + suffix;
-}
-function fillSequence(targetArray, initialValue, options = {}) {
-    const len = targetArray.length;
-    const { mode = "cumulative", step = 1, coerce = (v) => v, condition, reverse = false, startIndex = reverse ? len - 1 : 0, endIndex = reverse ? -1 : len } = options;
-    const increment = reverse ? -1 : 1;
-    const start = startIndex;
-    const end = endIndex;
-    const writeVal = (idx, val) => {
-        if (!condition || condition(targetArray[idx], idx, targetArray)) {
-            targetArray[idx] = coerce(val);
-        }
-    };
-    if (mode === "constant") {
-        const finalVal = coerce(initialValue);
-        for (let i = start; reverse ? i > end : i < end; i += increment) {
-            writeVal(i, finalVal);
-        }
-    }
-    else if (mode === "independent") {
-        if (typeof step === "function") {
-            let relativeIdx = 0;
-            for (let i = start; reverse ? i > end : i < end; i += increment) {
-                writeVal(i, step({
-                    index: relativeIdx,
-                    initialValue,
-                    originalValue: targetArray[i],
-                    absoluteIndex: i,
-                    targetArray
-                }));
-                relativeIdx++;
-            }
-        }
-        else {
-            for (let i = start; reverse ? i > end : i < end; i += increment) {
-                writeVal(i, initialValue + i * step);
-            }
-        }
-    }
-    else {
-        // cumulative mode
-        let current = initialValue;
-        let isFirst = true;
-        let relativeIdx = 0;
-        for (let i = start; reverse ? i > end : i < end; i += increment) {
-            if (isFirst) {
-                writeVal(i, current);
-                isFirst = false;
-            }
-            else {
-                if (typeof step === "function") {
-                    current = step({
-                        prev: current,
-                        index: relativeIdx,
-                        originalValue: targetArray[i],
-                        absoluteIndex: i,
-                        targetArray
-                    });
-                }
-                else {
-                    current = current + step;
-                }
-                writeVal(i, current);
-            }
-            relativeIdx++;
-        }
-    }
-}