@simplysm/sd-claude 14.0.46 → 14.0.48

package/claude/references/sd-simplysm14/core-node/docs/utilities-fsx.md

@@ -1,469 +0,0 @@
-# Utilities — fsx
-
-`fsx`는 `@simplysm/core-node`에서 네임스페이스로 re-export되는 파일 시스템 유틸리티 모음이다.
-
-```typescript
-import { fsx } from "@simplysm/core-node";
-```
-
----
-
-## `exists`
-
-파일 또는 디렉토리가 존재하는지 확인한다 (비동기).
-
-```typescript
-export async function exists(targetPath: string): Promise<boolean>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 확인할 경로 |
-
----
-
-## `existsSync`
-
-파일 또는 디렉토리가 존재하는지 확인한다 (동기).
-
-```typescript
-export function existsSync(targetPath: string): boolean
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 확인할 경로 |
-
----
-
-## `mkdir`
-
-디렉토리를 재귀적으로 생성한다 (비동기).
-
-```typescript
-export async function mkdir(targetPath: string): Promise<void>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 생성할 디렉토리 경로 |
-
----
-
-## `mkdirSync`
-
-디렉토리를 재귀적으로 생성한다 (동기).
-
-```typescript
-export function mkdirSync(targetPath: string): void
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 생성할 디렉토리 경로 |
-
----
-
-## `rm`
-
-파일 또는 디렉토리를 삭제한다 (비동기). 파일 잠금 등 일시적 오류에 대해 최대 6회(500ms 간격) 재시도한다.
-
-```typescript
-export async function rm(targetPath: string): Promise<void>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 삭제할 경로 |
-
----
-
-## `rmSync`
-
-파일 또는 디렉토리를 삭제한다 (동기). 재시도 없이 즉시 실패한다.
-
-```typescript
-export function rmSync(targetPath: string): void
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 삭제할 경로 |
-
----
-
-## `copy`
-
-파일 또는 디렉토리를 복사한다 (비동기). sourcePath가 존재하지 않으면 아무 작업도 수행하지 않는다.
-
-```typescript
-export async function copy(
-  sourcePath: string,
-  targetPath: string,
-  filter?: (absolutePath: string) => boolean,
-): Promise<void>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `sourcePath` | `string` | 복사할 원본 경로 |
-| `targetPath` | `string` | 복사 대상 경로 |
-| `filter` | `(absolutePath: string) => boolean` | 복사 여부를 결정하는 필터 함수. 각 파일/디렉토리의 절대 경로가 전달된다. 최상위 sourcePath는 필터 대상이 아니다. |
-
----
-
-## `copySync`
-
-파일 또는 디렉토리를 복사한다 (동기). sourcePath가 존재하지 않으면 아무 작업도 수행하지 않는다.
-
-```typescript
-export function copySync(
-  sourcePath: string,
-  targetPath: string,
-  filter?: (absolutePath: string) => boolean,
-): void
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `sourcePath` | `string` | 복사할 원본 경로 |
-| `targetPath` | `string` | 복사 대상 경로 |
-| `filter` | `(absolutePath: string) => boolean` | 복사 여부를 결정하는 필터 함수 |
-
----
-
-## `read`
-
-파일을 UTF-8 문자열로 읽는다 (비동기).
-
-```typescript
-export async function read(targetPath: string): Promise<string>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 읽을 파일 경로 |
-
----
-
-## `readSync`
-
-파일을 UTF-8 문자열로 읽는다 (동기).
-
-```typescript
-export function readSync(targetPath: string): string
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 읽을 파일 경로 |
-
----
-
-## `readBytes`
-
-파일을 Uint8Array로 읽는다 (비동기).
-
-```typescript
-export async function readBytes(targetPath: string): Promise<Uint8Array>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 읽을 파일 경로 |
-
----
-
-## `readBytesSync`
-
-파일을 Uint8Array로 읽는다 (동기).
-
-```typescript
-export function readBytesSync(targetPath: string): Uint8Array
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 읽을 파일 경로 |
-
----
-
-## `readJson`
-
-JSON 파일을 읽는다 (비동기). `@simplysm/core-common`의 `json.parse`를 사용한다.
-
-```typescript
-export async function readJson<TData = unknown>(targetPath: string): Promise<TData>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 읽을 JSON 파일 경로 |
-
----
-
-## `readJsonSync`
-
-JSON 파일을 읽는다 (동기). `@simplysm/core-common`의 `json.parse`를 사용한다.
-
-```typescript
-export function readJsonSync<TData = unknown>(targetPath: string): TData
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 읽을 JSON 파일 경로 |
-
----
-
-## `write`
-
-파일에 데이터를 쓴다 (비동기). 상위 디렉토리를 자동으로 생성한다.
-
-```typescript
-export async function write(targetPath: string, data: string | Uint8Array): Promise<void>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 쓸 파일 경로 |
-| `data` | `string \| Uint8Array` | 쓸 데이터 |
-
----
-
-## `writeSync`
-
-파일에 데이터를 쓴다 (동기). 상위 디렉토리를 자동으로 생성한다.
-
-```typescript
-export function writeSync(targetPath: string, data: string | Uint8Array): void
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 쓸 파일 경로 |
-| `data` | `string \| Uint8Array` | 쓸 데이터 |
-
----
-
-## `writeJson`
-
-JSON 파일에 데이터를 쓴다 (비동기). `@simplysm/core-common`의 `json.stringify`를 사용한다.
-
-```typescript
-export async function writeJson(
-  targetPath: string,
-  data: unknown,
-  options?: {
-    replacer?: (this: unknown, key: string | undefined, value: unknown) => unknown;
-    space?: string | number;
-  },
-): Promise<void>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 쓸 JSON 파일 경로 |
-| `data` | `unknown` | 쓸 데이터 |
-| `options.replacer` | `function` | JSON 직렬화 커스텀 replacer |
-| `options.space` | `string \| number` | 들여쓰기 지정 |
-
----
-
-## `writeJsonSync`
-
-JSON 파일에 데이터를 쓴다 (동기). `@simplysm/core-common`의 `json.stringify`를 사용한다.
-
-```typescript
-export function writeJsonSync(
-  targetPath: string,
-  data: unknown,
-  options?: {
-    replacer?: (this: unknown, key: string | undefined, value: unknown) => unknown;
-    space?: string | number;
-  },
-): void
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 쓸 JSON 파일 경로 |
-| `data` | `unknown` | 쓸 데이터 |
-| `options.replacer` | `function` | JSON 직렬화 커스텀 replacer |
-| `options.space` | `string \| number` | 들여쓰기 지정 |
-
----
-
-## `readdir`
-
-디렉토리의 내용을 읽는다 (비동기).
-
-```typescript
-export async function readdir(targetPath: string): Promise<string[]>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 읽을 디렉토리 경로 |
-
-**반환**: 디렉토리 내 항목 이름 배열 (상대 이름, 절대 경로 아님)
-
----
-
-## `readdirSync`
-
-디렉토리의 내용을 읽는다 (동기).
-
-```typescript
-export function readdirSync(targetPath: string): string[]
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 읽을 디렉토리 경로 |
-
-**반환**: 디렉토리 내 항목 이름 배열 (상대 이름, 절대 경로 아님)
-
----
-
-## `stat`
-
-파일/디렉토리 정보를 가져온다 (비동기). 심볼릭 링크를 따라간다.
-
-```typescript
-export async function stat(targetPath: string): Promise<fs.Stats>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 정보를 조회할 경로 |
-
----
-
-## `statSync`
-
-파일/디렉토리 정보를 가져온다 (동기). 심볼릭 링크를 따라간다.
-
-```typescript
-export function statSync(targetPath: string): fs.Stats
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 정보를 조회할 경로 |
-
----
-
-## `lstat`
-
-파일/디렉토리 정보를 가져온다 (비동기). 심볼릭 링크를 따라가지 않는다.
-
-```typescript
-export async function lstat(targetPath: string): Promise<fs.Stats>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 정보를 조회할 경로 |
-
----
-
-## `lstatSync`
-
-파일/디렉토리 정보를 가져온다 (동기). 심볼릭 링크를 따라가지 않는다.
-
-```typescript
-export function lstatSync(targetPath: string): fs.Stats
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `targetPath` | `string` | 정보를 조회할 경로 |
-
----
-
-## `glob`
-
-Glob 패턴을 사용하여 파일을 검색한다 (비동기).
-
-```typescript
-export async function glob(pattern: string, options?: GlobOptions): Promise<string[]>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `pattern` | `string` | Glob 패턴 (예: `"**/*.ts"`) |
-| `options` | `GlobOptions` | glob 패키지 옵션 |
-
-**반환**: 매칭된 파일의 절대 경로 배열
-
----
-
-## `globSync`
-
-Glob 패턴을 사용하여 파일을 검색한다 (동기).
-
-```typescript
-export function globSync(pattern: string, options?: GlobOptions): string[]
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `pattern` | `string` | Glob 패턴 (예: `"**/*.ts"`) |
-| `options` | `GlobOptions` | glob 패키지 옵션 |
-
-**반환**: 매칭된 파일의 절대 경로 배열
-
----
-
-## `clearEmptyDirectory`
-
-지정된 디렉토리 하위의 빈 디렉토리를 재귀적으로 삭제한다. 모든 하위 디렉토리가 삭제되어 상위 디렉토리가 비게 되면 해당 디렉토리도 삭제된다.
-
-```typescript
-export async function clearEmptyDirectory(dirPath: string): Promise<void>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `dirPath` | `string` | 빈 디렉토리를 정리할 루트 디렉토리 경로 |
-
----
-
-## `findAllParentChildPaths`
-
-시작 경로에서 루트 방향으로 부모 디렉토리를 순회하며 glob 패턴에 매칭되는 파일을 검색한다 (비동기).
-
-```typescript
-export async function findAllParentChildPaths(
-  childGlob: string,
-  fromPath: string,
-  rootPath?: string,
-): Promise<string[]>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `childGlob` | `string` | 각 디렉토리에서 검색할 glob 패턴 |
-| `fromPath` | `string` | 검색을 시작할 경로 |
-| `rootPath` | `string` | 검색을 중단할 경로. 미지정 시 파일 시스템 루트까지 검색. fromPath는 rootPath의 하위 경로여야 한다 |
-
----
-
-## `findAllParentChildPathsSync`
-
-시작 경로에서 루트 방향으로 부모 디렉토리를 순회하며 glob 패턴에 매칭되는 파일을 검색한다 (동기).
-
-```typescript
-export function findAllParentChildPathsSync(
-  childGlob: string,
-  fromPath: string,
-  rootPath?: string,
-): string[]
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `childGlob` | `string` | 각 디렉토리에서 검색할 glob 패턴 |
-| `fromPath` | `string` | 검색을 시작할 경로 |
-| `rootPath` | `string` | 검색을 중단할 경로. 미지정 시 파일 시스템 루트까지 검색 |

package/claude/references/sd-simplysm14/core-node/docs/utilities-pathx.md

@@ -1,151 +0,0 @@
-# Utilities — pathx
-
-`pathx`는 `@simplysm/core-node`에서 네임스페이스로 re-export되는 경로 유틸리티 모음이다.
-
-```typescript
-import { pathx } from "@simplysm/core-node";
-```
-
----
-
-## `PosixPath`
-
-POSIX 스타일(슬래시 `/`) 경로를 나타내는 브랜드 타입. `posix()` 또는 `posixResolve()`를 통해서만 생성할 수 있다.
-
-```typescript
-export type PosixPath = string & {
-  [POSIX]: never;
-};
-```
-
-`FsWatcher`가 반환하는 경로는 항상 `PosixPath`다.
-
----
-
-## `posix`
-
-POSIX 스타일 경로로 변환한다 (백슬래시 → 슬래시). 경로 결합이나 resolve는 수행하지 않는다.
-
-```typescript
-export function posix(p: string): PosixPath
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `p` | `string` | 변환할 경로 |
-
-```typescript
-pathx.posix("C:\\Users\\test"); // "C:/Users/test"
-```
-
----
-
-## `posixResolve`
-
-절대 경로로 resolve한 뒤 POSIX 스타일로 변환한다.
-
-```typescript
-export function posixResolve(...args: string[]): PosixPath
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `...args` | `string[]` | `path.resolve()`에 전달할 경로 세그먼트 |
-
-```typescript
-pathx.posixResolve("/base", "sub", "file.txt"); // "/base/sub/file.txt"
-pathx.posixResolve("relative/path"); // "D:/cwd/relative/path" (절대 경로화)
-```
-
----
-
-## `changeFileDirectory`
-
-파일 경로의 디렉토리를 변경한다.
-
-```typescript
-export function changeFileDirectory(
-  filePath: string,
-  fromDirectory: string,
-  toDirectory: string,
-): string
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `filePath` | `string` | 변경할 파일 경로 |
-| `fromDirectory` | `string` | 원래 디렉토리 경로 |
-| `toDirectory` | `string` | 새로운 디렉토리 경로 |
-
-**Throws**: `filePath`가 `fromDirectory` 내부에 없는 경우 `ArgumentError`를 던진다.
-
-```typescript
-pathx.changeFileDirectory("/a/b/c.txt", "/a", "/x");
-// → "/x/b/c.txt"
-```
-
----
-
-## `basenameWithoutExt`
-
-확장자를 제외한 파일명(basename)을 반환한다.
-
-```typescript
-export function basenameWithoutExt(filePath: string): string
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `filePath` | `string` | 파일 경로 |
-
-```typescript
-pathx.basenameWithoutExt("file.txt");           // "file"
-pathx.basenameWithoutExt("/path/to/file.spec.ts"); // "file.spec"
-```
-
----
-
-## `isChildPath`
-
-`childPath`가 `parentPath`의 하위 경로인지 확인한다. 동일한 경로이면 `false`를 반환한다.
-
-경로는 내부적으로 `posixResolve()`를 사용하여 정규화된다.
-
-```typescript
-export function isChildPath(childPath: string, parentPath: string): boolean
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `childPath` | `string` | 자식 경로 후보 |
-| `parentPath` | `string` | 부모 경로 |
-
-```typescript
-pathx.isChildPath("/a/b/c", "/a/b"); // true
-pathx.isChildPath("/a/b", "/a/b/c"); // false
-pathx.isChildPath("/a/b", "/a/b");   // false (동일 경로)
-```
-
----
-
-## `filterByTargets`
-
-대상 경로 목록을 기반으로 파일을 필터링한다. 대상 경로와 일치하거나 하위에 있는 파일을 포함한다.
-
-```typescript
-export function filterByTargets(files: string[], targets: string[], cwd: string): string[]
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `files` | `string[]` | 필터링할 파일 경로. cwd 하위의 절대 경로여야 한다 |
-| `targets` | `string[]` | 대상 경로 (cwd 기준 상대 경로, POSIX 스타일 권장) |
-| `cwd` | `string` | 현재 작업 디렉토리 (절대 경로) |
-
-**반환**: `targets`가 비어있으면 `files`를 그대로 반환. 그렇지 않으면 대상 경로 하위의 파일만 반환.
-
-```typescript
-const files = ["/proj/src/a.ts", "/proj/src/b.ts", "/proj/tests/c.ts"];
-pathx.filterByTargets(files, ["src"], "/proj");
-// → ["/proj/src/a.ts", "/proj/src/b.ts"]
-```