@simplysm/sd-claude 14.0.50 → 14.0.52

package/claude/references/sd-simplysm-v14/sd-cli/README.md

@@ -0,0 +1,138 @@
+# @simplysm/sd-cli
+
+Simplysm 모노레포용 빌드/개발/배포 CLI 도구. `sd.config.ts` 설정 타입과 Angular AOT Vite 플러그인(`sdAngularPlugin`)을 export한다.
+
+## Installation
+
+```bash
+npm install @simplysm/sd-cli
+```
+
+## 하려는 작업 → 먼저 읽을 파일
+
+| 작업 | 먼저 읽을 파일 |
+|------|----------------|
+| `sd.config.ts` 작성 | [SdConfig](./config/sd-config.md), [SdPackageConfig](./config/sd-package-config.md) |
+| 클라이언트 패키지 설정 | [SdClientPackageConfig](./config/sd-client-package-config.md) |
+| 서버 패키지 설정 | [SdServerPackageConfig](./config/sd-server-package-config.md) |
+| 배포 설정 (npm/FTP/SFTP) | [SdPublishConfig](./config/sd-publish-config.md) |
+| Capacitor 앱 설정 | [SdCapacitorConfig](./config/sd-capacitor-config.md) |
+| Electron 앱 설정 | [SdElectronConfig](./config/sd-electron-config.md) |
+| 프로그래매틱 TypeScript 컴파일 | [SdTsCompiler](./ts-compiler/sd-ts-compiler.md) |
+| Vitest Angular 테스트 | [sdAngularPlugin](./angular-vite-plugin/sd-angular-plugin.md) |
+
+## API Overview
+
+### Config
+
+| Entry | Kind | 언제 쓰나 |
+|-------|------|-----------|
+| [`SdConfig`](./config/sd-config.md) | interface | `sd.config.ts` 작성 시 최상위 설정 타입이 필요할 때 |
+| [`SdPackageConfig`](./config/sd-package-config.md) | type | 패키지 target에 따라 분기해야 할 때 (`target` 필드 discriminated union) |
+| [`SdBuildPackageConfig`](./config/sd-build-package-config.md) | interface | `node`/`browser`/`neutral` 라이브러리 패키지를 설정할 때 |
+| [`SdClientPackageConfig`](./config/sd-client-package-config.md) | interface | `client` 타겟 프론트엔드 패키지를 설정할 때 |
+| [`SdServerPackageConfig`](./config/sd-server-package-config.md) | interface | `server` 타겟 Fastify 서버 패키지를 설정할 때 |
+| [`SdScriptsPackageConfig`](./config/sd-scripts-package-config.md) | interface | 빌드 없이 watch 훅만 실행하는 스크립트 패키지를 설정할 때 |
+| [`BuildTarget`](./config/build-target.md) | type | 라이브러리 패키지의 빌드 플랫폼을 지정할 때 (`"node"` \| `"browser"` \| `"neutral"`) |
+| [`SdPublishConfig`](./config/sd-publish-config.md) | type | 패키지 배포 방식을 설정할 때 (npm / 로컬 디렉토리 / FTP·SFTP) |
+| [`SdPostPublishScriptConfig`](./config/sd-post-publish-script-config.md) | interface | 배포 후 스크립트를 실행할 때 |
+| [`SdCapacitorConfig`](./config/sd-capacitor-config.md) | interface | 클라이언트 패키지에 Capacitor 모바일 앱 설정을 추가할 때 |
+| [`SdElectronConfig`](./config/sd-electron-config.md) | interface | 클라이언트 패키지에 Electron 데스크톱 앱 설정을 추가할 때 |
+| [`SdPwaConfig`](./config/sd-pwa-config.md) | interface | PWA manifest를 설정할 때 |
+| [`SdBrowserSupportConfig`](./config/sd-browser-support-config.md) | interface | 클라이언트 패키지의 브라우저 호환성(browserslist, PostCSS)을 설정할 때 |
+| [`SdWatchHookConfig`](./config/sd-watch-hook-config.md) | interface | watch 모드에서 파일 변경 시 명령어 훅을 실행할 때 |
+| [`NpmConfig`](./config/npm-config.md) | interface | `package.json` 구조를 타입으로 참조해야 할 때 |
+
+### TypeScript Compiler
+
+| Entry | Kind | 언제 쓰나 |
+|-------|------|-----------|
+| [`SdTsCompiler`](./ts-compiler/sd-ts-compiler.md) | class | Angular/TS 패키지를 프로그래매틱하게 AOT 컴파일할 때 |
+
+### Angular Vite Plugin
+
+| Entry | Kind | 언제 쓰나 |
+|-------|------|-----------|
+| [`sdAngularPlugin`](./angular-vite-plugin/sd-angular-plugin.md) | function | Vitest에서 Angular 컴포넌트 테스트 시 AOT 컴파일이 필요할 때 |
+
+## Usage Examples
+
+### SdTsCompiler를 사용한 TypeScript 컴파일
+
+```typescript
+import { SdTsCompiler } from "@simplysm/sd-cli";
+
+const compiler = new SdTsCompiler({
+  pkgDir: "/workspace/packages/my-lib",
+  cwd: "/workspace",
+  output: { js: true, dts: true },
+  lint: true,
+  globalScss: true,
+});
+
+// 초기 컴파일
+const result = await compiler.compileAsync();
+
+if (result.errors) {
+  console.error("Compilation errors:", result.errors);
+  process.exit(1);
+}
+
+console.log(`Compiled ${result.affectedFiles?.size ?? "all"} files`);
+```
+
+### watch 모드에서 증분 컴파일
+
+```typescript
+import { SdTsCompiler } from "@simplysm/sd-cli";
+
+const compiler = new SdTsCompiler({
+  pkgDir: "/workspace/packages/my-lib",
+  cwd: "/workspace",
+  output: { js: true, dts: true },
+});
+
+// 초기 컴파일
+let result = await compiler.compileAsync();
+
+// 파일 변경 감지 시 증분 컴파일
+const changedFiles = new Set(["/workspace/packages/my-lib/src/foo.ts"]);
+result = await compiler.compileAsync(changedFiles);
+
+// SCSS 의존성이 변경된 TS 파일 찾기
+const affectedByScss = compiler.findAffectedByScss("/workspace/packages/my-lib/scss/variables.scss");
+```
+
+### sd.config.ts 작성
+
+```typescript
+import type { SdConfigFn } from "@simplysm/sd-cli";
+
+const config: SdConfigFn = (params) => ({
+  packages: {
+    "core-common": { target: "neutral" },
+    "core-node": { target: "node" },
+    "my-client": {
+      target: "client",
+      server: "my-server",
+    },
+    "my-server": {
+      target: "server",
+      publish: { type: "npm" },
+    },
+  },
+});
+
+export default config;
+```
+
+### Vite에서 Angular AOT 플러그인 사용
+
+```typescript
+import { defineConfig } from "vite";
+import { sdAngularPlugin } from "@simplysm/sd-cli";
+
+export default defineConfig({
+  plugins: [sdAngularPlugin({ pkg: "my-client" })],
+});
+```

