@rzl-zone/utils-js 3.0.2-beta.2 → 3.1.0

package/dist/operations/index.d.ts

@@ -1,182 +1,127 @@
 import{N as NumberRangeUnion}from'../NumberRangeUnion-DC-C3_Kq.js';
 /** ----------------------------------------------------------------------
-* * ***Finds duplicate values in an array by deep equality comparison.***
-* ----------------------------------------------------------------------
-*
-* - ✔ Uses `isEqual` to compare elements (handles objects, arrays, dates, NaN, etc.)
-* - ✔ Returns a new array containing only the *first occurrences* of duplicated values.
-* - ✔ Does **not mutate** the original array.
-* - ✔ Throws `TypeError` if input is not an array.
-*
-* @template T Type of elements in the input array.
-* @param {T[]} values - The array to check for duplicates.
-* @returns {T[]} An array of the duplicate values found in the input,
-*                preserving order of their first duplicate appearance.
-*
-* @throws {TypeError} If the provided `values` argument is not an array.
-*
-* @example
-* findDuplicates([1, 2, 2, 3, 4, 4]); // => [2, 4]
-* findDuplicates(["apple", "banana", "apple", "orange"]); // => ["apple"]
-* findDuplicates([{ a: 1 }, { a: 1 }, { a: 2 }]); // => [{ a: 1 }]
-* findDuplicates([NaN, NaN, 1]); // => [NaN]
-* findDuplicates([true, false, true]); // => [true]
-* findDuplicates([1, 2, 3]); // => []
-*/
+ * * ***Utility: `findDuplicates`.***
+ * ----------------------------------------------------------------------
+ * **Finds duplicate values in an array by deep equality comparison.**
+ * - **Behavior:**
+ *    - Uses ***{@link isEqual | `isEqual`}*** to compare elements
+ *      (handles objects, arrays, dates, NaN, etc.).
+ *    - Returns a new array containing only the *first occurrences* of duplicated values.
+ *    - Does **not mutate** the original array.
+ *    - Throws ***{@link TypeError | `TypeError`}*** if input is not an array.
+ * @template T Type of elements in the input array.
+ * @param {T[]} values - The array to check for duplicates.
+ * @returns {T[]} An array of the duplicate values found in the input,
+ *                preserving order of their first duplicate appearance.
+ * @throws {TypeError} If the provided `values` argument is not an array.
+ * @example
+ * findDuplicates([1, 2, 2, 3, 4, 4]);
+ * // ➔ [2, 4]
+ * findDuplicates(["apple", "banana", "apple", "orange"]);
+ * // ➔ ["apple"]
+ * findDuplicates([{ a: 1 }, { a: 1 }, { a: 2 }]);
+ * // ➔ [{ a: 1 }]
+ * findDuplicates([NaN, NaN, 1]);
+ * // ➔ [NaN]
+ * findDuplicates([true, false, true]);
+ * // ➔ [true]
+ * findDuplicates([1, 2, 3]);
+ * // ➔ []
+ */
 declare const findDuplicates:<T>(values:T[])=>T[];
 /** --------------------------------
-* * ***Creates a new object excluding specified keys.***
-* --------------------------------
-* This function creates a shallow copy of the given object
-* omitting the specified keys. It will return a new object
-* without mutating the original.
-*
-* It also validates that `keysToOmit` does not contain duplicate keys.
-*
-* Internally, it uses `isEqual` to check for duplicates in the `keysToOmit` array.
-*
-* @template I The type of the input object.
-* @template K The keys to omit from the object.
-* @param {I} object - The source object to omit keys from.
-* @param {K[]} keysToOmit - An array of keys to exclude from the returned object.
-* @returns {Omit<I, K>} A new object without the specified keys.
-*
-* @throws {TypeError} If `keysToOmit` is not an array.
-* @throws {Error} If duplicate keys are found in `keysToOmit`.
-*
-* @example
-* omitKeys({ a: 1, b: 2, c: 3 }, ["b", "c"]);
-* // => { a: 1 }
-*
-* @example
-* omitKeys({ name: "John", age: 30 }, ["age"]);
-* // => { name: "John" }
-*
-* @example
-* omitKeys({ a: 1, b: 2 }, []);
-* // => { a: 1, b: 2 } (no changes)
-*/
+ * * ***Utility: `omitKeys`.***
+ * --------------------------------
+ * **This function creates a shallow copy of the given object omitting the
+ *  specified keys.**
+ * - **Behavior:**
+ *    - It will return a new object without mutating the original.
+ *    - It also validates that ***`keysToOmit`*** does not contain duplicate keys.
+ * - **ℹ️ Internally:**
+ *    - It uses ***{@link isEqual | `isEqual`}*** to check for duplicates in
+ *      the ***`keysToOmit`*** array.
+ * @template I The type of the input object.
+ * @template K The keys to omit from the object.
+ * @param {I} object - The source object to omit keys from.
+ * @param {K[]} keysToOmit - An array of keys to exclude from the returned object.
+ * @returns {Omit<I, K>} A new object without the specified keys.
+ * @throws {TypeError} If `keysToOmit` is not an array.
+ * @throws {Error} If duplicate keys are found in `keysToOmit`.
+ * @example
+ * omitKeys({ a: 1, b: 2, c: 3 }, ["b", "c"]);
+ * //➔ { a: 1 }
+ * omitKeys({ name: "John", age: 30 }, ["age"]);
+ * //➔ { name: "John" }
+ * omitKeys({ a: 1, b: 2 }, []);
+ * //➔ { a: 1, b: 2 } (no changes)
+ */
 declare const omitKeys:<I extends Record<string,unknown>,K extends keyof I>(object:I,keysToOmit:K[])=>Omit<I,K>;type IndexArray=NumberRangeUnion<0,30>;type DotPath<T,Prev extends string="">=T extends Array<infer U>?DotPath<U,`${Prev}${Prev extends "" ? "" : "."}${IndexArray}`>:T extends object?{[K in keyof T & string]:`${Prev}${Prev extends "" ? "" : "."}${K}`|DotPath<T[K],`${Prev}${Prev extends "" ? "" : "."}${K}`>;}[keyof T & string]:never;
 /** ------------------------------------------------------
-* * Recursively omits properties from an object using dot notation paths.
-* * Also removes resulting empty objects (`{}`) and arrays (`[]`),
-* * cascading upwards to remove empty parents until root if needed.
-* ------------------------------------------------------
-*
-* @template I - Type of the input object
-*
-* @param {I} object
-*    The object to process. Should be a plain nested object or array structure.
-*
-* @param {DotPath<I>[]} keysToOmit
-*    An array of string paths in dot notation indicating the properties to remove.
-*    Paths can include numeric indices to target array elements, e.g. `"arr.0.x"` to remove `x`
-*    from the first object inside the `arr` array.
-*
-* @returns {Partial<I>}
-*    A new deeply cloned object with the specified keys omitted,
-*    with resulting empty objects or arrays fully removed (even if it collapses to `{}`).
-*
-* @throws {TypeError}
-*    If `keysToOmit` is not an array will throw TypeError.
-*
-* @throws {Error}
-*    If `keysToOmit` contains duplicate paths will throw Error.
-*
-* @remarks
-* ⚠️ Be careful: if after omission an object or array becomes empty, it will be removed entirely
-* including all the way up to the root if necessary, resulting in `{}`.
-*
-* ⚠️ Note: For array indices, TypeScript autocomplete only suggests `0`–`30`
-* (to prevent editor lag on large unions).
-* However, higher indices are still fully supported at runtime — you can
-* manually type `"arr.99.key"` and it will work the same.
-*
-* @example
-* omitKeysDeep({ arr: [{ a: 1 }] }, ["arr.0.a"]);
-* // → {} (array becomes empty and removed)
-*
-* @example
-* omitKeysDeep({ a: { b: { c: 1 }, d: 2 }, e: 3 }, ["a.b.c"]);
-* // → { a: { d: 2 }, e: 3 }
-*
-* @example
-* omitKeysDeep({ a: [{ b: 1 }, { c: 2 }] }, ["a.0.b"]);
-* // → { a: [{ c: 2 }] }
-*
-* @example
-* omitKeysDeep({ a: [{ b: 1 }] }, ["a.0.b"]);
-* // → {} (array becomes empty and removed)
-*
-* @example
-* omitKeysDeep({ complex: [{ deep: [{ x: 1, y: 2 }] }] }, ["complex.0.deep.0.x"]);
-* // → { complex: [{ deep: [{ y: 2 }] }] }
-*
-* @example
-* omitKeysDeep({ complex: [{ deep: [{ x: 1 }] }] }, ["complex.0.deep.0.x"]);
-* // → {} (deep chain emptied and collapsed)
-*
-* @example
-* omitKeysDeep({ data: [[{ foo: 1, bar: 2 }]] }, ["data.0.0.foo"]);
-* // → { data: [[{ bar: 2 }]] }
-*
-* @example
-* omitKeysDeep({ data: [[{ foo: 1 }]] }, ["data.0.0.foo"]);
-* // → {} (nested arrays emptied completely)
-*
-* @example
-* omitKeysDeep({ x: [{ y: [{ z: 1 }, { w: 2 }] }] }, ["x.0.y.0.z"]);
-* // → { x: [{ y: [{ w: 2 }] }] }
-*
-* @example
-* omitKeysDeep({ x: [{ y: [{ z: 1 }] }] }, ["x.0.y.0.z"]);
-* // → {} (entire nested arrays removed)
-*
-* @example
-* omitKeysDeep({ p: { q: { r: 5 } }, s: 6 }, ["p.q.r"]);
-* // → { s: 6 } (`p` removed because it becomes empty)
-*
-* @example
-* omitKeysDeep({ arr: [{ a: 1, b: 2 }, { c: 3 }] }, ["arr.0.a"]);
-* // → { arr: [{ b: 2 }, { c: 3 }] }
-*
-* @example
-* omitKeysDeep({ root: [{ sub: [{ leaf: 10 }] }] }, ["root.0.sub.0.leaf"]);
-* // → {} (deep nested arrays emptied to root)
-*
-* @example
-* omitKeysDeep({ meta: { tags: ["x", "y"], count: 2 } }, ["meta.count"]);
-* // → { meta: { tags: ["x", "y"] } }
-*
-* @example
-* omitKeysDeep({ arr: [[{ a: 1 }, { b: 2 }]] }, ["arr.0.0.a"]);
-* // → { arr: [[{ b: 2 }]] }
-*
-* @example
-* omitKeysDeep({ arr: [[{ a: 1 }]] }, ["arr.0.0.a"]);
-* // → {} (double nested emptied)
-*
-* @example
-* omitKeysDeep({ nested: [{ list: [{ id: 1, val: 2 }] }] }, ["nested.0.list.0.val"]);
-* // → { nested: [{ list: [{ id: 1 }] }] }
-*
-* @example
-* omitKeysDeep({ nested: [{ list: [{ id: 1 }] }] }, ["nested.0.list.0.id"]);
-* // → {} (full collapse to empty)
-*
-* @example
-* omitKeysDeep({ mixed: { a: [1, 2, 3], b: { c: 4 } } }, ["mixed.b.c"]);
-* // → { mixed: { a: [1, 2, 3] } }
-*/
-declare const omitKeysDeep:<I extends Record<string,unknown>>(object:I,keysToOmit:DotPath<I>[])=>Partial<I>;
-/** --------------------------------
-* * Removes Property from PROPS Collection
-* --------------------------------
-* @description Becarefull put array in arrayException, If array is duplicated it will be throw an exception error
-* @param object is Record as object (string,any)
-* @param arrayExcept is Array exception []
-* @returns
-*
-* @deprecated - Use `omitKeys` instead, this function will remove a next update.
-*/
-declare const omitProps:<I extends Record<string,unknown>,S extends(keyof I)[]>(object:I,arrayExcept:S)=>Omit<I,S[number]>|undefined;export{findDuplicates,omitKeys,omitKeysDeep,omitProps};
+ * * ***Utility: `omitKeysDeep`.***
+ * ------------------------------------------------------
+ * **Recursively omits properties from an object using dot notation paths.**
+ * - **Behavior:**
+ *    - Also removes resulting empty objects (`{}`) and arrays (`[]`),
+ *    - cascading upwards to remove empty parents until root if needed.
+ * - **⚠️ Be careful:**
+ *    - If after omission an object or array becomes empty, it will be removed entirely
+ *      including all the way up to the root if necessary, resulting in `{}`.
+ * - **ℹ️ Note:**
+ *    - For array indices, TypeScript autocomplete only suggests `0`–`30`
+ *      (to prevent editor lag on large unions).
+ *      However, higher indices are still fully supported at runtime — you can
+ *      manually type `"arr.99.key"` and it will work the same.
+ * @template I - Type of the input object
+ * @param {I} object
+ *  The object to process. Should be a plain nested object or array structure.
+ * @param {DotPath<I>[]} keysToOmit
+ *  An array of string paths in dot notation indicating the properties to remove, paths
+ *  can include numeric indices to target array elements, e.g. `"arr.0.x"` to
+ *  remove `x` from the first object inside the `arr` array.
+ * @returns {Partial<I>}
+ *  A new deeply cloned object with the specified keys omitted, with resulting
+ *  empty objects or arrays fully removed (even if it collapses to `{}`).
+ * @throws {TypeError}
+ *    If `keysToOmit` is not an array will throw TypeError.
+ * @throws {Error} If `keysToOmit` contains duplicate paths will throw Error.
+ * @example
+ * omitKeysDeep({ arr: [{ a: 1 }] }, ["arr.0.a"]);
+ * // ➔ {} (array becomes empty and removed)
+ * omitKeysDeep({ a: { b: { c: 1 }, d: 2 }, e: 3 }, ["a.b.c"]);
+ * // ➔ { a: { d: 2 }, e: 3 }
+ * omitKeysDeep({ a: [{ b: 1 }, { c: 2 }] }, ["a.0.b"]);
+ * // ➔ { a: [{ c: 2 }] }
+ * omitKeysDeep({ a: [{ b: 1 }] }, ["a.0.b"]);
+ * // ➔ {} (array becomes empty and removed)
+ * omitKeysDeep({ complex: [{ deep: [{ x: 1, y: 2 }] }] }, ["complex.0.deep.0.x"]);
+ * // ➔ { complex: [{ deep: [{ y: 2 }] }] }
+ * omitKeysDeep({ complex: [{ deep: [{ x: 1 }] }] }, ["complex.0.deep.0.x"]);
+ * // ➔ {} (deep chain emptied and collapsed)
+ * omitKeysDeep({ data: [[{ foo: 1, bar: 2 }]] }, ["data.0.0.foo"]);
+ * // ➔ { data: [[{ bar: 2 }]] }
+ * omitKeysDeep({ data: [[{ foo: 1 }]] }, ["data.0.0.foo"]);
+ * // ➔ {} (nested arrays emptied completely)
+ * omitKeysDeep({ x: [{ y: [{ z: 1 }, { w: 2 }] }] }, ["x.0.y.0.z"]);
+ * // ➔ { x: [{ y: [{ w: 2 }] }] }
+ * omitKeysDeep({ x: [{ y: [{ z: 1 }] }] }, ["x.0.y.0.z"]);
+ * // ➔ {} (entire nested arrays removed)
+ * omitKeysDeep({ p: { q: { r: 5 } }, s: 6 }, ["p.q.r"]);
+ * // ➔ { s: 6 } (`p` removed because it becomes empty)
+ * omitKeysDeep({ arr: [{ a: 1, b: 2 }, { c: 3 }] }, ["arr.0.a"]);
+ * // ➔ { arr: [{ b: 2 }, { c: 3 }] }
+ * omitKeysDeep({ root: [{ sub: [{ leaf: 10 }] }] }, ["root.0.sub.0.leaf"]);
+ * // ➔ {} (deep nested arrays emptied to root)
+ * omitKeysDeep({ meta: { tags: ["x", "y"], count: 2 } }, ["meta.count"]);
+ * // ➔ { meta: { tags: ["x", "y"] } }
+ * omitKeysDeep({ arr: [[{ a: 1 }, { b: 2 }]] }, ["arr.0.0.a"]);
+ * // ➔ { arr: [[{ b: 2 }]] }
+ * omitKeysDeep({ arr: [[{ a: 1 }]] }, ["arr.0.0.a"]);
+ * // ➔ {} (double nested emptied)
+ * omitKeysDeep({ nested: [{ list: [{ id: 1, val: 2 }] }] }, ["nested.0.list.0.val"]);
+ * // ➔ { nested: [{ list: [{ id: 1 }] }] }
+ * omitKeysDeep({ nested: [{ list: [{ id: 1 }] }] }, ["nested.0.list.0.id"]);
+ * // ➔ {} (full collapse to empty)
+ * omitKeysDeep({ mixed: { a: [1, 2, 3], b: { c: 4 } } }, ["mixed.b.c"]);
+ * // ➔ { mixed: { a: [1, 2, 3] } }
+ */
+declare const omitKeysDeep:<I extends Record<string,unknown>>(object:I,keysToOmit:DotPath<I>[])=>Partial<I>;export{findDuplicates,omitKeys,omitKeysDeep};

