create-forgeon 0.1.2 → 0.1.5

package/README.md

@@ -1,23 +1,25 @@
-# create-forgeon
-
-CLI package for generating Forgeon fullstack monorepo projects.
-
-## Usage
-
-```bash
-npx create-forgeon@latest my-app --i18n true --proxy caddy
-```
-
-If flags are omitted, the CLI asks interactive questions.
-Project name stays text input; fixed-choice prompts use arrow-key selection (`Up/Down + Enter`).
-
+# create-forgeon
+
+CLI package for generating Forgeon fullstack monorepo projects.
+
+## Usage
+
+```bash
+npx create-forgeon@latest my-app --i18n true --proxy caddy
+```
+
+If flags are omitted, the CLI asks interactive questions.
+Project name stays text input; fixed-choice prompts use arrow-key selection (`Up/Down + Enter`).
+
 ```bash
 npx create-forgeon@latest add --list
+npx create-forgeon@latest add i18n --project ./my-app
 npx create-forgeon@latest add jwt-auth --project ./my-app
 ```
-
-## Notes
-
+
+## Notes
+
 - Canonical stack is fixed: NestJS + React + Prisma/Postgres + Docker.
 - Reverse proxy options: `caddy` (default), `nginx`, `none`.
-- `add <module-id>` currently writes module docs notes under `docs/AI/MODULES/`
+- `add i18n` is implemented and applies backend/frontend i18n wiring.
+- Planned modules write docs notes under `docs/AI/MODULES/`.

package/bin/create-forgeon.mjs

@@ -1,22 +1,22 @@
-#!/usr/bin/env node
-import { runCreateForgeon } from '../src/run-create-forgeon.mjs';
-import { runAddModule } from '../src/run-add-module.mjs';
-
-const args = process.argv.slice(2);
-const command = args[0];
-
-const task =
-  command === 'add'
-    ? runAddModule(args.slice(1))
-    : runCreateForgeon(args);
-
-task.then(() => {
-  if (typeof process.stdin.pause === 'function') {
-    process.stdin.pause();
-  }
-});
-
-task.catch((error) => {
-  console.error(error instanceof Error ? error.message : error);
-  process.exit(1);
-});
+#!/usr/bin/env node
+import { runCreateForgeon } from '../src/run-create-forgeon.mjs';
+import { runAddModule } from '../src/run-add-module.mjs';
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+const task =
+  command === 'add'
+    ? runAddModule(args.slice(1))
+    : runCreateForgeon(args);
+
+task.then(() => {
+  if (typeof process.stdin.pause === 'function') {
+    process.stdin.pause();
+  }
+});
+
+task.catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-forgeon",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "Forgeon project generator CLI",
   "license": "MIT",
   "author": "Forgeon",

package/src/cli/add-help.mjs

@@ -1,12 +1,12 @@
-export function printAddHelp() {
-  console.log(`create-forgeon add
-
-Usage:
-  npx create-forgeon@latest add <module-id> [options]
-
-Options:
-  --project <path>   Target project path (default: current directory)
-  --list             List available modules
-  -h, --help         Show this help
-`);
-}
+export function printAddHelp() {
+  console.log(`create-forgeon add
+
+Usage:
+  npx create-forgeon@latest add <module-id> [options]
+
+Options:
+  --project <path>   Target project path (default: current directory)
+  --list             List available modules
+  -h, --help         Show this help
+`);
+}

package/src/cli/add-options.mjs

@@ -1,54 +1,54 @@
-export function parseAddCliArgs(argv) {
-  const args = [...argv];
-  const options = {
-    moduleId: undefined,
-    project: '.',
-    list: false,
-    help: false,
-  };
-  const positional = [];
-
-  for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i];
-    if (arg === '--') continue;
-
-    if (arg === '-h' || arg === '--help') {
-      options.help = true;
-      continue;
-    }
-
-    if (arg === '--list') {
-      options.list = true;
-      continue;
-    }
-
-    if (arg.startsWith('--project=')) {
-      options.project = arg.split('=')[1] || '.';
-      continue;
-    }
-
-    if (arg === '--project') {
-      if (args[i + 1] && !args[i + 1].startsWith('-')) {
-        options.project = args[i + 1];
-        i += 1;
-      }
-      continue;
-    }
-
-    if (arg.startsWith('--')) {
-      continue;
-    }
-
-    positional.push(arg);
-  }
-
-  if (positional.length > 0) {
-    [options.moduleId] = positional;
-  }
-
-  if (positional.length > 1 && options.project === '.') {
-    options.project = positional[1];
-  }
-
-  return options;
-}
+export function parseAddCliArgs(argv) {
+  const args = [...argv];
+  const options = {
+    moduleId: undefined,
+    project: '.',
+    list: false,
+    help: false,
+  };
+  const positional = [];
+
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === '--') continue;
+
+    if (arg === '-h' || arg === '--help') {
+      options.help = true;
+      continue;
+    }
+
+    if (arg === '--list') {
+      options.list = true;
+      continue;
+    }
+
+    if (arg.startsWith('--project=')) {
+      options.project = arg.split('=')[1] || '.';
+      continue;
+    }
+
+    if (arg === '--project') {
+      if (args[i + 1] && !args[i + 1].startsWith('-')) {
+        options.project = args[i + 1];
+        i += 1;
+      }
+      continue;
+    }
+
+    if (arg.startsWith('--')) {
+      continue;
+    }
+
+    positional.push(arg);
+  }
+
+  if (positional.length > 0) {
+    [options.moduleId] = positional;
+  }
+
+  if (positional.length > 1 && options.project === '.') {
+    options.project = positional[1];
+  }
+
+  return options;
+}

