@simplysm/sd-claude 14.0.98 → 14.0.99

package/claude/references/sd-simplysm14/apis/orm-node/db-conn.md

@@ -1,6 +1,6 @@
 # @simplysm/orm-node — 저수준 DB 연결
 
-`createOrm` 추상화를 거치지 않고 raw SQL·파라미터 쿼리·bulk insert·수동 트랜잭션을 직접 다루거나, dialect별 접속 설정 타입을 작성하거나, `DbContext` 의 executor 를 손수 조립할 때 함께 읽히는 묶음. 연결 인스턴스 생성·연결 인터페이스·접속 설정·executor·dialect 헬퍼·상수로 구성.
+`createOrm` 추상화를 거치지 않고 raw SQL·파라미터 쿼리·bulk insert·수동 트랜잭션을 직접 다루거나, dialect별 접속 설정 타입을 작성하거나, `DbContext` executor 를 손수 조립할 때 함께 읽히는 묶음. 연결 인스턴스 생성·연결 인터페이스·접속 설정·executor·dialect 헬퍼·상수로 구성.
 
 ## createDbConn
 
@@ -8,7 +8,7 @@
 function createDbConn(config: DbConnConfig): Promise<DbConn>
 ```
 
-`config.dialect` 에 맞는 드라이버를 **지연 import** 해 연결 인스턴스를 만든다(mysql → `mysql2/promise`, postgresql → `pg` + `pg-copy-streams`, mssql/mssql-azure → `tedious`). 한 번 로드한 드라이버는 모듈 캐시에 보관해 재사용. 반환 객체는 아직 **미연결** 상태이므로 `connect()` 를 별도 호출해야 함.
+`config.dialect` 에 맞는 드라이버를 **지연 import** 해 연결 인스턴스를 생성(mysql → `mysql2/promise`, postgresql → `pg` + `pg-copy-streams`, mssql/mssql-azure → `tedious`). 한 번 로드한 드라이버는 모듈 캐시에 보관해 재사용. 반환 객체는 아직 **미연결** 상태이므로 `connect()` 를 별도로 호출해야 함.
 
 ```typescript
 const conn = await createDbConn({ dialect: "postgresql", host: "localhost", username: "u", password: "p", database: "db" });
@@ -23,7 +23,7 @@ await conn.connect();
 - isConnected: boolean — 현재 연결 여부. `connect` 성공 시 `true`, `close`/드라이버 `end` 이벤트 시 `false`. 재연결 판단·정리 분기에 사용.
 - isInTransaction: boolean — 트랜잭션 진행 여부. `beginTransaction` 후 `true`, 커밋·롤백 후 `false`. 중첩 방지·상태 확인에 사용.
 - connect(): Promise\<void\> — 연결 수립. 이미 연결돼 있으면 `DB_CONN_ERRORS.ALREADY_CONNECTED` throw.
-- close(): Promise\<void\> — 연결 종료. 미연결 상태면 아무 동작 없이 반환(throw 안 함). 재호출 안전.
+- close(): Promise\<void\> — 연결 종료. 미연결 상태면 아무 동작 없이 반환(throw 안 함) — 재호출 안전.
 - beginTransaction(isolationLevel?: IsolationLevel): Promise\<void\> — 트랜잭션 시작. `isolationLevel` 미지정 시 `config.defaultIsolationLevel`, 그것도 없으면 `READ_UNCOMMITTED` 로 시작. 테스트로 확인된 값: `"READ_UNCOMMITTED" | "READ_COMMITTED" | "REPEATABLE_READ" | "SERIALIZABLE"`. 더티 리드 차단이 필요하면 `READ_COMMITTED` 이상.
 - commitTransaction(): Promise\<void\> — 진행 중 트랜잭션 커밋, `isInTransaction` 을 `false` 로.
 - rollbackTransaction(): Promise\<void\> — 진행 중 트랜잭션 롤백, `isInTransaction` 을 `false` 로.

package/claude/references/sd-simplysm14/apis/sd-cli/README.md

@@ -1,11 +1,11 @@
 # @simplysm/sd-cli
 
