umt 2.1.1 → 2.2.0

package/module/Object/pickDeep.js

@@ -1,17 +1,17 @@
 /**
- * オブジェクトから指定されたキーに基づいて深くプロパティを選択し、新しいオブジェクトを作成します。
+ * Creates a new object by deeply selecting properties from the source object based on specified keys.
  *
- * @template T - 元のオブジェクトの型。
- * @template K - 選択するプロパティキーの型。PickDeepKey<T>のサブセット。
- * @param {T} object - プロパティを抽出する元のオブジェクト。
- * @param {...K[]} keys - 抽出したいプロパティのキー。ネストされたキーをドットで区切ることができます。
- * @returns {PickDeep<T>} 指定されたキーを持つプロパティのみを含む新しいオブジェクト。
+ * @template T - Type of the source object.
+ * @template K - Type of property keys to select. Must be a subset of PickDeepKey<T>.
+ * @param {T} object - The source object to extract properties from.
+ * @param {...K[]} keys - Property keys to extract. Can use dot notation for nested properties.
+ * @returns {PickDeep<T>} A new object containing only the specified properties.
  *
  * @example
  * ```typescript
  * const obj = { a: { b: { c: 1, d: 2 }, e: 3 }, f: 4 };
  * const picked = pickDeep(obj, 'a.b.c', 'f');
- * // picked は { a: { b: { c: 1 } }, f: 4 } となる
+ * // picked will be { a: { b: { c: 1 } }, f: 4 }
  * ```
  */
 export const pickDeep = (object, ...keys) => {

package/module/Simple/Array/quickSortSimple.d.ts

@@ -1,10 +1,12 @@
+import type { CompareFunction } from "../../types/array/compareFunction";
 /**
- * 配列を高速にソート
- * @param {T[]} array 配列
- * @param {(a: T, b: T) => number} compareFunction 比較関数
- * @param {number} startID 開始インデックス
- * @param {number} endID 終了インデックス
- * @returns T[]
+ * Quick sort implementation for arrays
+ * @template T Type of array elements
+ * @param {T[]} array Input array to sort
+ * @param {(a: T, b: T) => number} compareFunction Function to determine sort order
+ * @param {number} startID Starting index for sorting
+ * @param {number} endID Ending index for sorting
+ * @returns {T[]} Sorted array
  * @example quickSort([1, 3, 2, 4, 5], (a, b) => a - b); // [1, 2, 3, 4, 5]
  */
-export declare const quickSortSimple: <T>(array: T[], compareFunction?: (a: T, b: T) => number, startID?: number, endID?: number) => T[];
+export declare const quickSortSimple: <T>(array: T[], compareFunction?: CompareFunction<T>, startID?: number, endID?: number) => T[];

package/module/Simple/Array/quickSortSimple.js

@@ -1,12 +1,13 @@
 import { compareFunctionDefault } from "../../Array/compareFunctionDefault";
 import { quickSort } from "../../Array/quickSort";
 /**
- * 配列を高速にソート
- * @param {T[]} array 配列
- * @param {(a: T, b: T) => number} compareFunction 比較関数
- * @param {number} startID 開始インデックス
- * @param {number} endID 終了インデックス
- * @returns T[]
+ * Quick sort implementation for arrays
+ * @template T Type of array elements
+ * @param {T[]} array Input array to sort
+ * @param {(a: T, b: T) => number} compareFunction Function to determine sort order
+ * @param {number} startID Starting index for sorting
+ * @param {number} endID Ending index for sorting
+ * @returns {T[]} Sorted array
  * @example quickSort([1, 3, 2, 4, 5], (a, b) => a - b); // [1, 2, 3, 4, 5]
  */
 export const quickSortSimple = (array, compareFunction = (compareFunctionDefault), startID = 0, endID = array.length - 1) => {

package/module/Simple/Array/quickSortSimple.js.map

@@ -1 +1 @@
-{"version":3,"file":"quickSortSimple.js","sourceRoot":"","sources":["../../../src/Simple/Array/quickSortSimple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAU,EACV,kBAA0C,CAAA,sBAAyB,CAAA,EACnE,OAAO,GAAG,CAAC,EACX,QAAgB,KAAK,CAAC,MAAM,GAAG,CAAC,EAC3B,EAAE;IACP,IAAI,YAAY,GAAG,OAAO,CAAC;IAC3B,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IACE,YAAY,GAAG,CAAC;QAChB,YAAY,IAAI,KAAK,CAAC,MAAM;QAC5B,YAAY,GAAG,UAAU,EACzB,CAAC;QACD,YAAY,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjD,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;AACrE,CAAC,CAAC"}
+{"version":3,"file":"quickSortSimple.js","sourceRoot":"","sources":["../../../src/Simple/Array/quickSortSimple.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAU,EACV,kBAAsC,CAAA,sBAAyB,CAAA,EAC/D,OAAO,GAAG,CAAC,EACX,QAAgB,KAAK,CAAC,MAAM,GAAG,CAAC,EAC3B,EAAE;IACP,IAAI,YAAY,GAAG,OAAO,CAAC;IAC3B,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IACE,YAAY,GAAG,CAAC;QAChB,YAAY,IAAI,KAAK,CAAC,MAAM;QAC5B,YAAY,GAAG,UAAU,EACzB,CAAC;QACD,YAAY,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjD,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;AACrE,CAAC,CAAC"}

package/module/Simple/Date/birthdaySimple.d.ts

@@ -7,10 +7,10 @@ export type BIRTHDAYSIMPLE = <T extends MonType>(birthdays: Date | `${number}-${
     day: number;
 }, timeDifference?: HoursTypeInt) => number;
 /**
- * 年齢を取得する
- * @param birthdays - 誕生日
- * @param timeDifference - 時差 (default: 9)
- * @returns number
+ * Calculate age from birthdate
+ * @param birthdays - Birthday date in various formats
+ * @param timeDifference - Time zone difference in hours (default: 9)
+ * @returns Age in years
  * @example birthdaySimple("2000-01-01");
  * birthdaySimple("2000:01:01");
  * birthdaySimple("2000/01/01");

package/module/Simple/Date/birthdaySimple.js

@@ -1,9 +1,9 @@
 import { birthday } from "../../Date/birthday";
 /**
- * 年齢を取得する
- * @param birthdays - 誕生日
- * @param timeDifference - 時差 (default: 9)
- * @returns number
+ * Calculate age from birthdate
+ * @param birthdays - Birthday date in various formats
+ * @param timeDifference - Time zone difference in hours (default: 9)
+ * @returns Age in years
  * @example birthdaySimple("2000-01-01");
  * birthdaySimple("2000:01:01");
  * birthdaySimple("2000/01/01");

package/module/Simple/Date/dayOfWeekSimple.d.ts

@@ -7,10 +7,10 @@ import type { MonthsWith31DaysInt } from "../../types/date/monthsWith31DaysInt";
 import type { MonthsWithout31Days } from "../../types/date/monthsWithout31Days";
 import type { MonthsWithout31DaysInt } from "../../types/date/monthsWithout31DaysInt";
 /**
- * 曜日を取得する
- * @param properties - 年月日
- * @param timeDifference - 時差 (default: 9)
- * @returns number
+ * Get day of the week
+ * @param properties - Date in various formats (year, month, day)
+ * @param timeDifference - Time zone difference in hours (default: 9)
+ * @returns Day of the week (0-6, where 0 is Sunday)
  * @example dayOfWeekSimple("2000-01-01");
  * dayOfWeekSimple("2000:01:01");
  * dayOfWeekSimple("2000/01/01");

package/module/Simple/Date/nowSimple.d.ts

@@ -1,9 +1,9 @@
 import type { HoursType } from "../../types/clock/hoursType";
 import type { HoursTypeInt } from "../../types/clock/hoursTypeInt";
 /**
- * 現在時刻を取得する
- * @param timeDifference - 時差 (default: 9)
- * @returns Date
+ * Get current date and time
+ * @param timeDifference - Time zone difference in hours (default: 9)
+ * @returns Current Date object
  * @example nowSimple(); // 2021-01-01T00:00:00.000Z
  */
 export declare const nowSimple: (timeDifference?: HoursTypeInt | HoursType) => Date;

package/module/Simple/Date/nowSimple.js

@@ -1,9 +1,9 @@
 import { now } from "../../Date/now";
 import { isNumber } from "../../Validate/isNumber";
 /**
- * 現在時刻を取得する
- * @param timeDifference - 時差 (default: 9)
- * @returns Date
+ * Get current date and time
+ * @param timeDifference - Time zone difference in hours (default: 9)
+ * @returns Current Date object
  * @example nowSimple(); // 2021-01-01T00:00:00.000Z
  */
 export const nowSimple = (timeDifference = 9) => {

package/module/Simple/Math/deviationValueSimple.d.ts

@@ -1,13 +1,12 @@
-export interface DeviationValueSimple {
-    (value: number, averageValue: number, standardDeviationValue: number): number;
-    (value: number, averageValue: number[]): number;
-}
 /**
- * 偏差値を返す
- * @param  {number} value 値
- * @param  {number|number[]} averageValue 平均値
- * @param  {number} standardDeviationValue 標準偏差
- * @returns number
- * @example deviationValueSimple(60, 50, 10); // 110
+ * Calculate deviation score (T-score)
+ * @param  {number} value Input value
+ * @param  {number|number[]} averageValue Average value or array of values to calculate average from
+ * @param  {number} standardDeviationValue Standard deviation (optional if averageValue is array)
+ * @returns {number} Deviation score (50 is average, each standard deviation is worth 10 points)
+ * @returns {number} Returns 50 when standard deviation is 0 (all values are the same)
+ * @example deviationValueSimple(60, 50, 10); // 60 (one standard deviation above mean)
+ * @example deviationValueSimple(60, [40, 50, 60]); // Calculates using array values
  */
-export declare const deviationValueSimple: DeviationValueSimple;
+export declare function deviationValueSimple(value: number, averageValue: number[]): number;
+export declare function deviationValueSimple(value: number, averageValue: number, standardDeviationValue: number): number;

package/module/Simple/Math/deviationValueSimple.js

@@ -1,19 +1,20 @@
 import { average } from "../../Math/average";
 import { deviationValue } from "../../Math/deviationValue";
 import { standardDeviation } from "../../Math/standardDeviation";
-/**
- * 偏差値を返す
- * @param  {number} value 値
- * @param  {number|number[]} averageValue 平均値
- * @param  {number} standardDeviationValue 標準偏差
- * @returns number
- * @example deviationValueSimple(60, 50, 10); // 110
- */
-export const deviationValueSimple = ((value, averageValue, standardDeviationValue) => {
+export function deviationValueSimple(value, averageValue, standardDeviationValue) {
+    // Handle array input
     if (Array.isArray(averageValue)) {
-        const x = average(averageValue);
-        return deviationValue(value, x, standardDeviation(averageValue));
+        const avg = average(averageValue);
+        const sd = standardDeviation(averageValue);
+        // When all values are the same, standard deviation is 0
+        return sd === 0 ? 50 : deviationValue(value, avg, sd);
     }
-    return deviationValue(value, averageValue, standardDeviationValue);
-});
+    // Handle direct value input with standard deviation
+    if (standardDeviationValue === undefined) {
+        throw new TypeError("Standard deviation is required when using a single average value");
+    }
+    return standardDeviationValue === 0
+        ? 50
+        : deviationValue(value, averageValue, standardDeviationValue);
+}
 //# sourceMappingURL=deviationValueSimple.js.map

package/module/Simple/Math/deviationValueSimple.js.map

@@ -1 +1 @@
-{"version":3,"file":"deviationValueSimple.js","sourceRoot":"","sources":["../../../src/Simple/Math/deviationValueSimple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAM7D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CACnC,KAAa,EACb,YAA+B,EAC/B,sBAA8B,EAC9B,EAAE;IACF,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAChC,OAAO,cAAc,CAAC,KAAK,EAAE,CAAC,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,sBAAsB,CAAC,CAAC;AACrE,CAAC,CAAyB,CAAC"}
+{"version":3,"file":"deviationValueSimple.js","sourceRoot":"","sources":["../../../src/Simple/Math/deviationValueSimple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAqB7D,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,YAA+B,EAC/B,sBAA+B;IAE/B,qBAAqB;IACrB,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAClC,MAAM,EAAE,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAC3C,wDAAwD;QACxD,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,oDAAoD;IACpD,IAAI,sBAAsB,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,IAAI,SAAS,CACjB,kEAAkE,CACnE,CAAC;IACJ,CAAC;IAED,OAAO,sBAAsB,KAAK,CAAC;QACjC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,sBAAsB,CAAC,CAAC;AAClE,CAAC"}

package/module/String/deleteSpaces.d.ts

@@ -1,7 +1,11 @@
 /**
- * 文字列からスペースを削除する
- * @param {string} string_
- * @returns string
- * @example deleteSpace("Hello World"); // "HelloWorld"
+ * Removes all whitespace characters from a string
+ * @param {string} string_ - Input string
+ * @returns {string} String with all whitespace characters removed
+ * @example
+ * ```typescript
+ * deleteSpaces("Hello World");  // Returns: "HelloWorld"
+ * deleteSpaces("  tab\t space ");  // Returns: "tabspace"
+ * ```
  */
 export declare const deleteSpaces: (string_: string) => string;

package/module/String/deleteSpaces.js

@@ -1,8 +1,12 @@
 /**
- * 文字列からスペースを削除する
- * @param {string} string_
- * @returns string
- * @example deleteSpace("Hello World"); // "HelloWorld"
+ * Removes all whitespace characters from a string
+ * @param {string} string_ - Input string
+ * @returns {string} String with all whitespace characters removed
+ * @example
+ * ```typescript
+ * deleteSpaces("Hello World");  // Returns: "HelloWorld"
+ * deleteSpaces("  tab\t space ");  // Returns: "tabspace"
+ * ```
  */
 export const deleteSpaces = (string_) => {
     return string_.replaceAll(/\s/g, "");

package/module/String/deleteSpaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"deleteSpaces.js","sourceRoot":"","sources":["../../src/String/deleteSpaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,EAAE;IAC9C,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC,CAAC"}
+{"version":3,"file":"deleteSpaces.js","sourceRoot":"","sources":["../../src/String/deleteSpaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAU,EAAE;IACtD,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC,CAAC"}

package/module/String/formatString.d.ts

@@ -1,13 +1,13 @@
 /**
- * テンプレート文字列内のプレースホルダーを指定された値で置換します。
- * プレースホルダーは {0}、{1}、{2}... の形式で、対応する値が配列で渡されます。
+ * Replaces placeholders in a template string with specified values.
+ * Placeholders are in the format {0}, {1}, {2}... and corresponding values are passed as an array.
  *
- * @param template - プレースホルダーを含むテンプレート文字列
- * @param values - テンプレート内のプレースホルダーに置換する値の配列
- * @returns プレースホルダーが値で置換された文字列
+ * @param template - Template string containing placeholders
+ * @param values - Array of values to replace the placeholders in the template
+ * @returns String with placeholders replaced with values
  *
  * @example
- * // "こんにちは、世界！" を返します
- * formatString("こんにちは、{0}！", "世界");
+ * // Returns "Hello, World!"
+ * formatString("Hello, {0}!", "World");
  */
-export declare const formatString: <T>(template: string, ...values: T[]) => string;
+export declare const formatString: (template: string, ...values: unknown[]) => string;

package/module/String/formatString.js

@@ -1,14 +1,14 @@
 /**
- * テンプレート文字列内のプレースホルダーを指定された値で置換します。
- * プレースホルダーは {0}、{1}、{2}... の形式で、対応する値が配列で渡されます。
+ * Replaces placeholders in a template string with specified values.
+ * Placeholders are in the format {0}, {1}, {2}... and corresponding values are passed as an array.
  *
- * @param template - プレースホルダーを含むテンプレート文字列
- * @param values - テンプレート内のプレースホルダーに置換する値の配列
- * @returns プレースホルダーが値で置換された文字列
+ * @param template - Template string containing placeholders
+ * @param values - Array of values to replace the placeholders in the template
+ * @returns String with placeholders replaced with values
  *
  * @example
- * // "こんにちは、世界！" を返します
- * formatString("こんにちは、{0}！", "世界");
+ * // Returns "Hello, World!"
+ * formatString("Hello, {0}!", "World");
  */
 export const formatString = (template, ...values) => {
     return template.replaceAll(/{(\d+)}/g, (match, index) => {

package/module/String/formatString.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatString.js","sourceRoot":"","sources":["../../src/String/formatString.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAI,QAAgB,EAAE,GAAG,MAAW,EAAE,EAAE;IAClE,OAAO,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACtD,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}
+{"version":3,"file":"formatString.js","sourceRoot":"","sources":["../../src/String/formatString.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAE,GAAG,MAAiB,EAAE,EAAE;IACrE,OAAO,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACtD,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/module/String/fromBase64.d.ts

@@ -1,6 +1,7 @@
 /**
- * Base64を文字列に変換する
- * @param {string} base64String - Base64文字列
- * @returns 文字列に変換されたBase64
+ * Converts Base64 to string
+ * @param {string} base64String - Base64 encoded string
+ * @returns Decoded string from Base64
+ * @throws {Error} When input is not a valid Base64 string
  */
 export declare const fromBase64: (base64String: string) => string;

package/module/String/fromBase64.js

@@ -1,14 +1,20 @@
 /**
- * Base64を文字列に変換する
- * @param {string} base64String - Base64文字列
- * @returns 文字列に変換されたBase64
+ * Converts Base64 to string
+ * @param {string} base64String - Base64 encoded string
+ * @returns Decoded string from Base64
+ * @throws {Error} When input is not a valid Base64 string
  */
 export const fromBase64 = (base64String) => {
-    // Base64文字列をバイト配列に変換
-    const bytes = Uint8Array.from(atob(base64String)
-        .split("")
-        .map((c) => c.codePointAt(0)));
-    // UTF-8デコーダーを使用して文字列に変換
-    return new TextDecoder().decode(bytes);
+    if (base64String === "") {
+        return "";
+    }
+    try {
+        return new TextDecoder().decode(Uint8Array.from(atob(base64String)
+            .split("")
+            .map((c) => c.codePointAt(0))));
+    }
+    catch {
+        throw new Error("Invalid Base64 string");
+    }
 };
 //# sourceMappingURL=fromBase64.js.map

package/module/String/fromBase64.js.map

@@ -1 +1 @@
-{"version":3,"file":"fromBase64.js","sourceRoot":"","sources":["../../src/String/fromBase64.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,YAAoB,EAAU,EAAE;IACzD,qBAAqB;IACrB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAC3B,IAAI,CAAC,YAAY,CAAC;SACf,KAAK,CAAC,EAAE,CAAC;SACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAW,CAAC,CAC1C,CAAC;IACF,wBAAwB;IACxB,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC,CAAC"}
+{"version":3,"file":"fromBase64.js","sourceRoot":"","sources":["../../src/String/fromBase64.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,YAAoB,EAAU,EAAE;IACzD,IAAI,YAAY,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAC7B,UAAU,CAAC,IAAI,CACb,IAAI,CAAC,YAAY,CAAC;aACf,KAAK,CAAC,EAAE,CAAC;aACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAW,CAAC,CAC1C,CACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC,CAAC"}

package/module/String/hasNoLetters.d.ts

@@ -1,6 +1,12 @@
 /**
- * Check if the string has no letters (only emojis, numbers, or special characters)
- * @param text
- * @returns boolean - true if the string has no letters
+ * Checks if the string contains no letters (contains only emojis, numbers, or special characters)
+ * @param {string} text - The string to check
+ * @returns {boolean} True if the string has no letters, false otherwise
+ * @example
+ * ```typescript
+ * hasNoLetters("123");     // Returns: true
+ * hasNoLetters("🌟123#"); // Returns: true
+ * hasNoLetters("abc123"); // Returns: false
+ * ```
  */
 export declare const hasNoLetters: (text: string) => boolean;

package/module/String/hasNoLetters.js

@@ -1,12 +1,18 @@
 /**
- * Check if the string has no letters (only emojis, numbers, or special characters)
- * @param text
- * @returns boolean - true if the string has no letters
+ * Checks if the string contains no letters (contains only emojis, numbers, or special characters)
+ * @param {string} text - The string to check
+ * @returns {boolean} True if the string has no letters, false otherwise
+ * @example
+ * ```typescript
+ * hasNoLetters("123");     // Returns: true
+ * hasNoLetters("🌟123#"); // Returns: true
+ * hasNoLetters("abc123"); // Returns: false
+ * ```
  */
 export const hasNoLetters = (text) => {
-    // \p[L] = Unicode letter
-    // /u = Unicode flag
-    // [^\p{L}]* = any character that is not a letter
+    // Uses Unicode pattern:
+    // \p{L} matches any Unicode letter
+    // [^\p{L}]* matches zero or more non-letter characters
     const nonTextPattern = /^[^\p{L}]*$/u;
     return nonTextPattern.test(text);
 };

package/module/String/hasNoLetters.js.map

@@ -1 +1 @@
-{"version":3,"file":"hasNoLetters.js","sourceRoot":"","sources":["../../src/String/hasNoLetters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE;IAC3C,yBAAyB;IACzB,oBAAoB;IACpB,iDAAiD;IACjD,MAAM,cAAc,GAAG,cAAc,CAAC;IACtC,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC,CAAC"}
+{"version":3,"file":"hasNoLetters.js","sourceRoot":"","sources":["../../src/String/hasNoLetters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAW,EAAE;IACpD,wBAAwB;IACxB,mCAAmC;IACnC,uDAAuD;IACvD,MAAM,cAAc,GAAG,cAAc,CAAC;IACtC,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC,CAAC"}

package/module/String/padEnd.d.ts

@@ -1,9 +1,9 @@
 /**
- * 指定された長さに達するまで、文字列の末尾に指定された文字列を追加します。
+ * Adds the specified string to the end of the string until it reaches the specified length.
  *
- * @param string_ - パディングを適用する元の文字列
- * @param targetLength - パディング後の目標の長さ
- * @param padString - パディングに使用する文字列
- * @returns パディングが適用された後の文字列
+ * @param string_ - The original string to apply padding
+ * @param targetLength - The target length after padding
+ * @param padString - The string to use for padding
+ * @returns The string after padding has been applied
  */
 export declare const padEnd: (string_: string, targetLength: number, padString: string) => string;

package/module/String/padEnd.js

@@ -1,10 +1,10 @@
 /**
- * 指定された長さに達するまで、文字列の末尾に指定された文字列を追加します。
+ * Adds the specified string to the end of the string until it reaches the specified length.
  *
- * @param string_ - パディングを適用する元の文字列
- * @param targetLength - パディング後の目標の長さ
- * @param padString - パディングに使用する文字列
- * @returns パディングが適用された後の文字列
+ * @param string_ - The original string to apply padding
+ * @param targetLength - The target length after padding
+ * @param padString - The string to use for padding
+ * @returns The string after padding has been applied
  */
 export const padEnd = (string_, targetLength, padString) => {
     if (padString === "") {

package/module/String/padStart.d.ts

@@ -1,9 +1,15 @@
 /**
- * 指定された長さに達するまで、文字列の先頭に別の文字列を繰り返し追加します。
+ * Pads the start of a string with another string until the target length is reached
  *
- * @param string_ - パディングを追加する元の文字列。
- * @param targetLength - パディングを含めた後の目標の文字列長。
- * @param padString - 元の文字列の先頭に追加される文字列。
- * @returns パディングが追加された後の文字列。
+ * @param {string} string_ - The original string to pad
+ * @param {number} targetLength - The target length after padding
+ * @param {string} padString - The string to use for padding
+ * @returns {string} The padded string
+ * @throws {Error} If padString is empty
+ * @example
+ * ```typescript
+ * padStart("123", 5, "0");     // Returns: "00123"
+ * padStart("abc", 8, "def");   // Returns: "defdeabc"
+ * ```
  */
 export declare const padStart: (string_: string, targetLength: number, padString: string) => string;

package/module/String/padStart.js

@@ -1,20 +1,32 @@
 /**
- * 指定された長さに達するまで、文字列の先頭に別の文字列を繰り返し追加します。
+ * Pads the start of a string with another string until the target length is reached
  *
- * @param string_ - パディングを追加する元の文字列。
- * @param targetLength - パディングを含めた後の目標の文字列長。
- * @param padString - 元の文字列の先頭に追加される文字列。
- * @returns パディングが追加された後の文字列。
+ * @param {string} string_ - The original string to pad
+ * @param {number} targetLength - The target length after padding
+ * @param {string} padString - The string to use for padding
+ * @returns {string} The padded string
+ * @throws {Error} If padString is empty
+ * @example
+ * ```typescript
+ * padStart("123", 5, "0");     // Returns: "00123"
+ * padStart("abc", 8, "def");   // Returns: "defdeabc"
+ * ```
  */
 export const padStart = (string_, targetLength, padString) => {
     if (padString === "") {
         throw new Error("padString cannot be empty");
     }
+    // Return original string if it's longer than target length
+    if (string_.length >= targetLength) {
+        return string_;
+    }
     let padding = "";
     const paddingLength = targetLength - string_.length;
+    // Build padding by repeating padString
     while (padding.length < paddingLength) {
         padding += padString;
     }
+    // Trim padding to exact length needed and concatenate with original string
     return padding.slice(0, paddingLength) + string_;
 };
 //# sourceMappingURL=padStart.js.map

package/module/String/padStart.js.map

@@ -1 +1 @@
-{"version":3,"file":"padStart.js","sourceRoot":"","sources":["../../src/String/padStart.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,OAAe,EACf,YAAoB,EACpB,SAAiB,EACT,EAAE;IACV,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,aAAa,GAAG,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IACpD,OAAO,OAAO,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACtC,OAAO,IAAI,SAAS,CAAC;IACvB,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC;AACnD,CAAC,CAAC"}
+{"version":3,"file":"padStart.js","sourceRoot":"","sources":["../../src/String/padStart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,OAAe,EACf,YAAoB,EACpB,SAAiB,EACT,EAAE;IACV,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,2DAA2D;IAC3D,IAAI,OAAO,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,aAAa,GAAG,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAEpD,uCAAuC;IACvC,OAAO,OAAO,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACtC,OAAO,IAAI,SAAS,CAAC;IACvB,CAAC;IAED,2EAA2E;IAC3E,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC;AACnD,CAAC,CAAC"}

package/module/String/randomString.d.ts

@@ -1,7 +1,7 @@
 /**
- * ランダムな文字列を生成します。
- * @param char ランダムな文字列を生成するための文字列
- * @param size ランダムな文字列の長さ
- * @returns ランダムな文字列
+ * Generates a random string.
+ * @param char String of characters to use for generating random string
+ * @param size Length of the random string
+ * @returns Random string
  */
 export declare const randomString: (size?: number, char?: string) => string;

package/module/String/randomString.js

@@ -1,8 +1,8 @@
 /**
- * ランダムな文字列を生成します。
- * @param char ランダムな文字列を生成するための文字列
- * @param size ランダムな文字列の長さ
- * @returns ランダムな文字列
+ * Generates a random string.
+ * @param char String of characters to use for generating random string
+ * @param size Length of the random string
+ * @returns Random string
  */
 export const randomString = (size = 8, char = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz") => {
     const length = char.length;

package/module/String/randomStringInitialization.d.ts

@@ -1,6 +1,6 @@
 /**
- * ランダムな文字列を生成する関数を初期化します。
- * @param char ランダムな文字列を生成するための文字列
- * @returns ランダムな文字列を生成する関数 (size: number) => string
+ * Initializes a function that generates random strings.
+ * @param char String of characters to use for generating random strings
+ * @returns A function that generates random strings (size: number) => string
  */
 export declare const randomStringInitialization: (char?: string) => (size: number) => string;

package/module/String/randomStringInitialization.js

@@ -1,8 +1,8 @@
 import { randomString } from "./randomString";
 /**
- * ランダムな文字列を生成する関数を初期化します。
- * @param char ランダムな文字列を生成するための文字列
- * @returns ランダムな文字列を生成する関数 (size: number) => string
+ * Initializes a function that generates random strings.
+ * @param char String of characters to use for generating random strings
+ * @returns A function that generates random strings (size: number) => string
  */
 export const randomStringInitialization = (char = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz") => {
     return (size) => randomString(size, char);

package/module/String/reverseString.d.ts

@@ -1,7 +1,7 @@
 /**
- * 文字列を逆順にする
- * @param {string} char
- * @returns string
+ * Reverses a string
+ * @param {string} char - String to reverse
+ * @returns Reversed string
  * @example reverseString("Hello"); // "olleH"
  */
 export declare const reverseString: (char: string) => string;

package/module/String/reverseString.js

@@ -1,7 +1,7 @@
 /**
- * 文字列を逆順にする
- * @param {string} char
- * @returns string
+ * Reverses a string
+ * @param {string} char - String to reverse
+ * @returns Reversed string
  * @example reverseString("Hello"); // "olleH"
  */
 export const reverseString = (char) => {

package/module/String/toBase64.d.ts

@@ -1,6 +1,6 @@
 /**
- * 文字列をBase64に変換する
- * @param char Base64に変換する文字列
- * @returns Base64に変換された文字列
+ * Convert string to Base64
+ * @param char String to convert to Base64
+ * @returns Base64 encoded string
  */
 export declare const toBase64: (char: string) => string;

package/module/String/toBase64.js

@@ -1,7 +1,7 @@
 /**
- * 文字列をBase64に変換する
- * @param char Base64に変換する文字列
- * @returns Base64に変換された文字列
+ * Convert string to Base64
+ * @param char String to convert to Base64
+ * @returns Base64 encoded string
  */
 export const toBase64 = (char) => btoa(encodeURIComponent(char).replaceAll(/%([\dA-F]{2})/g, (_, p1) => String.fromCodePoint(Number.parseInt(p1, 16))));
 //# sourceMappingURL=toBase64.js.map