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

package/dist/commands/typecheck.js

@@ -0,0 +1,197 @@
+import ts from "typescript";
+import path from "path";
+import os from "os";
+import { Listr } from "listr2";
+import { pathPosix, pathFilterByTargets, Worker } from "@simplysm/core-node";
+import "@simplysm/core-common";
+import { consola, LogLevels } from "consola";
+import { parseRootTsconfig } from "../utils/tsconfig";
+import { loadSdConfig } from "../utils/sd-config";
+import { deserializeDiagnostic } from "../utils/typecheck-serialization";
+const PATH_PATTERNS = {
+  /** packages/{pkg}/... */
+  PACKAGE: /^packages\/([^/]+)\//
+};
+function toTypecheckEnvs(target) {
+  if (target === "node") return ["node"];
+  if (target === "browser" || target === "client") return ["browser"];
+  return ["node", "browser"];
+}
+function extractPackages(fileNames, cwd, config) {
+  const packages = /* @__PURE__ */ new Map();
+  for (const fileName of fileNames) {
+    const relativePath = pathPosix(path.relative(cwd, fileName));
+    const packageMatch = relativePath.match(PATH_PATTERNS.PACKAGE);
+    if (packageMatch) {
+      const pkgName = packageMatch[1];
+      if (config.packages[pkgName]?.target === "scripts") continue;
+      if (!packages.has(pkgName)) {
+        packages.set(pkgName, {
+          name: pkgName,
+          dir: path.resolve(cwd, "packages", pkgName),
+          envs: toTypecheckEnvs(config.packages[pkgName]?.target)
+        });
+      }
+    }
+  }
+  return packages;
+}
+function createTypecheckTasks(packages, cwd) {
+  const tasks = [];
+  for (const info of packages.values()) {
+    for (const env of info.envs) {
+      const envSuffix = info.envs.length > 1 ? ` [${env}]` : "";
+      tasks.push({
+        displayName: `\uD328\uD0A4\uC9C0: ${info.name}${envSuffix}`,
+        buildInfo: {
+          name: info.name,
+          cwd,
+          pkgDir: info.dir,
+          env,
+          emit: false
+          // 타입체크만 수행 (dts 생성 안 함)
+        }
+      });
+    }
+  }
+  return tasks;
+}
+async function runTypecheck(options) {
+  const { targets } = options;
+  const cwd = process.cwd();
+  const logger = consola.withTag("sd:cli:typecheck");
+  logger.debug("\uD0C0\uC785\uCCB4\uD06C \uC2DC\uC791", { targets });
+  const formatHost = {
+    getCanonicalFileName: (f) => f,
+    getCurrentDirectory: () => cwd,
+    getNewLine: () => ts.sys.newLine
+  };
+  let parsedConfig;
+  try {
+    parsedConfig = parseRootTsconfig(cwd);
+  } catch (err) {
+    consola.error(err instanceof Error ? err.message : err);
+    process.exitCode = 1;
+    return;
+  }
+  let sdConfig;
+  try {
+    sdConfig = await loadSdConfig({ cwd, dev: false, opt: options.options });
+    logger.debug("sd.config.ts \uB85C\uB4DC \uC644\uB8CC");
+  } catch (err) {
+    sdConfig = { packages: {} };
+    logger.debug("sd.config.ts \uB85C\uB4DC \uC2E4\uD328, \uAE30\uBCF8\uAC12 \uC0AC\uC6A9", err);
+  }
+  const fileNames = pathFilterByTargets(parsedConfig.fileNames, targets, cwd);
+  if (fileNames.length === 0) {
+    process.stdout.write("\u2714 \uD0C0\uC785\uCCB4\uD06C\uD560 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.\n");
+    logger.info("\uD0C0\uC785\uCCB4\uD06C\uD560 \uD30C\uC77C \uC5C6\uC74C");
+    return;
+  }
+  const packages = extractPackages(fileNames, cwd, sdConfig);
+  logger.debug("\uD328\uD0A4\uC9C0 \uCD94\uCD9C \uC644\uB8CC", {
+    packageCount: packages.size,
+    packages: [...packages.keys()]
+  });
+  const tasks = createTypecheckTasks(packages, cwd);
+  if (tasks.length === 0) {
+    process.stdout.write("\u2714 \uD0C0\uC785\uCCB4\uD06C\uD560 \uD328\uD0A4\uC9C0\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.\n");
+    return;
+  }
+  const maxConcurrency = Math.max(Math.floor(os.cpus().length * 7 / 8), 1);
+  const concurrency = Math.min(maxConcurrency, tasks.length);
+  logger.debug("\uB3D9\uC2DC\uC131 \uC124\uC815", { concurrency, maxConcurrency, taskCount: tasks.length });
+  const workerPath = path.resolve(import.meta.dirname, "../workers/dts.worker.ts");
+  const workers = [];
+  for (let i = 0; i < concurrency; i++) {
+    workers.push(Worker.create(workerPath));
+  }
+  const allResults = [];
+  const taskResolvers = /* @__PURE__ */ new Map();
+  try {
+    let taskIndex = 0;
+    async function runNextTask(worker) {
+      while (taskIndex < tasks.length) {
+        const currentIndex = taskIndex++;
+        const task = tasks[currentIndex];
+        try {
+          const result = await worker.buildDts(task.buildInfo);
+          allResults.push({ displayName: task.displayName, result });
+        } catch (err) {
+          logger.error(`Worker \uC624\uB958: ${task.displayName}`, {
+            error: err instanceof Error ? err.message : String(err)
+          });
+          allResults.push({
+            displayName: task.displayName,
+            result: {
+              success: false,
+              errors: [err instanceof Error ? err.message : String(err)],
+              diagnostics: [],
+              errorCount: 1,
+              warningCount: 0
+            }
+          });
+        } finally {
+          taskResolvers.get(task.displayName)?.();
+        }
+      }
+    }
+    const listr = new Listr(
+      tasks.map((task) => ({
+        title: task.displayName,
+        task: () => new Promise((resolve) => {
+          taskResolvers.set(task.displayName, resolve);
+        })
+      })),
+      {
+        concurrent: concurrency,
+        exitOnError: false,
+        renderer: consola.level >= LogLevels.debug ? "verbose" : "default"
+      }
+    );
+    const workerPromises = workers.map((worker) => runNextTask(worker));
+    await Promise.all([listr.run(), ...workerPromises]);
+  } finally {
+    for (const resolver of taskResolvers.values()) {
+      resolver();
+    }
+    await Promise.all(workers.map((w) => w.terminate()));
+  }
+  const allDiagnostics = [];
+  let totalErrorCount = 0;
+  let totalWarningCount = 0;
+  const fileCache = /* @__PURE__ */ new Map();
+  for (const { result } of allResults) {
+    totalErrorCount += result.errorCount;
+    totalWarningCount += result.warningCount;
+    for (const serialized of result.diagnostics) {
+      allDiagnostics.push(deserializeDiagnostic(serialized, fileCache));
+    }
+  }
+  if (totalErrorCount > 0) {
+    logger.error("\uD0C0\uC785\uCCB4\uD06C \uC5D0\uB7EC \uBC1C\uC0DD", {
+      errorCount: totalErrorCount,
+      warningCount: totalWarningCount
+    });
+  } else if (totalWarningCount > 0) {
+    logger.info("\uD0C0\uC785\uCCB4\uD06C \uC644\uB8CC (\uACBD\uACE0 \uC788\uC74C)", {
+      errorCount: totalErrorCount,
+      warningCount: totalWarningCount
+    });
+  } else {
+    logger.info("\uD0C0\uC785\uCCB4\uD06C \uC644\uB8CC", { errorCount: totalErrorCount, warningCount: totalWarningCount });
+  }
+  if (allDiagnostics.length > 0) {
+    const uniqueDiagnostics = ts.sortAndDeduplicateDiagnostics(allDiagnostics);
+    const message = ts.formatDiagnosticsWithColorAndContext(uniqueDiagnostics, formatHost);
+    process.stdout.write(message);
+  }
+  if (totalErrorCount > 0) {
+    process.exitCode = 1;
+  }
+}
+export {
+  extractPackages,
+  runTypecheck
+};
+//# sourceMappingURL=typecheck.js.map

