@fluojs/cli 1.0.0-beta.2 → 1.0.0-beta.3

package/README.ko.md

@@ -30,12 +30,12 @@ pnpm dlx @fluojs/cli new my-app
 ## 릴리스 계약
 
 - `@fluojs/cli`는 intended publish surface에 포함되는 공개 패키지입니다.
-- 지원되는 설치 경로는 전역 패키지(`pnpm add -g @fluojs/cli`)와 무설치 실행 경로(`pnpm dlx @fluojs/cli ...`)입니다.
+- 지원되는 설치 경로는 전역 패키지(`npm install -g @fluojs/cli`, `pnpm add -g @fluojs/cli`, `bun add -g @fluojs/cli`, `yarn global add @fluojs/cli`)와 무설치 실행 경로(`pnpm dlx @fluojs/cli ...`)입니다.
 - 배포되는 `fluo` bin은 `package.json`에 선언된 dist 빌드 CLI 엔트리포인트를 기준으로 동작합니다.
 
 ## 업데이트 확인
 
-`fluo`가 interactive TTY에서 실행되면 로컬 캐시를 사용해 공개 npm `latest` dist-tag의 `@fluojs/cli` 버전을 확인하므로 매 invocation마다 registry를 호출하지 않습니다. 더 새로운 버전이 있으면 CLI가 설치 여부를 묻습니다. 거절하면 현재 설치된 버전으로 기존 명령을 계속 실행하고, 승인하면 `pnpm add -g @fluojs/cli@<latest>`를 실행한 뒤 같은 인자로 업데이트된 `fluo` 바이너리를 다시 시작합니다.
+`fluo`가 interactive TTY에서 실행되면 로컬 캐시를 사용해 공개 npm `latest` dist-tag의 `@fluojs/cli` 버전을 확인하므로 매 invocation마다 registry를 호출하지 않습니다. 더 새로운 버전이 있으면 CLI가 설치 여부를 묻습니다. 거절하면 현재 설치된 버전으로 기존 명령을 계속 실행하고, 승인하면 현재 설치를 소유한 것으로 보이는 package manager의 전역 업데이트 명령(`npm install -g`, `pnpm add -g`, `bun add -g`, `yarn global add`)을 사용한 뒤 같은 인자로 업데이트된 `fluo` 바이너리를 다시 시작합니다. 설치 도구를 추론할 수 없으면 Node.js 기본 전역 설치 경로를 소유하는 npm 기준으로 `npm install -g @fluojs/cli@<latest>`를 fallback으로 사용합니다.
 
 업데이트 확인은 CI, non-TTY 출력, npm-script context, 업데이트 후 재실행 context, registry/network 실패, 명시적 opt-out 경로에서는 건너뜁니다. 한 번만 끄려면 `--no-update-check`(또는 compatibility alias `--no-update-notifier`)를 사용하고, 자동화에서 절대 prompt가 뜨면 안 되는 경우에는 `FLUO_NO_UPDATE_CHECK=1`을 설정하세요.
 
@@ -184,8 +184,11 @@ Studio가 없으면 CI와 non-interactive 실행은 prompt나 package manager
 |---|---|
 | `runCli(argv?, options?)` | 모든 CLI 명령을 실행하는 메인 진입점입니다. |
 | `runNewCommand(argv, options?)` | 프로젝트 스캐폴딩 로직에 대한 프로그래밍적 접근을 제공합니다. |
+| `CliPromptCancelledError` | 호출자가 제공한 prompt hook이 정상 취소를 알리기 위해 throw할 수 있는 안정적인 sentinel입니다. |
 | `GeneratorKind` | 지원되는 모든 생성기 유형(예: `'controller'`, `'service'`)의 유니온 타입입니다. |
 
