@zuzjs/core 0.3.1 → 0.3.2

package/dist/cjs/events.js

@@ -1,82 +0,0 @@
-class Events {
-    _events;
-    constructor() {
-        this._events = [];
-    }
-    /**
-     * Registers an event listener.
-     * @param event The name of the event.
-     * @param fun The callback function.
-     * @param context Optional context (this) for the callback.
-     * @returns A function to unsubscribe this specific listener.
-     */
-    on(event, fun, context) {
-        const evt = this._events.find(x => x.event === event);
-        const id = Symbol('listener_id'); // Give each listener a unique ID
-        const listener = {
-            fun: fun, // Store original function
-            context: context,
-            id: id,
-        };
-        if (!evt) {
-            this._events.push({ event: event, listeners: [listener] });
-        }
-        else {
-            evt.listeners.push(listener);
-        }
-        // Return an unsubscribe function
-        return () => {
-            const currentEvt = this._events.find(x => x.event === event);
-            if (currentEvt) {
-                currentEvt.listeners = currentEvt.listeners.filter(l => l.id !== id);
-                if (currentEvt.listeners.length === 0) {
-                    this._events = this._events.filter(e => e.event !== event);
-                }
-            }
-        };
-    }
-    /**
-     * Removes event listeners matching a specific event and function.
-     * Note: This removes *all* listeners for the event that use the exact same function reference.
-     * It's often more reliable to use the unsubscribe function returned by 'on'.
-     * @param event The name of the event.
-     * @param fun The callback function to remove.
-     */
-    off(event, fun) {
-        const evt = this._events.find(x => x.event === event);
-        if (evt) {
-            // Filter out listeners where the 'fun' property matches the provided function.
-            evt.listeners = evt.listeners.filter(listener => listener.fun !== fun);
-            // Optional: If no listeners remain for this event, remove the event entry.
-            if (evt.listeners.length === 0) {
-                this._events = this._events.filter(e => e.event !== event);
-            }
-        }
-    }
-    /**
-     * Emits an event, calling all registered listeners.
-     * @param event The name of the event.
-     * @param args Arguments to pass to the listeners.
-     */
-    emit(event, ...args) {
-        const evt = this._events.find(x => x.event === event);
-        if (evt) {
-            [...evt.listeners].forEach(({ fun, context }) => {
-                try {
-                    fun.apply(context, args);
-                }
-                catch (e) {
-                    console.error(`Error during event '${String(event)}' emission:`, e);
-                }
-            });
-        }
-    }
-    /**
-     * Removes all listeners for a specific event.
-     * @param event The name of the event.
-     */
-    removeAllListeners(event) {
-        this._events = this._events.filter(e => e.event !== event);
-    }
-}
-export default Events;

package/dist/cjs/index.d.ts

@@ -1,52 +0,0 @@
-import { AxiosProgressEvent, AxiosRequestConfig, CancelTokenSource } from "axios";
-import { RefObject } from "react";
-import { FormatNumberParams, sortOptions } from "./types.js";
-export { default as PubSub } from "./events.js";
-export { CancelTokenSource, AxiosProgressEvent as UploadProgressEvent };
-export * from "./types.js";
-export declare const __SALT: string;
-export { default as "_" } from "./withGlobals.js";
-export declare const numberInRange: (min: number, max: number) => number;
-export declare const toHash: (n: number, len?: number, SALT?: string | null) => string;
-export declare const fromHash: (str: string, SALT?: string | null) => number;
-export declare const MD5: (str: string) => string;
-export declare const uuid: (len: number) => string;
-export declare const ucfirst: (o: any) => string;
-export declare const urldecode: (str: string) => string;
-export declare const urlencode: (str: string) => string;
-export declare const pluralize: (word: string, count: number) => string;
-export declare const isHexColor: (color: string) => boolean;
-export declare const isRgbaColor: (color: string) => boolean;
-export declare const isHslColor: (color: string) => boolean;
-export declare const isColorName: (color: string) => boolean;
-export declare const isColor: (color: string) => boolean;
-export declare const hexToRgba: (hex: string, alpha?: number) => string;
-export declare const removeDuplicates: <T>(array: T[]) => T[];
-export declare const getCancelToken: () => CancelTokenSource;
-export declare const withCredentials: (include: boolean) => boolean;
-export declare const withPost: <T>(uri: string, data: any, // 'dynamic' usually maps to 'any' or 'Record<string, any>'
-timeout?: number, ignoreKind?: boolean, headers?: AxiosRequestConfig["headers"], onProgress?: (ev: AxiosProgressEvent) => void) => Promise<T>;
-export declare const withGet: <T>(uri: string, timeout?: number, ignoreKind?: boolean, headers?: AxiosRequestConfig["headers"]) => Promise<T>;
-export declare const withTime: (fun: (...args: any[]) => any) => {
-    result: any;
-    executionTime: number;
-};
-export declare const time: (stamp?: number, format?: string) => string;
-export declare const timeSince: (stamp: number) => string;
-export declare const arrayRand: (arr: any[]) => any;
-export declare const formatNumber: ({ number, locale, style, decimal, forceDecimal, currency }: FormatNumberParams) => string;
-export declare const formatSize: (bytes: number | string) => string;
-export declare const copyToClipboard: (text: string) => Promise<unknown>;
-export declare const natsort: (options?: sortOptions) => (a: string | number, b: string | number) => number;
-export declare const camelCase: (str: string, ucf?: boolean) => string;
-export declare const camelCaseToDash: (str: string) => string;
-export declare const clamp: (value: number, min: number, max: number) => number;
-export declare const slugify: (text: string, separator?: string) => string;
-export declare const animateCSSVar: (ref: RefObject<HTMLElement>, variable: string, to: number, { lerpFactor, threshold, multiplier, }?: {
-    lerpFactor?: number;
-    threshold?: number;
-    multiplier?: number;
-}) => void;
-export declare const sleep: (ms: number) => Promise<any>;
-export declare const enumToKeys: <T extends Record<string, any>>(obj: T) => Array<keyof T>;
-export declare const exists: (path: string) => Promise<boolean>;

package/dist/cjs/index.js

@@ -1,381 +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 { default as PubSub } from "./events.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,28 +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;
-};
-export interface EventListener {
-    fun: (...args: any[]) => void;
-    context?: any;
-    id: symbol;
-}

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 _;