@simplysm/sd-claude 14.0.47 → 14.0.49

package/claude/references/sd-simplysm14/excel/docs/wrapper.md

@@ -1,73 +0,0 @@
-# Wrapper
-
-## `ExcelWrapper`
-
-Zod 스키마 기반 타입 안전한 Excel 읽기/쓰기 래퍼. 스키마에서 타입 정보를 추론하여 타입 안전한 읽기/쓰기를 제공한다.
-
-```typescript
-export class ExcelWrapper<TSchema extends z.ZodObject<z.ZodRawShape>> {
-  constructor(schema: TSchema);
-
-  async read(
-    file: Bytes | Blob,
-    wsNameOrIndex?: string | number,
-    options?: { excludes?: (keyof z.infer<TSchema>)[] },
-  ): Promise<z.infer<TSchema>[]>;
-
-  async write(
-    wsName: string,
-    records: Partial<z.infer<TSchema>>[],
-    options?: { excludes?: (keyof z.infer<TSchema>)[] },
-  ): Promise<ExcelWorkbook>;
-}
-```
-
-### Constructor
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `schema` | `TSchema extends z.ZodObject<z.ZodRawShape>` | Zod 스키마. `.describe()`로 Excel 헤더 이름을 지정한다 |
-
-### Methods
-
-#### `read(file, wsNameOrIndex?, options?)`
-
-Excel 파일을 레코드 배열로 읽는다. 헤더 행의 텍스트를 스키마의 `.describe()` 값과 매칭하여 필드를 연결한다. Zod 스키마로 유효성 검사를 수행하며, 실패 시 에러를 던진다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `file` | `Bytes \| Blob` | Excel 파일 데이터 |
-| `wsNameOrIndex` | `string \| number` | 워크시트 이름 또는 0 기반 인덱스 (기본값: `0`) |
-| `options.excludes` | `(keyof z.infer<TSchema>)[]` | 읽기에서 제외할 필드 키 배열 |
-
-**반환값:** `z.infer<TSchema>[]` - 스키마 타입으로 추론된 레코드 배열
-
-**타입 변환 규칙:**
-
-| 스키마 타입 | 변환 동작 |
-|------------|-----------|
-| `z.string()` | 문자열로 변환 (`String(rawValue)`) |
-| `z.number()` | 숫자로 파싱 (`num.parseFloat`) |
-| `z.boolean()` | `"1"`, `"true"` -> `true`, `"0"`, `"false"` -> `false` |
-| `z.optional()` / `z.nullable()` | 빈 셀을 `undefined`로 반환 |
-| `z.default(value)` | 빈 셀에 기본값 적용 |
-| `DateOnly` / `DateTime` / `Time` | `instanceof`로 직접 전달 |
-
-#### `write(wsName, records, options?)`
-
-레코드 배열을 Excel 워크북으로 변환한다. 반환된 `ExcelWorkbook`의 리소스 관리는 호출자의 책임이다. 내부에서 에러 발생 시 워크북이 자동으로 `close()`된다.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `wsName` | `string` | 워크시트 이름 |
-| `records` | `Partial<z.infer<TSchema>>[]` | 레코드 배열 |
-| `options.excludes` | `(keyof z.infer<TSchema>)[]` | 쓰기에서 제외할 필드 키 배열 |
-
-**반환값:** `ExcelWorkbook` - 호출자가 `try-finally` 블록에서 `close()`를 호출하여 리소스를 관리해야 한다
-
-**쓰기 동작:**
-
-- 첫 번째 행에 헤더 자동 생성 (스키마의 `.describe()` 값 사용)
-- 모든 셀에 테두리 스타일 자동 적용
-- 필수 비boolean 필드의 헤더에 노란색 배경(`00FFFF00`) 강조
-- 확대/축소 85%, 첫 번째 행 틀 고정 자동 설정

package/claude/references/sd-simplysm14/excel/usage.md

