umt 2.16.0 → 2.17.0

package/module/Object/index.js

@@ -1,7 +1,10 @@
 export * from "./deepClone";
+export * from "./flattenObject";
+export * from "./get";
 export * from "./getObjectsCommon";
 export * from "./getObjectsDiff";
 export * from "./has";
+export * from "./invert";
 export * from "./isEmpty";
 export * from "./isPlainObject";
 export * from "./keyBy";
@@ -10,10 +13,15 @@ export * from "./mapValues";
 export * from "./merge";
 export * from "./mergeDeep";
 export * from "./omit";
+export * from "./omitBy";
+export * from "./pathSegments";
 export * from "./pick";
+export * from "./pickBy";
 export * from "./pickDeep";
 export * from "./removePrototype";
 export * from "./removePrototypeDeep";
 export * from "./removePrototypeMap";
 export * from "./removePrototypeMapDeep";
+export * from "./set";
+export * from "./unflattenObject";
 //# sourceMappingURL=index.js.map

package/module/Object/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Object/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Object/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,OAAO,CAAC;AACtB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,OAAO,CAAC;AACtB,cAAc,mBAAmB,CAAC"}

package/module/Object/invert.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Creates a new object with keys and values swapped.
+ * If multiple keys share the same value, later entries overwrite earlier ones.
+ *
+ * @template K - Key type of the input object (must be a PropertyKey)
+ * @template V - Value type of the input object (must be a PropertyKey)
+ * @param {Record<K, V>} object - Source object
+ * @returns {Record<V, K>} A new object with keys and values swapped
+ * @example
+ * invert({ a: 1, b: 2 }); // { 1: "a", 2: "b" }
+ */
+export declare const invert: <K extends PropertyKey, V extends PropertyKey>(object: Record<K, V>) => Record<V, K>;

package/module/Object/invert.js

@@ -0,0 +1,20 @@
+/**
+ * Creates a new object with keys and values swapped.
+ * If multiple keys share the same value, later entries overwrite earlier ones.
+ *
+ * @template K - Key type of the input object (must be a PropertyKey)
+ * @template V - Value type of the input object (must be a PropertyKey)
+ * @param {Record<K, V>} object - Source object
+ * @returns {Record<V, K>} A new object with keys and values swapped
+ * @example
+ * invert({ a: 1, b: 2 }); // { 1: "a", 2: "b" }
+ */
+export const invert = (object) => {
+    const result = {};
+    for (const key of Object.keys(object)) {
+        const value = object[key];
+        result[value] = key;
+    }
+    return result;
+};
+//# sourceMappingURL=invert.js.map

package/module/Object/invert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invert.js","sourceRoot":"","sources":["../../src/Object/invert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,MAAoB,EACN,EAAE;IAChB,MAAM,MAAM,GAAG,EAAkB,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAQ,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/module/Object/mergeDeep.js.map

