@simplysm/sd-cli 12.16.27 → 13.0.0-beta.12

package/README.md

@@ -0,0 +1,529 @@
+# @simplysm/sd-cli
+
+The CLI tool for the Simplysm framework. It provides project initialization, ESLint linting, TypeScript type-checking, library/client/server package builds, development mode, deployment, Android device execution, and Electron desktop app build capabilities.
+
+## Installation
+
+```bash
+npm install --save-dev @simplysm/sd-cli
+# or
+pnpm add -D @simplysm/sd-cli
+```
+
+## Main Commands
+
+The CLI binary name is `sd-cli`. All commands support the `--debug` option to output detailed logs.
+
+### lint
+
+Runs ESLint. It automatically extracts and applies globalIgnores patterns from `eslint.config.ts` and stores cache in `.cache/eslint.cache`.
+
+```bash
+# Lint all
+sd-cli lint
+
+# Lint specific path
+sd-cli lint packages/core-common
+
+# Lint multiple paths
+sd-cli lint packages/core-common tests/orm
+
+# Auto-fix
+sd-cli lint --fix
+
+# Output rule execution times
+sd-cli lint --timing
+```
+
+**Options:**
+
+| Option     | Description                                                | Default |
+| ---------- | ---------------------------------------------------------- | ------- |
+| `--fix`    | Auto-fix                                                   | `false` |
+| `--timing` | Output rule execution times (sets ESLint `TIMING` env var) | `false` |
+| `--debug`  | Output debug logs                                          | `false` |
+
+### typecheck
+
+Runs TypeScript type-checking. It performs parallel type-checking per package environment (`node`/`browser`) based on `tsconfig.json` and `sd.config.ts`. Uses worker threads to run concurrently up to 7/8 of CPU cores.
+
+```bash
+# Type-check all
+sd-cli typecheck
+
+# Type-check specific path
+sd-cli typecheck packages/core-common
+
+# Type-check multiple paths
+sd-cli typecheck packages/core-common tests/orm
+
+# Pass options to sd.config.ts
+sd-cli typecheck -o key=value
+```
+
+**Options:**
+
+| Option            | Description                                                | Default |
+| ----------------- | ---------------------------------------------------------- | ------- |
+| `--options`, `-o` | Additional options to pass to sd.config.ts (multi-use)     | `[]`    |
+| `--debug`         | Output debug logs                                          | `false` |
+
+**Type-check environment by target:**
+
+| Target              | Environment             |
+| ------------------- | ----------------------- |
+| `node`              | node environment once   |
+| `browser`, `client` | browser environment once |
+| `neutral`           | node + browser environment twice |
+| `scripts`           | Excluded from type-check |
+
+### watch
+
+Watches **library packages** (`node`/`browser`/`neutral` targets) in watch mode. Automatically rebuilds on file changes and generates `.d.ts` type definition files.
+
+> **Note**: Use the `dev` command for `client`/`server` targets.
+
+```bash
+# Watch all library packages
+sd-cli watch
+
+# Watch specific package
+sd-cli watch solid
+
+# Watch multiple packages
+sd-cli watch solid core-common
+```
+
+**Options:**
+
+| Option            | Description                                                | Default |
+| ----------------- | ---------------------------------------------------------- | ------- |
+| `--options`, `-o` | Additional options to pass to sd.config.ts (multi-use)     | `[]`    |
+| `--debug`         | Output debug logs                                          | `false` |
+
+### dev
+
+Runs **Client and Server packages** in development mode. `client` targets run with Vite dev server, and `server` targets run with Server Build Worker + Server Runtime Worker. Supports Server-Client proxy connection and Capacitor initialization.
+
+```bash
+# Run all client/server packages
+sd-cli dev
+
+# Run specific package
+sd-cli dev solid-demo
+
+# Run multiple packages
+sd-cli dev solid-demo my-server
+```
+
+**Options:**
+
+| Option            | Description                                                | Default |
+| ----------------- | ---------------------------------------------------------- | ------- |
+| `--options`, `-o` | Additional options to pass to sd.config.ts (multi-use)     | `[]`    |
+| `--debug`         | Output debug logs                                          | `false` |
+
+**How it works:**
+
+- `client` target: Starts Vite dev server. If `server` config is a string (package name), connects proxy to that server
+- `server` target: Builds in esbuild watch mode, then runs server runtime in separate Worker. Auto-rebuilds and restarts server on file changes
+- Client packages with Capacitor config perform Capacitor initialization after build completes
+- Client packages with Electron config launch Electron in dev mode after build completes
+- Terminates on SIGINT/SIGTERM signals
+
+### build
+
+Runs production build. Performs lint, dist folder cleanup, and build sequentially.
+
+```bash
+# Build all packages
+sd-cli build
+
+# Build specific packages
+sd-cli build solid core-common
+```
+
+**Options:**
+
+| Option            | Description                                                | Default |
+| ----------------- | ---------------------------------------------------------- | ------- |
+| `--options`, `-o` | Additional options to pass to sd.config.ts (multi-use)     | `[]`    |
+| `--debug`         | Output debug logs                                          | `false` |
+
+**Build behavior by target:**
+
+| Target                     | JS build        | .d.ts generation | Type-check | Note                                  |
+| -------------------------- | --------------- | ---------------- | ---------- | ------------------------------------- |
+| `node`/`browser`/`neutral` | esbuild         | O                | O          | Library package                       |
+| `client`                   | Vite production | X                | O          | Client app (+ Capacitor/Electron build) |
+| `server`                   | esbuild         | X                | X          | Server app                            |
+| `scripts`                  | Excluded        | Excluded         | Excluded   | -                                     |
+
+### publish
+
+Publishes packages. For safety, proceeds in the following order:
+
+1. Pre-validation (npm authentication, Git uncommitted changes check)
+2. Version upgrade (increment prerelease if prerelease, otherwise patch)
+3. Build (Git rollback on failure)
+4. Git commit/tag/push (Git rollback on failure)
+5. npm/FTP/local deployment
+6. postPublish script execution
+
+```bash
+# Publish all packages with publish config
+sd-cli publish
+
+# Publish specific packages
+sd-cli publish solid core-common
+
+# Publish without build (dangerous)
+sd-cli publish --no-build
+
+# Simulate without actual deployment
+sd-cli publish --dry-run
+```
+
+**Options:**
+
+| Option                   | Description                                                | Default |
+| ------------------------ | ---------------------------------------------------------- | ------- |
+| `--build` / `--no-build` | Whether to run build (skip with `--no-build`)             | `true`  |
+| `--dry-run`              | Simulate without actual deployment                         | `false` |
+| `--options`, `-o`        | Additional options to pass to sd.config.ts (multi-use)     | `[]`    |
+| `--debug`                | Output debug logs                                          | `false` |
+
+### init
+
+Initializes a new Simplysm project in the current directory. The directory must be empty and the directory name must be a valid npm scope name (lowercase, numbers, hyphens only).
+
+Creates a skeleton project with:
+- `sd.config.ts`, `tsconfig.json`, `eslint.config.ts`, `pnpm-workspace.yaml`
+- `.gitignore`, `.prettierrc.yaml`, `.prettierignore`, `mise.toml`
+
+After rendering templates, runs `pnpm install` automatically.
+
+```bash
+# Create an empty directory and run init
+mkdir my-project && cd my-project
+sd-cli init
+```
+
+After initialization, use `sd-cli add client` and `sd-cli add server` to add packages.
+
+> **Note**: To install Claude Code skills/agents, use `sd-claude install` from the separate `@simplysm/sd-claude` package.
+
+### add client
+
+Adds a client package to an existing project. Must be run from the project root (where `sd.config.ts` exists).
+
+Runs an interactive prompt to collect:
+1. Client package name suffix (creates `client-{suffix}` package)
+2. Whether to use router
+
+After collecting inputs, it:
+1. Renders client package from Handlebars templates into `packages/client-{suffix}/`
+2. Adds the package entry to `sd.config.ts` (via ts-morph AST editing)
+3. Adds tailwind CSS settings to `eslint.config.ts` (if first client)
+4. Runs `pnpm install`
+
+```bash
+sd-cli add client
+```
+
+### add server
+
+Adds a server package to an existing project. Must be run from the project root (where `sd.config.ts` exists).
+
+Runs an interactive prompt to collect:
+1. Server name suffix (leave empty for just `server`, otherwise creates `server-{suffix}`)
+2. Which existing client packages this server should serve (multi-select)
+
+After collecting inputs, it:
+1. Renders server package from Handlebars templates into `packages/{server-name}/`
+2. Adds the server package entry to `sd.config.ts`
+3. Updates selected client packages' `server` field in `sd.config.ts`
+4. Runs `pnpm install`
+
+```bash
+sd-cli add server
+```
+
+### device
+
+Runs Capacitor app on Android device. Only available for `client` target packages with `capacitor` config in `sd.config.ts`.
+
+```bash
+# Specify package (required)
+sd-cli device -p my-app
+
+# Specify dev server URL directly
+sd-cli device -p my-app -u http://192.168.0.10:3000
+```
+
+**Options:**
+
+| Option            | Description                                                               | Default |
+| ----------------- | ------------------------------------------------------------------------- | ------- |
+| `--package`, `-p` | Package name (required)                                                   | -       |
+| `--url`, `-u`     | Dev server URL (uses server port from sd.config.ts if not specified)      | -       |
+| `--options`, `-o` | Additional options to pass to sd.config.ts (multi-use)                    | `[]`    |
+| `--debug`         | Output debug logs                                                         | `false` |
+
+## Configuration (sd.config.ts)
+
+Create an `sd.config.ts` file in the project root to define build targets and deployment settings per package. Used by `typecheck`, `watch`, `dev`, `build`, `publish`, and `device` commands.
+
+The `typecheck` command treats all packages as `neutral` target if no config file exists. The `watch`, `dev`, `build`, and `publish` commands require this file.
+
+### Basic Example
+
+```typescript
+import type { SdConfigFn } from "@simplysm/sd-cli";
+
+const config: SdConfigFn = () => ({
+  packages: {
+    "core-common": { target: "neutral" },
+    "core-node": { target: "node" },
+    "core-browser": { target: "browser" },
+    "solid": { target: "browser", publish: "npm" },
+    "solid-demo": { target: "client", server: "solid-demo-server" },
+    "solid-demo-server": { target: "server" },
+    "my-scripts": { target: "scripts" },
+  },
+});
+
+export default config;
+```
+
+### Target Types
+
+| Target    | Description                                                        | Type-check         | watch | dev | build        |
+| --------- | ------------------------------------------------------------------ | ------------------ | ----- | --- | ------------ |
+| `node`    | Node.js-only package. Removes DOM lib, includes `@types/node`     | O (node)           | O     | X   | O (JS + dts) |
+| `browser` | Browser-only package. Keeps DOM lib, excludes `@types/node`       | O (browser)        | O     | X   | O (JS + dts) |
+| `neutral` | Node/browser common. Keeps DOM lib, includes `@types/node`        | O (node + browser) | O     | X   | O (JS + dts) |
+| `client`  | Vite dev server-based client app                                   | O (browser)        | X     | O   | O (Vite)     |
+| `server`  | Fastify-based server app                                           | X                  | X     | O   | O (JS)       |
+| `scripts` | Excluded from typecheck/watch/build                                | X                  | X     | X   | X            |
+
+### Function Parameters
+
+The `sd.config.ts` function receives a `SdConfigParams` object as an argument:
+
+```typescript
+import type { SdConfigFn, SdConfigParams } from "@simplysm/sd-cli";
+
+const config: SdConfigFn = (params: SdConfigParams) => {
+  // params.cwd  - Current working directory
+  // params.dev  - Whether in dev mode (true for dev command, false for build/publish)
+  // params.opt  - Additional options array passed via CLI's -o flag
+
+  return {
+    packages: {
+      "my-app": {
+        target: "client",
+        server: params.dev ? 3000 : "my-server",
+      },
+    },
+  };
+};
+
+export default config;
+```
+
+### Package Configuration Types
+
+#### Library Package (SdBuildPackageConfig)
+
+```typescript
+{
+  target: "node" | "browser" | "neutral";
+  publish?: SdPublishConfig;  // Deployment config (optional)
+}
+```
+
+#### Client Package (SdClientPackageConfig)
+
+```typescript
+{
+  target: "client";
+  server: string | number;      // Server package name or direct port number
+  env?: Record<string, string>; // Environment variables to replace during build
+  publish?: SdPublishConfig;    // Deployment config (optional)
+  capacitor?: SdCapacitorConfig; // Capacitor config (optional)
+  electron?: SdElectronConfig;  // Electron config (optional)
+}
+```
+
+#### Server Package (SdServerPackageConfig)
+
+```typescript
+{
+  target: "server";
+  env?: Record<string, string>; // Environment variables to replace during build
+  publish?: SdPublishConfig;    // Deployment config (optional)
+}
+```
+
+#### Scripts Package (SdScriptsPackageConfig)
+
+```typescript
+{
+  target: "scripts";
+}
+```
+
+### Deployment Configuration (SdPublishConfig)
+
+Three deployment methods are supported:
+
+| Method           | Config Value                                                            | Description                           |
+| ---------------- | ----------------------------------------------------------------------- | ------------------------------------- |
+| npm              | `"npm"`                                                                 | Deploy to npm registry                |
+| Local directory  | `{ type: "local-directory", path: "..." }`                              | Copy dist to local path               |
+| Storage          | `{ type: "ftp" \| "ftps" \| "sftp", host, port?, path?, user?, pass? }` | Upload to FTP/FTPS/SFTP server        |
+
+Environment variable substitution is supported in `path` for local directory and storage: `%VER%` (version), `%PROJECT%` (project path).
+
+```typescript
+// npm deployment
+"core-common": { target: "neutral", publish: "npm" },
+
+// Local directory deployment
+"my-app": {
+  target: "client",
+  server: 3000,
+  publish: { type: "local-directory", path: "/deploy/%VER%/my-app" },
+},
+
+// SFTP upload
+"my-server": {
+  target: "server",
+  publish: {
+    type: "sftp",
+    host: "deploy.example.com",
+    port: 22,
+    path: "/opt/app",
+    user: "deploy",
+    pass: "secret",
+  },
+},
+```
+
+### postPublish Scripts
+
+You can define scripts to run after deployment completes. Supports environment variable substitution (`%VER%`, `%PROJECT%`). On script failure, only a warning is printed and execution continues.
+
+```typescript
+const config: SdConfigFn = () => ({
+  packages: {
+    /* ... */
+  },
+  postPublish: [
+    {
+      type: "script",
+      cmd: "curl",
+      args: ["-X", "POST", "https://hooks.example.com/deploy?version=%VER%"],
+    },
+  ],
+});
+```
+
+### Capacitor Configuration (SdCapacitorConfig)
+
+Capacitor configuration for Android app builds in `client` target packages.
+
+```typescript
+"my-app": {
+  target: "client",
+  server: 3000,
+  capacitor: {
+    appId: "com.example.myapp",
+    appName: "My App",
+    icon: "resources/icon.png",          // App icon (relative to package directory)
+    debug: true,                          // Whether debug build
+    plugins: {                            // Capacitor plugins
+      "@capacitor/camera": true,
+      "@capacitor/storage": { group: "myGroup" },
+    },
+    platform: {
+      android: {
+        config: {                         // AndroidManifest.xml application attributes
+          requestLegacyExternalStorage: "true",
+        },
+        bundle: true,                     // AAB bundle build (APK if false)
+        sdkVersion: 33,                   // Android SDK version
+        permissions: [                    // Additional permissions
+          { name: "CAMERA" },
+          { name: "WRITE_EXTERNAL_STORAGE", maxSdkVersion: 29 },
+        ],
+        intentFilters: [                  // Intent Filters
+          { action: "android.intent.action.VIEW", category: "android.intent.category.DEFAULT" },
+        ],
+        sign: {                           // APK/AAB signing
+          keystore: "keystore.jks",
+          storePassword: "password",
+          alias: "key0",
+          password: "password",
+        },
+      },
+    },
+  },
+},
+```
+
+### Electron Configuration (SdElectronConfig)
+
+Electron configuration for Windows desktop app builds in `client` target packages. Requires `src/electron-main.ts` entry point in the package directory.
+
+```typescript
+"my-app": {
+  target: "client",
+  server: 3000,
+  electron: {
+    appId: "com.example.myapp",           // Electron app ID (required)
+    portable: false,                       // true: portable .exe, false: NSIS installer
+    installerIcon: "resources/icon.ico",   // Installer icon (.ico, relative to package directory)
+    reinstallDependencies: ["better-sqlite3"], // npm packages to include (native modules etc.)
+    postInstallScript: "node scripts/setup.js", // npm postinstall script
+    nsisOptions: {},                       // NSIS options (when portable is false)
+    env: {                                 // Environment variables (accessible via process.env in electron-main.ts)
+      API_URL: "https://api.example.com",
+    },
+  },
+},
+```
+
+**How it works:**
+
+- **Initialize**: Creates `.electron/src/package.json`, runs `npm install`, rebuilds native modules with `electron-rebuild`
+- **Build**: Bundles `electron-main.ts` with esbuild, copies web assets, runs `electron-builder` for Windows
+- **Dev mode**: Bundles `electron-main.ts`, launches Electron pointing to Vite dev server URL
+
+## Cache
+
+| Command       | Cache Path                                           | Description                                                        |
+| ------------- | ---------------------------------------------------- | ------------------------------------------------------------------ |
+| `lint`        | `.cache/eslint.cache`                                | ESLint cache                                                       |
+| `typecheck`   | `packages/{pkg}/.cache/typecheck-{env}.tsbuildinfo`  | Incremental type-check info (`{env}` is `node` or `browser`)      |
+| `watch` (dts) | `packages/{pkg}/.cache/dts.tsbuildinfo`              | Incremental .d.ts build info                                       |
+
+To reset cache, delete the `.cache` directory:
+
+```bash
+# Delete all caches
+rm -rf .cache packages/*/.cache
+```
+
+## Notes
+
+- `sd.config.ts` is required for `watch`, `dev`, `build`, `publish`, and `device` commands. `typecheck` and `lint` work without a config file.
+- The `publish` command automatically increments version and performs Git commit/tag/push. Execution is rejected if there are uncommitted changes.
+- `publish --no-build` deploys already-built artifacts as-is, so use with caution.
+- Before using the `device` command, run `sd-cli dev` or `sd-cli watch` first to initialize the Capacitor project.
+- During build, `VER` (project version) and `DEV` (`"true"` or `"false"`) environment variables are automatically set.
+
+## License
+
+Apache-2.0