@@ -1,134 +0,0 @@
-# @simplysm/excel
-
-Excel 워크북(xlsx) 읽기/쓰기 라이브러리. DOM 의존성이 없어 Node.js와 브라우저 양쪽에서 동작하는 neutral 패키지다. Lazy Loading 아키텍처로 대용량 파일도 메모리 효율적으로 처리한다.
-
-## Installation
-
-```bash
-npm install @simplysm/excel
-```
-
-## API Overview
-
-### Core Classes
-
-| API | Type | Description |
-|-----|------|-------------|
-| `ExcelWorkbook` | class | Excel 워크북 진입점. 워크시트 생성/조회, 바이트 내보내기, ZIP 리소스 관리 |
-| `ExcelWorksheet` | class | 워크시트. 셀/행/열 접근, 행/셀 복사, 데이터 테이블 읽기, 이미지 삽입, 시트명 변경 |
-| `ExcelCell` | class | 개별 셀. 값/수식 읽기/쓰기, 스타일 설정, 셀 병합 |
-| `ExcelRow` | class | 워크시트 행. 셀 접근, 행 전체 셀 조회 |
-| `ExcelCol` | class | 워크시트 열. 셀 접근, 열 너비 설정 |
-
-→ See [docs/core-classes.md](./docs/core-classes.md) for details.
-
-### Wrapper
-
-| API | Type | Description |
-|-----|------|-------------|
-| `ExcelWrapper` | class | Zod 스키마 기반 타입 안전한 Excel 읽기/쓰기. 헤더 자동 생성, 유효성 검사, 필수 필드 강조 |
-
-→ See [docs/wrapper.md](./docs/wrapper.md) for details.
-
-### Utilities
-
-| API | Type | Description |
-|-----|------|-------------|
-| `ExcelUtils` | class | 셀 주소 변환 (좌표↔문자열), 날짜↔숫자 변환, 숫자 형식 매핑 (정적 메서드) |
-
-→ See [docs/utilities.md](./docs/utilities.md) for details.
-
-### Types
-
-| API | Type | Description |
-|-----|------|-------------|
-| `ExcelValueType` | type | 셀 값 타입: number, string, DateOnly, DateTime, Time, boolean, undefined |
-| `ExcelNumberFormat` | type | 숫자 형식 이름: "number", "string", "DateOnly", "DateTime", "Time" |
-| `ExcelCellType` | type | 셀 타입: "s"(공유문자열), "b"(boolean), "str"(수식문자열), "n"(숫자), "inlineStr", "e"(에러) |
-| `ExcelAddressPoint` | interface | 셀 좌표 (0 기반 r, c) |
-| `ExcelAddressRangePoint` | interface | 셀 범위 좌표 (시작점 s, 끝점 e) |
-| `ExcelStyleOptions` | interface | 셀 스타일 옵션 (배경색, 테두리, 정렬, 숫자 형식) |
-| `ExcelBorderPosition` | type | 테두리 위치: "left", "right", "top", "bottom" |
-| `ExcelHorizontalAlign` | type | 가로 정렬: "left", "center", "right" |
-| `ExcelVerticalAlign` | type | 세로 정렬: "top", "center", "bottom" |
-| `ExcelXml` | interface | XML 처리 클래스가 구현하는 인터페이스 (내부용) |
-
-→ See [docs/types.md](./docs/types.md) for details.
-
-## Usage Examples
-
-### 새 Excel 파일 생성 및 저장
-
-```typescript
-import { ExcelWorkbook } from "@simplysm/excel";
-
-const wb = new ExcelWorkbook();
-try {
-  const ws = await wb.addWorksheet("Sheet1");
-  
-  // 헤더 행
-  await ws.cell(0, 0).setValue("이름");
-  await ws.cell(0, 1).setValue("나이");
-  
-  // 데이터 행
-  await ws.cell(1, 0).setValue("김철수");
-  await ws.cell(1, 1).setValue(30);
-  
-  const bytes = await wb.toBytes();
-  // 파일 저장 또는 전송
-} finally {
-  await wb.close();
-}
-```
-
-### 기존 Excel 파일 읽기
-
-```typescript
-import { ExcelWorkbook } from "@simplysm/excel";
-
-const bytes = /* 파일 바이트 배열 */;
-const wb = new ExcelWorkbook(bytes);
-try {
-  // 시트명 또는 인덱스(0 기반)로 조회
-  const ws = await wb.getWorksheet(0);
-  
-  // 개별 셀 읽기
-  const value = await ws.cell(0, 0).getValue();
-  
-  // 전체 데이터 테이블 읽기 (첫 행이 헤더)
-  const table = await ws.getDataTable();
-} finally {
-  await wb.close();
-}
-```
-
-### Zod 스키마 기반 타입 안전한 작업
-
-```typescript
-import { ExcelWrapper } from "@simplysm/excel";
-import { z } from "zod";
-
-const schema = z.object({
-  name: z.string().describe("이름"),
-  age: z.number().describe("나이"),
-  email: z.string().optional().describe("이메일"),
-});
-
-const wrapper = new ExcelWrapper(schema);
-
-// 레코드 배열을 Excel로 쓰기
-const records = [
-  { name: "김철수", age: 30, email: "kim@example.com" },
-  { name: "이영희", age: 28 },
-];
-const wb = await wrapper.write("사람", records);
-try {
-  const bytes = await wb.toBytes();
-} finally {
-  await wb.close();
-}
-
-// Excel 파일을 레코드 배열로 읽기 (유효성 검사 포함)
-const bytes = /* 파일 바이트 배열 */;
-const data = await wrapper.read(bytes, "사람");
-```

