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

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/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/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"}