@simplysm/sd-cli 13.0.64 → 13.0.66

package/src/utils/vite-config.ts

@@ -17,14 +17,14 @@ import { FsWatcher, pathNorm } from "@simplysm/core-node";
  * preset 등으로 참조하는 scope 패키지의 config 변경을 감지하지 못한다.
  * 이 플러그인이 해당 파일들을 watch하고, 변경 시 Tailwind 캐시를 무효화한다.
  */
-function sdTailwindConfigDepsPlugin(pkgDir: string, scopes: string[]): Plugin {
+function sdTailwindConfigDepsPlugin(pkgDir: string, replaceDeps: string[]): Plugin {
   return {
     name: "sd-tailwind-config-deps",
     configureServer(server) {
       const configPath = path.join(pkgDir, "tailwind.config.ts");
       if (!fs.existsSync(configPath)) return;
 
-      const allDeps = getTailwindConfigDeps(configPath, scopes);
+      const allDeps = getTailwindConfigDeps(configPath, replaceDeps);
       const configAbsolute = path.resolve(configPath);
       const externalDeps = allDeps.filter((d) => d !== configAbsolute);
       if (externalDeps.length === 0) return;
@@ -133,66 +133,51 @@ function sdPublicDevPlugin(pkgDir: string): Plugin {
  * 변경 시 Vite의 내부 HMR 파이프라인을 트리거한다.
  * optimizeDeps에서 제외하여 pre-bundled 캐시로 인한 변경 무시를 방지한다.
  */
-function sdScopeWatchPlugin(pkgDir: string, scopes: string[], onScopeRebuild?: () => void): Plugin {
+function sdScopeWatchPlugin(
+  pkgDir: string,
+  replaceDeps: string[],
+  onScopeRebuild?: () => void,
+): Plugin {
   return {
     name: "sd-scope-watch",
     config() {
       const excluded: string[] = [];
       const nestedDepsToInclude: string[] = [];
 
-      for (const scope of scopes) {
-        // scope 패키지를 pre-bundling에서 제외하여 소스 코드로 취급
-        const scopeDir = path.join(pkgDir, "node_modules", scope);
-        if (!fs.existsSync(scopeDir)) continue;
-
-        for (const name of fs.readdirSync(scopeDir)) {
-          excluded.push(`${scope}/${name}`);
-
-          // excluded 패키지의 dependencies를 nested include로 추가하여 pre-bundling 보장
-          // Vite nested dependency 구문: "excluded-pkg > dep"
-          // (pnpm strict 모듈 격리에서 transitive dep을 resolve하기 위해 필요)
-          const depPkgJsonPath = path.join(scopeDir, name, "package.json");
-          try {
-            const depPkgJson = JSON.parse(fs.readFileSync(depPkgJsonPath, "utf-8")) as {
-              dependencies?: Record<string, string>;
-            };
-            const excludedPkg = `${scope}/${name}`;
-            for (const dep of Object.keys(depPkgJson.dependencies ?? {})) {
-              // 같은 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;
-              // PostCSS/빌드 도구는 브라우저 pre-bundling 대상 아님
-              if (dep === "tailwindcss") continue;
-
-              // subpath-only 패키지 필터링: 두 경로를 시도하여 확인
-              // pnpm 구조에서 realpath를 따라 .pnpm node_modules에서 먼저 찾기
-              const realPkgPath = fs.realpathSync(path.join(scopeDir, name));
-              const pnpmNodeModules = path.resolve(realPkgPath, "../..");
-              const depPkgJsonResolved = path.join(pnpmNodeModules, dep, "package.json");
-              if (isSubpathOnlyPackage(depPkgJsonResolved)) {
-                continue;
-              }
-
-              // workspace 패키지는 realpath가 소스 디렉토리로 해석되어 .pnpm 구조가 아님
-              // symlink 경로의 node_modules에서 fallback 시도
-              const depPkgJsonFallback = path.join(
-                scopeDir,
-                name,
-                "node_modules",
-                dep,
-                "package.json",
-              );
-              if (isSubpathOnlyPackage(depPkgJsonFallback)) {
-                continue;
-              }
-
-              nestedDepsToInclude.push(`${excludedPkg} > ${dep}`);
-            }
-          } catch {
-            // package.json 읽기 실패 시 스킵
+      for (const pkg of replaceDeps) {
+        excluded.push(pkg);
+
+        const pkgParts = pkg.split("/");
+        const depPkgJsonPath = path.join(pkgDir, "node_modules", ...pkgParts, "package.json");
+        try {
+          const depPkgJson = JSON.parse(fs.readFileSync(depPkgJsonPath, "utf-8")) as {
+            dependencies?: Record<string, string>;
+          };
+          for (const dep of Object.keys(depPkgJson.dependencies ?? {})) {
+            if (replaceDeps.includes(dep)) continue;
+            if (dep === "solid-js" || dep.startsWith("@solidjs/") || dep.startsWith("solid-"))
+              continue;
+            if (dep === "tailwindcss") continue;
+
+            const realPkgPath = fs.realpathSync(path.join(pkgDir, "node_modules", ...pkgParts));
+            const pnpmNodeModules = path.resolve(realPkgPath, "../..");
+            const depPkgJsonResolved = path.join(pnpmNodeModules, dep, "package.json");
+            if (isSubpathOnlyPackage(depPkgJsonResolved)) continue;
+
+            const depPkgJsonFallback = path.join(
+              pkgDir,
+              "node_modules",
+              ...pkgParts,
+              "node_modules",
+              dep,
+              "package.json",
+            );
+            if (isSubpathOnlyPackage(depPkgJsonFallback)) continue;
+
+            nestedDepsToInclude.push(`${pkg} > ${dep}`);
           }
+        } catch {
+          // package.json 읽기 실패 시 스킵
         }
       }
 
@@ -207,56 +192,43 @@ function sdScopeWatchPlugin(pkgDir: string, scopes: string[], onScopeRebuild?: (
     async configureServer(server) {
       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 pkgRoot = path.join(scopeDir, pkgName);
+      for (const pkg of replaceDeps) {
+        const pkgParts = pkg.split("/");
+        const pkgRoot = path.join(pkgDir, "node_modules", ...pkgParts);
+        if (!fs.existsSync(pkgRoot)) continue;
 
-          // dist 디렉토리 watch (JS/TS 빌드 결과물)
-          const distDir = path.join(pkgRoot, "dist");
-          if (fs.existsSync(distDir)) {
-            watchPaths.push(distDir);
-          }
+        const distDir = path.join(pkgRoot, "dist");
+        if (fs.existsSync(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));
-            }
+        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 (watchPaths.length === 0) return;
 
-      // Vite의 기본 watcher는 **/node_modules/**를 ignore하고
-      // server.watcher.add()로는 이 패턴을 override할 수 없다.
-      // 별도의 FsWatcher로 scope 패키지의 dist 디렉토리를 감시한다.
       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 사용)
           let realPath: string;
           try {
             realPath = fs.realpathSync(changedPath);
           } catch {
-            continue; // 삭제된 파일
+            continue;
           }
-
-          // Vite의 내부 HMR 파이프라인 트리거
           server.watcher.emit("change", realPath);
         }
-
         onScopeRebuild?.();
       });
 
-      // 서버 종료 시 watcher 정리
       server.httpServer?.on("close", () => void scopeWatcher.close());
     },
   };
@@ -274,9 +246,9 @@ export interface ViteConfigOptions {
   mode: "build" | "dev";
   /** dev 모드일 때 서버 포트 (0이면 자동 할당) */
   serverPort?: number;
-  /** watch 대상 scope 목록 (예: ["@myapp", "@simplysm"]) */
-  watchScopes?: string[];
-  /** scope 패키지 dist 변경 감지 시 콜백 */
+  /** replaceDeps 패키지명 배열 (resolve 완료된 상태) */
+  replaceDeps?: string[];
+  /** replaceDeps 패키지 dist 변경 감지 시 콜백 */
   onScopeRebuild?: () => void;
 }
 
@@ -288,7 +260,7 @@ export interface ViteConfigOptions {
  * - dev 모드: dev server (define으로 env 치환, server 설정)
  */
 export function createViteConfig(options: ViteConfigOptions): ViteUserConfig {
-  const { pkgDir, name, tsconfigPath, compilerOptions, env, mode, serverPort, watchScopes } =
+  const { pkgDir, name, tsconfigPath, compilerOptions, env, mode, serverPort, replaceDeps } =
     options;
 
   // Read package.json to extract app name for PWA manifest
@@ -322,11 +294,11 @@ export function createViteConfig(options: ViteConfigOptions): ViteUserConfig {
           globPatterns: ["**/*.{js,css,html,ico,png,svg,woff2}"],
         },
       }),
-      ...(watchScopes != null && watchScopes.length > 0
-        ? [sdTailwindConfigDepsPlugin(pkgDir, watchScopes)]
+      ...(replaceDeps != null && replaceDeps.length > 0
+        ? [sdTailwindConfigDepsPlugin(pkgDir, replaceDeps)]
         : []),
-      ...(watchScopes != null && watchScopes.length > 0
-        ? [sdScopeWatchPlugin(pkgDir, watchScopes, options.onScopeRebuild)]
+      ...(replaceDeps != null && replaceDeps.length > 0
+        ? [sdScopeWatchPlugin(pkgDir, replaceDeps, options.onScopeRebuild)]
         : []),
       ...(mode === "dev" ? [sdPublicDevPlugin(pkgDir)] : []),
     ],

package/src/workers/client.worker.ts

@@ -6,6 +6,7 @@ import { consola } from "consola";
 import type { SdClientPackageConfig } from "../sd-config.types";
 import { parseRootTsconfig, getCompilerOptionsForPackage } from "../utils/tsconfig";
 import { createViteConfig } from "../utils/vite-config";
+import { collectDeps } from "../utils/package-utils";
 import { registerCleanupHandlers } from "../utils/worker-utils";
 
 //#region Types
@@ -36,8 +37,8 @@ export interface ClientWatchInfo {
   config: SdClientPackageConfig;
   cwd: string;
   pkgDir: string;
-  /** watch 대상 scope 목록 */
-  watchScopes?: string[];
+  /** sd.config.ts의 replaceDeps 설정 */
+  replaceDeps?: Record<string, string>;
 }
 
 /**
@@ -176,6 +177,9 @@ async function startWatch(info: ClientWatchInfo): Promise<void> {
     // server가 숫자면 해당 포트로 고정 (standalone 클라이언트)
     const serverPort = typeof info.config.server === "number" ? info.config.server : 0;
 
+    // 의존성 기반 replaceDeps 수집
+    const { replaceDeps } = collectDeps(info.pkgDir, info.cwd, info.replaceDeps);
+
     // Vite 설정 생성
     const viteConfig = createViteConfig({
       pkgDir: info.pkgDir,
@@ -185,7 +189,7 @@ async function startWatch(info: ClientWatchInfo): Promise<void> {
       env: info.config.env,
       mode: "dev",
       serverPort,
-      watchScopes: info.watchScopes,
+      replaceDeps,
       onScopeRebuild: () => sender.send("scopeRebuild", {}),
     });
 

package/src/workers/server.worker.ts

@@ -2,7 +2,7 @@ import path from "path";
 import fs from "fs";
 import cp from "child_process";
 import esbuild from "esbuild";
-import { createWorker, FsWatcher } from "@simplysm/core-node";
+import { createWorker, FsWatcher, pathNorm } from "@simplysm/core-node";
 import { consola } from "consola";
 import {
   parseRootTsconfig,
@@ -13,8 +13,10 @@ import {
   createServerEsbuildOptions,
   collectUninstalledOptionalPeerDeps,
   collectNativeModuleExternals,
+  writeChangedOutputFiles,
 } from "../utils/esbuild-config";
 import { registerCleanupHandlers } from "../utils/worker-utils";
+import { collectDeps } from "../utils/package-utils";
 import { copyPublicFiles, watchPublicFiles } from "../utils/copy-public";
 
 //#region Types
@@ -64,8 +66,8 @@ export interface ServerWatchInfo {
   configs?: Record<string, unknown>;
   /** sd.config.ts에서 수동 지정한 external 모듈 */
   externals?: string[];
-  /** scope 패키지 감시 대상 (e.g. ["@simplysm"]) */
-  watchScopes?: string[];
+  /** sd.config.ts의 replaceDeps 설정 */
+  replaceDeps?: Record<string, string>;
 }
 
 /**
@@ -103,6 +105,9 @@ const logger = consola.withTag("sd:cli:server:worker");
 /** esbuild build context (정리 대상) */
 let esbuildContext: esbuild.BuildContext | undefined;
 
+/** 마지막 빌드의 metafile (rebuild 시 변경 파일 필터링용) */
+let lastMetafile: esbuild.Metafile | undefined;
+
 /** public 파일 watcher (정리 대상) */
 let publicWatcher: FsWatcher | undefined;
 
@@ -117,6 +122,7 @@ async function cleanup(): Promise<void> {
   // (Promise.all 대기 중 다른 호출에서 전역 변수를 수정할 수 있으므로)
   const contextToDispose = esbuildContext;
   esbuildContext = undefined;
+  lastMetafile = undefined;
 
   const watcherToClose = publicWatcher;
   publicWatcher = undefined;
@@ -385,6 +391,8 @@ async function createAndBuildContext(
 
   const context = await esbuild.context({
     ...baseOptions,
+    metafile: true,
+    write: false,
     plugins: [
       {
         name: "watch-notify",
@@ -393,22 +401,38 @@ async function createAndBuildContext(
             sender.send("buildStart", {});
           });
 
-          pluginBuild.onEnd((result) => {
+          pluginBuild.onEnd(async (result) => {
+            // metafile 저장
+            if (result.metafile != null) {
+              lastMetafile = result.metafile;
+            }
+
             const errors = result.errors.map((e) => e.text);
             const warnings = result.warnings.map((w) => w.text);
             const success = result.errors.length === 0;
 
+            // output 파일 쓰기 및 변경 여부 확인
+            let hasOutputChange = false;
+            if (success && result.outputFiles != null) {
+              hasOutputChange = await writeChangedOutputFiles(result.outputFiles);
+            }
+
             if (isBuildFirstTime && success) {
               const confDistPath = path.join(info.pkgDir, "dist", ".config.json");
               fs.writeFileSync(confDistPath, JSON.stringify(info.configs ?? {}, undefined, 2));
             }
 
-            sender.send("build", {
-              success,
-              mainJsPath,
-              errors: errors.length > 0 ? errors : undefined,
-              warnings: warnings.length > 0 ? warnings : undefined,
-            });
+            // 첫 빌드이거나, output이 변경되었거나, 에러인 경우에만 build 이벤트 발생
+            if (isBuildFirstTime || hasOutputChange || !success) {
+              sender.send("build", {
+                success,
+                mainJsPath,
+                errors: errors.length > 0 ? errors : undefined,
+                warnings: warnings.length > 0 ? warnings : undefined,
+              });
+            } else {
+              logger.debug("output 변경 없음, 서버 재시작 skip");
+            }
 
             if (isBuildFirstTime) {
               isBuildFirstTime = false;
@@ -452,25 +476,27 @@ async function startWatch(info: ServerWatchInfo): Promise<void> {
     // Watch public/ and public-dev/ (dev mode includes public-dev)
     publicWatcher = await watchPublicFiles(info.pkgDir, true);
 
-    // FsWatcher 감시 경로 수집
-    const watchPaths: string[] = [];
+    // 의존성 기반 감시 경로 수집
+    const { workspaceDeps, replaceDeps } = collectDeps(info.pkgDir, info.cwd, info.replaceDeps);
 
-    // 1) 서버 자체 소스
-    watchPaths.push(path.join(info.pkgDir, "src", "**", "*.{ts,tsx}"));
+    const watchPaths: string[] = [];
 
-    // 2) scope 패키지 dist 디렉토리
-    if (info.watchScopes != null) {
-      for (const scope of info.watchScopes) {
-        const scopeDir = path.join(info.pkgDir, "node_modules", scope);
-        if (!fs.existsSync(scopeDir)) continue;
+    // 1) 서버 패키지 자신 + workspace 의존 패키지 소스
+    const watchDirs = [
+      info.pkgDir,
+      ...workspaceDeps.map((d) => path.join(info.cwd, "packages", d)),
+    ];
+    for (const dir of watchDirs) {
+      watchPaths.push(path.join(dir, "src", "**", "*"));
+      watchPaths.push(path.join(dir, "*.{ts,js,css}"));
+    }
 
-        for (const pkgName of fs.readdirSync(scopeDir)) {
-          const distDir = path.join(scopeDir, pkgName, "dist");
-          if (fs.existsSync(distDir)) {
-            watchPaths.push(distDir);
-          }
-        }
-      }
+    // 2) replaceDeps 의존 패키지 dist (루트 + 패키지 node_modules)
+    for (const pkg of replaceDeps) {
+      watchPaths.push(path.join(info.cwd, "node_modules", ...pkg.split("/"), "dist", "**", "*.js"));
+      watchPaths.push(
+        path.join(info.pkgDir, "node_modules", ...pkg.split("/"), "dist", "**", "*.js"),
+      );
     }
 
     // FsWatcher 시작
@@ -479,16 +505,11 @@ async function startWatch(info: ServerWatchInfo): Promise<void> {
     // 파일 변경 감지 시 처리
     srcWatcher.onChange({ delay: 300 }, async (changes) => {
       try {
-        // 서버 자체 소스에서 add/unlink가 있으면 context 재생성
-        const srcDir = path.join(info.pkgDir, "src");
-        const hasEntryPointChange = changes.some(
-          (c) =>
-            (c.event === "add" || c.event === "unlink") &&
-            c.path.startsWith(srcDir.replace(/\\/g, "/")),
-        );
+        // 파일 추가/삭제가 있으면 context 재생성 (import graph 변경 가능)
+        const hasFileAddOrRemove = changes.some((c) => c.event === "add" || c.event === "unlink");
 
-        if (hasEntryPointChange) {
-          logger.debug("서버 소스 파일 추가/삭제 감지, context 재생성");
+        if (hasFileAddOrRemove) {
+          logger.debug("파일 추가/삭제 감지, context 재생성");
 
           const oldContext = esbuildContext;
           esbuildContext = await createAndBuildContext(info, false);
@@ -496,10 +517,29 @@ async function startWatch(info: ServerWatchInfo): Promise<void> {
           if (oldContext != null) {
             await oldContext.dispose();
           }
+          return;
+        }
+
+        // 파일 변경만 있는 경우: metafile 필터링
+        if (esbuildContext == null) return;
+
+        // metafile이 없으면 (첫 빌드 전) 무조건 rebuild
+        if (lastMetafile == null) {
+          await esbuildContext.rebuild();
+          return;
+        }
+
+        // metafile.inputs 키를 절대경로(NormPath)로 변환하여 비교
+        const metafileAbsPaths = new Set(
+          Object.keys(lastMetafile.inputs).map((key) => pathNorm(info.cwd, key)),
+        );
+
+        const hasRelevantChange = changes.some((c) => metafileAbsPaths.has(c.path));
+
+        if (hasRelevantChange) {
+          await esbuildContext.rebuild();
         } else {
-          if (esbuildContext != null) {
-            await esbuildContext.rebuild();
-          }
+          logger.debug("변경된 파일이 빌드에 포함되지 않음, rebuild skip");
         }
       } catch (err) {
         sender.send("error", {

package/templates/add-client/__CLIENT__/package.json.hbs

@@ -4,7 +4,7 @@
   "type": "module",
   "private": true,
   "dependencies": {
-    "@simplysm/solid": "~13.0.64",
+    "@simplysm/solid": "~13.0.66",
 {{#if router}}
     "@solidjs/router": "^0.15.4",
 {{/if}}

package/templates/add-server/__SERVER__/package.json.hbs

@@ -4,7 +4,7 @@
   "type": "module",
   "private": true,
   "dependencies": {
-    "@simplysm/core-common": "~13.0.64",
-    "@simplysm/service-server": "~13.0.64"
+    "@simplysm/core-common": "~13.0.66",
+    "@simplysm/service-server": "~13.0.66"
   }
 }

package/templates/init/package.json.hbs

@@ -15,9 +15,9 @@
     "vitest": "vitest"
   },
   "devDependencies": {
-    "@simplysm/sd-cli": "~13.0.64",
-    "@simplysm/sd-claude": "~13.0.64",
-    "@simplysm/lint": "~13.0.64",
+    "@simplysm/sd-cli": "~13.0.66",
+    "@simplysm/sd-claude": "~13.0.66",
+    "@simplysm/lint": "~13.0.66",
     "@types/node": "^20.19.33",
     "eslint": "^9.39.2",
     "prettier": "^3.8.1",