package/dist/commands/typecheck.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/commands/typecheck.ts"],
+  "sourcesContent": ["import ts from \"typescript\";\nimport path from \"path\";\nimport os from \"os\";\nimport { Listr } from \"listr2\";\nimport { pathPosix, pathFilterByTargets, Worker, type WorkerProxy } from \"@simplysm/core-node\";\nimport \"@simplysm/core-common\";\nimport { consola, LogLevels } from \"consola\";\nimport type { SdConfig } from \"../sd-config.types\";\nimport { parseRootTsconfig, type TypecheckEnv } from \"../utils/tsconfig\";\nimport { loadSdConfig } from \"../utils/sd-config\";\nimport { deserializeDiagnostic } from \"../utils/typecheck-serialization\";\nimport type { DtsBuildInfo, DtsBuildResult } from \"../workers/dts.worker\";\nimport type * as DtsWorkerModule from \"../workers/dts.worker\";\n\n//#region Types\n\n/**\n * TypeScript \uD0C0\uC785\uCCB4\uD06C \uC635\uC158\n */\nexport interface TypecheckOptions {\n  /** \uD0C0\uC785\uCCB4\uD06C\uD560 \uACBD\uB85C \uD544\uD130 (\uC608: `packages/core-common`). \uBE48 \uBC30\uC5F4\uC774\uBA74 tsconfig.json\uC5D0 \uC815\uC758\uB41C \uBAA8\uB4E0 \uD30C\uC77C \uB300\uC0C1 */\n  targets: string[];\n  /** sd.config.ts\uC5D0 \uC804\uB2EC\uD560 \uCD94\uAC00 \uC635\uC158 */\n  options: string[];\n}\n\n// \uD328\uD0A4\uC9C0 \uC815\uBCF4 (packages/* \uD558\uC704 \uD30C\uC77C \uBD84\uB958\uC6A9)\ninterface PackageInfo {\n  name: string;\n  dir: string;\n  envs: TypecheckEnv[]; // neutral\uC740 [\"node\", \"browser\"], \uB098\uBA38\uC9C0\uB294 \uB2E8\uC77C \uD658\uACBD\n}\n\n// \uD0C0\uC785\uCCB4\uD06C \uC791\uC5C5 \uC815\uBCF4 (\uB0B4\uBD80 \uC0AC\uC6A9)\ninterface TypecheckTask {\n  /** \uC791\uC5C5 \uD45C\uC2DC \uC774\uB984 (\uC608: \"\uD328\uD0A4\uC9C0: core-common [node]\") */\n  displayName: string;\n  /** dts.worker\uC5D0 \uC804\uB2EC\uD560 \uC815\uBCF4 */\n  buildInfo: DtsBuildInfo;\n}\n\n//#endregion\n\n//#region Utilities\n\n/** \uACBD\uB85C \uBD84\uB958\uC6A9 \uC815\uADDC\uD45C\uD604\uC2DD */\nconst PATH_PATTERNS = {\n  /** packages/{pkg}/... */\n  PACKAGE: /^packages\\/([^/]+)\\//,\n} as const;\n\n/**\n * \uD328\uD0A4\uC9C0 \uD0C0\uAC9F\uC744 \uD0C0\uC785\uCCB4\uD06C \uD658\uACBD \uBAA9\uB85D\uC73C\uB85C \uBCC0\uD658\uD569\uB2C8\uB2E4.\n * - node/browser: \uD574\uB2F9 \uD658\uACBD\uB9CC\n * - neutral: node + browser \uB458 \uB2E4\n * - client: browser\uB85C \uCC98\uB9AC\n * @param target \uD328\uD0A4\uC9C0 \uBE4C\uB4DC \uD0C0\uAC9F\n * @returns \uD0C0\uC785\uCCB4\uD06C \uD658\uACBD \uBAA9\uB85D\n */\nfunction toTypecheckEnvs(target: string | undefined): TypecheckEnv[] {\n  if (target === \"node\") return [\"node\"];\n  if (target === \"browser\" || target === \"client\") return [\"browser\"];\n  // neutral \uB610\uB294 \uBBF8\uC9C0\uC815\uC740 \uB458 \uB2E4\n  return [\"node\", \"browser\"];\n}\n\n/**\n * \uD30C\uC77C \uACBD\uB85C\uC5D0\uC11C \uD328\uD0A4\uC9C0 \uC815\uBCF4\uB97C \uCD94\uCD9C\uD569\uB2C8\uB2E4.\n * scripts \uD0C0\uAC9F \uD328\uD0A4\uC9C0\uB294 \uC81C\uC678\uD569\uB2C8\uB2E4.\n * @internal \uD14C\uC2A4\uD2B8\uC6A9\uC73C\uB85C export\n */\nexport function extractPackages(fileNames: string[], cwd: string, config: SdConfig): Map<string, PackageInfo> {\n  const packages = new Map<string, PackageInfo>();\n\n  for (const fileName of fileNames) {\n    const relativePath = pathPosix(path.relative(cwd, fileName));\n\n    // packages/{pkg}/...\n    const packageMatch = relativePath.match(PATH_PATTERNS.PACKAGE);\n    if (packageMatch) {\n      const pkgName = packageMatch[1];\n      // scripts \uD0C0\uAC9F \uD328\uD0A4\uC9C0\uB294 \uC81C\uC678\n      if (config.packages[pkgName]?.target === \"scripts\") continue;\n\n      if (!packages.has(pkgName)) {\n        packages.set(pkgName, {\n          name: pkgName,\n          dir: path.resolve(cwd, \"packages\", pkgName),\n          envs: toTypecheckEnvs(config.packages[pkgName]?.target),\n        });\n      }\n    }\n  }\n\n  return packages;\n}\n\n/**\n * \uD328\uD0A4\uC9C0 \uC815\uBCF4\uB85C\uBD80\uD130 \uD0C0\uC785\uCCB4\uD06C \uC791\uC5C5 \uBAA9\uB85D\uC744 \uC0DD\uC131\uD569\uB2C8\uB2E4.\n * neutral \uD328\uD0A4\uC9C0\uB294 node/browser \uB450 \uD658\uACBD\uC73C\uB85C \uBD84\uB9AC\uD558\uC5EC \uAC01\uAC01 \uCCB4\uD06C\uD569\uB2C8\uB2E4.\n * @param packages \uD328\uD0A4\uC9C0 \uC815\uBCF4 \uB9F5\n * @param cwd \uD604\uC7AC \uC791\uC5C5 \uB514\uB809\uD1A0\uB9AC\n * @returns \uD0C0\uC785\uCCB4\uD06C \uC791\uC5C5 \uC815\uBCF4 \uBC30\uC5F4\n */\nfunction createTypecheckTasks(packages: Map<string, PackageInfo>, cwd: string): TypecheckTask[] {\n  const tasks: TypecheckTask[] = [];\n\n  // packages/* - \uAC01 env\uB9C8\uB2E4 \uBCC4\uB3C4 task \uC0DD\uC131\n  for (const info of packages.values()) {\n    for (const env of info.envs) {\n      const envSuffix = info.envs.length > 1 ? ` [${env}]` : \"\";\n      tasks.push({\n        displayName: `\uD328\uD0A4\uC9C0: ${info.name}${envSuffix}`,\n        buildInfo: {\n          name: info.name,\n          cwd,\n          pkgDir: info.dir,\n          env,\n          emit: false, // \uD0C0\uC785\uCCB4\uD06C\uB9CC \uC218\uD589 (dts \uC0DD\uC131 \uC548 \uD568)\n        },\n      });\n    }\n  }\n\n  return tasks;\n}\n\n//#endregion\n\n//#region Main\n\n/**\n * TypeScript \uD0C0\uC785\uCCB4\uD06C\uB97C \uC2E4\uD589\uD55C\uB2E4.\n *\n * - `tsconfig.json`\uC744 \uB85C\uB4DC\uD558\uC5EC \uCEF4\uD30C\uC77C\uB7EC \uC635\uC158 \uC801\uC6A9\n * - `sd.config.ts`\uB97C \uB85C\uB4DC\uD558\uC5EC \uD328\uD0A4\uC9C0\uBCC4 \uD0C0\uAC9F \uC815\uBCF4 \uD655\uC778 (\uC5C6\uC73C\uBA74 \uAE30\uBCF8\uAC12 \uC0AC\uC6A9)\n * - Worker threads\uB97C \uC0AC\uC6A9\uD558\uC5EC \uC2E4\uC81C \uBCD1\uB82C \uD0C0\uC785\uCCB4\uD06C \uC218\uD589\n * - incremental \uCEF4\uD30C\uC77C \uC0AC\uC6A9 (`.cache/typecheck-{env}.tsbuildinfo`)\n * - listr2\uB97C \uC0AC\uC6A9\uD558\uC5EC \uC9C4\uD589 \uC0C1\uD669 \uD45C\uC2DC\n * - \uC5D0\uB7EC \uBC1C\uC0DD \uC2DC `process.exitCode = 1` \uC124\uC815\n *\n * @param options - \uD0C0\uC785\uCCB4\uD06C \uC2E4\uD589 \uC635\uC158\n * @returns \uC644\uB8CC \uC2DC resolve. \uC5D0\uB7EC \uBC1C\uACAC \uC2DC `process.exitCode`\uB97C 1\uB85C \uC124\uC815\uD558\uACE0 resolve (throw\uD558\uC9C0 \uC54A\uC74C)\n */\nexport async function runTypecheck(options: TypecheckOptions): Promise<void> {\n  const { targets } = options;\n  const cwd = process.cwd();\n  const logger = consola.withTag(\"sd:cli:typecheck\");\n\n  logger.debug(\"\uD0C0\uC785\uCCB4\uD06C \uC2DC\uC791\", { targets });\n\n  const formatHost: ts.FormatDiagnosticsHost = {\n    getCanonicalFileName: (f) => f,\n    getCurrentDirectory: () => cwd,\n    getNewLine: () => ts.sys.newLine,\n  };\n\n  // tsconfig.json \uB85C\uB4DC \uBC0F \uD30C\uC2F1\n  let parsedConfig: ts.ParsedCommandLine;\n  try {\n    parsedConfig = parseRootTsconfig(cwd);\n  } catch (err) {\n    consola.error(err instanceof Error ? err.message : err);\n    process.exitCode = 1;\n    return;\n  }\n\n  // sd.config.ts \uB85C\uB4DC\n  let sdConfig: SdConfig;\n  try {\n    sdConfig = await loadSdConfig({ cwd, dev: false, opt: options.options });\n    logger.debug(\"sd.config.ts \uB85C\uB4DC \uC644\uB8CC\");\n  } catch (err) {\n    // sd.config.ts\uAC00 \uC5C6\uAC70\uB098 \uB85C\uB4DC \uC2E4\uD328 \uC2DC \uAE30\uBCF8\uAC12 \uC0AC\uC6A9\n    sdConfig = { packages: {} };\n    logger.debug(\"sd.config.ts \uB85C\uB4DC \uC2E4\uD328, \uAE30\uBCF8\uAC12 \uC0AC\uC6A9\", err);\n  }\n\n  // targets\uAC00 \uC9C0\uC815\uB418\uBA74 fileNames \uD544\uD130\uB9C1\n  const fileNames = pathFilterByTargets(parsedConfig.fileNames, targets, cwd);\n\n  if (fileNames.length === 0) {\n    process.stdout.write(\"\u2714 \uD0C0\uC785\uCCB4\uD06C\uD560 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.\\n\");\n    logger.info(\"\uD0C0\uC785\uCCB4\uD06C\uD560 \uD30C\uC77C \uC5C6\uC74C\");\n    return;\n  }\n\n  // \uD328\uD0A4\uC9C0 \uC815\uBCF4 \uCD94\uCD9C\n  const packages = extractPackages(fileNames, cwd, sdConfig);\n  logger.debug(\"\uD328\uD0A4\uC9C0 \uCD94\uCD9C \uC644\uB8CC\", {\n    packageCount: packages.size,\n    packages: [...packages.keys()],\n  });\n\n  // \uD0C0\uC785\uCCB4\uD06C \uC791\uC5C5 \uC0DD\uC131\n  const tasks = createTypecheckTasks(packages, cwd);\n\n  if (tasks.length === 0) {\n    process.stdout.write(\"\u2714 \uD0C0\uC785\uCCB4\uD06C\uD560 \uD328\uD0A4\uC9C0\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.\\n\");\n    return;\n  }\n\n  // \uB3D9\uC2DC\uC131 \uC124\uC815: CPU \uCF54\uC5B4\uC758 7/8\uB9CC \uC0AC\uC6A9 (\uC77C\uBC18\uC801\uC778 \uBCD1\uB82C \uBE4C\uB4DC \uB3C4\uAD6C\uC758 \uAE30\uBCF8\uAC12, OS/\uB2E4\uB978 \uD504\uB85C\uC138\uC2A4 \uC5EC\uC720\uBD84 \uD655\uBCF4, \uCD5C\uC18C 1, \uC791\uC5C5 \uC218 \uC774\uD558)\n  const maxConcurrency = Math.max(Math.floor((os.cpus().length * 7) / 8), 1);\n  const concurrency = Math.min(maxConcurrency, tasks.length);\n  logger.debug(\"\uB3D9\uC2DC\uC131 \uC124\uC815\", { concurrency, maxConcurrency, taskCount: tasks.length });\n\n  // Worker \uD480 \uC0DD\uC131 (\uC791\uC5C5 \uC218\uB9CC\uD07C\uB9CC \uC0DD\uC131)\n  const workerPath = path.resolve(import.meta.dirname, \"../workers/dts.worker.ts\");\n  const workers: WorkerProxy<typeof DtsWorkerModule>[] = [];\n  for (let i = 0; i < concurrency; i++) {\n    workers.push(Worker.create<typeof DtsWorkerModule>(workerPath));\n  }\n\n  // \uACB0\uACFC \uC218\uC9D1\uC6A9\n  const allResults: { displayName: string; result: DtsBuildResult }[] = [];\n\n  // listr2-Worker \uC5F0\uB3D9 \uD328\uD134:\n  // 1. listr2\uC758 \uAC01 task\uB294 Promise\uB97C \uBC18\uD658\uD558\uACE0, \uD574\uB2F9 Promise\uAC00 resolve\uB418\uBA74 task\uAC00 \uC644\uB8CC\uB428\n  // 2. taskResolvers \uB9F5\uC5D0 task\uBCC4 resolve \uD568\uC218\uB97C \uC800\uC7A5\n  // 3. Worker\uAC00 \uC791\uC5C5 \uC644\uB8CC \uC2DC \uD574\uB2F9 task\uC758 resolver\uB97C \uD638\uCD9C\uD558\uC5EC listr2 UI \uC5C5\uB370\uC774\uD2B8\n  // 4. Worker \uD480\uC740 \uB3C5\uB9BD\uC801\uC73C\uB85C \uC791\uC5C5 \uD050\uC5D0\uC11C task\uB97C \uAC00\uC838\uC640 \uC2E4\uD589\n  const taskResolvers = new Map<string, () => void>();\n\n  try {\n    // \uC791\uC5C5 \uD050\n    let taskIndex = 0;\n\n    // Worker\uC5D0\uC11C \uC791\uC5C5 \uC2E4\uD589\n    async function runNextTask(worker: WorkerProxy<typeof DtsWorkerModule>): Promise<void> {\n      while (taskIndex < tasks.length) {\n        const currentIndex = taskIndex++;\n        const task = tasks[currentIndex];\n\n        try {\n          const result = await worker.buildDts(task.buildInfo);\n\n          allResults.push({ displayName: task.displayName, result });\n        } catch (err) {\n          // Worker \uC624\uB958 \uB85C\uAE45 \uBC0F \uACB0\uACFC\uB85C \uBCC0\uD658\n          logger.error(`Worker \uC624\uB958: ${task.displayName}`, {\n            error: err instanceof Error ? err.message : String(err),\n          });\n          allResults.push({\n            displayName: task.displayName,\n            result: {\n              success: false,\n              errors: [err instanceof Error ? err.message : String(err)],\n              diagnostics: [],\n              errorCount: 1,\n              warningCount: 0,\n            },\n          });\n        } finally {\n          // \uC131\uACF5/\uC2E4\uD328 \uBAA8\uB450 task \uC644\uB8CC \uCC98\uB9AC\n          taskResolvers.get(task.displayName)?.();\n        }\n      }\n    }\n\n    // listr2\uB85C \uC9C4\uD589 \uC0C1\uD669 \uD45C\uC2DC\n    const listr = new Listr(\n      tasks.map((task) => ({\n        title: task.displayName,\n        task: () =>\n          new Promise<void>((resolve) => {\n            taskResolvers.set(task.displayName, resolve);\n          }),\n      })),\n      {\n        concurrent: concurrency,\n        exitOnError: false,\n        renderer: consola.level >= LogLevels.debug ? \"verbose\" : \"default\",\n      },\n    );\n\n    // \uBCD1\uB82C\uB85C \uBAA8\uB4E0 worker \uC2E4\uD589\n    const workerPromises = workers.map((worker) => runNextTask(worker));\n\n    // listr\uC640 worker \uB3D9\uC2DC \uC2E4\uD589\n    await Promise.all([listr.run(), ...workerPromises]);\n  } finally {\n    // \uBBF8\uD574\uACB0 resolver \uC815\uB9AC (\uD0C0\uC784\uC544\uC6C3/\uBE44\uC815\uC0C1 \uC885\uB8CC \uB300\uBE44)\n    for (const resolver of taskResolvers.values()) {\n      resolver();\n    }\n    // Worker \uC885\uB8CC (\uC131\uACF5/\uC2E4\uD328 \uBAA8\uB450)\n    await Promise.all(workers.map((w) => w.terminate()));\n  }\n\n  // \uACB0\uACFC \uCD9C\uB825\n  const allDiagnostics: ts.Diagnostic[] = [];\n  let totalErrorCount = 0;\n  let totalWarningCount = 0;\n  const fileCache = new Map<string, string>(); // \uD30C\uC77C \uB0B4\uC6A9 \uCE90\uC2DC (\uB3D9\uC77C \uD30C\uC77C \uC911\uBCF5 \uC77D\uAE30 \uBC29\uC9C0)\n  for (const { result } of allResults) {\n    totalErrorCount += result.errorCount;\n    totalWarningCount += result.warningCount;\n    for (const serialized of result.diagnostics) {\n      allDiagnostics.push(deserializeDiagnostic(serialized, fileCache));\n    }\n  }\n\n  if (totalErrorCount > 0) {\n    logger.error(\"\uD0C0\uC785\uCCB4\uD06C \uC5D0\uB7EC \uBC1C\uC0DD\", {\n      errorCount: totalErrorCount,\n      warningCount: totalWarningCount,\n    });\n  } else if (totalWarningCount > 0) {\n    logger.info(\"\uD0C0\uC785\uCCB4\uD06C \uC644\uB8CC (\uACBD\uACE0 \uC788\uC74C)\", {\n      errorCount: totalErrorCount,\n      warningCount: totalWarningCount,\n    });\n  } else {\n    logger.info(\"\uD0C0\uC785\uCCB4\uD06C \uC644\uB8CC\", { errorCount: totalErrorCount, warningCount: totalWarningCount });\n  }\n\n  if (allDiagnostics.length > 0) {\n    const uniqueDiagnostics = ts.sortAndDeduplicateDiagnostics(allDiagnostics);\n    const message = ts.formatDiagnosticsWithColorAndContext(uniqueDiagnostics, formatHost);\n    process.stdout.write(message);\n  }\n\n  if (totalErrorCount > 0) {\n    process.exitCode = 1;\n  }\n}\n\n//#endregion\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/commands/watch.js

@@ -0,0 +1,19 @@
+import { WatchOrchestrator } from "../orchestrators/WatchOrchestrator";
+async function runWatch(options) {
+  const orchestratorOptions = {
+    targets: options.targets,
+    options: options.options
+  };
+  const orchestrator = new WatchOrchestrator(orchestratorOptions);
+  try {
+    await orchestrator.initialize();
+    await orchestrator.start();
+    await orchestrator.awaitTermination();
+  } finally {
+    await orchestrator.shutdown();
+  }
+}
+export {
+  runWatch
+};
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/commands/watch.ts"],
+  "sourcesContent": ["// packages/cli/src/commands/watch.ts\nimport { WatchOrchestrator, type WatchOrchestratorOptions } from \"../orchestrators/WatchOrchestrator\";\n\n/**\n * Watch \uBA85\uB839 \uC635\uC158 (\uD558\uC704 \uD638\uD658\uC131)\n */\nexport interface WatchOptions {\n  targets: string[];\n  options: string[];\n}\n\n/**\n * Library \uD328\uD0A4\uC9C0\uB97C watch \uBAA8\uB4DC\uB85C \uBE4C\uB4DC\uD55C\uB2E4.\n *\n * - `sd.config.ts`\uB97C \uB85C\uB4DC\uD558\uC5EC \uD328\uD0A4\uC9C0\uBCC4 \uBE4C\uB4DC \uD0C0\uAC9F \uC815\uBCF4 \uD655\uC778 (\uD544\uC218)\n * - `node`/`browser`/`neutral` \uD0C0\uAC9F: esbuild watch \uBAA8\uB4DC\uB85C \uBE4C\uB4DC + .d.ts \uC0DD\uC131\n * - \uD30C\uC77C \uBCC0\uACBD \uC2DC \uC790\uB3D9 \uB9AC\uBE4C\uB4DC\n * - SIGINT/SIGTERM \uC2DC\uADF8\uB110\uB85C \uC885\uB8CC\n *\n * @param options - watch \uC2E4\uD589 \uC635\uC158\n * @returns \uC885\uB8CC \uC2DC\uADF8\uB110 \uC218\uC2E0 \uC2DC resolve\n */\nexport async function runWatch(options: WatchOptions): Promise<void> {\n  const orchestratorOptions: WatchOrchestratorOptions = {\n    targets: options.targets,\n    options: options.options,\n  };\n\n  const orchestrator = new WatchOrchestrator(orchestratorOptions);\n\n  try {\n    await orchestrator.initialize();\n    await orchestrator.start();\n    await orchestrator.awaitTermination();\n  } finally {\n    await orchestrator.shutdown();\n  }\n}\n"],
+  "mappings": "AACA,SAAS,yBAAwD;AAqBjE,eAAsB,SAAS,SAAsC;AACnE,QAAM,sBAAgD;AAAA,IACpD,SAAS,QAAQ;AAAA,IACjB,SAAS,QAAQ;AAAA,EACnB;AAEA,QAAM,eAAe,IAAI,kBAAkB,mBAAmB;AAE9D,MAAI;AACF,UAAM,aAAa,WAAW;AAC9B,UAAM,aAAa,MAAM;AACzB,UAAM,aAAa,iBAAiB;AAAA,EACtC,UAAE;AACA,UAAM,aAAa,SAAS;AAAA,EAC9B;AACF;",
+  "names": []
+}