-simplysm 모노레포의 빌드/배포 오케스트레이터 CLI. entry(`src/index.ts`)가 외부로 노출하는 건 CLI 실행 코드가 아니라 세 묶음뿐 — ① `sd.config.ts` 작성용 설정 타입군, ② 패키지 단위 TypeScript/Angular AOT 증분 컴파일러 `SdTsCompiler` 와 그 옵션·결과 타입, ③ Vitest 전용 Angular Vite 플러그인 `sdAngularPlugin`.
+simplysm 모노레포의 빌드/배포 오케스트레이터 CLI. 라이브러리 entry(`src/index.ts`)가 노출하는 건 CLI 실행 코드가 아니라 세 묶음 — ① `sd.config.ts` 작성용 설정 타입군(`export *`), ② 패키지 단위 TypeScript/Angular AOT 증분 컴파일러 `SdTsCompiler` 와 옵션·결과 타입, ③ Vitest 전용 Angular Vite 플러그인 `sdAngularPlugin`. CLI 서브커맨드 내부 구현은 entry 에서 노출되지 않아 문서 대상이 아니다.
 
 ## 사용 트리거 인덱스
 
-- **sd.config.ts 설정 타입** — 프로젝트 루트 `sd.config.ts` 를 작성·수정하며 패키지별 빌드 타겟(`node`/`browser`/`neutral`/`client`/`server`/`scripts`), 배포(npm/로컬/FTP)·Capacitor/Electron/PWA·서버 옵션·의존성 교체를 지정할 때. 자세히: [sd-config-types.md](./sd-config-types.md)
-- **SdTsCompiler / ISdTsCompilerOptions / ISdTsCompilerResult / ISdTsCompilerEmitOptions** — sd-cli 외부에서 패키지 1개의 TS(또는 Angular AOT) 증분 컴파일을 직접 구동하거나 그 결과(emit·진단·lint·SCSS)를 다룰 때. 자세히: [SdTsCompiler.md](./SdTsCompiler.md)
+- **sd.config.ts 설정 타입** (`SdConfigFn`·`SdConfig`·`SdConfigParams`·`SdPackageConfig` 와 그 하위 타겟·배포·Capacitor·Electron·PWA 설정) — 프로젝트 루트 `sd.config.ts` 를 작성·수정하며 패키지별 빌드 타겟·배포·앱 패키징·의존성 교체를 지정할 때. 자세히: [sd-config-types.md](./sd-config-types.md)
+- **SdTsCompiler / ISdTsCompilerOptions / ISdTsCompilerResult** — sd-cli 외부에서 패키지 1개의 TS(또는 Angular AOT) 증분 컴파일을 직접 구동하거나 그 결과(emit·진단·lint·SCSS)를 다룰 때. 자세히: [SdTsCompiler.md](./SdTsCompiler.md)
 - **sdAngularPlugin / SdAngularPluginOptions** — Vitest 에서 Angular 패키지의 `.ts` 를 AOT 컴파일해 주입하는 Vite 플러그인을 설정할 때. 아래 인라인 섹션 참조.
 
 ## sdAngularPlugin