package/claude/references/sd-simplysm14/lint/usage.md

@@ -1,130 +0,0 @@
-# @simplysm/lint
-
-Simplysm 모노레포 전용 ESLint 플러그인 및 공유 Flat Config 설정. 커스텀 규칙 8개와 권장 설정을 제공한다.
-
-## Installation
-
-```bash
-npm install @simplysm/lint
-```
-
-## API Overview
-
-### Plugin (`@simplysm/lint/eslint-plugin`)
-
-| API | Type | Description |
-|-----|------|-------------|
-| `default` | object | `{ rules: {...} }` 형태의 ESLint 플러그인 객체. 8개의 커스텀 규칙을 포함한다 |
-
-#### Rules
-
-| Rule | Type | Fixable | Description |
-|------|------|---------|-------------|
-| `no-hard-private` | problem | autofix | ECMAScript `#private` 필드를 금지하고 TypeScript `private _` 스타일을 강제한다. 선언(`#field`, `#method()`, `accessor #field`)과 사용(`this.#field`) 모두 감지. 이름 충돌 시 `nameConflict` 메시지 보고 |
-| `no-subpath-imports-from-simplysm` | problem | autofix | `@simplysm/*` 패키지에서 `src` 하위 경로 import를 금지한다. 정적 import, 동적 import, re-export 모두 감지. `@simplysm/pkg/src/...` -> `@simplysm/pkg`로 자동 수정 |
-| `ts-no-throw-not-implemented-error` | suggestion | - | `@simplysm/core-common`의 `NotImplementedError` 사용을 경고한다. named import, aliased import, namespace import 모두 감지. 동적 import는 미감지 |
-| `ts-no-unused-injects` | problem | autofix | 미사용 Angular `inject()` 필드를 감지하여 제거한다. 클래스 내 `inject()` 호출로 초기화된 프로퍼티 중 다른 곳에서 참조되지 않는 필드를 보고 |
-| `ts-no-unused-protected-readonly` | problem | autofix | Angular `@Component` 클래스의 미사용 `protected readonly` 필드를 감지하여 제거한다. 인라인 템플릿과 클래스 본문 모두에서 참조 여부를 확인 |
-| `ng-template-no-todo-comments` | problem | - | HTML 템플릿 내 `<!-- TODO: ... -->` 주석을 경고한다. raw text regex 방식으로 동작 |
-| `ng-template-no-strict-null-check` | problem | - | Angular 템플릿에서 `=== null`, `!== null`, `=== undefined`, `!== undefined` 사용을 금지한다. `== null` / `!= null`로 통일하도록 강제. autofix 미제공(인라인 템플릿 offset 매핑 문제) |
-| `ng-template-sd-require-binding-attrs` | problem | autofix | `sd-*` 컴포넌트에서 허용 목록 외 plain attribute 사용을 금지하고 Angular property binding(`[attr]="..."`)을 강제한다 |
-
-#### `ng-template-sd-require-binding-attrs` Options
-
-유일하게 사용자 옵션을 받는 규칙이다.
-
-| Field | Type | Default | Description |
-|-------|------|---------|-------------|
-| `selectorPrefixes` | `string[]` | `["sd-"]` | 검사 대상 엘리먼트의 태그명 접두사 목록 |
-| `allowAttributes` | `string[]` | `["id", "class", "style", "title", "tabindex", "role"]` | plain attribute로 허용할 속성명 목록 |
-| `allowAttributePrefixes` | `string[]` | `["aria-", "data-", "sd-"]` | plain attribute로 허용할 속성명 접두사 목록 |
-
-### Recommended Config (`@simplysm/lint/eslint-recommended`)
-
-| API | Type | Description |
-|-----|------|-------------|
-| `default` | `FlatConfig.Config[]` | `tseslint.config()`으로 생성된 Flat Config 배열. 커스텀 플러그인과 외부 플러그인을 조합한 권장 설정 |
-
-#### Config 블록 구성
-
-| 파일 패턴 | 적용 플러그인 | 주요 규칙 |
-|-----------|-------------|-----------|
-| `**/*.js`, `**/*.mjs`, `**/*.cjs` | `@simplysm`, `import`, `unused-imports` | `no-hard-private`, `no-subpath-imports-from-simplysm`, `require-await`, `no-shadow` |
-| `**/*.ts` | `@typescript-eslint`, `@simplysm`, `import`, `unused-imports`, `angular-eslint` | 전체 커스텀 규칙 + `require-await`, `strict-boolean-expressions`, `prefer-readonly`, `only-throw-error`, `no-array-delete` 등 |
-| `**/*.html` | `@simplysm`, `@angular-eslint/template` (recommended + accessibility) | `ng-template-no-todo-comments`, `ng-template-sd-require-binding-attrs` |
-| `**/tests/**/*.ts` | - | `no-console`, `import/no-extraneous-dependencies`, `ts-no-throw-not-implemented-error` 비활성화 |
-| `**/vitest.config.ts` | - | `no-restricted-properties` 비활성화 (`process.env` 접근 허용) |
-
-#### 공유 규칙 변수
-
-| Variable | Description |
-|----------|-------------|
-| `commonRules` | `eqeqeq` (`null` 비교만 `==` 허용), `no-warning-comments`, `no-self-compare`, `array-callback-return` |
-| `noNodeBuiltinsRules` | `Buffer` 전역 사용 금지, `buffer`/`events`/`eventemitter3` import 금지 |
-| `noDirectEnvAccessRules` | `process.env` 및 `import.meta.env` 직접 접근 금지 (`env("...")` 사용 강제), `NODE_ENV` 환경변수 사용 금지 |
-| `unusedImportsRules` | 미사용 import 자동 제거 (`_` 접두사 변수 무시) |
-
-#### Ignores
-
-`node_modules/`, `dist/`, `.*` (dotfiles), `_*` (underscore-prefixed) 디렉토리를 무시한다.
-
-### Utility (internal)
-
-| API | Type | Description |
-|-----|------|-------------|
-| `createRule` | const | `ESLintUtils.RuleCreator` 래퍼. 규칙 문서 URL을 자동 생성한다. 패키지 내부에서만 사용되며 entrypoint에서 export되지 않는다 |
-
-## Usage Examples
-
-### Flat Config에서 권장 설정 사용
-
-```typescript
-// eslint.config.js
-import recommended from "@simplysm/lint/eslint-recommended";
-
-export default [
-  ...recommended,
-  // 프로젝트별 추가 설정
-];
-```
-
-### 플러그인만 사용하여 개별 규칙 활성화
-
-```typescript
-// eslint.config.js
-import plugin from "@simplysm/lint/eslint-plugin";
-
-export default [
-  {
-    plugins: {
-      "@simplysm": plugin,
-    },
-    rules: {
-      "@simplysm/no-hard-private": "error",
-      "@simplysm/no-subpath-imports-from-simplysm": "error",
-    },
-  },
-];
-```
-
-### `ng-template-sd-require-binding-attrs` 옵션 커스터마이징
-
-```typescript
-// eslint.config.js
-export default [
-  ...recommended,
-  {
-    files: ["**/*.html"],
-    rules: {
-      "@simplysm/ng-template-sd-require-binding-attrs": [
-        "error",
-        {
-          selectorPrefixes: ["sd-", "app-"],
-          allowAttributes: ["id", "class", "style", "title", "tabindex", "role", "name"],
-          allowAttributePrefixes: ["aria-", "data-", "sd-", "app-"],
-        },
-      ],
-    },
-  },
-];
-```