package/src/cli/add-options.test.mjs

@@ -1,24 +1,24 @@
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-import { parseAddCliArgs } from './add-options.mjs';
-
-describe('parseAddCliArgs', () => {
-  it('parses module id and explicit project', () => {
-    const options = parseAddCliArgs(['jwt-auth', '--project', './demo']);
-    assert.equal(options.moduleId, 'jwt-auth');
-    assert.equal(options.project, './demo');
-    assert.equal(options.list, false);
-  });
-
-  it('parses --list and --help', () => {
-    const options = parseAddCliArgs(['--list', '--help']);
-    assert.equal(options.list, true);
-    assert.equal(options.help, true);
-  });
-
-  it('uses second positional as project when project flag is absent', () => {
-    const options = parseAddCliArgs(['queue', './my-app']);
-    assert.equal(options.moduleId, 'queue');
-    assert.equal(options.project, './my-app');
-  });
-});
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { parseAddCliArgs } from './add-options.mjs';
+
+describe('parseAddCliArgs', () => {
+  it('parses module id and explicit project', () => {
+    const options = parseAddCliArgs(['jwt-auth', '--project', './demo']);
+    assert.equal(options.moduleId, 'jwt-auth');
+    assert.equal(options.project, './demo');
+    assert.equal(options.list, false);
+  });
+
+  it('parses --list and --help', () => {
+    const options = parseAddCliArgs(['--list', '--help']);
+    assert.equal(options.list, true);
+    assert.equal(options.help, true);
+  });
+
+  it('uses second positional as project when project flag is absent', () => {
+    const options = parseAddCliArgs(['queue', './my-app']);
+    assert.equal(options.moduleId, 'queue');
+    assert.equal(options.project, './my-app');
+  });
+});

package/src/cli/help.mjs

@@ -1,20 +1,20 @@
-export function printHelp() {
-  console.log(`create-forgeon
-
-Usage:
-  npx create-forgeon@latest <project-name> [options]
-  npx create-forgeon@latest add <module-id> [options]
-  npx create-forgeon@latest add --list
-
-Create options:
-  --i18n <true|false>          Enable i18n (default: true)
-  --proxy <caddy|nginx|none>   Reverse proxy preset (default: caddy)
-  --install                    Run pnpm install after generation
-  -y, --yes                    Skip prompts and use defaults
-  -h, --help                   Show this help
-
-Add options:
-  --project <path>             Target project path (default: current directory)
-  --list                       List available modules
-`);
-}
+export function printHelp() {
+  console.log(`create-forgeon
+
+Usage:
+  npx create-forgeon@latest <project-name> [options]
+  npx create-forgeon@latest add <module-id> [options]
+  npx create-forgeon@latest add --list
+
+Create options:
+  --i18n <true|false>          Enable i18n (default: true)
+  --proxy <caddy|nginx|none>   Reverse proxy preset (default: caddy)
+  --install                    Run pnpm install after generation
+  -y, --yes                    Skip prompts and use defaults
+  -h, --help                   Show this help
+
+Add options:
+  --project <path>             Target project path (default: current directory)
+  --list                       List available modules
+`);
+}

package/src/cli/options.mjs