+프로그래밍 방식 진입점은 호출자 프로세스의 소유권을 보존합니다. `runCli(...)`와 `runNewCommand(...)`는 `process.exit(...)`를 호출하지 않고 숫자 exit code를 반환하며, prompt 취소는 command runner를 통해 exit code `0`으로 해석됩니다. dependency 설치나 git 초기화 같은 setup 작업은 해석된 `fluo new` 옵션이 요청한 경우에만 실행됩니다. 호출자가 제공한 prompt hook은 공개 패키지 엔트리포인트의 `CliPromptCancelledError`를 throw해 CLI 내부 파일에 의존하지 않고 정상 취소를 표현할 수 있습니다.
+
 ## 관련 패키지
 
 - **[@fluojs/runtime](../runtime/README.ko.md)**: 부트스트랩 안전 런타임 검사 중 inspection snapshot을 생산하는 기본 엔진입니다.

package/README.md

@@ -30,12 +30,12 @@ pnpm dlx @fluojs/cli new my-app
 ## Release Contract
 
 - `@fluojs/cli` is a public package in the intended publish surface.
-- The supported install paths are the global package (`pnpm add -g @fluojs/cli`) and the no-install runner (`pnpm dlx @fluojs/cli ...`).
+- The supported install paths are the global package (`npm install -g @fluojs/cli`, `pnpm add -g @fluojs/cli`, `bun add -g @fluojs/cli`, or `yarn global add @fluojs/cli`) and the no-install runner (`pnpm dlx @fluojs/cli ...`).
 - The published `fluo` bin is backed by the dist-built CLI entrypoint declared in `package.json`.
 
 ## Update Checks
 
-When `fluo` runs in an interactive TTY, it checks the public npm `latest` dist-tag for `@fluojs/cli` using a local cache so every invocation does not hit the registry. If a newer version is available, the CLI asks whether to install it. Declining continues the current command with the installed version; accepting runs `pnpm add -g @fluojs/cli@<latest>` and then restarts `fluo` with the same arguments under the updated binary.
+When `fluo` runs in an interactive TTY, it checks the public npm `latest` dist-tag for `@fluojs/cli` using a local cache so every invocation does not hit the registry. If a newer version is available, the CLI asks whether to install it. Declining continues the current command with the installed version; accepting updates the global CLI with the package manager that appears to own the current installation (`npm install -g`, `pnpm add -g`, `bun add -g`, or `yarn global add`) and then restarts `fluo` with the same arguments under the updated binary. If the installer cannot be inferred, the CLI falls back to `npm install -g @fluojs/cli@<latest>` because npm owns the default Node.js global installation path.
 
 The update check is skipped in CI, non-TTY output, npm-script contexts, rerun-after-update contexts, registry/network failures, and explicit opt-out paths. Use `--no-update-check` (or the compatibility alias `--no-update-notifier`) for one invocation, or set `FLUO_NO_UPDATE_CHECK=1` when automation must never prompt.
 
@@ -184,8 +184,11 @@ The package can be used programmatically to trigger CLI actions from within othe
 |---|---|
 | `runCli(argv?, options?)` | Main entry point to execute any CLI command. |
 | `runNewCommand(argv, options?)` | Programmatic access to the project scaffolding logic. |
+| `CliPromptCancelledError` | Stable sentinel that caller-supplied prompt hooks can throw to report normal cancellation. |
 | `GeneratorKind` | Union type of all supported generator types (e.g., `'controller'`, `'service'`). |
 
+Programmatic entry points preserve caller process ownership. `runCli(...)` and `runNewCommand(...)` return numeric exit codes instead of calling `process.exit(...)`; prompt cancellation resolves as exit code `0` through the command runner, and setup actions such as dependency installation or git initialization only run when the resolved `fluo new` options request them. Caller-supplied prompt hooks can throw `CliPromptCancelledError` from the public package entrypoint to express normal cancellation without depending on CLI-internal files.
+
 ## Related Packages
 
 - **[@fluojs/runtime](../runtime/README.md)**: The underlying engine that produces inspection snapshots during bootstrap-safe runtime inspection.

