umt 2.1.1 → 2.2.0

package/module/es5/Date/dateRange.js

@@ -6,11 +6,14 @@ Object.defineProperty(exports, "__esModule", {
 exports.dateRange = void 0;
 var _clock = require("@/Consts/clock");
 /**
- * 指定された開始日と終了日の範囲内の全ての日付を含む配列を生成します。
+ * Generate an array containing all dates between the specified start and end dates.
  *
- * @param {Date} startDate - 範囲の開始日
- * @param {Date} endDate - 範囲の終了日
- * @returns {Date[]} startDateからendDateまでの日付を含むDateオブジェクトの配列
+ * @param {Date} startDate - The start date of the range
+ * @param {Date} endDate - The end date of the range
+ * @returns {Date[]} An array of Date objects from startDate to endDate (inclusive)
+ * @example
+ * dateRange(new Date('2025-01-01'), new Date('2025-01-03'))
+ * // Returns array of dates: [2025-01-01, 2025-01-02, 2025-01-03]
  */
 var dateRange = exports.dateRange = function dateRange(startDate, endDate) {
   var dates = [];

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

@@ -2,10 +2,10 @@ import type { HoursTypeInt } from "$/clock/hoursTypeInt";
 import type { DayTypeInt } from "$/date/dayTypeInt";
 import type { MonTypeInt } from "$/date/monTypeInt";
 /**
- * 曜日を取得する
- * @param properties
- * @param timeDifference
- * @returns number
+ * Get the day of the week
+ * @param properties Object containing year, month, and day
+ * @param timeDifference Time difference from UTC in hours (default: 9)
+ * @returns A number representing the day of the week (0 = Sunday, 6 = Saturday)
  * @example dayOfWeek({ year: 2000, mon: 1, day: 1 });
  */
 export declare const dayOfWeek: <T extends MonTypeInt>(properties?: {

package/module/es5/Date/dayOfWeek.js

@@ -7,10 +7,10 @@ exports.dayOfWeek = void 0;
 var _new = require("@/Date/new");
 var _now = require("@/Date/now");
 /**
- * 曜日を取得する
- * @param properties
- * @param timeDifference
- * @returns number
+ * Get the day of the week
+ * @param properties Object containing year, month, and day
+ * @param timeDifference Time difference from UTC in hours (default: 9)
+ * @returns A number representing the day of the week (0 = Sunday, 6 = Saturday)
  * @example dayOfWeek({ year: 2000, mon: 1, day: 1 });
  */
 var dayOfWeek = exports.dayOfWeek = function dayOfWeek(properties) {

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

@@ -1,7 +1,33 @@
 /**
- * 日時を指定されたフォーマットに従って文字列に変換します。
- * @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)
  */
 export declare const format: (date: Date, formatString?: string) => string;

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;