@@ -1,121 +1,121 @@
-import readline from 'node:readline/promises';
-import { stdin as input, stdout as output } from 'node:process';
-import { DEFAULT_OPTIONS, DEFAULT_PROXY } from '../constants.mjs';
-import { promptSelect } from './prompt-select.mjs';
-
-const REMOVED_FLAGS = new Set(['frontend', 'db', 'docker']);
-
-export function parseCliArgs(argv) {
-  const args = [...argv];
-  const options = { ...DEFAULT_OPTIONS };
-  const positional = [];
-
-  for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i];
-
-    if (arg === '--') continue;
-
-    if (arg === '-h' || arg === '--help') {
-      options.help = true;
-      continue;
-    }
-
-    if (arg === '-y' || arg === '--yes') {
-      options.yes = true;
-      continue;
-    }
-
-    if (arg === '--install') {
-      options.install = true;
-      continue;
-    }
-
-    if (arg.startsWith('--no-')) {
-      const key = arg.slice(5);
-      if (REMOVED_FLAGS.has(key)) {
-        throw new Error(`Option "--${key}" has been removed. Forgeon now uses a fixed stack.`);
-      }
-      if (key === 'install') options.install = false;
-      if (key === 'i18n') options.i18n = false;
-      continue;
-    }
-
-    if (arg.startsWith('--')) {
-      const [keyRaw, inlineValue] = arg.split('=');
-      const key = keyRaw.slice(2);
-      if (REMOVED_FLAGS.has(key)) {
-        throw new Error(`Option "--${key}" has been removed. Forgeon now uses a fixed stack.`);
-      }
-
-      let value = inlineValue;
-      if (value === undefined && args[i + 1] && !args[i + 1].startsWith('-')) {
-        value = args[i + 1];
-        i += 1;
-      }
-
-      if (Object.prototype.hasOwnProperty.call(options, key)) {
-        options[key] = value;
-      }
-
-      continue;
-    }
-
-    positional.push(arg);
-  }
-
-  return { options, positional };
-}
-
-export async function promptForMissingOptions(options) {
-  const nextOptions = { ...options };
-
-  if (!nextOptions.name) {
-    if (!input.isTTY) {
-      throw new Error('Project name is required in non-interactive mode. Pass it as first argument.');
-    }
-
-    const rl = readline.createInterface({ input, output });
-    try {
-      nextOptions.name = await rl.question('Project name: ');
-    } finally {
-      await rl.close();
-    }
-  }
-
-  if (!nextOptions.yes && nextOptions.i18n === undefined) {
-    nextOptions.i18n = await promptSelect({
-      message: 'Enable i18n:',
-      defaultValue: 'true',
-      choices: [
-        { label: 'true', value: 'true' },
-        { label: 'false', value: 'false' },
-      ],
-    });
-  }
-
-  if (!nextOptions.yes && !nextOptions.proxy) {
-    nextOptions.proxy = await promptSelect({
-      message: 'Reverse proxy preset:',
-      defaultValue: DEFAULT_PROXY,
-      choices: [
-        { label: 'caddy', value: 'caddy' },
-        { label: 'nginx', value: 'nginx' },
-        { label: 'none', value: 'none' },
-      ],
-    });
-  }
-
-  if (nextOptions.yes) {
-    if (nextOptions.i18n === undefined) nextOptions.i18n = 'true';
-    if (!nextOptions.proxy) nextOptions.proxy = DEFAULT_PROXY;
-  }
-
-  if (nextOptions.i18n === undefined) {
-    nextOptions.i18n = 'true';
-  }
-  if (!nextOptions.proxy) {
-    nextOptions.proxy = DEFAULT_PROXY;
-  }
-
-  return nextOptions;
-}
+import readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import { DEFAULT_OPTIONS, DEFAULT_PROXY } from '../constants.mjs';
+import { promptSelect } from './prompt-select.mjs';
+
+const REMOVED_FLAGS = new Set(['frontend', 'db', 'docker']);
+
+export function parseCliArgs(argv) {
+  const args = [...argv];
+  const options = { ...DEFAULT_OPTIONS };
+  const positional = [];
+
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+
+    if (arg === '--') continue;
+
+    if (arg === '-h' || arg === '--help') {
+      options.help = true;
+      continue;
+    }
+
+    if (arg === '-y' || arg === '--yes') {
+      options.yes = true;
+      continue;
+    }
+
+    if (arg === '--install') {
+      options.install = true;
+      continue;
+    }
+
+    if (arg.startsWith('--no-')) {
+      const key = arg.slice(5);
+      if (REMOVED_FLAGS.has(key)) {
+        throw new Error(`Option "--${key}" has been removed. Forgeon now uses a fixed stack.`);
+      }
+      if (key === 'install') options.install = false;
+      if (key === 'i18n') options.i18n = false;
+      continue;
+    }
+
+    if (arg.startsWith('--')) {
+      const [keyRaw, inlineValue] = arg.split('=');
+      const key = keyRaw.slice(2);
+      if (REMOVED_FLAGS.has(key)) {
+        throw new Error(`Option "--${key}" has been removed. Forgeon now uses a fixed stack.`);
+      }
+
+      let value = inlineValue;
+      if (value === undefined && args[i + 1] && !args[i + 1].startsWith('-')) {
+        value = args[i + 1];
+        i += 1;
+      }
+
+      if (Object.prototype.hasOwnProperty.call(options, key)) {
+        options[key] = value;
+      }
+
+      continue;
+    }
+
+    positional.push(arg);
+  }
+
+  return { options, positional };
+}
+
+export async function promptForMissingOptions(options) {
+  const nextOptions = { ...options };
+
+  if (!nextOptions.name) {
+    if (!input.isTTY) {
+      throw new Error('Project name is required in non-interactive mode. Pass it as first argument.');
+    }
+
+    const rl = readline.createInterface({ input, output });
+    try {
+      nextOptions.name = await rl.question('Project name: ');
+    } finally {
+      await rl.close();
+    }
+  }
+
+  if (!nextOptions.yes && nextOptions.i18n === undefined) {
+    nextOptions.i18n = await promptSelect({
+      message: 'Enable i18n:',
+      defaultValue: 'true',
+      choices: [
+        { label: 'true', value: 'true' },
+        { label: 'false', value: 'false' },
+      ],
+    });
+  }
+
+  if (!nextOptions.yes && !nextOptions.proxy) {
+    nextOptions.proxy = await promptSelect({
+      message: 'Reverse proxy preset:',
+      defaultValue: DEFAULT_PROXY,
+      choices: [
+        { label: 'caddy', value: 'caddy' },
+        { label: 'nginx', value: 'nginx' },
+        { label: 'none', value: 'none' },
+      ],
+    });
+  }
+
+  if (nextOptions.yes) {
+    if (nextOptions.i18n === undefined) nextOptions.i18n = 'true';
+    if (!nextOptions.proxy) nextOptions.proxy = DEFAULT_PROXY;
+  }
+
+  if (nextOptions.i18n === undefined) {
+    nextOptions.i18n = 'true';
+  }
+  if (!nextOptions.proxy) {
+    nextOptions.proxy = DEFAULT_PROXY;
+  }
+
+  return nextOptions;
+}

