@simplysm/core-common 14.0.47 → 14.0.49

package/README.md

@@ -0,0 +1,255 @@
+# @simplysm/core-common
+
+브라우저와 Node.js 모두에서 사용 가능한 순수 공통 유틸리티 패키지. 다른 `@simplysm/*` 패키지에 대한 내부 의존성이 없는 리프 패키지다.
+
+## Installation
+
+```bash
+npm install @simplysm/core-common
+```
+
+## API Overview
+
+### Errors
+
+| API | Type | Description |
+|-----|------|-------------|
+| `SdError` | class | 트리 구조 에러 체인 지원. 메시지를 역순으로 결합 (상위 => 하위 => 원인) |
+| `ArgumentError` | class | 인자 유효성 오류. 인자 객체를 YAML 형식으로 메시지에 포함 |
+| `NotImplementedError` | class | 미구현 기능 호출 시 발생 |
+| `TimeoutError` | class | 대기 시간 초과 시 발생 (시도 횟수 포함) |
+
+→ See [docs/errors.md](./docs/errors.md) for details.
+
+### Types (Value Objects)
+
+| API | Type | Description |
+|-----|------|-------------|
+| `DateTime` | class | 불변 날짜시간 (밀리초 정밀도, 로컬 타임존) |
+| `DateOnly` | class | 불변 날짜 (시간 제외, 주차 계산 지원) |
+| `Time` | class | 불변 시간 (24시간 순환, 날짜 제외) |
+| `Uuid` | class | UUID v4 (crypto.getRandomValues 기반) |
+| `LazyGcMap<TKey, TValue>` | class | 자동 만료 기능이 있는 LRU Map |
+
+→ See [docs/types.md](./docs/types.md) for details.
+
+### Features
+
+| API | Type | Description |
+|-----|------|-------------|
+| `EventEmitter<TEvents>` | class | 타입 안전 EventEmitter (EventTarget 기반, 브라우저/Node.js 모두 지원) |
+| `DebounceQueue` | class | 비동기 디바운스 큐 (짧은 시간 내 다수 호출 시 마지막만 실행) |
+| `SerialQueue` | class | 비동기 직렬 큐 (순차 실행 보장) |
+
+→ See [docs/features.md](./docs/features.md) for details.
+
+### Extensions (Prototype)
+
+Array, Map, Set 프로토타입 확장이 자동 등록됨 (side-effect import):
+
+| API | Type | Description |
+|-----|------|-------------|
+| **Array Methods (Immutable)** | | `single`, `first`, `last`, `filterExists`, `ofType`, `groupBy`, `toMap`, `toMapAsync`, `toArrayMap`, `toSetMap`, `toMapValues`, `toObject`, `toTree`, `distinct`, `orderBy`, `orderByDesc`, `diffs`, `oneWayDiffs`, `merge`, `sum`, `min`, `max`, `shuffle`, `mapAsync`, `filterAsync`, `mapMany`, `mapManyAsync`, `parallelAsync` |
+| **Array Methods (Mutable)** | | `remove`, `insert`, `toggle`, `clear`, `distinctThis`, `orderByThis`, `orderByDescThis` |
+| **Map Extensions** | | `getOrCreate`, `update` |
+| **Set Extensions** | | `adds`, `toggle` |
+| `ArrayDiffsResult<T, P>` | type | diffs() 결과 타입 (INSERT/DELETE/UPDATE) |
+| `ArrayOneWayDiffResult<T>` | type | oneWayDiffs() 결과 타입 (create/update/same) |
+| `TreeArray<T>` | type | toTree() 결과 타입 (children 속성 추가) |
+| `ComparableType` | type | 정렬/비교 가능한 타입 union |
+
+→ See [docs/extensions.md](./docs/extensions.md) for details.
+
+### Environment
+
+| API | Type | Description |
+|-----|------|-------------|
+| `env` | function | 환경변수 get/set. `env(key)` 읽기, `env(key, value)` 쓰기 |
+| `parseBoolEnv` | function | 환경변수 값을 boolean으로 파싱 ("true"/"1"/"yes"/"on" -> true) |
+
+### Utils (Namespace Imports)
+
+| API | Type | Description |
+|-----|------|-------------|
+| `obj` | namespace | clone, equal, merge, merge3, omit, omitByFilter, pick, getChainValue, getChainValueByDepth, setChainValue, deleteChainValue, clearUndefined, clear, nullToUndefined, unflatten, keys, entries, fromEntries, map |
+| `str` | namespace | getKoreanSuffix, replaceFullWidth, toPascalCase, toCamelCase, toKebabCase, toSnakeCase, isNullOrEmpty, insert |
+| `num` | namespace | parseInt, parseFloat, parseRoundedInt, isNullOrEmpty, format |
+| `bytes` | namespace | concat, toHex, fromHex, toBase64, fromBase64 |
+| `path` | namespace | join, basename, extname |
+| `json` | namespace | stringify, parse |
+| `xml` | namespace | parse, stringify |
+| `wait` | namespace | until, time |
+| `transfer` | namespace | encode, decode |
+| `err` | namespace | message |
+| `dt` | namespace | format, normalizeMonth, convert12To24 |
+| `primitive` | namespace | typeStr |
+
+→ See [docs/utils.md](./docs/utils.md) for details.
+
+### Utils (Direct Exports)
+
+| API | Type | Description |
+|-----|------|-------------|
+| `js` | function | JavaScript 코드 하이라이팅용 태그드 템플릿 리터럴 |
+| `ts` | function | TypeScript 코드 하이라이팅용 태그드 템플릿 리터럴 |
+| `html` | function | HTML 마크업 하이라이팅용 태그드 템플릿 리터럴 |
+| `tsql` | function | MSSQL T-SQL 하이라이팅용 태그드 템플릿 리터럴 |
+| `mysql` | function | MySQL SQL 하이라이팅용 태그드 템플릿 리터럴 |
+| `pgsql` | function | PostgreSQL SQL 하이라이팅용 태그드 템플릿 리터럴 |
+| `ZipArchive` | class | ZIP 파일 읽기/쓰기/압축/해제 (캐싱, 진행률 콜백 지원) |
+| `ZipArchiveProgress` | interface | ZipArchive 진행률 콜백 데이터 |
+
+### Type Utilities
+
+| API | Type | Description |
+|-----|------|-------------|
+| `Bytes` | type | `Uint8Array` 별칭 (Buffer 대신 사용) |
+| `PrimitiveTypeMap` | type | 원시 타입 문자열 key -> 타입 매핑 |
+| `PrimitiveTypeStr` | type | 원시 타입 문자열 key union (`"string" \| "number" \| ...`) |
+| `PrimitiveType` | type | 원시 타입 union (`string \| number \| boolean \| DateTime \| ...`) |
+| `DeepPartial<T>` | type | 모든 속성을 재귀적으로 optional로 변환 |
+| `Type<T>` | interface | 생성자 타입 (`new (...args) => T`) |
+| `EqualOptions` | interface | obj.equal() 옵션 |
+| `MergeOptions` | interface | obj.merge() 옵션 |
+| `Merge3KeyOptions` | interface | obj.merge3() key 옵션 |
+| `DtNormalizedMonth` | interface | dt.normalizeMonth() 결과 타입 |
+| `UndefToOptional<T>` | type | undefined 타입을 optional로 변환 |
+| `OptionalToUndef<T>` | type | optional 속성을 undefined 포함 타입으로 변환 |
+
+→ See [docs/utils.md](./docs/utils.md) for details.
+
+## Usage Examples
+
+### 프로토타입 확장 사용
+
+```typescript
+import "@simplysm/core-common";
+
+// Array 확장
+const users = [{ id: 1, name: "Alice" }, { id: 2, name: "Bob" }];
+const user = users.single((u) => u.id === 1);
+const grouped = users.groupBy((u) => u.name);
+const sorted = users.orderBy((u) => u.name);
+const diffs = newUsers.diffs(oldUsers, { keys: ["id"] });
+
+// Map 확장
+const cache = new Map<string, number[]>();
+const arr = cache.getOrCreate("key", []);
+
+// Set 확장
+const set = new Set<string>();
+set.adds("a", "b", "c"); // 여러 항목 추가
+```
+
+### 에러 체인 처리
+
+```typescript
+import { SdError } from "@simplysm/core-common";
+
+try {
+  await fetch(url);
+} catch (err) {
+  throw new SdError(err, "API 호출 실패", "사용자 로드 실패");
+  // 결과 메시지: "사용자 로드 실패 => API 호출 실패 => 원본 에러 메시지"
+}
+```
+
+### 네임스페이스 유틸리티 사용
+
+```typescript
+import { obj, str, json, DateTime, Uuid } from "@simplysm/core-common";
+
+// 깊은 복사 및 비교
+const copied = obj.clone({ nested: { data: [1, 2, 3] } });
+const isEqual = obj.equal(a, b, { topLevelExcludes: ["updatedAt"] });
+const merged = obj.merge(defaults, overrides);
+
+// obj.omit, obj.pick
+const noId = obj.omit(user, ["id"]);
+const onlyName = obj.pick(user, ["name", "email"]);
+
+// 한국어 조사 처리
+const suffix = str.getKoreanSuffix("파일", "을"); // "을"
+const camel = str.toCamelCase("HelloWorld"); // "helloWorld"
+
+// 커스텀 타입 지원 JSON 직렬화
+const serialized = json.stringify({
+  date: new DateTime(),
+  id: Uuid.generate()
+});
+const restored = json.parse(serialized); // DateTime, Uuid 타입 복원됨
+```
+
+### 비동기 큐 사용
+
+```typescript
+import { DebounceQueue, SerialQueue } from "@simplysm/core-common";
+
+// 디바운스 큐: 짧은 시간 내 재호출 시 이전 호출 무시
+const dq = new DebounceQueue(300);
+dq.on("error", (err) => console.error(err));
+dq.run(() => saveData());
+dq.run(() => saveData()); // 첫 번째 호출 무시, 300ms 후 마지막만 실행
+
+// 직렬 큐: 순차 실행
+const sq = new SerialQueue();
+sq.run(async () => await step1());
+sq.run(async () => await step2()); // step1 완료 후 실행
+sq.run(async () => await step3()); // step2 완료 후 실행
+```
+
+### DateTime 사용
+
+```typescript
+import { DateTime, DateOnly, Time, Uuid } from "@simplysm/core-common";
+
+const now = new DateTime();
+const specific = new DateTime(2025, 1, 15, 10, 30, 0);
+const parsed = DateTime.parse("2025-01-15 10:30:00");
+const formatted = now.toFormatString("yyyy-MM-dd HH:mm:ss");
+const today = new DateOnly();
+const id = Uuid.generate();
+```
+
+### 자동 만료 Map 사용
+
+```typescript
+import { LazyGcMap } from "@simplysm/core-common";
+
+const cache = new LazyGcMap<string, Data>({
+  expireTime: 60_000,
+  onExpire: async (key, value) => {
+    await value.cleanup();
+  },
+});
+try {
+  cache.set("key", data);
+  const val = cache.get("key"); // 접근 시간 갱신
+} finally {
+  cache.dispose();
+}
+```
+
+### EventEmitter 사용
+
+```typescript
+import { EventEmitter } from "@simplysm/core-common";
+
+interface MyEvents {
+  data: string;
+  error: Error;
+  done: void;
+}
+
+class MyService extends EventEmitter<MyEvents> {
+  async load() {
+    this.emit("data", "Loading...");
+    this.emit("done"); // void 타입은 인자 없이 호출
+  }
+}
+
+const svc = new MyService();
+svc.on("data", (data) => console.log(data)); // data: string
+svc.on("done", () => console.log("completed"));
+await svc.load();
+```

