@develia/commons 0.4.13 → 0.4.15

package/dist/esm/type.js

@@ -5,30 +5,76 @@ class Type {
         this.constructorRef = constructorRef;
         this.typeCode = typeCode;
     }
+    // ══════════════════════════════════════════════
+    //  ÚNICO PUNTO DE ENTRADA
+    // ══════════════════════════════════════════════
+    /**
+     * Obtiene el `Type` de cualquier valor, constructor o primitivo.
+     *
+     * Unifica `typeof()` y `.GetType()` de C# en un solo método.
+     *
+     * **Reglas de resolución:**
+     * 1. `null` / `undefined` → tipo nullish correspondiente
+     * 2. Primitivo (`number`, `string`, etc.) → tipo primitivo
+     * 3. Array → `Type.Array`
+     * 4. Función/Constructor → tipo del constructor (no "Function")
+     * 5. Objeto → tipo basado en su constructor
+     *
+     * @example
+     * ```ts
+     * Type.of(42)           // Type<number>   — primitivo
+     * Type.of('hello')      // Type<string>   — primitivo
+     * Type.of(new Date())   // Type<Date>     — desde instancia
+     * Type.of(Date)         // Type<Date>     — desde constructor
+     * Type.of(null)         // Type<null>
+     * Type.of([1, 2, 3])   // Type<Array>
+     * ```
+     */
     static of(target) {
+        // ── Nullish ──
         if (target === null)
             return Type.Null;
         if (target === undefined)
             return Type.Undefined;
         const jsType = typeof target;
+        // ── Primitivos ──
         if (jsType !== 'object' && jsType !== 'function') {
             return this._getOrCreate(jsType, undefined, jsType);
         }
+        // ── Funciones y Constructores ──
         if (jsType === 'function') {
             return this._resolveFunction(target);
         }
+        // ── Arrays ──
         if (Array.isArray(target)) {
             return Type.Array;
         }
+        // ── Objetos ──
         return this._resolveObject(target);
     }
+    // ──────────────────────────────────────────────
+    //  Resolvers privados (separan la lógica compleja)
+    // ──────────────────────────────────────────────
+    /**
+     * Resuelve funciones y constructores.
+     *
+     * Decisión clave: si la función tiene un `prototype` con
+     * miembros propios o empieza con `class`, es un constructor
+     * y devolvemos el tipo que construye. Si no, es una función.
+     */
     static _resolveFunction(fn) {
         const isConstructor = this._isConstructorLike(fn);
         if (isConstructor) {
-            return this._getOrCreate(fn, fn, TypeCode.Object, fn.name || 'AnonymousClass');
+            // Constructor → devuelve el tipo que construye
+            return this._getOrCreate(fn, // cacheamos por referencia al constructor
+            fn, TypeCode.Object, fn.name || 'AnonymousClass');
         }
+        // Función pura → devuelve Type<Function>
         return Type.Function;
     }
+    /**
+     * Resuelve objetos por su cadena de prototipos.
+     */
     static _resolveObject(obj) {
         const proto = Object.getPrototypeOf(obj);
         const ctor = proto?.constructor;
@@ -38,21 +84,36 @@ class Type {
         }
         return this._getOrCreate(ctor, ctor, TypeCode.Object, name);
     }
+    /**
+     * Heurística para distinguir constructores de funciones planas.
+     *
+     * Un "constructor" cumple al menos una de:
+     *  - Su `toString()` empieza con "class "
+     *  - Tiene propiedades propias en su prototype (más allá de constructor)
+     *  - Es un built-in conocido (Date, Map, Set, etc.)
+     */
     static _isConstructorLike(fn) {
+        // 1. Clase ES6 explícita
         try {
             if (fn.toString().startsWith('class '))
                 return true;
         }
         catch {
+            // toString puede fallar en Proxy, etc.
         }
+        // 2. Built-ins conocidos con prototype significativo
         if (fn === Object || fn === Function || fn === Array)
             return true;
         const proto = fn.prototype;
         if (!proto || typeof proto !== 'object')
             return false;
+        // 3. Prototype con miembros propios (señal de constructor)
         const ownKeys = Object.getOwnPropertyNames(proto);
         return ownKeys.length > 1 || (ownKeys.length === 1 && ownKeys[0] !== 'constructor');
     }