@@ -18,9 +18,9 @@ interface SdAngularPluginOptions {
 }
 ```
 
-Angular AOT 컴파일을 수행하는 **Vitest 전용** Vite 플러그인. 내부에서 `SdTsCompiler` 로 대상 패키지의 `.ts`(tests 포함 — `includeTests: true`, `output: { js: true, dts: false }`)를 AOT 컴파일하고, Vite `transform` 훅에서 컴파일된 JS 를 반환한다. `enforce: "pre"` 로 다른 transform 보다 먼저 동작하며, 컴파일러가 emit 한 인라인 base64 소스맵을 분리해 Vite 호환 형태(`{ code, map }`)로 넘긴다. `compilerOptionsTransformer` 로 `noEmit:false`·`declaration:false`·`inlineSourceMap:true`·`rootDir = cwd` 를 강제하고, `buildEnd` 마다 내부 컴파일러를 폐기해 다음 watch 재빌드 시 재생성하며, `watchChange` 로 모은 변경 파일을 `buildStart` 의 증분 캐시 무효화에 쓴다.
+Angular AOT 컴파일을 수행하는 **Vitest 전용** Vite 플러그인(`name: "sd-angular"`, `enforce: "pre"`). 내부에서 `SdTsCompiler` 로 대상 패키지의 `.ts`(tests 포함 — `includeTests: true`, `output: { js: true, dts: false }`)를 AOT 컴파일하고, Vite `transform` 훅에서 컴파일된 JS 를 반환한다. `enforce: "pre"` 라 다른 transform 보다 먼저 동작하며, 컴파일러가 emit 한 인라인 base64 소스맵을 분리해 Vite 호환 형태(`{ code, map }`)로 넘긴다. `compilerOptionsTransformer` 로 `noEmit:false`·`declaration:false`·`sourceMap:false`·`inlineSourceMap:true`·`rootDir = process.cwd()` 를 강제한다. `buildEnd` 마다 내부 컴파일러를 폐기(`undefined`)해 다음 watch 재빌드 시 재생성하고, `watchChange` 로 모은 변경 파일을 `buildStart` 의 증분 캐시 무효화에 쓴다.
 
-- **pkg**: string — 컴파일 대상 패키지 디렉토리명. `sd.config.ts` 의 `packages` 키(`@simplysm/` 접두사 제외한 짧은 이름, 예: `"angular"`)와 동일. 플러그인은 `process.cwd()/packages/<pkg>` 를 컴파일 루트로 잡으므로, 테스트하려는 Angular 패키지명을 그대로 넣는다.
+- **pkg**: string — 컴파일 대상 패키지 디렉토리명. `sd.config.ts` 의 `packages` 키(`@simplysm/` 접두사 제외한 짧은 이름, 예: `"angular"`)와 동일. 플러그인은 `process.cwd()/packages/<pkg>` 를 컴파일 루트로 잡으므로 테스트하려는 Angular 패키지명을 그대로 넣는다. `config()` 훅 전에 `buildStart` 가 불리면 에러.
 
 ```typescript
 // vitest.config.ts

package/claude/references/sd-simplysm14/apis/sd-cli/SdTsCompiler.md

@@ -1,43 +1,64 @@
 # @simplysm/sd-cli — SdTsCompiler
 
-패키지 디렉토리 1개의 `.ts` 를 TypeScript 또는 Angular AOT 로 **증분** 컴파일하는 클래스. 한 번의 `compileAsync` 호출로 직렬화된 진단 + emit 결과 + lint + SCSS 결과를 한 묶음(`ISdTsCompilerResult`)으로 반환한다. tsconfig 의 `angularCompilerOptions` 존재 여부로 Angular/일반 모드를 자동 판별. 빌드 엔진과 `sdAngularPlugin` 내부에서 사용. 진단은 worker 경계를 통과하도록 `SerializedDiagnostic` 으로 직렬화되며, 내부 크래시는 단계별로 잡아 진단으로 보고(부분 복구)한다.
+패키지 디렉토리 1개의 `.ts` 를 TypeScript 또는 Angular AOT 로 **증분** 컴파일하는 클래스. 한 번의 `compileAsync` 호출이 직렬화된 진단 + emit 결과 + lint + SCSS 결과를 한 묶음(`ISdTsCompilerResult`)으로 반환한다. tsconfig 의 `angularCompilerOptions` 존재 여부로 Angular/일반 모드를 자동 판별한다. 진단은 worker 경계를 통과하도록 `SerializedDiagnostic` 으로 직렬화되며, 내부 크래시는 단계별로 잡아 진단으로 보고(부분 복구)한다.
 
