@simplysm/sd-cli 14.0.18 → 14.0.21

package/dist/orchestrators/TypecheckOrchestrator.js

@@ -0,0 +1,285 @@
+import ts from "typescript";
+import { err as errNs } from "@simplysm/core-common";
+import { pathx } from "@simplysm/core-node";
+import { consola } from "consola";
+import { loadSdConfig } from "../utils/sd-config.js";
+import { deserializeDiagnostic } from "../utils/typecheck-serialization.js";
+import { createBuildEngine } from "../engines/index.js";
+import { typecheckNonPackageFiles } from "../utils/typecheck-non-package.js";
+import { runWithConcurrency, getMaxConcurrency } from "../utils/concurrency.js";
+import { discoverWorkspacePackages, mergeTestsPackagesIntoConfig } from "../utils/package-utils.js";
+import { toTypecheckEnvs } from "../utils/tsconfig.js";
+//#endregion
+//#region Utilities
+const TARGET_PATH_PATTERN = /^(?:packages|tests)\/([^/]+)/;
+/**
+ * 대상 경로에서 패키지명을 추출한다.
+ * "packages/core-common" → "core-common"
+ * "tests/orm" → "orm"
+ */
+function extractTargetPackageNames(targets) {
+    const names = new Set();
+    for (const target of targets) {
+        const match = target.match(TARGET_PATH_PATTERN);
+        if (match)
+            names.add(match[1]);
+    }
+    return names;
+}
+//#endregion
+//#region TypecheckOrchestrator
+/**
+ * 타입체크를 조율하는 Orchestrator
+ *
+ * BuildOrchestrator/DevWatchOrchestrator와 동일한 initialize() → start() → shutdown() 생명주기를 따른다.
+ * sd.config.ts 기반으로 패키지를 분류하고, BuildEngine을 사용하여 타입체크를 실행한다.
+ */
+export class TypecheckOrchestrator {
+    _cwd;
+    _options;
+    _logger = consola.withTag("sd:cli:typecheck");
+    // initialize()에서 설정되는 내부 상태
+    _typecheckTasks = [];
+    _scriptsPackagePaths = [];
+    _includeNonPackage = false;
+    constructor(options) {
+        this._cwd = process.cwd();
+        this._options = options;
+    }
+    /**
+     * Initialize Orchestrator
+     * - Load sd.config.ts
+     * - Discover workspace packages and merge tests
+     * - Classify packages into typecheck tasks
+     * - Collect scripts package paths
+     */
+    async initialize() {
+        const { targets } = this._options;
+        const phaseLabel = this._options.lint === true ? "타입체크/린트" : "타입체크";
+        this._logger.debug(`${phaseLabel} 시작`, { targets, lint: this._options.lint });
+        // sd.config.ts 로드
+        const sdConfig = await loadSdConfig({ cwd: this._cwd, dev: false, opt: this._options.options });
+        this._logger.debug("sd.config.ts 로드 완료");
+        // 워크스페이스 패키지 탐색 및 tests/를 설정에 병합
+        const workspacePackages = discoverWorkspacePackages(this._cwd);
+        const { merged, pathMap } = mergeTestsPackagesIntoConfig(sdConfig.packages, workspacePackages);
+        // 경로 기반 대상에서 패키지명 결정
+        const targetNames = extractTargetPackageNames(targets);
+        // 타입체크할 패키지 수집 (scripts 제외), env별로 확장
+        for (const [name, config] of Object.entries(merged)) {
+            if (config == null)
+                continue;
+            if (config.target === "scripts") {
+                if (targets.length === 0 || targetNames.has(name)) {
+                    const relPath = pathMap.get(name) ?? `packages/${name}`;
+                    this._scriptsPackagePaths.push(relPath);
+                }
+                continue;
+            }
+            if (targets.length > 0 && !targetNames.has(name))
+                continue;
+            const relPath = pathMap.get(name) ?? `packages/${name}`;
+            // 클라이언트 패키지의 경우 browser 타겟을 사용하여 createBuildEngine이 ViteEngine 대신 NgtscEngine으로 라우팅되도록 함
+            const typecheckConfig = config.target === "client" ? { target: "browser" } : config;
+            const envs = toTypecheckEnvs(config.target);
+            for (const env of envs) {
+                this._typecheckTasks.push({
+                    name,
+                    dir: pathx.posixResolve(this._cwd, relPath),
+                    config: typecheckConfig,
+                    env,
+                });
+            }
+        }
+        // 비패키지 타입체크: 대상이 지정되지 않은 경우에만 (= 전체 검사)
+        this._includeNonPackage = targets.length === 0;
+    }
+    /**
+     * 타입체크 실행
+     * - 엔진 생성 및 동시성 제어된 실행
+     * - 비패키지 타입체크
+     * - 결과 집계 및 포맷 출력 생성
+     *
+     * @returns 타입체크 결과
+     */
+    async start() {
+        const phaseLabel = this._options.lint === true ? "타입체크/린트" : "타입체크";
+        const formatHost = {
+            getCanonicalFileName: (f) => f,
+            getCurrentDirectory: () => this._cwd,
+            getNewLine: () => ts.sys.newLine,
+        };
+        if (this._typecheckTasks.length === 0 && !this._includeNonPackage) {
+            this._logger.info(`${phaseLabel} 대상 없음`);
+            return {
+                success: true,
+                errorCount: 0,
+                warningCount: 0,
+                formattedOutput: `✔ ${phaseLabel} 대상 없음.\n`,
+                scriptsPackagePaths: this._scriptsPackagePaths.length > 0 ? this._scriptsPackagePaths : undefined,
+            };
+        }
+        // 동시성 제한이 있는 BuildEngine 작업 생성
+        const allDiagnostics = [];
+        let totalErrorCount = 0;
+        let totalWarningCount = 0;
+        const fileCache = new Map();
+        // Lint 결과 집계
+        let lintErrorCount = 0;
+        let lintWarningCount = 0;
+        let lintSuccess = true;
+        const lintOutputs = [];
+        if (this._typecheckTasks.length > 0) {
+            const tasks = this._typecheckTasks.map((task) => async () => {
+                const label = `${task.name}:${task.env}`;
+                const engine = createBuildEngine({ name: task.name, dir: task.dir, config: task.config }, { cwd: this._cwd });
+                try {
+                    this._logger.debug(`[${label}] 타입체크 시작됨`);
+                    const result = await engine.run({
+                        js: false,
+                        dts: false,
+                        env: task.env,
+                        includeTests: true,
+                        ...(this._options.lint === true ? { lint: true } : {}),
+                    });
+                    this._logger.debug(`[${label}] 타입체크 ${result.build.success ? "완료" : "실패"}`);
+                    return result;
+                }
+                catch (err) {
+                    const message = errNs.message(err);
+                    const stack = err instanceof Error ? err.stack : undefined;
+                    this._logger.error(`[${label}] 엔진 작업 실패: ${message}`);
+                    if (stack != null) {
+                        this._logger.debug(`[${label}] 스택 트레이스:\n${stack}`);
+                    }
+                    return {
+                        build: {
+                            success: false,
+                            errors: [`[${label}] ${message}`],
+                            warnings: [],
+                            diagnostics: [],
+                        },
+                    };
+                }
+                finally {
+                    await engine.stop();
+                }
+            });
+            const concurrency = getMaxConcurrency();
+            this._logger.start(`${phaseLabel} 실행 중... (${tasks.length}개 작업, 동시성: ${concurrency})`);
+            const results = await runWithConcurrency(tasks, concurrency);
+            this._logger.success(`${phaseLabel} 실행 완료`);
+            // 엔진 결과 집계 (모든 task는 catch로 인해 항상 fulfilled)
+            for (const settled of results) {
+                if (settled.status !== "fulfilled")
+                    continue;
+                const engineResult = settled.value;
+                const buildDiags = engineResult.build.diagnostics.map((d) => deserializeDiagnostic(d, fileCache));
+                allDiagnostics.push(...buildDiags);
+                // 역직렬화된 진단 정보에서 에러/경고 수 집계
+                // 숫자 카테고리 값 사용 (ts.DiagnosticCategory: Error=1, Warning=0)
+                totalErrorCount += buildDiags.filter((d) => d.category === 1).length;
+                totalWarningCount += buildDiags.filter((d) => d.category === 0).length;
+                if (!engineResult.build.success && buildDiags.length === 0) {
+                    for (const errMsg of engineResult.build.errors) {
+                        allDiagnostics.push({
+                            category: 1,
+                            code: 0,
+                            messageText: errMsg,
+                            file: undefined,
+                            start: undefined,
+                            length: undefined,
+                        });
+                    }
+                    totalErrorCount += engineResult.build.errors.length || 1;
+                }
+                // Lint 결과 수집
+                if (engineResult.lint != null) {
+                    lintErrorCount += engineResult.lint.errorCount;
+                    lintWarningCount += engineResult.lint.warningCount;
+                    if (!engineResult.lint.success)
+                        lintSuccess = false;
+                    if (engineResult.lint.formattedOutput !== "") {
+                        lintOutputs.push(engineResult.lint.formattedOutput);
+                    }
+                }
+            }
+        }
+        // 비패키지 타입체크
+        if (this._includeNonPackage) {
+            this._logger.debug("비패키지 타입체크 실행 중");
+            const nonPkgResult = typecheckNonPackageFiles(this._cwd);
+            totalErrorCount += nonPkgResult.errorCount;
+            totalWarningCount += nonPkgResult.warningCount;
+            const nonPkgDiags = nonPkgResult.diagnostics.map((d) => deserializeDiagnostic(d, fileCache));
+            allDiagnostics.push(...nonPkgDiags);
+        }
+        // 요약 로그
+        const resultMeta = {
+            errorCount: totalErrorCount,
+            warningCount: totalWarningCount,
+        };
+        if (this._options.lint === true) {
+            resultMeta["lintErrorCount"] = lintErrorCount;
+            resultMeta["lintWarningCount"] = lintWarningCount;
+        }
+        if (totalErrorCount > 0) {
+            this._logger.error(`${phaseLabel} 에러 발생`, resultMeta);
+        }
+        else {
+            this._logger.info(`${phaseLabel} 완료`, resultMeta);
+        }
+        // 진단 출력 포매팅
+        let formattedOutput = "";
+        if (allDiagnostics.length > 0) {
+            const uniqueDiagnostics = ts.sortAndDeduplicateDiagnostics(allDiagnostics);
+            formattedOutput = ts.formatDiagnosticsWithColorAndContext(uniqueDiagnostics, formatHost);
+        }
+        // lint가 요청된 경우 lint 결과 생성
+        const lintResult = this._options.lint === true
+            ? {
+                success: lintSuccess,
+                errorCount: lintErrorCount,
+                warningCount: lintWarningCount,
+                formattedOutput: lintOutputs.join("\n"),
+            }
+            : undefined;
+        return {
+            success: totalErrorCount === 0,
+            errorCount: totalErrorCount,
+            warningCount: totalWarningCount,
+            formattedOutput,
+            lint: lintResult,
+            scriptsPackagePaths: this._scriptsPackagePaths.length > 0 ? this._scriptsPackagePaths : undefined,
+        };
+    }
+    /**
+     * Orchestrator 종료 (현재 정리할 리소스 없음)
+     */
+    async shutdown() {
+        // 타입체크는 일회성 작업이므로 종료 시 정리할 리소스가 없음
+        // 엔진은 각 작업 내에서 stop()으로 정리됨
+        await Promise.resolve();
+    }
+}
+//#endregion
+//#region Convenience Function
+/**
+ * TypecheckOrchestrator의 전체 생명주기를 래핑한 편의 함수.
+ * initialize() → start() → shutdown() 순서로 호출한다.
+ *
+ * @param options - 타입체크 실행 옵션
+ * @returns 타입체크 결과
+ */
+export async function executeTypecheck(options) {
+    const orchestrator = new TypecheckOrchestrator(options);
+    await orchestrator.initialize();
+    try {
+        return await orchestrator.start();
+    }
+    finally {
+        await orchestrator.shutdown();
+    }
+}
+//#endregion
+//# sourceMappingURL=TypecheckOrchestrator.js.map