package/dist/operations/index.js

@@ -1 +1 @@
-export{a as findDuplicates,b as omitKeys,c as omitKeysDeep,d as omitProps}from'../chunk-GCGU2WB7.js';import'../chunk-PVJF2JHM.js';import'../chunk-W5EDKJK3.js';import'../chunk-QFCGBBSY.js';import'../chunk-SYJC7UAW.js';import'../chunk-MNGGDB2G.js';import'../chunk-5SZUSNGZ.js';import'../chunk-XCFIOTCV.js';
+export{findDuplicates,omitKeys,omitKeysDeep}from"../chunk-SMADKXZE.js";import"../chunk-LBMEEJWA.js";import"../chunk-BSVZRN7C.js";import"../chunk-ZXIWDFEQ.js";import"../chunk-FIAAX3UE.js";import"../chunk-AJ65QFV2.js";import"../chunk-QNKGP5DY.js";import"../chunk-2UIRWYE3.js";

package/dist/or-DyZCRvaU.d.ts

@@ -0,0 +1,89 @@
+import{E as Extends,I as IfExtends}from'./extends-Bk_SBGdT.js';
+/** -------------------------------------------------------
+ * * ***And.***
+ * -------------------------------------------------------
+ * Performs a **logical AND** operation between two boolean types.
+ * - Returns `true` if **both** conditions extend `true`.
+ * - Returns `false` otherwise.
+ *
+ * @template Condition1 - The first condition.
+ * @template Condition2 - The second condition.
+ * @example
+ * ```ts
+ * type Case1 = And<true, true>;
+ * // ➔ true
+ * type Case2 = And<false, true>;
+ * // ➔ false
+ * type Case3 = And<true, false>;
+ * // ➔ false
+ * type Case4 = And<false, false>;
+ * // ➔ false
+ * ```
+ */
+type And<Condition1,Condition2>=IfExtends<Condition1,true,Extends<Condition2,true>>;
+/** -------------------------------------------------------
+ * * ***AndArr.***
+ * -------------------------------------------------------
+ * Performs a **logical AND** operation across all elements in an array of boolean types.
+ * - Returns `true` if **all elements** extend `true`.
+ * - Returns `false` if **any element** is not `true`.
+ *
+ * @template Conditions - A readonly array of boolean conditions.
+ * @example
+ * ```ts
+ * type Case1 = AndArr<[true, true, true]>;
+ * // ➔ true
+ * type Case2 = AndArr<[true, true, false]>;
+ * // ➔ false
+ * type Case3 = AndArr<[false, false, false]>;
+ * // ➔ false
+ * type Case4 = AndArr<[]>;
+ * // ➔ true (vacuous truth)
+ * ```
+ */
+type AndArr<Conditions extends readonly unknown[]>=Extends<Conditions[number],true>;
+/** -------------------------------------------------------
+ * * ***Or.***
+ * -------------------------------------------------------
+ *
+ * Computes the logical OR of two type-level boolean conditions.
+ *
+ * @template Condition1 - First boolean condition.
+ * @template Condition2 - Second boolean condition.
+ *
+ * @example
+ * ```ts
+ * type Case1 = Or<true, true>;   // true
+ * type Case2 = Or<false, true>;  // true
+ * type Case3 = Or<false, false>; // false
+ * type Case4 = Or<true, false>;  // true
+ * ```
+ *
+ * @remarks
+ * - Uses {@link IfExtends} to determine if either condition is `true`.
+ * - Returns `true` if at least one of the two conditions is `true`.
+ * - Returns `false` only if both are `false`.
+ */
+type Or<Condition1,Condition2>=IfExtends<Condition1,true,true,IfExtends<Condition2,true>>;
+/** -------------------------------------------------------
+ * * ***OrArr.***
+ * -------------------------------------------------------
+ *
+ * Computes the logical OR of all elements inside a tuple or array of boolean types.
+ *
+ * @template Conditions - An array of boolean type elements.
+ *
+ * @example
+ * ```ts
+ * type Case1 = OrArr<[true, true, true]>;    // true
+ * type Case2 = OrArr<[true, true, false]>;   // true
+ * type Case3 = OrArr<[false, false, false]>; // false
+ * type Case4 = OrArr<[]>;                    // false
+ * ```
+ *
+ * @remarks
+ * - Uses TypeScript's indexed access types and conditional type inference.
+ * - Returns `true` if at least one element in the array is `true`.
+ * - Returns `false` if all elements are `false` or array is empty.
+ */
+type OrArr<Conditions extends readonly unknown[]>=true extends Conditions[number]?true:false;export type{And as A,OrArr as O,AndArr as a,Or as b};

