umt 2.5.0 → 2.7.0

package/module/es5/types/index.d.ts

@@ -7,5 +7,6 @@ export * from "./joke";
 export * from "./logic";
 export * from "./math";
 export * from "./object";
+export * from "./string";
 export * from "./time";
 export * from "./ua";

package/module/es5/types/index.js

@@ -102,6 +102,17 @@ Object.keys(_object).forEach(function (key) {
     }
   });
 });
+var _string = require("./string");
+Object.keys(_string).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _string[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _string[key];
+    }
+  });
+});
 var _time = require("./time");
 Object.keys(_time).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/module/es5/types/logic/deepPartial.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Recursively makes all properties in T optional, including nested objects.
+ * Unlike TypeScript's built-in Partial<T> which only affects top-level properties,
+ * DeepPartial<T> applies the optional modifier to all levels of nested objects.
+ *
+ * @template T - The type to make deeply partial
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id: number;
+ *   profile: {
+ *     name: string;
+ *     address: {
+ *       street: string;
+ *       city: string;
+ *     };
+ *   };
+ * }
+ *
+ * type PartialUser = DeepPartial<User>;
+ * // Result:
+ * // {
+ * //   id?: number;
+ * //   profile?: {
+ * //     name?: string;
+ * //     address?: {
+ * //       street?: string;
+ * //       city?: string;
+ * //     };
+ * //   };
+ * // }
+ * ```
+ */
+export type DeepPartial<T> = T extends Record<PropertyKey, any> ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;

package/module/es5/types/logic/deepPartial.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/module/es5/types/logic/deepRequired.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Recursively makes all properties in T required, including nested objects.
+ * Unlike TypeScript's built-in Required<T> which only affects top-level properties,
+ * DeepRequired<T> removes the optional modifier from all levels of nested objects.
+ *
+ * @template T - The type to make deeply required
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id?: number;
+ *   profile?: {
+ *     name?: string;
+ *     address?: {
+ *       street?: string;
+ *       city?: string;
+ *     };
+ *   };
+ * }
+ *
+ * type RequiredUser = DeepRequired<User>;
+ * // Result:
+ * // {
+ * //   id: number;
+ * //   profile: {
+ * //     name: string;
+ * //     address: {
+ * //       street: string;
+ * //       city: string;
+ * //     };
+ * //   };
+ * // }
+ * ```
+ */
+export type DeepRequired<T> = T extends Record<PropertyKey, any> ? {
+    [P in keyof T]-?: DeepRequired<T[P]>;
+} : T;

package/module/es5/types/logic/deepRequired.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/module/es5/types/logic/index.d.ts

@@ -27,6 +27,8 @@ export * from "./capitalize";
 export * from "./decimal1byteTobinary";
 export * from "./decimal4bitTobinary";
 export * from "./decimal4bitToHex";
+export * from "./deepPartial";
+export * from "./deepRequired";
 export * from "./equal";
 export * from "./first";
 export * from "./first8Chars";
@@ -53,6 +55,7 @@ export * from "./stringReverse";
 export * from "./stringToArray";
 export * from "./stringToUnion";
 export * from "./toNumber";
+export * from "./unionToIntersection";
 export * from "./xnor";
 export * from "./xor";
 export * from "./zeroAorB";

package/module/es5/types/logic/index.js

@@ -322,6 +322,28 @@ Object.keys(_decimal4bitToHex).forEach(function (key) {
     }
   });
 });
+var _deepPartial = require("./deepPartial");
+Object.keys(_deepPartial).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _deepPartial[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _deepPartial[key];
+    }
+  });
+});
+var _deepRequired = require("./deepRequired");
+Object.keys(_deepRequired).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _deepRequired[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _deepRequired[key];
+    }
+  });
+});
 var _equal = require("./equal");
 Object.keys(_equal).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -608,6 +630,17 @@ Object.keys(_toNumber).forEach(function (key) {
     }
   });
 });
+var _unionToIntersection = require("./unionToIntersection");
+Object.keys(_unionToIntersection).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _unionToIntersection[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _unionToIntersection[key];
+    }
+  });
+});
 var _xnor = require("./xnor");
 Object.keys(_xnor).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/module/es5/types/logic/unionToIntersection.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Converts a union type to an intersection type
+ *
+ * @example
+ * ```typescript
+ * type A = { a: string }
+ * type B = { b: number }
+ * type Union = A | B
+ * type Intersection = UnionToIntersection<Union> // { a: string } & { b: number }
+ * ```
+ */
+export type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;

package/module/es5/types/logic/unionToIntersection.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/module/es5/types/object/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./pickDeep";
 export * from "./pickDeepKey";
+export * from "./shallowObjectValue";

package/module/es5/types/object/index.js

@@ -24,4 +24,15 @@ Object.keys(_pickDeepKey).forEach(function (key) {
       return _pickDeepKey[key];
     }
   });
+});
+var _shallowObjectValue = require("./shallowObjectValue");
+Object.keys(_shallowObjectValue).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _shallowObjectValue[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _shallowObjectValue[key];
+    }
+  });
 });

