ember.nvp 1.10.0 → 1.11.0

package/.release-plan.json

@@ -2,17 +2,13 @@
   "solution": {
     "ember.nvp": {
       "impact": "minor",
-      "oldVersion": "1.9.0",
-      "newVersion": "1.10.0",
+      "oldVersion": "1.10.0",
+      "newVersion": "1.11.0",
       "tagName": "latest",
       "constraints": [
         {
           "impact": "minor",
           "reason": "Appears in changelog section :rocket: Enhancement"
-        },
-        {
-          "impact": "patch",
-          "reason": "Appears in changelog section :bug: Bug Fix"
         }
       ],
       "pkgJSONPath": "./package.json"
@@ -21,25 +17,11 @@
       "oldVersion": "1.2.0"
     },
     "@nullvoxpopuli/ember-rolldown": {
-      "impact": "minor",
-      "oldVersion": "2.9.0",
-      "newVersion": "2.10.0",
-      "tagName": "latest",
-      "constraints": [
-        {
-          "impact": "minor",
-          "reason": "Appears in changelog section :rocket: Enhancement"
-        },
-        {
-          "impact": "patch",
-          "reason": "Appears in changelog section :bug: Bug Fix"
-        }
-      ],
-      "pkgJSONPath": "./packages/rolldown/package.json"
+      "oldVersion": "2.10.0"
     },
     "@nullvoxpopuli/ember-vite": {
       "oldVersion": "1.2.0"
     }
   },
-  "description": "## Release (2026-09-30)\n\n* ember.nvp 1.10.0 (minor)\n* @nullvoxpopuli/ember-rolldown 2.10.0 (minor)\n\n#### :rocket: Enhancement\n* `ember.nvp`, `@nullvoxpopuli/ember-rolldown`\n  * [#144](https://github.com/NullVoxPopuli/ember.nvp/pull/144) Layer options, with an ESLint preset and a TypeScript version ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#142](https://github.com/NullVoxPopuli/ember.nvp/pull/142) Add a TypeScript 7.1+ layer ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`\n  * [#140](https://github.com/NullVoxPopuli/ember.nvp/pull/140) Point .gts declaration maps at the .gts source ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n\n#### :bug: Bug Fix\n* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`\n  * [#145](https://github.com/NullVoxPopuli/ember.nvp/pull/145) Make .gts source maps point at the real source ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#140](https://github.com/NullVoxPopuli/ember.nvp/pull/140) Point .gts declaration maps at the .gts source ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n\n#### Committers: 1\n- @NullVoxPopuli's reduced-access machine account for AI usage ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n"
+  "description": "## Release (2026-09-30)\n\n* ember.nvp 1.11.0 (minor)\n\n#### :rocket: Enhancement\n* `ember.nvp`\n  * [#146](https://github.com/NullVoxPopuli/ember.nvp/pull/146) Better help ([@tcjr](https://github.com/tcjr))\n\n#### Committers: 1\n- Tom Carter ([@tcjr](https://github.com/tcjr))\n"
 }

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Release (2026-09-30)
 