package/dist/core-common/src/common.types.d.ts

@@ -0,0 +1,74 @@
+import { DateTime } from "./types/date-time";
+import { DateOnly } from "./types/date-only";
+import { Time } from "./types/time";
+import { Uuid } from "./types/uuid";
+/**
+ * Buffer 대신 사용하는 바이너리 타입
+ */
+export type Bytes = Uint8Array;
+/**
+ * Primitive 타입 매핑
+ * orm-common과 공유
+ */
+export type PrimitiveTypeMap = {
+    string: string;
+    number: number;
+    boolean: boolean;
+    DateTime: DateTime;
+    DateOnly: DateOnly;
+    Time: Time;
+    Uuid: Uuid;
+    Bytes: Bytes;
+};
+/**
+ * Primitive 타입 문자열 키
+ */
+export type PrimitiveTypeStr = keyof PrimitiveTypeMap;
+/**
+ * Primitive 타입 유니온
+ */
+export type PrimitiveType = PrimitiveTypeMap[PrimitiveTypeStr] | undefined;
+/**
+ * 깊은 Partial 타입
+ *
+ * 객체의 모든 속성을 재귀적으로 선택적(optional)으로 만듭니다.
+ * Primitive 타입(string, number, boolean 등)은 그대로 유지하고,
+ * 객체/배열 타입만 재귀적으로 Partial을 적용합니다.
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   name: string;
+ *   profile: {
+ *     age: number;
+ *     address: { city: string };
+ *   };
+ * }
+ *
+ * // 모든 깊이의 속성이 선택적이 됨
+ * const partial: DeepPartial<User> = {
+ *   profile: { address: {} }
+ * };
+ * ```
+ */
+export type DeepPartial<T> = Partial<{
+    [K in keyof T]: T[K] extends PrimitiveType ? T[K] : DeepPartial<T[K]>;
+}>;
+/**
+ * 생성자 타입
+ *
+ * 클래스 생성자를 타입으로 표현할 때 사용합니다.
+ * 주로 의존성 주입, 팩토리 패턴, instanceof 체크 등에서 활용됩니다.
+ *
+ * @example
+ * function create<T>(ctor: Type<T>): T {
+ *   return new ctor();
+ * }
+ *
+ * class MyClass { name = "test"; }
+ * const instance = create(MyClass); // MyClass 인스턴스
+ */
+export interface Type<T> extends Function {
+    new (...args: unknown[]): T;
+}
+//# sourceMappingURL=common.types.d.ts.map