package/module/es5/types/object/pickDeep.d.ts

@@ -1 +1,13 @@
-export type PickDeep<T extends object> = keyof T extends infer K ? K extends keyof T ? T[K] extends object ? PickDeep<T[K]> : T[K] : never : never;
+import type { PickDeepKey } from "./pickDeepKey";
+import type { UnionToIntersection } from "$/logic/unionToIntersection";
+type GetValueAtPath<T, P extends string> = P extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? T[Key] extends object ? GetValueAtPath<T[Key], Rest> : never : never : P extends keyof T ? T[P] : never;
+type ConstructNestedObject<P extends string, V> = P extends `${infer Key}.${infer Rest}` ? {
+    [K in Key]: ConstructNestedObject<Rest, V>;
+} : {
+    [K in P]: V;
+};
+type ProcessKeys<T extends object, K extends readonly PickDeepKey<T>[]> = {
+    [I in keyof K]: K[I] extends string ? ConstructNestedObject<K[I], GetValueAtPath<T, K[I]>> : never;
+}[number];
+export type PickDeep<T extends object, K extends readonly PickDeepKey<T>[]> = UnionToIntersection<ProcessKeys<T, K>>;
+export {};

package/module/es5/types/object/shallowObjectValue.d.ts

@@ -0,0 +1,9 @@
+import type { UnionToIntersection } from "$/logic/unionToIntersection";
+/**
+ * Extract the value type from the first level of an object
+ *
+ * @example
+ * type Input = { a: { b: { c: {} } } }
+ * type Output = ShallowObjectValue<Input> // { b: { c: {} } }
+ */
+export type ShallowObjectValue<T> = T extends Record<PropertyKey, infer U> ? UnionToIntersection<U> : never;

package/module/es5/types/object/shallowObjectValue.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/module/es5/types/string/formatString/formatData.d.ts

@@ -0,0 +1,17 @@
+import type { FormatValue } from "./formatValue";
+/**
+ * Data structure for formatString input.
+ *
+ * Can be either an object for named placeholders or an array for indexed placeholders.
+ *
+ * @example
+ * // Object for named placeholders
+ * const namedData: FormatData = { name: "Alice", age: 25 };
+ * formatString("Hello {name}, age {age}", namedData);
+ *
+ * @example
+ * // Array for indexed placeholders
+ * const indexedData: FormatData = ["Alice", 25];
+ * formatString("Hello {0}, age {1}", ...indexedData);
+ */
+export type FormatData = Record<string, unknown> | FormatValue[];

package/module/es5/types/string/formatString/formatData.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/module/es5/types/string/formatString/formatOptions.d.ts

@@ -0,0 +1,21 @@
+import type { Formatter } from "./formatter";
+/**
+ * Configuration options for formatString.
+ *
+ * @property formatters - Custom formatter functions to extend or override built-in formatters
+ * @property locale - Default locale for built-in formatters (currently unused but reserved)
+ *
+ * @example
+ * const options: FormatOptions = {
+ *   formatters: {
+ *     reverse: (value) => String(value).split('').reverse().join(''),
+ *     shout: (value) => `${String(value).toUpperCase()}!`
+ *   }
+ * };
+ * formatString("{text:reverse} {text:shout}", { text: "hello" }, options);
+ * // → "olleh HELLO!"
+ */
+export interface FormatOptions {
+    formatters?: Record<string, Formatter>;
+    locale?: string;
+}

package/module/es5/types/string/formatString/formatOptions.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/module/es5/types/string/formatString/formatString.d.ts

@@ -0,0 +1,4 @@
+export * from "./formatData";
+export * from "./formatOptions";
+export * from "./formatter";
+export * from "./formatValue";

package/module/es5/types/string/formatString/formatString.js

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _formatData = require("./formatData");
+Object.keys(_formatData).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formatData[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _formatData[key];
+    }
+  });
+});
+var _formatOptions = require("./formatOptions");
+Object.keys(_formatOptions).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formatOptions[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _formatOptions[key];
+    }
+  });
+});
+var _formatter = require("./formatter");
+Object.keys(_formatter).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formatter[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _formatter[key];
+    }
+  });
+});
+var _formatValue = require("./formatValue");
+Object.keys(_formatValue).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formatValue[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _formatValue[key];
+    }
+  });
+});

package/module/es5/types/string/formatString/formatValue.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Valid value types that can be passed to formatString.
+ *
+ * Includes primitives, objects, arrays, and null/undefined values.
+ * Objects and arrays are typically used in indexed mode as placeholder values.
+ *
+ * @example
+ * // Primitive values
+ * formatString("{0} {1}", "hello", 42) // string, number
+ *
+ * @example
+ * // Complex values
+ * formatString("{0} {1}", { key: "value" }, [1, 2, 3]) // object, array
+ */
+export type FormatValue = string | number | boolean | Date | null | undefined | Record<string, unknown> | unknown[];