package/dist/parsers/index.cjs

@@ -1 +1 @@
-'use strict';var chunkBYZAD3XN_cjs=require('../chunk-BYZAD3XN.cjs');require('../chunk-CN53M4QZ.cjs');Object.defineProperty(exports,"extractFileName",{enumerable:true,get:function(){return chunkBYZAD3XN_cjs.a}});
+"use strict";var e=require("../chunk-26XIKDJI.cjs");require("../chunk-INUFZJLX.cjs"),Object.defineProperty(exports,"extractFileName",{enumerable:!0,get:function(){return e.extractFileName}});

package/dist/parsers/index.d.ts

@@ -1,37 +1,36 @@
 /** ----------------------------------------------------------
-* * ***Extracts the base file name (without extension) from a given URL, file path, or file name.***
-* ----------------------------------------------------------
-*
-* - ✅ Strips known extensions (including multi-part extensions such as `.tar.gz`, `.tar.bz2`, etc.).
-* - ✅ Handles plain file names, local file paths, and full URLs seamlessly.
-* - ✅ If the path ends with a `/`, returns an empty string `""` (represents a directory or empty segment).
-* - ✅ If the input is empty, whitespace, or not a string, returns `undefined`.
-* - ✅ Leaves unknown or unrecognized extensions intact (does not attempt to strip unknown file extensions).
-*
-* Behavior summary:
-* - `extractFileName("https://example.com/file.txt")` → `"file"`
-* - `extractFileName("/local/path/image.jpeg")` → `"image"`
-* - `extractFileName("backup.archive.tar.gz")` → `"backup.archive"`
-* - `extractFileName("folder/")` → `""`
-* - `extractFileName("")` → `undefined`
-* - `extractFileName("unknownfile.weirdext")` → `"unknownfile.weirdext"` (keeps unknown extension)
-*
-* This is particularly useful for displaying or logging file names
-* without cluttering them with redundant extensions, while being careful
-* not to accidentally truncate unfamiliar formats.
-*
-* @param {string} url - The URL, file system path, or plain file name to process.
-* @returns {string | undefined} The file name without its extension(s),
-*                               or `undefined` if input is invalid,
-*                               or an empty string `""` if the path ends with `/`.
-*
-* @example
-* extractFileName("document.pdf");                     // "document"
-* extractFileName("/files/archive.tar.gz");            // "archive"
-* extractFileName("https://cdn.site.com/video.mp4");   // "video"
-* extractFileName("folder/");                          // ""
-* extractFileName("strangefile.unknownext");           // "strangefile.unknownext"
-* extractFileName("");                                 // undefined
-* extractFileName(123);                                // undefined
-*/
-declare const extractFileName:(url?:string|null)=>string|undefined;export{extractFileName};
+ * * ***Utility: `extractFileName`.***
+ * ----------------------------------------------------------
+ * **Extracts the base file name (without extension) from a given URL, file path, or file name.**
+ * - **Behavior:**
+ *    - Strips known extensions (including multi-part extensions such as `.tar.gz`, `.tar.bz2`, etc.).
+ *    - Handles plain file names, local file paths, and full URLs seamlessly.
+ *    - If the path ends with a `/`, returns an empty string `""` (represents a directory or empty segment).
+ *    - If the input is empty, whitespace, or not a string, returns `undefined`.
+ *    - Leaves unknown or unrecognized extensions intact (does not attempt to strip unknown file extensions).
+ * - **Summary:**
+ *    - `extractFileName("https://example.com/file.txt")` ➔ `"file"`.
+ *    - `extractFileName("/local/path/image.jpeg")` ➔ `"image"`.
+ *    - `extractFileName("backup.archive.tar.gz")` ➔ `"backup.archive"`.
+ *    - `extractFileName("folder/")` ➔ `""`.
+ *    - `extractFileName("")` ➔ `undefined`.
+ *    - `extractFileName("unknownfile.weirdext")` ➔ `"unknownfile.weirdext"`
+ *       ***(keeps unknown extension)***.
+ * @description
+ * This is particularly useful for displaying or logging file names
+ * without cluttering them with redundant extensions, while being careful
+ * not to accidentally truncate unfamiliar formats.
+ * @param {string | null | undefined} url - The URL, file system path, or plain file name to process.
+ * @returns {string | undefined} The file name without its extension(s),
+ *                               or `undefined` if input is invalid,
+ *                               or an empty string `""` if the path ends with `/`.
+ * @example
+ * extractFileName("document.pdf");                   // ➔ "document"
+ * extractFileName("/files/archive.tar.gz");          // ➔ "archive"
+ * extractFileName("https://cdn.site.com/video.mp4"); // ➔ "video"
+ * extractFileName("folder/");                        // ➔ ""
+ * extractFileName("strangefile.unknownext");         // ➔ "strangefile.unknownext"
+ * extractFileName("");                               // ➔ undefined
+ * extractFileName(123);                              // ➔ undefined
+ */
+declare const extractFileName:(url:string|null|undefined)=>string|undefined;export{extractFileName};

