@simplysm/sd-claude 14.0.97 → 14.0.99

package/claude/references/sd-simplysm14/apis/sd-cli/sd-config-types.md

@@ -1,6 +1,6 @@
 # @simplysm/sd-cli — sd.config.ts 설정 타입
 
-프로젝트 루트 `sd.config.ts` 작성·수정 시 함께 읽히는 타입 묶음. `sd.config.ts` 는 `SdConfigFn` 형태의 함수를 default export 해야 하며, 그 반환값 `SdConfig` 의 `packages` 맵에 각 패키지를 타겟별 설정으로 채운다. 모든 타입은 `import type { ... } from "@simplysm/sd-cli"` 로 가져온다.
+프로젝트 루트 `sd.config.ts` 는 `SdConfigFn` 형태의 함수를 `default export` 해야 한다 — `(params: SdConfigParams) => SdConfig | Promise<SdConfig>`. sd-cli 가 이 함수를 호출해 패키지별 빌드 타겟·배포·앱 패키징·의존성 교체를 결정한다. 모든 타입은 entry 의 `export *` 로 노출되며 `import type { ... } from "@simplysm/sd-cli"` 로 가져온다.
 
 ## SdConfigFn / SdConfigParams / SdConfig
 
@@ -20,34 +20,31 @@ interface SdConfig {
 }
 ```
 
-`SdConfigParams` (sd-cli 가 설정 함수에 주입):
+`SdConfigParams` — sd-cli 가 config 함수에 넘기는 인자:
 
-- cwd: string — 현재 작업 디렉토리(워크스페이스 루트). 설정에서 경로를 절대화할 때 기준.
-- dev: boolean — 개발 모드 플래그. true 면 dev 실행(watch/dev) 중. env·빌드 타겟을 dev/prod 로 분기할 때.
-- opt: string[] — CLI 의 `-o` 플래그로 넘어온 추가 옵션 배열. 특정 옵션이 들어왔을 때만 패키지를 켜는 식의 임의 빌드 변형에.
+- **cwd**: string — 현재 작업 디렉토리(워크스페이스 루트).
+- **dev**: boolean — 개발 모드 플래그. `true`(`watch`/`dev`)와 `false`(프로덕션 `build`/`pub`)에 따라 다른 설정을 반환하는 분기에 쓴다.
+- **opt**: string[] — CLI `-o <opt>` 로 전달된 추가 옵션 배열.
 
-`SdConfig`:
+`SdConfig` — config 함수 반환값:
 
-- packages: Record<string, SdPackageConfig | undefined> — 키는 `packages/` 하위 디렉토리명(예: `"core-common"`), 값은 빌드 설정. `undefined` 면 그 패키지를 빌드 대상에서 제외. 어떤 패키지를 어떤 타겟으로 빌드할지 한 곳에 모은다.
-- replaceDeps?: Record<string, string> — 의존성 교체(심링크). 키는 node_modules 에서 찾을 패키지 glob(예: `"@simplysm/*"`), 값은 로컬 소스 디렉토리 경로로 키의 `*` 캡처가 값의 `*` 에 치환됨(예: `"../simplysm/packages/*"`). 배포된 패키지 대신 로컬 소스를 곧바로 물려 디버깅할 때.
-- postPublish?: SdPostPublishScriptConfig[] — 배포 완료 후 순차 실행할 스크립트 목록. 배포 후 태깅·알림 등 후처리에.
-
-사용 예:
+- **packages**: `Record<string, SdPackageConfig | undefined>` — 키는 `packages/` 하위 디렉토리명(예: `"core-common"`), 값은 그 패키지의 빌드 설정. `undefined` 면 빌드 대상에서 제외.
+- **replaceDeps**: `Record<string, string>` — node_modules 패키지를 로컬 소스로 심링크 교체. 키는 node_modules 에서 찾을 glob(예: `"@simplysm/*"`), 값은 소스 디렉토리 경로이며 키의 `*` 캡처가 값의 `*` 에 치환됨(예: `"../simplysm/packages/*"`). 로컬 소스를 빌드 없이 곧바로 참조하게 만든다.
+- **postPublish**: `SdPostPublishScriptConfig[]` — 배포 완료 후 실행할 스크립트 목록.
 
 ```typescript
 import type { SdConfigFn } from "@simplysm/sd-cli";
 
