umt 2.16.0 → 2.18.0

package/module/String/index.js

@@ -1,4 +1,7 @@
 export * from "./camelCase";
+export * from "./capitalize";
+export * from "./capitalizeWord";
+export * from "./dedent";
 export * from "./deleteSpaces";
 export * from "./escapeHtml";
 export * from "./formatString";
@@ -7,18 +10,25 @@ export * from "./fuzzySearch";
 export * from "./hasNoLetters";
 export * from "./kebabCase";
 export * from "./levenshteinDistance";
+export * from "./mask";
 export * from "./padEnd";
 export * from "./padStart";
+export * from "./pascalCase";
 export * from "./randomString";
 export * from "./randomStringInitialization";
 export * from "./reverseString";
 export * from "./slugify";
+export * from "./snakeCase";
 export * from "./stringSimilarity";
+export * from "./titleCase";
 export * from "./toBase64";
 export * from "./toHalfWidth";
 export * from "./trimCharacters";
 export * from "./trimEndCharacters";
 export * from "./trimStartCharacters";
 export * from "./truncate";
+export * from "./uncapitalize";
 export * from "./unescapeHtml";
+export * from "./wordCount";
+export * from "./words";
 //# sourceMappingURL=index.js.map

package/module/String/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/String/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/String/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/module/String/mask.d.ts

@@ -0,0 +1,20 @@
+export interface MaskOptions {
+    /** Number of leading characters to keep visible. Default: 1 */
+    start?: number;
+    /** Number of trailing characters to keep visible. Default: 1 */
+    end?: number;
+    /** Mask character. Default: "*" */
+    char?: string;
+}
+/**
+ * Masks the middle portion of a string with a fill character, preserving the
+ * leading and trailing visible counts. Surrogate-pair safe.
+ *
+ * @param {string} string_ - Input string
+ * @param {MaskOptions} [options] - Visible-character counts and mask char
+ * @returns {string} Masked string
+ * @example
+ * mask("1234567890", { start: 2, end: 4 }); // "12****7890"
+ * mask("secret"); // "s****t"
+ */
+export declare const mask: (string_: string, options?: MaskOptions) => string;

package/module/String/mask.js

@@ -0,0 +1,24 @@
+/**
+ * Masks the middle portion of a string with a fill character, preserving the
+ * leading and trailing visible counts. Surrogate-pair safe.
+ *
+ * @param {string} string_ - Input string
+ * @param {MaskOptions} [options] - Visible-character counts and mask char
+ * @returns {string} Masked string
+ * @example
+ * mask("1234567890", { start: 2, end: 4 }); // "12****7890"
+ * mask("secret"); // "s****t"
+ */
+export const mask = (string_, options = {}) => {
+    const { start = 1, end = 1, char = "*" } = options;
+    const graphemes = [...string_];
+    const length = graphemes.length;
+    if (start + end >= length) {
+        return string_;
+    }
+    const middleLength = length - start - end;
+    return (graphemes.slice(0, start).join("") +
+        char.repeat(middleLength) +
+        graphemes.slice(length - end).join(""));
+};
+//# sourceMappingURL=mask.js.map

package/module/String/mask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.js","sourceRoot":"","sources":["../../src/String/mask.ts"],"names":[],"mappings":"AASA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,UAAuB,EAAE,EAAU,EAAE;IACzE,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC;IACnD,MAAM,SAAS,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;IAChC,IAAI,KAAK,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC;IAC1C,OAAO,CACL,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;QACzB,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CACvC,CAAC;AACJ,CAAC,CAAC"}

package/module/String/pascalCase.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Converts a string to PascalCase.
+ * @param {string} string_ - Input string
+ * @returns {string} PascalCase string
+ * @example
+ * pascalCase("hello-world"); // "HelloWorld"
+ * pascalCase("hello_world"); // "HelloWorld"
+ */
+export declare const pascalCase: (string_: string) => string;

package/module/String/pascalCase.js

@@ -0,0 +1,14 @@
+import { capitalizeWord } from "./capitalizeWord";
+import { words } from "./words";
+/**
+ * Converts a string to PascalCase.
+ * @param {string} string_ - Input string
+ * @returns {string} PascalCase string
+ * @example
+ * pascalCase("hello-world"); // "HelloWorld"
+ * pascalCase("hello_world"); // "HelloWorld"
+ */
+export const pascalCase = (string_) => words(string_)
+    .map((word) => capitalizeWord(word))
+    .join("");
+//# sourceMappingURL=pascalCase.js.map

