@simplysm/sd-cli 14.0.15 → 14.0.17

package/dist/workers/server-runtime.worker.js

@@ -1,12 +1,12 @@
 import { createWorker } from "@simplysm/core-node";
-import { err as errNs } from "@simplysm/core-common";
+import { env, err as errNs } from "@simplysm/core-common";
 import { consola } from "consola";
 import proxy from "@fastify/http-proxy";
 import net from "net";
 import { pathToFileURL } from "url";
-import { registerCleanupHandlers, applyDebugLevel } from "../utils/worker-utils.js";
+import { registerCleanupHandlers, setupWorkerConsola } from "../utils/worker-utils.js";
 //#endregion
-applyDebugLevel();
+setupWorkerConsola();
 const logger = consola.withTag("sd:cli:server-runtime:worker");
 /** 서버 인스턴스 (정리 대상) */
 let serverInstance;
@@ -74,7 +74,7 @@ async function start(info) {
         // main.js import 전에 환경변수를 process.env에 주입
         if (info.env != null) {
             for (const [key, value] of Object.entries(info.env)) {
-                process.env[key] = value;
+                env(key, value);
             }
         }
         // main.js import (서버 인스턴스를 export해야 함)

package/dist/workers/server-runtime.worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-runtime.worker.js","sourceRoot":"","sources":["../../src/workers/server-runtime.worker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server-runtime.worker.js","sourceRoot":"","sources":["../../src/workers/server-runtime.worker.ts"],"names":[],"mappings":"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"}

package/docs/config.md

@@ -1,5 +1,31 @@
 # Config
 
+## `NpmConfig`
+
+npm `package.json` structure.
+
+```typescript
+interface NpmConfig {
+  name: string;
+  version: string;
+  description?: string;
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+  peerDependencies?: Record<string, string>;
+  volta?: unknown;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `name` | `string` | Package name |
+| `version` | `string` | Package version |
+| `description` | `string` | Package description |
+| `dependencies` | `Record<string, string>` | Production dependencies |
+| `devDependencies` | `Record<string, string>` | Development dependencies |
+| `peerDependencies` | `Record<string, string>` | Peer dependencies |
+| `volta` | `unknown` | Volta configuration |
+
 ## `BuildTarget`
 
 Build target type (built with esbuild).
@@ -41,6 +67,7 @@ Configuration for client (Angular/Vite) packages.
 ```typescript
 interface SdClientPackageConfig {
   target: "client";
+  framework?: "angular" | "solid";
   server: string | number;
   env?: Record<string, string>;
   publish?: SdPublishConfig;
@@ -56,6 +83,7 @@ interface SdClientPackageConfig {
 | Field | Type | Description |
 |-------|------|-------------|
 | `target` | `"client"` | Fixed value |
+| `framework` | `"angular" \| "solid"` | Client framework selection. Defaults to `"angular"` when not specified |
 | `server` | `string \| number` | Server package name to connect to (e.g., `"solid-demo-server"`), or Vite port number (backward compatibility) |
 | `env` | `Record<string, string>` | Environment variables to substitute during build (replaces `process.env` with object) |
 | `publish` | `SdPublishConfig` | Publish configuration |
@@ -173,7 +201,7 @@ Parameters passed to the `sd.config.ts` function.
 interface SdConfigParams {
   cwd: string;
   dev: boolean;
-  options: string[];
+  opt: string[];
 }
 ```
 
@@ -181,7 +209,7 @@ interface SdConfigParams {
 |-------|------|-------------|
 | `cwd` | `string` | Current working directory |
 | `dev` | `boolean` | Development mode flag |
-| `options` | `string[]` | Additional options (from CLI's `-o` flag) |
+| `opt` | `string[]` | Additional options (from CLI's `-o` flag) |
 
 ## `SdConfigFn`
 

package/docs/pwa-configuration-types.md

@@ -18,7 +18,7 @@ interface SdPwaConfig {
 
 ## `SdPwaManifestConfig`
 
-PWA manifest configuration (subset of VitePWA manifest options).
+PWA manifest configuration.
 
 ```typescript
 interface SdPwaManifestConfig {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/sd-cli",
-  "version": "14.0.15",
+  "version": "14.0.17",
   "description": "Simplysm package - CLI tool",
   "author": "simplysm",
   "license": "Apache-2.0",
@@ -26,25 +26,23 @@
     "@inquirer/prompts": "^8.3.2",
     "browserslist-to-esbuild": "^2.1.1",
     "consola": "^3.4.2",
-    "esbuild": "^0.27.5",
+    "esbuild": "^0.27.7",
     "eslint": "^9.39.4",
     "glob": "^13.0.6",
     "jiti": "^2.6.1",
     "mime": "^4.1.0",
     "postcss": "^8.5.8",
-    "sass": "^1.98.0",
+    "sass": "^1.99.0",
     "semver": "^7.7.4",
     "sharp": "^0.34.5",
     "ssh2": "^1.17.0",
     "typescript": "^5.9.3",
-    "vite": "^7.3.1",
-    "vite-plugin-pwa": "^1.2.0",
-    "vite-tsconfig-paths": "^6.1.1",
-    "yargs": "^18.0.0",
+    "vite": "^8.0.3",
     "vite-plugin-solid": "^2.11.11",
-    "@simplysm/core-node": "14.0.15",
-    "@simplysm/storage": "14.0.15",
-    "@simplysm/core-common": "14.0.15"
+    "yargs": "^18.0.0",
+    "@simplysm/core-node": "14.0.17",
+    "@simplysm/core-common": "14.0.17",
+    "@simplysm/storage": "14.0.17"
   },
   "devDependencies": {
     "@types/semver": "^7.7.1",

package/src/angular/client-transform-stylesheet.ts

@@ -1,3 +1,6 @@
+import { createHash } from "crypto";
+import fsp from "fs/promises";
+import path from "path";
 import postcss from "postcss";
 import { compileScssFileAsync, compileScssStringAsync } from "../utils/scss-compiler.js";
 
@@ -6,6 +9,41 @@ export interface ClientTransformStylesheetOptions {
   postCssPlugins?: unknown[];
   scssErrors: string[];
   scssDependencies: Map<string, Set<string>>;
+  /** SCSS 캐시 디렉토리 (미지정 시 캐시 비활성화) */
+  cacheDir?: string;
+}
+
+interface ScssCacheEntry {
+  fileHash: string;
+  deps: Array<{ path: string; hash: string }>;
+  css: string;
+}
+
+function computeHash(content: string): string {
+  return createHash("sha256").update(content).digest("hex");
+}
+
+function cachePathFor(cacheDir: string, scssFilePath: string): string {
+  const pathHash = computeHash(scssFilePath).slice(0, 16);
+  return path.join(cacheDir, `${pathHash}.json`);
+}
+
+async function loadCacheEntry(cachePath: string): Promise<ScssCacheEntry | undefined> {
+  try {
+    const raw = await fsp.readFile(cachePath, "utf-8");
+    return JSON.parse(raw) as ScssCacheEntry;
+  } catch {
+    return undefined;
+  }
+}
+
+async function readFileHash(filePath: string): Promise<string | undefined> {
+  try {
+    const content = await fsp.readFile(filePath, "utf-8");
+    return computeHash(content);
+  } catch {
+    return undefined;
+  }
 }
 
 /**
@@ -19,7 +57,7 @@ export interface ClientTransformStylesheetOptions {
 export function createClientTransformStylesheet(
   options: ClientTransformStylesheetOptions,
 ): (data: string, containingFile: string, stylesheetFile?: string) => Promise<string | null> {
-  const { loadPaths, postCssPlugins, scssErrors, scssDependencies } = options;
+  const { loadPaths, postCssPlugins, scssErrors, scssDependencies, cacheDir } = options;
 
   const postCssProcessor =
     postCssPlugins != null && postCssPlugins.length > 0
@@ -35,9 +73,73 @@ export function createClientTransformStylesheet(
     if (stylesheetFile != null) {
       if (stylesheetFile.endsWith(".scss")) {
         try {
+          if (cacheDir != null) {
+            const content = await fsp.readFile(stylesheetFile, "utf-8");
+            const fileHash = computeHash(content);
+            const cachePath = cachePathFor(cacheDir, stylesheetFile);
+            const cached = await loadCacheEntry(cachePath);
+
+            if (cached != null && cached.fileHash === fileHash) {
+              let allDepsMatch = true;
+              for (const dep of cached.deps) {
+                const currentHash = await readFileHash(dep.path);
+                if (currentHash !== dep.hash) {
+                  allDepsMatch = false;
+                  break;
+                }
+              }
+
+              if (allDepsMatch) {
+                if (cached.deps.length > 0) {
+                  scssDependencies.set(stylesheetFile, new Set(cached.deps.map((d) => d.path)));
+                }
+                let css = cached.css;
+                if (postCssProcessor != null) {
+                  css = (await postCssProcessor.process(css, { from: stylesheetFile })).css;
+                }
+                return css;
+              }
+            }
+
+            // 캐시 미스: compileScssStringAsync로 이중 읽기 회피 (D5)
+            const result = await compileScssStringAsync(content, stylesheetFile, loadPaths);
+
+            if (result.dependencies.length > 0) {
+              scssDependencies.set(stylesheetFile, new Set(result.dependencies));
+            }
+
+            const depHashes: Array<{ path: string; hash: string }> = [];
+            let allDepsHashed = true;
+            for (const depPath of result.dependencies) {
+              const depHash = await readFileHash(depPath);
+              if (depHash != null) {
+                depHashes.push({ path: depPath, hash: depHash });
+              } else {
+                allDepsHashed = false;
+                break;
+              }
+            }
+
+            if (allDepsHashed) {
+              const entry: ScssCacheEntry = { fileHash, deps: depHashes, css: result.css };
+              try {
+                await fsp.mkdir(cacheDir, { recursive: true });
+                await fsp.writeFile(cachePath, JSON.stringify(entry));
+              } catch {
+                // cache write failure — non-fatal
+              }
+            }
+
+            let css = result.css;
+            if (postCssProcessor != null) {
+              css = (await postCssProcessor.process(css, { from: stylesheetFile })).css;
+            }
+            return css;
+          }
+
+          // cacheDir 없음: 기존 동작
           const result = await compileScssFileAsync(stylesheetFile, loadPaths);
 
-          // 의존성 수집
           if (result.dependencies.length > 0) {
             scssDependencies.set(stylesheetFile, new Set(result.dependencies));
           }

package/src/angular/vite-angular-plugin.ts

@@ -1,6 +1,8 @@
-import type { Plugin, ModuleNode, ViteDevServer } from "vite";
+import type { Plugin, EnvironmentModuleNode, HotUpdateOptions, ViteDevServer } from "vite";
 import type { IncomingMessage, ServerResponse } from "http";
 import { JavaScriptTransformer } from "@angular/build/private";
+import { createHash } from "crypto";
+import fsp from "fs/promises";
 import os from "os";
 import path from "path";
 import ts from "typescript";
@@ -45,6 +47,25 @@ export interface SdAngularPluginOptions {
   browserslist?: string[];
   /** PostCSS 플러그인 배열 */
   postCssPlugins?: unknown[];
+  /** Linker 캐시 디렉토리 (기본값: {cwd}/.cache/linker/{sm|nosm}) */
+  linkerCacheDir?: string;
+}
+
+/**
+ * SCSS 의존성 역방향 탐색.
+ * 변경된 SCSS 파일을 @use하는 owner 파일(TS 또는 SCSS)을 찾는다.
+ */
+export function findAffectedByScss(
+  normalizedScssPath: string,
+  scssDependencies: Map<string, Set<string>>,
+): string[] {
+  const affected: string[] = [];
+  for (const [ownerFile, deps] of scssDependencies) {
+    if (deps.has(normalizedScssPath)) {
+      affected.push(ownerFile);
+    }
+  }
+  return affected;
 }
 
 /**
@@ -114,6 +135,10 @@ export function sdAngularPlugin(options: SdAngularPluginOptions): Plugin {
     enforce: "pre",
 
     config() {
+      const linkerCacheDir =
+        options.linkerCacheDir ??
+        path.join(process.cwd(), ".cache", "linker", enableSourcemap ? "sm" : "nosm");
+
       return {
         define: {
           ngDevMode: options.dev ? undefined : "false",
@@ -121,18 +146,37 @@ export function sdAngularPlugin(options: SdAngularPluginOptions): Plugin {
           ngHmrMode: options.dev && !options.legacyModule ? undefined : "false",
         },
         optimizeDeps: {
-          esbuildOptions: {
+          rolldownOptions: {
             plugins: [
               {
                 name: "angular-vite-optimize-deps",
-                setup(build: { onLoad: Function }) {
-                  build.onLoad(
-                    { filter: /\.[cm]?js$/ },
-                    async (args: { path: string }) => ({
-                      contents: await prebundleTransformer.transformFile(args.path),
-                      loader: "js" as const,
-                    }),
-                  );
+                async load(id: string) {
+                  if (!/\.[cm]?js$/.test(id)) return null;
+
+                  const content = await fsp.readFile(id, "utf-8");
+                  const hash = createHash("sha256").update(content).digest("hex");
+                  const cachePath = path.join(linkerCacheDir, `${hash}.js`);
+
+                  try {
+                    return await fsp.readFile(cachePath, "utf-8");
+                  } catch {
+                    // cache miss
+                  }
+
+                  const result = await prebundleTransformer.transformFile(id);
+                  const resultStr =
+                    typeof result === "string"
+                      ? result
+                      : new TextDecoder().decode(result);
+
+                  try {
+                    await fsp.mkdir(linkerCacheDir, { recursive: true });
+                    await fsp.writeFile(cachePath, resultStr);
+                  } catch {
+                    // cache write failure — non-fatal
+                  }
+
+                  return resultStr;
                 },
               },
             ],
@@ -165,6 +209,7 @@ export function sdAngularPlugin(options: SdAngularPluginOptions): Plugin {
         postCssPlugins: options.postCssPlugins,
         scssErrors,
         scssDependencies,
+        cacheDir: path.join(workspaceRoot, ".cache", "scss"),
       });
 
       // externalStylesheets (client mode에서 stylesheet SHA256 ID 매핑)
@@ -236,16 +281,10 @@ export function sdAngularPlugin(options: SdAngularPluginOptions): Plugin {
       });
     },
 
-    async handleHotUpdate({
+    async hotUpdate({
       file,
       modules,
-    }: {
-      file: string;
-      modules: ModuleNode[];
-      server: ViteDevServer;
-      timestamp: number;
-      read: () => string | Promise<string>;
-    }): Promise<ModuleNode[] | void> {
+    }: HotUpdateOptions): Promise<EnvironmentModuleNode[] | void> {
       if (compiler == null || !options.dev) return;
       if (
         !file.endsWith(".ts") &&
@@ -255,15 +294,25 @@ export function sdAngularPlugin(options: SdAngularPluginOptions): Plugin {
         return;
       }
 
-      // 의존성 필터: TypeScript program에 포함되지 않은 파일은 건너뜀
       const normalizedFile = pathx.posix(file);
-      const programFiles = compiler.getTsProgram().getSourceFiles();
-      const isInProgram = programFiles.some(
-        (sf) => pathx.posix(sf.fileName) === normalizedFile,
-      );
-      if (!isInProgram) {
-        logger.debug(`변경된 파일이 빌드에 포함되지 않아 리빌드 건너뜀: ${normalizedFile}`);
-        return;
+      let filesToUpdate: string[];
+
+      if (file.endsWith(".scss")) {
+        // SCSS @use 의존성 역방향 탐색: 변경된 SCSS를 @use하는 파일을 찾아 재컴파일
+        const affectedOwnerFiles = findAffectedByScss(normalizedFile, scssDependencies);
+        if (affectedOwnerFiles.length === 0) return;
+        filesToUpdate = affectedOwnerFiles;
+      } else {
+        // 의존성 필터: TypeScript program에 포함되지 않은 파일은 건너뜀
+        const programFiles = compiler.getTsProgram().getSourceFiles();
+        const isInProgram = programFiles.some(
+          (sf) => pathx.posix(sf.fileName) === normalizedFile,
+        );
+        if (!isInProgram) {
+          logger.debug(`변경된 파일이 빌드에 포함되지 않아 리빌드 건너뜀: ${normalizedFile}`);
+          return;
+        }
+        filesToUpdate = [file];
       }
 
       // 경쟁 조건 방지: 이전 HMR 처리 완료 대기
@@ -280,7 +329,7 @@ export function sdAngularPlugin(options: SdAngularPluginOptions): Plugin {
         // rebuild 시작 시 이전 templateUpdates 정리
         templateUpdates.clear();
 
-        const updateResult = await compiler.update([file]);
+        const updateResult = await compiler.update(filesToUpdate);
 
         // templateUpdates 수집
         if (updateResult.templateUpdates != null) {
@@ -321,10 +370,22 @@ export function sdAngularPlugin(options: SdAngularPluginOptions): Plugin {
           lint: lintResult,
         });
 
-        const affectedSet = new Set(affectedPaths);
-        return modules.filter(
-          (m) => m.file != null && affectedSet.has(pathx.posix(m.file)),
-        );
+        if (file.endsWith(".scss")) {
+          // SCSS: moduleGraph에서 영향받은 TS 모듈 조회
+          const moduleGraph = this.environment.moduleGraph;
+          const result: EnvironmentModuleNode[] = [];
+          for (const p of affectedPaths) {
+            const mods = moduleGraph.getModulesByFile(p);
+            if (mods) result.push(...mods);
+          }
+          return result;
+        } else {
+          // TS/HTML: 전달받은 modules에서 영향받은 모듈 필터
+          const affectedSet = new Set(affectedPaths);
+          return modules.filter(
+            (m) => m.file != null && affectedSet.has(pathx.posix(m.file)),
+          );
+        }
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
         logger.error(`HMR recompile failed: ${message}`);

package/src/capacitor/capacitor.ts

@@ -6,19 +6,7 @@ import { createRequire } from "module";
 import { cpx, fsx, pathx } from "@simplysm/core-node";
 import { env } from "@simplysm/core-common";
 import { consola, LogLevels } from "consola";
-import type { SdCapacitorConfig } from "../sd-config.types.js";
-
-/**
- * package.json 타입
- */
-interface NpmConfig {
-  name: string;
-  version: string;
-  dependencies?: Record<string, string>;
-  devDependencies?: Record<string, string>;
-  peerDependencies?: Record<string, string>;
-  volta?: unknown;
-}
+import type { NpmConfig, SdCapacitorConfig } from "../sd-config.types.js";
 
 /**
  * 설정 검증 에러
@@ -275,10 +263,6 @@ export class Capacitor {
     if (!(await fsx.exists(workspaceYamlPath))) {
       await fsx.write(workspaceYamlPath, "");
     }
-    const lockfilePath = pathx.posixResolve(this._capPath, "pnpm-lock.yaml");
-    if (!(await fsx.exists(lockfilePath))) {
-      await fsx.write(lockfilePath, "");
-    }
 
     // pnpm install + 빌드 스크립트 승인
     Capacitor._logger.debug("pnpm install 시작");
@@ -340,15 +324,15 @@ export class Capacitor {
 
     // 기본 의존성
     capNpmConf.dependencies = capNpmConf.dependencies ?? {};
-    capNpmConf.dependencies["@capacitor/core"] = "^7.0.0";
-    capNpmConf.dependencies["@capacitor/app"] = "^7.0.0";
+    capNpmConf.dependencies["@capacitor/core"] = "^7";
+    capNpmConf.dependencies["@capacitor/app"] = "^7";
     for (const platform of this._platforms) {
-      capNpmConf.dependencies[`@capacitor/${platform}`] = "^7.0.0";
+      capNpmConf.dependencies[`@capacitor/${platform}`] = "^7";
     }
 
     capNpmConf.devDependencies = capNpmConf.devDependencies ?? {};
-    capNpmConf.devDependencies["@capacitor/cli"] = "^7.0.0";
-    capNpmConf.devDependencies["@capacitor/assets"] = "^3.0.0";
+    capNpmConf.devDependencies["@capacitor/cli"] = "^7";
+    capNpmConf.devDependencies["@capacitor/assets"] = "^3";
 
     // 플러그인 패키지 설정
     const mainDeps = {
@@ -640,15 +624,15 @@ export default config;
    */
   private async _findAndroidSdk(): Promise<string | undefined> {
     const androidHome =
-      (env["ANDROID_HOME"] as string | undefined) ??
-      (env["ANDROID_SDK_ROOT"] as string | undefined);
+      env("ANDROID_HOME") ??
+      env("ANDROID_SDK_ROOT");
     if (androidHome != null && (await fsx.exists(androidHome))) {
       return androidHome;
     }
 
     const candidates = [
-      pathx.posixResolve((env["LOCALAPPDATA"] as string | undefined) ?? "", "Android/Sdk"),
-      pathx.posixResolve((env["HOME"] as string | undefined) ?? "", "Android/Sdk"),
+      pathx.posixResolve(env("LOCALAPPDATA") ?? "", "Android/Sdk"),
+      pathx.posixResolve(env("HOME") ?? "", "Android/Sdk"),
       "C:/Program Files/Android/Sdk",
       "C:/Android/Sdk",
     ];
@@ -860,6 +844,21 @@ export default config;
     await this._updateServerUrl(url);
 
     for (const platform of this._platforms) {
+      // Android + localhost URL이면 adb reverse로 포트 포워딩
+      if (platform === "android") {
+        const urlObj = new URL(url);
+        if (urlObj.hostname === "localhost" || urlObj.hostname === "127.0.0.1") {
+          const port = urlObj.port || (urlObj.protocol === "https:" ? "443" : "80");
+          Capacitor._logger.debug(`[${platform}] adb reverse tcp:${port} 설정`);
+          try {
+            await this._exec("adb", ["reverse", `tcp:${port}`, `tcp:${port}`], this._capPath);
+          } catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            Capacitor._logger.warn(`adb reverse 실패 — USB 연결을 확인하세요: ${errMsg}`);
+          }
+        }
+      }
+
       Capacitor._logger.debug(`[${platform}] cap copy 시작`);
       await this._execCap(["copy", platform]);
       Capacitor._logger.debug(`[${platform}] cap copy 완료`);

package/src/commands/check.ts

@@ -34,25 +34,22 @@ async function spawnVitest(targets: string[]): Promise<CheckResult> {
     const args = ["vitest", ...targets, "--run"];
     logger.debug("vitest 실행", { args });
     logger.start("테스트 실행 중...");
-    const result = await cpx.spawn("pnpm", args, { cwd: process.cwd(), reject: false });
-    const output = result.stdout + result.stderr;
+    const result = await cpx.spawn("pnpm", args, {
+      cwd: process.cwd(),
+      reject: false,
+      stdio: "inherit",
+    });
     const code = result.exitCode;
 
-    const failMatch =
-      output.match(/(\d+)\s+tests?\s+failed/i) ??
-      output.match(/Tests\s+(\d+)\s+failed/i) ??
-      output.match(/(\d+)\s+fail/i);
-    const failCount = failMatch ? Number(failMatch[1]) : 0;
-
     logger.success("테스트 실행 완료");
-    logger.info("테스트 완료", { errorCount: failCount, warningCount: 0 });
+    logger.info("테스트 완료", { errorCount: code === 0 ? 0 : 1, warningCount: 0 });
 
     return {
       name: "TEST",
       success: code === 0,
-      errorCount: failCount,
+      errorCount: code === 0 ? 0 : 1,
       warningCount: 0,
-      formattedOutput: code === 0 ? "" : output,
+      formattedOutput: "",
     };
   } catch (err) {
     logger.fail("테스트 실행 실패");