@expressots/cli 4.0.0-preview.2 → 4.0.0-preview.3

package/bin/help/form.js

@@ -5,36 +5,133 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.helpForm = void 0;
 const chalk_1 = __importDefault(require("chalk"));
-const cli_table3_1 = __importDefault(require("cli-table3"));
-const helpForm = async () => {
-    const table = new cli_table3_1.default({
-        head: [
-            chalk_1.default.green("Name"),
-            chalk_1.default.green("Alias"),
-            chalk_1.default.green("Description"),
+const process_1 = require("process");
+const render_1 = require("./render");
+/**
+ * The full command + schematics reference. Shares the exact visual
+ * language of the top-level help screen (see `main-help.ts`) via the
+ * common `renderHelpGroups` helper, but goes deeper: it enumerates every
+ * `generate` schematic and provider sub-command.
+ */
+const RESOURCE_GROUPS = [
+    {
+        title: "Project",
+        entries: [
+            {
+                name: "new",
+                desc: "Generate a new project (application or micro)",
+            },
+            { name: "dev", desc: "Start the development server" },
+            { name: "build", desc: "Build the project for production" },
+            { name: "prod", desc: "Run in production mode" },
+            { name: "info", alias: "i", desc: "Display project information" },
+            { name: "scripts", desc: "Run scripts list or specific scripts" },
+            { name: "help", alias: "h", desc: "Show command help" },
+        ],
+    },
+    {
+        title: "Generate",
+        entries: [
+            {
+                name: "service",
+                alias: "g s",
+                desc: "Service [controller, usecase, dto, module]",
+            },
+            { name: "controller", alias: "g c", desc: "Controller" },
+            { name: "usecase", alias: "g u", desc: "Use case" },
+            { name: "dto", alias: "g d", desc: "DTO" },
+            { name: "entity", alias: "g e", desc: "Entity" },
+            { name: "module", alias: "g mo", desc: "Module" },
+            { name: "middleware", alias: "g mi", desc: "Middleware" },
+            {
+                name: "interceptor",
+                alias: "g i",
+                desc: "Interceptor (--priority)",
+            },
+            { name: "event", alias: "g ev", desc: "Type-safe event" },
+            {
+                name: "handler",
+                alias: "g h",
+                desc: "Event handler (--event, --priority)",
+            },
+            { name: "guard", alias: "g gu", desc: "Authorization guard" },
+            { name: "config", alias: "g cfg", desc: "Config module" },
+        ],
+    },
+    {
+        title: "Providers",
+        entries: [
+            {
+                name: "provider",
+                alias: "g p",
+                desc: "Generate internal provider",
+            },
+            {
+                name: "add",
+                desc: "Add provider to the project (-d for devDependency)",
+            },
+            { name: "remove", desc: "Remove provider from the project" },
+            { name: "create", desc: "Create external provider" },
         ],
-        colWidths: [15, 15, 60],
-    });
-    table.push(
-    // Project commands
-    ["new project", "new", "Generate a new project (application or micro)"], ["info", "i", "Provides project information"], ["resources", "r", "Displays cli commands and resources"], ["scripts", "scripts", "Run scripts list or specific scripts"], ["help", "h", "Show command help"], 
-    // Core schematics
-    [
-        "service",
-        "g s",
-        "Generate a service [controller, usecase, dto, module]",
-    ], ["controller", "g c", "Generate a controller"], ["usecase", "g u", "Generate a usecase"], ["dto", "g d", "Generate a dto"], ["entity", "g e", "Generate an entity"], ["module", "g mo", "Generate a module"], ["middleware", "g mi", "Generate a middleware"], 
-    // v4.0 schematics
-    ["interceptor", "g i", "Generate an interceptor (--priority)"], ["event", "g ev", "Generate a type-safe event"], ["handler", "g h", "Generate an event handler (--event, --priority)"], ["guard", "g gu", "Generate an authorization guard"], ["config", "g cfg", "Generate a config module"], 
-    // Provider commands
-    ["provider", "g p", "Generate internal provider"], [
-        "provider",
-        "add",
-        "Add provider to the project. Use -d to add as dev dependency",
-    ], ["provider", "remove", "Remove provider from the project"], ["provider", "create", "Create external provider"]);
-    console.log(chalk_1.default.bold.white("ExpressoTS:", `${chalk_1.default.green("Resources List")}`));
-    console.log(chalk_1.default.whiteBright(table.toString()));
-    console.log(chalk_1.default.bold.white(`📝 More info: ${chalk_1.default.green("https://doc.expresso-ts.com/docs/category/cli")}`));
-    console.log("\n");
+    },
+    {
+        title: "DevOps",
+        entries: [
+            {
+                name: "containerize",
+                alias: "ctr",
+                desc: "Generate Docker / Kubernetes / Compose configs",
+            },
+            {
+                name: "cicd",
+                alias: "ci",
+                desc: "Generate and manage CI/CD pipelines",
+            },
+            {
+                name: "migrate",
+                alias: "mig",
+                desc: "Generate migration scripts between platforms",
+            },
+            {
+                name: "profile",
+                alias: "prof",
+                desc: "Analyze and optimize container configs",
+            },
+            {
+                name: "container-dev",
+                alias: "cdev",
+                desc: "Develop inside Docker with hot reload",
+            },
+            {
+                name: "costs",
+                alias: "cost",
+                desc: "Estimate and compare cloud deployment costs",
+            },
+            {
+                name: "templates",
+                alias: "tpl",
+                desc: "Manage CI/CD, Docker, and Kubernetes templates",
+            },
+        ],
+    },
+    {
+        title: "Studio & Help",
+        entries: [
+            { name: "studio", desc: "Launch ExpressoTS Studio" },
+            { name: "resources", alias: "r", desc: "Show this reference" },
+            { name: "completion", desc: "Generate a shell completion script" },
+        ],
+    },
+];
+const helpForm = async () => {
+    const lines = [
+        "",
+        `${chalk_1.default.bold.green("🐎 ExpressoTS CLI")}  ${chalk_1.default.dim("·  Command Reference")}`,
+        ...(0, render_1.renderHelpGroups)(RESOURCE_GROUPS),
+        "",
+        `📝  ${chalk_1.default.dim("Docs:")} ${chalk_1.default.green("https://doc.expresso-ts.com/docs/category/cli")}`,
+        "",
+    ];
+    process_1.stdout.write(`${lines.join("\n")}\n`);
 };
 exports.helpForm = helpForm;

package/bin/help/main-help.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Print a refined, grouped, column-aligned top-level help screen.
+ *
+ * Unlike the default yargs help, this drops the repeated `expressots`
+ * prefix on every line and renders aliases inline, keeping the whole
+ * reference compact while still listing every command.
+ */
+export declare function printMainHelp(version?: string): void;

package/bin/help/main-help.js

@@ -0,0 +1,126 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printMainHelp = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const process_1 = require("process");
+const render_1 = require("./render");
+const COMMAND_GROUPS = [
+    {
+        title: "Project",
+        entries: [
+            { name: "new", desc: "Create a new application or micro project" },
+            { name: "dev", desc: "Start the development server" },
+            { name: "build", desc: "Build the project for production" },
+            { name: "prod", desc: "Run in production mode" },
+            { name: "info", alias: "i", desc: "Display project information" },
+            { name: "scripts", desc: "Run one or more package scripts" },
+        ],
+    },
+    {
+        title: "Generate",
+        entries: [
+            {
+                name: "generate",
+                alias: "g",
+                desc: "Scaffold a resource (controller, usecase, dto, ...)",
+            },
+        ],
+    },
+    {
+        title: "Providers",
+        entries: [
+            { name: "create", desc: "Create an external provider" },
+            { name: "add", desc: "Add a provider to the project" },
+            { name: "remove", desc: "Remove a provider from the project" },
+        ],
+    },
+    {
+        title: "DevOps",
+        entries: [
+            {
+                name: "containerize",
+                alias: "ctr",
+                desc: "Generate Docker / Kubernetes / Compose configs",
+            },
+            {
+                name: "cicd",
+                alias: "ci",
+                desc: "Generate and manage CI/CD pipelines",
+            },
+            {
+                name: "migrate",
+                alias: "mig",
+                desc: "Generate migration scripts between platforms",
+            },
+            {
+                name: "profile",
+                alias: "prof",
+                desc: "Analyze and optimize container configs",
+            },
+            {
+                name: "container-dev",
+                alias: "cdev",
+                desc: "Develop inside Docker with hot reload",
+            },
+            {
+                name: "costs",
+                alias: "cost",
+                desc: "Estimate and compare cloud deployment costs",
+            },
+            {
+                name: "templates",
+                alias: "tpl",
+                desc: "Manage CI/CD, Docker, and Kubernetes templates",
+            },
+        ],
+    },
+    {
+        title: "Studio & Help",
+        entries: [
+            { name: "studio", desc: "Launch ExpressoTS Studio" },
+            {
+                name: "resources",
+                alias: "r",
+                desc: "Show full command & schematics reference",
+            },
+            { name: "completion", desc: "Generate a shell completion script" },
+        ],
+    },
+    {
+        title: "Options",
+        entries: [
+            { name: "-h, --help", desc: "Show help" },
+            { name: "-V, --version", desc: "Show version" },
+        ],
+    },
+];
+/**
+ * Print a refined, grouped, column-aligned top-level help screen.
+ *
+ * Unlike the default yargs help, this drops the repeated `expressots`
+ * prefix on every line and renders aliases inline, keeping the whole
+ * reference compact while still listing every command.
+ */
+function printMainHelp(version) {
+    const title = version
+        ? `🐎 ExpressoTS CLI v${version}`
+        : "🐎 ExpressoTS CLI";
+    const lines = [
+        "",
+        chalk_1.default.bold.green(title),
+        "",
+        `${chalk_1.default.bold("Usage:")} expressots <command> [options]`,
+        ...(0, render_1.renderHelpGroups)(COMMAND_GROUPS),
+        "",
+        chalk_1.default.dim("Run 'expressots <command> --help' for details on a command."),
+        "",
+        `🌐  ${chalk_1.default.green("https://expresso-ts.com")}     ` +
+            `💖  ${chalk_1.default.green("https://github.com/sponsors/expressots")}`,
+        "",
+    ];
+    process_1.stdout.write(`${lines.join("\n")}\n`);
+}
+exports.printMainHelp = printMainHelp;

package/bin/help/render.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A single command/option row in a help surface.
+ */
+export interface HelpEntry {
+    name: string;
+    alias?: string;
+    desc: string;
+}
+/**
+ * A titled group of entries (e.g. "Project", "DevOps").
+ */
+export interface HelpGroup {
+    title: string;
+    entries: HelpEntry[];
+}
+/**
+ * Format an alias as `(g)`, or an empty string when there is none.
+ */
+export declare function formatAlias(alias?: string): string;
+/**
+ * Render one aligned row: `  name   alias   description`.
+ */
+export declare function renderRow(entry: HelpEntry, nameWidth: number, aliasWidth: number): string;
+/**
+ * Render grouped, column-aligned rows. A single name/alias width is
+ * computed across *all* groups so every column lines up, giving every
+ * help surface (top-level help, resources reference) one cohesive look.
+ *
+ * Returns the lines (no trailing newline). Each group is preceded by a
+ * blank line and a bold cyan title.
+ */
+export declare function renderHelpGroups(groups: HelpGroup[]): string[];

package/bin/help/render.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderHelpGroups = exports.renderRow = exports.formatAlias = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Format an alias as `(g)`, or an empty string when there is none.
+ */
+function formatAlias(alias) {
+    return alias ? `(${alias})` : "";
+}
+exports.formatAlias = formatAlias;
+/**
+ * Render one aligned row: `  name   alias   description`.
+ */
+function renderRow(entry, nameWidth, aliasWidth) {
+    const name = chalk_1.default.green(entry.name.padEnd(nameWidth));
+    const alias = chalk_1.default.dim(formatAlias(entry.alias).padEnd(aliasWidth));
+    return `  ${name}  ${alias}  ${entry.desc}`;
+}
+exports.renderRow = renderRow;
+/**
+ * Render grouped, column-aligned rows. A single name/alias width is
+ * computed across *all* groups so every column lines up, giving every
+ * help surface (top-level help, resources reference) one cohesive look.
+ *
+ * Returns the lines (no trailing newline). Each group is preceded by a
+ * blank line and a bold cyan title.
+ */
+function renderHelpGroups(groups) {
+    const all = groups.flatMap((g) => g.entries);
+    const nameWidth = Math.max(...all.map((e) => e.name.length));
+    const aliasWidth = Math.max(...all.map((e) => formatAlias(e.alias).length));
+    const lines = [];
+    for (const group of groups) {
+        lines.push("");
+        lines.push(chalk_1.default.bold.cyan(group.title));
+        for (const entry of group.entries) {
+            lines.push(renderRow(entry, nameWidth, aliasWidth));
+        }
+    }
+    return lines;
+}
+exports.renderHelpGroups = renderHelpGroups;

package/bin/info/cli.d.ts

@@ -1,4 +1,4 @@
 import { CommandModule } from "yargs";
-type CommandModuleArgs = {};
+type CommandModuleArgs = object;
 declare const infoProject: () => CommandModule<CommandModuleArgs, any>;
 export { infoProject };

package/bin/info/form.d.ts

@@ -1 +1 @@
-export declare const infoForm: () => void;
+export declare const infoForm: () => Promise<void>;

package/bin/info/form.js

@@ -4,7 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.infoForm = void 0;
-const chalk_1 = __importDefault(require("chalk"));
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
@@ -18,21 +17,22 @@ function getInfosFromPackage() {
         const packageJsonPath = path_1.default.join(absDirPath, "package.json");
         const fileContents = fs_1.default.readFileSync(packageJsonPath, "utf-8");
         const packageJson = JSON.parse(fileContents);
-        console.log(chalk_1.default.green("ExpressoTS Project:"));
-        console.log(chalk_1.default.white(`\tName: ${packageJson.name}`));
-        console.log(chalk_1.default.white(`\tDescription: ${packageJson.description}`));
-        console.log(chalk_1.default.white(`\tVersion: ${packageJson.version}`));
-        console.log(chalk_1.default.white(`\tAuthor: ${packageJson.author}`));
+        (0, cli_ui_1.printSection)("📦 Project");
+        (0, cli_ui_1.printKeyValue)("Name", `${packageJson.name}`);
+        (0, cli_ui_1.printKeyValue)("Description", `${packageJson.description}`);
+        (0, cli_ui_1.printKeyValue)("Version", `${packageJson.version}`);
+        (0, cli_ui_1.printKeyValue)("Author", `${packageJson.author}`);
     }
     catch (error) {
         (0, cli_ui_1.printError)("No project information available.", "package.json not found!");
     }
 }
-const infoForm = () => {
+const infoForm = async () => {
     getInfosFromPackage();
-    console.log(chalk_1.default.green("System information:"));
-    console.log(chalk_1.default.white(`\tOS Version: ${os_1.default.version()}`));
-    console.log(chalk_1.default.white(`\tNodeJS version: ${process.version}`));
-    (0, cli_ui_1.printSuccess)("CLI version:", cli_1.BUNDLE_VERSION);
+    (0, cli_ui_1.printSection)("💻 System");
+    (0, cli_ui_1.printKeyValue)("OS", `${os_1.default.type()} ${os_1.default.release()} (${os_1.default.arch()})`);
+    (0, cli_ui_1.printKeyValue)("Node.js", process.version);
+    (0, cli_ui_1.printKeyValue)("CLI", cli_1.BUNDLE_VERSION);
+    console.log("");
 };
 exports.infoForm = infoForm;

package/bin/migrate/cli.d.ts

@@ -1,5 +1,5 @@
 import { CommandModule } from "yargs";
-type CommandModuleArgs = {};
+type CommandModuleArgs = Record<string, never>;
 export type MigrationSource = "heroku" | "docker-compose" | "vercel" | "aws-ecs" | "gcp-cloudrun" | "azure-container";
 export type MigrationTarget = "railway" | "render" | "fly" | "kubernetes" | "aws-ecs" | "gcp-cloudrun" | "azure-container";
 declare const migrateCommand: () => CommandModule<CommandModuleArgs, any>;

package/bin/migrate/cli.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.migrateCommand = void 0;
 const form_1 = require("./form");
+const cli_ui_1 = require("../utils/cli-ui");
 const migrateCommand = () => {
     return {
         command: "migrate <action> [options]",
@@ -88,7 +89,8 @@ const migrateCommand = () => {
                     await (0, form_1.analyzeMigration)(options);
                     break;
                 default:
-                    console.log(`Unknown action: ${action}`);
+                    (0, cli_ui_1.printError)(`Unknown action: ${action}`, "migrate");
+                    process.exit(1);
             }
         },
     };

package/bin/migrate/form.js

@@ -10,6 +10,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const inquirer_1 = __importDefault(require("inquirer"));
 const platform_detector_1 = require("./analyzers/platform-detector");
 const generators_1 = require("./generators");
+const cli_ui_1 = require("../utils/cli-ui");
 const SUPPORTED_MIGRATIONS = [
     {
         from: "heroku",
@@ -94,7 +95,7 @@ const SUPPORTED_MIGRATIONS = [
  * Interactive migration setup wizard
  */
 async function initMigration(options) {
-    console.log(chalk_1.default.cyan("\n🚀 ExpressoTS Migration Wizard\n"));
+    (0, cli_ui_1.printSection)("🚀 ExpressoTS Migration Wizard");
     // Detect current platform
     const detected = await (0, platform_detector_1.detectCurrentPlatform)();
     if (detected) {
@@ -206,7 +207,7 @@ exports.generateMigration = generateMigration;
  * List available migrations
  */
 async function listMigrations() {
-    console.log(chalk_1.default.cyan("\n📋 Available Migration Paths\n"));
+    (0, cli_ui_1.printSection)("📋 Available Migration Paths");
     // Group by source
     const bySource = SUPPORTED_MIGRATIONS.reduce((acc, m) => {
         if (!acc[m.from])
@@ -233,7 +234,7 @@ exports.listMigrations = listMigrations;
  * Analyze migration complexity
  */
 async function analyzeMigration(options) {
-    console.log(chalk_1.default.cyan("\n🔍 Migration Analysis\n"));
+    (0, cli_ui_1.printSection)("🔍 Migration Analysis");
     const detected = await (0, platform_detector_1.detectCurrentPlatform)();
     const cwd = process.cwd();
     console.log(chalk_1.default.bold("Current Setup:"));

package/bin/new/cli.d.ts

@@ -1,4 +1,8 @@
 import { CommandModule } from "yargs";
 type CommandModuleArgs = object;
+export declare const PACKAGE_MANAGER_CHOICES: readonly ["npm", "yarn", "pnpm", ...string[]];
+export declare const TEMPLATE_CHOICES: readonly ["application", "micro"];
+export declare const MIDDLEWARE_PRESET_CHOICES: readonly ["api", "web", "graphql", "microservice", "minimal"];
+declare const NEW_COMMAND_EPILOG: string;
 declare const createProject: () => CommandModule<CommandModuleArgs, any>;
-export { createProject };
+export { createProject, NEW_COMMAND_EPILOG };

package/bin/new/cli.js

@@ -3,56 +3,103 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createProject = void 0;
-const form_1 = require("./form");
+exports.NEW_COMMAND_EPILOG = exports.createProject = exports.MIDDLEWARE_PRESET_CHOICES = exports.TEMPLATE_CHOICES = exports.PACKAGE_MANAGER_CHOICES = void 0;
+const chalk_1 = __importDefault(require("chalk"));
 const semver_1 = __importDefault(require("semver"));
+const form_1 = require("./form");
 const cli_ui_1 = require("../utils/cli-ui");
-const chalk_1 = __importDefault(require("chalk"));
-const packageManagers = [
+exports.PACKAGE_MANAGER_CHOICES = [
     "npm",
     "yarn",
     "pnpm",
     ...(process.platform !== "win32" ? ["bun"] : []),
 ];
-const middlewarePresets = [
+exports.TEMPLATE_CHOICES = ["application", "micro"];
+exports.MIDDLEWARE_PRESET_CHOICES = [
     "api",
     "web",
     "graphql",
     "microservice",
     "minimal",
 ];
+const formatInlineChoices = (choices) => choices.join(", ");
+const NEW_COMMAND_EPILOG = [
+    chalk_1.default.bold("Available choices"),
+    "",
+    chalk_1.default.bold("Templates") + ` (${formatInlineChoices(exports.TEMPLATE_CHOICES)})`,
+    "  application   Full REST/GraphQL API (DI, controllers, lifecycle, presets)",
+    "  micro         Single-file HTTP service via micro(), no DI container",
+    chalk_1.default.dim("  Tip: add -e / --events with application to scaffold application-with-events"),
+    "",
+    chalk_1.default.bold("Package managers") +
+        ` (${formatInlineChoices(exports.PACKAGE_MANAGER_CHOICES)})`,
+    ...(process.platform === "win32"
+        ? [chalk_1.default.dim("  bun is not available on Windows")]
+        : []),
+    "",
+    chalk_1.default.bold("Middleware presets") +
+        ` (${formatInlineChoices(exports.MIDDLEWARE_PRESET_CHOICES)})` +
+        chalk_1.default.dim(" (application template only)"),
+    "  api            REST API: security, compression, rate limit (default)",
+    "  web            api + cookies and session",
+    "  graphql        GraphQL stack + Apollo scaffold",
+    "  microservice   Minimal parsing + compression",
+    "  minimal        parse() only; wire the rest yourself",
+    "",
+    chalk_1.default.bold("Flags"),
+    "  -e, --events   boolean: use application-with-events (not a separate -t value)",
+    "",
+    chalk_1.default.bold("Provider packages") +
+        chalk_1.default.dim(" (not expressots new): expressots create --provider <name>"),
+    "",
+    chalk_1.default.bold("Silent vs interactive"),
+    "  Pass -t and -p together for non-interactive scaffold (CI-friendly).",
+    "  Omit both for prompts (template, package manager, preset, events).",
+].join("\n");
+exports.NEW_COMMAND_EPILOG = NEW_COMMAND_EPILOG;
 const commandOptions = (yargs) => {
+    const terminalWidth = typeof process.stdout.columns === "number" && process.stdout.columns > 0
+        ? Math.max(process.stdout.columns, 100)
+        : 120;
     return yargs
+        .wrap(terminalWidth)
         .positional("project-name", {
         describe: "The name of the project",
         type: "string",
     })
         .option("template", {
-        describe: "The project template to use",
+        describe: "Project template",
         type: "string",
-        choices: ["application", "micro"],
+        choices: [...exports.TEMPLATE_CHOICES],
         alias: "t",
     })
         .option("package-manager", {
-        describe: "The package manager to use",
+        describe: "Package manager",
         type: "string",
-        choices: packageManagers,
+        choices: [...exports.PACKAGE_MANAGER_CHOICES],
         alias: "p",
     })
         .option("preset", {
-        describe: "Middleware preset for Application template",
+        describe: "Middleware preset (application template only)",
         type: "string",
-        choices: middlewarePresets,
+        choices: [...exports.MIDDLEWARE_PRESET_CHOICES],
         alias: "s",
+    })
+        .option("events", {
+        describe: "Scaffold application-with-events (boolean flag; do not pass a value)",
+        type: "boolean",
+        alias: "e",
     })
         .option("directory", {
-        describe: "The directory for new project",
+        describe: "Parent directory for the new project",
         type: "string",
         alias: "d",
     })
         .implies("package-manager", "template")
         .implies("template", "package-manager")
-        .implies("preset", "template");
+        .implies("preset", "template")
+        .implies("events", "template")
+        .epilog(NEW_COMMAND_EPILOG);
 };
 const checkNodeVersion = () => {
     const minVersion = "20.0.0";
@@ -68,13 +115,14 @@ const createProject = () => {
         command: "new <project-name> [package-manager] [template] [directory]",
         describe: "Create ExpressoTS application.",
         builder: commandOptions,
-        handler: async ({ projectName, packageManager, template, directory, preset, }) => {
+        handler: async ({ projectName, packageManager, template, directory, preset, events, }) => {
             checkNodeVersion();
             return await (0, form_1.projectForm)(projectName, [
                 packageManager,
                 template,
                 directory,
                 preset,
+                events,
             ]);
         },
     };

package/bin/new/form.d.ts

@@ -3,6 +3,7 @@
  */
 declare enum Template {
     application = "Application :: Full-featured ExpressoTS application. (Recommended)",
+    applicationWithEvents = "Application with Events :: Application template pre-wired with the type-safe Event Bus example.",
     micro = "Micro :: A minimalistic template for building micro APIs and serverless functions."
 }
 declare const enum PackageManager {
@@ -27,7 +28,8 @@ type ProjectFormArgs = [
     PackageManager,
     TemplateKeys,
     string,
-    MiddlewarePresetKeys
+    MiddlewarePresetKeys,
+    boolean | undefined
 ];
 /**
  * Main project creation form