umt 2.1.2 → 2.2.0

package/module/es5/IP/ipToBinaryString.js

@@ -4,13 +4,52 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.ipToBinaryString = void 0;
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 /**
- * IPアドレスをバイナリ文字列に変換します
- * @param {string} ip - 変換するIPアドレス
- * @returns {string} バイナリ文字列
+ * Converts an IPv4 address to its binary string representation
+ * @param {string} ip - IPv4 address (e.g., "192.168.1.1")
+ * @returns {string} Binary string representation (32 bits)
+ * @throws {Error} If IP address is invalid
  */
 var ipToBinaryString = exports.ipToBinaryString = function ipToBinaryString(ip) {
-  return ip.split(".").map(function (octet) {
-    return (+octet).toString(2).padStart(8, "0");
+  if (!ip) {
+    throw new Error("IP address is required");
+  }
+
+  // Check for invalid characters
+  if (/[^0-9.]/.test(ip)) {
+    throw new Error("Invalid IP address format");
+  }
+  var parts = ip.split(".");
+  if (parts.length !== 4) {
+    throw new Error("Invalid IP address format");
+  }
+
+  // Validate each octet
+  var _iterator = _createForOfIteratorHelper(parts),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var octet = _step.value;
+      // Check for empty octet or leading zeros
+      if (!octet || octet.length > 1 && octet[0] === "0") {
+        throw new Error("Invalid IP address format");
+      }
+      var number = Number.parseInt(octet);
+      if (Number.isNaN(number) || number < 0 || number > 255) {
+        throw new Error("Invalid IP address format");
+      }
+    }
+
+    // Convert to binary
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return parts.map(function (octet) {
+    return Number.parseInt(octet).toString(2).padStart(8, "0");
   }).join("");
 };

package/module/es5/IP/ipToLong.d.ts

@@ -1,6 +1,7 @@
 /**
- * IPアドレスを32ビットの数値に変換します
- * @param {string} ip - 変換するIPアドレス
- * @returns {number} 32ビットの数値
+ * Converts an IPv4 address to a 32-bit number
+ * @param {string} ip - IPv4 address to convert (e.g., "192.168.1.1")
+ * @returns {number} 32-bit unsigned integer
+ * @throws {Error} If IP address is invalid
  */
 export declare const ipToLong: (ip: string) => number;

package/module/es5/IP/ipToLong.js

@@ -6,9 +6,10 @@ Object.defineProperty(exports, "__esModule", {
 exports.ipToLong = void 0;
 var _ipToBinaryString = require("./ipToBinaryString");
 /**
- * IPアドレスを32ビットの数値に変換します
- * @param {string} ip - 変換するIPアドレス
- * @returns {number} 32ビットの数値
+ * Converts an IPv4 address to a 32-bit number
+ * @param {string} ip - IPv4 address to convert (e.g., "192.168.1.1")
+ * @returns {number} 32-bit unsigned integer
+ * @throws {Error} If IP address is invalid
  */
 var ipToLong = exports.ipToLong = function ipToLong(ip) {
   return Number.parseInt((0, _ipToBinaryString.ipToBinaryString)(ip), 2) >>> 0;

package/module/es5/IP/isInRange.d.ts

@@ -1,8 +1,9 @@
 /**
- * 指定のIPアドレスが範囲内かどうかを判定します
- * @param {string} remoteIp - リモートIPアドレス
- * @param {string} networkIp - ネットワークIPアドレス
- * @param {number} cidr - CIDR
- * @returns {boolean} 範囲内であればtrue
+ * Checks if an IP address is within a specified network range
+ * @param {string} remoteIp - IP address to check (e.g., "192.168.1.1")
+ * @param {string} networkIp - Network IP address (e.g., "192.168.0.0")
+ * @param {number} cidr - CIDR notation (0-32)
+ * @returns {boolean} True if the IP is in range, false otherwise
+ * @throws {Error} If any parameter is invalid
  */
 export declare const isInRange: (remoteIp: string, networkIp: string, cidr: number) => boolean;

package/module/es5/IP/isInRange.js

@@ -6,13 +6,40 @@ Object.defineProperty(exports, "__esModule", {
 exports.isInRange = void 0;
 var _ipToLong = require("./ipToLong");
 /**
- * 指定のIPアドレスが範囲内かどうかを判定します
- * @param {string} remoteIp - リモートIPアドレス
- * @param {string} networkIp - ネットワークIPアドレス
- * @param {number} cidr - CIDR
- * @returns {boolean} 範囲内であればtrue
+ * Checks if an IP address is within a specified network range
+ * @param {string} remoteIp - IP address to check (e.g., "192.168.1.1")
+ * @param {string} networkIp - Network IP address (e.g., "192.168.0.0")
+ * @param {number} cidr - CIDR notation (0-32)
+ * @returns {boolean} True if the IP is in range, false otherwise
+ * @throws {Error} If any parameter is invalid
  */
 var isInRange = exports.isInRange = function isInRange(remoteIp, networkIp, cidr) {
-  var shift = 32 - cidr;
-  return (0, _ipToLong.ipToLong)(remoteIp) >>> shift === (0, _ipToLong.ipToLong)(networkIp) >>> shift;
+  if (!remoteIp) {
+    throw new Error("Remote IP address is required");
+  }
+  if (!networkIp) {
+    throw new Error("Network IP address is required");
+  }
+  if (!Number.isInteger(cidr) || cidr < 0 || cidr > 32) {
+    throw new Error("CIDR must be an integer between 0 and 32");
+  }
+  try {
+    var remoteLong = (0, _ipToLong.ipToLong)(remoteIp);
+    var networkLong = (0, _ipToLong.ipToLong)(networkIp);
+
+    // Special cases
+    if (cidr === 0) {
+      return true; // All IPs are in range
+    }
+    if (cidr === 32) {
+      return remoteLong === networkLong; // Exact match required
+    }
+
+    // Normal case
+    var shift = 32 - cidr;
+    var mask = 0xffffffff >>> 0 << shift;
+    return (remoteLong & mask) === (networkLong & mask);
+  } catch (error) {
+    throw new Error("Invalid IP address format: ".concat(String(error)));
+  }
 };

package/module/es5/IP/isPrivateIp.d.ts

@@ -1,6 +1,7 @@
 /**
- * IPアドレスがプライベート範囲にあるかどうかを判定します
- * @param {string} ip - 判定するIPアドレス
- * @returns {boolean} プライベート範囲にあればtrue
+ * Checks if an IP address is within private IP ranges
+ * @param {string} ip - IP address to check (e.g., "192.168.1.1")
+ * @returns {boolean} True if the IP is private, false otherwise
+ * @throws {Error} If IP address is invalid
  */
 export declare const isPrivateIp: (ip: string) => boolean;

package/module/es5/IP/isPrivateIp.js

@@ -4,26 +4,39 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.isPrivateIp = void 0;
-var _ipToLong = require("./ipToLong");
 var _isInRange = require("./isInRange");
 /**
- * IPアドレスがプライベート範囲にあるかどうかを判定します
- * @param {string} ip - 判定するIPアドレス
- * @returns {boolean} プライベート範囲にあればtrue
+ * Checks if an IP address is within private IP ranges
+ * @param {string} ip - IP address to check (e.g., "192.168.1.1")
+ * @returns {boolean} True if the IP is private, false otherwise
+ * @throws {Error} If IP address is invalid
  */
 var isPrivateIp = exports.isPrivateIp = function isPrivateIp(ip) {
-  // プライベートIP範囲の定義
+  if (!ip) {
+    throw new Error("IP address is required");
+  }
+
+  // Define private IP ranges with their CIDR notations
   var privateRanges = [{
-    start: "10.0.0.0",
-    end: "10.255.255.255"
-  }, {
-    start: "172.16.0.0",
-    end: "172.31.255.255"
-  }, {
-    start: "192.168.0.0",
-    end: "192.168.255.255"
-  }];
-  return privateRanges.some(function (range) {
-    return (0, _isInRange.isInRange)(ip, range.start, (0, _ipToLong.ipToLong)(range.end));
-  });
+    network: "10.0.0.0",
+    cidr: 8
+  },
+  // Class A private network
+  {
+    network: "172.16.0.0",
+    cidr: 12
+  },
+  // Class B private network
+  {
+    network: "192.168.0.0",
+    cidr: 16
+  } // Class C private network
+  ];
+  try {
+    return privateRanges.some(function (range) {
+      return (0, _isInRange.isInRange)(ip, range.network, range.cidr);
+    });
+  } catch (error) {
+    throw new Error("Invalid IP address: ".concat(String(error)));
+  }
 };

package/module/es5/IP/longToIp.d.ts

@@ -1,6 +1,7 @@
 /**
- * 32ビットの数値をIPアドレスに変換します
- * @param {number} long - 変換する32ビットの数値
- * @returns {string} IPアドレス
+ * Converts a 32-bit number to an IPv4 address
+ * @param {number} long - 32-bit unsigned integer to convert
+ * @returns {string} IPv4 address (e.g., "192.168.1.1")
+ * @throws {Error} If input is not a valid 32-bit unsigned integer
  */
 export declare const longToIp: (long: number) => string;

package/module/es5/IP/longToIp.js

@@ -5,15 +5,27 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.longToIp = void 0;
 /**
- * 32ビットの数値をIPアドレスに変換します
- * @param {number} long - 変換する32ビットの数値
- * @returns {string} IPアドレス
+ * Converts a 32-bit number to an IPv4 address
+ * @param {number} long - 32-bit unsigned integer to convert
+ * @returns {string} IPv4 address (e.g., "192.168.1.1")
+ * @throws {Error} If input is not a valid 32-bit unsigned integer
  */
 var longToIp = exports.longToIp = function longToIp(_long) {
+  // Validate input
+  if (!Number.isFinite(_long) || _long < 0 || _long > 0xffffffff || !Number.isInteger(_long)) {
+    throw new Error("Input must be a valid 32-bit unsigned integer");
+  }
+
+  // Convert to binary string and ensure 32-bit length
   var binary = _long.toString(2).padStart(32, "0");
-  return Array.from({
+
+  // Split into octets and convert to decimal
+  var octets = Array.from({
     length: 4
   }, function (_, index) {
     return Number.parseInt(binary.slice(index * 8, (index + 1) * 8), 2);
-  }).join(".");
+  });
+
+  // Join octets with dots
+  return octets.join(".");
 };

package/module/es5/IP/subnetMaskToCidr.d.ts

@@ -1,6 +1,7 @@
 /**
- * サブネットマスクからCIDRを取得します
- * @param {string} subnetMask - サブネットマスク
- * @returns {number} CIDR
+ * Converts a subnet mask to CIDR notation
+ * @param {string} subnetMask - IPv4 subnet mask (e.g., "255.255.255.0")
+ * @returns {number} CIDR notation (0-32)
+ * @throws {Error} If subnet mask is invalid
  */
 export declare const subnetMaskToCidr: (subnetMask: string) => number;

package/module/es5/IP/subnetMaskToCidr.js

@@ -4,20 +4,41 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.subnetMaskToCidr = void 0;
-var _ipToBinaryString = require("./ipToBinaryString");
-var _isValueNaN = require("@/Validate/isValueNaN");
 /**
- * サブネットマスクからCIDRを取得します
- * @param {string} subnetMask - サブネットマスク
- * @returns {number} CIDR
+ * Converts a subnet mask to CIDR notation
+ * @param {string} subnetMask - IPv4 subnet mask (e.g., "255.255.255.0")
+ * @returns {number} CIDR notation (0-32)
+ * @throws {Error} If subnet mask is invalid
  */
 var subnetMaskToCidr = exports.subnetMaskToCidr = function subnetMaskToCidr(subnetMask) {
-  // サブネットマスクが有効なIPアドレス形式かどうかをチェック
-  var octets = subnetMask.split(".").map(Number);
-  if (octets.length !== 4 || octets.some(function (octet) {
-    return (0, _isValueNaN.isValueNaN)(octet, true) || octet < 0 || octet > 255;
-  })) {
-    return 0;
+  var _binaryString$match$l, _binaryString$match;
+  if (!subnetMask) {
+    throw new Error("Subnet mask is required");
   }
-  return (0, _ipToBinaryString.ipToBinaryString)(subnetMask).match(/1/g).length;
+
+  // Parse octets and validate format
+  var octets = subnetMask.split(".");
+  if (octets.length !== 4) {
+    throw new Error("Invalid subnet mask format");
+  }
+
+  // Validate each octet
+  var binaryOctets = octets.map(function (octet) {
+    var number_ = Number.parseInt(octet);
+    if (Number.isNaN(number_) || number_ < 0 || number_ > 255) {
+      throw new Error("Invalid subnet mask format");
+    }
+    return number_.toString(2).padStart(8, "0");
+  });
+
+  // Join octets and count consecutive 1s
+  var binaryString = binaryOctets.join("");
+  var match = binaryString.match(/^1*0*$/);
+  if (!match) {
+    throw new Error("Invalid subnet mask: must be consecutive 1s followed by 0s");
+  }
+
+  // Count 1s
+  var cidr = (_binaryString$match$l = (_binaryString$match = binaryString.match(/1/g)) === null || _binaryString$match === void 0 ? void 0 : _binaryString$match.length) !== null && _binaryString$match$l !== void 0 ? _binaryString$match$l : 0;
+  return cidr;
 };

package/module/es5/Math/addition.d.ts

@@ -1,7 +1,7 @@
 /**
- * 誤差のない足し算
- * @param  {number[]} numbers
- * @returns number
+ * Addition without floating point errors
+ * @param  {number[]} numbers Numbers to add
+ * @returns number Sum of the numbers
  * @example addition(0.1, 0.2); // 0.3
  */
 export declare const addition: (...numbers: number[]) => number;

package/module/es5/Math/addition.js

@@ -14,9 +14,9 @@ function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Sym
 function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 /**
- * 誤差のない足し算
- * @param  {number[]} numbers
- * @returns number
+ * Addition without floating point errors
+ * @param  {number[]} numbers Numbers to add
+ * @returns number Sum of the numbers
  * @example addition(0.1, 0.2); // 0.3
  */
 var addition = exports.addition = function addition() {

package/module/es5/Math/average.d.ts

@@ -1,7 +1,10 @@
 /**
- * 平均値
- * @param  {number[]} numbers
- * @returns number
- * @example average([1, 2, 3]); // 2
+ * Calculates the arithmetic mean of an array of numbers
+ * @param  {number[]} numbers - Array of numbers to average
+ * @returns {number} The arithmetic mean, returns 0 for empty array
+ * @example
+ * average([1, 2, 3]); // 2
+ * average([10, 20]); // 15
+ * average([]); // 0
  */
 export declare const average: (numbers: number[]) => number;

package/module/es5/Math/average.js

@@ -7,10 +7,13 @@ exports.average = void 0;
 var _addition = require("./addition");
 var _division = require("./division");
 /**
- * 平均値
- * @param  {number[]} numbers
- * @returns number
- * @example average([1, 2, 3]); // 2
+ * Calculates the arithmetic mean of an array of numbers
+ * @param  {number[]} numbers - Array of numbers to average
+ * @returns {number} The arithmetic mean, returns 0 for empty array
+ * @example
+ * average([1, 2, 3]); // 2
+ * average([10, 20]); // 15
+ * average([]); // 0
  */
 var average = exports.average = function average(numbers) {
   if (numbers.length === 0) {

package/module/es5/Math/bitwise.d.ts

@@ -1,9 +1,9 @@
 /**
- * ビット回転を行う関数
- * @param x 回転させる32ビット整数
- * @param k 回転するビット数
- * @param direction 回転方向 ('left' または 'right')
- * @returns 指定された方向にkビット回転された結果
+ * Performs bit rotation on a number
+ * @param x 32-bit integer to rotate
+ * @param k Number of bits to rotate
+ * @param direction Direction of rotation ('left' or 'right')
+ * @returns The result after rotating k bits in the specified direction
  * @example
  * const resultLeft = bitwise(0x12345678, 8);
  * console.log(resultLeft.toString(16)); // '34567812'

package/module/es5/Math/bitwise.js

@@ -5,11 +5,11 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.bitwise = void 0;
 /**
- * ビット回転を行う関数
- * @param x 回転させる32ビット整数
- * @param k 回転するビット数
- * @param direction 回転方向 ('left' または 'right')
- * @returns 指定された方向にkビット回転された結果
+ * Performs bit rotation on a number
+ * @param x 32-bit integer to rotate
+ * @param k Number of bits to rotate
+ * @param direction Direction of rotation ('left' or 'right')
+ * @returns The result after rotating k bits in the specified direction
  * @example
  * const resultLeft = bitwise(0x12345678, 8);
  * console.log(resultLeft.toString(16)); // '34567812'

package/module/es5/Math/calculator/calculator.d.ts

@@ -1,10 +1,12 @@
 /**
- * 電卓
- * ()や符号に対応
- * 一文字までの方程式に対応
- * @param  {string} expression 計算式または方程式
- * @param  {object} exchange 為替
- * @returns 計算結果
- * @example calculator("1+2"); // 3
+ * Calculator function that handles mathematical expressions and simple equations
+ * Supports parentheses, signs, and currency conversion
+ * Handles simple equations with single-character variables
+ * @param {string} expression - Mathematical expression or equation
+ * @param {object} exchange - Exchange rates for currency conversion
+ * @returns {string} Calculation result
+ * @example calculator("1+2"); // "3"
+ * @example calculator("(2+3)*4"); // "20"
+ * @example calculator("x=5"); // "x=5"
  */
 export declare const calculator: <T extends Record<string, string | number>>(expression: string, exchange?: T) => string;

package/module/es5/Math/calculator/calculator.js

@@ -7,13 +7,15 @@ exports.calculator = void 0;
 var _core = require("./core");
 var _literalExpression = require("./literalExpression");
 /**
- * 電卓
- * ()や符号に対応
- * 一文字までの方程式に対応
- * @param  {string} expression 計算式または方程式
- * @param  {object} exchange 為替
- * @returns 計算結果
- * @example calculator("1+2"); // 3
+ * Calculator function that handles mathematical expressions and simple equations
+ * Supports parentheses, signs, and currency conversion
+ * Handles simple equations with single-character variables
+ * @param {string} expression - Mathematical expression or equation
+ * @param {object} exchange - Exchange rates for currency conversion
+ * @returns {string} Calculation result
+ * @example calculator("1+2"); // "3"
+ * @example calculator("(2+3)*4"); // "20"
+ * @example calculator("x=5"); // "x=5"
  */
 var calculator = exports.calculator = function calculator(expression, exchange) {
   var cleanExpression = expression.replaceAll(/\s+/g, "");

package/module/es5/Math/calculator/calculatorInitialization.d.ts

@@ -1,8 +1,9 @@
 /**
- * 電卓関数を初期化する
- * @param {object} exchange - 為替レート
- * @return {Function} - calculator
+ * Initializes a calculator function with exchange rates
+ * @param {object} exchange - Exchange rates object
+ * @return {Function} - Configured calculator function
  * @example calculatorInitialization({ $: 100 })("$1"); // "100"
+ * @example calculatorInitialization({ EUR: 1.2 })("EUR5 + 10"); // "16"
  */
 export declare const calculatorInitialization: <T extends {
     [key: string]: string | number;

package/module/es5/Math/calculator/calculatorInitialization.js

@@ -6,15 +6,16 @@ Object.defineProperty(exports, "__esModule", {
 exports.calculatorInitialization = void 0;
 var _calculator = require("./calculator");
 /**
- * 電卓関数を初期化する
- * @param {object} exchange - 為替レート
- * @return {Function} - calculator
+ * Initializes a calculator function with exchange rates
+ * @param {object} exchange - Exchange rates object
+ * @return {Function} - Configured calculator function
  * @example calculatorInitialization({ $: 100 })("$1"); // "100"
+ * @example calculatorInitialization({ EUR: 1.2 })("EUR5 + 10"); // "16"
  */
 var calculatorInitialization = exports.calculatorInitialization = function calculatorInitialization(exchange) {
   /**
-   * @param {string} x - 金額
-   * @return {string} - 計算結果
+   * @param {string} x - Expression to calculate
+   * @return {string} - Calculation result
    */
   return function (x) {
     return (0, _calculator.calculator)(x, exchange);

package/module/es5/Math/calculator/convertCurrency.d.ts

@@ -1,10 +1,12 @@
 /**
- * 文字列内の通貨記号を利用して通貨を換算する。
+ * Converts currency amounts in a string using currency symbols.
  *
- * @param inputString - 換算する通貨額を含む文字列
- * @param conversionRates - 通貨記号と換算レートのオブジェクト
- * @returns 換算後の通貨額を文字列で返す。換算できない場合は元の文字列を返す。
+ * @param {string} inputString - String containing a currency amount to convert
+ * @param {object} conversionRates - Object mapping currency symbols to conversion rates
+ * @returns {string} Converted currency amount as a string, or the original string if conversion is not possible
  * @example convertCurrency("¥100", { "¥": 0.01 }); // "1"
+ * @example convertCurrency("$50", { "$": 1.2 }); // "60"
+ * @example convertCurrency("€200", { "€": 1.1 }); // "220"
  */
 export declare const convertCurrency: <T extends {
     [key: string]: number | string;

package/module/es5/Math/calculator/convertCurrency.js

@@ -7,12 +7,14 @@ exports.convertCurrency = void 0;
 var _multiplication = require("@/Math/multiplication");
 var _isNumber = require("@/Validate/isNumber");
 /**
- * 文字列内の通貨記号を利用して通貨を換算する。
+ * Converts currency amounts in a string using currency symbols.
  *
- * @param inputString - 換算する通貨額を含む文字列
- * @param conversionRates - 通貨記号と換算レートのオブジェクト
- * @returns 換算後の通貨額を文字列で返す。換算できない場合は元の文字列を返す。
+ * @param {string} inputString - String containing a currency amount to convert
+ * @param {object} conversionRates - Object mapping currency symbols to conversion rates
+ * @returns {string} Converted currency amount as a string, or the original string if conversion is not possible
  * @example convertCurrency("¥100", { "¥": 0.01 }); // "1"
+ * @example convertCurrency("$50", { "$": 1.2 }); // "60"
+ * @example convertCurrency("€200", { "€": 1.1 }); // "220"
  */
 var convertCurrency = exports.convertCurrency = function convertCurrency(inputString, conversionRates) {
   if (!conversionRates) {