package/claude/references/sd-simplysm-v14/sd-cli/angular-vite-plugin/sd-angular-plugin.md

@@ -0,0 +1,60 @@
+# sdAngularPlugin
+
+Angular AOT 컴파일을 수행하는 Vite 플러그인. Vitest 환경에서 Angular 컴포넌트를 포함한 TypeScript 패키지를 컴파일할 때 사용한다.
+
+## When to use
+
+- ✅ Vitest에서 Angular 컴포넌트/서비스를 포함한 패키지를 테스트할 때 — `vitest.config.ts`에 플러그인 등록
+- ❌ 프로덕션 빌드 — sd-cli가 내부적으로 esbuild + Angular 컴파일러 플러그인을 사용하므로 직접 사용 불필요
+- ❌ Non-Angular 패키지 테스트 — Vite의 기본 TypeScript 처리로 충분
+
+```typescript
+export function sdAngularPlugin(options: SdAngularPluginOptions): Plugin;
+```
+
+## Parameters
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `options` | `SdAngularPluginOptions` | 플러그인 옵션 |
+
+## Returns
+
+`Plugin` — Vite 플러그인 객체
+
+## Vite 훅
+
+| 훅 | 동작 |
+|----|------|
+| `config` | `process.cwd()/packages/{pkg}` 경로를 `resolvedPkgDir`로 초기화 |
+| `watchChange` | Vitest watch 모드에서 변경된 파일 경로를 `pendingWatchChanges`에 수집 |
+| `buildStart` | `SdTsCompiler` 초기화 → `compileAsync()` → emit 결과를 내부 맵에 캐싱. watch 재빌드 시 변경 파일로 증분 재컴파일 |
+| `transform` | `.ts` 파일 요청 시 캐싱된 컴파일 결과 반환 + 인라인 소스맵 분리 |
+| `buildEnd` | `SdTsCompiler` 참조 해제 |
+
+## Related Types
+
+### `SdAngularPluginOptions`
+
+```typescript
+export interface SdAngularPluginOptions {
+  pkg: string;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `pkg` | `string` | `sd.config.ts` `packages` 키 (패키지 디렉토리명). 예: `"my-client"` |
+
+## Usage
+
+`vite.config.ts` 또는 `vitest.config.ts`에 플러그인을 등록한다.
+
+```typescript
+import { defineConfig } from "vite";
+import { sdAngularPlugin } from "@simplysm/sd-cli";
+
+export default defineConfig({
+  plugins: [sdAngularPlugin({ pkg: "my-client" })],
+});
+```

package/claude/references/sd-simplysm-v14/sd-cli/config/build-target.md

@@ -0,0 +1,31 @@
+# BuildTarget
+
+esbuild로 빌드되는 라이브러리 패키지의 타겟 플랫폼을 나타내는 타입.
+
+```typescript
+export type BuildTarget = "node" | "browser" | "neutral";
+```
+
+| 값 | 설명 |
+|----|------|
+| `"node"` | Node.js 전용 패키지. esbuild `platform: "node"` |
+| `"browser"` | 브라우저 전용 패키지. esbuild `platform: "browser"` |
+| `"neutral"` | Node/브라우저 공용 패키지. esbuild `platform: "neutral"` |
+
+## Usage
+
+[`SdBuildPackageConfig`](./sd-build-package-config.md)의 `target` 필드에 사용한다.
+
+```typescript
+import type { SdConfigFn } from "@simplysm/sd-cli";
+
+const config: SdConfigFn = () => ({
+  packages: {
+    "core-common": { target: "neutral" },
+    "core-node": { target: "node" },
+    "core-browser": { target: "browser" },
+  },
+});
+
+export default config;
+```

package/claude/references/sd-simplysm-v14/sd-cli/config/npm-config.md

@@ -0,0 +1,27 @@
+# NpmConfig
+
+npm `package.json` 구조를 나타내는 인터페이스. 패키지 의존성 탐색, 버전 조회 등 내부 유틸리티에서 사용한다.
+
+```typescript
+export interface NpmConfig {
+  name: string;
+  version: string;
+  description?: string;
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+  peerDependencies?: Record<string, string>;
+  volta?: unknown;
+}
+```
+
+## Members
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `name` | `string` | 패키지명 |
+| `version` | `string` | 패키지 버전 |
+| `description` | `string?` | 패키지 설명 |
+| `dependencies` | `Record<string, string>?` | 프로덕션 의존성 |
+| `devDependencies` | `Record<string, string>?` | 개발 의존성 |
+| `peerDependencies` | `Record<string, string>?` | 피어 의존성 |
+| `volta` | `unknown?` | Volta 설정 |

package/claude/references/sd-simplysm-v14/sd-cli/config/sd-browser-support-config.md

@@ -0,0 +1,19 @@
+# SdBrowserSupportConfig
+
+클라이언트 패키지의 브라우저 지원 설정. [`SdClientPackageConfig`](./sd-client-package-config.md)의 `browserSupport` 필드에 사용한다.
+
+```typescript
+export interface SdBrowserSupportConfig {
+  browserslist?: string | string[];
+  postCss?: { plugins: [string, (object | string)?][] };
+  legacyModule?: boolean;
+}
+```
+
+## Members
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `browserslist` | `string \| string[]?` | browserslist 쿼리. esbuild target으로 변환되어 문법(syntax)만 다운레벨 컴파일된다. 예: `"last 2 Chrome versions"` |
+| `postCss` | `{ plugins: [string, (object \| string)?][] }?` | PostCSS 플러그인 설정. `[패키지명, 옵션]` 튜플 배열 |
+| `legacyModule` | `boolean?` | 레거시 모듈 지원. `true`이면 코드 분할 비활성화 + `import.meta` 치환 |

package/claude/references/sd-simplysm-v14/sd-cli/config/sd-build-package-config.md

@@ -0,0 +1,21 @@
+# SdBuildPackageConfig
+
+`node` / `browser` / `neutral` 타겟 라이브러리 패키지 설정. esbuild + tsc로 빌드된다.
+
+```typescript
+export interface SdBuildPackageConfig {
+  target: BuildTarget;
+  publish?: SdPublishConfig;
+  copySrc?: string[];
+  watch?: SdWatchHookConfig;
+}
+```
+
+## Members
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `target` | [`BuildTarget`](./build-target.md) | 빌드 타겟 (`"node"` \| `"browser"` \| `"neutral"`) |
+| `publish` | [`SdPublishConfig?`](./sd-publish-config.md) | 배포 설정 |
+| `copySrc` | `string[]?` | `src/`에서 `dist/`로 복사할 파일의 glob 패턴 (`src/` 기준 상대 경로) |
+| `watch` | [`SdWatchHookConfig?`](./sd-watch-hook-config.md) | watch 훅 설정. 설정 시 watch 모드에서 빌드 엔진과 함께 훅이 실행된다 |

package/claude/references/sd-simplysm-v14/sd-cli/config/sd-capacitor-config.md

@@ -0,0 +1,109 @@
+# SdCapacitorConfig
+
+Capacitor 모바일 앱 설정. [`SdClientPackageConfig`](./sd-client-package-config.md)의 `capacitor` 필드에 사용한다.
+
+```typescript
+export interface SdCapacitorConfig {
+  appId: string;
+  appName: string;
+  plugins?: Record<string, Record<string, unknown> | true>;
+  icon?: string;
+  debug?: boolean;
+  platform?: {
+    android?: SdCapacitorAndroidConfig;
+  };
+}
+```
+
+## Members
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `appId` | `string` | 앱 ID (예: `"com.example.app"`) |
+| `appName` | `string` | 앱 이름 |
+| `plugins` | `Record<string, Record<string, unknown> \| true>?` | Capacitor 플러그인 설정. key: 패키지명, value: `true` 또는 플러그인 옵션 객체 |
+| `icon` | `string?` | 앱 아이콘 경로 (패키지 디렉토리 기준 상대 경로) |
+| `debug` | `boolean?` | 디버그 빌드 플래그 |
+| `platform` | `{ android?: SdCapacitorAndroidConfig }?` | 플랫폼별 설정 |
+
+## Related Types
+
+### `SdCapacitorAndroidConfig`
+
+Capacitor Android 플랫폼 설정.
+
+```typescript
+export interface SdCapacitorAndroidConfig {
+  config?: Record<string, string>;
+  bundle?: boolean;
+  intentFilters?: SdCapacitorIntentFilter[];
+  sign?: SdCapacitorSignConfig;
+  sdkVersion?: number;
+  permissions?: SdCapacitorPermission[];
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `config` | `Record<string, string>?` | AndroidManifest.xml `application` 태그 속성 (예: `{ requestLegacyExternalStorage: "true" }`) |
+| `bundle` | `boolean?` | AAB 번들 빌드 플래그. `false`이면 APK |
+| `intentFilters` | `SdCapacitorIntentFilter[]?` | Intent Filter 설정 |
+| `sign` | `SdCapacitorSignConfig?` | APK/AAB 서명 설정 |
+| `sdkVersion` | `number?` | Android SDK 버전 (minSdk, targetSdk에 동시 적용) |
+| `permissions` | `SdCapacitorPermission[]?` | 추가 권한 설정 |
+
+### `SdCapacitorSignConfig`
+
+Android APK/AAB 서명 설정.
+
+```typescript
+export interface SdCapacitorSignConfig {
+  keystore: string;
+  storePassword: string;
+  alias: string;
+  password: string;
+  keystoreType?: string;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `keystore` | `string` | keystore 파일 경로 (패키지 디렉토리 기준 상대 경로) |
+| `storePassword` | `string` | keystore 비밀번호 |
+| `alias` | `string` | 키 별칭 |
+| `password` | `string` | 키 비밀번호 |
+| `keystoreType` | `string?` | keystore 타입 (기본값: `"jks"`) |
+
+### `SdCapacitorPermission`
+
+Android 권한 설정.
+
+```typescript
+export interface SdCapacitorPermission {
+  name: string;
+  maxSdkVersion?: number;
+  ignore?: string;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `name` | `string` | 권한 이름 (예: `"CAMERA"`, `"WRITE_EXTERNAL_STORAGE"`) |
+| `maxSdkVersion` | `number?` | 이 권한을 적용할 최대 SDK 버전 |
+| `ignore` | `string?` | `tools:ignore` 속성 값 |
+
+### `SdCapacitorIntentFilter`
+
+Android Intent Filter 설정.
+
+```typescript
+export interface SdCapacitorIntentFilter {
+  action?: string;
+  category?: string;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `action` | `string?` | intent 액션 (예: `"android.intent.action.VIEW"`) |
+| `category` | `string?` | intent 카테고리 (예: `"android.intent.category.DEFAULT"`) |

package/claude/references/sd-simplysm-v14/sd-cli/config/sd-client-package-config.md

@@ -0,0 +1,33 @@
+# SdClientPackageConfig
+
+`client` 타겟 패키지 설정. esbuild 기반으로 빌드되며 개발 시 Vite dev server를 사용한다.
+
+```typescript
+export interface SdClientPackageConfig {
+  target: "client";
+  server: string | number;
+  env?: Record<string, string>;
+  publish?: SdPublishConfig;
+  capacitor?: SdCapacitorConfig;
+  electron?: SdElectronConfig;
+  configs?: Record<string, unknown>;
+  exclude?: string[];
+  browserSupport?: SdBrowserSupportConfig;
+  pwa?: false | SdPwaConfig;
+}
+```
+
+## Members
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `target` | `"client"` | 빌드 타겟 식별자 |
+| `server` | `string \| number` | 연결할 서버 패키지명 (예: `"my-server"`) 또는 포트 직접 지정 (하위 호환) |
+| `env` | `Record<string, string>?` | 빌드 시 치환할 환경 변수. `process.env`를 객체로 치환 |
+| `publish` | [`SdPublishConfig?`](./sd-publish-config.md) | 배포 설정 |
+| `capacitor` | [`SdCapacitorConfig?`](./sd-capacitor-config.md) | Capacitor 모바일 앱 설정 |
+| `electron` | [`SdElectronConfig?`](./sd-electron-config.md) | Electron 데스크톱 앱 설정 |
+| `configs` | `Record<string, unknown>?` | 런타임 설정. 빌드 시 `dist/.config.json`으로 기록 |
+| `exclude` | `string[]?` | Capacitor/Electron `package.json`에 추가할 패키지 목록 |
+| `browserSupport` | [`SdBrowserSupportConfig?`](./sd-browser-support-config.md) | 브라우저 지원 설정 |
+| `pwa` | `false \| SdPwaConfig?` | PWA 설정. `false`이면 비활성화. 미지정 시 기본값으로 활성화 |

package/claude/references/sd-simplysm-v14/sd-cli/config/sd-config.md

@@ -0,0 +1,78 @@
+# SdConfig
+
+`sd.config.ts` 설정 타입. `sd.config.ts`는 반드시 [`SdConfigFn`](#sdconfigfn) 형식의 함수를 default export해야 한다.
+
+## When to use
+
+- ✅ 프로젝트 루트에 `sd.config.ts`를 작성할 때 — 이 인터페이스가 최상위 설정 구조를 정의한다
+- ✅ 의존성 교체(`replaceDeps`) 또는 배포 후 스크립트(`postPublish`)를 설정할 때
+
+```typescript
+export interface SdConfig {
+  packages: Record<string, SdPackageConfig | undefined>;
+  replaceDeps?: Record<string, string>;
+  postPublish?: SdPostPublishScriptConfig[];
+}
+```
+
+## Members
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `packages` | `Record<string, SdPackageConfig \| undefined>` | 패키지별 설정. key: `packages/` 하위 디렉토리명 (예: `"core-common"`) |
+| `replaceDeps` | `Record<string, string>?` | 의존성 교체 설정. `node_modules` 패키지를 로컬 소스로 심링크 교체. key: 패키지 glob 패턴, value: 소스 디렉토리 경로. key의 `*`에서 캡처된 값이 value의 `*`에 치환됨 |
+| `postPublish` | [`SdPostPublishScriptConfig[]?`](./sd-post-publish-script-config.md) | 배포 완료 후 실행할 스크립트 목록 |
+
+## Related Types
+
+### `SdConfigParams`
+
+`sd.config.ts` 함수에 전달되는 매개변수.
+
+```typescript
+export interface SdConfigParams {
+  cwd: string;
+  dev: boolean;
+  opt: string[];
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `cwd` | `string` | 현재 작업 디렉토리 |
+| `dev` | `boolean` | 개발 모드 플래그 (`pnpm dev` 실행 시 `true`) |
+| `opt` | `string[]` | 추가 옵션 (`-o` 플래그에서 전달된 값 배열) |
+
+### `SdConfigFn`
+
+`sd.config.ts`가 default export해야 하는 함수 타입.
+
+```typescript
+export type SdConfigFn = (params: SdConfigParams) => SdConfig | Promise<SdConfig>;
+```
+
+## Usage
+
+```typescript
+import type { SdConfigFn } from "@simplysm/sd-cli";
+
+const config: SdConfigFn = (params) => ({
+  packages: {
+    "core-common": { target: "neutral" },
+    "core-node": { target: "node" },
+    "my-client": {
+      target: "client",
+      server: "my-server",
+    },
+    "my-server": {
+      target: "server",
+      publish: { type: "npm" },
+    },
+  },
+  replaceDeps: {
+    "@simplysm/*": "../simplysm/packages/*",
+  },
+});
+
+export default config;
+```

package/claude/references/sd-simplysm-v14/sd-cli/config/sd-electron-config.md

@@ -0,0 +1,27 @@
+# SdElectronConfig
+
+Electron 데스크톱 앱 설정. [`SdClientPackageConfig`](./sd-client-package-config.md)의 `electron` 필드에 사용한다.
+
+```typescript
+export interface SdElectronConfig {
+  appId: string;
+  portable?: boolean;
+  installerIcon?: string;
+  reinstallDependencies?: string[];
+  postInstallScript?: string;
+  nsisOptions?: Record<string, unknown>;
+  env?: Record<string, string>;
+}
+```
+
+## Members
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `appId` | `string` | Electron 앱 ID (예: `"com.example.myapp"`) |
+| `portable` | `boolean?` | `true`이면 포터블 `.exe`, `false`/미지정이면 NSIS 설치 프로그램 |
+| `installerIcon` | `string?` | 설치 프로그램 아이콘 경로 (`.ico`, 패키지 디렉토리 기준 상대 경로) |
+| `reinstallDependencies` | `string[]?` | Electron에 포함할 npm 패키지 목록 (네이티브 모듈 등 별도 설치 필요 패키지) |
+| `postInstallScript` | `string?` | npm `postinstall` 스크립트 |
+| `nsisOptions` | `Record<string, unknown>?` | NSIS 옵션. `portable`이 `false`일 때 적용 |
+| `env` | `Record<string, string>?` | 환경 변수. `electron-main.ts`에서 `process.env`로 접근 가능 |

package/claude/references/sd-simplysm-v14/sd-cli/config/sd-package-config.md

@@ -0,0 +1,18 @@
+# SdPackageConfig
+
+`sd.config.ts`의 패키지별 설정. `target` 필드로 분기하는 discriminated union이다.
+
+```typescript
+export type SdPackageConfig =
+  | SdBuildPackageConfig
+  | SdClientPackageConfig
+  | SdServerPackageConfig
+  | SdScriptsPackageConfig;
+```
+
+| `target` 값 | 타입 | 설명 |
+|-------------|------|------|
+| `"node"` \| `"browser"` \| `"neutral"` | [`SdBuildPackageConfig`](./sd-build-package-config.md) | esbuild+tsc로 빌드되는 라이브러리 패키지 |
+| `"client"` | [`SdClientPackageConfig`](./sd-client-package-config.md) | Vite/esbuild로 빌드되는 프론트엔드 패키지 |
+| `"server"` | [`SdServerPackageConfig`](./sd-server-package-config.md) | esbuild로 빌드되는 Fastify 서버 패키지 |
+| `"scripts"` | [`SdScriptsPackageConfig`](./sd-scripts-package-config.md) | 빌드 없이 watch 훅만 실행하는 스크립트 패키지 |

package/claude/references/sd-simplysm-v14/sd-cli/config/sd-post-publish-script-config.md

@@ -0,0 +1,19 @@
+# SdPostPublishScriptConfig
+
+배포 완료 후 실행할 스크립트 설정. [`SdConfig`](./sd-config.md)의 `postPublish` 배열 항목으로 사용한다.
+
+```typescript
+export interface SdPostPublishScriptConfig {
+  type: "script";
+  cmd: string;
+  args: string[];
+}
+```
+
+## Members
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `type` | `"script"` | 타입 식별자 |
+| `cmd` | `string` | 실행할 명령어 |
+| `args` | `string[]` | 명령어 인수. 환경 변수 치환 지원: `%VER%` (버전), `%PROJECT%` (프로젝트명) |

package/claude/references/sd-simplysm-v14/sd-cli/config/sd-publish-config.md

@@ -0,0 +1,72 @@
+# SdPublishConfig
+
+패키지 배포 설정. `type` 필드로 분기하는 discriminated union이다.
+
+```typescript
+export type SdPublishConfig =
+  | SdNpmPublishConfig
+  | SdLocalDirectoryPublishConfig
+  | SdStoragePublishConfig;
+```
+
+| `type` 값 | 타입 | 설명 |
+|-----------|------|------|
+| `"npm"` | `SdNpmPublishConfig` | npm 레지스트리 배포 |
+| `"local-directory"` | `SdLocalDirectoryPublishConfig` | 로컬 디렉토리 복사 |
+| `"ftp"` \| `"ftps"` \| `"sftp"` | `SdStoragePublishConfig` | 스토리지 업로드 |
+
+## Related Types
+
+### `SdNpmPublishConfig`
+
+npm 레지스트리에 배포한다. 버전은 자동으로 증가된다.
+
+```typescript
+export interface SdNpmPublishConfig {
+  type: "npm";
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `type` | `"npm"` | 배포 타입 식별자 |
+
+### `SdLocalDirectoryPublishConfig`
+
+로컬 디렉토리로 빌드 산출물을 복사한다.
+
+```typescript
+export interface SdLocalDirectoryPublishConfig {
+  type: "local-directory";
+  path: string;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `type` | `"local-directory"` | 배포 타입 식별자 |
+| `path` | `string` | 배포 대상 경로. 환경 변수 치환 지원: `%VER%` (버전), `%PROJECT%` (프로젝트명) |
+
+### `SdStoragePublishConfig`
+
+FTP/FTPS/SFTP 서버에 빌드 산출물을 업로드한다.
+
+```typescript
+export interface SdStoragePublishConfig {
+  type: "ftp" | "ftps" | "sftp";
+  host: string;
+  port?: number;
+  path?: string;
+  user?: string;
+  password?: string;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `type` | `"ftp" \| "ftps" \| "sftp"` | 스토리지 프로토콜 |
+| `host` | `string` | 서버 호스트 |
+| `port` | `number?` | 서버 포트 |
+| `path` | `string?` | 원격 경로 |
+| `user` | `string?` | 사용자명 |
+| `password` | `string?` | 비밀번호 |