package/module/String/pascalCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pascalCase.js","sourceRoot":"","sources":["../../src/String/pascalCase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAU,EAAE,CACpD,KAAK,CAAC,OAAO,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;KACnC,IAAI,CAAC,EAAE,CAAC,CAAC"}

package/module/String/snakeCase.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Converts a string to snake_case.
+ * @param {string} string_ - Input string
+ * @returns {string} snake_case string
+ * @example
+ * snakeCase("helloWorld"); // "hello_world"
+ * snakeCase("Hello World"); // "hello_world"
+ */
+export declare const snakeCase: (string_: string) => string;

package/module/String/snakeCase.js

@@ -0,0 +1,13 @@
+import { words } from "./words";
+/**
+ * Converts a string to snake_case.
+ * @param {string} string_ - Input string
+ * @returns {string} snake_case string
+ * @example
+ * snakeCase("helloWorld"); // "hello_world"
+ * snakeCase("Hello World"); // "hello_world"
+ */
+export const snakeCase = (string_) => words(string_)
+    .map((word) => word.toLowerCase())
+    .join("_");
+//# sourceMappingURL=snakeCase.js.map

package/module/String/snakeCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snakeCase.js","sourceRoot":"","sources":["../../src/String/snakeCase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAU,EAAE,CACnD,KAAK,CAAC,OAAO,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;KACjC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/module/String/titleCase.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Converts a string to Title Case (each word capitalized, separated by spaces).
+ * @param {string} string_ - Input string
+ * @returns {string} Title Case string
+ * @example
+ * titleCase("hello world"); // "Hello World"
+ * titleCase("a-quick brown_fox"); // "A Quick Brown Fox"
+ */
+export declare const titleCase: (string_: string) => string;

package/module/String/titleCase.js

@@ -0,0 +1,14 @@
+import { capitalizeWord } from "./capitalizeWord";
+import { words } from "./words";
+/**
+ * Converts a string to Title Case (each word capitalized, separated by spaces).
+ * @param {string} string_ - Input string
+ * @returns {string} Title Case string
+ * @example
+ * titleCase("hello world"); // "Hello World"
+ * titleCase("a-quick brown_fox"); // "A Quick Brown Fox"
+ */
+export const titleCase = (string_) => words(string_)
+    .map((word) => capitalizeWord(word))
+    .join(" ");
+//# sourceMappingURL=titleCase.js.map

