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

package/dist/generators/manifest.d.ts

@@ -1,9 +1,11 @@
 import type { GeneratorFactory } from '../generator-types.js';
+/** Module metadata array names that auto-registered generators are allowed to update. */
 export type ModuleArrayKey = 'controllers' | 'providers' | 'middleware';
 type ModuleRegistrationDescriptor = {
     arrayKey: ModuleArrayKey;
     classSuffix: string;
 };
+/** Describes one built-in generator schematic and its CLI-facing metadata. */
 export type GeneratorManifestEntry = {
     aliases: readonly string[];
     description: string;
@@ -15,6 +17,244 @@ export type GeneratorManifestEntry = {
     schematic: string;
     wiringBehavior: 'auto-registered' | 'files-only';
 };
+/** Describes a deterministic collection of generator schematics discoverable by the CLI. */
+export type GeneratorCollection = {
+    description: string;
+    generators: readonly GeneratorManifestEntry[];
+    id: string;
+    source: 'built-in';
+};
+/** Option metadata shared by generate-command parsing, help output, docs, and tests. */
+export declare const generatorOptionSchemas: readonly [{
+    readonly aliases: readonly ["-o"];
+    readonly description: "Write generated files under a specific source directory.";
+    readonly name: "--target-directory <path>";
+    readonly value: "path";
+}, {
+    readonly aliases: readonly ["-f"];
+    readonly description: "Overwrite files that already exist.";
+    readonly name: "--force";
+    readonly value: "boolean";
+}, {
+    readonly aliases: readonly [];
+    readonly description: "Preview planned writes, skips, and module wiring without touching files.";
+    readonly name: "--dry-run";
+    readonly value: "boolean";
+}, {
+    readonly aliases: readonly ["-h"];
+    readonly description: "Show help for the generate command.";
+    readonly name: "--help";
+    readonly value: "boolean";
+}];
+/** The single generator collection shipped directly inside `@fluojs/cli`. */
+export declare const builtInGeneratorCollection: {
+    readonly description: "The deterministic collection of generator schematics shipped by @fluojs/cli.";
+    readonly generators: readonly [{
+        readonly aliases: readonly ["co"];
+        readonly description: "Generate a controller (auto-registered in the module controllers array).";
+        readonly factory: (name: string, options: import("../generator-types.js").GenerateOptions | undefined) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "controller";
+        readonly moduleRegistration: {
+            readonly arrayKey: "controllers";
+            readonly classSuffix: "Controller";
+        };
+        readonly nextStepHint: "Run 'pnpm typecheck' to verify module wiring, then add route handlers.";
+        readonly schematic: "controller";
+        readonly wiringBehavior: "auto-registered";
+    }, {
+        readonly aliases: readonly ["gu"];
+        readonly description: "Generate a guard (auto-registered as a provider in the module).";
+        readonly factory: (name: string) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "guard";
+        readonly moduleRegistration: {
+            readonly arrayKey: "providers";
+            readonly classSuffix: "Guard";
+        };
+        readonly nextStepHint: "Run 'pnpm typecheck' to verify module wiring, then apply the guard to routes.";
+        readonly schematic: "guard";
+        readonly wiringBehavior: "auto-registered";
+    }, {
+        readonly aliases: readonly ["in"];
+        readonly description: "Generate an interceptor (auto-registered as a provider in the module).";
+        readonly factory: (name: string) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "interceptor";
+        readonly moduleRegistration: {
+            readonly arrayKey: "providers";
+            readonly classSuffix: "Interceptor";
+        };
+        readonly nextStepHint: "Run 'pnpm typecheck' to verify module wiring, then bind the interceptor to routes.";
+        readonly schematic: "interceptor";
+        readonly wiringBehavior: "auto-registered";
+    }, {
+        readonly aliases: readonly ["mi"];
+        readonly description: "Generate a middleware (auto-registered in the module middleware array).";
+        readonly factory: (name: string) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "middleware";
+        readonly moduleRegistration: {
+            readonly arrayKey: "middleware";
+            readonly classSuffix: "Middleware";
+        };
+        readonly nextStepHint: "Run 'pnpm typecheck' to verify module wiring, then configure route matching in forRoutes.";
+        readonly schematic: "middleware";
+        readonly wiringBehavior: "auto-registered";
+    }, {
+        readonly aliases: readonly ["mo"];
+        readonly description: "Generate a standalone module (import it in a parent module to activate).";
+        readonly factory: (name: string) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "module";
+        readonly nextStepHint: "Import the new module in a parent module's imports array, then run 'pnpm typecheck'.";
+        readonly schematic: "module";
+        readonly wiringBehavior: "files-only";
+    }, {
+        readonly aliases: readonly ["repo"];
+        readonly description: "Generate a persistence-agnostic repository (auto-registered as a provider).";
+        readonly factory: (name: string, options: import("../generator-types.js").GenerateOptions | undefined) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "repo";
+        readonly moduleRegistration: {
+            readonly arrayKey: "providers";
+            readonly classSuffix: "Repo";
+        };
+        readonly nextStepHint: "Run 'pnpm typecheck' to verify module wiring, then add data-access methods to the repo stub.";
+        readonly registryAliases: readonly ["repository"];
+        readonly schematic: "repository";
+        readonly wiringBehavior: "auto-registered";
+    }, {
+        readonly aliases: readonly ["req"];
+        readonly description: "Generate a request DTO for route-level data binding and validation (files only — wire it into a controller manually).";
+        readonly factory: (name: string) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "request-dto";
+        readonly nextStepHint: "Import the DTO in a controller and add it as a parameter with @FromBody or @FromQuery.";
+        readonly schematic: "request-dto";
+        readonly wiringBehavior: "files-only";
+    }, {
+        readonly aliases: readonly ["res"];
+        readonly description: "Generate a response DTO for typed response payloads (files only — use it as a controller return type).";
+        readonly factory: (name: string) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "response-dto";
+        readonly nextStepHint: "Import the DTO in a controller and use it as the return type for route handlers.";
+        readonly schematic: "response-dto";
+        readonly wiringBehavior: "files-only";
+    }, {
+        readonly aliases: readonly ["s"];
+        readonly description: "Generate a service (auto-registered as a provider in the module).";
+        readonly factory: (name: string, options: import("../generator-types.js").GenerateOptions | undefined) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "service";
+        readonly moduleRegistration: {
+            readonly arrayKey: "providers";
+            readonly classSuffix: "Service";
+        };
+        readonly nextStepHint: "Run 'pnpm typecheck' to verify module wiring, then implement business logic.";
+        readonly schematic: "service";
+        readonly wiringBehavior: "auto-registered";
+    }];
+    readonly id: "@fluojs/cli/builtin";
+    readonly source: "built-in";
+};
+/** Deterministic list of generator collections currently discovered by `fluo generate`. */
+export declare const generatorCollections: readonly [{
+    readonly description: "The deterministic collection of generator schematics shipped by @fluojs/cli.";
+    readonly generators: readonly [{
+        readonly aliases: readonly ["co"];
+        readonly description: "Generate a controller (auto-registered in the module controllers array).";
+        readonly factory: (name: string, options: import("../generator-types.js").GenerateOptions | undefined) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "controller";
+        readonly moduleRegistration: {
+            readonly arrayKey: "controllers";
+            readonly classSuffix: "Controller";
+        };
+        readonly nextStepHint: "Run 'pnpm typecheck' to verify module wiring, then add route handlers.";
+        readonly schematic: "controller";
+        readonly wiringBehavior: "auto-registered";
+    }, {
+        readonly aliases: readonly ["gu"];
+        readonly description: "Generate a guard (auto-registered as a provider in the module).";
+        readonly factory: (name: string) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "guard";
+        readonly moduleRegistration: {
+            readonly arrayKey: "providers";
+            readonly classSuffix: "Guard";
+        };
+        readonly nextStepHint: "Run 'pnpm typecheck' to verify module wiring, then apply the guard to routes.";
+        readonly schematic: "guard";
+        readonly wiringBehavior: "auto-registered";
+    }, {
+        readonly aliases: readonly ["in"];
+        readonly description: "Generate an interceptor (auto-registered as a provider in the module).";
+        readonly factory: (name: string) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "interceptor";
+        readonly moduleRegistration: {
+            readonly arrayKey: "providers";
+            readonly classSuffix: "Interceptor";
+        };
+        readonly nextStepHint: "Run 'pnpm typecheck' to verify module wiring, then bind the interceptor to routes.";
+        readonly schematic: "interceptor";
+        readonly wiringBehavior: "auto-registered";
+    }, {
+        readonly aliases: readonly ["mi"];
+        readonly description: "Generate a middleware (auto-registered in the module middleware array).";
+        readonly factory: (name: string) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "middleware";
+        readonly moduleRegistration: {
+            readonly arrayKey: "middleware";
+            readonly classSuffix: "Middleware";
+        };
+        readonly nextStepHint: "Run 'pnpm typecheck' to verify module wiring, then configure route matching in forRoutes.";
+        readonly schematic: "middleware";
+        readonly wiringBehavior: "auto-registered";
+    }, {
+        readonly aliases: readonly ["mo"];
+        readonly description: "Generate a standalone module (import it in a parent module to activate).";
+        readonly factory: (name: string) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "module";
+        readonly nextStepHint: "Import the new module in a parent module's imports array, then run 'pnpm typecheck'.";
+        readonly schematic: "module";
+        readonly wiringBehavior: "files-only";
+    }, {
+        readonly aliases: readonly ["repo"];
+        readonly description: "Generate a persistence-agnostic repository (auto-registered as a provider).";
+        readonly factory: (name: string, options: import("../generator-types.js").GenerateOptions | undefined) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "repo";
+        readonly moduleRegistration: {
+            readonly arrayKey: "providers";
+            readonly classSuffix: "Repo";
+        };
+        readonly nextStepHint: "Run 'pnpm typecheck' to verify module wiring, then add data-access methods to the repo stub.";
+        readonly registryAliases: readonly ["repository"];
+        readonly schematic: "repository";
+        readonly wiringBehavior: "auto-registered";
+    }, {
+        readonly aliases: readonly ["req"];
+        readonly description: "Generate a request DTO for route-level data binding and validation (files only — wire it into a controller manually).";
+        readonly factory: (name: string) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "request-dto";
+        readonly nextStepHint: "Import the DTO in a controller and add it as a parameter with @FromBody or @FromQuery.";
+        readonly schematic: "request-dto";
+        readonly wiringBehavior: "files-only";
+    }, {
+        readonly aliases: readonly ["res"];
+        readonly description: "Generate a response DTO for typed response payloads (files only — use it as a controller return type).";
+        readonly factory: (name: string) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "response-dto";
+        readonly nextStepHint: "Import the DTO in a controller and use it as the return type for route handlers.";
+        readonly schematic: "response-dto";
+        readonly wiringBehavior: "files-only";
+    }, {
+        readonly aliases: readonly ["s"];
+        readonly description: "Generate a service (auto-registered as a provider in the module).";
+        readonly factory: (name: string, options: import("../generator-types.js").GenerateOptions | undefined) => import("../generator-types.js").GeneratedFile[];
+        readonly kind: "service";
+        readonly moduleRegistration: {
+            readonly arrayKey: "providers";
+            readonly classSuffix: "Service";
+        };
+        readonly nextStepHint: "Run 'pnpm typecheck' to verify module wiring, then implement business logic.";
+        readonly schematic: "service";
+        readonly wiringBehavior: "auto-registered";
+    }];
+    readonly id: "@fluojs/cli/builtin";
+    readonly source: "built-in";
+}];
+/** Built-in generator manifest used by CLI parsing, help output, and command execution. */
 export declare const generatorManifest: readonly [{
     readonly aliases: readonly ["co"];
     readonly description: "Generate a controller (auto-registered in the module controllers array).";
@@ -113,9 +353,36 @@ export declare const generatorManifest: readonly [{
     readonly schematic: "service";
     readonly wiringBehavior: "auto-registered";
 }];
+/** Union of generator kind tokens accepted by the built-in generator manifest. */
 export type GeneratorKind = (typeof generatorManifest)[number]['kind'];
+/** Exact manifest entry type for one built-in generator definition. */
 export type GeneratorDefinition = (typeof generatorManifest)[number];
+/**
+ * Looks up one built-in generator definition by canonical kind.
+ *
+ * @param kind Canonical generator kind to resolve.
+ * @returns The matching built-in generator definition.
+ */
 export declare function findGeneratorDefinition(kind: GeneratorKind): GeneratorDefinition;
+/**
+ * Lists generator collections that `fluo generate` discovers without loading external code.
+ *
+ * @returns The deterministic generator collection list.
+ */
+export declare function listGeneratorCollections(): readonly GeneratorCollection[];
+/**
+ * Lists generator definitions for a known collection.
+ *
+ * @param collectionId Collection identifier to read, defaulting to the built-in collection.
+ * @returns Generator definitions owned by the requested collection.
+ */
+export declare function listGeneratorDefinitions(collectionId?: string): readonly GeneratorDefinition[];
+/**
+ * Resolves a CLI token or alias to a canonical generator kind.
+ *
+ * @param value Raw CLI generator token or alias.
+ * @returns The canonical generator kind when the token is known, otherwise `undefined`.
+ */
 export declare function resolveGeneratorKind(value: string | undefined): GeneratorKind | undefined;
 export {};
 //# sourceMappingURL=manifest.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/generators/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAY9D,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,CAAC;AAExE,KAAK,4BAA4B,GAAG;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,4BAA4B,CAAC;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,iBAAiB,GAAG,YAAY,CAAC;CAClD,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyFwB,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAcrE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,aAAa,GAAG,mBAAmB,CAOhF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAMzF"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/generators/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAyB,MAAM,uBAAuB,CAAC;AAYrF,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,CAAC;AAExE,KAAK,4BAA4B,GAAG;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,4BAA4B,CAAC;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,iBAAiB,GAAG,YAAY,CAAC;CAClD,CAAC;AAEF,4FAA4F;AAC5F,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;EAKkB,CAAC;AA6FtD,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKC,CAAC;AAEzC,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAiF,CAAC;AAEnH,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAwC,CAAC;AAEvE,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,uEAAuE;AACvE,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAcrE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,aAAa,GAAG,mBAAmB,CAOhF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,SAAS,mBAAmB,EAAE,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,GAAE,MAAsC,GAAG,SAAS,mBAAmB,EAAE,CAO7H;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAMzF"}

package/dist/generators/manifest.js

@@ -7,7 +7,36 @@ import { generateRepoFiles } from './repository.js';
 import { generateRequestDtoFiles } from './request-dto.js';
 import { generateResponseDtoFiles } from './response-dto.js';
 import { generateServiceFiles } from './service.js';
-export const generatorManifest = [{
+
+/** Module metadata array names that auto-registered generators are allowed to update. */
+
+/** Describes one built-in generator schematic and its CLI-facing metadata. */
+
+/** Describes a deterministic collection of generator schematics discoverable by the CLI. */
+
+/** Option metadata shared by generate-command parsing, help output, docs, and tests. */
+export const generatorOptionSchemas = [{
+  aliases: ['-o'],
+  description: 'Write generated files under a specific source directory.',
+  name: '--target-directory <path>',
+  value: 'path'
+}, {
+  aliases: ['-f'],
+  description: 'Overwrite files that already exist.',
+  name: '--force',
+  value: 'boolean'
+}, {
+  aliases: [],
+  description: 'Preview planned writes, skips, and module wiring without touching files.',
+  name: '--dry-run',
+  value: 'boolean'
+}, {
+  aliases: ['-h'],
+  description: 'Show help for the generate command.',
+  name: '--help',
+  value: 'boolean'
+}];
+const builtInGeneratorDefinitions = [{
   aliases: ['co'],
   description: 'Generate a controller (auto-registered in the module controllers array).',
   factory: (name, options) => generateControllerFiles(name, options),
@@ -105,6 +134,25 @@ export const generatorManifest = [{
   schematic: 'service',
   wiringBehavior: 'auto-registered'
 }];
+
+/** The single generator collection shipped directly inside `@fluojs/cli`. */
+export const builtInGeneratorCollection = {
+  description: 'The deterministic collection of generator schematics shipped by @fluojs/cli.',
+  generators: builtInGeneratorDefinitions,
+  id: '@fluojs/cli/builtin',
+  source: 'built-in'
+};
+
+/** Deterministic list of generator collections currently discovered by `fluo generate`. */
+export const generatorCollections = [builtInGeneratorCollection];
+
+/** Built-in generator manifest used by CLI parsing, help output, and command execution. */
+export const generatorManifest = builtInGeneratorCollection.generators;
+
+/** Union of generator kind tokens accepted by the built-in generator manifest. */
+
+/** Exact manifest entry type for one built-in generator definition. */
+
 const generatorByKind = new Map();
 const tokenToKind = new Map();
 for (const entry of generatorManifest) {
@@ -115,6 +163,13 @@ for (const entry of generatorManifest) {
     tokenToKind.set(alias, entry.kind);
   }
 }
+
+/**
+ * Looks up one built-in generator definition by canonical kind.
+ *
+ * @param kind Canonical generator kind to resolve.
+ * @returns The matching built-in generator definition.
+ */
 export function findGeneratorDefinition(kind) {
   const entry = generatorByKind.get(kind);
   if (!entry) {
@@ -122,6 +177,36 @@ export function findGeneratorDefinition(kind) {
   }
   return entry;
 }
+
+/**
+ * Lists generator collections that `fluo generate` discovers without loading external code.
+ *
+ * @returns The deterministic generator collection list.
+ */
+export function listGeneratorCollections() {
+  return generatorCollections;
+}
+
+/**
+ * Lists generator definitions for a known collection.
+ *
+ * @param collectionId Collection identifier to read, defaulting to the built-in collection.
+ * @returns Generator definitions owned by the requested collection.
+ */
+export function listGeneratorDefinitions(collectionId = builtInGeneratorCollection.id) {
+  const collection = generatorCollections.find(entry => entry.id === collectionId);
+  if (!collection) {
+    throw new Error(`Unknown generator collection: ${collectionId}`);
+  }
+  return collection.generators;
+}
+
+/**
+ * Resolves a CLI token or alias to a canonical generator kind.
+ *
+ * @param value Raw CLI generator token or alias.
+ * @returns The canonical generator kind when the token is known, otherwise `undefined`.
+ */
 export function resolveGeneratorKind(value) {
   if (!value) {
     return undefined;

package/dist/new/prompt.d.ts

@@ -20,6 +20,7 @@ export interface BootstrapPrompter {
 }
 /** Runtime overrides for resolving bootstrap answers in tests and editors. */
 export interface ResolveBootstrapAnswersOptions {
+    completionMessage?: string | ((answers: BootstrapAnswers) => string);
     interactive?: boolean;
     prompt?: BootstrapPrompter;
     stdin?: ReadableStream;

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

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/new/prompt.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,EAAE,cAAuB,CAAC;AAI9D,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AAQF,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7G,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,8EAA8E;AAC9E,MAAM,WAAW,8BAA8B;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AA6OD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,CAIhB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,gBAAgB,CAgBlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,gBAAgB,CAAC,CA0B3B"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/new/prompt.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,EAAE,cAAuB,CAAC;AAI9D,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AAQF,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7G,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,8EAA8E;AAC9E,MAAM,WAAW,8BAA8B;IAC7C,iBAAiB,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,gBAAgB,KAAK,MAAM,CAAC,CAAC;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAwPD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,CAIhB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,gBAAgB,CAgBlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,gBAAgB,CAAC,CA0B3B"}

package/dist/new/prompt.js

@@ -22,6 +22,12 @@ const STARTER_SHAPE_CHOICES = [{
 
 /** Runtime overrides for resolving bootstrap answers in tests and editors. */
 
+function resolveCompletionMessage(completionMessage, answers) {
+  if (typeof completionMessage === 'function') {
+    return completionMessage(answers);
+  }
+  return completionMessage ?? `Project created! Run: cd ${answers.targetDirectory}`;
+}
 function hasOwnValue(partial, key) {
   return partial[key] !== undefined;
 }
@@ -269,7 +275,7 @@ export async function collectBootstrapAnswers(partial, cwd, userAgent, options =
     }
     const answers = await resolveInteractiveBootstrapAnswers(partial, cwd, userAgent, prompt);
     if (isInteractiveShell) {
-      clack.outro(`Project created! Run: cd ${answers.targetDirectory}`);
+      clack.outro(resolveCompletionMessage(options.completionMessage, answers));
     }
     return answers;
   } finally {

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

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/new/scaffold.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAijEnE;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,aAAa,SAAkB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,6BAAuB,CAAC"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/new/scaffold.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAmkEnE;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,aAAa,SAAkB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,6BAAuB,CAAC"}

package/dist/new/scaffold.js

@@ -26,6 +26,22 @@ const PUBLISHED_RUNTIME_DEPENDENCIES = {
   mqtt: '^5.0.0',
   nats: '^2.29.3'
 };
+const PUBLISHED_INTERNAL_DEPENDENCIES = {
+  '@fluojs/cli': '^1.0.0-beta.2',
+  '@fluojs/config': '^1.0.0-beta.1',
+  '@fluojs/core': '^1.0.0-beta.1',
+  '@fluojs/di': '^1.0.0-beta.1',
+  '@fluojs/http': '^1.0.0-beta.1',
+  '@fluojs/microservices': '^1.0.0-beta.1',
+  '@fluojs/platform-bun': '^1.0.0-beta.1',
+  '@fluojs/platform-cloudflare-workers': '^1.0.0-beta.1',
+  '@fluojs/platform-deno': '^1.0.0-beta.1',
+  '@fluojs/platform-express': '^1.0.0-beta.1',
+  '@fluojs/platform-fastify': '^1.0.0-beta.2',
+  '@fluojs/platform-nodejs': '^1.0.0-beta.1',
+  '@fluojs/runtime': '^1.0.0-beta.1',
+  '@fluojs/testing': '^1.0.0-beta.1'
+};
 function describeApplicationStarter(options) {
   if (options.runtime === 'bun') {
     return {
@@ -97,7 +113,7 @@ function writeTextFile(filePath, content) {
   writeFileSync(filePath, content, 'utf8');
 }
 function createDependencySpec(packageName, releaseVersion, packageSpecs) {
-  return packageSpecs[packageName] ?? PUBLISHED_RUNTIME_DEPENDENCIES[packageName] ?? createPublishedInternalDependencySpec(releaseVersion);
+  return packageSpecs[packageName] ?? PUBLISHED_RUNTIME_DEPENDENCIES[packageName] ?? PUBLISHED_INTERNAL_DEPENDENCIES[packageName] ?? createPublishedInternalDependencySpec(releaseVersion);
 }
 function createPublishedInternalDependencySpec(version) {
   return `^${version}`;

package/dist/registry.d.ts

@@ -1,10 +1,13 @@
 import type { GeneratorFactory } from './generator-types.js';
+/** In-memory registry that maps generator tokens to factories and their owning collection. */
 export declare class GeneratorRegistry {
     private readonly registry;
-    register(kind: string, factory: GeneratorFactory, description?: string): this;
+    register(kind: string, factory: GeneratorFactory, description?: string, collectionId?: string): this;
+    collectionId(kind: string): string | undefined;
     resolve(kind: string): GeneratorFactory | undefined;
     has(kind: string): boolean;
     kinds(): string[];
 }
+/** Default generator registry populated from the deterministic built-in collection. */
 export declare const defaultRegistry: GeneratorRegistry;
 //# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAyB,MAAM,sBAAsB,CAAC;AAIpF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IAErE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAK7E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAInD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,KAAK,IAAI,MAAM,EAAE;CAGlB;AAED,eAAO,MAAM,eAAe,mBAA0B,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAyB,MAAM,sBAAsB,CAAC;AAIpF,8FAA8F;AAC9F,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IAErE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAKpG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAInD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,KAAK,IAAI,MAAM,EAAE;CAGlB;AAED,uFAAuF;AACvF,eAAO,MAAM,eAAe,mBAA0B,CAAC"}

package/dist/registry.js

@@ -1,13 +1,19 @@
-import { generatorManifest } from './generators/manifest.js';
+import { builtInGeneratorCollection, listGeneratorDefinitions } from './generators/manifest.js';
+
+/** In-memory registry that maps generator tokens to factories and their owning collection. */
 export class GeneratorRegistry {
   registry = new Map();
-  register(kind, factory, description) {
+  register(kind, factory, description, collectionId) {
     this.registry.set(kind, {
+      collectionId,
       factory,
       description
     });
     return this;
   }
+  collectionId(kind) {
+    return this.registry.get(kind)?.collectionId;
+  }
   resolve(kind) {
     return this.registry.get(kind)?.factory;
   }
@@ -18,13 +24,15 @@ export class GeneratorRegistry {
     return Array.from(this.registry.keys());
   }
 }
+
+/** Default generator registry populated from the deterministic built-in collection. */
 export const defaultRegistry = new GeneratorRegistry();
-for (const entry of generatorManifest) {
-  defaultRegistry.register(entry.kind, entry.factory, entry.description);
+for (const entry of listGeneratorDefinitions()) {
+  defaultRegistry.register(entry.kind, entry.factory, entry.description, builtInGeneratorCollection.id);
   const registryAliases = 'registryAliases' in entry ? entry.registryAliases : undefined;
   if (registryAliases) {
     for (const alias of registryAliases) {
-      defaultRegistry.register(alias, entry.factory, entry.description);
+      defaultRegistry.register(alias, entry.factory, entry.description, builtInGeneratorCollection.id);
     }
   }
 }

package/dist/update-check.d.ts

@@ -0,0 +1,50 @@
+type CliStream = {
+    isTTY?: boolean;
+    write(message: string): unknown;
+};
+type CliReadableStream = {
+    isTTY?: boolean;
+};
+export type CliUpdateCheckResult = {
+    action: 'continue';
+} | {
+    action: 'reran';
+    exitCode: number;
+};
+export type UpdateInstallCommand = {
+    args: string[];
+    command: string;
+    display: string;
+};
+export type UpdateCommandRuntime = {
+    env: NodeJS.ProcessEnv;
+    stderr: CliStream;
+};
+export type UpdatePrompter = {
+    confirm(message: string, defaultValue: boolean): Promise<boolean>;
+};
+export interface CliUpdateCheckRuntimeOptions {
+    cacheFile?: string;
+    cacheTtlMs?: number;
+    ci?: boolean;
+    currentVersion?: string;
+    env?: NodeJS.ProcessEnv;
+    fetchLatestVersion?: (packageName: string) => Promise<string | undefined>;
+    installPackage?: (installCommand: UpdateInstallCommand, runtime: UpdateCommandRuntime) => Promise<number>;
+    interactive?: boolean;
+    now?: () => Date;
+    packageName?: string;
+    prompt?: UpdatePrompter;
+    rerunCli?: (argv: string[], runtime: UpdateCommandRuntime) => Promise<number>;
+    skip?: boolean;
+    stderr?: CliStream;
+    stdin?: CliReadableStream;
+    stdout?: CliStream;
+}
+export declare function removeUpdateCheckFlags(argv: string[]): {
+    argv: string[];
+    skipUpdateCheck: boolean;
+};
+export declare function runCliUpdateCheck(argv: string[], options?: CliUpdateCheckRuntimeOptions): Promise<CliUpdateCheckResult>;
+export {};
+//# sourceMappingURL=update-check.d.ts.map

package/dist/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAOA,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAcF,MAAM,MAAM,oBAAoB,GAC5B;IACE,MAAM,EAAE,UAAU,CAAC;CACpB,GACD;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE,CAAC;AAEF,MAAM,WAAW,4BAA4B;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1E,cAAc,CAAC,EAAE,CAAC,cAAc,EAAE,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1G,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AA0VD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAcnG;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgEjI"}