@zuzjs/core 0.3.1 → 0.3.2

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

package/dist/esm/colors.js

@@ -1,26 +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 const colorNames = [
-    'aliceblue', 'antiquewhite', 'aqua', 'aquamarine', 'azure', 'beige', 'bisque', 'black', 'blanchedalmond', 'blue', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'fuchsia', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'gray', 'green', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'lime', 'limegreen', 'linen', 'magenta', 'maroon', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'navy', 'oldlace', 'olive', 'olivedrab', 'orange', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'purple', 'rebeccapurple', 'red', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'silver', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'teal', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'white', 'whitesmoke', 'yellow', 'yellowgreen'
-];
-/**
- * colorPalatter contains colors and their corresponding shades.
- */
-export const colorPalette = {
-    green: {
-        50: '#e8f5e9',
-        100: '#c8e6c9',
-        200: '#a5d6a7',
-        300: '#81c784',
-        400: '#66bb6a',
-        500: '#4caf50',
-        600: '#43a047',
-        700: '#388e3c',
-        800: '#2e7d32',
-        900: '#1b5e20',
-    },
-};

package/dist/esm/events.d.ts

@@ -1,37 +0,0 @@
-import { EventListener } from "./types";
-export interface Event {
-    event: String | Symbol;
-    listeners: Array<EventListener>;
-}
-declare class Events {
-    _events: Event[];
-    constructor();
-    /**
-     * 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: String | Symbol, fun: (...args: any[]) => void, context?: any): () => void;
-    /**
-     * 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: String | Symbol, fun: (...args: any[]) => void): void;
-    /**
-     * Emits an event, calling all registered listeners.
-     * @param event The name of the event.
-     * @param args Arguments to pass to the listeners.
-     */
-    emit(event: String | Symbol, ...args: any[]): void;
-    /**
-     * Removes all listeners for a specific event.
-     * @param event The name of the event.
-     */
-    removeAllListeners(event: String | Symbol): void;
-}
-export default Events;

package/dist/esm/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/esm/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>;