package/dist/orchestrators/TypecheckOrchestrator.js.map

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

package/dist/sd-cli.js

@@ -6,6 +6,7 @@
  * .js 실행 (프로덕션): replaceDeps 실행 후 새 프로세스에서 sd-cli-entry 실행
  */
 import { cpx } from "@simplysm/core-node";
+import { consola } from "consola";
 import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
@@ -31,8 +32,12 @@ else {
             await setupReplaceDeps(process.cwd(), sdConfig.replaceDeps);
         }
     }
-    catch {
+    catch (err) {
         // sd.config.ts가 없거나 replaceDeps가 설정되지 않으면 건너뜀
+        const code = err instanceof Error && "code" in err ? err.code : undefined;
+        if (code !== "MODULE_NOT_FOUND" && code !== "ERR_MODULE_NOT_FOUND") {
+            consola.warn("[sd-cli] replaceDeps 사전 설정 실패:", err instanceof Error ? err.message : err);
+        }
     }
     // Phase 2: 실제 CLI를 새 프로세스로 실행 (모듈 캐시 초기화)
     const cliEntryFilePath = path.join(__dirname, "sd-cli-entry.js");

package/dist/sd-cli.js.map

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

package/dist/utils/lint-core.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ESLint 실행 옵션
+ */
+export interface LintOptions {
+    /** 린트 대상 경로 필터 (예: `packages/core-common`). 빈 배열이면 전체 대상 */
+    targets: string[];
+    /** 자동 수정 활성화 */
+    fix: boolean;
+    /** ESLint 규칙별 실행 시간 측정 활성화 (TIMING 환경변수 설정) */
+    timing: boolean;
+}
+/**
+ * executeLint()의 반환 타입
+ */
+export interface LintResult {
+    /** 린트 에러가 없으면 true */
+    success: boolean;
+    /** ESLint 전체 에러 수 */
+    errorCount: number;
+    /** ESLint 전체 경고 수 */
+    warningCount: number;
+    /** 포매터 출력 문자열 (stdout에 출력할 내용) */
+    formattedOutput: string;
+}
+/**
+ * eslint.config.ts/js에서 globalIgnores 패턴을 추출한다.
+ * ignores만 있고 files가 없는 설정 객체가 globalIgnores이다.
+ * @internal 테스트용으로 export
+ */
+export declare function loadIgnorePatterns(cwd: string): Promise<string[]>;
+/**
+ * ESLint를 실행하고 결과를 반환한다.
+ *
+ * - `eslint.config.ts/js`에서 globalIgnores 패턴을 추출하여 glob 필터링에 적용
+ * - consola를 사용하여 진행 상황 표시
+ * - 캐시 활성화 (`.cache/eslint.cache`에 저장, 설정 변경 시 자동 무효화)
+ * - stdout 출력이나 process.exitCode 설정 없음 (호출자가 결정)
+ *
+ * @param options - 린트 실행 옵션
+ * @returns 린트 결과 (성공 여부, 에러/경고 수, 포매터 출력)
+ */
+export declare function executeLint(options: LintOptions): Promise<LintResult>;
+//# sourceMappingURL=lint-core.d.ts.map

package/dist/utils/lint-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-core.d.ts","sourceRoot":"","sources":["../../src/utils/lint-core.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;CACzB;AA0BD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuCvE;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAkF3E"}

package/dist/utils/lint-core.js

@@ -0,0 +1,154 @@
+import { ESLint } from "eslint";
+import { createJiti } from "jiti";
+import path from "path";
+import { fsx, pathx } from "@simplysm/core-node";
+import { env, SdError } from "@simplysm/core-common";
+import { consola } from "consola";
+//#endregion
+//#region Utilities
+/** ESLint 설정 파일 검색 순서 */
+const ESLINT_CONFIG_FILES = [
+    "eslint.config.ts",
+    "eslint.config.mts",
+    "eslint.config.js",
+    "eslint.config.mjs",
+];
+/**
+ * ESLint 설정 객체가 ignores 속성만 가지고 있는지 확인하는 타입 가드
+ */
+function isGlobalIgnoresConfig(item) {
+    if (item == null || typeof item !== "object")
+        return false;
+    if (!("ignores" in item))
+        return false;
+    if ("files" in item)
+        return false; // files가 있으면 globalIgnores가 아님
+    const ignores = item.ignores;
+    if (!Array.isArray(ignores))
+        return false;
+    return ignores.every((i) => typeof i === "string");
+}
+/**
+ * eslint.config.ts/js에서 globalIgnores 패턴을 추출한다.
+ * ignores만 있고 files가 없는 설정 객체가 globalIgnores이다.
+ * @internal 테스트용으로 export
+ */
+export async function loadIgnorePatterns(cwd) {
+    let configPath;
+    for (const f of ESLINT_CONFIG_FILES) {
+        const p = path.join(cwd, f);
+        if (await fsx.exists(p)) {
+            configPath = p;
+            break;
+        }
+    }
+    if (configPath == null) {
+        throw new SdError(`ESLint 설정 파일을 찾을 수 없습니다 (cwd: ${cwd}): ${ESLINT_CONFIG_FILES.join(", ")}`);
+    }
+    const jiti = createJiti(import.meta.url);
+    const configModule = await jiti.import(configPath);
+    let configs;
+    if (Array.isArray(configModule)) {
+        configs = configModule;
+    }
+    else if (configModule != null &&
+        typeof configModule === "object" &&
+        "default" in configModule) {
+        configs = configModule.default;
+    }
+    else {
+        throw new SdError(`ESLint 설정 파일의 형식이 올바르지 않습니다: ${configPath}`);
+    }
+    if (!Array.isArray(configs)) {
+        throw new SdError(`ESLint 설정이 배열이 아닙니다: ${configPath}`);
+    }
+    return configs.filter(isGlobalIgnoresConfig).flatMap((item) => item.ignores);
+}
+//#endregion
+//#region Main
+/**
+ * ESLint를 실행하고 결과를 반환한다.
+ *
+ * - `eslint.config.ts/js`에서 globalIgnores 패턴을 추출하여 glob 필터링에 적용
+ * - consola를 사용하여 진행 상황 표시
+ * - 캐시 활성화 (`.cache/eslint.cache`에 저장, 설정 변경 시 자동 무효화)
+ * - stdout 출력이나 process.exitCode 설정 없음 (호출자가 결정)
+ *
+ * @param options - 린트 실행 옵션
+ * @returns 린트 결과 (성공 여부, 에러/경고 수, 포매터 출력)
+ */
+export async function executeLint(options) {
+    const { targets, fix, timing } = options;
+    const cwd = process.cwd();
+    const logger = consola.withTag("sd:cli:lint");
+    logger.debug("린트 시작", { targets, fix, timing });
+    // TIMING 환경변수 설정
+    if (timing) {
+        env("TIMING", "1");
+    }
+    // ESLint 설정 로드
+    logger.start("ESLint 설정 로딩 중");
+    const ignorePatterns = await loadIgnorePatterns(cwd);
+    logger.debug("무시 패턴 로드 완료", { ignorePatternCount: ignorePatterns.length });
+    logger.success(`ESLint 설정 로드 완료 (${ignorePatterns.length}개 무시 패턴)`);
+    // 린트 대상 파일 수집
+    logger.start("린트 대상 파일 수집 중");
+    let files = await fsx.glob("**/*.{ts,js,mjs,cjs}", {
+        cwd,
+        ignore: ignorePatterns,
+        nodir: true,
+        absolute: true,
+    });
+    files = pathx.filterByTargets(files, targets, cwd);
+    logger.debug("파일 수집 완료", { fileCount: files.length });
+    logger.success(`린트 대상 파일 수집 완료 (${files.length}개 파일)`);
+    // 린트 실행
+    let eslint;
+    let eslintResults;
+    if (files.length > 0) {
+        logger.start(`린트 실행 중... (${files.length}개 파일)`);
+        eslint = new ESLint({
+            cwd,
+            fix,
+            cache: true,
+            cacheLocation: path.join(cwd, ".cache", "eslint.cache"),
+        });
+        eslintResults = await eslint.lintFiles(files);
+        logger.success("린트 실행 완료");
+        // 자동 수정 적용
+        if (fix) {
+            logger.debug("자동 수정 적용 중...");
+            await ESLint.outputFixes(eslintResults);
+            logger.debug("자동 수정 적용 완료");
+        }
+    }
+    // 파일이 없거나 린트가 실행되지 않은 경우 성공 결과 반환
+    if (files.length === 0 || eslintResults == null || eslint == null) {
+        logger.info("린트할 파일 없음");
+        return { success: true, errorCount: 0, warningCount: 0, formattedOutput: "" };
+    }
+    // 결과 집계
+    let errorCount = eslintResults.sum((r) => r.errorCount);
+    let warningCount = eslintResults.sum((r) => r.warningCount);
+    if (errorCount > 0) {
+        logger.error("린트 에러 발생", { errorCount, warningCount });
+    }
+    else {
+        logger.info("린트 완료", { errorCount, warningCount });
+    }
+    // 포매터 출력 수집
+    let formattedOutput = "";
+    const formatter = await eslint.loadFormatter("stylish");
+    const resultText = await formatter.format(eslintResults);
+    if (resultText) {
+        formattedOutput += resultText;
+    }
+    return {
+        success: errorCount === 0,
+        errorCount,
+        warningCount,
+        formattedOutput,
+    };
+}
+//#endregion
+//# sourceMappingURL=lint-core.js.map

package/dist/utils/lint-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-core.js","sourceRoot":"","sources":["../../src/utils/lint-core.ts"],"names":[],"mappings":"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"}

package/dist/utils/lint-utils.d.ts

@@ -1,4 +1,4 @@
-import type { LintOptions, LintResult } from "../commands/lint";
+import type { LintOptions, LintResult } from "./lint-core";
 /**
  * lint Worker를 생성하고 실행한 뒤 terminate하는 공통 유틸.
  * BuildOrchestrator.start()와 check.ts에서 호출한다.

package/dist/utils/lint-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lint-utils.d.ts","sourceRoot":"","sources":["../../src/utils/lint-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGhE;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ/E"}
+{"version":3,"file":"lint-utils.d.ts","sourceRoot":"","sources":["../../src/utils/lint-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG3D;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ/E"}

package/dist/utils/server-production-files.d.ts

@@ -0,0 +1,22 @@
+import type { ServerBuildInfo } from "../workers/server-build.worker";
+/**
+ * 세 가지 소스에서 외부 모듈을 수집하고 병합한다.
+ * collectAllDependencyExternals를 통한 단일 패스 의존성 트리 순회를 사용한다.
+ */
+export declare function collectAllExternals(pkgDir: string, manualExternals?: string[]): string[];
+/**
+ * pnpm-lock.yaml의 packages 섹션을 파싱하여 name→version 맵을 생성한다.
+ * Lockfile v9 형식: `packages:` 섹션의 `'name@version':` 키를 파싱한다.
+ * YAML 파서 의존성을 피하기 위해 단순 라인 기반 파싱을 사용한다.
+ */
+export declare function parseLockfileVersions(cwd: string): Map<string, string>;
+/**
+ * pnpm-lock.yaml에서 주어진 모든 패키지의 잠긴 버전을 확인한다.
+ * lockfile에서 패키지를 찾을 수 없으면 에러를 던진다.
+ */
+export declare function resolveLockedVersions(cwd: string, pkgNames: string[]): Record<string, string>;
+/**
+ * 프로덕션 배포용 파일을 생성한다
+ */
+export declare function generateProductionFiles(info: ServerBuildInfo, externals: string[]): void;
+//# sourceMappingURL=server-production-files.d.ts.map

package/dist/utils/server-production-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-production-files.d.ts","sourceRoot":"","sources":["../../src/utils/server-production-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAStE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAMxF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAmCtE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAc7F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,EAAE,GAClB,IAAI,CAgGN"}