package/dist/commands/inspect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAMA,OAAO,EAML,KAAK,qBAAqB,EAE3B,MAAM,iBAAiB,CAAC;AAIzB,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,KAAK,qBAAqB,GAAG,CAAC,QAAQ,EAAE,qBAAqB,KAAK,MAAM,CAAC;AAEzE,KAAK,2BAA2B,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,yEAAyE;IACzE,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yEAAyE;IACzE,yBAAyB,CAAC,EAAE,2BAA2B,CAAC;IACxD,wFAAwF;IACxF,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,sCAAsC;IACtC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,yCAAyC;IACzC,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAkFD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAarC;AA+PD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,MAAM,CAAC,CAwEnH"}
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAMA,OAAO,EAML,KAAK,qBAAqB,EAE3B,MAAM,iBAAiB,CAAC;AAKzB,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,KAAK,qBAAqB,GAAG,CAAC,QAAQ,EAAE,qBAAqB,KAAK,MAAM,CAAC;AAEzE,KAAK,2BAA2B,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,yEAAyE;IACzE,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yEAAyE;IACzE,yBAAyB,CAAC,EAAE,2BAA2B,CAAC;IACxD,wFAAwF;IACxF,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,sCAAsC;IACtC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,yCAAyC;IACzC,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAkFD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAarC;AA+PD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,MAAM,CAAC,CA4EnH"}

package/dist/commands/inspect.js

@@ -5,6 +5,7 @@ import { pathToFileURL } from 'node:url';
 import * as clack from '@clack/prompts';
 import { FluoFactory, PLATFORM_SHELL } from '@fluojs/runtime';
 import { renderAliasList, renderHelpTable } from '../help.js';
+import { CliPromptCancelledError, isCliPromptCancelledError } from '../prompt-cancel.js';
 
 /**
  * Runtime options for the inspect command when used programmatically.
@@ -210,7 +211,7 @@ function createInspectPrompter() {
       });
       if (clack.isCancel(result)) {
         clack.cancel('Operation cancelled.');
-        process.exit(0);
+        throw new CliPromptCancelledError();
       }
       return result;
     }
@@ -332,6 +333,9 @@ export async function runInspectCommand(argv, runtime = {}) {
     }
     return 0;
   } catch (error) {
+    if (isCliPromptCancelledError(error)) {
+      return 0;
+    }
     const message = error instanceof Error ? error.message : String(error);
     stderr.write(`${message}\n`);
     return 1;

package/dist/commands/new.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAMA,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAWnF,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAuBF;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA0UD;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CA0BjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,CAwG3G"}
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAOA,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAWnF,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAuBF;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA0UD;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CA0BjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,CA4G3G"}

package/dist/commands/new.js

@@ -1,6 +1,7 @@
 import { resolve } from 'node:path';
 import { spinner as clackSpinner, log as clackLog } from '@clack/prompts';
 import { renderAliasList, renderHelpTable } from '../help.js';
+import { isCliPromptCancelledError } from '../prompt-cancel.js';
 import { installDependencies } from '../new/install.js';
 import { collectBootstrapAnswers } from '../new/prompt.js';
 import { resolveBootstrapPlan } from '../new/resolver.js';
@@ -366,6 +367,9 @@ export async function runNewCommand(argv, runtime = {}) {
     stdout.write(`Next steps:\n  cd ${answers.targetDirectory}\n  ${answers.packageManager === 'npm' ? 'npm run dev' : answers.packageManager === 'bun' ? 'bun run dev' : `${answers.packageManager} dev`}\n`);
     return 0;
   } catch (error) {
+    if (isCliPromptCancelledError(error)) {
+      return 0;
+    }
     const message = error instanceof Error ? error.message : String(error);
     stderr.write(`${message}\n`);
     return 1;

package/dist/generators/controller.d.ts

@@ -1,3 +1,10 @@
 import type { GenerateOptions, GeneratedFile } from '../types.js';
+/**
+ * Generate controller files.
+ *
+ * @param name The name.
+ * @param options The options.
+ * @returns The generate controller files result.
+ */
 export declare function generateControllerFiles(name: string, options?: GenerateOptions): GeneratedFile[];
 //# sourceMappingURL=controller.d.ts.map

package/dist/generators/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/generators/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKlE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,aAAa,EAAE,CAkBpG"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/generators/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKlE;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,aAAa,EAAE,CAkBpG"}

package/dist/generators/controller.js

@@ -1,5 +1,13 @@
 import { renderTemplate } from './render.js';
 import { toKebabCase, toPascalCase } from './utils.js';