+* ember.nvp 1.11.0 (minor)
+
+#### :rocket: Enhancement
+* `ember.nvp`
+  * [#146](https://github.com/NullVoxPopuli/ember.nvp/pull/146) Better help ([@tcjr](https://github.com/tcjr))
+
+#### Committers: 1
+- Tom Carter ([@tcjr](https://github.com/tcjr))
+
+## Release (2026-09-30)
+
 * ember.nvp 1.10.0 (minor)
 * @nullvoxpopuli/ember-rolldown 2.10.0 (minor)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ember.nvp",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "ember project generator, alternative to the official blueprints, but more modern -- hopefully one day to upstream back in to ember-cli / official blueprints",
   "repository": {
     "type": "git",

package/src/cli/args.js

@@ -1,6 +1,6 @@
 import * as p from "@clack/prompts";
 import { styleText, parseArgs } from "node:util";
-import { layers as discoveredLayers } from "#layers";
+import { layers as discoveredLayers, layerNames } from "#layers";
 import { validateOption } from "./questions/validate-option.js";
 import { printHelp } from "./help.js";
 
@@ -36,7 +36,8 @@ export const coreOptions = /** @type {const} */ ({
   layers: {
     type: "string",
     multiple: true,
-    description: "Layers to apply to the project (repeat for multiple layers)",
+    choices: layerNames,
+    description: "Layers to apply to the project",
   },
 
   packageManager: {

package/src/cli/help.js

@@ -30,6 +30,7 @@ export function printHelp(coreOptions, layers = []) {
       flag: `--${name}`,
       alias: config.short ? `-${config.short}, ` : "    ",
       type: config.type,
+      multiple: config.multiple,
       description: config.description,
       choices: config.choices,
     });
@@ -41,6 +42,7 @@ export function printHelp(coreOptions, layers = []) {
 
   console.log(styleText("bold", "Layer Options:"));
   for (const layer of withOptions) {
+    console.log(`  Layer: ${styleText(["cyan", "bold"], layer.name)}`);
     for (const [key, schema] of Object.entries(layer.options ?? {})) {
       const name = `${layer.name}.${key}`;
 
@@ -48,6 +50,7 @@ export function printHelp(coreOptions, layers = []) {
         flag: schema.type === "confirm" ? `--[no-]${name}` : `--${name}`,
         alias: "    ",
         type: FLAG_TYPES[schema.type],
+        multiple: schema.type === "multiselect",
         description: schema.prompt,
         choices: schema.options?.map((choice) => choice.value),
         fallback: schema.default,
@@ -61,20 +64,27 @@ export function printHelp(coreOptions, layers = []) {
  *   flag: string,
  *   alias: string,
  *   type?: string,
+ *   multiple?: boolean,
  *   description?: string,
  *   choices?: string[],
  *   fallback?: unknown,
  * }} option
  */
-function printOption({ flag, alias, type, description = "", choices, fallback }) {
+function printOption({ flag, alias, type, multiple, description = "", choices, fallback }) {
   const typeStr = type ? styleText("dim", `<${type}>`) : "";
+  const repeatStr = multiple
+    ? type
+      ? ` ${styleText("dim", "[")}${styleText("cyan", flag)} ${typeStr}${styleText("dim", " ...]")}`
+      : ` ${styleText("dim", "[")}${styleText("cyan", flag)}${styleText("dim", " ...]")}`
+    : "";
+  const flagAndType = [styleText("cyan", flag), typeStr].filter(Boolean).join(" ");
   const choicesStr = choices
     ? styleText("yellow", ` [choices: ${choices.map((c) => `"${c}"`).join(", ")}]`)
     : "";
   const fallbackStr =
     fallback === undefined ? "" : styleText("dim", ` [default: ${JSON.stringify(fallback)}]`);
 
-  console.log(`  ${styleText("cyan", alias)}${styleText("cyan", flag)} ${typeStr}`);
+  console.log(`  ${styleText("cyan", alias)}${flagAndType}${repeatStr}`);
   if (description || choicesStr || fallbackStr) {
     console.log(`      ${description}${choicesStr}${fallbackStr}`);
   }

package/test/ember.nvp/cli.test.ts

@@ -37,8 +37,8 @@ const BASIC_HELP_OUTPUT = `
           --confirm <string>
           Bypass target confirmation step [choices: "yes", "no"]
 
-          --layers <string>
-          Layers to apply to the project (repeat for multiple layers)
+          --layers <string> [--layers <string> ...]
+          Layers to apply to the project [choices: "are-the-types-wrong", "eslint-bundled", "expect-type", "git", "github-actions", "inspector-support", "prettier", "publint", "qunit", "readme", "renovate", "typescript", "vitest"]
 
           --packageManager <string>
           Package manager to configure for the project [choices: "npm", "pnpm"]
@@ -50,9 +50,11 @@ const BASIC_HELP_OUTPUT = `
           Confirm writing changes to disk [choices: "yes", "no"]
 
     Layer Options:
+      Layer: eslint-bundled
           --eslint-bundled.preset <string>
           Which ESLint config? [choices: "ember", "nvp"] [default: "ember"]
 
+      Layer: typescript
           --typescript.version <string>
           Which TypeScript version? [choices: "7", "6"] [default: "7"]
     "

package/test/ember.nvp/layer-options.test.ts

@@ -228,6 +228,7 @@ describe("Layer Options Feature", () => {
 
     expect(output.slice(output.indexOf("Layer Options:"))).toMatchInlineSnapshot(`
       "Layer Options:
+        Layer: fake-kitchen-sink
             --fake-kitchen-sink.unitCount <number>
             How many units do you want? [default: 7]
 
@@ -240,7 +241,7 @@ describe("Layer Options Feature", () => {
             --[no-]fake-kitchen-sink.enableLogging <boolean>
             Enable detailed sink logging? [default: true]
 
-            --fake-kitchen-sink.extras <string>
+            --fake-kitchen-sink.extras <string> [--fake-kitchen-sink.extras <string> ...]
             Select optional kitchen sink extras [choices: "soap-dispenser", "garbage-disposal"] [default: ["soap-dispenser"]]
       "
     `);