+    // ══════════════════════════════════════════════
+    //  PROPIEDADES COMPUTADAS
+    // ══════════════════════════════════════════════
     get isPrimitive() {
         return (this.typeCode === TypeCode.String ||
             this.typeCode === TypeCode.Number ||
@@ -92,6 +153,9 @@ class Type {
         }
         return this.name;
     }
+    // ══════════════════════════════════════════════
+    //  JERARQUÍA
+    // ══════════════════════════════════════════════
     get baseType() {
         if (!this.constructorRef)
             return undefined;
@@ -132,6 +196,9 @@ class Type {
             return false;
         return this.isAssignableTo(parent);
     }
+    // ══════════════════════════════════════════════
+    //  REFLEXIÓN
+    // ══════════════════════════════════════════════
     getMethodNames() {
         if (!this.constructorRef?.prototype)
             return Object.freeze([]);
@@ -169,6 +236,9 @@ class Type {
         return Object.freeze(Object.getOwnPropertyNames(this.constructorRef)
             .filter(n => !skip.has(n)));
     }
+    // ══════════════════════════════════════════════
+    //  SERIALIZACIÓN
+    // ══════════════════════════════════════════════
     toString() {
         return `Type [${this.name}]`;
     }
@@ -182,6 +252,9 @@ class Type {
     get [Symbol.toStringTag]() {
         return `Type<${this.name}>`;
     }
+    // ──────────────────────────────────────────────
+    //  FACTORY INTERNA
+    // ──────────────────────────────────────────────
     static _getOrCreate(key, constructorRef, typeCode, customName) {
         const cached = this._cache.get(key);
         if (cached)
@@ -196,7 +269,13 @@ class Type {
         return instance;
     }
 }
+// ──────────────────────────────────────────────
+//  Caché (Flyweight)
+// ──────────────────────────────────────────────
 Type._cache = new Map();
+// ──────────────────────────────────────────────
+//  Tipos predefinidos
+// ──────────────────────────────────────────────
 Type.String = Type._getOrCreate('string', undefined, TypeCode.String, 'string');
 Type.Number = Type._getOrCreate('number', undefined, TypeCode.Number, 'number');
 Type.Boolean = Type._getOrCreate('boolean', undefined, TypeCode.Boolean, 'boolean');

package/dist/esm/type.js.map

@@ -1 +1 @@
-{"version":3,"file":"type.js","sourceRoot":"","sources":["../../src/type.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../src/type.ts"],"names":[],"mappings":"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","sourcesContent":["import TypeCode from \"./type-code.js\";\r\nimport {type Constructor} from \"./types.js\";\r\n\r\nexport default class Type<T = unknown> {\r\n\r\n    // ──────────────────────────────────────────────\r\n    //  Caché (Flyweight)\r\n    // ──────────────────────────────────────────────\r\n\r\n    private static readonly _cache = new Map<unknown, Type>();\r\n\r\n    // ──────────────────────────────────────────────\r\n    //  Tipos predefinidos\r\n    // ──────────────────────────────────────────────\r\n\r\n    public static readonly String = Type._getOrCreate<string>('string', undefined, TypeCode.String, 'string');\r\n    public static readonly Number = Type._getOrCreate<number>('number', undefined, TypeCode.Number, 'number');\r\n    public static readonly Boolean = Type._getOrCreate<boolean>('boolean', undefined, TypeCode.Boolean, 'boolean');\r\n    public static readonly Symbol = Type._getOrCreate<symbol>('symbol', undefined, TypeCode.Symbol, 'symbol');\r\n    public static readonly BigInt = Type._getOrCreate<bigint>('bigint', undefined, TypeCode.BigInt, 'bigint');\r\n    public static readonly Null = Type._getOrCreate<null>('null', undefined, TypeCode.Null, 'null');\r\n    public static readonly Undefined = Type._getOrCreate<undefined>('undefined', undefined, TypeCode.Undefined, 'undefined');\r\n    public static readonly Object = Type._getOrCreate<object>(Object, Object, TypeCode.Object, 'Object');\r\n    public static readonly Function = Type._getOrCreate<Function>(Function, Function, TypeCode.Function, 'Function');\r\n    public static readonly Array = Type._getOrCreate<unknown[]>(Array, Array, TypeCode.Array, 'Array');\r\n\r\n    // ──────────────────────────────────────────────\r\n    //  Propiedades inmutables\r\n    // ──────────────────────────────────────────────\r\n\r\n    public readonly name: string;\r\n    public readonly constructorRef:\r\n        Constructor<T> | undefined;\r\n    public readonly typeCode: TypeCode;\r\n\r\n    private constructor(\r\n        name: string,\r\n        constructorRef: Constructor<T> | undefined,\r\n        typeCode: TypeCode,\r\n    ) {\r\n        this.name = name;\r\n        this.constructorRef = constructorRef;\r\n        this.typeCode = typeCode;\r\n    }\r\n\r\n    // ══════════════════════════════════════════════\r\n    //  ÚNICO PUNTO DE ENTRADA\r\n    // ══════════════════════════════════════════════\r\n\r\n    /**\r\n     * Obtiene el `Type` de cualquier valor, constructor o primitivo.\r\n     *\r\n     * Unifica `typeof()` y `.GetType()` de C# en un solo método.\r\n     *\r\n     * **Reglas de resolución:**\r\n     * 1. `null` / `undefined` → tipo nullish correspondiente\r\n     * 2. Primitivo (`number`, `string`, etc.) → tipo primitivo\r\n     * 3. Array → `Type.Array`\r\n     * 4. Función/Constructor → tipo del constructor (no \"Function\")\r\n     * 5. Objeto → tipo basado en su constructor\r\n     *\r\n     * @example\r\n     * ```ts\r\n     * Type.of(42)           // Type<number>   — primitivo\r\n     * Type.of('hello')      // Type<string>   — primitivo\r\n     * Type.of(new Date())   // Type<Date>     — desde instancia\r\n     * Type.of(Date)         // Type<Date>     — desde constructor\r\n     * Type.of(null)         // Type<null>\r\n     * Type.of([1, 2, 3])   // Type<Array>\r\n     * ```\r\n     */\r\n    public static of<U>(target: U | Constructor<U>): Type<U> {\r\n        // ── Nullish ──\r\n        if (target === null) return Type.Null as Type<U>;\r\n        if (target === undefined) return Type.Undefined as Type<U>;\r\n\r\n        const jsType = typeof target;\r\n\r\n        // ── Primitivos ──\r\n        if (jsType !== 'object' && jsType !== 'function') {\r\n            return this._getOrCreate<U>(jsType, undefined, jsType as TypeCode);\r\n        }\r\n\r\n        // ── Funciones y Constructores ──\r\n        if (jsType === 'function') {\r\n            return this._resolveFunction<U>(target as Function & Constructor<U>);\r\n        }\r\n\r\n        // ── Arrays ──\r\n        if (Array.isArray(target)) {\r\n            return Type.Array as Type<U>;\r\n        }\r\n\r\n        // ── Objetos ──\r\n        return this._resolveObject<U>(target as object);\r\n    }\r\n\r\n    // ──────────────────────────────────────────────\r\n    //  Resolvers privados (separan la lógica compleja)\r\n    // ──────────────────────────────────────────────\r\n\r\n    /**\r\n     * Resuelve funciones y constructores.\r\n     *\r\n     * Decisión clave: si la función tiene un `prototype` con\r\n     * miembros propios o empieza con `class`, es un constructor\r\n     * y devolvemos el tipo que construye. Si no, es una función.\r\n     */\r\n    private static _resolveFunction<U>(fn: Function & Constructor<U>): Type<U> {\r\n        const isConstructor = this._isConstructorLike(fn);\r\n\r\n        if (isConstructor) {\r\n            // Constructor → devuelve el tipo que construye\r\n            return this._getOrCreate<U>(\r\n                fn,                          // cacheamos por referencia al constructor\r\n                fn as Constructor<U>,\r\n                TypeCode.Object,\r\n                fn.name || 'AnonymousClass',\r\n            );\r\n        }\r\n\r\n        // Función pura → devuelve Type<Function>\r\n        return Type.Function as Type<U>;\r\n    }\r\n\r\n    /**\r\n     * Resuelve objetos por su cadena de prototipos.\r\n     */\r\n    private static _resolveObject<U>(obj: object): Type<U> {\r\n        const proto = Object.getPrototypeOf(obj) as { constructor?: Constructor<U> } | null;\r\n        const ctor = proto?.constructor as Constructor<U> | undefined;\r\n        const name = ctor?.name || 'Object';\r\n\r\n        if (!ctor || ctor === (Object as unknown)) {\r\n            return Type.Object as Type<U>;\r\n        }\r\n\r\n        return this._getOrCreate<U>(ctor, ctor, TypeCode.Object, name);\r\n    }\r\n\r\n    /**\r\n     * Heurística para distinguir constructores de funciones planas.\r\n     *\r\n     * Un \"constructor\" cumple al menos una de:\r\n     *  - Su `toString()` empieza con \"class \"\r\n     *  - Tiene propiedades propias en su prototype (más allá de constructor)\r\n     *  - Es un built-in conocido (Date, Map, Set, etc.)\r\n     */\r\n    private static _isConstructorLike(fn: Function): boolean {\r\n        // 1. Clase ES6 explícita\r\n        try {\r\n            if (fn.toString().startsWith('class ')) return true;\r\n        } catch {\r\n            // toString puede fallar en Proxy, etc.\r\n        }\r\n\r\n        // 2. Built-ins conocidos con prototype significativo\r\n        if (fn === Object || fn === Function || fn === Array) return true;\r\n\r\n        const proto = fn.prototype;\r\n        if (!proto || typeof proto !== 'object') return false;\r\n\r\n        // 3. Prototype con miembros propios (señal de constructor)\r\n        const ownKeys = Object.getOwnPropertyNames(proto);\r\n        return ownKeys.length > 1 || (ownKeys.length === 1 && ownKeys[0] !== 'constructor');\r\n    }\r\n\r\n    // ══════════════════════════════════════════════\r\n    //  PROPIEDADES COMPUTADAS\r\n    // ══════════════════════════════════════════════\r\n\r\n    public get isPrimitive(): boolean {\r\n        return (\r\n            this.typeCode === TypeCode.String ||\r\n            this.typeCode === TypeCode.Number ||\r\n            this.typeCode === TypeCode.Boolean ||\r\n            this.typeCode === TypeCode.Symbol ||\r\n            this.typeCode === TypeCode.BigInt\r\n        );\r\n    }\r\n\r\n    public get isNullish(): boolean {\r\n        return this.typeCode === TypeCode.Null || this.typeCode === TypeCode.Undefined;\r\n    }\r\n\r\n    public get isReferenceType(): boolean {\r\n        return !this.isPrimitive && !this.isNullish;\r\n    }\r\n\r\n    public get isArray(): boolean {\r\n        return this.typeCode === TypeCode.Array ||\r\n            this.constructorRef === (Array as unknown as Constructor<T>);\r\n    }\r\n\r\n    public get isFunction(): boolean {\r\n        return this.typeCode === TypeCode.Function;\r\n    }\r\n\r\n    public get isValueType(): boolean {\r\n        return this.isPrimitive;\r\n    }\r\n\r\n    public get isClass(): boolean {\r\n        if (!this.constructorRef) return false;\r\n        try {\r\n            return this.constructorRef.toString().startsWith('class ');\r\n        } catch {\r\n            return false;\r\n        }\r\n    }\r\n\r\n    public get fullName(): string {\r\n        if (this.isPrimitive || this.isNullish) {\r\n            return `System.${this.name.charAt(0).toUpperCase()}${this.name.slice(1)}`;\r\n        }\r\n        return this.name;\r\n    }\r\n\r\n    // ══════════════════════════════════════════════\r\n    //  JERARQUÍA\r\n    // ══════════════════════════════════════════════\r\n\r\n    public get baseType(): Type | undefined {\r\n        if (!this.constructorRef) return undefined;\r\n\r\n        const parentProto = Object.getPrototypeOf(this.constructorRef.prototype);\r\n        if (!parentProto || parentProto === Object.prototype) {\r\n            return this === Type.Object ? undefined : Type.Object;\r\n        }\r\n\r\n        const parentCtor = parentProto.constructor as Constructor;\r\n        return Type.of(parentCtor);\r\n    }\r\n\r\n    public getInheritanceChain(): ReadonlyArray<Type> {\r\n        const chain: Type[] = [this];\r\n        let current: Type | undefined = this.baseType;\r\n\r\n        while (current && !chain.includes(current)) {\r\n            chain.push(current);\r\n            current = current.baseType;\r\n        }\r\n\r\n        return Object.freeze(chain);\r\n    }\r\n\r\n    public isAssignableTo(target: Type): boolean {\r\n        if (this === target) return true;\r\n        if (!this.constructorRef || !target.constructorRef) return false;\r\n\r\n        let proto: object | null = this.constructorRef.prototype;\r\n        while (proto) {\r\n            if (proto.constructor === target.constructorRef) return true;\r\n            proto = Object.getPrototypeOf(proto) as object | null;\r\n        }\r\n        return false;\r\n    }\r\n\r\n    public isAssignableFrom(source: Type): boolean {\r\n        return source.isAssignableTo(this);\r\n    }\r\n\r\n    public isSubclassOf(parent: Type): boolean {\r\n        if (this === parent) return false;\r\n        return this.isAssignableTo(parent);\r\n    }\r\n\r\n\r\n    // ══════════════════════════════════════════════\r\n    //  REFLEXIÓN\r\n    // ══════════════════════════════════════════════\r\n\r\n    public getMethodNames(): ReadonlyArray<string> {\r\n        if (!this.constructorRef?.prototype) return Object.freeze([]);\r\n        return Object.freeze(\r\n            Object.getOwnPropertyNames(this.constructorRef.prototype)\r\n                  .filter(n => n !== 'constructor' &&\r\n                      typeof Object.getOwnPropertyDescriptor(\r\n                          this.constructorRef!.prototype, n\r\n                      )?.value === 'function'\r\n                  )\r\n        );\r\n    }\r\n\r\n    public getPropertyNames(): ReadonlyArray<string> {\r\n        if (!this.constructorRef?.prototype) return Object.freeze([]);\r\n        return Object.freeze(\r\n            Object.getOwnPropertyNames(this.constructorRef.prototype)\r\n                  .filter(n => n !== 'constructor' &&\r\n                      typeof Object.getOwnPropertyDescriptor(\r\n                          this.constructorRef!.prototype, n\r\n                      )?.value !== 'function'\r\n                  )\r\n        );\r\n    }\r\n\r\n    public getMemberNames(): ReadonlyArray<string> {\r\n        if (!this.constructorRef?.prototype) return Object.freeze([]);\r\n        return Object.freeze(\r\n            Object.getOwnPropertyNames(this.constructorRef.prototype)\r\n                  .filter(n => n !== 'constructor')\r\n        );\r\n    }\r\n\r\n    public hasMethod(name: string): boolean {\r\n        if (!this.constructorRef?.prototype) return false;\r\n        return typeof this.constructorRef.prototype[name] === 'function';\r\n    }\r\n\r\n    public hasProperty(name: string): boolean {\r\n        if (!this.constructorRef?.prototype) return false;\r\n        return name in this.constructorRef.prototype && !this.hasMethod(name);\r\n    }\r\n\r\n    public getStaticMemberNames(): ReadonlyArray<string> {\r\n        if (!this.constructorRef) return Object.freeze([]);\r\n        const skip = new Set(['prototype', 'length', 'name', 'caller', 'arguments']);\r\n        return Object.freeze(\r\n            Object.getOwnPropertyNames(this.constructorRef)\r\n                  .filter(n => !skip.has(n))\r\n        );\r\n    }\r\n\r\n\r\n    // ══════════════════════════════════════════════\r\n    //  SERIALIZACIÓN\r\n    // ══════════════════════════════════════════════\r\n\r\n    public toString(): string {\r\n        return `Type [${this.name}]`;\r\n    }\r\n\r\n\r\n    public [Symbol.toPrimitive](hint: string): string | number {\r\n\r\n        let hash = 0;\r\n        for (let i = 0; i < this.name.length; i++) {\r\n            hash = ((hash << 5) - hash + this.name.charCodeAt(i)) | 0;\r\n        }\r\n\r\n        return hint === 'number' ? hash : this.toString();\r\n    }\r\n\r\n    public get [Symbol.toStringTag](): string {\r\n        return `Type<${this.name}>`;\r\n    }\r\n\r\n    // ──────────────────────────────────────────────\r\n    //  FACTORY INTERNA\r\n    // ──────────────────────────────────────────────\r\n\r\n    private static _getOrCreate<V>(\r\n        key: unknown,\r\n        constructorRef: Constructor<V> | unknown,\r\n        typeCode: TypeCode,\r\n        customName?: string,\r\n    ): Type<V> {\r\n        const cached = this._cache.get(key);\r\n        if (cached) return cached as Type<V>;\r\n\r\n        const name = customName\r\n            ?? (typeof key === 'string' ? key : 'unknown');\r\n\r\n        const ref = typeof constructorRef === 'function'\r\n            ? constructorRef as Constructor<V>\r\n            : undefined;\r\n\r\n        const instance = new Type<V>(name, ref, typeCode);\r\n        this._cache.set(key, instance as Type);\r\n        return instance;\r\n    }\r\n}"]}

package/dist/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type EqualityComparer<T> = (arg1: T, arg2: T) => boolean;\r\n\r\nexport type Consumer<T> = (arg: T) => void\r\n\r\nexport type Predicate<T> = (arg: T) => boolean;\r\n\r\nexport type Supplier<T> = () => T;\r\n\r\nexport type Nullable<T> = T | null;\r\n\r\nexport type Optional<T> = T | undefined;\r\n\r\nexport type Nullish = null | undefined;\r\n\r\nexport type Resolvable<T> = Promise<T> | Supplier<T>\r\n\r\nexport type UnaryFunction<T, R> = (arg: T) => R;\r\n\r\nexport type BinaryFunction<T1, T2, R> = (arg1: T1, arg2: T2) => R;\r\n\r\nexport type TernaryFunction<T1, T2, T3, R> = (arg1: T1, arg2: T2, arg3: T3) => R;\r\n\r\nexport type QuaternaryFunction<T1, T2, T3, T4, R> = (\r\n    arg1: T1,\r\n    arg2: T2,\r\n    arg3: T3,\r\n    arg4: T4\r\n) => R;\r\n\r\nexport type Constructor<T = unknown> = abstract new (...args: any[]) => T;\r\n"]}

package/dist/esm/utilities.js

@@ -1,3 +1,4 @@
+// noinspection JSUnusedGlobalSymbols
 import KeyValuePair from "./key-value-pair.js";
 import Type from "./type.js";
 export function lazy(factory) {
@@ -32,28 +33,90 @@ export function lazy(factory) {
         },
     });
 }
+/**
+ * Checks if an object is iterable.
+ *
+ * @param {any} obj - The object to check.
+ * @return {boolean} - Returns true if the object is iterable, otherwise false.
+ */
 export function isIterable(obj) {
     return obj[Symbol.iterator] === 'function';
 }
+/**
+ * Checks if a given value is a string.
+ *
+ * @param {*} value - The value to check.
+ * @return {boolean} - Returns true if the value is a string, otherwise returns false.
+ */
 export function isString(value) {
     return typeof value === 'string';
 }
+/**
+ * Checks if a value is a number.
+ *
+ * @param {any} value - The value to check.
+ * @return {boolean} - Returns true if the value is a number, otherwise false.
+ */
 export function isNumber(value) {
     return typeof value === 'number';
 }
+/**
+ * Checks if a given value is a boolean.
+ *
+ * @param {any} value - The value to be checked.
+ *
+ * @return {boolean} - Returns true if the value is a boolean, otherwise false.
+ */
 export function isBoolean(value) {
     return typeof value === 'boolean';
 }
+/**
+ * Checks if a value is an object.
+ * @param {any} value - The value to be checked.
+ * @returns {boolean} - Returns true if the value is an object, otherwise returns false.
+ */
 export function isObject(value) {
     return value != null && typeof value === 'object' && !Array.isArray(value);
 }
+/**
+ * Determines if a value is an array.
+ *
+ * @param value - The value to be checked.
+ *
+ * @return Whether the value is an array.
+ */
 export function isArray(value) {
     return Array.isArray(value);
 }
+/**
+ * Checks if a value is a function.
+ *
+ * @param {any} value - The value to be checked.
+ * @return {boolean} - Returns true if the value is a function, otherwise returns false.
+ */
 export function isFunction(value) {
     return typeof value === 'function';
 }
-export function deepEqual(a, b, seen = new WeakMap()) {
+/**
+ * Structural deep equality check.
+ *
+ * Compares primitives by value, and objects/arrays/Maps/Sets/Dates/RegExps
+ * by structure. Handles circular references.
+ *
+ * @param a - First value.
+ * @param b - Second value.
+ * @returns `true` if `a` and `b` are structurally equal.
+ */
+export function deepEqual(a, b) {
+    return _deepEqual(a, b);
+}
+/**
+ * Internal implementation of deep equality check.
+ * @param a - First value.
+ * @param b - Second value.
+ * @param seen - Internal map used to handle circular references.
+ */
+function _deepEqual(a, b, seen = new WeakMap()) {
     if (a === b)
         return true;
     if (a === null || b === null)
@@ -76,7 +139,7 @@ export function deepEqual(a, b, seen = new WeakMap()) {
         if (!(b instanceof Map) || a.size !== b.size)
             return false;
         for (const [k, v] of a) {
-            if (!b.has(k) || !deepEqual(v, b.get(k), seen))
+            if (!b.has(k) || !_deepEqual(v, b.get(k), seen))
                 return false;
         }
         return true;
@@ -96,11 +159,28 @@ export function deepEqual(a, b, seen = new WeakMap()) {
     for (const key of keysA) {
         if (!Object.prototype.hasOwnProperty.call(b, key))
             return false;
-        if (!deepEqual(a[key], b[key], seen))
+        if (!_deepEqual(a[key], b[key], seen))
             return false;
     }
     return true;
 }
+/**
+ * Submits an HTML form programmatically using the specified HTTP method (default is POST),
+ * without using AJAX. Supports nested objects and arrays using bracket notation (e.g., `user[name]`, `tags[]`).
+ *
+ * @param url - The destination URL where the form will be submitted.
+ * @param data - An object containing key-value pairs. Supports nested structures and arrays.
+ * @param method - HTTP method to use: 'POST' or 'GET' (default: 'POST').
+ * @param target - Optional parameter specifying the target for the form submission (e.g., '_blank', '_self', '_parent', '_top').
+ */
+/**
+ * Compares two objects or arrays to check if they have the same immediate fields and values,
+ * or the same immediate elements if they are arrays (shallow equality check).
+ *
+ * @param {any} a - The first object or array.
+ * @param {any} b - The second object or array.
+ * @return {boolean} - Returns true if the objects/arrays are shallowly equal, otherwise false.
+ */
 export function shallowEqual(a, b) {
     if (a === b) {
         return true;
@@ -124,40 +204,108 @@ export function shallowEqual(a, b) {
     }
     return false;
 }
+/**
+ * Pauses the execution of an asynchronous function for a specified duration.
+ *
+ * @param {number} ms - The delay duration in milliseconds.
+ * @return {Promise<void>} A promise that resolves after the specified delay.
+ */
 export async function delay(ms) {
     await new Promise(resolve => setTimeout(resolve, ms));
 }
+/**
+ * Checks if a value is undefined.
+ *
+ * @param {any} value - The value to check.
+ * @returns {boolean} - True if the value is undefined, false otherwise.
+ */
 export function isUndefined(value) {
     return typeof value === 'undefined';
 }
+/**
+ * Checks if a value is defined or not.
+ *
+ * @param {any} value - The value to be checked.
+ *
+ * @return {boolean} - True if the value is defined, false otherwise.
+ */
 export function isDefined(value) {
     return typeof value !== 'undefined';
 }
+/**
+ * Checks if a given value is null.
+ *
+ * @param {any} value - The value to check for null.
+ * @return {boolean} - Returns true if the value is null, otherwise returns false.
+ */
 export function isNull(value) {
     return value === null;
 }
+/**
+ * Determines whether the given value is of type bigint.
+ * @param {any} value - The value to be checked.
+ * @return {boolean} - Returns true if the value is of type bigint, false otherwise.
+ */
 export function isBigInt(value) {
     return typeof value === 'bigint';
 }
+/**
+ * Checks if a given value is a symbol.
+ *
+ * @param {any} value - The value to be checked.
+ * @return {boolean} - Returns true if the value is a symbol, false otherwise.
+ */
 export function isSymbol(value) {
     return typeof value === 'symbol';
 }
+/**
+ * Checks if a value is null or undefined.
+ *
+ * @param {any} value - The value to check.
+ * @return {boolean} - Returns true if the value is null or undefined, false otherwise.
+ * @deprecated
+ */
 export function isNullOrUndefined(value) {
     return value === null || typeof value === 'undefined';
 }
+/**
+ * Checks if a value is null or undefined.
+ *
+ * @param {any} value - The value to check.
+ * @return {boolean} - Returns true if the value is null or undefined, false otherwise.
+
+ */
 export function isNullish(value) {
     return value === null || typeof value === 'undefined';
 }
+/**
+ * Checks if a given value is empty.
+ *
+ * @param {any} value - The value to check.
+ * @return {boolean} - Returns true if the value is empty, otherwise returns false.
+ */
 export function isEmpty(value) {
     return (Array.isArray(value) && value.length === 0) ||
         (typeof value === 'string' && value === '') ||
         value === null || typeof value === 'undefined';
 }
+/**
+ * Check if a value is empty or contains only whitespace characters.
+ *
+ * @param {any} value - The value to check.
+ * @return {boolean} Returns true if the value is empty or contains only whitespace characters, otherwise returns false.
+ */
 export function isEmptyOrWhitespace(value) {
     return (Array.isArray(value) && value.length === 0) ||
         (typeof value === 'string' && value.trim() === '') ||
         value === null || typeof value === 'undefined';
 }
+/**
+ * Converts an object into an array of key-value pairs.
+ *
+ * @param {Record<string, any>} obj - The object to convert.
+ * @return {KeyValuePair<string, any>[]} - The array of key-value pairs.
+ */
 export function toPairs(obj) {
     let output = [];
     for (const key in obj) {
@@ -165,6 +313,33 @@ export function toPairs(obj) {
     }
     return output;
 }
+/**
+ * Creates an object composed of the picked object properties.
+ *
+ * @template T - The type of the source object.
+ * @template K - The type of the keys to pick.
+ * @param obj - The source object.
+ * @param props - The property names to pick.
+ * @returns A new object with the picked properties.
+ */
+export function pick(obj, props) {
+    const result = {};
+    if (obj === null || typeof obj !== 'object') {
+        return result;
+    }
+    for (const key of props) {
+        if (key in obj) {
+            result[key] = obj[key];
+        }
+    }
+    return result;
+}
+/**
+ * Converts a given thing into a Promise.
+ * @template T
+ * @param {any} thing - The thing to be converted into a Promise.
+ * @returns {Promise<T>} - A Promise representing the given thing.
+ */
 export function promisify(thing) {
     if (thing instanceof Promise)
         return thing;
@@ -181,7 +356,26 @@ export function promisify(thing) {
     }
     return Promise.resolve(thing);
 }
-export function deepClone(value, seen = new WeakMap()) {
+/**
+ * Create a deep, independent copy of a value.
+ *
+ * Supports primitives, plain objects, arrays, `Date`, `RegExp`, `Map`, `Set`,
+ * symbol-keyed properties and circular references. Functions are copied by
+ * reference. Class instances preserve their prototype.
+ *
+ * @template T - The value's type.
+ * @param value - The value to clone.
+ * @returns A deep clone of `value`.
+ */
+export function deepClone(value) {
+    return _deepClone(value);
+}
+/**
+ * Internal implementation of deep clone.
+ * @param value - The value to clone.
+ * @param seen - Internal map used to handle circular references.
+ */
+function _deepClone(value, seen = new WeakMap()) {
     if (value === null || typeof value !== "object")
         return value;
     const obj = value;
@@ -194,13 +388,17 @@ export function deepClone(value, seen = new WeakMap()) {
     if (value instanceof Map) {
         const copy = new Map();
         seen.set(value, copy);
-        value.forEach((v, k) => copy.set(deepClone(k, seen), deepClone(v, seen)));
+        for (const [k, v] of value) {
+            copy.set(_deepClone(k, seen), _deepClone(v, seen));
+        }
         return copy;
     }
     if (value instanceof Set) {
         const copy = new Set();
         seen.set(value, copy);
-        value.forEach((v) => copy.add(deepClone(v, seen)));
+        for (const v of value) {
+            copy.add(_deepClone(v, seen));
+        }
         return copy;
     }
     const copy = Array.isArray(value)
@@ -208,10 +406,17 @@ export function deepClone(value, seen = new WeakMap()) {
         : Object.create(Object.getPrototypeOf(value));
     seen.set(obj, copy);
     for (const key of Reflect.ownKeys(obj)) {
-        copy[key] = deepClone(value[key], seen);
+        copy[key] = _deepClone(value[key], seen);
     }
     return copy;
 }
+/**
+ * Returns the type of the given value.
+ *
+ * @param {any} value - The value to determine the type of.
+ * @return {Type} - The type of the given value.
+ * @deprecated use Type.of(...)
+ */
 export function getType(value) {
     return Type.of(value);
 }