package/module/String/titleCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"titleCase.js","sourceRoot":"","sources":["../../src/String/titleCase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAU,EAAE,CACnD,KAAK,CAAC,OAAO,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;KACnC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/module/String/uncapitalize.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Lowercases the first grapheme of a string. Surrogate-pair safe.
+ *
+ * @param {string} string_ - Input string
+ * @returns {string} String with the first grapheme lowercased
+ * @example
+ * uncapitalize("Hello"); // "hello"
+ * uncapitalize("ÉCLAIR"); // "éCLAIR"
+ */
+export declare const uncapitalize: (string_: string) => string;

package/module/String/uncapitalize.js

@@ -0,0 +1,16 @@
+/**
+ * Lowercases the first grapheme of a string. Surrogate-pair safe.
+ *
+ * @param {string} string_ - Input string
+ * @returns {string} String with the first grapheme lowercased
+ * @example
+ * uncapitalize("Hello"); // "hello"
+ * uncapitalize("ÉCLAIR"); // "éCLAIR"
+ */
+export const uncapitalize = (string_) => {
+    for (const first of string_) {
+        return first.toLowerCase() + string_.slice(first.length);
+    }
+    return string_;
+};
+//# sourceMappingURL=uncapitalize.js.map

package/module/String/uncapitalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uncapitalize.js","sourceRoot":"","sources":["../../src/String/uncapitalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAU,EAAE;IACtD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/module/String/wordCount.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Counts words in a string using the same boundaries as `words`.
+ *
+ * @param {string} string_ - Input string
+ * @returns {number} Word count
+ * @example
+ * wordCount("hello world"); // 2
+ * wordCount("camelCase split"); // 3
+ */
+export declare const wordCount: (string_: string) => number;

package/module/String/wordCount.js

@@ -0,0 +1,12 @@
+import { words } from "./words";
+/**
+ * Counts words in a string using the same boundaries as `words`.
+ *
+ * @param {string} string_ - Input string
+ * @returns {number} Word count
+ * @example
+ * wordCount("hello world"); // 2
+ * wordCount("camelCase split"); // 3
+ */
+export const wordCount = (string_) => words(string_).length;
+//# sourceMappingURL=wordCount.js.map

package/module/String/wordCount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wordCount.js","sourceRoot":"","sources":["../../src/String/wordCount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC"}

package/module/String/words.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Splits a string into words on case boundaries and non-alphanumeric separators.
+ * Uses Unicode property escapes so CJK and other letters are preserved.
+ *
+ * @param {string} string_ - Input string
+ * @param {RegExp} [pattern] - Custom matching pattern; defaults to a Unicode word matcher
+ * @returns {string[]} Array of words
+ * @example
+ * words("helloWorld foo-bar"); // ["hello", "World", "foo", "bar"]
+ * words("XMLHttpRequest"); // ["XML", "Http", "Request"]
+ */
+export declare const words: (string_: string, pattern?: RegExp) => string[];

package/module/String/words.js

@@ -0,0 +1,21 @@
+/**
+ * Splits a string into words on case boundaries and non-alphanumeric separators.
+ * Uses Unicode property escapes so CJK and other letters are preserved.
+ *
+ * @param {string} string_ - Input string
+ * @param {RegExp} [pattern] - Custom matching pattern; defaults to a Unicode word matcher
+ * @returns {string[]} Array of words
+ * @example
+ * words("helloWorld foo-bar"); // ["hello", "World", "foo", "bar"]
+ * words("XMLHttpRequest"); // ["XML", "Http", "Request"]
+ */
+export const words = (string_, pattern) => {
+    if (pattern) {
+        return string_.match(pattern) ?? [];
+    }
+    const withBoundaries = string_
+        .replaceAll(/([\p{Ll}\p{N}])(\p{Lu})/gu, "$1 $2")
+        .replaceAll(/(\p{Lu})(\p{Lu}\p{Ll})/gu, "$1 $2");
+    return withBoundaries.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+};
+//# sourceMappingURL=words.js.map

package/module/String/words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.js","sourceRoot":"","sources":["../../src/String/words.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,OAAgB,EAAY,EAAE;IACnE,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;IACD,MAAM,cAAc,GAAG,OAAO;SAC3B,UAAU,CAAC,2BAA2B,EAAE,OAAO,CAAC;SAChD,UAAU,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,cAAc,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjE,CAAC,CAAC"}

package/module/Tool/createPipeline.d.ts

@@ -17,4 +17,4 @@ export interface Pipeline<T> {
  * pipeline(); // 1
  * pipeline((x) => x + 1)(); // 2
  */
-export declare const createPipeline: <T>(initialValue: T) => Pipeline<T>;
+export declare function createPipeline<T>(initialValue: T): Pipeline<T>;

package/module/Tool/createPipeline.js

@@ -7,10 +7,12 @@
  * pipeline(); // 1
  * pipeline((x) => x + 1)(); // 2
  */
-export const createPipeline = (initialValue) => 
-// Accepts a transformer function as an argument and returns a new Pipeline.
-// If no argument is provided, returns the stored value (initialValue).
-((transformer) => transformer
-    ? createPipeline(transformer(initialValue))
-    : initialValue);
+export function createPipeline(initialValue) {
+    function pipeline(transformer) {
+        return transformer
+            ? createPipeline(transformer(initialValue))
+            : initialValue;
+    }
+    return pipeline;
+}
 //# sourceMappingURL=createPipeline.js.map

package/module/Tool/createPipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"createPipeline.js","sourceRoot":"","sources":["../../src/Tool/createPipeline.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwC,CACjE,YAAe,EACf,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,CAAC,CAAI,WAA6B,EAAE,EAAE,CACpC,WAAW;IACT,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC,CAAC,YAAY,CAAgB,CAAC"}
+{"version":3,"file":"createPipeline.js","sourceRoot":"","sources":["../../src/Tool/createPipeline.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAI,YAAe;IAG/C,SAAS,QAAQ,CAAI,WAA6B;QAChD,OAAO,WAAW;YAChB,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAC3C,CAAC,CAAC,YAAY,CAAC;IACnB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/module/Tool/pipe.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../../src/Tool/pipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAe,MAAM,qBAAqB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,OAAO,IAAI;IAIc;IAH7B;;OAEG;IACH,YAA6B,KAAQ;QAAR,UAAK,GAAL,KAAK,CAAG;IAAG,CAAC;IAEzC;;;;OAIG;IACH,GAAG,CAAI,SAA0B;QAC/B,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,IAAI,CACF,SAAgC,EAChC,SAA0B;QAE1B,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;YAC1B,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAyB,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,SAA6B;QAC/B,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CAAc,SAAmC;QAC3D,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB,CACf,SAAmC,EACnC,YAAe;QAEf,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;YAC1B,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YACtB,CAAC,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,YAAY,CACV,SAAmC;QAEnC,OAAO,IAAI,IAAI,CACb,WAAW,CAAO,GAAG,EAAE;YACrB,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC,KAAK,CAAC;YACpB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAI,YAAe;IACrC,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../../src/Tool/pipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAe,MAAM,qBAAqB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,OAAO,IAAI;IAIc;IAH7B;;OAEG;IACH,YAA6B,KAAQ;QAAR,UAAK,GAAL,KAAK,CAAG;IAAG,CAAC;IAEzC;;;;OAIG;IACH,GAAG,CAAI,SAA0B;QAC/B,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,IAAI,CACF,SAAgC,EAChC,SAA0B;QAE1B,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;YAC1B,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,SAA6B;QAC/B,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CAAc,SAAmC;QAC3D,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB,CACf,SAAmC,EACnC,YAAe;QAEf,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;YAC1B,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YACtB,CAAC,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,YAAY,CACV,SAAmC;QAEnC,OAAO,IAAI,IAAI,CACb,WAAW,CAAO,GAAG,EAAE;YACrB,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC,KAAK,CAAC;YACpB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAI,YAAe;IACrC,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;AAChC,CAAC"}

package/module/URL/buildUrl.d.ts

@@ -5,6 +5,16 @@
  * @param params - An object of key-value pairs to append as query parameters
  * @returns The complete URL string with query parameters
  *
+ * @remarks
+ * **Prototype pollution warning:** This function does not filter out
+ * prototype-polluting keys (`__proto__`, `constructor`, `prototype`).
+ * If processing user-controlled input, sanitize with the appropriate
+ * `removePrototype*` helper before calling this function:
+ * - `removePrototype` — shallow sanitization of a single object
+ * - `removePrototypeDeep` — recursive sanitization of a single object (for deeply nested data)
+ * - `removePrototypeMap` — shallow sanitization of an array of objects
+ * - `removePrototypeMapDeep` — recursive sanitization of an array of objects (for deeply nested data)
+ *
  * @example
  * ```typescript
  * buildUrl("https://example.com", { page: "1", q: "search" });

package/module/URL/buildUrl.js

@@ -5,6 +5,16 @@
  * @param params - An object of key-value pairs to append as query parameters
  * @returns The complete URL string with query parameters
  *
+ * @remarks
+ * **Prototype pollution warning:** This function does not filter out
+ * prototype-polluting keys (`__proto__`, `constructor`, `prototype`).
+ * If processing user-controlled input, sanitize with the appropriate
+ * `removePrototype*` helper before calling this function:
+ * - `removePrototype` — shallow sanitization of a single object
+ * - `removePrototypeDeep` — recursive sanitization of a single object (for deeply nested data)
+ * - `removePrototypeMap` — shallow sanitization of an array of objects
+ * - `removePrototypeMapDeep` — recursive sanitization of an array of objects (for deeply nested data)
+ *
  * @example
  * ```typescript
  * buildUrl("https://example.com", { page: "1", q: "search" });
@@ -17,10 +27,6 @@
 export const buildUrl = (base, parameters = {}) => {
     const url = new URL(base);
     for (const key of Object.keys(parameters)) {
-        // Prevent prototype pollution by rejecting dangerous keys
-        if (key === "__proto__" || key === "constructor" || key === "prototype") {
-            continue;
-        }
         url.searchParams.append(key, parameters[key]);
     }
     return url.toString();

package/module/URL/buildUrl.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildUrl.js","sourceRoot":"","sources":["../../src/URL/buildUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,IAAY,EACZ,aAAqC,EAAE,EAC/B,EAAE;IACV,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,0DAA0D;QAC1D,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxE,SAAS;QACX,CAAC;QACD,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC,CAAC"}
+{"version":3,"file":"buildUrl.js","sourceRoot":"","sources":["../../src/URL/buildUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,IAAY,EACZ,aAAqC,EAAE,EAC/B,EAAE;IACV,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC,CAAC"}

package/module/URL/parseQueryString.d.ts

@@ -7,6 +7,12 @@
  * @param query - The query string or URL to parse
  * @returns A record of key-value pairs from the query string
  *
+ * @remarks
+ * **Prototype pollution warning:** This function does not filter out
+ * prototype-polluting keys (`__proto__`, `constructor`, `prototype`).
+ * If processing user-controlled input, sanitize the result with
+ * `removePrototype` after calling this function.
+ *
  * @example
  * ```typescript
  * parseQueryString("?page=1&q=search");

package/module/URL/parseQueryString.js

@@ -7,6 +7,12 @@
  * @param query - The query string or URL to parse
  * @returns A record of key-value pairs from the query string
  *
+ * @remarks
+ * **Prototype pollution warning:** This function does not filter out
+ * prototype-polluting keys (`__proto__`, `constructor`, `prototype`).
+ * If processing user-controlled input, sanitize the result with
+ * `removePrototype` after calling this function.
+ *
  * @example
  * ```typescript
  * parseQueryString("?page=1&q=search");
@@ -27,10 +33,6 @@ export const parseQueryString = (query) => {
     const parameters = new URLSearchParams(searchString);
     const result = {};
     for (const [key, value] of parameters) {
-        // Prevent prototype pollution by rejecting dangerous keys
-        if (key === "__proto__" || key === "constructor" || key === "prototype") {
-            continue;
-        }
         result[key] = value;
     }
     return result;

package/module/URL/parseQueryString.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseQueryString.js","sourceRoot":"","sources":["../../src/URL/parseQueryString.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAA0B,EAAE;IACxE,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,YAAY,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IACvC,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,YAAY,CAAC,CAAC;IACrD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;QACtC,0DAA0D;QAC1D,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxE,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
+{"version":3,"file":"parseQueryString.js","sourceRoot":"","sources":["../../src/URL/parseQueryString.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAA0B,EAAE;IACxE,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,YAAY,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IACvC,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,YAAY,CAAC,CAAC;IACrD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/module/Validate/isNumber.js.map

@@ -1 +1 @@
-{"version":3,"file":"isNumber.js","sourceRoot":"","sources":["../../src/Validate/isNumber.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,QAAQ,GAAG,CACf,MAAe,EACf,QAAW,IAAS,EACiC,EAAE;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,SAAS,IAAI,KAAK;QAC5D,CAAC,CAAC,wDAAwD;YACxD,QAAQ,CAAC,MAAgB,CAAC;QAC5B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAgB,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"isNumber.js","sourceRoot":"","sources":["../../src/Validate/isNumber.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,QAAQ,GAAG,CACf,MAAe,EACf,QAAW,IAAS,EACiC,EAAE;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,SAAS,IAAI,KAAK;QAC5D,CAAC,CAAC,wDAAwD;YACxD,QAAQ,CAAC,MAAgB,CAAC;QAC5B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/module/Validate/object/core.js

@@ -16,7 +16,6 @@ export const object = (option = {}, message) => {
             return {
                 validate: false,
                 message: message ?? "",
-                // biome-ignore lint/suspicious/noExplicitAny: Type assertion needed for return type compatibility
                 type: value,
             };
         }

package/module/Validate/object/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/Validate/object/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAOnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CASpB,SAAY,EAAO,EACnB,OAAgB,EAChB,EAAE;IACF,OAAO,CACL,KAKC,EAMA,EAAE;QACH,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,OAAO,IAAI,EAAE;gBACtB,kGAAkG;gBAClG,IAAI,EAAE,KAAY;aACnB,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;YAC9B,6EAA6E;YAC7E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAE,KAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACzD,OAAO;oBACL,QAAQ,EAAE,KAAK;oBACf,6EAA6E;oBAC7E,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAY,CAAC,CAAC,OAAO;oBAC/C,kGAAkG;oBAClG,IAAI,EAAE,KAAY;iBACnB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,EAAE;YACX,kGAAkG;YAClG,IAAI,EAAE,KAAY;SACnB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/Validate/object/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAOnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CASpB,SAAY,EAAO,EACnB,OAAgB,EAChB,EAAE;IACF,OAAO,CACL,KAKC,EAMA,EAAE;QACH,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,OAAO,IAAI,EAAE;gBACtB,IAAI,EAAE,KAAK;aACZ,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;YAC9B,6EAA6E;YAC7E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAE,KAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACzD,OAAO;oBACL,QAAQ,EAAE,KAAK;oBACf,6EAA6E;oBAC7E,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAY,CAAC,CAAC,OAAO;oBAC/C,kGAAkG;oBAClG,IAAI,EAAE,KAAY;iBACnB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,EAAE;YACX,kGAAkG;YAClG,IAAI,EAAE,KAAY;SACnB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/module/Validate/object/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./core";
 export * from "./intersection";
+export * from "./nullable";
 export * from "./optional";
 export * from "./union";

package/module/Validate/object/index.js

@@ -1,5 +1,6 @@
 export * from "./core";
 export * from "./intersection";
+export * from "./nullable";
 export * from "./optional";
 export * from "./union";
 //# sourceMappingURL=index.js.map

package/module/Validate/object/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Validate/object/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Validate/object/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

package/module/Validate/object/intersection.d.ts

@@ -1,6 +1,8 @@
 import type { UnionToIntersection } from "../../types/logic";
-import type { ValidateCoreReturnType } from "../../Validate/type";
-type ExtractValidatedType<V> = V extends (value: never) => ValidateCoreReturnType<infer T> ? T : never;
+import type { ValidateCoreReturnType, ValidateType } from "../../Validate/type";
+type ExtractValidatedType<V> = V extends (value: never) => {
+    type: infer T;
+} ? ValidateType<T> : never;
 /**
  * Creates an intersection validator that passes only if all given validators pass
  * @param validators - Validator functions to compose as an intersection (logical AND)

package/module/Validate/object/intersection.js.map

@@ -1 +1 @@
-{"version":3,"file":"intersection.js","sourceRoot":"","sources":["../../../src/Validate/object/intersection.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAG1B,GAAG,UAAmB,EACtB,EAAE;IACF,OAAO,CACL,KAA4D,EAG5D,EAAE;QACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GACV,SAKD,CAAC,KAAK,CAAC,CAAC;YACT,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACrB,OAAO;oBACL,QAAQ,EAAE,KAAK;oBACf,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,IAAI,EAAE,KAEL;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,KAEL;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"intersection.js","sourceRoot":"","sources":["../../../src/Validate/object/intersection.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAG1B,GAAG,UAAmB,EACtB,EAAE;IACF,OAAO,CACL,KAA4D,EAG5D,EAAE;QACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GACV,SAKD,CAAC,KAAK,CAAC,CAAC;YACT,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACrB,OAAO;oBACL,QAAQ,EAAE,KAAK;oBACf,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,IAAI,EAAE,KAEL;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,KAEL;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/module/Validate/object/nullable.d.ts

@@ -0,0 +1,8 @@
+import type { ValidateCoreReturnType } from "../../Validate/type";
+/**
+ * Wraps a validator to accept null values
+ * @template T - The type of value the wrapped validator expects
+ * @param {Function} validator - Validator function to make nullable
+ * @returns {Function} - Validator that passes for null or delegates to the wrapped validator
+ */
+export declare const nullable: <T>(validator: (value: T) => ValidateCoreReturnType<T>) => ((value: T | null) => ValidateCoreReturnType<T | null>);

package/module/Validate/object/nullable.js

@@ -0,0 +1,21 @@
+/**
+ * Wraps a validator to accept null values
+ * @template T - The type of value the wrapped validator expects
+ * @param {Function} validator - Validator function to make nullable
+ * @returns {Function} - Validator that passes for null or delegates to the wrapped validator
+ */
+export const nullable = (validator) => {
+    const nullableValidator = (value) => {
+        if (value === null) {
+            return {
+                validate: true,
+                message: "",
+                type: "null",
+            };
+        }
+        const result = validator(value);
+        return result;
+    };
+    return nullableValidator;
+};
+//# sourceMappingURL=nullable.js.map

package/module/Validate/object/nullable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullable.js","sourceRoot":"","sources":["../../../src/Validate/object/nullable.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,SAAkD,EACO,EAAE;IAC3D,MAAM,iBAAiB,GAAG,CACxB,KAAe,EACmB,EAAE;QACpC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,EAAE;gBACX,IAAI,EAAE,MAAM;aACb,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO,iBAAiB,CAAC;AAC3B,CAAC,CAAC"}

package/module/Validate/object/union.d.ts

@@ -1,5 +1,7 @@
-import type { ValidateCoreReturnType } from "../../Validate/type";
-type ExtractValidatedType<V> = V extends (value: never) => ValidateCoreReturnType<infer T> ? T : never;
+import type { ValidateCoreReturnType, ValidateType } from "../../Validate/type";
+type ExtractValidatedType<V> = V extends (value: never) => {
+    type: infer T;
+} ? ValidateType<T> : never;
 /**
  * Creates a union validator that passes if any of the given validators pass
  * @param validators - Validator functions to compose as a union (logical OR)

package/module/Validate/object/union.js.map

@@ -1 +1 @@
-{"version":3,"file":"union.js","sourceRoot":"","sources":["../../../src/Validate/object/union.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAGnB,GAAG,UAAmB,EACtB,EAAE;IACF,OAAO,CACL,KAAuC,EACmB,EAAE;QAC5D,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GACV,SAGD,CAAC,KAAK,CAAC,CAAC;YACT,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,OAAO;oBACL,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,EAAE;oBACX,IAAI,EAAE,KAA2D;iBAClE,CAAC;YACJ,CAAC;YACD,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,WAAW;YACpB,IAAI,EAAE,KAA2D;SAClE,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"union.js","sourceRoot":"","sources":["../../../src/Validate/object/union.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAGnB,GAAG,UAAmB,EACtB,EAAE;IACF,OAAO,CACL,KAAuC,EACmB,EAAE;QAC5D,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GACV,SAGD,CAAC,KAAK,CAAC,CAAC;YACT,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,OAAO;oBACL,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,EAAE;oBACX,IAAI,EAAE,KAA2D;iBAClE,CAAC;YACJ,CAAC;YACD,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,WAAW;YACpB,IAAI,EAAE,KAA2D;SAClE,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/module/Validate/string/index.d.ts

@@ -4,5 +4,6 @@ export * from "./length";
 export * from "./minLength";
 export * from "./maxLength";
 export * from "./numberString";
+export * from "./oneOf";
 export * from "./regexMatch";
 export * from "./uuid";

package/module/Validate/string/index.js

@@ -4,6 +4,7 @@ export * from "./length";
 export * from "./minLength";
 export * from "./maxLength";
 export * from "./numberString";
+export * from "./oneOf";
 export * from "./regexMatch";
 export * from "./uuid";
 //# sourceMappingURL=index.js.map

package/module/Validate/string/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Validate/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Validate/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC"}

package/module/Validate/string/oneOf.d.ts

@@ -0,0 +1,32 @@
+/**
+ * String validation module for literal union (allowed values) check
+ * Provides validation functionality for checking if a string is one of the
+ * allowed literal values, useful for validating string literal union types
+ * such as `'standard' | 'squat' | 'decanter' | 'round' | 'tall' | 'flask'`.
+ *
+ * The validator's return type carries the literal union through its `type`
+ * field directly (instead of going through `Types<T>` which would collapse
+ * to `"string"`), so consumers like `object()`, `union()`, and `intersection()`
+ * can preserve the literal union in their inferred types.
+ */
+/**
+ * Return type produced by a `oneOf` validator. Structurally compatible with
+ * `ValidateCoreReturnType<unknown>`, but exposes the literal union directly
+ * via the `type` field so the inferred type can flow through `object()`,
+ * `union()`, and `intersection()` without being collapsed to `string`.
+ */
+export interface OneOfReturnType<T extends string> {
+    validate: boolean;
+    message: string;
+    type: T;
+}
+/**
+ * Creates a top-level validator that checks if a string value is one of the
+ * given allowed literal values. The literal union is captured via `const T`
+ * and exposed through the `OneOfReturnType<T[number]>` return type.
+ * @template T - The tuple of allowed string literals
+ * @param {T} values - The tuple of allowed string values
+ * @param {string} [message] - Custom error message for validation failure
+ * @returns A validator function from `string` to `OneOfReturnType<T[number]>`
+ */
+export declare const oneOf: <const T extends readonly string[]>(values: T, message?: string) => (value: string) => OneOfReturnType<T[number]>;