@simplysm/sd-cli 14.0.11 → 14.0.12

package/src/workers/server-runtime.worker.ts

@@ -9,31 +9,31 @@ import { registerCleanupHandlers, applyDebugLevel } from "../utils/worker-utils"
 //#region Types
 
 /**
- * Server runtime start info
+ * 서버 런타임 시작 정보
  */
 export interface ServerRuntimeStartInfo {
   mainJsPath: string;
-  /** Client Vite dev server ports for @fastify/http-proxy registration */
+  /** @fastify/http-proxy 등록을 위한 Client Vite dev server 포트 */
   clientPorts?: Record<string, number>;
   env?: Record<string, string>;
 }
 
 /**
- * Server ready event
+ * 서버 준비 완료 이벤트
  */
 export interface ServerRuntimeReadyEvent {
   port: number;
 }
 
 /**
- * Error event
+ * 에러 이벤트
  */
 export interface ServerRuntimeErrorEvent {
   message: string;
 }
 
 /**
- * Worker event types
+ * 워커 이벤트 타입
  */
 export interface ServerRuntimeWorkerEvents extends Record<string, unknown> {
   serverReady: ServerRuntimeReadyEvent;
@@ -46,11 +46,11 @@ applyDebugLevel();
 
 const logger = consola.withTag("sd:cli:server-runtime:worker");
 
-/** Server instance (to be cleaned up) */
+/** 서버 인스턴스 (정리 대상) */
 let serverInstance: { close: () => Promise<void> } | undefined;
 
 /**
- * Clean up resources
+ * 리소스 정리
  */
 async function cleanup(): Promise<void> {
   const server = serverInstance;
@@ -60,15 +60,15 @@ async function cleanup(): Promise<void> {
   }
 }
 
-// Catch runtime errors that occur after server listen() and send them as a custom "error" event
-// (Without this handler, the worker will crash but dev.ts's buildResolver won't be called, causing listr to hang)
+// 서버 listen() 이후 발생하는 런타임 에러를 잡아 커스텀 "error" 이벤트로 전송
+// (이 핸들러 없이는 워커가 크래시해도 빌드 Promise가 resolve되지 않아 프로세스가 중단될 수 있다)
 process.on("uncaughtException", (err) => {
   logger.error("서버 런타임 미처리 에러", err);
   sender.send("error", {
     message: errNs.message(err),
   });
-  // Allow event to be sent before exit
-  setTimeout(() => process.exit(1), 100);
+  // 이벤트 전송 후 종료할 수 있도록 대기
+  setTimeout(() => process.exit(1), 500);
 });
 
 process.on("unhandledRejection", (reason) => {
@@ -76,14 +76,14 @@ process.on("unhandledRejection", (reason) => {
   sender.send("error", {
     message: errNs.message(reason),
   });
-  // Allow event to be sent before exit
-  setTimeout(() => process.exit(1), 100);
+  // 이벤트 전송 후 종료할 수 있도록 대기
+  setTimeout(() => process.exit(1), 500);
 });
 
 registerCleanupHandlers(cleanup, logger);
 
 /**
- * Check if a port is available for use
+ * 포트가 사용 가능한지 확인한다
  */
 function isPortAvailable(port: number): Promise<boolean> {
   return new Promise((resolve) => {
@@ -97,7 +97,7 @@ function isPortAvailable(port: number): Promise<boolean> {
 }
 
 /**
- * Find and return an available port starting from the specified port
+ * 지정된 포트부터 사용 가능한 포트를 찾아 반환한다
  */
 async function findAvailablePort(startPort: number, maxRetries = 20): Promise<number> {
   for (let i = 0; i < maxRetries; i++) {
@@ -112,21 +112,21 @@ async function findAvailablePort(startPort: number, maxRetries = 20): Promise<nu
 }
 
 /**
- * Start Server Runtime
- * Import main.js, then listen
+ * 서버 런타임 시작
+ * main.js를 import한 후 listen 수행
  */
 async function start(info: ServerRuntimeStartInfo): Promise<void> {
   try {
     const startTime = performance.now();
 
-    // Inject environment variables into process.env before importing main.js
+    // main.js import 전에 환경변수를 process.env에 주입
     if (info.env != null) {
       for (const [key, value] of Object.entries(info.env)) {
         process.env[key] = value;
       }
     }
 
-    // Import main.js (must export a server instance)
+    // main.js import (서버 인스턴스를 export해야 함)
     logger.debug("main.js 임포트 중...");
     let stepStart = performance.now();
     const module = await import(pathToFileURL(info.mainJsPath).href);
@@ -137,10 +137,10 @@ async function start(info: ServerRuntimeStartInfo): Promise<void> {
       throw new Error("main.js must export a server instance.");
     }
 
-    // Save server instance (for cleanup)
+    // 서버 인스턴스 저장 (정리용)
     serverInstance = server;
 
-    // Register client proxies (before listen)
+    // 클라이언트 프록시 등록 (listen 전)
     if (info.clientPorts != null && Object.keys(info.clientPorts).length > 0) {
       for (const [name, port] of Object.entries(info.clientPorts)) {
         logger.debug(`프록시 등록: /${name} → http://127.0.0.1:${String(port)}`);
@@ -153,7 +153,7 @@ async function start(info: ServerRuntimeStartInfo): Promise<void> {
       }
     }
 
-    // Find available port (auto-increment on port conflict)
+    // 사용 가능한 포트 탐색 (포트 충돌 시 자동 증가)
     logger.debug("사용 가능한 포트 탐색 중...");
     stepStart = performance.now();
     const originalPort = server.options.port;

package/tests/angular/vite-angular-plugin-hmr-fallback.spec.ts

@@ -195,6 +195,7 @@ describe("sdAngularPlugin HMR fallback", () => {
     const middlewares: Array<(req: IncomingMessage, res: ServerResponse, next: () => void) => void> =
       [];
     const mockServer = {
+      config: { base: "/" },
       middlewares: {
         use: (fn: (req: IncomingMessage, res: ServerResponse, next: () => void) => void) => {
           middlewares.push(fn);

package/tests/angular/vite-angular-plugin-hmr.spec.ts

@@ -17,6 +17,7 @@ describe("sdAngularPlugin HMR + component-middleware", () => {
     const middlewares: Array<(req: IncomingMessage, res: ServerResponse, next: () => void) => void> =
       [];
     const mockServer = {
+      config: { base: "/" },
       middlewares: {
         use: (fn: (req: IncomingMessage, res: ServerResponse, next: () => void) => void) => {
           middlewares.push(fn);
@@ -72,6 +73,7 @@ describe("sdAngularPlugin HMR + component-middleware", () => {
     const middlewares: Array<(req: IncomingMessage, res: ServerResponse, next: () => void) => void> =
       [];
     const mockServer = {
+      config: { base: "/" },
       middlewares: {
         use: (fn: (req: IncomingMessage, res: ServerResponse, next: () => void) => void) => {
           middlewares.push(fn);
@@ -101,6 +103,7 @@ describe("sdAngularPlugin HMR + component-middleware", () => {
     const middlewares: Array<(req: IncomingMessage, res: ServerResponse, next: () => void) => void> =
       [];
     const mockServer = {
+      config: { base: "/" },
       middlewares: {
         use: (fn: (req: IncomingMessage, res: ServerResponse, next: () => void) => void) => {
           middlewares.push(fn);
@@ -138,6 +141,7 @@ describe("sdAngularPlugin HMR + component-middleware", () => {
     const middlewares: Array<(req: IncomingMessage, res: ServerResponse, next: () => void) => void> =
       [];
     const mockServer = {
+      config: { base: "/" },
       middlewares: {
         use: (fn: (req: IncomingMessage, res: ServerResponse, next: () => void) => void) => {
           middlewares.push(fn);
@@ -177,6 +181,7 @@ describe("sdAngularPlugin HMR + component-middleware", () => {
     const middlewares: Array<(req: IncomingMessage, res: ServerResponse, next: () => void) => void> =
       [];
     const mockServer = {
+      config: { base: "/" },
       middlewares: {
         use: (fn: (req: IncomingMessage, res: ServerResponse, next: () => void) => void) => {
           middlewares.push(fn);
@@ -223,4 +228,77 @@ describe("sdAngularPlugin HMR + component-middleware", () => {
 
     await (plugin as any).buildEnd?.call({});
   });
+
+  // Acceptance: base path가 포함된 /@ng/component 요청도 정상 응답한다
+  it("serves /@ng/component requests with base path prefix", async () => {
+    const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
+    await (plugin as any).buildStart?.call({});
+
+    const middlewares: Array<(req: IncomingMessage, res: ServerResponse, next: () => void) => void> =
+      [];
+    const mockServer = {
+      config: { base: "/client-pda/" },
+      middlewares: {
+        use: (fn: (req: IncomingMessage, res: ServerResponse, next: () => void) => void) => {
+          middlewares.push(fn);
+        },
+      },
+      httpServer: { on: vi.fn() },
+    };
+    (plugin as any).configureServer?.(mockServer);
+
+    const middleware = middlewares[0];
+    // 실제 브라우저에서는 /client-pda/src/services/@ng/component 형태로 요청됨
+    const mockReq = {
+      url: "/client-pda/src/services/@ng/component?c=testId",
+    } as IncomingMessage;
+
+    let statusCode: number | undefined;
+    let headers: Record<string, string> = {};
+    const mockRes = {
+      writeHead(code: number, hdrs: Record<string, string>) {
+        statusCode = code;
+        headers = hdrs;
+      },
+      end: vi.fn(),
+    } as unknown as ServerResponse;
+
+    const next = vi.fn();
+    middleware(mockReq, mockRes, next);
+
+    expect(statusCode).toBe(200);
+    expect(headers["Content-Type"]).toBe("text/javascript");
+    expect(next).not.toHaveBeenCalled();
+
+    await (plugin as any).buildEnd?.call({});
+  });
+
+  // Acceptance: base path가 있지만 @ng/component가 아닌 요청은 next()로 통과
+  it("passes through non-/@ng/component requests with base path", async () => {
+    const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
+    await (plugin as any).buildStart?.call({});
+
+    const middlewares: Array<(req: IncomingMessage, res: ServerResponse, next: () => void) => void> =
+      [];
+    const mockServer = {
+      config: { base: "/client-pda/" },
+      middlewares: {
+        use: (fn: (req: IncomingMessage, res: ServerResponse, next: () => void) => void) => {
+          middlewares.push(fn);
+        },
+      },
+      httpServer: { on: vi.fn() },
+    };
+    (plugin as any).configureServer?.(mockServer);
+
+    const middleware = middlewares[0];
+    const mockReq = { url: "/client-pda/other-path" } as IncomingMessage;
+    const mockRes = {} as ServerResponse;
+    const next = vi.fn();
+
+    middleware(mockReq, mockRes, next);
+    expect(next).toHaveBeenCalled();
+
+    await (plugin as any).buildEnd?.call({});
+  });
 });

package/tests/angular/vite-angular-plugin.spec.ts

@@ -192,6 +192,73 @@ describe("sdAngularPlugin", () => {
     // (in real use, Vite server close triggers this)
   });
 
+  // Scenario: optimizeDeps에 Angular Linker esbuild 플러그인이 등록된다 (Feature 1.1 Angular Linker)
+  it("registers angular-vite-optimize-deps esbuild plugin in optimizeDeps config", () => {
+    const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
+    const config = (plugin as any).config?.();
+
+    const esbuildPlugins = config?.optimizeDeps?.esbuildOptions?.plugins as
+      | { name: string }[]
+      | undefined;
+    expect(esbuildPlugins).toBeDefined();
+    expect(esbuildPlugins!.some((p) => p.name === "angular-vite-optimize-deps")).toBe(true);
+  });
+
+  // Scenario: .mjs 파일이 JavaScriptTransformer를 통과한다 (Feature 1.1 Angular Linker)
+  it("transforms .mjs files through JavaScriptTransformer", async () => {
+    const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
+    await (plugin as any).buildStart?.call({});
+
+    const mjsCode = "export const x = 1;";
+    const result = await (plugin as any).transform?.call(
+      {},
+      mjsCode,
+      "/some/library/module.mjs",
+    );
+
+    // .mjs 파일은 transform 결과를 반환해야 한다 (undefined가 아님)
+    expect(result).toBeDefined();
+    expect(result.code).toBeDefined();
+    expect(typeof result.code).toBe("string");
+
+    await (plugin as any).buildEnd?.call({});
+  });
+
+  // Scenario: .js 파일이 JavaScriptTransformer를 통과한다 (Feature 1.1 Angular Linker)
+  it("transforms .js files through JavaScriptTransformer", async () => {
+    const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
+    await (plugin as any).buildStart?.call({});
+
+    const jsCode = "export const y = 2;";
+    const result = await (plugin as any).transform?.call(
+      {},
+      jsCode,
+      "/some/library/module.js",
+    );
+
+    expect(result).toBeDefined();
+    expect(result.code).toBeDefined();
+    expect(typeof result.code).toBe("string");
+
+    await (plugin as any).buildEnd?.call({});
+  });
+
+  // Scenario: 비대상 파일(.css 등)은 transform하지 않는다 (Feature 1.1 Angular Linker)
+  it("returns undefined for non-JS files like .css", async () => {
+    const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
+    await (plugin as any).buildStart?.call({});
+
+    const result = await (plugin as any).transform?.call(
+      {},
+      "body { color: red; }",
+      "/some/styles.css",
+    );
+
+    expect(result).toBeUndefined();
+
+    await (plugin as any).buildEnd?.call({});
+  });
+
   // Scenario: Angular .ts 파일 transform
   it("transforms emitted .ts files with compiled JS", async () => {
     const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: false });

package/tests/capacitor/capacitor-build.spec.ts

@@ -27,8 +27,8 @@ vi.mock("@simplysm/core-node", () => ({
     copy: mockFsxCopy,
   },
   cpx: {
-    exec: mockCpxExec,
-    execSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
+    spawn: mockCpxSpawn,
+    spawnSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
   },
   pathx: {
     posixResolve: (...args: string[]) => path.resolve(...args).replace(/\\/g, "/"),
@@ -46,7 +46,7 @@ vi.mock("@simplysm/core-common", () => ({
 
 // cpx mock (was execa)
 const execaCalls: { command: string; args: string[] }[] = [];
-const mockCpxExec = vi.fn((...args: unknown[]) => {
+const mockCpxSpawn = vi.fn((...args: unknown[]) => {
   execaCalls.push({ command: args[0] as string, args: (args[1] as string[] | undefined) ?? [] });
   return Promise.resolve({ stdout: "", stderr: "", exitCode: 0 });
 });
@@ -82,7 +82,9 @@ vi.mock("consola", () => ({
       warn: mockLoggerWarn,
       success: mockLoggerSuccess,
     }),
+    level: 0,
   },
+  LogLevels: { debug: 4 },
 }));
 
 //#endregion
@@ -270,7 +272,7 @@ describe("Capacitor 빌드", () => {
 
       // cap copy가 gradlew보다 먼저 실행되는지 확인
       const capCopyIndex = execaCalls.findIndex(
-        (c) => c.command === "npx" && c.args.includes("cap") && c.args.includes("copy"),
+        (c) => c.command === "pnpm" && c.args.includes("cap") && c.args.includes("copy"),
       );
       const gradlewIndex = execaCalls.findIndex((c) => c.command.includes("gradlew"));
       expect(capCopyIndex).toBeGreaterThanOrEqual(0);

package/tests/capacitor/capacitor-icon.spec.ts

@@ -25,8 +25,8 @@ vi.mock("@simplysm/core-node", () => ({
     glob: mockFsxGlob,
   },
   cpx: {
-    exec: mockCpxExec,
-    execSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
+    spawn: mockCpxSpawn,
+    spawnSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
   },
   pathx: {
     posixResolve: (...args: string[]) => path.resolve(...args).replace(/\\/g, "/"),
@@ -44,7 +44,7 @@ vi.mock("@simplysm/core-common", () => ({
 
 // cpx mock (was execa)
 const execaCalls: { command: string; args: string[] }[] = [];
-const mockCpxExec = vi.fn((...args: unknown[]) => {
+const mockCpxSpawn = vi.fn((...args: unknown[]) => {
   execaCalls.push({ command: args[0] as string, args: (args[1] as string[] | undefined) ?? [] });
   return Promise.resolve({ stdout: "", stderr: "", exitCode: 0 });
 });
@@ -82,7 +82,9 @@ vi.mock("consola", () => ({
       warn: mockLoggerWarn,
       success: mockLoggerSuccess,
     }),
+    level: 0,
   },
+  LogLevels: { debug: 4 },
 }));
 
 //#endregion
@@ -178,7 +180,7 @@ describe("Capacitor 아이콘 처리", () => {
 
       // capacitor-assets generate가 실행되었는지 확인
       const assetsCmd = execaCalls.find(
-        (c) => c.command === "npx" && c.args.includes("capacitor-assets"),
+        (c) => c.command === "pnpm" && c.args.includes("capacitor-assets"),
       );
       expect(assetsCmd).toBeDefined();
 
@@ -202,7 +204,7 @@ describe("Capacitor 아이콘 처리", () => {
 
       // capacitor-assets generate가 실행되지 않아야 한다
       const assetsCmd = execaCalls.find(
-        (c) => c.command === "npx" && c.args.includes("capacitor-assets"),
+        (c) => c.command === "pnpm" && c.args.includes("capacitor-assets"),
       );
       expect(assetsCmd).toBeUndefined();
     });

package/tests/capacitor/capacitor-init.spec.ts

@@ -26,8 +26,8 @@ vi.mock("@simplysm/core-node", () => ({
     copy: mockFsxCopy,
   },
   cpx: {
-    exec: mockCpxExec,
-    execSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
+    spawn: mockCpxSpawn,
+    spawnSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
   },
   pathx: {
     posixResolve: (...args: string[]) => path.resolve(...args).replace(/\\/g, "/"),
@@ -43,7 +43,7 @@ vi.mock("@simplysm/core-common", () => ({
 }));
 
 const execaCalls: { command: string; args: string[] }[] = [];
-const mockCpxExec = vi.fn((...args: unknown[]) => {
+const mockCpxSpawn = vi.fn((...args: unknown[]) => {
   execaCalls.push({ command: args[0] as string, args: (args[1] as string[] | undefined) ?? [] });
   return Promise.resolve({ stdout: "", stderr: "", exitCode: 0 });
 });
@@ -71,8 +71,10 @@ const mockLoggerDebug = vi.fn();
 const mockLoggerWarn = vi.fn();
 vi.mock("consola", () => ({
   consola: {
+    level: 0,
     withTag: () => ({ debug: mockLoggerDebug, warn: mockLoggerWarn }),
   },
+  LogLevels: { debug: 4 },
 }));
 
 //#endregion
@@ -131,6 +133,22 @@ function setupDefaultMocks() {
     if (p.includes("gradle.properties")) {
       return "org.gradle.jvmargs=-Xmx2048m";
     }
+    if (p.includes("styles.xml")) {
+      return `<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
+        <item name="colorPrimary">@color/colorPrimary</item>
+    </style>
+    <style name="AppTheme.NoActionBar" parent="Theme.AppCompat.DayNight.NoActionBar">
+        <item name="windowActionBar">false</item>
+        <item name="windowNoTitle">true</item>
+        <item name="android:background">@null</item>
+    </style>
+    <style name="AppTheme.NoActionBarLaunch" parent="Theme.SplashScreen">
+        <item name="android:background">@drawable/splash</item>
+    </style>
+</resources>`;
+    }
     return "";
   });
 
@@ -197,7 +215,7 @@ describe("Capacitor 초기화", () => {
     setupDefaultMocks();
   });
 
-  it("최초 초기화: npm install, cap init, cap add android를 실행한다", async () => {
+  it("최초 초기화: pnpm install, cap init, cap add android를 실행한다", async () => {
     let androidAdded = false;
     mockFsxExists.mockImplementation((p: string) => {
       const n = p.replace(/\\/g, "/");
@@ -220,18 +238,18 @@ describe("Capacitor 초기화", () => {
     });
     await cap.initialize();
 
-    expect(execaCalls.some((c) => c.command === "npm" && c.args.includes("install"))).toBe(true);
+    expect(execaCalls.some((c) => c.command === "pnpm" && c.args.includes("install"))).toBe(true);
     expect(
-      execaCalls.some((c) => c.command === "npx" && c.args.includes("cap") && c.args.includes("init")),
+      execaCalls.some((c) => c.command === "pnpm" && c.args.includes("cap") && c.args.includes("init")),
     ).toBe(true);
     expect(
       execaCalls.some(
-        (c) => c.command === "npx" && c.args.includes("cap") && c.args.includes("add"),
+        (c) => c.command === "pnpm" && c.args.includes("cap") && c.args.includes("add"),
       ),
     ).toBe(true);
   });
 
-  it("재초기화: 설정 미변경 시 npm install을 건너뛴다", async () => {
+  it("재초기화: 설정 미변경 시 pnpm install을 건너뛴다", async () => {
     const { Capacitor } = await import("../../src/capacitor/capacitor.js");
     const cap = await Capacitor.create(PKG_PATH, {
       appId: "com.test.app",
@@ -240,10 +258,10 @@ describe("Capacitor 초기화", () => {
     });
     await cap.initialize();
 
-    expect(execaCalls.some((c) => c.command === "npm" && c.args.includes("install"))).toBe(false);
+    expect(execaCalls.some((c) => c.command === "pnpm" && c.args.includes("install"))).toBe(false);
   });
 
-  it("플러그인 추가: package.json에 플러그인을 추가하고 npm install을 실행한다", async () => {
+  it("플러그인 추가: package.json에 플러그인을 추가하고 pnpm install을 실행한다", async () => {
     const { Capacitor } = await import("../../src/capacitor/capacitor.js");
 
     // 클라이언트 패키지의 deps에 플러그인 포함
@@ -531,6 +549,98 @@ describe("Android 네이티브 설정", () => {
     expect(manifestWrite).toBeDefined();
   });
 
+  it("styles.xml의 Theme.SplashScreen parent를 Theme.AppCompat.DayNight.NoActionBar로 변경한다", async () => {
+    const { Capacitor } = await import("../../src/capacitor/capacitor.js");
+    const cap = await Capacitor.create(PKG_PATH, {
+      appId: "com.test.app",
+      appName: "Test App",
+      platform: { android: {} },
+    });
+    await cap.initialize();
+
+    const writeCalls = mockFsxWrite.mock.calls;
+    const stylesWrite = writeCalls.find(
+      (call) =>
+        typeof call[0] === "string" &&
+        call[0].includes("styles.xml") &&
+        typeof call[1] === "string" &&
+        call[1].includes('parent="Theme.AppCompat.DayNight.NoActionBar"'),
+    );
+    expect(stylesWrite).toBeDefined();
+    // android:background는 유지
+    expect((stylesWrite![1] as string)).toContain("@drawable/splash");
+    // Theme.SplashScreen은 제거됨
+    expect((stylesWrite![1] as string)).not.toContain('parent="Theme.SplashScreen"');
+  });
+
+  it("이미 변경된 styles.xml은 재변경하지 않는다", async () => {
+    mockFsxRead.mockImplementation((p: string) => {
+      if (p.includes("styles.xml")) {
+        return `<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme.NoActionBarLaunch" parent="Theme.AppCompat.DayNight.NoActionBar">
+        <item name="android:background">@drawable/splash</item>
+    </style>
+</resources>`;
+      }
+      if (p.includes("AndroidManifest.xml")) {
+        return '<manifest xmlns:android="http://schemas.android.com/apk/res/android">\n<application>\n<activity android:name=".MainActivity">\n</activity>\n</application>\n</manifest>';
+      }
+      if (p.includes("build.gradle")) {
+        return `android {
+    defaultConfig {
+        versionCode 1
+        versionName "1.0"
+        minSdkVersion rootProject.ext.minSdkVersion
+        targetSdkVersion rootProject.ext.targetSdkVersion
+    }
+    buildTypes { release { } }
+}`;
+      }
+      if (p.includes("gradle.properties")) {
+        return "org.gradle.jvmargs=-Xmx2048m";
+      }
+      return "";
+    });
+
+    const { Capacitor } = await import("../../src/capacitor/capacitor.js");
+    const cap = await Capacitor.create(PKG_PATH, {
+      appId: "com.test.app",
+      appName: "Test App",
+      platform: { android: {} },
+    });
+    await cap.initialize();
+
+    const writeCalls = mockFsxWrite.mock.calls;
+    const stylesWrite = writeCalls.find(
+      (call) =>
+        typeof call[0] === "string" &&
+        call[0].includes("styles.xml"),
+    );
+    expect(stylesWrite).toBeUndefined();
+  });
+
+  it("styles.xml이 없으면 warn을 출력한다", async () => {
+    mockFsxExists.mockImplementation((p: string) => {
+      const n = p.replace(/\\/g, "/");
+      if (n.includes(".capacitor.lock")) return false;
+      if (n.includes("styles.xml")) return false;
+      return true;
+    });
+
+    const { Capacitor } = await import("../../src/capacitor/capacitor.js");
+    const cap = await Capacitor.create(PKG_PATH, {
+      appId: "com.test.app",
+      appName: "Test App",
+      platform: { android: {} },
+    });
+    await cap.initialize();
+
+    expect(mockLoggerWarn).toHaveBeenCalledWith(
+      expect.stringContaining("styles.xml"),
+    );
+  });
+
   it("application 태그에 커스텀 속성을 추가한다", async () => {
     const { Capacitor } = await import("../../src/capacitor/capacitor.js");
     const cap = await Capacitor.create(PKG_PATH, {