umt 2.1.2 → 2.2.0

package/module/es5/Date/format.js

@@ -7,10 +7,36 @@ exports.format = void 0;
 var _getTimezoneOffsetString = require("@/Date/getTimezoneOffsetString");
 var _padStart = require("@/String/padStart");
 /**
- * 日時を指定されたフォーマットに従って文字列に変換します。
- * @param {Date} date - 対象の日時オブジェクト
- * @param {string} formatString - フォーマット文字列
- * @return {string} - フォーマットされた日時文字列
+ * Converts a date to a string according to the specified format pattern.
+ * @param {Date} date - The date object to format
+ * @param {string} formatString - The format pattern string (default: "YYYY-MM-DDTHH:mm:ssZ")
+ * @return {string} - The formatted date string
+ * @example
+ * format(new Date('2025-04-04'), 'YYYY-MM-DD') // Returns "2025-04-04"
+ * format(new Date('2025-04-04T15:30:00'), 'HH:mm') // Returns "15:30"
+ * format(new Date('2025-04-04'), 'MM/DD/YYYY') // Returns "04/04/2025"
+ *
+ * Available format tokens:
+ * - YYYY: Full year (e.g., 2025)
+ * - YY: Short year (e.g., 25)
+ * - MM: Month with leading zero (01-12)
+ * - M: Month without leading zero (1-12)
+ * - DD: Day with leading zero (01-31)
+ * - D: Day without leading zero (1-31)
+ * - d: Day of week (0-6)
+ * - HH: Hours with leading zero (00-23)
+ * - H: Hours without leading zero (0-23)
+ * - hh: Hours (12-hour) with leading zero (01-12)
+ * - h: Hours (12-hour) without leading zero (1-12)
+ * - mm: Minutes with leading zero (00-59)
+ * - m: Minutes without leading zero (0-59)
+ * - ss: Seconds with leading zero (00-59)
+ * - s: Seconds without leading zero (0-59)
+ * - SSS: Milliseconds with leading zeros (000-999)
+ * - A: AM/PM
+ * - a: am/pm
+ * - Z: Timezone offset (+09:00)
+ * - ZZ: Timezone offset without colon (+0900)
  */
 var format = exports.format = function format(date) {
   var formatString = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "YYYY-MM-DDTHH:mm:ssZ";

package/module/es5/Date/getDay.d.ts

@@ -7,11 +7,14 @@ interface DayList {
     fr: ["Dim", "Lun", "Mar", "Mer", "Jeu", "Ven", "Sam"];
 }
 /**
- * 数値を曜日に変換する
- * @param day 曜日を表す数値
- * @param lang 言語
- * @returns langに応じた曜日
- * @example getDay(0); // "日"
+ * Convert a number to a day of the week in the specified language
+ * @param day Number representing the day (0-6, where 0 is Sunday)
+ * @param lang Language code ('de', 'ko', 'en', 'ja', 'fr')
+ * @returns Day of the week string in the specified language
+ * @example
+ * getDay(0); // Returns "日" (default is Japanese)
+ * getDay(0, "en"); // Returns "Sun"
+ * getDay(1, "fr"); // Returns "Lun"
  */
 export declare const getDay: <T extends keyof DayList>(day: number, lang?: T) => ArrayToUnion<DayList[T]>;
 export {};

package/module/es5/Date/getDay.js

@@ -5,11 +5,14 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.getDay = void 0;
 /**
- * 数値を曜日に変換する
- * @param day 曜日を表す数値
- * @param lang 言語
- * @returns langに応じた曜日
- * @example getDay(0); // "日"
+ * Convert a number to a day of the week in the specified language
+ * @param day Number representing the day (0-6, where 0 is Sunday)
+ * @param lang Language code ('de', 'ko', 'en', 'ja', 'fr')
+ * @returns Day of the week string in the specified language
+ * @example
+ * getDay(0); // Returns "日" (default is Japanese)
+ * getDay(0, "en"); // Returns "Sun"
+ * getDay(1, "fr"); // Returns "Lun"
  */
 var getDay = exports.getDay = function getDay(day) {
   var lang = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "ja";

package/module/es5/Date/getTimezoneOffsetString.d.ts

@@ -1,6 +1,6 @@
 /**
- * タイムゾーンのオフセット文字列を取得します。
- * @param {Date} instance - 対象の日時オブジェクト
- * @return {string} - タイムゾーンのオフセット文字列
+ * Get timezone offset string in format "+HH:mm" or "-HH:mm"
+ * @param {Date} instance - The date object to get timezone offset from
+ * @return {string} - The timezone offset string (e.g. "+09:00" for JST)
  */
 export declare const getTimezoneOffsetString: (instance: Date) => string;

package/module/es5/Date/getTimezoneOffsetString.js

@@ -6,9 +6,9 @@ Object.defineProperty(exports, "__esModule", {
 exports.getTimezoneOffsetString = void 0;
 var _padStart = require("@/String/padStart");
 /**
- * タイムゾーンのオフセット文字列を取得します。
- * @param {Date} instance - 対象の日時オブジェクト
- * @return {string} - タイムゾーンのオフセット文字列
+ * Get timezone offset string in format "+HH:mm" or "-HH:mm"
+ * @param {Date} instance - The date object to get timezone offset from
+ * @return {string} - The timezone offset string (e.g. "+09:00" for JST)
  */
 var getTimezoneOffsetString = exports.getTimezoneOffsetString = function getTimezoneOffsetString(instance) {
   var negMinutes = -instance.getTimezoneOffset();

package/module/es5/Date/isLeapYear.d.ts

@@ -1,6 +1,11 @@
 /**
- * 与えられた年が閏年かどうかを判定する
- * @param {number} year - 判定する年
- * @returns {boolean} 閏年であればtrue、そうでなければfalse
+ * Determine if a given year is a leap year
+ * @param {number} year - The year to check
+ * @returns {boolean} true if the year is a leap year, false otherwise
+ * @example
+ * isLeapYear(2000); // Returns true (divisible by 400)
+ * isLeapYear(2020); // Returns true (divisible by 4 but not 100)
+ * isLeapYear(2100); // Returns false (divisible by 100 but not 400)
+ * isLeapYear(2023); // Returns false (not divisible by 4)
  */
 export declare const isLeapYear: (year: number) => boolean;

package/module/es5/Date/isLeapYear.js

@@ -5,9 +5,14 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.isLeapYear = void 0;
 /**
- * 与えられた年が閏年かどうかを判定する
- * @param {number} year - 判定する年
- * @returns {boolean} 閏年であればtrue、そうでなければfalse
+ * Determine if a given year is a leap year
+ * @param {number} year - The year to check
+ * @returns {boolean} true if the year is a leap year, false otherwise
+ * @example
+ * isLeapYear(2000); // Returns true (divisible by 400)
+ * isLeapYear(2020); // Returns true (divisible by 4 but not 100)
+ * isLeapYear(2100); // Returns false (divisible by 100 but not 400)
+ * isLeapYear(2023); // Returns false (not divisible by 4)
  */
 var isLeapYear = exports.isLeapYear = function isLeapYear(year) {
   return year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;

package/module/es5/Date/new.d.ts

@@ -11,27 +11,27 @@ import type { DayTypeInt } from "$/date/dayTypeInt";
 import type { MonTypeInt } from "$/date/monTypeInt";
 import type { MonTypeZero } from "$/date/monTypeZero";
 /**
- * 日付を生成する
- * @param year
- * @param mon
- * @param day
- * @param hours
- * @param minutes
- * @param seconds
- * @param milliseconds
- * @returns Date
- * @example newDateInt(2021, 1, 1); // 2021-01-01T00:00:00.000Z
+ * Create a new Date object from numeric values
+ * @param year - The year
+ * @param mon - The month (1-12)
+ * @param day - The day of the month
+ * @param hours - Hours offset from UTC (defaults to local timezone offset)
+ * @param minutes - Minutes (0-59)
+ * @param seconds - Seconds (0-59)
+ * @param milliseconds - Milliseconds (0-999)
+ * @returns Date object
+ * @example newDateInt(2021, 1, 1); // Creates date for January 1, 2021
  */
 export declare const newDateInt: <T extends MonTypeInt>(year: number, mon: T, day: DayTypeInt<T>, hours?: HoursTypeInt, minutes?: MinutesTypeInt, seconds?: SecondsTypeInt, milliseconds?: MillisecondsTypeInt) => Date;
 /**
- * 日付を生成する
- * @param date "2021-01-01"
- * @param hours
- * @param minutes
- * @param seconds
- * @param miliSeconds
- * @param timeDifference
- * @returns Date
- * @example newDateString("2021-01-01"); // 2021-01-01T00:00:00.000Z
+ * Create a new Date object from a string date and time components
+ * @param date - Date string in format "YYYY-MM-DD"
+ * @param hours - Hours in "HH" format (00-23)
+ * @param minutes - Minutes in "mm" format (00-59)
+ * @param seconds - Seconds in "ss" format (00-59)
+ * @param milliseconds - Milliseconds in "mmm" format (000-999)
+ * @param timeDifference - Timezone offset in "HH" format (e.g., "09" for UTC+9)
+ * @returns Date object
+ * @example newDateString("2021-01-01"); // Creates date for January 1, 2021 00:00:00
  */
-export declare const newDateString: <T extends MonTypeZero>(date: `${number}-${T}-${DayType<T>}`, hours?: HoursType, minutes?: MinutesType, seconds?: SecondsType, miliSeconds?: MillisecondsType, timeDifference?: HoursType) => Date;
+export declare const newDateString: <T extends MonTypeZero>(date: `${number}-${T}-${DayType<T>}`, hours?: HoursType, minutes?: MinutesType, seconds?: SecondsType, milliseconds?: MillisecondsType, timeDifference?: HoursType) => Date;

package/module/es5/Date/new.js

@@ -5,16 +5,16 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.newDateString = exports.newDateInt = void 0;
 /**
- * 日付を生成する
- * @param year
- * @param mon
- * @param day
- * @param hours
- * @param minutes
- * @param seconds
- * @param milliseconds
- * @returns Date
- * @example newDateInt(2021, 1, 1); // 2021-01-01T00:00:00.000Z
+ * Create a new Date object from numeric values
+ * @param year - The year
+ * @param mon - The month (1-12)
+ * @param day - The day of the month
+ * @param hours - Hours offset from UTC (defaults to local timezone offset)
+ * @param minutes - Minutes (0-59)
+ * @param seconds - Seconds (0-59)
+ * @param milliseconds - Milliseconds (0-999)
+ * @returns Date object
+ * @example newDateInt(2021, 1, 1); // Creates date for January 1, 2021
  */
 var newDateInt = exports.newDateInt = function newDateInt(year, mon, day) {
   var hours = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : -new Date().getTimezoneOffset() / 60;
@@ -26,21 +26,21 @@ var newDateInt = exports.newDateInt = function newDateInt(year, mon, day) {
 };
 
 /**
- * 日付を生成する
- * @param date "2021-01-01"
- * @param hours
- * @param minutes
- * @param seconds
- * @param miliSeconds
- * @param timeDifference
- * @returns Date
- * @example newDateString("2021-01-01"); // 2021-01-01T00:00:00.000Z
+ * Create a new Date object from a string date and time components
+ * @param date - Date string in format "YYYY-MM-DD"
+ * @param hours - Hours in "HH" format (00-23)
+ * @param minutes - Minutes in "mm" format (00-59)
+ * @param seconds - Seconds in "ss" format (00-59)
+ * @param milliseconds - Milliseconds in "mmm" format (000-999)
+ * @param timeDifference - Timezone offset in "HH" format (e.g., "09" for UTC+9)
+ * @returns Date object
+ * @example newDateString("2021-01-01"); // Creates date for January 1, 2021 00:00:00
  */
 var newDateString = exports.newDateString = function newDateString(date) {
   var hours = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "00";
   var minutes = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : "00";
   var seconds = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : "00";
-  var miliSeconds = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : "000";
+  var milliseconds = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : "000";
   var timeDifference = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : "00";
-  return new Date("".concat(date, "T").concat(hours, ":").concat(minutes, ":").concat(seconds, ".").concat(miliSeconds, "+").concat(timeDifference, ":00"));
+  return new Date("".concat(date, "T").concat(hours, ":").concat(minutes, ":").concat(seconds, ".").concat(milliseconds, "+").concat(timeDifference, ":00"));
 };

package/module/es5/Date/now.d.ts

@@ -1,8 +1,11 @@
 import type { HoursTypeInt } from "$/clock/hoursTypeInt";
 /**
- * タイムゾーンに関係なく、UTCを基準に指定した時差を加えた現在時刻を取得します。
- * @param {hoursTypeInt} [timeDifference=9] UTCからの時差を指定します。デフォルトは日本時間です。
- * @returns {Date} 現在時刻
- * @example now(); // Date
+ * Get the current time with a specified UTC offset, regardless of the local timezone
+ * @param {hoursTypeInt} [timeDifference=9] Hours offset from UTC (default: 9 for Japan Standard Time)
+ * @returns {Date} Current date and time adjusted for the specified UTC offset
+ * @example
+ * now(); // Returns current time in JST (UTC+9)
+ * now(0); // Returns current time in UTC
+ * now(1); // Returns current time in UTC+1
  */
 export declare const now: (timeDifference?: HoursTypeInt) => Date;

package/module/es5/Date/now.js

@@ -6,10 +6,13 @@ Object.defineProperty(exports, "__esModule", {
 exports.now = void 0;
 var _clock = require("@/Consts/clock");
 /**
- * タイムゾーンに関係なく、UTCを基準に指定した時差を加えた現在時刻を取得します。
- * @param {hoursTypeInt} [timeDifference=9] UTCからの時差を指定します。デフォルトは日本時間です。
- * @returns {Date} 現在時刻
- * @example now(); // Date
+ * Get the current time with a specified UTC offset, regardless of the local timezone
+ * @param {hoursTypeInt} [timeDifference=9] Hours offset from UTC (default: 9 for Japan Standard Time)
+ * @returns {Date} Current date and time adjusted for the specified UTC offset
+ * @example
+ * now(); // Returns current time in JST (UTC+9)
+ * now(0); // Returns current time in UTC
+ * now(1); // Returns current time in UTC+1
  */
 var now = exports.now = function now() {
   var timeDifference = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 9;

package/module/es5/Error/safeExecute.d.ts

@@ -1,11 +1,32 @@
+/**
+ * Represents a successful execution result containing a value
+ * @template V The type of the success value
+ */
 interface SuccessType<V> {
     type: "success";
     value: V;
 }
+/**
+ * Represents an error result containing an error object
+ * @template E The type of the error
+ */
 interface ErrorType<E> {
     type: "error";
     error: E;
 }
+/**
+ * Union type representing either a successful result or an error result
+ * @template V The type of the success value
+ * @template E The type of the error
+ */
 export type Result<V, E> = SuccessType<V> | ErrorType<E>;
+/**
+ * Safely executes a callback function and returns a Result type
+ * Catches any errors and wraps them in a Result type
+ * @template V The type of the success value
+ * @template E The type of the error (defaults to Error)
+ * @param callback The function to execute safely
+ * @returns A Result containing either the successful value or the caught error
+ */
 export declare const safeExecute: <V, E = Error>(callback: () => V) => Result<V, E>;
 export {};

package/module/es5/Error/safeExecute.js

@@ -4,18 +4,54 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.safeExecute = void 0;
+/**
+ * Represents a successful execution result containing a value
+ * @template V The type of the success value
+ */
+
+/**
+ * Represents an error result containing an error object
+ * @template E The type of the error
+ */
+
+/**
+ * Union type representing either a successful result or an error result
+ * @template V The type of the success value
+ * @template E The type of the error
+ */
+
+/**
+ * Creates an error result
+ * @template E The type of the error
+ * @param error The error object
+ * @returns An ErrorType containing the error
+ */
 var errorFunction = function errorFunction(error) {
   return {
     type: "error",
     error: error
   };
 };
+/**
+ * Creates a success result
+ * @template V The type of the success value
+ * @param value The success value
+ * @returns A SuccessType containing the value
+ */
 var successFunction = function successFunction(value) {
   return {
     type: "success",
     value: value
   };
 };
+/**
+ * Safely executes a callback function and returns a Result type
+ * Catches any errors and wraps them in a Result type
+ * @template V The type of the success value
+ * @template E The type of the error (defaults to Error)
+ * @param callback The function to execute safely
+ * @returns A Result containing either the successful value or the caught error
+ */
 var safeExecute = exports.safeExecute = function safeExecute(callback) {
   try {
     return successFunction(callback());

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

@@ -1,6 +1,7 @@
 /**
- * CIDRからサブネットマスクの数値を取得します
- * @param {number} cidr - CIDR
- * @returns {number} サブネットマスクの数値
+ * Converts CIDR notation to a subnet mask number
+ * @param {number} cidr - CIDR notation (0-32)
+ * @returns {number} Subnet mask as a 32-bit number
+ * @throws {Error} If CIDR is not between 0 and 32
  */
 export declare const cidrToLong: (cidr: number) => number;

package/module/es5/IP/cidrToLong.js

@@ -5,10 +5,14 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.cidrToLong = void 0;
 /**
- * CIDRからサブネットマスクの数値を取得します
- * @param {number} cidr - CIDR
- * @returns {number} サブネットマスクの数値
+ * Converts CIDR notation to a subnet mask number
+ * @param {number} cidr - CIDR notation (0-32)
+ * @returns {number} Subnet mask as a 32-bit number
+ * @throws {Error} If CIDR is not between 0 and 32
  */
 var cidrToLong = exports.cidrToLong = function cidrToLong(cidr) {
+  if (!Number.isInteger(cidr) || cidr < 0 || cidr > 32) {
+    throw new Error("CIDR must be an integer between 0 and 32");
+  }
   return Number.parseInt("1".repeat(cidr).padEnd(32, "0"), 2) >>> 0;
 };

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

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

package/module/es5/IP/cidrToSubnetMask.js

@@ -7,9 +7,10 @@ exports.cidrToSubnetMask = void 0;
 var _cidrToLong = require("./cidrToLong");
 var _longToIp = require("./longToIp");
 /**
- * CIDRからサブネットマスクを取得します
- * @param {number} cidr - CIDR
- * @returns {string} サブネットマスク
+ * Converts CIDR notation to a subnet mask
+ * @param {number} cidr - CIDR notation (0-32)
+ * @returns {string} Subnet mask in IPv4 format (e.g., "255.255.255.0")
+ * @throws {Error} If CIDR is not between 0 and 32
  */
 var cidrToSubnetMask = exports.cidrToSubnetMask = function cidrToSubnetMask(cidr) {
   return (0, _longToIp.longToIp)((0, _cidrToLong.cidrToLong)(cidr));

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

@@ -1,6 +1,6 @@
 /**
- * IPクラスを取得します
- * @param {string} ip - IPアドレス
- * @returns {string} IPクラス（A, B, C, D, Eまたは空文字列）
+ * Gets the IP address class (A, B, C, D, or E)
+ * @param {string} ip - IPv4 address
+ * @returns {string} IP class ('A', 'B', 'C', 'D', 'E', or empty string for invalid IP)
  */
 export declare const getIpClass: (ip: string) => string;

package/module/es5/IP/getIpClass.js

@@ -5,30 +5,56 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.getIpClass = void 0;
 /**
- * IPクラスを取得します
- * @param {string} ip - IPアドレス
- * @returns {string} IPクラス（A, B, C, D, Eまたは空文字列）
+ * Gets the IP address class (A, B, C, D, or E)
+ * @param {string} ip - IPv4 address
+ * @returns {string} IP class ('A', 'B', 'C', 'D', 'E', or empty string for invalid IP)
  */
 var getIpClass = exports.getIpClass = function getIpClass(ip) {
   if (!ip) {
     return "";
   }
-  // IPアドレスの最初のオクテットを取得
-  var firstOctet = Number.parseInt(ip.split(".")[0]);
-  if (firstOctet < 128) {
-    return "A";
-  }
-  if (firstOctet < 192) {
-    return "B";
-  }
-  if (firstOctet < 224) {
-    return "C";
+
+  // Validate IP format
+  var parts = ip.split(".");
+  if (parts.length !== 4) {
+    return "";
   }
-  if (firstOctet < 240) {
-    return "D";
+  var firstOctet = Number.parseInt(parts[0]);
+  if (Number.isNaN(firstOctet) || firstOctet < 0 || firstOctet > 255) {
+    return "";
   }
-  if (firstOctet < 256) {
-    return "E";
+
+  // Check each class range
+  switch (true) {
+    case firstOctet === 0:
+      {
+        return "";
+      }
+    // Reserved
+    case firstOctet < 128:
+      {
+        return "A";
+      }
+    // 1-127
+    case firstOctet < 192:
+      {
+        return "B";
+      }
+    // 128-191
+    case firstOctet < 224:
+      {
+        return "C";
+      }
+    // 192-223
+    case firstOctet < 240:
+      {
+        return "D";
+      }
+    // 224-239
+    default:
+      {
+        return "E";
+      }
+    // 240-255
   }
-  return "";
 };

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

@@ -1,7 +1,8 @@
 /**
- * ネットワークアドレスを取得します
- * @param {string} ip - IPアドレス
- * @param {string} subnetMask - サブネットマスク
- * @returns {number} ネットワークアドレス
+ * Calculates the network address from an IP address and subnet mask
+ * @param {string} ip - IPv4 address (e.g., "192.168.1.1")
+ * @param {string} subnetMask - Subnet mask (e.g., "255.255.255.0")
+ * @returns {number} Network address as a 32-bit unsigned integer
+ * @throws {Error} If IP address or subnet mask is invalid
  */
 export declare const getNetworkAddress: (ip: string, subnetMask: string) => number;

package/module/es5/IP/getNetworkAddress.js

@@ -8,12 +8,41 @@ var _cidrToLong = require("./cidrToLong");
 var _ipToLong = require("./ipToLong");
 var _subnetMaskToCidr = require("./subnetMaskToCidr");
 /**
- * ネットワークアドレスを取得します
- * @param {string} ip - IPアドレス
- * @param {string} subnetMask - サブネットマスク
- * @returns {number} ネットワークアドレス
+ * Calculates the network address from an IP address and subnet mask
+ * @param {string} ip - IPv4 address (e.g., "192.168.1.1")
+ * @param {string} subnetMask - Subnet mask (e.g., "255.255.255.0")
+ * @returns {number} Network address as a 32-bit unsigned integer
+ * @throws {Error} If IP address or subnet mask is invalid
  */
 var getNetworkAddress = exports.getNetworkAddress = function getNetworkAddress(ip, subnetMask) {
-  var networkAddress = (0, _ipToLong.ipToLong)(ip) & (0, _cidrToLong.cidrToLong)((0, _subnetMaskToCidr.subnetMaskToCidr)(subnetMask));
-  return networkAddress >>> 0; // 符号なし32ビット整数に変換
+  if (!ip) {
+    throw new Error("IP address is required");
+  }
+  if (!subnetMask) {
+    throw new Error("Subnet mask is required");
+  }
+
+  // Validate IP format
+  var ipParts = ip.split(".");
+  if (ipParts.length !== 4 || !ipParts.every(function (part) {
+    var number_ = Number.parseInt(part);
+    return !Number.isNaN(number_) && number_ >= 0 && number_ <= 255;
+  })) {
+    throw new TypeError("Invalid IP address or subnet mask");
+  }
+
+  // Validate subnet mask format
+  var maskParts = subnetMask.split(".");
+  if (maskParts.length !== 4 || !maskParts.every(function (part) {
+    var number_ = Number.parseInt(part);
+    return !Number.isNaN(number_) && number_ >= 0 && number_ <= 255;
+  })) {
+    throw new TypeError("Invalid IP address or subnet mask");
+  }
+  try {
+    var networkAddress = (0, _ipToLong.ipToLong)(ip) & (0, _cidrToLong.cidrToLong)((0, _subnetMaskToCidr.subnetMaskToCidr)(subnetMask));
+    return networkAddress >>> 0; // Convert to unsigned 32-bit integer
+  } catch (_unused) {
+    throw new TypeError("Invalid IP address or subnet mask");
+  }
 };

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

@@ -1,6 +1,7 @@
 /**
- * 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
  */
 export declare const ipToBinaryString: (ip: string) => string;