-const config: SdConfigFn = ({ dev }) => ({
+const config: SdConfigFn = (params) => ({
   packages: {
     "core-common": { target: "neutral" },
-    "core-node": { target: "node", publish: { type: "npm" } },
-    "demo-client": dev ? { target: "client", server: "demo-server" } : undefined,
+    "core-node": { target: "node" },
   },
 });
 export default config;
 ```
 
-## SdPackageConfig (빌드 타겟 분기 유니온)
+## SdPackageConfig (타겟별 패키지 설정)
 
 ```typescript
 type SdPackageConfig =
@@ -55,30 +52,34 @@ type SdPackageConfig =
   | SdClientPackageConfig   // target: "client"
   | SdServerPackageConfig   // target: "server"
   | SdScriptsPackageConfig; // target: "scripts"
+
+type BuildTarget = "node" | "browser" | "neutral";
 ```
 
-판별자는 `target`. enum literal 별 의미:
+`target` literal 로 어느 멤버인지 구분하는 판별 유니온. `target` 별 동작 차이:
 
-- "node" / "browser" / "neutral" (→ `SdBuildPackageConfig`) — esbuild 라이브러리 패키지. "node" = Node.js 전용, "browser" = 브라우저 전용, "neutral" = 양쪽 공용. npm 배포 라이브러리에 쓴다.
-- "client" (→ `SdClientPackageConfig`) — Frontend 앱(Angular + Capacitor/Electron/PWA 옵션). esbuild + define 으로 env 주입.
-- "server" (→ `SdServerPackageConfig`) — Fastify 서버 앱. esbuild banner 로 env 주입, PM2 옵션.
-- "scripts" (→ `SdScriptsPackageConfig`) — 유틸 패키지. watch 훅이 없으면 watch/typecheck 대상에서 제외됨.
+- **`"node"`** — Node.js 전용 라이브러리 패키지(esbuild 빌드, npm 배포용).
+- **`"browser"`** — 브라우저 전용 라이브러리 패키지.
+- **`"neutral"`** — Node/브라우저 공용 라이브러리 패키지.
+- **`"client"`** — Frontend 앱 패키지(Angular + Capacitor/Electron/PWA).
+- **`"server"`** — Fastify 서버 앱 패키지.
+- **`"scripts"`** — 유틸 패키지(watch 훅으로 임의 명령 실행).
 
 ### SdBuildPackageConfig (node/browser/neutral)
 
 ```typescript
 interface SdBuildPackageConfig {
-  target: BuildTarget; // "node" | "browser" | "neutral"
+  target: BuildTarget;
   publish?: SdPublishConfig;
   copySrc?: string[];
   watch?: SdWatchHookConfig;
 }
 ```
 
-- target: "node"|"browser"|"neutral" — 빌드 런타임 타겟(위 풀이 참조). 라이브러리가 어느 환경에서 돌지에 맞춰 고른다.
-- publish?: SdPublishConfig — 배포 대상 설정. 미지정 시 배포 안 함. npm 배포 라이브러리면 `{ type: "npm" }`.
-- copySrc?: string[] — `src/` 에서 `dist/` 로 그대로 복사할 파일 glob(src 기준 상대). 컴파일 대상 아닌 정적 리소스를 산출물에 포함할 때.
-- watch?: SdWatchHookConfig — watch 모드에서 빌드 엔진과 함께 실행할 훅. 빌드 외 부수 작업(코드 생성 등)을 watch 에 끼울 때.
+- **target**: `"node" | "browser" | "neutral"` — 위 BuildTarget 동작 차이 참조.
+- **publish**: `SdPublishConfig` — 배포 설정(아래 §배포 설정). 라이브러리 패키지는 보통 `{ type: "npm" }`.
+- **copySrc**: string[] — `src/`→`dist/` 로 그대로 복사할 파일의 glob 패턴(`src/` 기준 상대). esbuild 번들에 포함되지 않는 정적 자원을 dist 에 남길 때.
+- **watch**: `SdWatchHookConfig` — 설정 시 watch 모드에서 빌드 엔진과 함께 훅이 실행됨.
 
 ### SdClientPackageConfig (client)
 
@@ -98,19 +99,24 @@ interface SdClientPackageConfig {
 }
 ```
 
-- server: string | number — 연결할 서버. string = 서버 패키지명(예: `"demo-server"`), number = 포트 직접 지정(하위 호환). 보통 같은 워크스페이스의 서버 패키지명을 준다.
-- env?: Record<string, string> — 빌드 시 `process.env` 를 객체로 치환할 환경 변수. 프론트 코드에 빌드 타임 상수를 주입할 때.
-- publish?: SdPublishConfig — 산출물 배포 설정. 미지정 시 배포 안 함.
-- capacitor?: SdCapacitorConfig — Capacitor 모바일 앱 패키징 설정. 지정 시 Android 등으로 패키징.
-- electron?: SdElectronConfig — Electron 데스크톱 앱 패키징 설정.
-- configs?: Record<string, unknown> — 런타임 설정. 빌드 시 `dist/.config.json` 으로 기록되어 앱이 런타임에 읽음. 배포 환경별 가변 값에.
-- exclude?: string[] — Capacitor/Electron `package.json` 에 추가(번들에서 빼 외부 패키지로 둘)할 패키지 목록.
-- browserSupport?: SdBrowserSupportConfig — 브라우저 호환(browserslist/PostCSS/legacyModule) 설정.
-- pwa?: false | SdPwaConfig — PWA 설정. `false` 면 비활성화, 미지정 시 기본값으로 활성화, 객체면 manifest 커스텀. PWA 가 필요 없으면 `false`.
-- prerender?: string[] — SSG(빌드 타임 프리렌더) 라우트 목록(예: `["/", "/about"]`). SEO 가 필요한 공개 페이지에 지정. 프로덕션 빌드에서만 동작하며 dev/watch 모드는 기존 SPA 그대로. 동작:
-  - `src/main.server.ts` 가 서버 부트스트랩(`(context: BootstrapContext) => bootstrapApplication(App, config, context)`)을 default export 해야 하며, 앱 설정에 `provideClientHydration()`, 서버 설정에 `provideServerRendering()` 포함. `@angular/platform-server` 의존성 필요 (Angular 표준 SSR 셋업과 동일).
-  - 라우트별 `<경로>/index.html` 을 서버 렌더 결과로 생성 (`"/"` 는 `index.html` 대체). SPA 셸은 `index.csr.html` 로 별도 보존되어 비프리렌더 라우트 딥링크 폴백에 사용 (service-server 정적 핸들러가 처리).
-  - 라우트 1건이라도 렌더 실패 시 빌드 전체 실패.
+- **server**: `string | number` — string 이면 연결할 서버 패키지명(예: `"demo-server"`), number 이면 포트 직접 지정(하위 호환).
+- **env**: `Record<string, string>` — 빌드 시 치환할 환경 변수. `process.env` 를 이 객체로 치환(define 주입).
+- **publish**: `SdPublishConfig` — 배포 설정.
+- **capacitor**: `SdCapacitorConfig` — 모바일(Capacitor) 패키징 설정. 지정 시 앱을 Android 등으로 빌드.
+- **electron**: `SdElectronConfig` — 데스크톱(Electron) 패키징 설정.
+- **configs**: `Record<string, unknown>` — 런타임 설정. 빌드 시 `dist/.config.json` 으로 기록되어 앱이 런타임에 읽음.
+- **exclude**: string[] — Capacitor/Electron package.json 에 추가할(번들에서 제외할) 패키지.
+- **browserSupport**: `SdBrowserSupportConfig` — browserslist/PostCSS/legacyModule 등 브라우저 지원 설정.
+- **pwa**: `false | SdPwaConfig` — `false` 면 PWA 비활성화. 미지정 시 기본값으로 활성화. 객체면 manifest 등 세부 지정.
+- **prerender**: string[] — SSG(빌드 타임 프리렌더) 라우트 목록(예: `["/", "/about"]`). 지정 시 프로덕션 빌드에서 `src/main.server.ts` 진입점으로 라우트별 HTML 을 생성하고, SPA 셸은 `index.csr.html` 로 별도 출력. dev/watch 모드에는 적용되지 않음. 라우트는 `"/"` 로 시작.
+
+```typescript
+"client-portal": {
+  target: "client",
+  server: "server",
+  prerender: ["/", "/about"],
+},
+```
 
 ### SdServerPackageConfig (server)
 
@@ -126,13 +132,11 @@ interface SdServerPackageConfig {
 }
 ```
 
-- env?: Record<string, string> — 빌드 시 `process.env.KEY` 를 상수로 치환(esbuild banner). 서버 빌드 타임 상수 주입.
-- publish?: SdPublishConfig — 산출물 배포 설정.
-- configs?: Record<string, unknown> — 런타임 설정. `dist/.config.json` 으로 기록.
-- externals?: string[] — esbuild 번들에 포함하지 않을 외부 모듈. 자동 `binding.gyp` 감지 항목에 더해짐. 네이티브 모듈을 번들에서 뺄 때.
-- pm2?.name?: string — PM2 프로세스 이름. 미지정 시 `package.json` name 에서 생성. `pm2` 지정 시 `dist/pm2.config.cjs` 생성.
-- pm2?.ignoreWatchPaths?: string[] — PM2 watch 에서 제외할 경로.
-- packageManager?: "volta" | "mise" — 산출물에 생성할 패키지 매니저 설정 종류. "volta" = volta 설정, "mise" = `mise.toml` 생성. 배포 서버의 매니저에 맞춘다.
+- **env**: `Record<string, string>` — 빌드 시 치환할 환경 변수. `process.env.KEY` 를 상수로 치환(esbuild banner 주입).
+- **configs**: `Record<string, unknown>` — 런타임 설정. 빌드 시 `dist/.config.json` 으로 기록.
+- **externals**: string[] — esbuild 번들에 포함하지 않을 외부 모듈. 자동 `binding.gyp` 감지 목록에 추가됨(네이티브 모듈 외부화).
+- **pm2**: 지정 시 `dist/pm2.config.cjs` 생성. `name` 은 PM2 프로세스 이름(미지정 시 package.json name 에서 생성), `ignoreWatchPaths` 는 PM2 watch 제외 경로.
+- **packageManager**: `"volta" | "mise"` — 사용할 패키지 매니저. `mise.toml` 또는 volta 설정 생성에 영향.
 
 ### SdScriptsPackageConfig (scripts)
 
@@ -142,50 +146,47 @@ interface SdScriptsPackageConfig {
   publish?: SdPublishConfig;
   watch?: SdWatchHookConfig;
 }
-```
-
-- publish?: SdPublishConfig — 산출물 배포 설정.
-- watch?: SdWatchHookConfig — watch 훅. 지정해야만 이 패키지가 watch 모드에 포함됨(미지정 시 watch/typecheck 제외). 파일 변경 시 임의 명령 실행에 쓴다.
 
-## SdWatchHookConfig
-
-```typescript
 interface SdWatchHookConfig {
-  target: string[];
-  cmd: string;
-  args?: string[];
+  target: string[]; // 감시할 glob (패키지 디렉토리 기준 상대)
+  cmd: string;      // 변경 시 실행할 명령어
+  args?: string[];  // 명령어 인수
 }
 ```
 
-- target: string[] — 감시할 glob 패턴(패키지 디렉토리 기준 상대). 어떤 파일 변경에 반응할지.
-- cmd: string — 변경 감지 시 실행할 명령어.
-- args?: string[] — 명령어 인수.
+- **SdScriptsPackageConfig.watch**: `SdWatchHookConfig` — 설정 시에만 watch 모드에 패키지가 포함됨. 미설정이면 watch/typecheck 에서 제외.
+- **SdWatchHookConfig.target**: string[] — 감시할 glob 패턴(패키지 디렉토리 기준 상대 경로).
+- **SdWatchHookConfig.cmd / args**: 변경 감지 시 실행할 명령어와 인수.
 
-## 배포 설정 (SdPublishConfig 유니온 + SdPostPublishScriptConfig)
+## 배포 설정 (SdPublishConfig)
 
 ```typescript
 type SdPublishConfig = SdNpmPublishConfig | SdLocalDirectoryPublishConfig | SdStoragePublishConfig;
+
+interface SdNpmPublishConfig { type: "npm"; }
+interface SdLocalDirectoryPublishConfig { type: "local-directory"; path: string; }
+interface SdStoragePublishConfig {
+  type: "ftp" | "ftps" | "sftp";
+  host: string; port?: number; path?: string; user?: string; password?: string;
+}
+
+interface SdPostPublishScriptConfig { type: "script"; cmd: string; args: string[]; }
 ```
 
-판별자는 `type`:
+`type` literal 로 배포 방식 판별:
+
+- **`"npm"`** — npm 레지스트리에 배포. 추가 필드 없음.
+- **`"local-directory"`** — 로컬 디렉토리로 복사. `path` 는 대상 경로이며 환경 변수 치환 지원(`%VER%`, `%PROJECT%`).
+- **`"ftp" | "ftps" | "sftp"`** — 스토리지 서버에 업로드. `host` 필수, `port`/`path`/`user`/`password` 는 선택.
 
-- `SdNpmPublishConfig` — `{ type: "npm" }`. npm 레지스트리 배포. 공개 라이브러리에 쓴다.
-- `SdLocalDirectoryPublishConfig` — `{ type: "local-directory"; path: string }`. 로컬 디렉토리로 복사. `path` 는 `%VER%`/`%PROJECT%` 치환 지원. 사내 공유 폴더 배포에.
-- `SdStoragePublishConfig` — `{ type: "ftp"|"ftps"|"sftp"; host; port?; path?; user?; password? }`. type 별 프로토콜 차이(ftp = 평문, ftps = TLS, sftp = SSH). 원격 서버 업로드 배포에. host 만 필수, 나머지는 선택.
+`SdPostPublishScriptConfig` — `SdConfig.postPublish` 항목. `type: "script"` 고정, `cmd` 실행 명령, `args` 인수(환경 변수 치환 지원: `%VER%`, `%PROJECT%`).
 
 ```typescript
-interface SdPostPublishScriptConfig {
-  type: "script";
-  cmd: string;
-  args: string[]; // %VER%, %PROJECT% 치환 지원
-}
+"excel": { target: "neutral", publish: { type: "npm" } },
+"client": { target: "client", server: "server", publish: { type: "ftp", host: "...", path: "/www" } },
 ```
 
-- type: "script" — 후처리 스크립트임을 나타내는 판별자(고정).
-- cmd: string — 배포 후 실행할 명령어.
-- args: string[] — 인수. `%VER%`(버전), `%PROJECT%`(프로젝트명) 치환됨.
-
-## Capacitor 설정 (client 의 capacitor)
+## Capacitor 설정 (SdCapacitorConfig)
 
 ```typescript
 interface SdCapacitorConfig {
@@ -198,42 +199,50 @@ interface SdCapacitorConfig {
 }
 ```
 
-- appId: string — 앱 ID(역도메인, 예: `"com.example.app"`). 스토어 식별자.
-- appName: string — 앱 표시 이름.
-- plugins?: Record<string, Record<string, unknown> | true> — Capacitor 플러그인. 키 = 패키지명, 값 = `true`(옵션 없이 활성) 또는 옵션 객체. 옵션이 필요 없으면 `true`.
-- icon?: string — 앱 아이콘 경로(패키지 기준 상대).
-- debug?: boolean — 디버그 빌드 플래그.
-- platform?.android?: SdCapacitorAndroidConfig — Android 플랫폼별 설정.
+- **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` — Android 플랫폼 세부 설정.
 
 ```typescript
 interface SdCapacitorAndroidConfig {
-  config?: Record<string, string>;
-  bundle?: boolean;
+  config?: Record<string, string>;      // AndroidManifest application 태그 속성
+  bundle?: boolean;                     // false=APK (true/미지정=AAB 번들)
   intentFilters?: SdCapacitorIntentFilter[];
   sign?: SdCapacitorSignConfig;
-  sdkVersion?: number;
+  sdkVersion?: number;                  // minSdk/targetSdk
   permissions?: SdCapacitorPermission[];
 }
-```
 
-- config?: Record<string, string> — `AndroidManifest.xml` 의 `<application>` 태그 속성(예: `{ requestLegacyExternalStorage: "true" }`).
-- bundle?: boolean — true = AAB 번들, false = APK. 스토어 배포면 true.
-- intentFilters?: SdCapacitorIntentFilter[] — 딥링크 등 Intent Filter 목록.
-- sign?: SdCapacitorSignConfig — APK/AAB 서명 설정. 릴리스 빌드에 필요.
-- sdkVersion?: number — Android SDK 버전(minSdk·targetSdk 공통).
-- permissions?: SdCapacitorPermission[] — 추가 권한 목록.
+interface SdCapacitorSignConfig {
+  keystore: string;       // keystore 파일 경로 (패키지 기준 상대)
+  storePassword: string;
+  alias: string;
+  password: string;
+  keystoreType?: string;  // 기본값 "jks"
+}
 
-```typescript
-interface SdCapacitorSignConfig { keystore: string; storePassword: string; alias: string; password: string; keystoreType?: string; }
-interface SdCapacitorPermission { name: string; maxSdkVersion?: number; ignore?: string; }
-interface SdCapacitorIntentFilter { action?: string; category?: string; }
+interface SdCapacitorPermission {
+  name: string;           // 예: "CAMERA"
+  maxSdkVersion?: number;
+  ignore?: string;        // tools:ignore 속성 값
+}
+
+interface SdCapacitorIntentFilter {
+  action?: string;        // 예: "android.intent.action.VIEW"
+  category?: string;      // 예: "android.intent.category.DEFAULT"
+}
 ```
 
-- SdCapacitorSignConfig.keystore — keystore 파일 경로(패키지 기준 상대). storePassword/alias/password = 서명 자격증명. keystoreType?: string — keystore 타입(기본값 `"jks"`).
-- SdCapacitorPermission.name — 권한 이름(예: `"CAMERA"`). maxSdkVersion?: number — 권한 적용 최대 SDK. ignore?: string — `tools:ignore` 속성 값.
-- SdCapacitorIntentFilter.action — intent 액션(예: `"android.intent.action.VIEW"`). category — intent 카테고리(예: `"android.intent.category.DEFAULT"`).
+- **SdCapacitorAndroidConfig.config**: `Record<string, string>` — AndroidManifest.xml `application` 태그 속성(예: `{ requestLegacyExternalStorage: "true" }`).
+- **SdCapacitorAndroidConfig.bundle**: boolean — `false` 면 APK 로 빌드(AAB 번들 빌드 플래그).
+- **SdCapacitorAndroidConfig.sdkVersion**: number — Android SDK 버전(minSdk, targetSdk).
+- **SdCapacitorSignConfig.keystoreType**: string — keystore 타입, 기본값 `"jks"`.
+- **SdCapacitorPermission.maxSdkVersion / ignore**: 권한별 최대 SDK 버전과 `tools:ignore` 속성 값.
 
-## Electron 설정 (client 의 electron)
+## Electron 설정 (SdElectronConfig)
 
 ```typescript
 interface SdElectronConfig {
@@ -247,18 +256,19 @@ interface SdElectronConfig {
 }
 ```
 
-- appId: string — Electron 앱 ID(역도메인, 예: `"com.example.myapp"`).
-- portable?: boolean — true = 포터블 `.exe`, false/미지정 = NSIS 설치 프로그램. 설치 없이 실행 배포면 true.
-- 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` 로 접근 가능.
+- **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` 로 접근 가능.
 
-## PWA 설정 (client 의 pwa)
+## PWA 설정 (SdPwaConfig) / 브라우저 지원 (SdBrowserSupportConfig)
 
 ```typescript
 interface SdPwaConfig { manifest?: SdPwaManifestConfig; }
+
 interface SdPwaManifestConfig {
   name?: string;
   short_name?: string;
@@ -267,17 +277,7 @@ interface SdPwaManifestConfig {
   background_color?: string;
   icons?: Array<{ src: string; sizes: string; type?: string }>;
 }
-```
-
-- manifest?: SdPwaManifestConfig — PWA manifest 커스터마이징. 미지정 시 기본 manifest.
-- display?: "standalone"|"fullscreen"|"minimal-ui"|"browser" — 앱 표시 모드. "standalone" = 브라우저 UI 없는 앱 창, "fullscreen" = 전체 화면, "minimal-ui" = 최소 브라우저 UI, "browser" = 일반 탭. 네이티브 느낌이면 "standalone".
-- name/short_name — manifest 앱 이름 / 짧은 이름.
-- theme_color/background_color — manifest 테마 색 / 배경 색.
-- icons?: Array<{ src; sizes; type? }> — manifest 아이콘 목록. src = 경로, sizes = 크기(예: `"512x512"`), type = MIME 타입.
-
-## SdBrowserSupportConfig (client 의 browserSupport)
 
-```typescript
 interface SdBrowserSupportConfig {
   browserslist?: string | string[];
   postCss?: { plugins: [string, (object | string)?][] };
@@ -285,16 +285,23 @@ interface SdBrowserSupportConfig {
 }
 ```
 
-- browserslist?: string | string[] — browserslist 쿼리(예: `"last 2 Chrome versions"` 또는 `["ie 11", "last 2 versions"]`). 트랜스파일·prefix 대상 브라우저 범위.
-- postCss?.plugins: [string, (object|string)?][] — PostCSS 플러그인 `[이름, 옵션?]` 튜플 배열.
-- legacyModule?: boolean — 레거시 모듈 지원. true 면 코드 분할 비활성화 + `import.meta` 치환. 구형 환경 대응이 필요할 때.
+- **SdPwaManifestConfig.display**: `"standalone" | "fullscreen" | "minimal-ui" | "browser"` — PWA 표시 모드(웹 앱 manifest `display` 그대로).
+- **SdBrowserSupportConfig.browserslist**: `string | string[]` — browserslist 쿼리(예: `"last 2 Chrome versions"` 또는 `["ie 11", "last 2 versions"]`).
+- **SdBrowserSupportConfig.postCss**: PostCSS 플러그인 설정. `plugins` 는 `[name, options]` 튜플 배열.
+- **SdBrowserSupportConfig.legacyModule**: boolean — 레거시 모듈 지원. 코드 분할 비활성화 + `import.meta` 치환.
 
-## 보조 타입
+## NpmConfig
 
 ```typescript
-type BuildTarget = "node" | "browser" | "neutral";
-interface NpmConfig { name: string; version: string; description?: string; dependencies?: Record<string,string>; devDependencies?: Record<string,string>; peerDependencies?: Record<string,string>; volta?: unknown; }
+interface NpmConfig {
+  name: string;
+  version: string;
+  description?: string;
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+  peerDependencies?: Record<string, string>;
+  volta?: unknown;
+}
 ```
 
-- BuildTarget — esbuild 라이브러리 빌드 런타임 타겟 enum. "node" = Node 전용, "browser" = 브라우저 전용, "neutral" = 공용(위 `SdPackageConfig` 풀이와 동일).
-- NpmConfig — `package.json` 구조 타입. name/version 필수, description/dependencies/devDependencies/peerDependencies/volta 는 선택. package.json 을 타입 안전하게 다룰 때.
+npm `package.json` 구조 타입. sd.config 설정값은 아니며, package.json 을 다루는 보조 타입으로 entry 에서 함께 노출된다.