package/dist/builders/BaseBuilder.js

@@ -0,0 +1,86 @@
+import { WorkerManager } from "../infra/WorkerManager";
+class BaseBuilder {
+  workerManager;
+  resultCollector;
+  rebuildManager;
+  packages;
+  cwd;
+  isWatchMode = false;
+  /** 초기 빌드 Promise (패키지별) */
+  initialBuildPromises = /* @__PURE__ */ new Map();
+  /** 초기 빌드 resolver (패키지별) */
+  buildResolvers = /* @__PURE__ */ new Map();
+  constructor(options) {
+    this.cwd = options.cwd;
+    this.packages = options.packages;
+    this.resultCollector = options.resultCollector;
+    this.rebuildManager = options.rebuildManager;
+    this.workerManager = new WorkerManager();
+  }
+  /**
+   * Builder 초기화
+   */
+  initialize() {
+    for (const pkg of this.packages) {
+      const key = this.getPackageKey(pkg);
+      this.initialBuildPromises.set(
+        key,
+        new Promise((resolve) => {
+          this.buildResolvers.set(key, resolve);
+        })
+      );
+    }
+    this.createWorkers();
+    this.registerEventHandlers();
+    return Promise.resolve();
+  }
+  /**
+   * 일회성 빌드 (프로덕션)
+   */
+  async build() {
+    await Promise.all(this.packages.map((pkg) => this.buildPackage(pkg)));
+  }
+  /**
+   * Watch 모드 시작
+   */
+  async startWatch() {
+    this.isWatchMode = true;
+    for (const pkg of this.packages) {
+      this.startWatchPackage(pkg);
+    }
+    await Promise.all(this.initialBuildPromises.values());
+  }
+  /**
+   * Builder 종료
+   */
+  async shutdown() {
+    await this.workerManager.terminateAll();
+  }
+  /**
+   * 초기 빌드 Promise 맵 반환
+   */
+  getInitialBuildPromises() {
+    return this.initialBuildPromises;
+  }
+  /**
+   * 패키지 키 생성 (결과 저장용)
+   */
+  getPackageKey(pkg) {
+    return `${pkg.name}:${this.getBuilderType()}`;
+  }
+  /**
+   * 빌드 완료 처리
+   */
+  completeBuild(pkg) {
+    const key = this.getPackageKey(pkg);
+    const resolver = this.buildResolvers.get(key);
+    if (resolver != null) {
+      resolver();
+      this.buildResolvers.delete(key);
+    }
+  }
+}
+export {
+  BaseBuilder
+};
+//# sourceMappingURL=BaseBuilder.js.map