package/dist/core-common/src/common.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../../../core-common/src/common.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAIpC;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC;AAM/B;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;AAM3E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,OAAO,CAAC;KAClC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtE,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,CAAE,SAAQ,QAAQ;IACvC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;CAC7B"}

package/dist/core-common/src/env.d.ts

@@ -0,0 +1,6 @@
+export declare const env: {
+    DEV: boolean;
+    VER?: string;
+    [key: string]: unknown;
+};
+//# sourceMappingURL=env.d.ts.map

package/dist/core-common/src/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../core-common/src/env.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG,EAAE;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAKxB,CAAC"}

package/dist/core-common/src/errors/argument-error.d.ts

@@ -0,0 +1,25 @@
+import { SdError } from "./sd-error";
+/**
+ * 인수 오류
+ *
+ * 잘못된 인수를 받았을 때 발생시키는 에러이다.
+ * 인수 객체를 YAML 형식으로 메시지에 포함하여 디버깅을 용이하게 한다.
+ *
+ * @example
+ * // 인수 객체만 전달
+ * throw new ArgumentError({ userId: 123, name: null });
+ * // 결과 메시지: "인수가 잘못되었습니다.\n\nuserId: 123\nname: null"
+ *
+ * @example
+ * // 커스텀 메시지와 인수 객체 전달
+ * throw new ArgumentError("유효하지 않은 사용자", { userId: 123 });
+ * // 결과 메시지: "유효하지 않은 사용자\n\nuserId: 123"
+ */
+export declare class ArgumentError extends SdError {
+    /** 기본 메시지("인수가 잘못되었습니다.")와 함께 인수 객체를 YAML 형식으로 출력 */
+    constructor(argObj: Record<string, unknown>);
+    /** 커스텀 메시지와 함께 인수 객체를 YAML 형식으로 출력 */
+    constructor(message: string, argObj: Record<string, unknown>);
+    constructor(arg1: Record<string, unknown> | string, arg2?: Record<string, unknown>);
+}
+//# sourceMappingURL=argument-error.d.ts.map

