df-script 1.5.0 → 1.7.0

package/dist/utils/json.js

@@ -1,217 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isJsonString = isJsonString;
-exports.safeJsonParse = safeJsonParse;
-exports.createSafeJsonReplacer = createSafeJsonReplacer;
-const guards_1 = require("./guards");
-const date_1 = require("./date");
-const NEWLINE_REGEX = /\r\n|\n|\r/g;
-const NO_FALLBACK = Symbol("no_fallback");
-const isWrapped = (str) => {
-    const len = str.length;
-    if (len < 2)
-        return false;
-    const fChar = str[0];
-    const lChar = str[len - 1];
-    return (fChar === "{" && lChar === "}") || (fChar === "[" && lChar === "]");
-};
-const isWrappedUntrimmed = (str) => {
-    let first = 0;
-    const len = str.length;
-    while (first < len && /\s/.test(str[first])) {
-        first++;
-    }
-    let last = len - 1;
-    while (last >= first && /\s/.test(str[last])) {
-        last--;
-    }
-    if (first >= last)
-        return false;
-    const fChar = str[first];
-    const lChar = str[last];
-    return (fChar === "{" && lChar === "}") || (fChar === "[" && lChar === "]");
-};
-/**
- * Validates whether the given value is a valid JSON or NDJSON string.
- * Leverages single-pass parsing under the hood to ensure zero duplicate loops.
- *
- * @param input - The value to check.
- * @param options - Configuration options for validation.
- * @returns `true` if the input is a valid JSON or NDJSON string; `false` otherwise.
- */
-function isJsonString(input, options = {}) {
-    if (typeof input !== "string")
-        return false;
-    const sentinel = Symbol("invalid");
-    const result = safeJsonParse(input, {
-        ...options,
-        fallback: sentinel,
-        onError: () => { } // Silence errors during pure structural checking
-    });
-    return result !== sentinel;
-}
-/**
- * Safely parses a string containing JSON or NDJSON content in a single pass, returning the parsed value if successful
- * and passing the guard validation. If parsing or validation fails, returns the fallback value (if provided)
- * or the original input.
- *
- * @param input - The value to parse.
- * @param options - Configuration options for parsing and validation.
- * @returns The parsed value, the fallback, or the original input.
- */
-function safeJsonParse(input, { format = "json", allowPrimitives = false, trimBeforeParse = false, reviver, ndjson: { skipInvalidLines = false, maxLines, skipLines } = {}, guard, onError, fallback = NO_FALLBACK } = {}) {
-    if (typeof input !== "string") {
-        return fallback !== NO_FALLBACK ? fallback : input;
-    }
-    const s = trimBeforeParse ? input.trim() : input;
-    if (s === "") {
-        return fallback !== NO_FALLBACK ? fallback : input;
-    }
-    let result;
-    try {
-        if (format === "ndjson") {
-            const parsedData = [];
-            let nonEmptyCount = 0;
-            let parsedCount = 0;
-            let lastIndex = 0;
-            NEWLINE_REGEX.lastIndex = 0;
-            let match;
-            while (true) {
-                match = NEWLINE_REGEX.exec(s);
-                const line = match ? s.substring(lastIndex, match.index) : s.substring(lastIndex);
-                if (match) {
-                    lastIndex = NEWLINE_REGEX.lastIndex;
-                }
-                const trimmedLine = line.trim();
-                if (trimmedLine !== "") {
-                    nonEmptyCount++;
-                    if (skipLines === undefined || nonEmptyCount > skipLines) {
-                        if (!allowPrimitives && !isWrapped(trimmedLine)) {
-                            if (!skipInvalidLines) {
-                                throw new Error("NDJSON line is not wrapped and primitives are disallowed");
-                            }
-                        }
-                        else {
-                            try {
-                                parsedData.push(JSON.parse(trimmedLine, reviver));
-                                parsedCount++;
-                                if (maxLines !== undefined && parsedCount >= maxLines)
-                                    break;
-                            }
-                            catch (err) {
-                                if (!skipInvalidLines)
-                                    throw err;
-                            }
-                        }
-                    }
-                }
-                if (!match)
-                    break;
-            }
-            if (parsedData.length === 0) {
-                throw new Error("No valid NDJSON lines processed");
-            }
-            result = parsedData;
-        }
-        else {
-            if (!allowPrimitives && !isWrappedUntrimmed(s)) {
-                throw new Error("JSON string is not wrapped and primitives are disallowed");
-            }
-            result = JSON.parse(s, reviver);
-        }
-    }
-    catch (err) {
-        onError?.(err);
-        return fallback !== NO_FALLBACK ? fallback : input;
-    }
-    if (guard && !guard(result)) {
-        onError?.(new Error("Parsed value failed guard validation"));
-        return fallback !== NO_FALLBACK ? fallback : input;
-    }
-    return result;
-}
-function createSafeJsonReplacer(options = {}) {
-    const bigintStrat = options.bigintStrategy ?? "string";
-    let seen = options.handleCircular ? new WeakSet() : null;
-    const isArrayReplacer = Array.isArray(options.replacer);
-    const whitelist = isArrayReplacer ? options.replacer.map(String) : null;
-    const handleBigInt = (val) => {
-        if (bigintStrat === "number") {
-            return val <= BigInt(Number.MAX_SAFE_INTEGER) && val >= BigInt(Number.MIN_SAFE_INTEGER)
-                ? Number(val)
-                : val.toString();
-        }
-        return val.toString();
-    };
-    return function replacer(k, v) {
-        let val = v;
-        if (typeof options.replacer === "function") {
-            val = options.replacer.call(this, k, v);
-        }
-        else if (whitelist) {
-            if (k !== "" && !Array.isArray(this) && !whitelist.includes(k)) {
-                return undefined;
-            }
-        }
-        if (val === undefined)
-            return undefined;
-        const raw = (val === v && this != null) ? this[k] : val;
-        if (typeof options.onCustom === "function") {
-            const customVal = options.onCustom.call(this, k, raw);
-            if (customVal !== raw || (customVal === undefined && raw !== undefined)) {
-                return customVal;
-            }
-        }
-        if (raw !== null && typeof raw !== "object" && typeof raw !== "bigint") {
-            return val;
-        }
-        if (seen && raw !== null && typeof raw === "object") {
-            if (k === "") {
-                seen = new WeakSet();
-            }
-            if (seen.has(raw)) {
-                return options.onCircular ? options.onCircular.call(this, k, raw) : "[Circular]";
-            }
-            seen.add(raw);
-        }
-        if (typeof raw === "bigint") {
-            if (options.voidBigIntReplacement)
-                return val;
-            return options.onBigInt ? options.onBigInt(raw) : handleBigInt(raw);
-        }
-        if ((0, guards_1.isTypedArray)(raw)) {
-            if (options.voidTypedArrayReplacement)
-                return val;
-            return options.onTypedArray ? options.onTypedArray(raw) : Array.from(raw);
-        }
-        if (raw instanceof Set) {
-            if (options.voidSetReplacement)
-                return val;
-            return options.onSet ? options.onSet(raw) : Array.from(raw);
-        }
-        if (raw instanceof Map) {
-            if (options.voidMapReplacement)
-                return val;
-            return options.onMap ? options.onMap(raw) : Array.from(raw.entries());
-        }
-        if (raw instanceof RegExp) {
-            if (options.voidRegExpReplacement)
-                return val;
-            return options.onRegExp ? options.onRegExp(raw) : raw.toString();
-        }
-        if ((0, date_1.isValidDateObj)(raw)) {
-            if (options.voidDateReplacement)
-                return val;
-            if (options.onDate)
-                return options.onDate(raw);
-            return options.formatDate ? options.formatDate(raw) : raw.toISOString();
-        }
-        if (raw instanceof Error) {
-            return options.onError ? options.onError(raw) : { name: raw.name, message: raw.message, stack: raw.stack };
-        }
-        if (raw instanceof URLSearchParams) {
-            return options.onURLSearchParams ? options.onURLSearchParams(raw) : raw.toString();
-        }
-        return val;
-    };
-}

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++;
-        }
-    }
-}