package/claude/references/sd-simplysm14/orm-common/docs/core.md

@@ -1,188 +0,0 @@
-# Core
-
-## `DbContext`
-
-DB 연결/트랜잭션/DDL/초기화를 제공하는 추상 클래스. `queryable()`/`executable()`로 테이블/프로시저를 등록한다. 각 프로퍼티가 독립 직렬화되어 40+ 테이블에서도 TS7056이 발생하지 않는다.
-
-```typescript
-export abstract class DbContext implements DbContextBase {
-  status: DbContextStatus;
-  migrations: Migration[];
-
-  constructor(
-    executor: DbContextExecutor,
-    opt: { database: string; schema?: string },
-  );
-
-  // 등록 메서드
-  protected queryable<T extends TableBuilder | ViewBuilder>(builder: T): () => Queryable;
-  protected executable<T extends ProcedureBuilder>(builder: T): () => Executable;
-
-  // 연결 관리
-  connect<TResult>(fn: () => Promise<TResult>, isolationLevel?: IsolationLevel): Promise<TResult>;
-  connectWithoutTransaction<TResult>(callback: () => Promise<TResult>): Promise<TResult>;
-  transaction<TResult>(fn: () => Promise<TResult>, isolationLevel?: IsolationLevel): Promise<TResult>;
-
-  // DDL 실행 메서드
-  createTable(table: TableBuilder): Promise<void>;
-  dropTable(table: QueryDefObjectName): Promise<void>;
-  renameTable(table: QueryDefObjectName, newName: string): Promise<void>;
-  createView(view: ViewBuilder): Promise<void>;
-  dropView(view: QueryDefObjectName): Promise<void>;
-  createProc(procedure: ProcedureBuilder): Promise<void>;
-  dropProc(procedure: QueryDefObjectName): Promise<void>;
-  addColumn(table: QueryDefObjectName, columnName: string, column: ColumnBuilder): Promise<void>;
-  dropColumn(table: QueryDefObjectName, column: string): Promise<void>;
-  modifyColumn(table: QueryDefObjectName, columnName: string, column: ColumnBuilder): Promise<void>;
-  renameColumn(table: QueryDefObjectName, column: string, newName: string): Promise<void>;
-  addPrimaryKey(table: QueryDefObjectName, columns: string[]): Promise<void>;
-  dropPrimaryKey(table: QueryDefObjectName): Promise<void>;
-  addForeignKey(table: QueryDefObjectName, relationName: string, relationDef: ForeignKeyBuilder): Promise<void>;
-  addIndex(table: QueryDefObjectName, indexBuilder: IndexBuilder): Promise<void>;
-  dropForeignKey(table: QueryDefObjectName, relationName: string): Promise<void>;
-  dropIndex(table: QueryDefObjectName, columns: string[]): Promise<void>;
-  clearSchema(params: { database: string; schema?: string }): Promise<void>;
-  schemaExists(database: string, schema?: string): Promise<boolean>;
-  truncate(table: QueryDefObjectName): Promise<void>;
-  switchFk(table: QueryDefObjectName, enabled: boolean): Promise<void>;
-
-  // DDL QueryDef 생성기 (getCreateTableQueryDef, getDropTableQueryDef, ... 등 동일 시그니처)
-  getCreateTableQueryDef(table: TableBuilder): QueryDef;
-  getCreateViewQueryDef(view: ViewBuilder): QueryDef;
-  getCreateProcQueryDef(procedure: ProcedureBuilder): QueryDef;
-  getCreateObjectQueryDef(builder: TableBuilder | ViewBuilder | ProcedureBuilder): QueryDef;
-  getDropTableQueryDef(table: QueryDefObjectName): QueryDef;
-  getRenameTableQueryDef(table: QueryDefObjectName, newName: string): QueryDef;
-  getDropViewQueryDef(view: QueryDefObjectName): QueryDef;
-  getDropProcQueryDef(procedure: QueryDefObjectName): QueryDef;
-  getAddColumnQueryDef(table: QueryDefObjectName, columnName: string, column: ColumnBuilder): QueryDef;
-  getDropColumnQueryDef(table: QueryDefObjectName, column: string): QueryDef;
-  getModifyColumnQueryDef(table: QueryDefObjectName, columnName: string, column: ColumnBuilder): QueryDef;
-  getRenameColumnQueryDef(table: QueryDefObjectName, column: string, newName: string): QueryDef;
-  getAddPrimaryKeyQueryDef(table: QueryDefObjectName, columns: string[]): QueryDef;
-  getDropPrimaryKeyQueryDef(table: QueryDefObjectName): QueryDef;
-  getAddForeignKeyQueryDef(table: QueryDefObjectName, relationName: string, relationDef: ForeignKeyBuilder): QueryDef;
-  getAddIndexQueryDef(table: QueryDefObjectName, indexBuilder: IndexBuilder): QueryDef;
-  getDropForeignKeyQueryDef(table: QueryDefObjectName, relationName: string): QueryDef;
-  getDropIndexQueryDef(table: QueryDefObjectName, columns: string[]): QueryDef;
-  getClearSchemaQueryDef(params: { database: string; schema?: string }): QueryDef;
-  getSchemaExistsQueryDef(database: string, schema?: string): QueryDef;
-  getTruncateQueryDef(table: QueryDefObjectName): QueryDef;
-  getSwitchFkQueryDef(table: QueryDefObjectName, enabled: boolean): QueryDef;
-
-  // 초기화
-  initialize(options?: { dbs?: string[]; force?: boolean }): Promise<boolean>;
-
-  // DbContextBase 구현
-  get database(): string | undefined;
-  get schema(): string | undefined;
-  getNextAlias(): string;
-  resetAliasCounter(): void;
-  executeDefs<T>(defs: QueryDef[], resultMetas?: (ResultMeta | undefined)[]): Promise<T[][]>;
-  getQueryDefObjectName(tableOrView: TableBuilder | ViewBuilder): QueryDefObjectName;
-}
-```
-
-### 연결/트랜잭션 패턴
-
-| 메서드 | 용도 |
-|--------|------|
-| `connect(fn)` | 연결 -> 트랜잭션 시작 -> fn -> 커밋 -> 종료. 일반 DML 작업에 사용 |
-| `connectWithoutTransaction(fn)` | 연결 -> fn -> 종료. 트랜잭션 없는 DDL/읽기 전용 작업에 사용 |
-| `transaction(fn)` | 이미 연결된 상태에서 부분 트랜잭션 시작. `connectWithoutTransaction` 내부에서 사용 |
-
-- `connect()`/`connectWithoutTransaction()`은 status가 `"ready"`가 아니면 에러를 던진다 (재진입 방지).
-- 트랜잭션 중 DDL 실행은 런타임 에러를 발생시킨다.
-- 롤백 실패 시 원래 에러의 `cause`에 롤백 에러를 첨부하여 전파한다.
-
-## `SD_BUILDER`
-
-DbContext의 queryable/executable 프로퍼티에 부착된 builder 참조용 Symbol.
-
-```typescript
-export const SD_BUILDER: unique symbol;
-```
-
-## `DbContextBase`
-
-Queryable, Executable, ViewBuilder에서 사용하는 DbContext 내부 인터페이스. DbContext class가 이 인터페이스를 구현한다.
-
-```typescript
-export interface DbContextBase {
-  status: DbContextStatus;
-  readonly database: string | undefined;
-  readonly schema: string | undefined;
-  getNextAlias(): string;
-  resetAliasCounter(): void;
-  executeDefs<T = DataRecord>(defs: QueryDef[], resultMetas?: (ResultMeta | undefined)[]): Promise<T[][]>;
-  getQueryDefObjectName(tableOrView: TableBuilder | ViewBuilder): QueryDefObjectName;
-  switchFk(table: QueryDefObjectName, enabled: boolean): Promise<void>;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `status` | `DbContextStatus` | 현재 연결 상태 |
-| `database` | `string \| undefined` | 데이터베이스 이름 |
-| `schema` | `string \| undefined` | 스키마 이름 |
-
-## `DbContextStatus`
-
-DbContext 상태를 나타내는 문자열 리터럴 유니온.
-
-```typescript
-export type DbContextStatus = "ready" | "connect" | "transact";
-```
-
-## `DbContextDdlMethods`
-
-DDL 실행 메서드 인터페이스. DbContext에서 사용하는 모든 DDL 메서드 시그니처를 정의한다. DDL 실행 메서드와 DDL QueryDef 생성 메서드를 모두 포함한다.
-
-```typescript
-export interface DbContextDdlMethods {
-  createTable(table: TableBuilder): Promise<void>;
-  dropTable(table: QueryDefObjectName): Promise<void>;
-  // ... (DbContext의 DDL 메서드와 동일한 시그니처)
-}
-```
-
-## `DbErrorCode`
-
-트랜잭션 관련 에러 코드. DBMS별 네이티브 에러 코드를 추상화한다.
-
-```typescript
-export enum DbErrorCode {
-  NO_ACTIVE_TRANSACTION = "NO_ACTIVE_TRANSACTION",
-  TRANSACTION_ALREADY_STARTED = "TRANSACTION_ALREADY_STARTED",
-  DEADLOCK = "DEADLOCK",
-  LOCK_TIMEOUT = "LOCK_TIMEOUT",
-}
-```
-
-| Value | Description |
-|-------|-------------|
-| `NO_ACTIVE_TRANSACTION` | 활성 트랜잭션 없음 (ROLLBACK 시) |
-| `TRANSACTION_ALREADY_STARTED` | 트랜잭션 이미 시작됨 |
-| `DEADLOCK` | 데드락 발생 |
-| `LOCK_TIMEOUT` | 잠금 타임아웃 |
-
-## `DbTransactionError`
-
-DBMS별 네이티브 에러를 표준화된 에러 코드로 래핑하는 에러 클래스.
-
-```typescript
-export class DbTransactionError extends Error {
-  override readonly name = "DbTransactionError";
-
-  constructor(
-    public readonly code: DbErrorCode,
-    message: string,
-    public readonly originalError?: unknown,
-  );
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `code` | `DbErrorCode` | 표준화된 에러 코드 |
-| `originalError` | `unknown \| undefined` | 원본 DBMS 에러 (디버깅용) |