package/dist/core-common/src/errors/argument-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argument-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/argument-error.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,qDAAqD;gBACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3C,sCAAsC;gBAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYnF"}

package/dist/core-common/src/errors/not-implemented-error.d.ts

@@ -0,0 +1,29 @@
+import { SdError } from "./sd-error";
+/**
+ * 미구현 오류
+ *
+ * 아직 구현되지 않은 기능을 호출했을 때 발생시키는 에러이다.
+ * 추상 메서드 스텁, 향후 구현 예정인 분기 등에 사용한다.
+ *
+ * @example
+ * // 추상 메서드 구현 전
+ * class BaseService {
+ *   process(): void {
+ *     throw new NotImplementedError("서브클래스에서 구현 필요");
+ *   }
+ * }
+ *
+ * @example
+ * // 향후 구현 예정 분기
+ * switch (type) {
+ *   case "A": return handleA();
+ *   case "B": throw new NotImplementedError(`타입 ${type} 처리`);
+ * }
+ */
+export declare class NotImplementedError extends SdError {
+    /**
+     * @param message 추가 설명 메시지
+     */
+    constructor(message?: string);
+}
+//# sourceMappingURL=not-implemented-error.d.ts.map

package/dist/core-common/src/errors/not-implemented-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-implemented-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/not-implemented-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,mBAAoB,SAAQ,OAAO;IAC9C;;OAEG;gBACS,OAAO,CAAC,EAAE,MAAM;CAI7B"}