package/dist/utils/transferable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transferable.d.ts","sourceRoot":"","sources":["../../src/utils/transferable.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,KAAK,YAAY,GAAG,WAAW,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,YAAY,EAAE,CAAC;CAC9B,CAMA;AAoJD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA2E5C"}
+{"version":3,"file":"transferable.d.ts","sourceRoot":"","sources":["../../src/utils/transferable.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,KAAK,YAAY,GAAG,WAAW,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,YAAY,EAAE,CAAC;CAC9B,CAMA;AAoJD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAgF5C"}

package/dist/utils/transferable.js

@@ -203,7 +203,11 @@ export function decode(obj) {
     if (Array.isArray(obj)) {
         return obj.map((item) => decode(item));
     }
-    // 3. Map 재귀
+    // 3. Uint8Array (encode에서 그대로 반환하므로 decode에서도 그대로 반환)
+    if (obj instanceof Uint8Array) {
+        return obj;
+    }
+    // 4. Map 재귀
     if (obj instanceof Map) {
         const newMap = new Map();
         for (const [k, v] of obj) {
@@ -211,7 +215,7 @@ export function decode(obj) {
         }
         return newMap;
     }
-    // 4. Set 재귀
+    // 5. Set 재귀
     if (obj instanceof Set) {
         const newSet = new Set();
         for (const v of obj) {
@@ -219,7 +223,7 @@ export function decode(obj) {
         }
         return newSet;
     }
-    // 5. 객체 재귀
+    // 6. 객체 재귀
     if (typeof obj === "object") {
         const record = obj;
         const result = {};

package/dist/utils/transferable.js.map

@@ -1 +1 @@
-{"version":3,"file":"transferable.js","sourceRoot":"","sources":["../../src/utils/transferable.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transferable.js","sourceRoot":"","sources":["../../src/utils/transferable.ts"],"names":[],"mappings":"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"}

package/docs/errors.md

@@ -0,0 +1,82 @@
+# Errors
+
+## `SdError`
+
+트리 구조 에러 체인을 지원하는 에러 클래스. ES2024 `cause` 속성을 활용한다.
+
+```typescript
+export class SdError extends Error {
+  override cause?: Error;
+
+  /** 원인 에러를 감싸서 생성. 메시지는 역순으로 결합됨 */
+  constructor(cause: Error, ...messages: string[]);
+  /** 메시지만으로 생성 */
+  constructor(...messages: string[]);
+}
+```
+
+생성자에 전달된 메시지들은 역순으로 결합된다. `cause`가 `Error` 인스턴스이면 그 메시지도 체인 끝에 추가된다.
+
+```typescript
+throw new SdError(err, "API 호출 실패", "사용자 로드 실패");
+// message: "사용자 로드 실패 => API 호출 실패 => 원본 에러 메시지"
+
+throw new SdError("잘못된 상태", "처리 불가");
+// message: "처리 불가 => 잘못된 상태"
+```
+
+## `ArgumentError`
+
+유효하지 않은 인자를 전달받았을 때 발생하는 에러. 인자 객체를 YAML 형식으로 메시지에 포함하여 디버깅을 용이하게 한다.
+
+```typescript
+export class ArgumentError extends SdError {
+  /** 기본 메시지("잘못된 인자입니다.")와 함께 인자 객체를 YAML 형식으로 출력 */
+  constructor(argObj: Record<string, unknown>);
+  /** 커스텀 메시지와 함께 인자 객체를 YAML 형식으로 출력 */
+  constructor(message: string, argObj: Record<string, unknown>);
+}
+```
+
+```typescript
+throw new ArgumentError({ userId: 123, name: null });
+// message: "잘못된 인자입니다.\n\nuserId: 123\nname: null"
+
+throw new ArgumentError("잘못된 사용자", { userId: 123 });
+// message: "잘못된 사용자\n\nuserId: 123"
+```
+
+## `NotImplementedError`
+
+아직 구현되지 않은 기능이 호출되었을 때 발생하는 에러.
+
+```typescript
+export class NotImplementedError extends SdError {
+  constructor(message?: string);
+}
+```
+
+```typescript
+throw new NotImplementedError("서브클래스에서 구현 필요");
+// message: "미구현: 서브클래스에서 구현 필요"
+```
+
+## `TimeoutError`
+
+대기 시간이 초과되었을 때 발생하는 에러. `wait.until()`에서 최대 시도 횟수를 초과하면 자동으로 발생한다.
+
+```typescript
+export class TimeoutError extends SdError {
+  constructor(count?: number, message?: string);
+}
+```
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `count` | `number \| undefined` | 시도 횟수 |
+| `message` | `string \| undefined` | 추가 메시지 |
+
+```typescript
+throw new TimeoutError(50, "API 응답 대기 초과");
+// message: "대기 시간 초과(50회 시도): API 응답 대기 초과"
+```

package/docs/extensions.md

@@ -0,0 +1,167 @@
+# Extensions (Prototype)
+
+`@simplysm/core-common`을 import하면 `Array`, `Map`, `Set` 프로토타입 확장이 자동 등록된다.
+
+```typescript
+import "@simplysm/core-common"; // side-effect import — 확장 등록
+```
+
+## Array Extensions (Immutable)
+
+새 배열을 반환하며 원본 배열을 변경하지 않는다.
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `single` | `(predicate?) => T \| undefined` | 조건에 맞는 단일 요소 반환. 2개 이상이면 `ArgumentError` 발생 |
+| `first` | `(predicate?) => T \| undefined` | 첫 번째 요소 반환 |
+| `last` | `(predicate?) => T \| undefined` | 마지막 요소 반환 |
+| `filterExists` | `() => NonNullable<T>[]` | null/undefined 제거 |
+| `ofType` | `(type) => TNarrow[]` | 특정 타입의 요소만 필터 (`PrimitiveTypeStr` 또는 생성자) |
+| `mapAsync` | `(selector) => Promise<TResult[]>` | 비동기 매핑 (순차 실행) |
+| `filterAsync` | `(predicate) => Promise<T[]>` | 비동기 필터 (순차 실행) |
+| `mapMany` | `(selector?) => TResult[]` | 매핑 후 평탄화 (또는 중첩 배열 평탄화) |
+| `mapManyAsync` | `(selector?) => Promise<TResult[]>` | 비동기 매핑 후 평탄화 (순차 실행) |
+| `parallelAsync` | `(fn) => Promise<TResult[]>` | 비동기 병렬 처리 (`Promise.all` 사용) |
+| `groupBy` | `(keySelector, valueSelector?) => { key, values }[]` | key 기준 그룹화. 객체 key는 O(n²), 원시 key는 O(n) |
+| `toMap` | `(keySelector, valueSelector?) => Map<TKey, TValue>` | Map으로 변환. 중복 key이면 `ArgumentError` 발생 |
+| `toMapAsync` | `(keySelector, valueSelector?) => Promise<Map<TKey, TValue>>` | 비동기 Map으로 변환 |
+| `toArrayMap` | `(keySelector, valueSelector?) => Map<TKey, TValue[]>` | 그룹 Map으로 변환. O(n) 성능 |
+| `toSetMap` | `(keySelector, valueSelector?) => Map<TKey, Set<TValue>>` | 그룹 Set Map으로 변환 |
+| `toMapValues` | `(keySelector, valueSelector) => Map<TKey, TValue>` | 그룹화 후 그룹별로 값 변환 |
+| `toObject` | `(keySelector, valueSelector?) => Record<string, TValue>` | 일반 객체로 변환. 중복 key이면 `ArgumentError` 발생 |
+| `toTree` | `(keyProp, parentKey) => TreeArray<T>[]` | 평면 배열을 트리 구조로 변환. O(n) 복잡도 |
+| `distinct` | `(options?) => T[]` | 중복 제거. 객체 배열에서 `keyFn` 없이 사용하면 O(n²) |
+| `orderBy` | `(selector?) => T[]` | 오름차순 정렬 |
+| `orderByDesc` | `(selector?) => T[]` | 내림차순 정렬 |
+| `diffs` | `(target, options?) => ArrayDiffsResult<T, P>[]` | 두 배열 비교 (INSERT/DELETE/UPDATE) |
+| `oneWayDiffs` | `(orgItems, keyPropNameOrGetValFn, options?) => ArrayOneWayDiffResult<T>[]` | 단방향 차이 계산 (create/update/same) |
+| `merge` | `(target, options?) => (T \| P \| T&P)[]` | 두 배열 병합 |
+| `sum` | `(selector?) => number` | 합계. 빈 배열이면 0 |
+| `min` | `(selector?) => T \| undefined` | 최솟값 |
+| `max` | `(selector?) => T \| undefined` | 최댓값 |
+| `shuffle` | `() => T[]` | 무작위 섞기 |
+
+### `toTree` 상세
+
+```typescript
+interface Item {
+  id: number;
+  parentId?: number;
+  name: string;
+}
+
+const items: Item[] = [
+  { id: 1, name: "root" },
+  { id: 2, parentId: 1, name: "child1" },
+  { id: 3, parentId: 2, name: "grandchild" },
+];
+
+const tree = items.toTree("id", "parentId");
+// [{ id: 1, name: "root", children: [
+//   { id: 2, name: "child1", children: [
+//     { id: 3, name: "grandchild", children: [] }
+//   ]}
+// ]}]
+```
+
+### `diffs` 상세
+
+```typescript
+const diffs = newItems.diffs(oldItems, { keys: ["id"], excludes: ["updatedAt"] });
+// ArrayDiffsResult: { source: undefined, target: item } (INSERT)
+//                  { source: item, target: undefined } (DELETE)
+//                  { source: item, target: item }       (UPDATE)
+```
+
+### `oneWayDiffs` 상세
+
+```typescript
+const diffs = newItems.oneWayDiffs(orgItems, "id", { includeSame: false });
+// ArrayOneWayDiffResult: { type: "create", item, orgItem: undefined }
+//                        { type: "update", item, orgItem }
+//                        { type: "same", item, orgItem }
+```
+
+## Array Extensions (Mutable)
+
+원본 배열을 직접 변경한다.
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `insert` | `(index, ...items) => this` | 지정 위치에 항목 삽입 |
+| `remove` | `(item \| selector) => this` | 항목 또는 조건에 맞는 항목 제거 |
+| `toggle` | `(item) => this` | 항목 토글 (있으면 제거, 없으면 추가) |
+| `clear` | `() => this` | 배열 비우기 |
+| `distinctThis` | `(options?) => T[]` | 원본 배열에서 중복 제거 |
+| `orderByThis` | `(selector?) => T[]` | 원본 배열을 오름차순 정렬 |
+| `orderByDescThis` | `(selector?) => T[]` | 원본 배열을 내림차순 정렬 |
+
+## Map Extensions
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `getOrCreate` | `(key, newValue \| newValueFn) => V` | key가 없으면 새 값을 설정하고 반환. V 타입이 함수이면 팩토리로 감싸야 함 |
+| `update` | `(key, updateFn) => void` | 기존 값을 기반으로 업데이트. key가 없어도 `updateFn`이 호출됨 |
+
+```typescript
+const map = new Map<string, number[]>();
+const arr = map.getOrCreate("key", []); // 없으면 [] 설정 후 반환
+
+const countMap = new Map<string, number>();
+countMap.update("key", (v) => (v ?? 0) + 1); // 카운터 증가
+```
+
+## Set Extensions
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `adds` | `(...values: T[]) => this` | 여러 값을 한 번에 추가 |
+| `toggle` | `(value, addOrDel?) => this` | 값 토글. `addOrDel`로 강제 추가/제거 가능 |
+
+```typescript
+const set = new Set<number>([1, 2, 3]);
+set.adds(4, 5, 6); // 여러 항목 추가
+set.toggle(2); // 2가 있으므로 제거 → {1, 3, 4, 5, 6}
+set.toggle(99, "add"); // 강제 추가
+set.toggle(99, "del"); // 강제 제거
+```
+
+## Exported Types
+
+### `ArrayDiffsResult<TOriginal, TOther>`
+
+`diffs()` 메서드의 반환 타입. discriminated union으로 `source`와 `target` 중 하나가 `undefined`이면 INSERT/DELETE, 둘 다 있으면 UPDATE.
+
+```typescript
+export type ArrayDiffsResult<TOriginal, TOther> =
+  | { source: undefined; target: TOther }    // INSERT
+  | { source: TOriginal; target: undefined } // DELETE
+  | { source: TOriginal; target: TOther };   // UPDATE
+```
+
+### `ArrayOneWayDiffResult<TItem>`
+
+`oneWayDiffs()` 메서드의 반환 타입. `type` 필드로 분기.
+
+```typescript
+export type ArrayOneWayDiffResult<TItem> =
+  | { type: "create"; item: TItem; orgItem: undefined }
+  | { type: "update"; item: TItem; orgItem: TItem }
+  | { type: "same";   item: TItem; orgItem: TItem };
+```
+
+### `TreeArray<TNode>`
+
+`toTree()` 메서드의 반환 타입. 원본 타입에 `children` 속성이 추가된다.
+
+```typescript
+export type TreeArray<TNode> = TNode & { children: TreeArray<TNode>[] };
+```
+
+### `ComparableType`
+
+`orderBy`, `orderByDesc`, `orderByThis`, `orderByDescThis`의 selector 반환 타입.
+
+```typescript
+export type ComparableType = string | number | boolean | DateTime | DateOnly | Time | undefined;
+```