@ng-forge/openapi-generator 0.8.0-next.2 → 0.8.0-next.3

package/README.md

@@ -129,19 +129,20 @@ ng-forge-generator --spec openapi.yaml --output src/generated
 
 ### Options
 
-| Option                 | Description                                                                              |
-| ---------------------- | ---------------------------------------------------------------------------------------- |
-| `--spec <path>`        | Path to OpenAPI spec file (required)                                                     |
-| `--output <path>`      | Output directory for generated files (required)                                          |
-| `--interactive <mode>` | `full` (prompt for endpoints + ambiguous types) or `none` (auto-select). Default: `full` |
-| `--endpoints <list>`   | Comma-separated endpoints, e.g. `"POST:/users,PUT:/users/{id}"`                          |
-| `--read-only`          | Generate GET endpoint forms with all fields disabled                                     |
-| `--watch`              | Watch spec file for changes and regenerate                                               |
-| `--config <path>`      | Directory for `.ng-forge-generator.json` config (defaults to `--output`)                 |
-| `--dry-run`            | List files that would be generated without writing them                                  |
-| `--skip-existing`      | Skip files that already exist on disk                                                    |
-| `--verbose`            | Show detailed output including field mapping decisions                                   |
-| `--quiet`              | Suppress info output; still shows success summary, warnings, and errors                  |
+| Option                     | Description                                                                                                                                   |
+| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--spec <path>`            | Path to OpenAPI spec file (required)                                                                                                          |
+| `--output <path>`          | Output directory for generated files (required)                                                                                               |
+| `--interactive <mode>`     | `full` (prompt for endpoints + ambiguous types) or `none` (auto-select). Default: `full`                                                      |
+| `--endpoints <list>`       | Comma-separated endpoints, e.g. `"POST:/users,PUT:/users/{id}"`                                                                               |
+| `--read-only`              | Generate GET endpoint forms with all fields disabled                                                                                          |
+| `--barrel-extension <ext>` | Extension in barrel re-exports. Accepts `""` (default — no extension) or a dot-prefixed value like `".js"` (for Node ESM). Pass `""` to reset |
+| `--watch`                  | Watch spec file for changes and regenerate                                                                                                    |
+| `--config <path>`          | Directory for `.ng-forge-generator.json` config (defaults to `--output`)                                                                      |
+| `--dry-run`                | List files that would be generated without writing them                                                                                       |
+| `--skip-existing`          | Skip files that already exist on disk                                                                                                         |
+| `--verbose`                | Show detailed output including field mapping decisions                                                                                        |
+| `--quiet`                  | Suppress info output; still shows success summary, warnings, and errors                                                                       |
 
 ### Interactive Modes
 
@@ -164,6 +165,9 @@ ng-forge-generator --spec openapi.yaml --output src/generated \
 # Generate GET endpoints with disabled (read-only) fields
 ng-forge-generator --spec openapi.yaml --output src/generated --interactive none --read-only
 
+# Node ESM / moduleResolution nodenext — emit .js extensions in barrel files
+ng-forge-generator --spec openapi.yaml --output src/generated --barrel-extension .js
+
 # Preview without writing
 ng-forge-generator --spec openapi.yaml --output src/generated --dry-run
 
@@ -288,6 +292,7 @@ A `.ng-forge-generator.json` config file is saved in the output directory (or th
 - **Selected endpoints** — which `METHOD:/path` pairs to generate
 - **Field type decisions** — ambiguous field type choices (e.g., `"registerUser.acceptTerms": "checkbox"`)
 - **Read-only flag** — whether GET endpoint fields are disabled
+- **Barrel extension** — extension used in generated `index.ts` re-exports (empty by default)
 
 This enables reproducible non-interactive re-runs. On subsequent runs, the generator reuses saved decisions without prompting.
 
@@ -309,6 +314,22 @@ This enables reproducible non-interactive re-runs. On subsequent runs, the gener
 - **With `operationId`**: kebab-cased operationId (e.g., `createPet` -> `create-pet.form.ts`)
 - **Without `operationId`**: method + path (e.g., `POST /users/register` -> `post-users-register.form.ts`)
 
+### Barrel Exports
+
+By default, generated `index.ts` barrel files re-export modules without a file extension:
+
+```typescript
+// forms/index.ts
+export * from './create-pet.form';
+export * from './update-pet.form';
+```
+
+This matches the typical Angular app setup (`moduleResolution: bundler`). For Node ESM consumers running with `moduleResolution: node16` or `nodenext`, pass `--barrel-extension .js` to emit fully-qualified ESM imports.
+
+The selected extension persists in `.ng-forge-generator.json` (only when non-empty) so future runs keep your choice. To clear a previously-saved `.js` and return to the default, pass `--barrel-extension ""` or delete the `barrelExtension` key from the config file.
+
+> **Migrating from pre-1.x:** Earlier versions emitted `.js` suffixes by default. Upgrading will change generated barrel output for users who had not explicitly configured this — pass `--barrel-extension .js` on your next run to preserve the old behavior.
+
 ## Programmatic API
 
 The package exports all core functions for programmatic use:
@@ -348,8 +369,9 @@ generateFormConfig(fields: FieldConfig[], options: FormConfigGeneratorOptions):
 // Generate a TypeScript interface source string from a schema
 generateInterface(schema: SchemaObject, options: InterfaceGeneratorOptions): string
 
-// Generate an index.ts barrel file
-generateBarrel(fileNames: string[]): string
+// Generate an index.ts barrel file. `options.extension` controls the re-export
+// suffix (default: '' — no extension; use '.js' for Node ESM/nodenext).
+generateBarrel(fileNames: string[], options?: BarrelOptions): string
 ```
 
 ### I/O