package/dist/core-common/src/errors/sd-error.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 오류의 Tree 구조 구성이 가능한 오류 클래스
+ * ES2024 cause 속성 활용
+ *
+ * @example
+ * // 원인 에러를 감싸서 생성
+ * try {
+ *   await fetch(url);
+ * } catch (err) {
+ *   throw new SdError(err, "API 호출 실패", "사용자 로드 실패");
+ * }
+ * // 결과 메시지: "사용자 로드 실패 => API 호출 실패 => 원본 에러 메시지"
+ *
+ * @example
+ * // 메시지만으로 생성
+ * throw new SdError("잘못된 상태", "처리 불가");
+ * // 결과 메시지: "처리 불가 => 잘못된 상태"
+ */
+export declare class SdError extends Error {
+    cause?: Error;
+    /** 원인 에러를 감싸서 생성. 메시지는 역순으로 연결됨 (상위 메시지 => 하위 메시지 => 원인 메시지) */
+    constructor(cause: Error, ...messages: string[]);
+    /** 메시지만으로 생성. 메시지는 역순으로 연결됨 (상위 메시지 => 하위 메시지) */
+    constructor(...messages: string[]);
+    constructor(arg1?: unknown, ...messages: string[]);
+}
+//# sourceMappingURL=sd-error.d.ts.map