+
+/**
+ * Generate controller files.
+ *
+ * @param name The name.
+ * @param options The options.
+ * @returns The generate controller files result.
+ */
 export function generateControllerFiles(name, options = {}) {
   const kebab = toKebabCase(name);
   const resource = toPascalCase(name);

package/dist/generators/guard.d.ts

@@ -1,3 +1,9 @@
 import type { GeneratedFile } from '../types.js';
+/**
+ * Generate guard files.
+ *
+ * @param name The name.
+ * @returns The generate guard files result.
+ */
 export declare function generateGuardFiles(name: string): GeneratedFile[];
 //# sourceMappingURL=guard.d.ts.map

package/dist/generators/guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/generators/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAShE"}
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/generators/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAShE"}

package/dist/generators/guard.js

@@ -1,5 +1,12 @@
 import { renderTemplate } from './render.js';
 import { toKebabCase, toPascalCase } from './utils.js';
+
+/**
+ * Generate guard files.
+ *
+ * @param name The name.
+ * @returns The generate guard files result.
+ */
 export function generateGuardFiles(name) {
   const kebab = toKebabCase(name);
   const resource = toPascalCase(name);

package/dist/generators/interceptor.d.ts

@@ -1,3 +1,9 @@
 import type { GeneratedFile } from '../types.js';
+/**
+ * Generate interceptor files.
+ *
+ * @param name The name.
+ * @returns The generate interceptor files result.
+ */
 export declare function generateInterceptorFiles(name: string): GeneratedFile[];
 //# sourceMappingURL=interceptor.d.ts.map

package/dist/generators/interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/generators/interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAStE"}
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/generators/interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAStE"}

package/dist/generators/interceptor.js

@@ -1,5 +1,12 @@
 import { renderTemplate } from './render.js';
 import { toKebabCase, toPascalCase } from './utils.js';
+
+/**
+ * Generate interceptor files.
+ *
+ * @param name The name.
+ * @returns The generate interceptor files result.
+ */
 export function generateInterceptorFiles(name) {
   const kebab = toKebabCase(name);
   const resource = toPascalCase(name);

package/dist/generators/middleware.d.ts

@@ -1,3 +1,9 @@
 import type { GeneratedFile } from '../types.js';
+/**
+ * Generate middleware files.
+ *
+ * @param name The name.
+ * @returns The generate middleware files result.
+ */
 export declare function generateMiddlewareFiles(name: string): GeneratedFile[];
 //# sourceMappingURL=middleware.d.ts.map

package/dist/generators/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/generators/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CASrE"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/generators/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CASrE"}

package/dist/generators/middleware.js

@@ -1,5 +1,12 @@
 import { renderTemplate } from './render.js';
 import { toKebabCase, toPascalCase } from './utils.js';
+
+/**
+ * Generate middleware files.
+ *
+ * @param name The name.
+ * @returns The generate middleware files result.
+ */
 export function generateMiddlewareFiles(name) {
   const kebab = toKebabCase(name);
   const resource = toPascalCase(name);

package/dist/generators/module.d.ts

@@ -1,6 +1,28 @@
 import type { GeneratedFile } from '../types.js';
 import type { ModuleArrayKey } from './manifest.js';
+/**
+ * Ensure module import.
+ *
+ * @param source The source.
+ * @param className The class name.
+ * @param importPath The import path.
+ * @returns The ensure module import result.
+ */
 export declare function ensureModuleImport(source: string, className: string, importPath: string): string;
+/**
+ * Generate module files.
+ *
+ * @param name The name.
+ * @returns The generate module files result.
+ */
 export declare function generateModuleFiles(name: string): GeneratedFile[];
+/**
+ * Register in module.
+ *
+ * @param source The source.
+ * @param arrayKey The array key.
+ * @param className The class name.
+ * @returns The register in module result.
+ */
 export declare function registerInModule(source: string, arrayKey: ModuleArrayKey, className: string): string;
 //# sourceMappingURL=module.d.ts.map

package/dist/generators/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/generators/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA6FpD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyDhG;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAUjE;AAwDD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpG"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/generators/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA6FpD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyDhG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAUjE;AAwDD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpG"}

package/dist/generators/module.js

@@ -64,6 +64,15 @@ function findNamedImportSource(sourceFile, className) {
 function buildImportDeclaration(className, importPath) {
   return ts.factory.createImportDeclaration(undefined, ts.factory.createImportClause(false, undefined, ts.factory.createNamedImports([ts.factory.createImportSpecifier(false, undefined, ts.factory.createIdentifier(className))])), ts.factory.createStringLiteral(`./${importPath}`));
 }
+
+/**
+ * Ensure module import.
+ *
+ * @param source The source.
+ * @param className The class name.
+ * @param importPath The import path.
+ * @returns The ensure module import result.
+ */
 export function ensureModuleImport(source, className, importPath) {
   const sourceFile = parseSource(source);
   const moduleSpecifier = `./${importPath}`;
@@ -96,6 +105,13 @@ export function ensureModuleImport(source, className, importPath) {
   }
   return `${newImportLine}\n${source}`;
 }
+
+/**
+ * Generate module files.
+ *
+ * @param name The name.
+ * @returns The generate module files result.
+ */
 export function generateModuleFiles(name) {
   const kebab = toKebabCase(name);
   const pascal = `${toPascalCase(name)}Module`;
@@ -138,6 +154,15 @@ function insertIntoModuleArray(source, arrayKey, className) {
   const updatedModuleMetadata = ts.factory.updateObjectLiteralExpression(moduleMetadata, updatedProperties);
   return replaceNodeText(source, sourceFile, moduleMetadata, printer.printNode(ts.EmitHint.Unspecified, updatedModuleMetadata, sourceFile));
 }
+
+/**
+ * Register in module.
+ *
+ * @param source The source.
+ * @param arrayKey The array key.
+ * @param className The class name.
+ * @returns The register in module result.
+ */
 export function registerInModule(source, arrayKey, className) {
   return insertIntoModuleArray(source, arrayKey, className);
 }

package/dist/generators/render.d.ts

@@ -1,2 +1,9 @@
+/**
+ * Render template.
+ *
+ * @param templateName The template name.
+ * @param vars The vars.
+ * @returns The render template result.
+ */
 export declare function renderTemplate(templateName: string, vars: Record<string, unknown>): string;
 //# sourceMappingURL=render.d.ts.map

package/dist/generators/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/generators/render.ts"],"names":[],"mappings":"AAQA,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAU1F"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/generators/render.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAU1F"}

package/dist/generators/render.js

@@ -4,6 +4,14 @@ import { fileURLToPath } from 'node:url';
 import ejs from 'ejs';
 const templatesDir = join(dirname(fileURLToPath(import.meta.url)), 'templates');
 const templateCache = new Map();
+
+/**
+ * Render template.
+ *
+ * @param templateName The template name.
+ * @param vars The vars.
+ * @returns The render template result.
+ */
 export function renderTemplate(templateName, vars) {
   const templatePath = join(templatesDir, templateName);
   let template = templateCache.get(templatePath);

package/dist/generators/repository.d.ts

@@ -1,3 +1,10 @@
 import type { GenerateOptions, GeneratedFile } from '../types.js';
+/**
+ * Generate repo files.
+ *
+ * @param name The name.
+ * @param _options The options.
+ * @returns The generate repo files result.
+ */
 export declare function generateRepoFiles(name: string, _options?: GenerateOptions): GeneratedFile[];
 //# sourceMappingURL=repository.d.ts.map

package/dist/generators/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/generators/repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKlE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,eAAoB,GAAG,aAAa,EAAE,CAmB/F"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/generators/repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKlE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,eAAoB,GAAG,aAAa,EAAE,CAmB/F"}

package/dist/generators/repository.js

@@ -1,5 +1,13 @@
 import { renderTemplate } from './render.js';
 import { toKebabCase, toPascalCase } from './utils.js';
+
+/**
+ * Generate repo files.
+ *
+ * @param name The name.
+ * @param _options The options.
+ * @returns The generate repo files result.
+ */
 export function generateRepoFiles(name, _options = {}) {
   const kebab = toKebabCase(name);
   const resource = toPascalCase(name);

package/dist/generators/request-dto.d.ts

@@ -1,3 +1,9 @@
 import type { GeneratedFile } from '../types.js';
+/**
+ * Generate request dto files.
+ *
+ * @param name The name.
+ * @returns The generate request dto files result.
+ */
 export declare function generateRequestDtoFiles(name: string): GeneratedFile[];
 //# sourceMappingURL=request-dto.d.ts.map

package/dist/generators/request-dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-dto.d.ts","sourceRoot":"","sources":["../../src/generators/request-dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAYrE"}
+{"version":3,"file":"request-dto.d.ts","sourceRoot":"","sources":["../../src/generators/request-dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAYrE"}

package/dist/generators/request-dto.js

@@ -1,5 +1,12 @@
 import { renderTemplate } from './render.js';
 import { toKebabCase, toPascalCase } from './utils.js';
+
+/**
+ * Generate request dto files.
+ *
+ * @param name The name.
+ * @returns The generate request dto files result.
+ */
 export function generateRequestDtoFiles(name) {
   const kebab = toKebabCase(name);
   const resource = toPascalCase(name);

package/dist/generators/response-dto.d.ts

@@ -1,3 +1,9 @@
 import type { GeneratedFile } from '../types.js';
+/**
+ * Generate response dto files.
+ *
+ * @param name The name.
+ * @returns The generate response dto files result.
+ */
 export declare function generateResponseDtoFiles(name: string): GeneratedFile[];
 //# sourceMappingURL=response-dto.d.ts.map

package/dist/generators/response-dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-dto.d.ts","sourceRoot":"","sources":["../../src/generators/response-dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAYtE"}
+{"version":3,"file":"response-dto.d.ts","sourceRoot":"","sources":["../../src/generators/response-dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAYtE"}

package/dist/generators/response-dto.js

@@ -1,5 +1,12 @@
 import { renderTemplate } from './render.js';
 import { toKebabCase, toPascalCase } from './utils.js';
+
+/**
+ * Generate response dto files.
+ *
+ * @param name The name.
+ * @returns The generate response dto files result.
+ */
 export function generateResponseDtoFiles(name) {
   const kebab = toKebabCase(name);
   const resource = toPascalCase(name);

package/dist/generators/service.d.ts

@@ -1,3 +1,10 @@
 import type { GenerateOptions, GeneratedFile } from '../types.js';
+/**
+ * Generate service files.
+ *
+ * @param name The name.
+ * @param _options The options.
+ * @returns The generate service files result.
+ */
 export declare function generateServiceFiles(name: string, _options?: GenerateOptions): GeneratedFile[];
 //# sourceMappingURL=service.d.ts.map

package/dist/generators/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/generators/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKlE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,eAAoB,GAAG,aAAa,EAAE,CAkBlG"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/generators/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKlE;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,eAAoB,GAAG,aAAa,EAAE,CAkBlG"}

package/dist/generators/service.js

@@ -1,5 +1,13 @@
 import { renderTemplate } from './render.js';
 import { toKebabCase, toPascalCase } from './utils.js';
+
+/**
+ * Generate service files.
+ *
+ * @param name The name.
+ * @param _options The options.
+ * @returns The generate service files result.
+ */
 export function generateServiceFiles(name, _options = {}) {
   const kebab = toKebabCase(name);
   const resource = toPascalCase(name);

package/dist/generators/utils.d.ts

@@ -1,4 +1,22 @@
+/**
+ * To kebab case.
+ *
+ * @param value The value.
+ * @returns The to kebab case result.
+ */
 export declare function toKebabCase(value: string): string;
+/**
+ * To pascal case.
+ *
+ * @param value The value.
+ * @returns The to pascal case result.
+ */
 export declare function toPascalCase(value: string): string;
+/**
+ * To plural.
+ *
+ * @param value The value.
+ * @returns The to plural result.
+ */
 export declare function toPlural(value: string): string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/generators/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/generators/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAa9C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/generators/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAa9C"}

package/dist/generators/utils.js

@@ -1,9 +1,29 @@
+/**
+ * To kebab case.
+ *
+ * @param value The value.
+ * @returns The to kebab case result.
+ */
 export function toKebabCase(value) {
   return value.replace(/([a-z0-9])([A-Z])/g, '$1-$2').replace(/[_\s]+/g, '-').replace(/-+/g, '-').toLowerCase();
 }
+
+/**
+ * To pascal case.
+ *
+ * @param value The value.
+ * @returns The to pascal case result.
+ */
 export function toPascalCase(value) {
   return toKebabCase(value).split('-').filter(Boolean).map(segment => segment[0].toUpperCase() + segment.slice(1)).join('');
 }
+
+/**
+ * To plural.
+ *
+ * @param value The value.
+ * @returns The to plural result.
+ */
 export function toPlural(value) {
   if (value.endsWith('s') || value.endsWith('x') || value.endsWith('z') || value.endsWith('ch') || value.endsWith('sh')) {
     return `${value}es`;

package/dist/help.d.ts

@@ -2,7 +2,20 @@ type HelpTableColumn<Row> = {
     header: string;
     render: (row: Row) => string;
 };
+/**
+ * Render alias list.
+ *
+ * @param aliases The aliases.
+ * @returns The render alias list result.
+ */
 export declare function renderAliasList(aliases: string[]): string;
+/**
+ * Render help table.
+ *
+ * @param rows The rows.
+ * @param columns The columns.
+ * @returns The render help table result.
+ */
 export declare function renderHelpTable<Row>(rows: Row[], columns: HelpTableColumn<Row>[]): string;
 export {};
 //# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,CAAC,GAAG,IAAI;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;CAC9B,CAAC;AAUF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAEzD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,GAAG,MAAM,CAazF"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,CAAC,GAAG,IAAI;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;CAC9B,CAAC;AAUF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,GAAG,MAAM,CAazF"}

package/dist/help.js

@@ -4,9 +4,24 @@ function border(widths) {
 function renderRow(values, widths) {
   return `| ${values.map((value, index) => value.padEnd(widths[index] ?? 0)).join(' | ')} |`;
 }
+
+/**
+ * Render alias list.
+ *
+ * @param aliases The aliases.
+ * @returns The render alias list result.
+ */
 export function renderAliasList(aliases) {
   return aliases.length === 0 ? '-' : aliases.join(', ');
 }
+
+/**
+ * Render help table.
+ *
+ * @param rows The rows.
+ * @param columns The columns.
+ * @returns The render help table result.
+ */
 export function renderHelpTable(rows, columns) {
   const widths = columns.map(column => {
     const values = rows.map(row => column.render(row));

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { runCli, type CliRuntimeOptions } from './cli.js';
 export { newUsage, runNewCommand, type NewCommandRuntimeOptions } from './commands/new.js';
+export { CliPromptCancelledError } from './prompt-cancel.js';
 export type { GenerateOptions, GeneratedFile, GeneratorKind, ModuleRegistration } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
 export { runCli } from './cli.js';
-export { newUsage, runNewCommand } from './commands/new.js';
+export { newUsage, runNewCommand } from './commands/new.js';
+export { CliPromptCancelledError } from './prompt-cancel.js';

package/dist/new/package-spec-resolver.d.ts

@@ -1,4 +1,11 @@
 import type { ResolvedBootstrapPlan } from './resolver.js';
 import type { BootstrapOptions } from './types.js';
+/**
+ * Resolve package specs.
+ *
+ * @param options The options.
+ * @param bootstrapPlan The bootstrap plan.
+ * @returns The resolve package specs result.
+ */
 export declare function resolvePackageSpecs(options: BootstrapOptions, bootstrapPlan: ResolvedBootstrapPlan): Promise<Record<string, string>>;
 //# sourceMappingURL=package-spec-resolver.d.ts.map

package/dist/new/package-spec-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-spec-resolver.d.ts","sourceRoot":"","sources":["../../src/new/package-spec-resolver.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkhBnD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,gBAAgB,EACzB,aAAa,EAAE,qBAAqB,GACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgCjC"}
+{"version":3,"file":"package-spec-resolver.d.ts","sourceRoot":"","sources":["../../src/new/package-spec-resolver.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkhBnD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,gBAAgB,EACzB,aAAa,EAAE,qBAAqB,GACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgCjC"}