package/bin/ng-forge-generator.js

@@ -1003,7 +1003,7 @@ function generateBarrel(fileNames, options) {
   if (fileNames.length === 0) {
     return "";
   }
-  const ext = options?.extension ?? ".js";
+  const ext = options?.extension ?? "";
   const lines = [
     "// @generated by @ng-forge/openapi-generator ",
     ...fileNames.map((name) => {
@@ -1176,7 +1176,16 @@ function registerGenerateOptions(cmd) {
       return value;
     },
     "full"
-  ).option("--endpoints <list>", 'Comma-separated endpoints, e.g. "POST:/users,PUT:/users/{id}"').option("--read-only", "Generate GET endpoint forms with all fields disabled").option("--watch", "Watch spec file for changes and regenerate").option("--config <path>", "Directory for .ng-forge-generator.json config (defaults to --output)").option("--dry-run", "List files that would be generated without writing them").option("--skip-existing", "Skip files that already exist on disk").option("--verbose", "Show detailed output including field mapping decisions").option("--quiet", "Suppress info output; still shows success summary, warnings, and errors").addHelpText("after", "\nNote: Generated files are not formatted. Run your project formatter (e.g. prettier) after generation.");
+  ).option("--endpoints <list>", 'Comma-separated endpoints, e.g. "POST:/users,PUT:/users/{id}"').option("--read-only", "Generate GET endpoint forms with all fields disabled").option("--watch", "Watch spec file for changes and regenerate").option("--config <path>", "Directory for .ng-forge-generator.json config (defaults to --output)").option("--dry-run", "List files that would be generated without writing them").option("--skip-existing", "Skip files that already exist on disk").option(
+    "--barrel-extension <ext>",
+    'Extension used in barrel file exports. Accepts "" (default \u2014 no extension, for bundler/Angular setups) or a dot-prefixed extension like ".js" (for Node ESM / moduleResolution node16|nodenext). Pass "" to clear a previously-saved value',
+    (value) => {
+      if (value !== "" && !/^\.[a-z0-9]+$/i.test(value)) {
+        throw new Error(`Invalid --barrel-extension '${value}'. Expected "" or a dot-prefixed extension like ".js".`);
+      }
+      return value;
+    }
+  ).option("--verbose", "Show detailed output including field mapping decisions").option("--quiet", "Suppress info output; still shows success summary, warnings, and errors").addHelpText("after", "\nNote: Generated files are not formatted. Run your project formatter (e.g. prettier) after generation.");
 }
 async function runGenerateAction(options) {
   if (options.verbose && options.quiet) {
@@ -1195,6 +1204,7 @@ async function runGenerate(options) {
   const configDir = options.config ?? options.output;
   const existingConfig = await loadConfig(configDir);
   const decisions = existingConfig?.decisions ?? {};
+  const barrelExtension = options.barrelExtension ?? existingConfig?.barrelExtension ?? "";
   if (existingConfig) {
     logger.info(`Loaded config from ${configDir}/.ng-forge-generator.json (${existingConfig.endpoints.length} saved endpoint(s))`);
   }
@@ -1333,12 +1343,12 @@ Ambiguous fields in ${endpoint.method} ${endpoint.path}:`);
   }
   allFiles.push({
     fileName: "index.ts",
-    content: generateBarrel(allFormFileNames),
+    content: generateBarrel(allFormFileNames, { extension: barrelExtension }),
     subdirectory: "forms"
   });
   allFiles.push({
     fileName: "index.ts",
-    content: generateBarrel(allInterfaceFileNames),
+    content: generateBarrel(allInterfaceFileNames, { extension: barrelExtension }),
     subdirectory: "types"
   });
   if (allFormFileNames.length === 0) {
@@ -1375,7 +1385,11 @@ Ambiguous fields in ${endpoint.method} ${endpoint.path}:`);
     output: options.output,
     endpoints: configEndpoints,
     decisions: updatedDecisions,
-    readOnly: options.readOnly
+    readOnly: options.readOnly,
+    // Only persist when non-default so the empty (default) state is representable
+    // as "field absent" — letting users clear a previously-saved .js setting by
+    // passing --barrel-extension "" (or deleting the key manually).
+    ...barrelExtension !== "" && { barrelExtension }
   };
   await saveConfig(configDir, config);
   if (options.watch) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ng-forge/openapi-generator",
-  "version": "0.8.0-next.2",
+  "version": "0.8.0-next.3",
   "description": "Generate @ng-forge/dynamic-forms configurations from OpenAPI specs",
   "type": "module",
   "license": "MIT",

package/src/cli/commands/generate.command.d.ts

@@ -12,6 +12,7 @@ interface GenerateOptions {
     skipExisting?: boolean;
     verbose?: boolean;
     quiet?: boolean;
+    barrelExtension?: string;
 }
 /**
  * Register generate options directly on the given Command (no subcommand).

package/src/cli/commands/generate.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.command.d.ts","sourceRoot":"","sources":["../../../../../../packages/openapi-generator/src/cli/commands/generate.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAkBvE,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAwB1D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAe/E;AA6RD,wBAAgB,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAQ7F"}
+{"version":3,"file":"generate.command.d.ts","sourceRoot":"","sources":["../../../../../../packages/openapi-generator/src/cli/commands/generate.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAkBvE,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAkC1D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAe/E;AAkSD,wBAAgB,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAQ7F"}

package/src/config/generator-config.d.ts

@@ -4,6 +4,7 @@ export interface GeneratorConfig {
     endpoints: string[];
     decisions: Record<string, string>;
     readOnly?: boolean;
+    barrelExtension?: string;
 }
 export declare function loadConfig(dir: string): Promise<GeneratorConfig | null>;
 export declare function saveConfig(dir: string, config: GeneratorConfig): Promise<void>;

package/src/config/generator-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator-config.d.ts","sourceRoot":"","sources":["../../../../../packages/openapi-generator/src/config/generator-config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiB7E;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpF"}
+{"version":3,"file":"generator-config.d.ts","sourceRoot":"","sources":["../../../../../packages/openapi-generator/src/config/generator-config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiB7E;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpF"}

package/src/index.d.ts

@@ -15,6 +15,7 @@ export type { FormConfigGeneratorOptions } from './generator/form-config-generat
 export { generateInterface } from './generator/interface-generator.js';
 export type { InterfaceGeneratorOptions } from './generator/interface-generator.js';
 export { generateBarrel } from './generator/barrel-generator.js';
+export type { BarrelOptions } from './generator/barrel-generator.js';
 export { writeGeneratedFiles } from './generator/file-writer.js';
 export type { GeneratedFile, WriteOptions, WriteResult } from './generator/file-writer.js';
 export { loadConfig, saveConfig } from './config/generator-config.js';

package/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/openapi-generator/src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACvF,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE/G,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,YAAY,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAEpF,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE3F,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/openapi-generator/src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACvF,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE/G,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,YAAY,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAEpF,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE3F,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC"}

package/src/index.js

@@ -995,7 +995,7 @@ function generateBarrel(fileNames, options) {
   if (fileNames.length === 0) {
     return "";
   }
-  const ext = options?.extension ?? ".js";
+  const ext = options?.extension ?? "";
   const lines = [
     "// @generated by @ng-forge/openapi-generator ",
     ...fileNames.map((name) => {
@@ -1174,7 +1174,16 @@ function registerGenerateOptions(cmd) {
       return value;
     },
     "full"
-  ).option("--endpoints <list>", 'Comma-separated endpoints, e.g. "POST:/users,PUT:/users/{id}"').option("--read-only", "Generate GET endpoint forms with all fields disabled").option("--watch", "Watch spec file for changes and regenerate").option("--config <path>", "Directory for .ng-forge-generator.json config (defaults to --output)").option("--dry-run", "List files that would be generated without writing them").option("--skip-existing", "Skip files that already exist on disk").option("--verbose", "Show detailed output including field mapping decisions").option("--quiet", "Suppress info output; still shows success summary, warnings, and errors").addHelpText("after", "\nNote: Generated files are not formatted. Run your project formatter (e.g. prettier) after generation.");
+  ).option("--endpoints <list>", 'Comma-separated endpoints, e.g. "POST:/users,PUT:/users/{id}"').option("--read-only", "Generate GET endpoint forms with all fields disabled").option("--watch", "Watch spec file for changes and regenerate").option("--config <path>", "Directory for .ng-forge-generator.json config (defaults to --output)").option("--dry-run", "List files that would be generated without writing them").option("--skip-existing", "Skip files that already exist on disk").option(
+    "--barrel-extension <ext>",
+    'Extension used in barrel file exports. Accepts "" (default \u2014 no extension, for bundler/Angular setups) or a dot-prefixed extension like ".js" (for Node ESM / moduleResolution node16|nodenext). Pass "" to clear a previously-saved value',
+    (value) => {
+      if (value !== "" && !/^\.[a-z0-9]+$/i.test(value)) {
+        throw new Error(`Invalid --barrel-extension '${value}'. Expected "" or a dot-prefixed extension like ".js".`);
+      }
+      return value;
+    }
+  ).option("--verbose", "Show detailed output including field mapping decisions").option("--quiet", "Suppress info output; still shows success summary, warnings, and errors").addHelpText("after", "\nNote: Generated files are not formatted. Run your project formatter (e.g. prettier) after generation.");
 }
 async function runGenerateAction(options) {
   if (options.verbose && options.quiet) {
@@ -1193,6 +1202,7 @@ async function runGenerate(options) {
   const configDir = options.config ?? options.output;
   const existingConfig = await loadConfig(configDir);
   const decisions = existingConfig?.decisions ?? {};
+  const barrelExtension = options.barrelExtension ?? existingConfig?.barrelExtension ?? "";
   if (existingConfig) {
     logger.info(`Loaded config from ${configDir}/.ng-forge-generator.json (${existingConfig.endpoints.length} saved endpoint(s))`);
   }
@@ -1331,12 +1341,12 @@ Ambiguous fields in ${endpoint.method} ${endpoint.path}:`);
   }
   allFiles.push({
     fileName: "index.ts",
-    content: generateBarrel(allFormFileNames),
+    content: generateBarrel(allFormFileNames, { extension: barrelExtension }),
     subdirectory: "forms"
   });
   allFiles.push({
     fileName: "index.ts",
-    content: generateBarrel(allInterfaceFileNames),
+    content: generateBarrel(allInterfaceFileNames, { extension: barrelExtension }),
     subdirectory: "types"
   });
   if (allFormFileNames.length === 0) {
@@ -1373,7 +1383,11 @@ Ambiguous fields in ${endpoint.method} ${endpoint.path}:`);
     output: options.output,
     endpoints: configEndpoints,
     decisions: updatedDecisions,
-    readOnly: options.readOnly
+    readOnly: options.readOnly,
+    // Only persist when non-default so the empty (default) state is representable
+    // as "field absent" — letting users clear a previously-saved .js setting by
+    // passing --barrel-extension "" (or deleting the key manually).
+    ...barrelExtension !== "" && { barrelExtension }
   };
   await saveConfig(configDir, config);
   if (options.watch) {