package/dist/core-common/src/errors/sd-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/sd-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,OAAQ,SAAQ,KAAK;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IAEvB,gEAAgE;gBACpD,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;IAC/C,kDAAkD;gBACtC,GAAG,QAAQ,EAAE,MAAM,EAAE;gBACrB,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;CA2BlD"}

package/dist/core-common/src/errors/timeout-error.d.ts

@@ -0,0 +1,31 @@
+import { SdError } from "./sd-error";
+/**
+ * 타임아웃 오류
+ *
+ * 대기 시간이 초과되었을 때 발생하는 에러이다.
+ * Wait.until() 등의 비동기 대기 함수에서 최대 시도 횟수를 초과하면 자동으로 발생한다.
+ *
+ * @example
+ * // Wait.until에서 자동 발생
+ * try {
+ *   await Wait.until(() => isReady, 100, 50); // 100ms 간격, 최대 50회
+ * } catch (err) {
+ *   if (err instanceof TimeoutError) {
+ *     console.log("시간 초과");
+ *   }
+ * }
+ *
+ * @example
+ * // 직접 발생
+ * if (elapsed > maxTime) {
+ *   throw new TimeoutError(undefined, "API 응답 대기 초과");
+ * }
+ */
+export declare class TimeoutError extends SdError {
+    /**
+     * @param count 시도 횟수
+     * @param message 추가 메시지
+     */
+    constructor(count?: number, message?: string);
+}
+//# sourceMappingURL=timeout-error.d.ts.map