package/dist/parsers/index.js

@@ -1 +1 @@
-export{a as extractFileName}from'../chunk-EXZ47NOW.js';import'../chunk-XCFIOTCV.js';
+export{extractFileName}from"../chunk-7KJBDGEP.js";import"../chunk-2UIRWYE3.js";

package/dist/predicates/index.cjs

@@ -1 +1 @@
-'use strict';var chunk7NA6DUHR_cjs=require('../chunk-7NA6DUHR.cjs'),chunkFIEZKTAZ_cjs=require('../chunk-FIEZKTAZ.cjs'),chunkD47MHBSD_cjs=require('../chunk-D47MHBSD.cjs'),chunkUUPQI6ND_cjs=require('../chunk-UUPQI6ND.cjs'),chunkKCQDDZJE_cjs=require('../chunk-KCQDDZJE.cjs');require('../chunk-JWHM3WZQ.cjs');var chunkFDITZ5C6_cjs=require('../chunk-FDITZ5C6.cjs'),chunk2TRAPBZ7_cjs=require('../chunk-2TRAPBZ7.cjs');require('../chunk-BVPMMWDL.cjs');var chunkPUQXRLZH_cjs=require('../chunk-PUQXRLZH.cjs'),chunkU5Y2FXMN_cjs=require('../chunk-U5Y2FXMN.cjs'),chunk7YWAQOA4_cjs=require('../chunk-7YWAQOA4.cjs'),chunkCN53M4QZ_cjs=require('../chunk-CN53M4QZ.cjs');Object.defineProperty(exports,"areArraysEqual",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.a}});Object.defineProperty(exports,"areObjectsEqual",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.b}});Object.defineProperty(exports,"areURLsEqualPath",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.c}});Object.defineProperty(exports,"areURLsIdentical",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.d}});Object.defineProperty(exports,"arrayHasAnyMatch",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.h}});Object.defineProperty(exports,"doesKeyExist",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.g}});Object.defineProperty(exports,"isArguments",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.i}});Object.defineProperty(exports,"isArrayLike",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.k}});Object.defineProperty(exports,"isArrayLikeObject",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.l}});Object.defineProperty(exports,"isCurrencyLike",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.m}});Object.defineProperty(exports,"isDeepEqual",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.n}});Object.defineProperty(exports,"isElement",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.o}});Object.defineProperty(exports,"isEmpty",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.p}});Object.defineProperty(exports,"isEmptyDeep",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.q}});Object.defineProperty(exports,"isEqualWith",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.r}});Object.defineProperty(exports,"isLength",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.j}});Object.defineProperty(exports,"isMatch",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.t}});Object.defineProperty(exports,"isMatchWith",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.s}});Object.defineProperty(exports,"isNative",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.u}});Object.defineProperty(exports,"isObjectLoose",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.v}});Object.defineProperty(exports,"isSafeInteger",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.w}});Object.defineProperty(exports,"isValidURL",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.x}});Object.defineProperty(exports,"isWeakMap",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.y}});Object.defineProperty(exports,"textContainsAll",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.e}});Object.defineProperty(exports,"textContainsAny",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.f}});Object.defineProperty(exports,"isURL",{enumerable:true,get:function(){return chunkFIEZKTAZ_cjs.a}});Object.defineProperty(exports,"isNonEmptyValue",{enumerable:true,get:function(){return chunkD47MHBSD_cjs.a}});Object.defineProperty(exports,"isTypedArray",{enumerable:true,get:function(){return chunkD47MHBSD_cjs.b}});Object.defineProperty(exports,"isEmptyValue",{enumerable:true,get:function(){return chunkUUPQI6ND_cjs.a}});Object.defineProperty(exports,"isArrayBuffer",{enumerable:true,get:function(){return chunkKCQDDZJE_cjs.b}});Object.defineProperty(exports,"isEmptyArray",{enumerable:true,get:function(){return chunkKCQDDZJE_cjs.e}});Object.defineProperty(exports,"isEmptyObject",{enumerable:true,get:function(){return chunkKCQDDZJE_cjs.f}});Object.defineProperty(exports,"isEqual",{enumerable:true,get:function(){return chunkKCQDDZJE_cjs.d}});Object.defineProperty(exports,"isRegExp",{enumerable:true,get:function(){return chunkKCQDDZJE_cjs.a}});Object.defineProperty(exports,"isFinite",{enumerable:true,get:function(){return chunkFDITZ5C6_cjs.a}});Object.defineProperty(exports,"isEmptyString",{enumerable:true,get:function(){return chunk2TRAPBZ7_cjs.a}});Object.defineProperty(exports,"isInteger",{enumerable:true,get:function(){return chunkPUQXRLZH_cjs.a}});Object.defineProperty(exports,"isDate",{enumerable:true,get:function(){return chunkU5Y2FXMN_cjs.b}});Object.defineProperty(exports,"isMap",{enumerable:true,get:function(){return chunkU5Y2FXMN_cjs.a}});Object.defineProperty(exports,"isBigInt",{enumerable:true,get:function(){return chunk7YWAQOA4_cjs.a}});Object.defineProperty(exports,"getPreciseType",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.E}});Object.defineProperty(exports,"hasOwnProp",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.o}});Object.defineProperty(exports,"isArray",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.d}});Object.defineProperty(exports,"isBoolean",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.a}});Object.defineProperty(exports,"isBuffer",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.C}});Object.defineProperty(exports,"isError",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.D}});Object.defineProperty(exports,"isFunction",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.b}});Object.defineProperty(exports,"isNaN",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.n}});Object.defineProperty(exports,"isNil",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.c}});Object.defineProperty(exports,"isNonEmptyArray",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.r}});Object.defineProperty(exports,"isNonEmptyString",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.p}});Object.defineProperty(exports,"isNull",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.g}});Object.defineProperty(exports,"isNumber",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.i}});Object.defineProperty(exports,"isObject",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.e}});Object.defineProperty(exports,"isObjectOrArray",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.l}});Object.defineProperty(exports,"isPlainObject",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.f}});Object.defineProperty(exports,"isSet",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.q}});Object.defineProperty(exports,"isString",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.h}});Object.defineProperty(exports,"isSymbol",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.j}});Object.defineProperty(exports,"isUndefined",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.k}});
+"use strict";var e=require("../chunk-735HJXBT.cjs"),r=require("../chunk-KHO2SBNA.cjs"),t=require("../chunk-WBWTXKMC.cjs"),n=require("../chunk-GGRMHIFJ.cjs"),i=require("../chunk-Z4DXK7A6.cjs");require("../chunk-7BXIZM57.cjs");var u=require("../chunk-YZR5OGJA.cjs"),o=require("../chunk-EBMHQW7X.cjs");require("../chunk-Y4O5KZF6.cjs");var s=require("../chunk-DVMHRLKP.cjs"),c=require("../chunk-E63WVPZE.cjs"),p=require("../chunk-UDA26MCU.cjs"),b=require("../chunk-INUFZJLX.cjs");Object.defineProperty(exports,"areArraysEqual",{enumerable:!0,get:function(){return e.areArraysEqual}}),Object.defineProperty(exports,"areObjectsEqual",{enumerable:!0,get:function(){return e.areObjectsEqual}}),Object.defineProperty(exports,"areURLsEqualPath",{enumerable:!0,get:function(){return e.areURLsEqualPath}}),Object.defineProperty(exports,"areURLsIdentical",{enumerable:!0,get:function(){return e.areURLsIdentical}}),Object.defineProperty(exports,"arrayHasAnyMatch",{enumerable:!0,get:function(){return e.arrayHasAnyMatch}}),Object.defineProperty(exports,"doesKeyExist",{enumerable:!0,get:function(){return e.doesKeyExist}}),Object.defineProperty(exports,"isArguments",{enumerable:!0,get:function(){return e.isArguments}}),Object.defineProperty(exports,"isArrayLike",{enumerable:!0,get:function(){return e.isArrayLike}}),Object.defineProperty(exports,"isArrayLikeObject",{enumerable:!0,get:function(){return e.isArrayLikeObject}}),Object.defineProperty(exports,"isCurrencyLike",{enumerable:!0,get:function(){return e.isCurrencyLike}}),Object.defineProperty(exports,"isDeepEqual",{enumerable:!0,get:function(){return e.isDeepEqual}}),Object.defineProperty(exports,"isElement",{enumerable:!0,get:function(){return e.isElement}}),Object.defineProperty(exports,"isEmpty",{enumerable:!0,get:function(){return e.isEmpty}}),Object.defineProperty(exports,"isEmptyDeep",{enumerable:!0,get:function(){return e.isEmptyDeep}}),Object.defineProperty(exports,"isEqualWith",{enumerable:!0,get:function(){return e.isEqualWith}}),Object.defineProperty(exports,"isLength",{enumerable:!0,get:function(){return e.isLength}}),Object.defineProperty(exports,"isMatch",{enumerable:!0,get:function(){return e.isMatch}}),Object.defineProperty(exports,"isMatchWith",{enumerable:!0,get:function(){return e.isMatchWith}}),Object.defineProperty(exports,"isNative",{enumerable:!0,get:function(){return e.isNative}}),Object.defineProperty(exports,"isObjectLoose",{enumerable:!0,get:function(){return e.isObjectLoose}}),Object.defineProperty(exports,"isPropertyKey",{enumerable:!0,get:function(){return e.isPropertyKey}}),Object.defineProperty(exports,"isSafeInteger",{enumerable:!0,get:function(){return e.isSafeInteger}}),Object.defineProperty(exports,"isValidURL",{enumerable:!0,get:function(){return e.isValidURL}}),Object.defineProperty(exports,"isWeakMap",{enumerable:!0,get:function(){return e.isWeakMap}}),Object.defineProperty(exports,"textContainsAll",{enumerable:!0,get:function(){return e.textContainsAll}}),Object.defineProperty(exports,"textContainsAny",{enumerable:!0,get:function(){return e.textContainsAny}}),Object.defineProperty(exports,"isURL",{enumerable:!0,get:function(){return r.isURL}}),Object.defineProperty(exports,"isNonEmptyValue",{enumerable:!0,get:function(){return t.isNonEmptyValue}}),Object.defineProperty(exports,"isTypedArray",{enumerable:!0,get:function(){return t.isTypedArray}}),Object.defineProperty(exports,"isEmptyValue",{enumerable:!0,get:function(){return n.isEmptyValue}}),Object.defineProperty(exports,"isArrayBuffer",{enumerable:!0,get:function(){return i.isArrayBuffer}}),Object.defineProperty(exports,"isEmptyArray",{enumerable:!0,get:function(){return i.isEmptyArray}}),Object.defineProperty(exports,"isEmptyObject",{enumerable:!0,get:function(){return i.isEmptyObject}}),Object.defineProperty(exports,"isEqual",{enumerable:!0,get:function(){return i.isEqual}}),Object.defineProperty(exports,"isRegExp",{enumerable:!0,get:function(){return i.isRegExp}}),Object.defineProperty(exports,"isFinite",{enumerable:!0,get:function(){return u.isFinite}}),Object.defineProperty(exports,"isEmptyString",{enumerable:!0,get:function(){return o.isEmptyString}}),Object.defineProperty(exports,"isInteger",{enumerable:!0,get:function(){return s.isInteger}}),Object.defineProperty(exports,"isDate",{enumerable:!0,get:function(){return c.isDate}}),Object.defineProperty(exports,"isMap",{enumerable:!0,get:function(){return c.isMap}}),Object.defineProperty(exports,"isBigInt",{enumerable:!0,get:function(){return p.isBigInt}}),Object.defineProperty(exports,"getPreciseType",{enumerable:!0,get:function(){return b.getPreciseType}}),Object.defineProperty(exports,"hasOwnProp",{enumerable:!0,get:function(){return b.hasOwnProp}}),Object.defineProperty(exports,"isArray",{enumerable:!0,get:function(){return b.isArray}}),Object.defineProperty(exports,"isBoolean",{enumerable:!0,get:function(){return b.isBoolean}}),Object.defineProperty(exports,"isBooleanObject",{enumerable:!0,get:function(){return b.isBooleanObject}}),Object.defineProperty(exports,"isBuffer",{enumerable:!0,get:function(){return b.isBuffer}}),Object.defineProperty(exports,"isError",{enumerable:!0,get:function(){return b.isError}}),Object.defineProperty(exports,"isFunction",{enumerable:!0,get:function(){return b.isFunction}}),Object.defineProperty(exports,"isInfinityNumber",{enumerable:!0,get:function(){return b.isInfinityNumber}}),Object.defineProperty(exports,"isNaN",{enumerable:!0,get:function(){return b.isNaN}}),Object.defineProperty(exports,"isNil",{enumerable:!0,get:function(){return b.isNil}}),Object.defineProperty(exports,"isNonEmptyArray",{enumerable:!0,get:function(){return b.isNonEmptyArray}}),Object.defineProperty(exports,"isNonEmptyString",{enumerable:!0,get:function(){return b.isNonEmptyString}}),Object.defineProperty(exports,"isNull",{enumerable:!0,get:function(){return b.isNull}}),Object.defineProperty(exports,"isNumber",{enumerable:!0,get:function(){return b.isNumber}}),Object.defineProperty(exports,"isNumberObject",{enumerable:!0,get:function(){return b.isNumberObject}}),Object.defineProperty(exports,"isObject",{enumerable:!0,get:function(){return b.isObject}}),Object.defineProperty(exports,"isObjectOrArray",{enumerable:!0,get:function(){return b.isObjectOrArray}}),Object.defineProperty(exports,"isPlainObject",{enumerable:!0,get:function(){return b.isPlainObject}}),Object.defineProperty(exports,"isSet",{enumerable:!0,get:function(){return b.isSet}}),Object.defineProperty(exports,"isString",{enumerable:!0,get:function(){return b.isString}}),Object.defineProperty(exports,"isStringObject",{enumerable:!0,get:function(){return b.isStringObject}}),Object.defineProperty(exports,"isSymbol",{enumerable:!0,get:function(){return b.isSymbol}}),Object.defineProperty(exports,"isUndefined",{enumerable:!0,get:function(){return b.isUndefined}});