@ykdz/template 0.0.6 → 0.0.7

package/dist/src/cli.js

@@ -12,7 +12,12 @@ import { renderNewProject } from "./renderer.js";
 import { resolveToolchainVersions, } from "./toolchain-resolution.js";
 function usage() {
     return [
+        "Project Kit template CLI",
+        "",
         "Usage:",
+        "  template <command> [options]",
+        "",
+        "Commands:",
         "  template init <dir> --preset <name> --yes",
         "  template add package --preset <name> --name <name> [--path <package-path>] [--link-from <package-path>]...",
         "  template presets",
@@ -24,14 +29,14 @@ function usage() {
         "  template blueprint validate <path>",
         "",
         "Options:",
-        "  --preset <name>  Project preset to generate",
-        "  --name <name>    Package name to add",
-        "  --path <path>    Two-segment Package Path to add",
+        "  --preset <name>     Project preset to generate",
+        "  --name <name>       Package name to add",
+        "  --path <path>       Two-segment Package Path to add",
         "  --link-from <path>  Existing consumer Package Path to link from; repeatable",
-        "  --scope <name>   Package scope for workspace package names",
-        "  --yes            Accept defaults for non-interactive generation",
-        "  --dry-run        Print the planned generation without writing files",
-        "  --json           Print machine-readable output",
+        "  --scope <name>      Package scope for workspace package names",
+        "  --yes               Accept defaults for non-interactive generation",
+        "  --dry-run           Print the planned generation without writing files",
+        "  --json              Print machine-readable output",
     ].join("\n");
 }
 function printJson(value) {
@@ -56,10 +61,18 @@ function formatValidationIssues(issues) {
         .map((issue) => `  - ${issue.path}: ${issue.message}`)
         .join("\n");
 }
+function formatFieldRows(rows) {
+    const width = Math.max(...rows.map(([label]) => `${label}:`.length));
+    return rows.map(([label, value]) => `  ${`${label}:`.padEnd(width)} ${value}`);
+}
 function formatPresetCatalog() {
     return [
         "Built-in presets",
-        ...builtInPresets.map((preset) => `  ${preset.name.padEnd(8)} ${preset.title} (${preset.generation}) - ${preset.description}`),
+        "",
+        ...formatFieldRows(builtInPresets.map((preset) => [
+            preset.name,
+            `${preset.title} (${preset.generation}) - ${preset.description}`,
+        ])),
     ].join("\n");
 }
 function parseInitOptions(args) {
@@ -145,23 +158,29 @@ function blueprintForInit(options) {
     });
 }
 function formatBlueprintSummary(targetDir, blueprint) {
-    const lines = [
-        "Project Blueprint",
-        `  Target: ${targetDir}`,
-        `  Preset: ${blueprint.preset}`,
-        `  Project kind: ${blueprint.projectKind}`,
+    const rows = [
+        ["Target", targetDir],
+        ["Preset", blueprint.preset],
+        ["Project kind", blueprint.projectKind],
     ];
     if (blueprint.packageManager) {
-        lines.push(`  Package manager: ${blueprint.packageManager}`);
-    }
-    if (blueprint.packages) {
-        lines.push("  Packages:");
-        for (const pkg of blueprint.packages) {
-            lines.push(`    - ${pkg.name} (${pkg.path})`);
-        }
+        rows.push(["Package manager", blueprint.packageManager]);
     }
-    lines.push(`  Features: ${blueprint.features.join(", ")}`);
-    return lines.join("\n");
+    return [
+        "Project Blueprint",
+        "",
+        ...formatFieldRows(rows),
+        ...(blueprint.packages
+            ? [
+                "",
+                "  Packages:",
+                ...blueprint.packages.map((pkg) => `    - ${pkg.name} (${pkg.path})`),
+            ]
+            : []),
+        "",
+        "  Features:",
+        ...blueprint.features.map((feature) => `    - ${feature}`),
+    ].join("\n");
 }
 function formatProjectionNextSteps(targetDir, projectionPlan) {
     const steps = planNextStepInstructionsForProjection({
@@ -170,7 +189,11 @@ function formatProjectionNextSteps(targetDir, projectionPlan) {
     });
     return [
         "Next Step Instructions:",
-        ...steps.map((step) => `  ${step.label}: ${step.display}`),
+        "",
+        ...steps.flatMap((step, index) => [
+            `  ${index + 1}. ${step.label}`,
+            `     ${step.display}`,
+        ]),
     ].join("\n");
 }
 function toolchainReport(toolchain) {
@@ -184,9 +207,12 @@ function toolchainReport(toolchain) {
 function formatToolchainReport(toolchain) {
     return [
         "Toolchain Resolution:",
-        `  Source: ${toolchain.source}`,
-        `  Node LTS major: ${toolchain.nodeLtsMajor.value}`,
-        `  Package Manager Pin: ${toolchain.packageManagerPin.value}`,
+        "",
+        ...formatFieldRows([
+            ["Source", toolchain.source],
+            ["Node LTS major", toolchain.nodeLtsMajor.value],
+            ["Package Manager Pin", toolchain.packageManagerPin.value],
+        ]),
         ...toolchain.diagnostics.map((diagnostic) => `  ${diagnostic}`),
     ].join("\n");
 }
@@ -256,10 +282,19 @@ function printInitComplete(options, blueprint, generationContext) {
         });
         return;
     }
-    console.log(`Initialized ${options.preset} project in ${options.dir}`);
+    console.log([
+        "Initialized project",
+        "",
+        ...formatFieldRows([
+            ["Preset", options.preset],
+            ["Target", options.dir],
+        ]),
+    ].join("\n"));
     if (generationContext) {
+        console.log("");
         console.log(formatToolchainReport(generationContext.toolchain));
     }
+    console.log("");
     console.log(formatProjectionNextSteps(options.dir, projectionPlan));
 }
 function isInteractiveTerminal() {
@@ -438,8 +473,10 @@ async function main(args) {
             }
             console.log(formatBlueprintSummary(options.dir, blueprint));
             if (generationContext) {
+                console.log("");
                 console.log(formatToolchainReport(generationContext.toolchain));
             }
+            console.log("");
             console.log(formatProjectionNextSteps(options.dir, projectionPlan));
             return;
         }
@@ -463,7 +500,15 @@ async function main(args) {
             path: options.path,
             linkFrom: options.linkFrom,
         });
-        console.log(`Added ${options.preset} package ${options.name}`);
+        console.log([
+            "Added package",
+            "",
+            ...formatFieldRows([
+                ["Preset", options.preset],
+                ["Name", options.name],
+                ...(options.path ? [["Path", options.path]] : []),
+            ]),
+        ].join("\n"));
         return;
     }
     if (command === "--help" || command === "-h") {
@@ -474,8 +519,8 @@ async function main(args) {
 }
 main(process.argv.slice(2)).catch((error) => {
     const message = error instanceof Error ? error.message : String(error);
-    console.error(message);
+    console.error(`Error: ${message}`);
     console.error("");
-    console.error(usage());
+    console.error("Run `template --help` for usage.");
     process.exitCode = 1;
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ykdz/template",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "private": false,
   "description": "Project template generator for YKDZ starter projects.",
   "keywords": [