package/module/es5/types/string/formatString/formatValue.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/module/es5/types/string/formatString/formatter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Function type for formatString formatter functions.
+ *
+ * @param value - The value to be formatted
+ * @param arguments_ - Additional string arguments passed to the formatter
+ * @returns Formatted string representation of the value
+ *
+ * @example
+ * const upperFormatter: Formatter = (value) => String(value).toUpperCase();
+ * const padFormatter: Formatter = (value, length = "2", char = "0") =>
+ *   String(value).padStart(Number(length), char);
+ */
+export type Formatter = (value: unknown, ...arguments_: string[]) => string;

package/module/es5/types/string/formatString/formatter.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/module/es5/types/string/formatString/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./formatData";
+export * from "./formatValue";
+export * from "./formatter";
+export * from "./formatString";
+export * from "./formatOptions";

package/module/es5/types/string/formatString/index.js

@@ -0,0 +1,60 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _formatData = require("./formatData");
+Object.keys(_formatData).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formatData[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _formatData[key];
+    }
+  });
+});
+var _formatValue = require("./formatValue");
+Object.keys(_formatValue).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formatValue[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _formatValue[key];
+    }
+  });
+});
+var _formatter = require("./formatter");
+Object.keys(_formatter).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formatter[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _formatter[key];
+    }
+  });
+});
+var _formatString = require("./formatString");
+Object.keys(_formatString).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formatString[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _formatString[key];
+    }
+  });
+});
+var _formatOptions = require("./formatOptions");
+Object.keys(_formatOptions).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formatOptions[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _formatOptions[key];
+    }
+  });
+});

package/module/es5/types/string/index.d.ts

@@ -0,0 +1 @@
+export * from "./formatString";

package/module/es5/types/string/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _formatString = require("./formatString");
+Object.keys(_formatString).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formatString[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _formatString[key];
+    }
+  });
+});

package/module/index.d.ts

@@ -2,6 +2,8 @@ export * from "./Advance";
 export * from "./Array";
 export * from "./Color";
 export * from "./Consts";
+export * from "./Crypto";
+export * from "./DataStructure";
 export * from "./Date";
 export * from "./Error";
 export * from "./Function";

package/module/index.js

@@ -2,6 +2,8 @@ export * from "./Advance";
 export * from "./Array";
 export * from "./Color";
 export * from "./Consts";
+export * from "./Crypto";
+export * from "./DataStructure";
 export * from "./Date";
 export * from "./Error";
 export * from "./Function";

package/module/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,MAAM,CAAC;AACrB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC;AACrB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,MAAM,CAAC;AACrB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC;AACrB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}

package/module/types/index.d.ts

@@ -7,5 +7,6 @@ export * from "./joke";
 export * from "./logic";
 export * from "./math";
 export * from "./object";
+export * from "./string";
 export * from "./time";
 export * from "./ua";

package/module/types/index.js

@@ -7,6 +7,7 @@ export * from "./joke";
 export * from "./logic";
 export * from "./math";
 export * from "./object";
+export * from "./string";
 export * from "./time";
 export * from "./ua";
 //# sourceMappingURL=index.js.map

package/module/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC"}

package/module/types/logic/deepPartial.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Recursively makes all properties in T optional, including nested objects.
+ * Unlike TypeScript's built-in Partial<T> which only affects top-level properties,
+ * DeepPartial<T> applies the optional modifier to all levels of nested objects.
+ *
+ * @template T - The type to make deeply partial
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id: number;
+ *   profile: {
+ *     name: string;
+ *     address: {
+ *       street: string;
+ *       city: string;
+ *     };
+ *   };
+ * }
+ *
+ * type PartialUser = DeepPartial<User>;
+ * // Result:
+ * // {
+ * //   id?: number;
+ * //   profile?: {
+ * //     name?: string;
+ * //     address?: {
+ * //       street?: string;
+ * //       city?: string;
+ * //     };
+ * //   };
+ * // }
+ * ```
+ */
+export type DeepPartial<T> = T extends Record<PropertyKey, any> ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;

package/module/types/logic/deepPartial.js

@@ -0,0 +1,36 @@
+/**
+ * Recursively makes all properties in T optional, including nested objects.
+ * Unlike TypeScript's built-in Partial<T> which only affects top-level properties,
+ * DeepPartial<T> applies the optional modifier to all levels of nested objects.
+ *
+ * @template T - The type to make deeply partial
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id: number;
+ *   profile: {
+ *     name: string;
+ *     address: {
+ *       street: string;
+ *       city: string;
+ *     };
+ *   };
+ * }
+ *
+ * type PartialUser = DeepPartial<User>;
+ * // Result:
+ * // {
+ * //   id?: number;
+ * //   profile?: {
+ * //     name?: string;
+ * //     address?: {
+ * //       street?: string;
+ * //       city?: string;
+ * //     };
+ * //   };
+ * // }
+ * ```
+ */
+export {};
+//# sourceMappingURL=deepPartial.js.map

package/module/types/logic/deepPartial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepPartial.js","sourceRoot":"","sources":["../../../src/types/logic/deepPartial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG"}