package/dist/core-common/src/errors/timeout-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/timeout-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAa,SAAQ,OAAO;IACvC;;;OAGG;gBACS,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAM7C"}

package/dist/core-common/src/extensions/arr-ext.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Array 확장 메서드
+ *
+ * @remarks 각 메서드의 TSDoc은 타입 정의 파일(arr-ext.types.ts) 참조
+ */
+import "./map-ext";
+import type { ReadonlyArrayExt, MutableArrayExt } from "./arr-ext.types";
+declare global {
+    interface ReadonlyArray<T> extends ReadonlyArrayExt<T> {
+    }
+    interface Array<T> extends ReadonlyArrayExt<T>, MutableArrayExt<T> {
+    }
+}
+export type { ArrayDiffsResult, ArrayDiffs2Result, TreeArray, ComparableType } from "./arr-ext.types";
+//# sourceMappingURL=arr-ext.d.ts.map

package/dist/core-common/src/extensions/arr-ext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arr-ext.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/extensions/arr-ext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,WAAW,CAAC;AAUnB,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAIhB,MAAM,iBAAiB,CAAC;AA2uBzB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,aAAa,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;KAAG;IACzD,UAAU,KAAK,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;KAAG;CACtE;AAID,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core-common/src/extensions/arr-ext.helpers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Array 확장 헬퍼 함수
+ */
+import type { ComparableType } from "./arr-ext.types";
+/**
+ * DateTime, DateOnly, Time을 비교 가능한 primitive 값으로 변환
+ */
+export declare function toComparable(value: ComparableType): string | number | boolean | undefined;
+/**
+ * 정렬을 위한 비교 함수
+ *
+ * @param pp 비교 대상 1
+ * @param pn 비교 대상 2
+ * @param desc true: 내림차순, false: 오름차순
+ * @returns 음수: pp가 앞, 0: 같음, 양수: pn이 앞
+ * @note null/undefined 값은 오름차순 시 앞으로, 내림차순 시 뒤로 정렬됨
+ */
+export declare function compareForOrder(pp: ComparableType, pn: ComparableType, desc: boolean): number;
+//# sourceMappingURL=arr-ext.helpers.d.ts.map

package/dist/core-common/src/extensions/arr-ext.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arr-ext.helpers.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/extensions/arr-ext.helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAKzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAuB7F"}