@simplysm/core-common 13.0.69 → 13.0.71

package/README.md

@@ -1,277 +1,76 @@
 # @simplysm/core-common
 
-A common utility package for the Simplysm framework. As a neutral base module usable in both Node.js and browser environments, it provides date/time types, error classes, object/array/string utilities, JSON serialization, ZIP processing, prototype extensions, and more.
+Simplysm package - Core module (common)
 
 ## Installation
 
-```bash
-npm install @simplysm/core-common
-# or
 pnpm add @simplysm/core-common
-```
 
-### Initialization
-
-Import the package at your application entry point (e.g., `index.ts`, `main.ts`):
-
-```typescript
-import "@simplysm/core-common";
-```
-
-This import globally activates Array, Map, and Set prototype extensions.
-To use extension methods (`getOrCreate()`, `toggle()`, etc.), you must import this at app startup.
-
-## Main Modules
-
-### Errors
-
-- [`SdError`](docs/types.md#sderror) - Base error class with cause chain tracking
-- [`ArgumentError`](docs/types.md#argumenterror) - Argument validation error with YAML formatting
-- [`NotImplementedError`](docs/types.md#notimplementederror) - Indicates unimplemented functionality
-- [`TimeoutError`](docs/types.md#timeouterror) - Timeout error
-
-### Custom Types
-
-- [`DateTime`](docs/types.md#datetime) - Date + time (millisecond precision, local timezone)
-- [`DateOnly`](docs/types.md#dateonly) - Date only (no time)
-- [`Time`](docs/types.md#time) - Time only (no date, 24-hour cycle)
-- [`Uuid`](docs/types.md#uuid) - UUID v4 (cryptographically secure)
-- [`LazyGcMap`](docs/types.md#lazygcmap) - Map with auto-expiration (LRU style)
-
-### Features
-
-- [`DebounceQueue`](docs/features.md#debouncequeue) - Async debounce queue (executes only last request)
-- [`SerialQueue`](docs/features.md#serialqueue) - Async serial queue (sequential execution)
-- [`EventEmitter`](docs/features.md#eventemitter) - EventTarget wrapper with type-safe events
-
-### ZIP
-
-- [`ZipArchive`](docs/features.md#ziparchive) - ZIP file compression/decompression utility
-
-### Object Utilities
-
-- [`objClone`](docs/utils.md#objclone) - Deep clone (supports circular references, custom types)
-- [`objEqual`](docs/utils.md#objequal) - Deep comparison with options
-- [`objMerge`](docs/utils.md#objmerge) - Deep merge (source + target)
-- [`objMerge3`](docs/utils.md#objmerge3) - 3-way merge with conflict detection
-- [`objOmit`](docs/utils.md#objomit) - Exclude specific keys
-- [`objOmitByFilter`](docs/utils.md#objomitbyfilter) - Exclude keys matching a predicate
-- [`objPick`](docs/utils.md#objpick) - Select specific keys
-- [`objGetChainValue`](docs/utils.md#objgetchainvalue) - Query value by chain path
-- [`objGetChainValueByDepth`](docs/utils.md#objgetchainvaluebydepth) - Query value by descending the same key repeatedly
-- [`objSetChainValue`](docs/utils.md#objsetchainvalue) - Set value by chain path
-- [`objDeleteChainValue`](docs/utils.md#objdeletechainvalue) - Delete value by chain path
-- [`objClearUndefined`](docs/utils.md#objclearundefined) - Delete keys with `undefined` values (mutates original)
-- [`objClear`](docs/utils.md#objclear) - Delete all keys from an object (mutates original)
-- [`objNullToUndefined`](docs/utils.md#objnulltoundefined) - Recursively convert null to undefined (mutates original)
-- [`objUnflatten`](docs/utils.md#objunflatten) - Convert dot-notation flat object to nested object
-- [`objKeys`](docs/utils.md#objkeys) - Type-safe `Object.keys`
-- [`objEntries`](docs/utils.md#objentries) - Type-safe `Object.entries`
-- [`objFromEntries`](docs/utils.md#objfromentries) - Type-safe `Object.fromEntries`
-- [`objMap`](docs/utils.md#objmap) - Transform each entry of object
-
-### JSON Utilities
-
-- [`jsonStringify`](docs/utils.md#jsonstringify) - JSON serialization with custom type support
-- [`jsonParse`](docs/utils.md#jsonparse) - JSON deserialization with custom type restoration
-
-### XML Utilities
-
-- [`xmlParse`](docs/utils.md#xmlparse) - Parse XML string to object
-- [`xmlStringify`](docs/utils.md#xmlstringify) - Serialize object to XML string
-
-### String Utilities
-
-- [`strGetSuffix`](docs/utils.md#strgetsuffix) - Korean postposition handling
-- [`strReplaceFullWidth`](docs/utils.md#strreplacefullwidth) - Convert full-width to half-width
-- [`strToPascalCase`](docs/utils.md#strtopascalcase) - PascalCase conversion
-- [`strToCamelCase`](docs/utils.md#strtocamelcase) - camelCase conversion
-- [`strToKebabCase`](docs/utils.md#strtokebabcase) - kebab-case conversion
-- [`strToSnakeCase`](docs/utils.md#strtosnakecase) - snake_case conversion
-- [`strIsNullOrEmpty`](docs/utils.md#strisnullorempty) - Check for undefined/null/empty (type guard)
-- [`strInsert`](docs/utils.md#strinsert) - Insert at position in string
-
-### Number Utilities
-
-- [`numParseInt`](docs/utils.md#numparseint) - Parse string to integer
-- [`numParseFloat`](docs/utils.md#numparsefloat) - Parse string to float
-- [`numParseRoundedInt`](docs/utils.md#numparseroundedint) - Round float and return integer
-- [`numFormat`](docs/utils.md#numformat) - Thousands separator formatting
-- [`numIsNullOrEmpty`](docs/utils.md#numisnullorempty) - Check for undefined/null/0 (type guard)
-
-### Date/Time Formatting
-
-- [`formatDate`](docs/utils.md#formatdate) - Convert date/time to formatted string
-- [`normalizeMonth`](docs/utils.md#normalizemonth) - Normalize year/month/day when setting month
-- [`convert12To24`](docs/utils.md#convert12to24) - Convert 12-hour to 24-hour format
-
-### Byte Utilities
-
-- [`bytesConcat`](docs/utils.md#bytesconcat) - Concatenate multiple Uint8Arrays
-- [`bytesToHex`](docs/utils.md#bytestohex) - Convert Uint8Array to hex string
-- [`bytesFromHex`](docs/utils.md#bytesfromhex) - Convert hex string to Uint8Array
-- [`bytesToBase64`](docs/utils.md#bytestobase64) - Convert Uint8Array to base64 string
-- [`bytesFromBase64`](docs/utils.md#bytesfrombase64) - Convert base64 string to Uint8Array
-
-### Async Wait
-
-- [`waitTime`](docs/utils.md#waittime) - Wait for specified time
-- [`waitUntil`](docs/utils.md#waituntil) - Wait until condition is true
-
-### Worker Data Conversion
-
-- [`transferableEncode`](docs/utils.md#transferableencode) - Serialize custom types for Worker transfer
-- [`transferableDecode`](docs/utils.md#transferabledecode) - Deserialize Worker data to custom types
-
-### Path Utilities
-
-- [`pathJoin`](docs/utils.md#pathjoin) - Combine paths (POSIX-style only)
-- [`pathBasename`](docs/utils.md#pathbasename) - Extract filename
-- [`pathExtname`](docs/utils.md#pathextname) - Extract extension
-
-### Template Literal Tags
-
-- [`js`](docs/utils.md#js) - JavaScript code highlighting
-- [`ts`](docs/utils.md#ts) - TypeScript code highlighting
-- [`html`](docs/utils.md#html) - HTML markup highlighting
-- [`tsql`](docs/utils.md#tsql) - MSSQL T-SQL highlighting
-- [`mysql`](docs/utils.md#mysql) - MySQL SQL highlighting
-- [`pgsql`](docs/utils.md#pgsql) - PostgreSQL SQL highlighting
-
-### Other Utilities
-
-- [`getPrimitiveTypeStr`](docs/utils.md#getprimitivetypestr) - Infer `PrimitiveTypeStr` from runtime value
-- [`env`](docs/utils.md#env) - Environment variable object
-
-### Array Extensions
-
-#### Query
-- [`single`](docs/extensions.md#single) - Return single element (error if 2+)
-- [`first`](docs/extensions.md#first) - Return first element
-- [`last`](docs/extensions.md#last) - Return last element
-
-#### Filtering
-- [`filterExists`](docs/extensions.md#filterexists) - Remove `null`/`undefined`
-- [`ofType`](docs/extensions.md#oftype) - Filter by type
-- [`filterAsync`](docs/extensions.md#filterasync) - Async filter
-
-#### Mapping/Transformation
-- [`mapAsync`](docs/extensions.md#mapasync) - Async mapping (sequential)
-- [`mapMany`](docs/extensions.md#mapmany) - Flatten nested arrays and remove null/undefined
-- [`mapManyAsync`](docs/extensions.md#mapmanyasync) - Async mapMany
-- [`parallelAsync`](docs/extensions.md#parallelasync) - Parallel async mapping
-
-#### Grouping
-- [`groupBy`](docs/extensions.md#groupby) - Group by key
-- [`toMap`](docs/extensions.md#tomap) - Convert to Map
-- [`toMapAsync`](docs/extensions.md#tomapasync) - Async Map conversion
-- [`toArrayMap`](docs/extensions.md#toarraymap) - Convert to `Map<K, V[]>`
-- [`toSetMap`](docs/extensions.md#tosetmap) - Convert to `Map<K, Set<V>>`
-- [`toMapValues`](docs/extensions.md#tomapvalues) - Aggregate Map by group
-- [`toObject`](docs/extensions.md#toobject) - Convert to `Record<string, V>`
-- [`toTree`](docs/extensions.md#totree) - Convert to tree structure
-
-#### Deduplication
-- [`distinct`](docs/extensions.md#distinct) - Remove duplicates (new array)
-- [`distinctThis`](docs/extensions.md#distinctthis) - Remove duplicates (modify original)
-
-#### Sorting
-- [`orderBy`](docs/extensions.md#orderby) - Ascending sort (new array)
-- [`orderByDesc`](docs/extensions.md#orderbydesc) - Descending sort (new array)
-- [`orderByThis`](docs/extensions.md#orderbythis) - Ascending sort (modify original)
-- [`orderByDescThis`](docs/extensions.md#orderbydescthis) - Descending sort (modify original)
-
-#### Comparison/Merging
-- [`diffs`](docs/extensions.md#diffs) - Compare differences between arrays
-- [`oneWayDiffs`](docs/extensions.md#onewaydiffs) - One-way diff comparison
-- [`merge`](docs/extensions.md#merge) - Merge arrays
-
-#### Aggregation
-- [`sum`](docs/extensions.md#sum) - Sum
-- [`min`](docs/extensions.md#min) - Minimum
-- [`max`](docs/extensions.md#max) - Maximum
-
-#### Mutation
-- [`insert`](docs/extensions.md#insert) - Insert at specific position
-- [`remove`](docs/extensions.md#remove) - Remove item or items matching predicate
-- [`toggle`](docs/extensions.md#toggle) - Toggle item
-- [`clear`](docs/extensions.md#clear) - Remove all items
-- [`shuffle`](docs/extensions.md#shuffle) - Shuffle array
-
-### Map Extensions
-
-- [`getOrCreate`](docs/extensions.md#getorcreate) - Get or create and return value
-- [`update`](docs/extensions.md#update) - Update value using function
-
-### Set Extensions
-
-- [`adds`](docs/extensions.md#adds) - Add multiple values at once
-- [`toggle`](docs/extensions.md#toggle-1) - Toggle value (add/remove/force)
-
-## Types
-
-- [`Bytes`](docs/types.md#bytes) - Alias for `Uint8Array`
-- [`PrimitiveTypeStr`](docs/types.md#primitivetypestr) - Primitive type string keys
-- [`PrimitiveTypeMap`](docs/types.md#primitivetypemap) - Mapping from type string to type
-- [`PrimitiveType`](docs/types.md#primitivetype) - Union of all primitive types (includes `undefined`)
-- [`DeepPartial`](docs/types.md#deeppartial) - Recursively convert properties to optional
-- [`Type`](docs/types.md#type) - Constructor type
-- [`ObjUndefToOptional`](docs/types.md#objundeftooptional) - Convert `undefined` properties to optional
-- [`ObjOptionalToUndef`](docs/types.md#objoptionaltoundef) - Convert optional properties to `required + undefined`
-- [`EqualOptions`](docs/types.md#equaloptions) - Options for `objEqual`
-- [`ObjMergeOptions`](docs/types.md#objmergeoptions) - Options for `objMerge`
-- [`ObjMerge3KeyOptions`](docs/types.md#objmerge3keyoptions) - Per-key options for `objMerge3`
-- [`DtNormalizedMonth`](docs/types.md#dtnormalizedmonth) - Return type of `normalizeMonth`
-- [`ZipArchiveProgress`](docs/types.md#ziparchiveprogress) - Progress info for `ZipArchive.extractAll`
-- [`ArrayDiffsResult`](docs/types.md#arraydiffsresult) - Result type of `Array.diffs()`
-- [`ArrayDiffs2Result`](docs/types.md#arraydiffs2result) - Result type of `Array.oneWayDiffs()`
-- [`TreeArray`](docs/types.md#treearray) - Result type of `Array.toTree()`
-- [`ComparableType`](docs/types.md#comparabletype) - Union of types usable for sorting/comparison
-
-## Caveats
-
-### Prototype Extension Conflicts
-
-This package extends Array, Map, and Set prototypes.
-Conflicts may occur when used with other libraries that extend the same method names.
-In case of conflict, the last defined implementation is applied based on load order.
-
-### Timezone Handling
-
-When using `DateOnly.parse()`, `DateTime.parse()`:
-- `yyyy-MM-dd`, `yyyyMMdd` format: parse directly from string (no timezone influence)
-- ISO 8601 format (`2024-01-15T00:00:00Z`): interpret as UTC then convert to local
-
-When server and client timezones differ, actively use `yyyy-MM-dd` format.
-
-### Memory Management (LazyGcMap)
-
-`LazyGcMap` has an internal GC timer, so it must be cleaned up.
-
-```typescript
-// using statement (recommended)
-// gcInterval: GC execution interval (ms), expireTime: item expiration time (ms)
-using map = new LazyGcMap({ gcInterval: 10000, expireTime: 60000 }); // GC every 10 seconds, expire after 60 seconds
-
-// Or explicit dispose() call
-const map = new LazyGcMap({ gcInterval: 10000, expireTime: 60000 }); // GC every 10 seconds, expire after 60 seconds
-try {
-  // ... use
-} finally {
-  map.dispose();
-}
-```
-
-### jsonStringify's __type__ Reserved Word
-
-`jsonStringify`/`jsonParse` uses objects with `__type__` and `data` keys for type restoration.
-Be careful as user data in the form `{ __type__: "DateTime", data: "..." }` may be unintentionally type-converted.
-
-### Circular References
-
-- `objClone`: supports circular references (tracked with WeakMap)
-- `jsonStringify`: throws TypeError on circular reference
-- `transferableEncode`: throws TypeError on circular reference (includes path information)
+## Source Index
+
+### (top-level)
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/env.ts` | `env` | Runtime environment configuration object | - |
+| `src/extensions/arr-ext.ts` | `ArrayDiffsResult`, `ArrayDiffs2Result`, `TreeArray`, `ComparableType` | Array diff, tree, and comparison utilities via prototype augmentation | `array-extension.spec.ts` |
+
+### errors
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/errors/sd-error.ts` | `SdError` | Base error class with name-based error chain support | `errors.spec.ts` |
+| `src/errors/argument-error.ts` | `ArgumentError` | Error thrown when a function receives an invalid argument | `errors.spec.ts` |
+| `src/errors/not-implemented-error.ts` | `NotImplementedError` | Error indicating an unimplemented method or feature | `errors.spec.ts` |
+| `src/errors/timeout-error.ts` | `TimeoutError` | Error thrown when an operation exceeds its time limit | `errors.spec.ts` |
+
+### types
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/types/uuid.ts` | `Uuid` | UUID v4 generation and validation utility class | `uuid.spec.ts` |
+| `src/types/lazy-gc-map.ts` | `LazyGcMap` | Map with lazy initialization and automatic garbage collection of unused entries | `lazy-gc-map.spec.ts` |
+| `src/types/date-time.ts` | `DateTime` | Immutable date-time class with formatting, arithmetic, and comparison | `date-time.spec.ts` |
+| `src/types/date-only.ts` | `DateOnly` | Immutable date-only class (year, month, day) without time component | `date-only.spec.ts` |
+| `src/types/time.ts` | `Time` | Immutable time-of-day class (hour, minute, second) | `time.spec.ts` |
+
+### features
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/features/debounce-queue.ts` | `DebounceQueue` | Queue that debounces rapid calls into a single delayed execution | `debounce-queue.spec.ts` |
+| `src/features/serial-queue.ts` | `SerialQueue` | Queue that serializes async operations to run one at a time | `serial-queue.spec.ts` |
+| `src/features/event-emitter.ts` | `EventEmitter` | Type-safe event emitter with on/off/emit pattern | `sd-event-emitter.spec.ts` |
+
+### utils
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/utils/date-format.ts` | `DtNormalizedMonth`, `normalizeMonth`, `convert12To24`, `formatDate` | Date formatting and month normalization utilities | `date-format.spec.ts` |
+| `src/utils/bytes.ts` | `bytesConcat`, `bytesToHex`, `bytesFromHex`, `bytesToBase64`, `bytesFromBase64` | Binary conversion utilities (hex, base64, concat) | `bytes-utils.spec.ts` |
+| `src/utils/json.ts` | `jsonStringify`, `jsonParse` | JSON stringify/parse with custom type support (DateTime, DateOnly, etc.) | `json.spec.ts` |
+| `src/utils/num.ts` | `numParseInt`, `numParseRoundedInt`, `numParseFloat`, `numIsNullOrEmpty`, `numFormat` | Number parsing and formatting utilities | `number.spec.ts` |
+| `src/utils/obj.ts` | `objClone`, `EqualOptions`, `objEqual`, `ObjMergeOptions`, `objMerge`, `ObjMerge3KeyOptions`, `objMerge3`, `objOmit`, `objOmitByFilter`, `objPick`, `objGetChainValue`, `objGetChainValueByDepth`, `objSetChainValue`, `objDeleteChainValue`, `objClearUndefined`, `objClear`, `objNullToUndefined`, `objUnflatten`, `ObjUndefToOptional`, `ObjOptionalToUndef`, `objKeys`, `objEntries`, `objFromEntries`, `objMap` | Deep object utilities (clone, equal, merge, pick, omit, chain access) | `object.spec.ts` |
+| `src/utils/primitive.ts` | `getPrimitiveTypeStr` | Primitive type string detection utility | `primitive.spec.ts` |
+| `src/utils/str.ts` | `koreanGetSuffix`, `strReplaceFullWidth`, `strToPascalCase`, `strToCamelCase`, `strToKebabCase`, `strToSnakeCase`, `strIsNullOrEmpty`, `strInsert` | String utilities (case conversion, Korean suffix, full-width replacement) | `string.spec.ts` |
+| `src/utils/template-strings.ts` | `js`, `ts`, `html`, `tsql`, `mysql`, `pgsql` | Tagged template literals for JS, TS, HTML, SQL syntax highlighting | `template-strings.spec.ts` |
+| `src/utils/transferable.ts` | `transferableEncode`, `transferableDecode` | Encode/decode objects with Transferable types for structured clone | `transferable.spec.ts` |
+| `src/utils/wait.ts` | `waitUntil`, `waitTime` | Async wait utilities (until condition, timed delay) | `wait.spec.ts` |
+| `src/utils/xml.ts` | `xmlParse`, `xmlStringify` | XML parse and stringify utilities | `xml.spec.ts` |
+| `src/utils/path.ts` | `pathJoin`, `pathBasename`, `pathExtname` | Platform-independent path join, basename, and extension utilities | `path.spec.ts` |
+| `src/utils/error.ts` | `errorMessage` | Extract error message string from unknown error values | - |
+
+### zip
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/zip/sd-zip.ts` | `ZipArchiveProgress`, `ZipArchive` | ZIP archive creation and extraction with progress callback | `sd-zip.spec.ts` |
+
+### type utilities
+
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/common.types.ts` | `Bytes`, `PrimitiveTypeMap`, `PrimitiveTypeStr`, `PrimitiveType`, `DeepPartial`, `Type` | Common type utilities (Bytes, PrimitiveType, DeepPartial, Type) | - |
 
 ## License
 

package/dist/common.types.d.ts

@@ -3,12 +3,12 @@ import { DateOnly } from "./types/date-only";
 import { Time } from "./types/time";
 import { Uuid } from "./types/uuid";
 /**
- * Buffer 대신 사용하는 바이너리 타입
+ * Binary type used instead of Buffer
  */
 export type Bytes = Uint8Array;
 /**
- * Primitive 타입 매핑
- * orm-common과 공유
+ * Primitive type mapping
+ * Shared with orm-common
  */
 export type PrimitiveTypeMap = {
     string: string;
@@ -21,19 +21,19 @@ export type PrimitiveTypeMap = {
     Bytes: Bytes;
 };
 /**
- * Primitive 타입 문자열 키
+ * Primitive type string key
  */
 export type PrimitiveTypeStr = keyof PrimitiveTypeMap;
 /**
- * Primitive 타입 유니온
+ * Primitive type union
  */
 export type PrimitiveType = PrimitiveTypeMap[PrimitiveTypeStr] | undefined;
 /**
- * 깊은 Partial 타입
+ * Deep Partial type
  *
- * 객체의 모든 속성을 재귀적으로 선택적(optional)으로 만듭니다.
- * Primitive 타입(string, number, boolean 등)은 그대로 유지하고,
- * 객체/배열 타입만 재귀적으로 Partial을 적용합니다.
+ * Recursively makes all properties of an object optional.
+ * Primitive types (string, number, boolean, etc.) are kept as-is,
+ * only object/array types have Partial applied recursively.
  *
  * @example
  * ```typescript
@@ -45,7 +45,7 @@ export type PrimitiveType = PrimitiveTypeMap[PrimitiveTypeStr] | undefined;
  *   };
  * }
  *
- * // 모든 깊이의 속성이 선택적이 됨
+ * // All properties at every depth become optional
  * const partial: DeepPartial<User> = {
  *   profile: { address: {} }
  * };
@@ -55,10 +55,10 @@ export type DeepPartial<TObject> = Partial<{
     [K in keyof TObject]: TObject[K] extends PrimitiveType ? TObject[K] : DeepPartial<TObject[K]>;
 }>;
 /**
- * 생성자 타입
+ * Constructor type
  *
- * 클래스 생성자를 타입으로 표현할 때 사용합니다.
- * 주로 의존성 주입, 팩토리 패턴, instanceof 체크 등에서 활용됩니다.
+ * Used to represent a class constructor as a type.
+ * Primarily used in dependency injection, factory patterns, and instanceof checks.
  *
  * @example
  * function create<T>(ctor: Type<T>): T {
@@ -66,7 +66,7 @@ export type DeepPartial<TObject> = Partial<{
  * }
  *
  * class MyClass { name = "test"; }
- * const instance = create(MyClass); // MyClass 인스턴스
+ * const instance = create(MyClass); // MyClass instance
  */
 export interface Type<TInstance> extends Function {
     new (...args: unknown[]): TInstance;

package/dist/errors/argument-error.d.ts

@@ -1,24 +1,24 @@
 import { SdError } from "./sd-error";
 /**
- * 인수 오류
+ * Argument error
  *
- * 잘못된 인수를 받았을 때 발생시키는 에러이다.
- * 인수 객체를 YAML 형식으로 메시지에 포함하여 디버깅을 용이하게 한다.
+ * An error thrown when invalid arguments are received.
+ * Includes the argument object in YAML format in the message to facilitate debugging.
  *
  * @example
- * // 인수 객체만 전달
+ * // Passing only the argument object
  * throw new ArgumentError({ userId: 123, name: null });
- * // 결과 메시지: "인수가 잘못되었습니다.\n\nuserId: 123\nname: null"
+ * // Result message: "Invalid arguments.\n\nuserId: 123\nname: null"
  *
  * @example
- * // 커스텀 메시지와 인수 객체 전달
- * throw new ArgumentError("유효하지 않은 사용자", { userId: 123 });
- * // 결과 메시지: "유효하지 않은 사용자\n\nuserId: 123"
+ * // Passing a custom message and argument object
+ * throw new ArgumentError("Invalid user", { userId: 123 });
+ * // Result message: "Invalid user\n\nuserId: 123"
  */
 export declare class ArgumentError extends SdError {
-    /** 기본 메시지("인수가 잘못되었습니다.")와 함께 인수 객체를 YAML 형식으로 출력 */
+    /** Output argument object in YAML format with default message ("Invalid arguments.") */
     constructor(argObj: Record<string, unknown>);
-    /** 커스텀 메시지와 함께 인수 객체를 YAML 형식으로 출력 */
+    /** Output argument object in YAML format with a custom message */
     constructor(message: string, argObj: Record<string, unknown>);
     constructor(arg1: Record<string, unknown> | string, arg2?: Record<string, unknown>);
 }

package/dist/errors/argument-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"argument-error.d.ts","sourceRoot":"","sources":["../../src/errors/argument-error.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,qDAAqD;gBACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3C,sCAAsC;gBAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYnF"}
+{"version":3,"file":"argument-error.d.ts","sourceRoot":"","sources":["../../src/errors/argument-error.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,wFAAwF;gBAC5E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3C,kEAAkE;gBACtD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYnF"}

package/dist/errors/argument-error.js

@@ -5,9 +5,9 @@ class ArgumentError extends SdError {
     const message = typeof arg1 === "string" ? arg1 : void 0;
     const argObj = typeof arg1 === "string" ? arg2 : arg1;
     if (argObj != null) {
-      super((message ?? "\uC778\uC218\uAC00 \uC798\uBABB\uB418\uC5C8\uC2B5\uB2C8\uB2E4.") + "\n\n" + YAML.stringify(argObj));
+      super((message ?? "Invalid arguments.") + "\n\n" + YAML.stringify(argObj));
     } else {
-      super(message ?? "\uC778\uC218\uAC00 \uC798\uBABB\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
+      super(message ?? "Invalid arguments.");
     }
     this.name = "ArgumentError";
   }

package/dist/errors/argument-error.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/errors/argument-error.ts"],
-  "mappings": "AAGA,OAAO,UAAU;AACjB,SAAS,eAAe;AAkBjB,MAAM,sBAAsB,QAAQ;AAAA,EAMzC,YAAY,MAAwC,MAAgC;AAClF,UAAM,UAAU,OAAO,SAAS,WAAW,OAAO;AAClD,UAAM,SAAS,OAAO,SAAS,WAAW,OAAO;AAEjD,QAAI,UAAU,MAAM;AAClB,aAAO,WAAW,oEAAkB,SAAS,KAAK,UAAU,MAAM,CAAC;AAAA,IACrE,OAAO;AACL,YAAM,WAAW,gEAAc;AAAA,IACjC;AACA,SAAK,OAAO;AAAA,EACd;AACF;",
+  "mappings": "AAGA,OAAO,UAAU;AACjB,SAAS,eAAe;AAkBjB,MAAM,sBAAsB,QAAQ;AAAA,EAMzC,YAAY,MAAwC,MAAgC;AAClF,UAAM,UAAU,OAAO,SAAS,WAAW,OAAO;AAClD,UAAM,SAAS,OAAO,SAAS,WAAW,OAAO;AAEjD,QAAI,UAAU,MAAM;AAClB,aAAO,WAAW,wBAAwB,SAAS,KAAK,UAAU,MAAM,CAAC;AAAA,IAC3E,OAAO;AACL,YAAM,WAAW,oBAAoB;AAAA,IACvC;AACA,SAAK,OAAO;AAAA,EACd;AACF;",
   "names": []
 }

package/dist/errors/not-implemented-error.d.ts

@@ -1,28 +1,28 @@
 import { SdError } from "./sd-error";
 /**
- * 미구현 오류
+ * Not implemented error
  *
- * 아직 구현되지 않은 기능을 호출했을 때 발생시키는 에러이다.
- * 추상 메서드 스텁, 향후 구현 예정인 분기 등에 사용한다.
+ * An error thrown when a feature that has not yet been implemented is called.
+ * Used for abstract method stubs, branches planned for future implementation, etc.
  *
  * @example
- * // 추상 메서드 구현 전
+ * // Before abstract method implementation
  * class BaseService {
  *   process(): void {
- *     throw new NotImplementedError("서브클래스에서 구현 필요");
+ *     throw new NotImplementedError("Implementation required in subclass");
  *   }
  * }
  *
  * @example
- * // 향후 구현 예정 분기
+ * // Branch planned for future implementation
  * switch (type) {
  *   case "A": return handleA();
- *   case "B": throw new NotImplementedError(`타입 ${type} 처리`);
+ *   case "B": throw new NotImplementedError(`Handling for type ${type}`);
  * }
  */
 export declare class NotImplementedError extends SdError {
     /**
-     * @param message 추가 설명 메시지
+     * @param message Additional description message
      */
     constructor(message?: string);
 }

package/dist/errors/not-implemented-error.js

@@ -1,10 +1,10 @@
 import { SdError } from "./sd-error.js";
 class NotImplementedError extends SdError {
   /**
-   * @param message 추가 설명 메시지
+   * @param message Additional description message
    */
   constructor(message) {
-    super("\uAD6C\uD604\uB418\uC5B4 \uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4" + (message != null ? ": " + message : ""));
+    super("Not implemented" + (message != null ? ": " + message : ""));
     this.name = "NotImplementedError";
   }
 }

package/dist/errors/not-implemented-error.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/errors/not-implemented-error.ts"],
-  "mappings": "AAAA,SAAS,eAAe;AAuBjB,MAAM,4BAA4B,QAAQ;AAAA;AAAA;AAAA;AAAA,EAI/C,YAAY,SAAkB;AAC5B,UAAM,oEAAkB,WAAW,OAAO,OAAO,UAAU,GAAG;AAC9D,SAAK,OAAO;AAAA,EACd;AACF;",
+  "mappings": "AAAA,SAAS,eAAe;AAuBjB,MAAM,4BAA4B,QAAQ;AAAA;AAAA;AAAA;AAAA,EAI/C,YAAY,SAAkB;AAC5B,UAAM,qBAAqB,WAAW,OAAO,OAAO,UAAU,GAAG;AACjE,SAAK,OAAO;AAAA,EACd;AACF;",
   "names": []
 }

package/dist/errors/sd-error.d.ts

@@ -1,26 +1,26 @@
 /**
- * 오류의 Tree 구조 구성이 가능한 오류 클래스
- * ES2024 cause 속성 활용
+ * Error class supporting Tree structure composition
+ * Utilizes ES2024 cause property
  *
  * @example
- * // 원인 에러를 감싸서 생성
+ * // Wrap a cause error
  * try {
  *   await fetch(url);
  * } catch (err) {
- *   throw new SdError(err, "API 호출 실패", "사용자 로드 실패");
+ *   throw new SdError(err, "API call failed", "User load failed");
  * }
- * // 결과 메시지: "사용자 로드 실패 => API 호출 실패 => 원본 에러 메시지"
+ * // Result message: "User load failed => API call failed => original error message"
  *
  * @example
- * // 메시지만으로 생성
- * throw new SdError("잘못된 상태", "처리 불가");
- * // 결과 메시지: "처리 불가 => 잘못된 상태"
+ * // Create with message only
+ * throw new SdError("invalid state", "processing not possible");
+ * // Result message: "processing not possible => invalid state"
  */
 export declare class SdError extends Error {
     cause?: Error;
-    /** 원인 에러를 감싸서 생성. 메시지는 역순으로 연결됨 (상위 메시지 => 하위 메시지 => 원인 메시지) */
+    /** Create by wrapping a cause error. Messages are joined in reverse order (upper message => lower message => cause message) */
     constructor(cause: Error, ...messages: string[]);
-    /** 메시지만으로 생성. 메시지는 역순으로 연결됨 (상위 메시지 => 하위 메시지) */
+    /** Create with messages only. Messages are joined in reverse order (upper message => lower message) */
     constructor(...messages: string[]);
     constructor(arg1?: unknown, ...messages: string[]);
 }

package/dist/errors/sd-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sd-error.d.ts","sourceRoot":"","sources":["../../src/errors/sd-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,OAAQ,SAAQ,KAAK;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IAEvB,gEAAgE;gBACpD,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;IAC/C,kDAAkD;gBACtC,GAAG,QAAQ,EAAE,MAAM,EAAE;gBACrB,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;CAoClD"}
+{"version":3,"file":"sd-error.d.ts","sourceRoot":"","sources":["../../src/errors/sd-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,OAAQ,SAAQ,KAAK;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IAEvB,+HAA+H;gBACnH,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;IAC/C,uGAAuG;gBAC3F,GAAG,QAAQ,EAAE,MAAM,EAAE;gBACrB,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;CAoClD"}