package/dist/builders/BaseBuilder.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/builders/BaseBuilder.ts"],
+  "sourcesContent": ["import { WorkerManager } from \"../infra/WorkerManager\";\nimport type { ResultCollector } from \"../infra/ResultCollector\";\nimport type { RebuildListrManager } from \"../utils/listr-manager\";\nimport type { IBuilder, PackageInfo } from \"./types\";\n\n/**\n * Builder \uCD94\uC0C1 \uBCA0\uC774\uC2A4 \uD074\uB798\uC2A4\n *\n * \uBAA8\uB4E0 Builder\uC758 \uACF5\uD1B5 \uB85C\uC9C1\uC744 \uC81C\uACF5\uD558\uACE0,\n * \uC11C\uBE0C\uD074\uB798\uC2A4\uC5D0\uC11C \uAD6C\uD604\uD574\uC57C \uD560 \uCD94\uC0C1 \uBA54\uC11C\uB4DC\uB97C \uC815\uC758\uD55C\uB2E4.\n */\nexport abstract class BaseBuilder implements IBuilder {\n  protected readonly workerManager: WorkerManager;\n  protected readonly resultCollector: ResultCollector;\n  protected readonly rebuildManager: RebuildListrManager | undefined;\n  protected readonly packages: PackageInfo[];\n  protected readonly cwd: string;\n  protected isWatchMode = false;\n\n  /** \uCD08\uAE30 \uBE4C\uB4DC Promise (\uD328\uD0A4\uC9C0\uBCC4) */\n  protected readonly initialBuildPromises = new Map<string, Promise<void>>();\n  /** \uCD08\uAE30 \uBE4C\uB4DC resolver (\uD328\uD0A4\uC9C0\uBCC4) */\n  protected readonly buildResolvers = new Map<string, () => void>();\n\n  constructor(options: {\n    cwd: string;\n    packages: PackageInfo[];\n    resultCollector: ResultCollector;\n    rebuildManager?: RebuildListrManager;\n  }) {\n    this.cwd = options.cwd;\n    this.packages = options.packages;\n    this.resultCollector = options.resultCollector;\n    this.rebuildManager = options.rebuildManager;\n    this.workerManager = new WorkerManager();\n  }\n\n  /**\n   * Builder \uCD08\uAE30\uD654\n   */\n  initialize(): Promise<void> {\n    // \uCD08\uAE30 \uBE4C\uB4DC Promise \uC0DD\uC131\n    for (const pkg of this.packages) {\n      const key = this.getPackageKey(pkg);\n      this.initialBuildPromises.set(\n        key,\n        new Promise<void>((resolve) => {\n          this.buildResolvers.set(key, resolve);\n        }),\n      );\n    }\n\n    // Worker \uC0DD\uC131\n    this.createWorkers();\n\n    // \uC774\uBCA4\uD2B8 \uD578\uB4E4\uB7EC \uB4F1\uB85D\n    this.registerEventHandlers();\n\n    return Promise.resolve();\n  }\n\n  /**\n   * \uC77C\uD68C\uC131 \uBE4C\uB4DC (\uD504\uB85C\uB355\uC158)\n   */\n  async build(): Promise<void> {\n    await Promise.all(this.packages.map((pkg) => this.buildPackage(pkg)));\n  }\n\n  /**\n   * Watch \uBAA8\uB4DC \uC2DC\uC791\n   */\n  async startWatch(): Promise<void> {\n    this.isWatchMode = true;\n\n    // \uBAA8\uB4E0 \uD328\uD0A4\uC9C0\uC758 watch \uC2DC\uC791 (await \uC5C6\uC774 - \uBC31\uADF8\uB77C\uC6B4\uB4DC \uC2E4\uD589)\n    for (const pkg of this.packages) {\n      this.startWatchPackage(pkg);\n    }\n\n    // \uCD08\uAE30 \uBE4C\uB4DC \uC644\uB8CC\uAE4C\uC9C0 \uB300\uAE30\n    await Promise.all(this.initialBuildPromises.values());\n  }\n\n  /**\n   * Builder \uC885\uB8CC\n   */\n  async shutdown(): Promise<void> {\n    await this.workerManager.terminateAll();\n  }\n\n  /**\n   * \uCD08\uAE30 \uBE4C\uB4DC Promise \uB9F5 \uBC18\uD658\n   */\n  getInitialBuildPromises(): Map<string, Promise<void>> {\n    return this.initialBuildPromises;\n  }\n\n  /**\n   * \uD328\uD0A4\uC9C0 \uD0A4 \uC0DD\uC131 (\uACB0\uACFC \uC800\uC7A5\uC6A9)\n   */\n  protected getPackageKey(pkg: PackageInfo): string {\n    return `${pkg.name}:${this.getBuilderType()}`;\n  }\n\n  /**\n   * \uBE4C\uB4DC \uC644\uB8CC \uCC98\uB9AC\n   */\n  protected completeBuild(pkg: PackageInfo): void {\n    const key = this.getPackageKey(pkg);\n    const resolver = this.buildResolvers.get(key);\n    if (resolver != null) {\n      resolver();\n      this.buildResolvers.delete(key);\n    }\n  }\n\n  /**\n   * Builder \uD0C0\uC785 (\uACB0\uACFC \uD0A4 \uC0DD\uC131\uC6A9)\n   */\n  protected abstract getBuilderType(): string;\n\n  /**\n   * Worker \uC0DD\uC131\n   */\n  protected abstract createWorkers(): void;\n\n  /**\n   * \uC774\uBCA4\uD2B8 \uD578\uB4E4\uB7EC \uB4F1\uB85D\n   */\n  protected abstract registerEventHandlers(): void;\n\n  /**\n   * \uB2E8\uC77C \uD328\uD0A4\uC9C0 \uBE4C\uB4DC (\uD504\uB85C\uB355\uC158)\n   */\n  protected abstract buildPackage(pkg: PackageInfo): Promise<void>;\n\n  /**\n   * \uB2E8\uC77C \uD328\uD0A4\uC9C0 watch \uC2DC\uC791\n   */\n  protected abstract startWatchPackage(pkg: PackageInfo): void;\n}\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAWvB,MAAe,YAAgC;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACT,cAAc;AAAA;AAAA,EAGL,uBAAuB,oBAAI,IAA2B;AAAA;AAAA,EAEtD,iBAAiB,oBAAI,IAAwB;AAAA,EAEhE,YAAY,SAKT;AACD,SAAK,MAAM,QAAQ;AACnB,SAAK,WAAW,QAAQ;AACxB,SAAK,kBAAkB,QAAQ;AAC/B,SAAK,iBAAiB,QAAQ;AAC9B,SAAK,gBAAgB,IAAI,cAAc;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKA,aAA4B;AAE1B,eAAW,OAAO,KAAK,UAAU;AAC/B,YAAM,MAAM,KAAK,cAAc,GAAG;AAClC,WAAK,qBAAqB;AAAA,QACxB;AAAA,QACA,IAAI,QAAc,CAAC,YAAY;AAC7B,eAAK,eAAe,IAAI,KAAK,OAAO;AAAA,QACtC,CAAC;AAAA,MACH;AAAA,IACF;AAGA,SAAK,cAAc;AAGnB,SAAK,sBAAsB;AAE3B,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAuB;AAC3B,UAAM,QAAQ,IAAI,KAAK,SAAS,IAAI,CAAC,QAAQ,KAAK,aAAa,GAAG,CAAC,CAAC;AAAA,EACtE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAA4B;AAChC,SAAK,cAAc;AAGnB,eAAW,OAAO,KAAK,UAAU;AAC/B,WAAK,kBAAkB,GAAG;AAAA,IAC5B;AAGA,UAAM,QAAQ,IAAI,KAAK,qBAAqB,OAAO,CAAC;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,WAA0B;AAC9B,UAAM,KAAK,cAAc,aAAa;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA,EAKA,0BAAsD;AACpD,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKU,cAAc,KAA0B;AAChD,WAAO,GAAG,IAAI,IAAI,IAAI,KAAK,eAAe,CAAC;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA,EAKU,cAAc,KAAwB;AAC9C,UAAM,MAAM,KAAK,cAAc,GAAG;AAClC,UAAM,WAAW,KAAK,eAAe,IAAI,GAAG;AAC5C,QAAI,YAAY,MAAM;AACpB,eAAS;AACT,WAAK,eAAe,OAAO,GAAG;AAAA,IAChC;AAAA,EACF;AA0BF;",
+  "names": []
+}