package/src/cli/options.test.mjs

@@ -1,41 +1,41 @@
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-import { parseCliArgs } from './options.mjs';
-
-describe('parseCliArgs', () => {
-  it('parses positional name and supported inline options', () => {
-    const { options, positional } = parseCliArgs([
-      'demo-app',
-      '--i18n=false',
-      '--proxy=caddy',
-      '--install',
-      '--yes',
-    ]);
-
-    assert.equal(positional[0], 'demo-app');
-    assert.equal(options.i18n, 'false');
-    assert.equal(options.proxy, 'caddy');
-    assert.equal(options.install, true);
-    assert.equal(options.yes, true);
-  });
-
-  it('parses separated option values and negated i18n flag', () => {
-    const { options } = parseCliArgs(['--proxy', 'none', '--no-i18n', '--help']);
-
-    assert.equal(options.proxy, 'none');
-    assert.equal(options.i18n, false);
-    assert.equal(options.help, true);
-  });
-
-  it('throws for removed stack-selection flags', () => {
-    assert.throws(
-      () => parseCliArgs(['demo', '--frontend=react']),
-      /Option "--frontend" has been removed/,
-    );
-    assert.throws(() => parseCliArgs(['demo', '--db=prisma']), /Option "--db" has been removed/);
-    assert.throws(
-      () => parseCliArgs(['demo', '--docker=true']),
-      /Option "--docker" has been removed/,
-    );
-  });
-});
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { parseCliArgs } from './options.mjs';
+
+describe('parseCliArgs', () => {
+  it('parses positional name and supported inline options', () => {
+    const { options, positional } = parseCliArgs([
+      'demo-app',
+      '--i18n=false',
+      '--proxy=caddy',
+      '--install',
+      '--yes',
+    ]);
+
+    assert.equal(positional[0], 'demo-app');
+    assert.equal(options.i18n, 'false');
+    assert.equal(options.proxy, 'caddy');
+    assert.equal(options.install, true);
+    assert.equal(options.yes, true);
+  });
+
+  it('parses separated option values and negated i18n flag', () => {
+    const { options } = parseCliArgs(['--proxy', 'none', '--no-i18n', '--help']);
+
+    assert.equal(options.proxy, 'none');
+    assert.equal(options.i18n, false);
+    assert.equal(options.help, true);
+  });
+
+  it('throws for removed stack-selection flags', () => {
+    assert.throws(
+      () => parseCliArgs(['demo', '--frontend=react']),
+      /Option "--frontend" has been removed/,
+    );
+    assert.throws(() => parseCliArgs(['demo', '--db=prisma']), /Option "--db" has been removed/);
+    assert.throws(
+      () => parseCliArgs(['demo', '--docker=true']),
+      /Option "--docker" has been removed/,
+    );
+  });
+});