-## ISdTsCompilerOptions (생성자 인자)
+## 생성자 / ISdTsCompilerOptions
 
 ```typescript
+class SdTsCompiler {
+  constructor(options: ISdTsCompilerOptions);
+}
+
 interface ISdTsCompilerOptions {
   pkgDir: string;
   cwd: string;
   output: { js: boolean; dts: boolean };
   includeTests?: boolean;
-  env?: TypecheckEnv;
+  env?: TypecheckEnv; // "node" | "browser"
+
   // Angular 전용 (isForAngular 시 활성)
   sourceFileCache?: AngularSourceFileCache;
   transformStylesheet?: (data: string, containingFile: string, stylesheetFile?: string) => Promise<string | null>;
   externalStylesheets?: Map<string, string>;
   compilerOptionsTransformer?: (options: ts.CompilerOptions) => ts.CompilerOptions;
-  // SCSS/lint 통합
+
+  // SCSS / lint 통합
   lint?: boolean;
   globalScss?: boolean;
 }
 ```
 
-- pkgDir: string — 컴파일 대상 패키지 디렉토리. `<pkgDir>/tsconfig.json` 을 파싱하고 `<pkgDir>/dist` 로 emit, `<pkgDir>/.cache` 에 tsbuildinfo 를 둔다.
-- cwd: string — 워크스페이스 루트. 진단 필터링(`isWorkspaceDiagnostic`)·경로 상대화·에러 포맷 기준점.
-- output.js: boolean — JS emit 여부. true 면 `.js` 산출(non-Angular 은 import 에 `.js` 확장자 부착 + 경로 재작성, Angular 은 `emitResults` 로 반환).
-- output.dts: boolean — `.d.ts` emit 여부. `js`/`dts` 조합에 따라 emit-only·declaration-only·noEmit(둘 다 false = 타입체크만) 으로 분기.
-- includeTests?: boolean — `tests/` 파일을 rootNames 에 포함할지. 기본 false. 테스트까지 컴파일해야 하면 true(예: `sdAngularPlugin`).
-- env?: TypecheckEnv — 타입체크 환경. 지정 시 `getCompilerOptionsForEnv()` 로 환경별 compilerOptions 를 적용하고 tsbuildinfo 파일명에 접미사를 붙임. 환경 분리 타입체크에 쓴다.
-- sourceFileCache?: AngularSourceFileCache — Angular 증분용 SourceFile 캐시. 미제공 시 내부 생성. 여러 `compileAsync` 라운드 간 캐시를 공유하려면 외부에서 주입.
-- transformStylesheet?: (data, containingFile, stylesheetFile?) => Promise<string|null> — 컴포넌트 스타일 변환 콜백(Angular only). `null` 반환 시 변환 안 함. 미제공이고 Angular 면 라이브러리용 SCSS 변환 콜백을 자동 생성. 클라이언트 빌드처럼 커스텀 스타일 파이프라인이 필요할 때 직접 제공.
-- externalStylesheets?: Map<string, string> — 외부 스타일시트 맵(클라이언트 빌드용). 지정 시 비-템플릿 스타일 리소스를 해시 기반 `.css` 외부 파일명으로 매핑(`resourceNameToFileName`). 스타일을 별도 청크로 뽑을 때.
-- compilerOptionsTransformer?: (options) => ts.CompilerOptions — 최종 compilerOptions 후처리 훅. 클라이언트의 `target`/`module`/`rootDir` 강제, Vitest 의 `inlineSourceMap` 강제 등에 쓴다.
-- lint?: boolean — true 면 `compileAsync` 가 program 기반 lint 를 함께 돌려 결과를 `result.lint` 에 담는다(affected 파일만 대상, globalScss 와 병렬 실행). 컴파일과 동시에 lint 하고 싶을 때.
-- globalScss?: boolean — true 면 `scss/styles.scss` → `styles.css`(패키지 루트) 글로벌 SCSS 를 컴파일하고 에러를 `result.scssErrors` 에 더한다.
-
-## ISdTsCompilerEmitOptions (compileAsync 2번째 인자)
+- **pkgDir**: string — 컴파일 대상 패키지 디렉토리. 출력은 이 아래 `dist/`, 캐시는 `.cache/*.tsbuildinfo` 에 떨어진다.
+- **cwd**: string — workspace 루트. 진단 필터링(`isWorkspaceDiagnostic`)·경로 상대화에 사용.
+- **output**: `{ js: boolean; dts: boolean }` — 출력 제어. `js+dts` → JS+선언파일, `js` 만 → JS 만(`declaration:false`), `dts` 만 → 선언파일만(`emitDeclarationOnly:true`), 둘 다 false → `noEmit:true`(타입체크 전용). tsBuildInfo 파일명도 이에 따라 달라짐.
+- **includeTests**: boolean — `true` 면 `tests/` 파일을 rootNames 에 포함(`getPackageFiles`), 기본/`false` 면 소스만(`getPackageSourceFiles`).
+- **env**: `TypecheckEnv`(`"node" | "browser"`) — 지정 시 `getCompilerOptionsForEnv()` 로 env 별 lib 등을 조정. tsBuildInfo 파일명에 `-<env>` 접미사가 붙는다.
+- **sourceFileCache**: `AngularSourceFileCache` — Angular 증분 빌드용 SourceFile 캐시. 미제공 시 내부 생성. 여러 `compileAsync` 간 SourceFile 을 재사용.
+- **transformStylesheet**: `(data, containingFile, stylesheetFile?) => Promise<string|null>` — 스타일시트 변환 콜백(Angular only). 컴포넌트 인라인/외부 스타일을 변환. 미제공 + Angular 면 내부 라이브러리용 콜백을 자동 생성. 반환 `null` 이면 변환 없음.
+- **externalStylesheets**: `Map<string, string>` — 외부 스타일시트 맵(클라이언트 빌드용). 해석된 스타일 경로를 해시 ID 로 매핑해 `<id>.css` 가상 파일명으로 분리.
+- **compilerOptionsTransformer**: `(options) => options` — 최종 `compilerOptions` 후처리. 클라이언트의 target/module 강제, `inlineSourceMap` 등 강제에 사용(`sdAngularPlugin` 이 이걸 씀).
+- **lint**: boolean — `true` 면 `compileAsync` 가 ESLint 를 같은 Program 으로 실행하고 결과를 `result.lint` 에 담는다(중복 Program 생성 방지). 글로벌 SCSS 와 병렬 실행.
+- **globalScss**: boolean — `true` 면 `scss/styles.scss` → 패키지 루트 `styles.css` 를 생성. 에러는 `result.scssErrors` 에 누적.
+
+```typescript
+import { SdTsCompiler } from "@simplysm/sd-cli";
+
+const compiler = new SdTsCompiler({
+  pkgDir: path.resolve(cwd, "packages/excel"),
+  cwd,
+  output: { js: true, dts: true },
+});
+const result = await compiler.compileAsync();
+```
+
+## compileAsync
 
 ```typescript
+compileAsync(
+  modifiedFiles?: ReadonlySet<string>,
+  emitOptions?: ISdTsCompilerEmitOptions,
+): Promise<ISdTsCompilerResult>;
+
 interface ISdTsCompilerEmitOptions {
   sourceFilter?: (fileName: string) => boolean;
   additionalTransformers?: {
@@ -47,43 +68,18 @@ interface ISdTsCompilerEmitOptions {
 }
 ```
 