@@ -1 +1 @@
-{"version":3,"file":"mergeDeep.js","sourceRoot":"","sources":["../../src/Object/mergeDeep.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,0EAA0E;AAC1E,yEAAyE;AACzE,oEAAoE;AACpE,uEAAuE;AACvE,MAAM,iBAAiB,GAAG,CAIxB,MAAS,EACT,OAAU,EACV,KAAa,EACb,WAAW,GAAG,CAAC,EACqB,EAAE;IACtC,IAAI,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,MAA4C,CAAC;IACtD,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpC,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;QAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAE/B,MAAkC,CAAC,GAAG,CAAC;oBACtC,aAAa,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC;wBACtD,CAAC,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC,WAAW,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;wBAC1D,CAAC,CAAC,WAAW,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,iBAAiB,CACtB,MAAM,EACN,OAAuB,EACvB,KAAK,GAAG,CAAC,EACT,WAAW,GAAG,CAAC,CACsB,CAAC;IAC1C,CAAC;IAED,OAAO,iBAAiB,CACtB,MAAW,EACX,OAAuB,EACvB,KAAK,GAAG,CAAC,EACT,WAAW,GAAG,CAAC,CACsB,CAAC;AAC1C,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAIvB,MAAS,EACT,GAAG,OAAU,EACuB,EAAE;IACtC,OAAO,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC"}
+{"version":3,"file":"mergeDeep.js","sourceRoot":"","sources":["../../src/Object/mergeDeep.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,0EAA0E;AAC1E,yEAAyE;AACzE,oEAAoE;AACpE,uEAAuE;AACvE,MAAM,iBAAiB,GAAG,CAIxB,MAAS,EACT,OAAU,EACV,KAAa,EACb,WAAW,GAAG,CAAC,EACqB,EAAE;IACtC,IAAI,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,MAA4C,CAAC;IACtD,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpC,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;QAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAE/B,MAAkC,CAAC,GAAG,CAAC;oBACtC,aAAa,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC;wBACtD,CAAC,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC,WAAW,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;wBAC1D,CAAC,CAAC,WAAW,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,iBAAiB,CAAC,MAAW,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC;AAC7E,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAIvB,MAAS,EACT,GAAG,OAAU,EACuB,EAAE;IACtC,OAAO,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC"}

package/module/Object/omitBy.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Creates a new object containing only entries for which the predicate returns false.
+ *
+ * @template T - Type of the source object
+ * @param {T} object - Source object
+ * @param {(value: T[keyof T], key: keyof T) => boolean} predicate - Rejection predicate
+ * @returns {Partial<T>} A new object with the remaining entries
+ * @example
+ * omitBy({ a: 1, b: undefined, c: 3 }, (v) => v === undefined); // { a: 1, c: 3 }
+ */
+export declare const omitBy: <T extends Record<string, unknown>>(object: T, predicate: (value: T[keyof T], key: keyof T) => boolean) => Partial<T>;

package/module/Object/omitBy.js

@@ -0,0 +1,21 @@
+/**
+ * Creates a new object containing only entries for which the predicate returns false.
+ *
+ * @template T - Type of the source object
+ * @param {T} object - Source object
+ * @param {(value: T[keyof T], key: keyof T) => boolean} predicate - Rejection predicate
+ * @returns {Partial<T>} A new object with the remaining entries
+ * @example
+ * omitBy({ a: 1, b: undefined, c: 3 }, (v) => v === undefined); // { a: 1, c: 3 }
+ */
+export const omitBy = (object, predicate) => {
+    const result = {};
+    for (const key of Object.keys(object)) {
+        const value = object[key];
+        if (!predicate(value, key)) {
+            result[key] = value;
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=omitBy.js.map

package/module/Object/omitBy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omitBy.js","sourceRoot":"","sources":["../../src/Object/omitBy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,MAAS,EACT,SAAuD,EAC3C,EAAE;IACd,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAgB,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/module/Object/pathSegments.d.ts

@@ -0,0 +1 @@
+export declare const pathSegments: (path: string | string[]) => string[];

package/module/Object/pathSegments.js

@@ -0,0 +1,2 @@
+export const pathSegments = (path) => typeof path === "string" ? path.split(".") : path;
+//# sourceMappingURL=pathSegments.js.map

package/module/Object/pathSegments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathSegments.js","sourceRoot":"","sources":["../../src/Object/pathSegments.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAuB,EAAY,EAAE,CAChE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC"}

package/module/Object/pickBy.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Creates a new object containing only entries for which the predicate returns true.
+ *
+ * @template T - Type of the source object
+ * @param {T} object - Source object
+ * @param {(value: T[keyof T], key: keyof T) => boolean} predicate - Selector predicate
+ * @returns {Partial<T>} A new object with the filtered entries
+ * @example
+ * pickBy({ a: 1, b: 2, c: 3 }, (v) => v > 1); // { b: 2, c: 3 }
+ */
+export declare const pickBy: <T extends Record<string, unknown>>(object: T, predicate: (value: T[keyof T], key: keyof T) => boolean) => Partial<T>;

package/module/Object/pickBy.js

@@ -0,0 +1,21 @@
+/**
+ * Creates a new object containing only entries for which the predicate returns true.
+ *
+ * @template T - Type of the source object
+ * @param {T} object - Source object
+ * @param {(value: T[keyof T], key: keyof T) => boolean} predicate - Selector predicate
+ * @returns {Partial<T>} A new object with the filtered entries
+ * @example
+ * pickBy({ a: 1, b: 2, c: 3 }, (v) => v > 1); // { b: 2, c: 3 }
+ */
+export const pickBy = (object, predicate) => {
+    const result = {};
+    for (const key of Object.keys(object)) {
+        const value = object[key];
+        if (predicate(value, key)) {
+            result[key] = value;
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=pickBy.js.map

package/module/Object/pickBy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickBy.js","sourceRoot":"","sources":["../../src/Object/pickBy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,MAAS,EACT,SAAuD,EAC3C,EAAE;IACd,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAgB,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/module/Object/set.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Sets a value at a deeply nested path on an object, mutating it.
+ * Creates intermediate objects as needed.
+ *
+ * @template T - Type of the source object
+ * @param {T} object - Target object (mutated)
+ * @param {string | string[]} path - Dot-separated string or path segments array
+ * @param {unknown} value - Value to assign at the path
+ * @returns {T} The same object reference, for chaining
+ *
+ * @remarks
+ * **Prototype pollution warning:** This function does not filter out
+ * prototype-polluting keys (`__proto__`, `constructor`, `prototype`).
+ * Sanitize user-controlled paths before calling.
+ *
+ * @example
+ * set({}, "a.b.c", 1); // { a: { b: { c: 1 } } }
+ */
+export declare const set: <T extends object>(object: T, path: string | string[], value: unknown) => T;

package/module/Object/set.js

@@ -0,0 +1,38 @@
+import { pathSegments } from "./pathSegments";
+/**
+ * Sets a value at a deeply nested path on an object, mutating it.
+ * Creates intermediate objects as needed.
+ *
+ * @template T - Type of the source object
+ * @param {T} object - Target object (mutated)
+ * @param {string | string[]} path - Dot-separated string or path segments array
+ * @param {unknown} value - Value to assign at the path
+ * @returns {T} The same object reference, for chaining
+ *
+ * @remarks
+ * **Prototype pollution warning:** This function does not filter out
+ * prototype-polluting keys (`__proto__`, `constructor`, `prototype`).
+ * Sanitize user-controlled paths before calling.
+ *
+ * @example
+ * set({}, "a.b.c", 1); // { a: { b: { c: 1 } } }
+ */
+export const set = (object, path, value) => {
+    const segments = pathSegments(path);
+    if (segments.length === 0) {
+        return object;
+    }
+    let current = object;
+    for (let index = 0; index < segments.length - 1; index += 1) {
+        const key = segments[index];
+        const next = current[key];
+        if (next == null || typeof next !== "object") {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    const lastIndex = segments.length - 1;
+    current[segments[lastIndex]] = value;
+    return object;
+};
+//# sourceMappingURL=set.js.map

package/module/Object/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../src/Object/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,MAAS,EACT,IAAuB,EACvB,KAAc,EACX,EAAE;IACL,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,GAA4B,MAAiC,CAAC;IACzE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5D,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAA4B,CAAC;IACpD,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/module/Object/unflattenObject.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Reconstructs a nested object from a flat path-keyed object.
+ *
+ * @param {Record<string, unknown>} flat - Flat input keyed by joined paths
+ * @param {string} [separator="."] - Separator used in path keys
+ * @returns {Record<string, unknown>} A nested object
+ *
+ * @remarks
+ * **Prototype pollution warning:** Internally uses `set`, which does not
+ * filter out prototype-polluting keys. Sanitize user-controlled keys.
+ *
+ * @example
+ * unflattenObject({ "a.b.c": 1, d: 2 }); // { a: { b: { c: 1 } }, d: 2 }
+ */
+export declare const unflattenObject: (flat: Record<string, unknown>, separator?: string) => Record<string, unknown>;

package/module/Object/unflattenObject.js

@@ -0,0 +1,23 @@
+import { set } from "./set";
+/**
+ * Reconstructs a nested object from a flat path-keyed object.
+ *
+ * @param {Record<string, unknown>} flat - Flat input keyed by joined paths
+ * @param {string} [separator="."] - Separator used in path keys
+ * @returns {Record<string, unknown>} A nested object
+ *
+ * @remarks
+ * **Prototype pollution warning:** Internally uses `set`, which does not
+ * filter out prototype-polluting keys. Sanitize user-controlled keys.
+ *
+ * @example
+ * unflattenObject({ "a.b.c": 1, d: 2 }); // { a: { b: { c: 1 } }, d: 2 }
+ */
+export const unflattenObject = (flat, separator = ".") => {
+    const result = {};
+    for (const key of Object.keys(flat)) {
+        set(result, key.split(separator), flat[key]);
+    }
+    return result;
+};
+//# sourceMappingURL=unflattenObject.js.map

package/module/Object/unflattenObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unflattenObject.js","sourceRoot":"","sources":["../../src/Object/unflattenObject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,IAA6B,EAC7B,SAAS,GAAG,GAAG,EACU,EAAE;IAC3B,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/module/Random/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./randomBoolean";
+export * from "./randomChoice";
+export * from "./randomFloat";
+export * from "./randomInt";
+export * from "./randomUuid";
+export * from "./seededRandom";
+export * from "./weightedChoice";

package/module/Random/index.js

@@ -0,0 +1,8 @@
+export * from "./randomBoolean";
+export * from "./randomChoice";
+export * from "./randomFloat";
+export * from "./randomInt";
+export * from "./randomUuid";
+export * from "./seededRandom";
+export * from "./weightedChoice";
+//# sourceMappingURL=index.js.map

package/module/Random/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Random/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

package/module/Random/randomBoolean.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns a random boolean. The probability of `true` defaults to 0.5.
+ * @param {number} [probability=0.5] - Probability of returning true (0..1)
+ * @returns {boolean} Random boolean
+ * @example
+ * randomBoolean(); // true or false equally
+ * randomBoolean(0.9); // true ~90% of the time
+ */
+export declare const randomBoolean: (probability?: number) => boolean;

package/module/Random/randomBoolean.js

@@ -0,0 +1,10 @@
+/**
+ * Returns a random boolean. The probability of `true` defaults to 0.5.
+ * @param {number} [probability=0.5] - Probability of returning true (0..1)
+ * @returns {boolean} Random boolean
+ * @example
+ * randomBoolean(); // true or false equally
+ * randomBoolean(0.9); // true ~90% of the time
+ */
+export const randomBoolean = (probability = 0.5) => Math.random() < probability;
+//# sourceMappingURL=randomBoolean.js.map

package/module/Random/randomBoolean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomBoolean.js","sourceRoot":"","sources":["../../src/Random/randomBoolean.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,WAAW,GAAG,GAAG,EAAW,EAAE,CAC1D,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC"}

package/module/Random/randomChoice.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns a uniformly random element from the input array.
+ * @template T - Element type
+ * @param {readonly T[]} items - Source array (must be non-empty)
+ * @returns {T} A randomly selected element
+ * @example
+ * randomChoice(["a", "b", "c"]);
+ */
+export declare const randomChoice: <T>(items: readonly T[]) => T;

package/module/Random/randomChoice.js

@@ -0,0 +1,13 @@
+/**
+ * Returns a uniformly random element from the input array.
+ * @template T - Element type
+ * @param {readonly T[]} items - Source array (must be non-empty)
+ * @returns {T} A randomly selected element
+ * @example
+ * randomChoice(["a", "b", "c"]);
+ */
+export const randomChoice = (items) => {
+    const index = Math.floor(Math.random() * items.length);
+    return items[index];
+};
+//# sourceMappingURL=randomChoice.js.map

package/module/Random/randomChoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomChoice.js","sourceRoot":"","sources":["../../src/Random/randomChoice.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAI,KAAmB,EAAK,EAAE;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;AACtB,CAAC,CAAC"}

package/module/Random/randomFloat.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns a random float in the half-open interval `[min, max)`.
+ * @param {number} min - Inclusive lower bound
+ * @param {number} max - Exclusive upper bound
+ * @returns {number} Random float
+ * @example
+ * randomFloat(0, 1); // 0.000... up to but not including 1
+ */
+export declare const randomFloat: (min: number, max: number) => number;

package/module/Random/randomFloat.js

@@ -0,0 +1,10 @@
+/**
+ * Returns a random float in the half-open interval `[min, max)`.
+ * @param {number} min - Inclusive lower bound
+ * @param {number} max - Exclusive upper bound
+ * @returns {number} Random float
+ * @example
+ * randomFloat(0, 1); // 0.000... up to but not including 1
+ */
+export const randomFloat = (min, max) => Math.random() * (max - min) + min;
+//# sourceMappingURL=randomFloat.js.map

package/module/Random/randomFloat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomFloat.js","sourceRoot":"","sources":["../../src/Random/randomFloat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,GAAW,EAAU,EAAE,CAC9D,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC"}

package/module/Random/randomInt.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns a random integer in the closed interval `[min, max]`.
+ * @param {number} min - Inclusive lower bound
+ * @param {number} max - Inclusive upper bound
+ * @returns {number} Random integer
+ * @example
+ * randomInt(1, 6); // 1, 2, 3, 4, 5, or 6
+ */
+export declare const randomInt: (min: number, max: number) => number;

package/module/Random/randomInt.js

@@ -0,0 +1,14 @@
+/**
+ * Returns a random integer in the closed interval `[min, max]`.
+ * @param {number} min - Inclusive lower bound
+ * @param {number} max - Inclusive upper bound
+ * @returns {number} Random integer
+ * @example
+ * randomInt(1, 6); // 1, 2, 3, 4, 5, or 6
+ */
+export const randomInt = (min, max) => {
+    const lo = Math.ceil(min);
+    const hi = Math.floor(max);
+    return Math.floor(Math.random() * (hi - lo + 1)) + lo;
+};
+//# sourceMappingURL=randomInt.js.map

package/module/Random/randomInt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomInt.js","sourceRoot":"","sources":["../../src/Random/randomInt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,GAAW,EAAU,EAAE;IAC5D,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACxD,CAAC,CAAC"}

package/module/Random/randomUuid.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generates a UUID v4 string. Uses `crypto.randomUUID` when available,
+ * otherwise falls back to `crypto.getRandomValues`.
+ *
+ * @returns {string} A UUID v4 in canonical 8-4-4-4-12 hex form
+ * @example
+ * randomUUID(); // e.g. "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed"
+ */
+export declare const randomUUID: () => string;

package/module/Random/randomUuid.js

@@ -0,0 +1,31 @@
+const DIGITS = "0123456789abcdef";
+const bytesToUuid = (bytes) => {
+    let result = "";
+    for (let index = 0; index < 16; index += 1) {
+        if (index === 4 || index === 6 || index === 8 || index === 10) {
+            result += "-";
+        }
+        const byte = bytes[index];
+        result += DIGITS[byte >>> 4] + DIGITS[byte & 0xf];
+    }
+    return result;
+};
+/**
+ * Generates a UUID v4 string. Uses `crypto.randomUUID` when available,
+ * otherwise falls back to `crypto.getRandomValues`.
+ *
+ * @returns {string} A UUID v4 in canonical 8-4-4-4-12 hex form
+ * @example
+ * randomUUID(); // e.g. "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed"
+ */
+export const randomUUID = () => {
+    if (typeof globalThis.crypto?.randomUUID === "function") {
+        return globalThis.crypto.randomUUID();
+    }
+    const bytes = new Uint8Array(16);
+    globalThis.crypto.getRandomValues(bytes);
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    return bytesToUuid(bytes);
+};
+//# sourceMappingURL=randomUuid.js.map

package/module/Random/randomUuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomUuid.js","sourceRoot":"","sources":["../../src/Random/randomUuid.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,kBAAkB,CAAC;AAElC,MAAM,WAAW,GAAG,CAAC,KAAiB,EAAU,EAAE;IAChD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC9D,MAAM,IAAI,GAAG,CAAC;QAChB,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAW,EAAE;IACrC,IAAI,OAAO,UAAU,CAAC,MAAM,EAAE,UAAU,KAAK,UAAU,EAAE,CAAC;QACxD,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACzC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC,CAAC"}

package/module/Random/seededRandom.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Returns a deterministic PRNG seeded from a number or string. Each call
+ * produces a float in `[0, 1)` from the same xoshiro256** stream.
+ *
+ * @param {number | string} seed - Seed value
+ * @returns {() => number} A function that returns sequential pseudo-random floats
+ * @example
+ * const rand = seededRandom("hello");
+ * rand(); // deterministic for the same seed
+ */
+export declare const seededRandom: (seed: number | string) => (() => number);

package/module/Random/seededRandom.js

@@ -0,0 +1,31 @@
+import { xoshiro256 } from "../Math/xoshiro256";
+const TEXT_ENCODER = new TextEncoder();
+const hashStringToSeed = (input) => {
+    let hash = 2_166_136_261;
+    for (const byte of TEXT_ENCODER.encode(input)) {
+        hash ^= byte;
+        hash = Math.imul(hash, 16_777_619);
+    }
+    return hash >>> 0;
+};
+/**
+ * Returns a deterministic PRNG seeded from a number or string. Each call
+ * produces a float in `[0, 1)` from the same xoshiro256** stream.
+ *
+ * @param {number | string} seed - Seed value
+ * @returns {() => number} A function that returns sequential pseudo-random floats
+ * @example
+ * const rand = seededRandom("hello");
+ * rand(); // deterministic for the same seed
+ */
+export const seededRandom = (seed) => {
+    const initial = typeof seed === "number" ? seed >>> 0 : hashStringToSeed(seed);
+    const state = [
+        initial || 1,
+        Math.imul(initial, 0x9e_37_79_b9) >>> 0 || 2,
+        Math.imul(initial, 0x85_eb_ca_6b) >>> 0 || 3,
+        Math.imul(initial, 0xc2_b2_ae_35) >>> 0 || 4,
+    ];
+    return () => xoshiro256(state);
+};
+//# sourceMappingURL=seededRandom.js.map

package/module/Random/seededRandom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seededRandom.js","sourceRoot":"","sources":["../../src/Random/seededRandom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC;AAEvC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE;IACjD,IAAI,IAAI,GAAG,aAAa,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,IAAI,IAAI,IAAI,CAAC;QACb,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAqB,EAAkB,EAAE;IACpE,MAAM,OAAO,GACX,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,KAAK,GAAqC;QAC9C,OAAO,IAAI,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;KAC7C,CAAC;IACF,OAAO,GAAW,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC,CAAC"}

package/module/Random/weightedChoice.d.ts

@@ -0,0 +1,15 @@
+export interface WeightedItem<T> {
+    value: T;
+    weight: number;
+}
+/**
+ * Returns a random element using cumulative weights and binary search.
+ * Items with non-positive weights are skipped from the pool.
+ *
+ * @template T - Element type
+ * @param {readonly WeightedItem<T>[]} items - Items with non-negative weights
+ * @returns {T} A randomly selected element
+ * @example
+ * weightedChoice([{ value: "a", weight: 1 }, { value: "b", weight: 4 }]);
+ */
+export declare const weightedChoice: <T>(items: readonly WeightedItem<T>[]) => T;

package/module/Random/weightedChoice.js

@@ -0,0 +1,34 @@
+/**
+ * Returns a random element using cumulative weights and binary search.
+ * Items with non-positive weights are skipped from the pool.
+ *
+ * @template T - Element type
+ * @param {readonly WeightedItem<T>[]} items - Items with non-negative weights
+ * @returns {T} A randomly selected element
+ * @example
+ * weightedChoice([{ value: "a", weight: 1 }, { value: "b", weight: 4 }]);
+ */
+export const weightedChoice = (items) => {
+    const cumulative = [];
+    let total = 0;
+    for (const item of items) {
+        if (item.weight > 0) {
+            total += item.weight;
+        }
+        cumulative.push(total);
+    }
+    const target = Math.random() * total;
+    let lo = 0;
+    let hi = cumulative.length - 1;
+    while (lo < hi) {
+        const mid = (lo + hi) >>> 1;
+        if (cumulative[mid] <= target) {
+            lo = mid + 1;
+        }
+        else {
+            hi = mid;
+        }
+    }
+    return items[lo].value;
+};
+//# sourceMappingURL=weightedChoice.js.map

package/module/Random/weightedChoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weightedChoice.js","sourceRoot":"","sources":["../../src/Random/weightedChoice.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAI,KAAiC,EAAK,EAAE;IACxE,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC;IACrC,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/B,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;YAC9B,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,GAAG,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;AACzB,CAAC,CAAC"}

package/module/String/capitalize.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Capitalizes the first grapheme of a string. Surrogate-pair safe.
+ * Does not lowercase the rest of the string.
+ *
+ * @param {string} string_ - Input string
+ * @returns {string} String with the first grapheme uppercased
+ * @example
+ * capitalize("hello"); // "Hello"
+ * capitalize("éclair"); // "Éclair"
+ * capitalize(""); // ""
+ */
+export declare const capitalize: (string_: string) => string;

package/module/String/capitalize.js

@@ -0,0 +1,18 @@
+/**
+ * Capitalizes the first grapheme of a string. Surrogate-pair safe.
+ * Does not lowercase the rest of the string.
+ *
+ * @param {string} string_ - Input string
+ * @returns {string} String with the first grapheme uppercased
+ * @example
+ * capitalize("hello"); // "Hello"
+ * capitalize("éclair"); // "Éclair"
+ * capitalize(""); // ""
+ */
+export const capitalize = (string_) => {
+    for (const first of string_) {
+        return first.toUpperCase() + string_.slice(first.length);
+    }
+    return string_;
+};
+//# sourceMappingURL=capitalize.js.map

package/module/String/capitalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.js","sourceRoot":"","sources":["../../src/String/capitalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAU,EAAE;IACpD,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/capitalizeWord.d.ts

@@ -0,0 +1 @@
+export declare const capitalizeWord: (word: string) => string;

package/module/String/capitalizeWord.js

@@ -0,0 +1,2 @@
+export const capitalizeWord = (word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+//# sourceMappingURL=capitalizeWord.js.map

package/module/String/capitalizeWord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalizeWord.js","sourceRoot":"","sources":["../../src/String/capitalizeWord.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAU,EAAE,CACrD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC"}