@simplysm/sd-cli 13.0.27 → 13.0.29

package/src/orchestrators/DevOrchestrator.ts

@@ -5,12 +5,20 @@ import type { SdConfig, SdClientPackageConfig, SdServerPackageConfig } from "../
 import { consola } from "consola";
 import { loadSdConfig } from "../utils/sd-config";
 import { getVersion } from "../utils/build-env";
-import { setupReplaceDeps, watchReplaceDeps, type WatchReplaceDepResult } from "../utils/replace-deps";
+import {
+  setupReplaceDeps,
+  watchReplaceDeps,
+  type WatchReplaceDepResult,
+} from "../utils/replace-deps";
 import type * as ClientWorkerModule from "../workers/client.worker";
 import type * as ServerWorkerModule from "../workers/server.worker";
 import type * as ServerRuntimeWorkerModule from "../workers/server-runtime.worker";
 import { Capacitor } from "../capacitor/capacitor";
-import { filterPackagesByTargets, getWatchScopes, type PackageResult } from "../utils/package-utils";
+import {
+  filterPackagesByTargets,
+  getWatchScopes,
+  type PackageResult,
+} from "../utils/package-utils";
 import { printErrors, printServers } from "../utils/output-utils";
 import { RebuildManager } from "../utils/rebuild-manager";
 import {
@@ -86,7 +94,10 @@ export class DevOrchestrator {
       mainJsPath?: string;
     }
   >();
-  private readonly _serverRuntimeWorkers = new Map<string, WorkerProxy<typeof ServerRuntimeWorkerModule>>();
+  private readonly _serverRuntimeWorkers = new Map<
+    string,
+    WorkerProxy<typeof ServerRuntimeWorkerModule>
+  >();
 
   // State
   private readonly _results = new Map<string, PackageResult>();
@@ -125,7 +136,11 @@ export class DevOrchestrator {
 
     // sd.config.ts 로드 (dev는 패키지 빌드 정보가 필요하므로 필수)
     try {
-      this._sdConfig = await loadSdConfig({ cwd: this._cwd, dev: true, opt: this._options.options });
+      this._sdConfig = await loadSdConfig({
+        cwd: this._cwd,
+        dev: true,
+        opt: this._options.options,
+      });
       this._logger.debug("sd.config.ts 로드 완료");
     } catch (err) {
       this._logger.error(`sd.config.ts 로드 실패: ${err instanceof Error ? err.message : err}`);
@@ -213,7 +228,8 @@ export class DevOrchestrator {
     this._standaloneClientWorkers = this._clientPackages
       .filter(
         ({ config }) =>
-          typeof config.server === "number" || (typeof config.server === "string" && !serverNames.has(config.server)),
+          typeof config.server === "number" ||
+          (typeof config.server === "string" && !serverNames.has(config.server)),
       )
       .map(({ name, config }) => ({
         name,
@@ -247,7 +263,10 @@ export class DevOrchestrator {
 
     // Vite client 빌드 Promise 미리 생성 (서버 연결 클라이언트)
     const viteClientBuildPromises = new Map<string, Promise<void>>();
-    const viteClientReadyPromises = new Map<string, { promise: Promise<void>; resolver: () => void }>();
+    const viteClientReadyPromises = new Map<
+      string,
+      { promise: Promise<void>; resolver: () => void }
+    >();
     for (const workerInfo of this._viteClientWorkers) {
       viteClientBuildPromises.set(
         workerInfo.name,
@@ -260,7 +279,10 @@ export class DevOrchestrator {
       const readyPromise = new Promise<void>((resolve) => {
         readyResolver = resolve;
       });
-      viteClientReadyPromises.set(workerInfo.name, { promise: readyPromise, resolver: readyResolver });
+      viteClientReadyPromises.set(workerInfo.name, {
+        promise: readyPromise,
+        resolver: readyResolver,
+      });
     }
 
     // Server Build Worker 및 Promise 생성
@@ -277,7 +299,10 @@ export class DevOrchestrator {
     }
 
     // Server Runtime Promise (초기 서버 시작 완료 대기용)
-    const serverRuntimePromises = new Map<string, { promise: Promise<void>; resolver: () => void }>();
+    const serverRuntimePromises = new Map<
+      string,
+      { promise: Promise<void>; resolver: () => void }
+    >();
     for (const { name } of this._serverPackages) {
       let resolver!: () => void;
       const promise = new Promise<void>((resolve) => {
@@ -448,7 +473,8 @@ export class DevOrchestrator {
         }
 
         // 새 Server Runtime Worker 생성 및 시작
-        const runtimeWorker = Worker.create<typeof ServerRuntimeWorkerModule>(serverRuntimeWorkerPath);
+        const runtimeWorker =
+          Worker.create<typeof ServerRuntimeWorkerModule>(serverRuntimeWorkerPath);
         this._serverRuntimeWorkers.set(serverName, runtimeWorker);
 
         // 이 서버에 연결된 클라이언트들의 Vite 서버가 준비될 때까지 대기
@@ -456,7 +482,9 @@ export class DevOrchestrator {
         const clientReadyPromises = connectedClients
           .map((clientName) => viteClientReadyPromises.get(clientName)?.promise)
           .filter((p): p is Promise<void> => p != null);
-        this._logger.debug(`[${serverName}] 클라이언트 대기: ${String(clientReadyPromises.length)}개`);
+        this._logger.debug(
+          `[${serverName}] 클라이언트 대기: ${String(clientReadyPromises.length)}개`,
+        );
         if (clientReadyPromises.length > 0) {
           await Promise.all(clientReadyPromises);
         }
@@ -651,7 +679,9 @@ export class DevOrchestrator {
       })),
     ];
 
-    const initialResults = await Promise.allSettled(initialBuildPromises.map((item) => item.promise));
+    const initialResults = await Promise.allSettled(
+      initialBuildPromises.map((item) => item.promise),
+    );
 
     initialResults.forEach((result, index) => {
       const taskName = initialBuildPromises[index].name;

package/src/orchestrators/WatchOrchestrator.ts

@@ -3,7 +3,11 @@ import { consola } from "consola";
 import type { BuildTarget, SdConfig, SdPackageConfig } from "../sd-config.types";
 import { loadSdConfig } from "../utils/sd-config";
 import { filterPackagesByTargets } from "../utils/package-utils";
-import { setupReplaceDeps, watchReplaceDeps, type WatchReplaceDepResult } from "../utils/replace-deps";
+import {
+  setupReplaceDeps,
+  watchReplaceDeps,
+  type WatchReplaceDepResult,
+} from "../utils/replace-deps";
 import { printErrors } from "../utils/output-utils";
 import { RebuildManager } from "../utils/rebuild-manager";
 import { ResultCollector } from "../infra/ResultCollector";

package/src/sd-cli-entry.ts

@@ -325,6 +325,9 @@ export function createCliParser(argv: string[]): Argv {
 // CLI로 직접 실행될 때만 파싱 수행
 // ESM에서 메인 모듈 판별: import.meta.url과 process.argv[1]을 정규화하여 비교
 const cliEntryPath = process.argv.at(1);
-if (cliEntryPath != null && fileURLToPath(import.meta.url) === fs.realpathSync(path.resolve(cliEntryPath))) {
+if (
+  cliEntryPath != null &&
+  fileURLToPath(import.meta.url) === fs.realpathSync(path.resolve(cliEntryPath))
+) {
   await createCliParser(hideBin(process.argv)).parse();
 }

package/src/sd-cli.ts

@@ -42,7 +42,12 @@ if (isDev) {
   const cliEntryFilePath = path.join(__dirname, "sd-cli-entry.js");
   const child = spawn(
     "node",
-    ["--max-old-space-size=8192", "--max-semi-space-size=16", cliEntryFilePath, ...process.argv.slice(2)],
+    [
+      "--max-old-space-size=8192",
+      "--max-semi-space-size=16",
+      cliEntryFilePath,
+      ...process.argv.slice(2),
+    ],
     { stdio: "inherit" },
   );
   child.on("spawn", () => {

package/src/utils/config-editor.ts

@@ -31,7 +31,9 @@ function findPackagesObject(configPath: string): {
   }
 
   // "packages" 프로퍼티 찾기
-  const packagesProp = returnObj.getPropertyOrThrow("packages").asKindOrThrow(SyntaxKind.PropertyAssignment);
+  const packagesProp = returnObj
+    .getPropertyOrThrow("packages")
+    .asKindOrThrow(SyntaxKind.PropertyAssignment);
   const packagesObj = packagesProp.getInitializerIfKindOrThrow(SyntaxKind.ObjectLiteralExpression);
 
   return { project, packagesObj };
@@ -50,7 +52,8 @@ export function addPackageToSdConfig(
   const { project, packagesObj } = findPackagesObject(configPath);
 
   // 이미 존재하는지 확인 (따옴표 있는 형태와 없는 형태 모두 체크)
-  const existing = packagesObj.getProperty(`"${packageName}"`) ?? packagesObj.getProperty(packageName);
+  const existing =
+    packagesObj.getProperty(`"${packageName}"`) ?? packagesObj.getProperty(packageName);
   if (existing) {
     return false;
   }
@@ -72,10 +75,15 @@ export function addPackageToSdConfig(
 /**
  * sd.config.ts에서 특정 클라이언트의 server 필드를 설정한다.
  */
-export function setClientServerInSdConfig(configPath: string, clientName: string, serverName: string): void {
+export function setClientServerInSdConfig(
+  configPath: string,
+  clientName: string,
+  serverName: string,
+): void {
   const { project, packagesObj } = findPackagesObject(configPath);
 
-  const clientPropNode = packagesObj.getProperty(`"${clientName}"`) ?? packagesObj.getProperty(clientName);
+  const clientPropNode =
+    packagesObj.getProperty(`"${clientName}"`) ?? packagesObj.getProperty(clientName);
   if (clientPropNode == null) {
     throw new Error(`클라이언트 "${clientName}"을(를) sd.config.ts에서 찾을 수 없습니다.`);
   }
@@ -108,7 +116,9 @@ export function addTailwindToEslintConfig(configPath: string, clientName: string
   const sourceFile = project.addSourceFileAtPath(configPath);
 
   // default export 배열 찾기
-  const defaultExport = sourceFile.getFirstDescendantByKindOrThrow(SyntaxKind.ArrayLiteralExpression);
+  const defaultExport = sourceFile.getFirstDescendantByKindOrThrow(
+    SyntaxKind.ArrayLiteralExpression,
+  );
 
   // tailwindcss 설정이 이미 있는지 확인
   const text = defaultExport.getText();

package/src/utils/copy-public.ts

@@ -47,7 +47,10 @@ export async function copyPublicFiles(pkgDir: string, includeDev: boolean): Prom
  * @param includeDev public-dev/ 포함 여부 (dev 모드에서만 true)
  * @returns FsWatcher 인스턴스 (shutdown 시 close() 호출 필요) 또는 watch할 대상이 없으면 undefined
  */
-export async function watchPublicFiles(pkgDir: string, includeDev: boolean): Promise<FsWatcher | undefined> {
+export async function watchPublicFiles(
+  pkgDir: string,
+  includeDev: boolean,
+): Promise<FsWatcher | undefined> {
   const distDir = path.join(pkgDir, "dist");
   const publicDir = path.join(pkgDir, "public");
   const publicDevDir = path.join(pkgDir, "public-dev");

package/src/utils/esbuild-config.ts

@@ -99,7 +99,9 @@ export function createLibraryEsbuildOptions(options: LibraryEsbuildOptions): esb
     target: options.target === "node" ? "node20" : "chrome84",
     bundle: false,
     write: false,
-    tsconfigRaw: { compilerOptions: options.compilerOptions as esbuild.TsconfigRaw["compilerOptions"] },
+    tsconfigRaw: {
+      compilerOptions: options.compilerOptions as esbuild.TsconfigRaw["compilerOptions"],
+    },
     logLevel: "silent",
     plugins,
   };
@@ -135,7 +137,9 @@ export function createServerEsbuildOptions(options: ServerEsbuildOptions): esbui
     },
     external: options.external,
     define,
-    tsconfigRaw: { compilerOptions: options.compilerOptions as esbuild.TsconfigRaw["compilerOptions"] },
+    tsconfigRaw: {
+      compilerOptions: options.compilerOptions as esbuild.TsconfigRaw["compilerOptions"],
+    },
     logLevel: "silent",
   };
 }
@@ -176,7 +180,12 @@ export function collectUninstalledOptionalPeerDeps(pkgDir: string): string[] {
   return [...external];
 }
 
-function scanOptionalPeerDeps(pkgName: string, resolveDir: string, external: Set<string>, visited: Set<string>): void {
+function scanOptionalPeerDeps(
+  pkgName: string,
+  resolveDir: string,
+  external: Set<string>,
+  visited: Set<string>,
+): void {
   if (visited.has(pkgName)) return;
   visited.add(pkgName);
 
@@ -233,7 +242,12 @@ export function collectNativeModuleExternals(pkgDir: string): string[] {
   return [...external];
 }
 
-function scanNativeModules(pkgName: string, resolveDir: string, external: Set<string>, visited: Set<string>): void {
+function scanNativeModules(
+  pkgName: string,
+  resolveDir: string,
+  external: Set<string>,
+  visited: Set<string>,
+): void {
   if (visited.has(pkgName)) return;
   visited.add(pkgName);
 

package/src/utils/output-utils.ts

@@ -32,7 +32,10 @@ export function printErrors(results: Map<string, ErrorResult>): void {
  * @param results 패키지별 빌드 결과 상태
  * @param serverClientsMap 서버별 연결된 클라이언트 목록
  */
-export function printServers(results: Map<string, PackageResult>, serverClientsMap?: Map<string, string[]>): void {
+export function printServers(
+  results: Map<string, PackageResult>,
+  serverClientsMap?: Map<string, string[]>,
+): void {
   // 서버 정보 수집
   const servers = [...results.values()].filter((r) => r.status === "running" && r.port != null);
 

package/src/utils/rebuild-manager.ts

@@ -7,7 +7,10 @@ interface RebuildManagerEvents {
 
 export class RebuildManager extends EventEmitter<RebuildManagerEvents> {
   private _isRunning = false;
-  private readonly _pendingBuilds = new Map<string, { title: string; promise: Promise<void>; resolver: () => void }>();
+  private readonly _pendingBuilds = new Map<
+    string,
+    { title: string; promise: Promise<void>; resolver: () => void }
+  >();
   private readonly _logger: ReturnType<typeof consola.withTag>;
 
   constructor(logger: ReturnType<typeof consola.withTag>) {

package/src/utils/replace-deps.ts

@@ -157,7 +157,10 @@ async function collectSearchRoots(projectRoot: string): Promise<string[]> {
  * @param projectRoot - 프로젝트 루트 경로
  * @param replaceDeps - sd.config.ts의 replaceDeps 설정
  */
-export async function setupReplaceDeps(projectRoot: string, replaceDeps: Record<string, string>): Promise<void> {
+export async function setupReplaceDeps(
+  projectRoot: string,
+  replaceDeps: Record<string, string>,
+): Promise<void> {
   const logger = consola.withTag("sd:cli:replace-deps");
 
   // 1. Workspace 패키지 경로 목록 수집
@@ -348,7 +351,9 @@ export async function watchReplaceDeps(
               logger.info(`삭제: ${relativePath} (${e.targetName})`);
             }
           } catch (err) {
-            logger.error(`복사 실패 (${e.targetName}/${relativePath}): ${err instanceof Error ? err.message : err}`);
+            logger.error(
+              `복사 실패 (${e.targetName}/${relativePath}): ${err instanceof Error ? err.message : err}`,
+            );
           }
         }
       }

package/src/utils/sd-config.ts

@@ -9,7 +9,11 @@ import type { SdConfig } from "../sd-config.types";
  * @returns SdConfig 객체
  * @throws sd.config.ts가 없거나 형식이 잘못된 경우
  */
-export async function loadSdConfig(params: { cwd: string; dev: boolean; opt: string[] }): Promise<SdConfig> {
+export async function loadSdConfig(params: {
+  cwd: string;
+  dev: boolean;
+  opt: string[];
+}): Promise<SdConfig> {
   const sdConfigPath = path.resolve(params.cwd, "sd.config.ts");
 
   if (!(await fsExists(sdConfigPath))) {

package/src/utils/spawn.ts

@@ -72,7 +72,9 @@ export async function spawn(cmd: string, args: string[], options?: SpawnOptions)
       if (code === 0) {
         resolve(output);
       } else {
-        reject(new Error(`명령어 실패 (${cmd} ${args.join(" ")})\n종료 코드: ${code}\n출력:\n${output}`));
+        reject(
+          new Error(`명령어 실패 (${cmd} ${args.join(" ")})\n종료 코드: ${code}\n출력:\n${output}`),
+        );
       }
     });
   });

package/src/utils/template.ts

@@ -31,7 +31,12 @@ export async function renderTemplateDir(
     if (stat.isDirectory()) {
       // 디렉토리 이름 치환 적용
       const destName = dirReplacements?.[entry] ?? entry;
-      await renderTemplateDir(path.join(srcDir, entry), path.join(destDir, destName), context, dirReplacements);
+      await renderTemplateDir(
+        path.join(srcDir, entry),
+        path.join(destDir, destName),
+        context,
+        dirReplacements,
+      );
     } else if (entry.endsWith(".hbs")) {
       // Handlebars 템플릿 렌더링
       const source = await fsRead(srcPath);

package/src/utils/tsconfig.ts

@@ -18,7 +18,9 @@ export async function getTypesFromPackageJson(packageDir: string): Promise<strin
     return [];
   }
 
-  const packageJson = await fsReadJson<{ devDependencies?: Record<string, string> }>(packageJsonPath);
+  const packageJson = await fsReadJson<{ devDependencies?: Record<string, string> }>(
+    packageJsonPath,
+  );
   const devDeps = packageJson.devDependencies ?? {};
 
   return Object.keys(devDeps)
@@ -104,7 +106,10 @@ export function parseRootTsconfig(cwd: string): ts.ParsedCommandLine {
 /**
  * 패키지의 소스 파일 목록 가져오기 (tsconfig 기반)
  */
-export function getPackageSourceFiles(pkgDir: string, parsedConfig: ts.ParsedCommandLine): string[] {
+export function getPackageSourceFiles(
+  pkgDir: string,
+  parsedConfig: ts.ParsedCommandLine,
+): string[] {
   // 경로 구분자까지 포함하여 비교 (packages/core와 packages/core-common 구분)
   const pkgSrcPrefix = path.join(pkgDir, "src") + path.sep;
   return parsedConfig.fileNames.filter((f) => f.startsWith(pkgSrcPrefix));

package/src/utils/typecheck-serialization.ts

@@ -43,7 +43,8 @@ export function serializeDiagnostic(diagnostic: ts.Diagnostic): SerializedDiagno
 function getScriptKind(fileName: string): ts.ScriptKind {
   if (fileName.endsWith(".tsx")) return ts.ScriptKind.TSX;
   if (fileName.endsWith(".jsx")) return ts.ScriptKind.JSX;
-  if (fileName.endsWith(".js") || fileName.endsWith(".mjs") || fileName.endsWith(".cjs")) return ts.ScriptKind.JS;
+  if (fileName.endsWith(".js") || fileName.endsWith(".mjs") || fileName.endsWith(".cjs"))
+    return ts.ScriptKind.JS;
   return ts.ScriptKind.TS;
 }
 
@@ -54,7 +55,10 @@ function getScriptKind(fileName: string): ts.ScriptKind {
  * @param fileCache 파일 내용 캐시 (동일 파일 중복 읽기 방지)
  * @returns 복원된 ts.Diagnostic 객체
  */
-export function deserializeDiagnostic(serialized: SerializedDiagnostic, fileCache: Map<string, string>): ts.Diagnostic {
+export function deserializeDiagnostic(
+  serialized: SerializedDiagnostic,
+  fileCache: Map<string, string>,
+): ts.Diagnostic {
   let file: ts.SourceFile | undefined;
   if (serialized.file != null) {
     const fileName = serialized.file.fileName;

package/src/utils/vite-config.ts

@@ -170,7 +170,8 @@ function sdScopeWatchPlugin(pkgDir: string, scopes: string[], onScopeRebuild?: (
               // 같은 scope 내 패키지는 이미 excluded이므로 제외
               if (scopes.some((s) => dep.startsWith(`${s}/`))) continue;
               // SolidJS 관련 패키지는 solid 플러그인 transform이 필요하므로 pre-bundling 불가
-              if (dep === "solid-js" || dep.startsWith("@solidjs/") || dep.startsWith("solid-")) continue;
+              if (dep === "solid-js" || dep.startsWith("@solidjs/") || dep.startsWith("solid-"))
+                continue;
               // PostCSS/빌드 도구는 브라우저 pre-bundling 대상 아님
               if (dep === "tailwindcss") continue;
 
@@ -185,7 +186,13 @@ function sdScopeWatchPlugin(pkgDir: string, scopes: string[], onScopeRebuild?: (
 
               // workspace 패키지는 realpath가 소스 디렉토리로 해석되어 .pnpm 구조가 아님
               // symlink 경로의 node_modules에서 fallback 시도
-              const depPkgJsonFallback = path.join(scopeDir, name, "node_modules", dep, "package.json");
+              const depPkgJsonFallback = path.join(
+                scopeDir,
+                name,
+                "node_modules",
+                dep,
+                "package.json",
+              );
               if (isSubpathOnlyPackage(depPkgJsonFallback)) {
                 continue;
               }
@@ -200,32 +207,47 @@ function sdScopeWatchPlugin(pkgDir: string, scopes: string[], onScopeRebuild?: (
 
       return {
         optimizeDeps: {
+          force: true,
           exclude: excluded,
           include: [...new Set(nestedDepsToInclude)],
         },
       };
     },
     async configureServer(server) {
-      const distDirs: string[] = [];
+      const watchPaths: string[] = [];
 
       for (const scope of scopes) {
         const scopeDir = path.join(pkgDir, "node_modules", scope);
         if (!fs.existsSync(scopeDir)) continue;
 
         for (const pkgName of fs.readdirSync(scopeDir)) {
-          const distDir = path.join(scopeDir, pkgName, "dist");
+          const pkgRoot = path.join(scopeDir, pkgName);
+
+          // dist 디렉토리 watch (JS/TS 빌드 결과물)
+          const distDir = path.join(pkgRoot, "dist");
           if (fs.existsSync(distDir)) {
-            distDirs.push(distDir);
+            watchPaths.push(distDir);
+          }
+
+          // 패키지 루트의 CSS/config 파일 watch (tailwind.css, tailwind.config.ts 등)
+          for (const file of fs.readdirSync(pkgRoot)) {
+            if (
+              file.endsWith(".css") ||
+              file === "tailwind.config.ts" ||
+              file === "tailwind.config.js"
+            ) {
+              watchPaths.push(path.join(pkgRoot, file));
+            }
           }
         }
       }
 
-      if (distDirs.length === 0) return;
+      if (watchPaths.length === 0) return;
 
       // Vite의 기본 watcher는 **/node_modules/**를 ignore하고
       // server.watcher.add()로는 이 패턴을 override할 수 없다.
       // 별도의 FsWatcher로 scope 패키지의 dist 디렉토리를 감시한다.
-      const scopeWatcher = await FsWatcher.watch(distDirs);
+      const scopeWatcher = await FsWatcher.watch(watchPaths);
       scopeWatcher.onChange({ delay: 300 }, (changeInfos) => {
         for (const { path: changedPath } of changeInfos) {
           // pnpm symlink → real path 변환 (Vite module graph은 real path 사용)
@@ -275,7 +297,8 @@ export interface ViteConfigOptions {
  * - dev 모드: dev server (define으로 env 치환, server 설정)
  */
 export function createViteConfig(options: ViteConfigOptions): ViteUserConfig {
-  const { pkgDir, name, tsconfigPath, compilerOptions, env, mode, serverPort, watchScopes } = options;
+  const { pkgDir, name, tsconfigPath, compilerOptions, env, mode, serverPort, watchScopes } =
+    options;
 
   // Read package.json to extract app name for PWA manifest
   const pkgJsonPath = path.join(pkgDir, "package.json");

package/src/utils/worker-events.ts

@@ -62,7 +62,10 @@ export interface WorkerEventHandlerOptions {
  * @param rebuildManager 리빌드 매니저
  * @returns completeTask 함수 (결과를 저장하고 빌드 완료를 알림)
  */
-export function registerWorkerEventHandlers<TEvents extends Record<string, any[]>, T extends BaseWorkerInfo<TEvents>>(
+export function registerWorkerEventHandlers<
+  TEvents extends Record<string, any[]>,
+  T extends BaseWorkerInfo<TEvents>,
+>(
   workerInfo: T,
   opts: WorkerEventHandlerOptions,
   results: Map<string, PackageResult>,

package/src/utils/worker-utils.ts

@@ -10,7 +10,10 @@ import type { ConsolaInstance } from "consola";
  * @param cleanup - Async cleanup function to execute on shutdown
  * @param logger - Consola logger instance for error logging
  */
-export function registerCleanupHandlers(cleanup: () => Promise<void>, logger: ConsolaInstance): void {
+export function registerCleanupHandlers(
+  cleanup: () => Promise<void>,
+  logger: ConsolaInstance,
+): void {
   const handleSignal = () => {
     cleanup()
       .catch((err) => {

package/src/workers/client.worker.ts

@@ -115,7 +115,11 @@ async function build(info: ClientBuildInfo): Promise<ClientBuildResult> {
     const tsconfigPath = path.join(info.cwd, "tsconfig.json");
 
     // browser 타겟용 compilerOptions 생성
-    const compilerOptions = await getCompilerOptionsForPackage(parsedConfig.options, "browser", info.pkgDir);
+    const compilerOptions = await getCompilerOptionsForPackage(
+      parsedConfig.options,
+      "browser",
+      info.pkgDir,
+    );
 
     // Vite 설정 생성 및 빌드
     const viteConfig = createViteConfig({
@@ -162,7 +166,11 @@ async function startWatch(info: ClientWatchInfo): Promise<void> {
     const tsconfigPath = path.join(info.cwd, "tsconfig.json");
 
     // browser 타겟용 compilerOptions 생성
-    const compilerOptions = await getCompilerOptionsForPackage(parsedConfig.options, "browser", info.pkgDir);
+    const compilerOptions = await getCompilerOptionsForPackage(
+      parsedConfig.options,
+      "browser",
+      info.pkgDir,
+    );
 
     // server가 0이면 자동 포트 할당 (서버 연결 클라이언트)
     // server가 숫자면 해당 포트로 고정 (standalone 클라이언트)
@@ -192,7 +200,8 @@ async function startWatch(info: ClientWatchInfo): Promise<void> {
 
     // 실제 할당된 포트 반환 (config.server.port는 설정값이므로 httpServer에서 실제 포트를 가져옴)
     const address = viteServer.httpServer?.address();
-    const actualPort = typeof address === "object" && address != null ? address.port : viteServer.config.server.port;
+    const actualPort =
+      typeof address === "object" && address != null ? address.port : viteServer.config.server.port;
 
     sender.send("serverReady", { port: actualPort });
   } catch (err) {

package/src/workers/dts.worker.ts

@@ -78,7 +78,9 @@ export interface DtsWorkerEvents extends Record<string, unknown> {
 const logger = consola.withTag("sd:cli:dts:worker");
 
 /** tsc watch program (정리 대상) */
-let tscWatchProgram: ts.WatchOfFilesAndCompilerOptions<ts.EmitAndSemanticDiagnosticsBuilderProgram> | undefined;
+let tscWatchProgram:
+  | ts.WatchOfFilesAndCompilerOptions<ts.EmitAndSemanticDiagnosticsBuilderProgram>
+  | undefined;
 
 /**
  * 리소스 정리
@@ -141,7 +143,9 @@ function adjustDtsMapSources(content: string, originalDir: string, newDir: strin
  *
  * @returns (fileName, content) => [newPath, newContent] | null (null이면 쓰기 무시)
  */
-function createDtsPathRewriter(pkgDir: string): (fileName: string, content: string) => [string, string] | null {
+function createDtsPathRewriter(
+  pkgDir: string,
+): (fileName: string, content: string) => [string, string] | null {
   const pkgName = path.basename(pkgDir);
   const distDir = path.join(pkgDir, "dist");
   const distPrefix = distDir + path.sep;
@@ -276,8 +280,12 @@ async function buildDts(info: DtsBuildInfo): Promise<DtsBuildResult> {
     const filteredDiagnostics = allDiagnostics.filter(diagnosticFilter);
 
     const serializedDiagnostics = filteredDiagnostics.map(serializeDiagnostic);
-    const errorCount = filteredDiagnostics.filter((d) => d.category === ts.DiagnosticCategory.Error).length;
-    const warningCount = filteredDiagnostics.filter((d) => d.category === ts.DiagnosticCategory.Warning).length;
+    const errorCount = filteredDiagnostics.filter(
+      (d) => d.category === ts.DiagnosticCategory.Error,
+    ).length;
+    const warningCount = filteredDiagnostics.filter(
+      (d) => d.category === ts.DiagnosticCategory.Warning,
+    ).length;
 
     // 에러 메시지 문자열 배열 (하위 호환용)
     const errors = filteredDiagnostics
@@ -330,7 +338,11 @@ async function startDtsWatch(info: DtsWatchInfo): Promise<void> {
   try {
     const parsedConfig = parseRootTsconfig(info.cwd);
     const rootFiles = getPackageSourceFiles(info.pkgDir, parsedConfig);
-    const baseOptions = await getCompilerOptionsForPackage(parsedConfig.options, info.env, info.pkgDir);
+    const baseOptions = await getCompilerOptionsForPackage(
+      parsedConfig.options,
+      info.env,
+      info.pkgDir,
+    );
 
     // 해당 패키지 경로 (필터링용)
     const pkgSrcPrefix = path.join(info.pkgDir, "src") + path.sep;
@@ -362,7 +374,9 @@ async function startDtsWatch(info: DtsWatchInfo): Promise<void> {
 
         // 파일 위치 정보가 있으면 포함 (절대경로:라인:컬럼 형식 - IDE 링크 지원)
         if (diagnostic.file != null && diagnostic.start != null) {
-          const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);
+          const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(
+            diagnostic.start,
+          );
           collectedErrors.push(
             `${diagnostic.file.fileName}:${line + 1}:${character + 1}: TS${diagnostic.code}: ${message}`,
           );
@@ -424,7 +438,10 @@ async function startDtsWatch(info: DtsWatchInfo): Promise<void> {
   }
 }
 
-const sender = createWorker<{ startDtsWatch: typeof startDtsWatch; buildDts: typeof buildDts }, DtsWorkerEvents>({
+const sender = createWorker<
+  { startDtsWatch: typeof startDtsWatch; buildDts: typeof buildDts },
+  DtsWorkerEvents
+>({
   startDtsWatch,
   buildDts,
 });