-- sourceFilter?: (fileName) => boolean — emit 결과 필터(Angular only). true 인 소스만 `emitResults` 에 남긴다. 특정 파일의 emit 만 필요할 때(예: HMR 단일 파일).
-- additionalTransformers?.before / .after — Angular 기본 transformers 앞/뒤에 끼울 추가 TS transformer 배열(Angular only). before = 변환 전, after = 변환 후 단계에 주입. 커스텀 코드 변환을 끼울 때.
+- **modifiedFiles**: `ReadonlySet<string>` — 직전 호출 이후 변경된 파일 집합. 지정 시 SourceFile 캐시를 무효화하고, `node_modules` 경로가 포함되면 package.json 해석 캐시도 클리어. 미지정 시 전체 기준으로 진행. watch 재빌드에서 증분 컴파일에 쓴다.
+- **emitOptions.sourceFilter**: `(fileName) => boolean` — Angular only. emit 결과 중 이 필터를 통과한 소스만 `emitResults` 에 남긴다.
+- **emitOptions.additionalTransformers**: Angular only. Angular transformer 뒤에 `before`/`after` 커스텀 transformer 를 덧붙인다.
 
-## SdTsCompiler — 메서드
+여러 단계(analyze/affected 탐색/emit/진단 수집/lint+globalScss)를 각각 try-catch 로 감싸 한 단계가 크래시해도 나머지를 진행하고, 크래시는 `ISdTsCompilerResult.diagnostics` 에 에러 진단으로 합산된다.
 
 ```typescript
-class SdTsCompiler {
-  constructor(options: ISdTsCompilerOptions);
-  compileAsync(modifiedFiles?: ReadonlySet<string>, emitOptions?: ISdTsCompilerEmitOptions): Promise<ISdTsCompilerResult>;
-  get sideEffectScssRegistry(): Map<string, SideEffectScssEntry>;
-  compileSideEffectScss(): void;
-  findAffectedByScss(scssPath: string): string[];
-}
-```
-
-- compileAsync(modifiedFiles?, emitOptions?) — 1회 증분 컴파일 실행. `modifiedFiles` = 직전 변경된 파일 절대경로 집합(증분 무효화용, 미지정·빈 집합이면 캐시 그대로 사용; node_modules 포함 변경 시 packageJsonCache 클리어). `emitOptions` 는 위 emit 필터/transformer. 같은 인스턴스로 반복 호출해 증분 빌드를 이어간다.
-- sideEffectScssRegistry (getter) — side-effect SCSS 등록부(`Map<소스, SideEffectScssEntry>`) 참조. emit 코드가 항목을 등록하는 통로.
-- compileSideEffectScss() — 위 레지스트리의 모든 항목을 CSS 로 컴파일하고 에러/의존성을 내부 상태에 반영.
-- findAffectedByScss(scssPath) — 주어진 SCSS 경로에 의존하는 소유자 파일 경로 배열을 반환(역방향 탐색). watch 에서 SCSS 변경 시 재컴파일 대상 산출에 쓴다.
-
-사용 예:
-
-```typescript
-import { SdTsCompiler } from "@simplysm/sd-cli";
-
-const compiler = new SdTsCompiler({
-  pkgDir: "/repo/packages/core-common",
-  cwd: "/repo",
-  output: { js: true, dts: true },
-});
-const result = await compiler.compileAsync();
-if (result.errorCount > 0) console.error(result.errors);
-// watch 라운드: 변경 파일만 넘겨 증분 컴파일
-const next = await compiler.compileAsync(new Set(["/repo/packages/core-common/src/foo.ts"]));
+// watch 재빌드: 변경 파일만 넘겨 증분 컴파일
+const result = await compiler.compileAsync(new Set(["packages/excel/src/a.ts"]));
 ```
 
