@zuzjs/core 0.3.0 → 0.3.2

package/dist/cjs/index.js

@@ -1,380 +0,0 @@
-import axios from "axios";
-import fs from "fs/promises";
-import Hashids from "hashids";
-import Cookies from "js-cookie";
-import md5 from "md5";
-import moment from "moment";
-import { colorNames } from "./colors.js";
-import { hexColorRegex, hslColorRegex, rgbaColorRegex } from "./regexps.js";
-import { SORT } from "./types.js";
-import _ from "./withGlobals.js";
-export * from "./types.js";
-export const __SALT = `zuzjs-core`;
-export { default as "_" } from "./withGlobals.js";
-export const numberInRange = (min, max) => {
-    return Math.floor(Math.random() * (max - min + 1)) + min;
-};
-export const toHash = (n, len = 6, SALT = null) => new Hashids(SALT || __SALT, len).encode(n);
-export const fromHash = (str, SALT = null) => {
-    try {
-        const n = new Hashids(SALT || __SALT, +process.env.HASHIDS_LENGTH).decode(str);
-        return n.length >= 0 ? Number(n[0]) : 0;
-    }
-    catch (e) {
-        return 0;
-    }
-};
-export const MD5 = (str) => md5(str);
-export const uuid = (len) => toHash(numberInRange(11111111111, 999999999999));
-export const ucfirst = (o) => `${o.charAt(0).toUpperCase()}${o.substring(1, o.length)}`;
-export const urldecode = (str) => decodeURIComponent(str.replace(/\+/g, '%20'));
-export const urlencode = (str) => encodeURIComponent(str);
-export const pluralize = (word, count) => `${word}${count !== 1 ? 's' : ''}`;
-export const isHexColor = (color) => hexColorRegex.test(color);
-export const isRgbaColor = (color) => rgbaColorRegex.test(color);
-export const isHslColor = (color) => hslColorRegex.test(color);
-export const isColorName = (color) => colorNames.includes(color.toLowerCase());
-// Function to validate a color string
-export const isColor = (color) => isHexColor(color) || isRgbaColor(color) || isHslColor(color);
-export const hexToRgba = (hex, alpha = 1) => {
-    // Remove the hash symbol if present
-    hex = hex.replace(/^#/, '');
-    // If shorthand hex (#RGB), expand it to full form (#RRGGBB)
-    if (hex.length === 3) {
-        hex = hex.split('').map(char => char + char).join('');
-    }
-    // Convert to integer values for RGB
-    const bigint = parseInt(hex, 16);
-    const r = (bigint >> 16) & 255;
-    const g = (bigint >> 8) & 255;
-    const b = bigint & 255;
-    return `rgba(${r}, ${g}, ${b}, ${alpha})`;
-};
-export const removeDuplicates = (array) => {
-    return array.reduce((accumulator, currentValue) => {
-        if (!accumulator.includes(currentValue)) {
-            accumulator.push(currentValue);
-        }
-        return accumulator;
-    }, []);
-};
-export const getCancelToken = () => axios.CancelToken.source();
-export const withCredentials = (include) => axios.defaults.withCredentials = include;
-export const withPost = async (uri, data, // 'dynamic' usually maps to 'any' or 'Record<string, any>'
-timeout = 60, ignoreKind = false, headers = {}, onProgress) => {
-    const _cookies = Cookies.get();
-    let finalData = data;
-    let contentType = 'application/json';
-    // 1. Data Preparation Logic
-    if (data instanceof FormData) {
-        contentType = 'multipart/form-data';
-        for (const [key, value] of Object.entries(_cookies)) {
-            data.append(key, value);
-        }
-    }
-    else if (typeof data === "object" && !Array.isArray(data) && data !== null) {
-        // Handle standard objects: inject cookies and timestamp
-        finalData = {
-            ...data,
-            ..._cookies,
-            __stmp: Date.now() / 1000
-        };
-    }
-    else if (!_(data).isString()) {
-        // If it's not FormData, an Object, or a String, reject immediately
-        throw new Error("Unsupported data type for withPost");
-    }
-    // 2. Single Axios Execution
-    try {
-        const resp = await axios({
-            method: 'post',
-            url: uri,
-            data: finalData,
-            timeout: timeout * 1000,
-            headers: {
-                'Content-Type': contentType,
-                ...headers
-            },
-            onUploadProgress: onProgress
-        });
-        // 3. Response Validation
-        if (resp.data && (ignoreKind || "kind" in resp.data)) {
-            return resp.data;
-        }
-        else {
-            throw resp.data;
-        }
-    }
-    catch (err) {
-        // 4. Centralized Error Handling
-        if (err?.response?.data) {
-            throw err.response.data;
-        }
-        throw err.code === `ERR_NETWORK`
-            ? {
-                error: err.code,
-                message: navigator.onLine
-                    ? `Unable to connect to the server. It may be temporarily down.`
-                    : `Network error: Unable to connect. Please check your internet connection and try again.`,
-            }
-            : err;
-    }
-};
-export const withGet = async (uri, timeout = 60, ignoreKind = false, headers = {}) => {
-    try {
-        const resp = await axios.get(uri, {
-            timeout: timeout * 1000,
-            headers: headers
-        });
-        if (resp.data && (ignoreKind || "kind" in resp.data)) {
-            return resp.data;
-        }
-        else {
-            throw resp.data;
-        }
-    }
-    catch (err) {
-        if (err?.response?.data) {
-            throw err.response.data;
-        }
-        throw err.code === `ERR_NETWORK`
-            ? {
-                error: err.code,
-                message: navigator.onLine
-                    ? `Unable to connect to the server. It may be temporarily down.`
-                    : `Network error: Unable to connect. Please check your internet connection and try again.`,
-            }
-            : err;
-    }
-};
-export const withTime = (fun) => {
-    const start = new Date().getTime();
-    const result = fun();
-    const end = new Date().getTime();
-    return {
-        result,
-        executionTime: end - start
-    };
-};
-export const time = (stamp, format) => {
-    return stamp ?
-        moment.unix(+stamp / 1000).format(format || `YYYY-MM-DD HH:mm:ss`)
-        : moment().format(format || `YYYY-MM-DD HH:mm:ss`);
-};
-export const timeSince = (stamp) => moment(stamp).fromNow();
-export const arrayRand = (arr) => arr[Math.floor(Math.random() * arr.length)];
-export const formatNumber = ({ number, locale = 'en-US', style = `decimal`, decimal = 2, forceDecimal = false, currency }) => {
-    if (style === 'currency' && !currency) {
-        throw new TypeError('Currency code is required with currency style.');
-    }
-    if (currency) {
-        const { code, style: currencyStyle, symbol } = currency;
-        const out = new Intl.NumberFormat(locale, {
-            style: `currency`,
-            currency: code,
-            currencyDisplay: currencyStyle,
-            minimumFractionDigits: forceDecimal ? decimal : +number % 1 > 0 ? decimal : 0,
-            maximumFractionDigits: forceDecimal ? decimal : +number % 1 > 0 ? decimal : 0
-        }).format(+number);
-        return symbol ? out.replace(new RegExp(`\\${code}`, 'g'), symbol) : out;
-    }
-    return new Intl.NumberFormat(locale, {
-        style,
-        minimumFractionDigits: forceDecimal ? decimal : +number % 1 > 0 ? 2 : 0,
-        maximumFractionDigits: forceDecimal ? decimal : +number % 1 > 0 ? 2 : 0
-    }).format(+number);
-};
-export const formatSize = (bytes) => {
-    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
-    const _bytes = `string` == typeof bytes ? parseFloat(bytes) : bytes;
-    if (_bytes == 0)
-        return '0 Byte';
-    const _i = Math.floor(Math.log(_bytes) / Math.log(1024));
-    const i = `string` == typeof _i ? parseInt(_i) : _i;
-    const nx = _bytes / Math.pow(1024, i);
-    return nx.toFixed(2) + ' ' + sizes[i];
-};
-export const copyToClipboard = (text) => {
-    if (navigator.clipboard && navigator.clipboard.writeText) {
-        return navigator.clipboard.writeText(text);
-    }
-    else {
-        return new Promise((resolve, reject) => {
-            const textarea = document.createElement("textarea");
-            textarea.value = text;
-            textarea.style.position = "fixed"; // Prevent scrolling to bottom of page in MS Edge.
-            document.body.appendChild(textarea);
-            textarea.focus();
-            textarea.select();
-            try {
-                document.execCommand("copy");
-                resolve(`Copied to clipboard`);
-            }
-            catch (err) {
-                // console.error("Fallback: Oops, unable to copy", err);
-                reject(err);
-            }
-            document.body.removeChild(textarea);
-        });
-    }
-};
-export const natsort = (options = {
-    direction: SORT.Asc,
-    caseSensitive: false,
-}) => {
-    const ore = /^0/;
-    const sre = /\s+/g;
-    const tre = /^\s+|\s+$/g;
-    // unicode
-    const ure = /[^\x00-\x80]/;
-    // hex
-    const hre = /^0x[0-9a-f]+$/i;
-    // numeric
-    const nre = /(0x[\da-fA-F]+|(^[\+\-]?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?(?=\D|\s|$))|\d+)/g;
-    // datetime
-    const dre = /(^([\w ]+,?[\w ]+)?[\w ]+,?[\w ]+\d+:\d+(:\d+)?[\w ]?|^\d{1,4}[\/\-]\d{1,4}[\/\-]\d{1,4}|^\w+, \w+ \d+, \d{4})/; // tslint:disable-line
-    const GREATER = options.direction == SORT.Desc ? -1 : 1;
-    const SMALLER = -GREATER;
-    const _normalize = !options.caseSensitive
-        ? (s) => s.toString().toLowerCase().replace(tre, '')
-        : (s) => (`${s}`).replace(tre, '');
-    const _tokenize = (s) => {
-        return s.replace(nre, '\0$1\0')
-            .replace(/\0$/, '')
-            .replace(/^\0/, '')
-            .split('\0');
-    };
-    const _parse = (s, l) => {
-        return (!s.match(ore) || l === 1) &&
-            parseFloat(s)
-            || s.replace(sre, ' ').replace(tre, '')
-            || 0;
-    };
-    return function (a, b) {
-        const aa = _normalize(a);
-        const bb = _normalize(b);
-        if (!aa && !bb) {
-            return 0;
-        }
-        if (!aa && bb) {
-            return SMALLER;
-        }
-        if (aa && !bb) {
-            return GREATER;
-        }
-        const aArr = _tokenize(aa);
-        const bArr = _tokenize(bb);
-        // hex or date detection
-        const aHex = aa.match(hre);
-        const bHex = bb.match(hre);
-        const av = (aHex && bHex) ? parseInt(aHex[0], 16) : (aArr.length !== 1 && Date.parse(aa));
-        const bv = (aHex && bHex)
-            ? parseInt(bHex[0], 16)
-            : av && bb.match(dre) && Date.parse(bb) || null;
-        // try and sort Hex codes or Dates
-        if (bv) {
-            if (av === bv) {
-                return 0;
-            }
-            if (typeof av === 'number' && typeof bv === 'number' && av < bv) {
-                return SMALLER;
-            }
-            if (typeof av === 'number' && av > bv) {
-                return GREATER;
-            }
-        }
-        const al = aArr.length;
-        const bl = bArr.length;
-        // handle numeric strings and default strings
-        for (let i = 0, l = Math.max(al, bl); i < l; i += 1) {
-            const af = _parse(aArr[i] || '', al);
-            const bf = _parse(bArr[i] || '', bl);
-            if (isNaN(af) !== isNaN(bf)) {
-                return isNaN(af) ? GREATER : SMALLER;
-            }
-            if (ure.test(af + bf) && af.localeCompare) {
-                const comp = af.localeCompare(bf);
-                if (comp > 0) {
-                    return GREATER;
-                }
-                if (comp < 0) {
-                    return SMALLER;
-                }
-                if (i === l - 1) {
-                    return 0;
-                }
-            }
-            if (af < bf) {
-                return SMALLER;
-            }
-            if (af > bf) {
-                return GREATER;
-            }
-            if (`${af}` < `${bf}`) {
-                return SMALLER;
-            }
-            if (`${af}` > `${bf}`) {
-                return GREATER;
-            }
-        }
-        return 0;
-    };
-};
-export const camelCase = (str, ucf = false) => {
-    return str
-        .toLowerCase()
-        .split(/[^a-zA-Z0-9]+/) // Split by any non-alphanumeric character
-        .map((word, index) => index === 0
-        ? ucf ? ucfirst(word) : word
-        : ucfirst(word))
-        .join('');
-};
-export const camelCaseToDash = (str) => str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
-export const clamp = (value, min, max) => {
-    return Math.min(Math.max(value, min), max);
-};
-export const slugify = (text, separator = "-") => {
-    if (undefined == text) {
-        console.log(text, `is undefined`);
-        return ``;
-    }
-    return text
-        .normalize("NFKD") // Normalize accents (e.g., é → e)
-        .replace(/[\u0300-\u036f]/g, "") // Remove diacritic marks
-        .toLowerCase()
-        .replace(/[^a-z0-9\p{L}\p{N}]+/gu, separator) // Keep letters/numbers from all languages
-        .replace(new RegExp(`\\${separator}{2,}`, "g"), separator) // Remove duplicate separators
-        .replace(new RegExp(`^\\${separator}|\\${separator}$`, "g"), ""); // Trim separators from ends
-};
-export const animateCSSVar = (ref, variable, to, { lerpFactor = 0.1, threshold = 0.1, multiplier = 1, } = {}) => {
-    if (!ref.current)
-        return;
-    let current = parseFloat(getComputedStyle(ref.current).getPropertyValue(variable)) || 0;
-    let target = to * multiplier;
-    let rafId = null;
-    const tick = () => {
-        current += (target - current) * lerpFactor;
-        if (ref.current) {
-            ref.current.style.setProperty(variable, `${current}px`);
-        }
-        if (Math.abs(target - current) > threshold) {
-            rafId = requestAnimationFrame(tick);
-        }
-    };
-    // Cancel if a new target arrives
-    if (rafId)
-        cancelAnimationFrame(rafId);
-    requestAnimationFrame(tick);
-};
-export const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
-export const enumToKeys = (obj) => Object.keys(obj)
-    .filter((key) => isNaN(Number(key)));
-export const exists = async (path) => {
-    try {
-        await fs.access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};

package/dist/cjs/regexps.d.ts

@@ -1,3 +0,0 @@
-export declare const hexColorRegex: RegExp;
-export declare const rgbaColorRegex: RegExp;
-export declare const hslColorRegex: RegExp;

package/dist/cjs/regexps.js

@@ -1,6 +0,0 @@
-// Hex color regex (#RGB, #RRGGBB)
-export const hexColorRegex = /^#([A-Fa-f0-9]{3}){1,2}$/;
-// RGBA color regex (rgba(255, 255, 255, 1))
-export const rgbaColorRegex = /^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*(,\s*((0|1|0?\.\d+)\s*))?\)$/;
-// HSL color regex (hsl(360, 100%, 100%))
-export const hslColorRegex = /^hsl\(\s*(\d{1,3})\s*,\s*(\d{1,3})%\s*,\s*(\d{1,3})%\s*\)$/;

package/dist/cjs/types.d.ts

@@ -1,23 +0,0 @@
-export type dynamic = {
-    [x: string]: any;
-};
-export interface FormatNumberParams {
-    number: number | string;
-    locale?: string;
-    style?: `decimal` | `currency` | `percent`;
-    decimal?: number;
-    forceDecimal?: boolean;
-    currency?: {
-        code: string;
-        style: `symbol` | `code` | `name`;
-        symbol?: string;
-    };
-}
-export declare enum SORT {
-    Asc = "ASC",
-    Desc = "DESC"
-}
-export type sortOptions = {
-    direction?: SORT;
-    caseSensitive?: boolean;
-};

package/dist/cjs/types.js

@@ -1,5 +0,0 @@
-export var SORT;
-(function (SORT) {
-    SORT["Asc"] = "ASC";
-    SORT["Desc"] = "DESC";
-})(SORT || (SORT = {}));

package/dist/cjs/withGlobals.d.ts

@@ -1,41 +0,0 @@
-declare class withGlobals {
-    _: any;
-    constructor(value: any);
-    isIP(): boolean;
-    isIPv4(): boolean;
-    isIPv6(): boolean;
-    isTypeof(v: any): boolean;
-    isFunction(): boolean;
-    isArray(): boolean;
-    isNull(): boolean;
-    isString(): boolean;
-    isNumber(): boolean;
-    isObject(): boolean;
-    isEmpty(): boolean;
-    isEmail(): boolean;
-    isUrl(): boolean;
-    toLowerCase(): this;
-    /**
-     * Performs a deep equality check for arrays and objects, otherwise a strict equality check.
-     * @param v The value to compare against.
-     * @returns {boolean} True if the values are equal, false otherwise.
-     */
-    equals(v: any): boolean;
-    private isObjectValue;
-    ucfirst(): this;
-    formatString(v: string | number, ...vv: (string | number)[]): this;
-    camelCase(): this;
-    /**
-     * Sorts the keys of the internal object in ascending or descending order.
-     * If the internal value is not an object, it remains unchanged.
-     * @param order The sort order: 'asc' for ascending (default), 'desc' for descending.
-     * @returns {this} The current instance for chaining.
-     */
-    sort(order?: 'asc' | 'desc'): this;
-    value(): any;
-    valueOf(): any;
-    toString(): string;
-    [Symbol.toPrimitive](hint: string): string | number | boolean;
-}
-declare const _: <T>(value: T) => withGlobals;
-export default _;

package/dist/cjs/withGlobals.js

@@ -1,177 +0,0 @@
-import ipRegex from 'ip-regex';
-class withGlobals {
-    _;
-    constructor(value) {
-        this._ = value;
-    }
-    isIP() {
-        return this.isIPv4() || this.isIPv6();
-    }
-    isIPv4() {
-        return ipRegex.v4({ exact: true }).test(this._);
-    }
-    isIPv6() {
-        return ipRegex.v6({ exact: true }).test(this._);
-    }
-    isTypeof(v) {
-        return typeof this._ === typeof v;
-    }
-    isFunction() {
-        return typeof this._ === "function";
-    }
-    isArray() {
-        return Array.isArray(this._);
-    }
-    isNull() {
-        return this._ === null;
-    }
-    isString() {
-        return typeof this._ === "string";
-    }
-    isNumber() {
-        return /^[+-]?\d+(\.\d+)?$/.test(this._);
-    }
-    isObject() {
-        return typeof this._ === "object" && !Array.isArray(this._) && this._ !== null;
-    }
-    isEmpty() {
-        if (Array.isArray(this._))
-            return this._.length === 0;
-        if (typeof this._ === "object" && this._ !== null)
-            return Object.keys(this._).length === 0;
-        return this._ === "" || String(this._).length === 0;
-    }
-    isEmail() {
-        return typeof this._ === "string" && /^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$/.test(this._);
-    }
-    isUrl() {
-        return typeof this._ === "string" && /^(https?:\/\/)?(www\.)?([a-zA-Z0-9-]+\.)+[a-zA-Z]{2,}(\/[^\s]*)?$/.test(this._);
-    }
-    toLowerCase() {
-        this._ = typeof this._ === "string" ? this._.toLowerCase() : String(this._).toLowerCase();
-        return this;
-    }
-    /**
-     * Performs a deep equality check for arrays and objects, otherwise a strict equality check.
-     * @param v The value to compare against.
-     * @returns {boolean} True if the values are equal, false otherwise.
-     */
-    equals(v) {
-        const a = this._;
-        const b = v;
-        // Helper function for deep equality
-        const deepEqual = (val1, val2) => {
-            // If both are strictly equal, they are equal (handles primitives, null, undefined)
-            if (val1 === val2) {
-                return true;
-            }
-            // If one is null or not an object, and they are not strictly equal, they are not equal
-            if (val1 === null || typeof val1 !== 'object' ||
-                val2 === null || typeof val2 !== 'object') {
-                return false;
-            }
-            // Check if both are arrays
-            if (Array.isArray(val1) && Array.isArray(val2)) {
-                if (val1.length !== val2.length) {
-                    return false;
-                }
-                for (let i = 0; i < val1.length; i++) {
-                    if (!deepEqual(val1[i], val2[i])) {
-                        return false;
-                    }
-                }
-                return true;
-            }
-            // Check if both are objects (and not arrays, handled above)
-            if (this.isObjectValue(val1) && this.isObjectValue(val2)) {
-                const keys1 = Object.keys(val1);
-                const keys2 = Object.keys(val2);
-                if (keys1.length !== keys2.length) {
-                    return false;
-                }
-                for (const key of keys1) {
-                    if (!keys2.includes(key) || !deepEqual(val1[key], val2[key])) {
-                        return false;
-                    }
-                }
-                return true;
-            }
-            // If types don't match (e.g., one is array, one is object) or other complex types not handled
-            return false;
-        };
-        // Helper to check if a value is a plain object (not null and not an array)
-        const isObjectValue = (val) => typeof val === 'object' && val !== null && !Array.isArray(val);
-        this.isObjectValue = isObjectValue; // Temporarily add to context for deepEqual to access
-        // Main logic for the equals method
-        if (Array.isArray(a) && Array.isArray(b)) {
-            return deepEqual(a, b);
-        }
-        if (isObjectValue(a) && isObjectValue(b)) {
-            return deepEqual(a, b);
-        }
-        // For all other types, use strict equality
-        return a === b;
-    }
-    // Helper method to determine if a value is a plain object (not null and not an array)
-    // This is added as a class method for better encapsulation and reusability if needed elsewhere.
-    isObjectValue(val) {
-        return typeof val === 'object' && val !== null && !Array.isArray(val);
-    }
-    ucfirst() {
-        this._ = typeof this._ === "string" ? this._.charAt(0).toUpperCase() + this._.slice(1) : this._;
-        return this;
-    }
-    formatString(v, ...vv) {
-        if (typeof this._ !== "string")
-            this._ = "";
-        const values = [v, ...vv];
-        this._ = this._.replace(/%(\d+)/g, (inp, index) => values[Number(index)]?.toString() || `%${index}`);
-        return this;
-    }
-    camelCase() {
-        this._ = typeof this._ === "string"
-            ? this._
-                .split(/[^a-zA-Z0-9]+/)
-                .map((word, index) => index === 0 ? word : word.charAt(0).toUpperCase() + word.slice(1))
-                .join("")
-            : this._;
-        return this;
-    }
-    /**
-     * Sorts the keys of the internal object in ascending or descending order.
-     * If the internal value is not an object, it remains unchanged.
-     * @param order The sort order: 'asc' for ascending (default), 'desc' for descending.
-     * @returns {this} The current instance for chaining.
-     */
-    sort(order = 'asc') {
-        if (!this.isObject()) {
-            console.warn("sortKeys can only be applied to objects. Current value is not an object.");
-            return this;
-        }
-        const obj = this._;
-        const sortedKeys = Object.keys(obj).sort((a, b) => {
-            if (order === 'desc') {
-                return b.localeCompare(a);
-            }
-            return a.localeCompare(b);
-        });
-        const sortedObject = {};
-        for (const key of sortedKeys) {
-            sortedObject[key] = obj[key];
-        }
-        this._ = sortedObject;
-        return this;
-    }
-    value() { return this._; }
-    valueOf() { return this._; }
-    toString() { return String(this._); }
-    [Symbol.toPrimitive](hint) {
-        if (hint === "number")
-            return Number(this._);
-        if (hint === "boolean")
-            return Boolean(this._);
-        return String(this._);
-    }
-}
-const _ = (value) => new withGlobals(value);
-export default _;

package/dist/esm/colors.d.ts

@@ -1,24 +0,0 @@
-/**
- * An array of color names.
- *
- * @remarks
- * This array contains a list of color names that can be used in CSS or other color-related operations.
- */
-export declare const colorNames: string[];
-/**
- * colorPalatter contains colors and their corresponding shades.
- */
-export declare const colorPalette: {
-    green: {
-        50: string;
-        100: string;
-        200: string;
-        300: string;
-        400: string;
-        500: string;
-        600: string;
-        700: string;
-        800: string;
-        900: string;
-    };
-};