-## ISdTsCompilerResult (compileAsync 반환)
+## ISdTsCompilerResult
 
 ```typescript
 interface ISdTsCompilerResult {
@@ -96,23 +92,29 @@ interface ISdTsCompilerResult {
   warningCount: number;
   errors?: string[];
   ngtscProgram?: NgtscProgram;
-  emitResults?: EmitResult[]; // EmitResult: { filename; contents; sourceFileName }
-  lint?: LintWithProgramResult;
+  emitResults?: EmitResult[];        // { filename, contents, sourceFileName }
+  lint?: LintWithProgramResult;      // { success, errorCount, warningCount, formattedOutput }
   scssErrors: string[];
   scssDependencies: ReadonlyMap<string, ReadonlySet<string>>;
 }
 ```
 
-- program: ts.Program — TS Program 참조. lint·외부 도구에 넘길 때.
-- builderProgram: ts.EmitAndSemanticDiagnosticsBuilderProgram — 증분 BuilderProgram 참조.
-- isForAngular: boolean — Angular 모드로 컴파일됐는지(tsconfig 의 `angularCompilerOptions` 유무로 결정). 후속 처리 분기에 쓴다.
-- affectedFiles: ReadonlySet<string> | undefined — 이번 빌드에서 영향받은 파일(posix 경로). `undefined` = 전역 변경(전체 리빌드). 부분 재처리 범위 판단에 쓴다.
-- diagnostics: SerializedDiagnostic[] — 직렬화된 진단 전체(worker 경계 통과용). 내부 크래시 진단도 합산됨.
-- errorCount: number — Error 카테고리 진단 수. 크래시는 여기에 가산.
-- warningCount: number — Warning 카테고리 진단 수.
-- errors?: string[] — Error 진단을 `"파일:줄:열: TS코드: 메시지"` 형식으로 포맷한 배열(없으면 undefined). 로그 출력에 바로 쓴다.
-- ngtscProgram?: NgtscProgram — NgtscProgram 참조(Angular only, HMR 용). non-Angular 이면 undefined.
-- emitResults?: EmitResult[] — Angular emit 결과 배열. 각 항목 `{ filename; contents; sourceFileName }`(sourceFileName = 원본 소스 경로). non-Angular 은 writeFile 훅으로 디스크에 직접 쓰므로 undefined. 메모리상 컴파일 결과가 필요한 플러그인이 소비.
-- lint?: LintWithProgramResult — lint 결과(`lint: true` 일 때만). `{ success; errorCount; warningCount; formattedOutput }` 형상.
-- scssErrors: string[] — SCSS 컴파일 에러 목록.
-- scssDependencies: ReadonlyMap<string, ReadonlySet<string>> — SCSS 의존성 맵(소유자 파일 → 의존 SCSS 경로 집합). watch 역방향 탐색용.
+- **program / builderProgram**: TypeScript Program 과 Builder Program 참조(lint·외부 도구·증분 빌드용).
+- **isForAngular**: boolean — tsconfig 에 `angularCompilerOptions` 가 있어 Angular AOT 모드로 컴파일됐는지.
+- **affectedFiles**: `ReadonlySet<string> | undefined` — 이번 빌드에서 영향받은 파일(posix 경로). `undefined` 면 전역 변경(전체 리빌드).
+- **diagnostics**: `SerializedDiagnostic[]` — 직렬화된 진단(worker 경계 통과용). workspace 외부 진단은 필터링됨.
+- **errorCount / warningCount**: Error/Warning 카테고리 진단 수(크래시 진단 포함).
+- **errors**: string[] — Error 진단을 `"파일:줄:열: TS코드: 메시지"` 형식으로 포맷한 배열. 에러 없으면 `undefined`.
+- **ngtscProgram**: `NgtscProgram` — Angular only(HMR 용). Non-Angular 이면 `undefined`.
+- **emitResults**: `EmitResult[]` — Angular emit 결과(`{ filename, contents, sourceFileName }`). **Non-Angular 이면 `undefined`** — Non-Angular 은 writeFile 훅으로 디스크에 직접 쓰기 때문(메모리 반환 아님).
+- **lint**: `LintWithProgramResult` — `lint:true` 일 때만. `{ success, errorCount, warningCount, formattedOutput }`.
+- **scssErrors**: string[] — SCSS 컴파일 에러 목록(글로벌/side-effect/스타일시트 변환 누적).
+- **scssDependencies**: `ReadonlyMap<string, ReadonlySet<string>>` — 소유자 파일 → 의존 SCSS 경로 집합. watch 에서 SCSS 변경의 역방향 탐색에 사용.
+
+## 보조 메서드
+
+`SdTsCompiler` 는 SCSS 처리용 보조 멤버도 노출한다(주로 빌드 엔진 내부 배선용):
+
+- **get sideEffectScssRegistry**: `Map<string, SideEffectScssEntry>` — side-effect SCSS 레지스트리 참조. emit 코드에서 항목 등록용.
+- **compileSideEffectScss()**: 레지스트리의 모든 항목을 CSS 로 컴파일. 에러는 `scssErrors` 에 누적.
+- **findAffectedByScss(scssPath)**: `string[]` — 주어진 SCSS 경로에 의존하는 파일 목록 반환(watch 역방향 탐색).