create-bestax 4.2.12 → 4.2.14

package/README.md

@@ -29,9 +29,6 @@ npm create bestax@latest my-app
 
 # Using npx
 npx create-bestax@latest my-app
-
-# Alternative naming
-npm create bestax-bulma@latest my-app
 ```
 
 ### Interactive Mode
@@ -44,9 +41,10 @@ npm create bestax@latest
 
 You'll be asked to:
 
-1. Enter a project name
+1. Enter a project name (and, if that directory already holds files, confirm removing them;
+   nothing is removed until you have answered the last question)
 2. Select a framework (Vite or Vite + TypeScript)
-3. Choose a Bulma CSS flavor (Complete or Minimal)
+3. Choose a Bulma CSS flavor (the `--bulma` options below)
 4. Select an icon library (Font Awesome, Material Icons, etc.)
 5. Choose whether to install the bestax AI skills into `.claude/skills/`
 
@@ -55,12 +53,17 @@ Every prompt has a flag equivalent, so the whole flow is scriptable and CI-frien
 ### Command Line Options
 
 ```bash
-npm create bestax@latest [project-directory] [options]
+npm create bestax@latest [project-directory] -- [options]
 ```
 
+Put the options after `--`. npm needs it to pass them on at all, and so does bun, whose
+`bun create` rejects short flags such as `-t` and `-y` itself. pnpm and Yarn 1 accept the options
+with or without it.
+
 **Arguments:**
 
-- `[project-directory]` - Optional project directory name
+- `[project-directory]` - Optional project directory name. It also becomes the `package.json`
+  name, lower-cased the way `npm init` does and without a leading `_`, since npm rejects both.
 
 **Options:**
 
@@ -91,14 +94,24 @@ npm create bestax@latest [project-directory] [options]
   - Icon library: `none`
   - AI skills: installed (pass `--no-skills` to opt out)
 
+  `-y` never deletes files. If the target directory is not empty, the run stops, lists what is
+  there, and changes nothing; add `--overwrite` to empty it first. Earlier versions emptied the
+  directory under `-y` alone, so a script that relied on that now needs `--overwrite`.
+
+- `--overwrite` - Remove existing files if the target directory is not empty, without asking.
+  Every other flag is checked first, so a typo stops the run before anything is deleted.
+
 **Example:**
 
 ```bash
 # Create a TypeScript project with Font Awesome icons
-npm create bestax@latest my-app -t vite-ts -i fontawesome -b complete
+npm create bestax@latest my-app -- -t vite-ts -i fontawesome -b complete
 
 # Use all defaults (skip prompts)
-npm create bestax@latest my-app -y
+npm create bestax@latest my-app -- -y
+
+# The same with bun
+bun create bestax@latest my-app -- -y
 ```
 
 ## Templates

package/dist/cli.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import { ProjectCreator, type CLIOptions } from './project-creator.js';
+import { ProjectCreator, type CLIOptions, type ExistingDirectoryPlan } from './project-creator.js';
 export { validateProjectName } from './validators.js';
 export { TEMPLATES, ICON_LIBRARIES, BULMA_FLAVORS } from './constants.js';
 export type { ProjectConfig, CLIOptions } from './project-creator.js';
@@ -10,11 +10,21 @@ export { displayHeader, displaySuccess } from './display.js';
 export { promptProjectName, promptOverwriteDirectory, promptTemplate as selectTemplate, promptIconLibrary as selectIconLibrary, promptBulmaFlavor as selectBulmaFlavor, } from './prompts.js';
 export { checkDirectoryExists, isDirectoryEmpty, copyDirectory, updatePackageJson, } from './file-system.js';
 export declare function getProjectName(projectDir?: string): Promise<string | null>;
-export declare function checkExistingDirectory(targetPath: string, targetDir: string): Promise<boolean>;
+export declare function checkExistingDirectory(targetPath: string, targetDir: string): Promise<ExistingDirectoryPlan>;
 export declare function getTemplatePath(template: string): string;
 export declare function copyTemplate(templatePath: string, targetPath: string): Promise<void>;
 export declare function createProject(projectDir?: string, options?: CLIOptions): Promise<void>;
 export declare function createCLI(): Command;
 export declare function isMainModule(importMetaUrl: string, argv1: string): boolean;
-export declare function runCLI(): Promise<void>;
+/**
+ * pnpm, bun and bunx hand a `--` to the scaffolder as it was typed, where npm
+ * and Yarn 1 strip it, so `pnpm create bestax my-app -- -t vite-ts` arrives as
+ * `my-app -- -t vite-ts`. Commander reads `--` as the end of the options, and
+ * every flag after it became an extra argument: "too many arguments" (#950).
+ * Bun users need that `--`, because `bun create` rejects short flags such as
+ * `-t` and `-y` itself. So the first `--` after the script path is dropped
+ * before parsing, and a second keeps its usual meaning.
+ */
+export declare function dropForwardedSeparator(argv: readonly string[]): string[];
+export declare function runCLI(argv?: readonly string[]): Promise<void>;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAIvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGzE,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,IAAI,cAAc,EAChC,iBAAiB,IAAI,iBAAiB,EACtC,iBAAiB,IAAI,iBAAiB,GACvC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,wBAAsB,cAAc,CAClC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,aAAa,CACjC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf;AAcD,wBAAgB,SAAS,IAAI,OAAO,CA+BnC;AAED,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAG5C"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EACL,cAAc,EACd,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGzE,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,IAAI,cAAc,EAChC,iBAAiB,IAAI,iBAAiB,EACtC,iBAAiB,IAAI,iBAAiB,GACvC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,wBAAsB,cAAc,CAClC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,CAAC,CAGhC;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,aAAa,CACjC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf;AAcD,wBAAgB,SAAS,IAAI,OAAO,CAsCnC;AAED,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAKxE;AAED,wBAAsB,MAAM,CAC1B,IAAI,GAAE,SAAS,MAAM,EAAiB,GACrC,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/cli.js

@@ -3,7 +3,7 @@ import { Command } from 'commander';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
-import { ProjectCreator } from './project-creator.js';
+import { ProjectCreator, } from './project-creator.js';
 import { copyDirectory } from './file-system.js';
 // Re-export for backward compatibility with tests
 export { validateProjectName } from './validators.js';
@@ -61,7 +61,8 @@ export function createCLI() {
         .option('--no-skills', 'do not install the bestax AI skills')
         .option('--telemetry', 'enable anonymous usage telemetry (https://bestax.io/docs/guides/telemetry)')
         .option('--no-telemetry', 'disable anonymous usage telemetry')
-        .option('-y, --yes', 'skip prompts and use defaults or provided options')
+        .option('-y, --yes', 'skip prompts and use defaults or provided options (never removes files: see --overwrite)')
+        .option('--overwrite', 'remove existing files if the target directory is not empty')
         .action(async (projectDir, options) => {
         await projectCreator.create(projectDir, options);
     });
@@ -70,9 +71,24 @@ export function createCLI() {
 export function isMainModule(importMetaUrl, argv1) {
     return importMetaUrl === `file://${argv1}`;
 }
-export async function runCLI() {
+/**
+ * pnpm, bun and bunx hand a `--` to the scaffolder as it was typed, where npm
+ * and Yarn 1 strip it, so `pnpm create bestax my-app -- -t vite-ts` arrives as
+ * `my-app -- -t vite-ts`. Commander reads `--` as the end of the options, and
+ * every flag after it became an extra argument: "too many arguments" (#950).
+ * Bun users need that `--`, because `bun create` rejects short flags such as
+ * `-t` and `-y` itself. So the first `--` after the script path is dropped
+ * before parsing, and a second keeps its usual meaning.
+ */
+export function dropForwardedSeparator(argv) {
+    const separator = argv.indexOf('--', 2);
+    return separator === -1
+        ? [...argv]
+        : [...argv.slice(0, separator), ...argv.slice(separator + 1)];
+}
+export async function runCLI(argv = process.argv) {
     const program = createCLI();
-    await program.parseAsync();
+    await program.parseAsync(dropForwardedSeparator(argv));
 }
 // Only run if this is the main module
 /* istanbul ignore next */

package/dist/constants.d.ts

@@ -8,14 +8,19 @@ export declare const TEMPLATES: Template[];
 export declare const DEFAULT_PROJECT_NAME = "my-bestax-app";
 export declare const MAX_PROJECT_NAME_LENGTH = 214;
 export declare const PROJECT_NAME_REGEX: RegExp;
+export declare const MAX_LISTED_ENTRIES = 5;
 export declare const MESSAGES: {
     readonly PROJECT_NAME_REQUIRED: "Project name is required";
     readonly PROJECT_NAME_TOO_LONG: "Project name too long";
     readonly PROJECT_NAME_INVALID_CHARS: "Project name can only contain letters, numbers, dots, dashes and underscores";
     readonly PROJECT_NAME_DOT: "Project name cannot start with a dot (names like \".\" or \"..\" would scaffold outside a new directory) — pass a directory name";
+    readonly PROJECT_NAME_NO_PACKAGE_NAME: "Project name must contain a letter, number or dash (npm package names cannot start with \"_\" or \".\")";
+    readonly PACKAGE_NAME_NORMALIZED: (name: string) => string;
     readonly OPERATION_CANCELLED: "✖ Operation cancelled";
     readonly NO_TTY: string;
-    readonly DIRECTORY_NOT_EMPTY: (dir: string) => string;
+    readonly DIRECTORY_NOT_EMPTY: (dir: string, entries: string[]) => string;
+    readonly NOT_A_DIRECTORY: (dir: string) => string;
+    readonly DIRECTORY_NOT_EMPTY_REFUSED: (dir: string, entries: string[]) => string;
     readonly EMPTYING_DIRECTORY: (dir: string) => string;
     readonly CREATING_PROJECT: (path: string) => string;
     readonly TEMPLATE_NOT_FOUND: (template: string) => string;
@@ -23,6 +28,7 @@ export declare const MESSAGES: {
     readonly NEXT_STEPS: "Next steps:";
     readonly HAPPY_CODING: "Happy coding! 🎉";
     readonly SKILLS_ADDED: "✔ Installed bestax AI skills into .claude/skills/ (+ CLAUDE.md, .claude/launch.json)";
+    readonly ICON_CSS_NOT_ADDED: (file: string, importStatement: string) => string;
     readonly TELEMETRY_NOTICE: string;
     readonly TELEMETRY_ACK_ON: "Thanks! Opt out anytime with --no-telemetry.";
     readonly TELEMETRY_ACK_OFF: "No problem — we won't ask again.";

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,SAAS,EAAE,QAAQ,EAG/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,kBAAkB,QAAsB,CAAC;AAEtD,eAAO,MAAM,QAAQ;;;;;;;wCAaQ,MAAM;uCAEP,MAAM;sCACP,MAAM;4CAEA,MAAM;;;;;;;;;CAiB7B,CAAC;AASX,eAAO,MAAM,WAAW,QAed,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;;;CAQV,CAAC;AAOX,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK9D,CAAC;AAKF,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,SAAS,GACpB,aAAa,MAAM,EACnB,8BAA8B,eAAe,KAC5C,MAoIF,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc,EAAE,WAAW,EA6CvC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EA4CtC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,SAAS,EAAE,QAAQ,EAG/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,kBAAkB,QAAsB,CAAC;AAGtD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAOpC,eAAO,MAAM,QAAQ;;;;;;6CASa,MAAM;;;wCAQX,MAAM,WAAW,MAAM,EAAE;oCAE7B,MAAM;gDAIM,MAAM,WAAW,MAAM,EAAE;uCAIlC,MAAM;sCACP,MAAM;4CAEA,MAAM;;;;;wCAMV,MAAM,mBAAmB,MAAM;;;;;CAclD,CAAC;AASX,eAAO,MAAM,WAAW,QAed,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;;;CAQV,CAAC;AAOX,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK9D,CAAC;AAKF,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,SAAS,GACpB,aAAa,MAAM,EACnB,8BAA8B,eAAe,KAC5C,MAmIF,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc,EAAE,WAAW,EA6CvC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EA4CtC,CAAC"}

package/dist/constants.js

@@ -6,17 +6,31 @@ export const TEMPLATES = [
 export const DEFAULT_PROJECT_NAME = 'my-bestax-app';
 export const MAX_PROJECT_NAME_LENGTH = 214;
 export const PROJECT_NAME_REGEX = /^[a-zA-Z0-9-._]+$/;
+// How many of a non-empty directory's entries a message names before it
+// switches to "and N more".
+export const MAX_LISTED_ENTRIES = 5;
+const listEntries = (entries) => entries.length > MAX_LISTED_ENTRIES
+    ? `${entries.slice(0, MAX_LISTED_ENTRIES).join(', ')} and ${entries.length - MAX_LISTED_ENTRIES} more`
+    : entries.join(', ');
 export const MESSAGES = {
     PROJECT_NAME_REQUIRED: 'Project name is required',
     PROJECT_NAME_TOO_LONG: 'Project name too long',
     PROJECT_NAME_INVALID_CHARS: 'Project name can only contain letters, numbers, dots, dashes and underscores',
     PROJECT_NAME_DOT: 'Project name cannot start with a dot (names like "." or ".." would scaffold outside a new directory) — pass a directory name',
+    PROJECT_NAME_NO_PACKAGE_NAME: 'Project name must contain a letter, number or dash (npm package names cannot start with "_" or ".")',
+    PACKAGE_NAME_NORMALIZED: (name) => `  package.json name: ${name} (npm package names are lower-case and cannot start with "_")`,
     OPERATION_CANCELLED: '✖ Operation cancelled',
     NO_TTY: 'No interactive terminal detected — cannot prompt for input.\n' +
         'Re-run non-interactively with a project name and flags, e.g.:\n' +
         '  npm create bestax@latest my-app -- -t vite-ts -b complete -i none -y\n' +
         'Run with --help to see all options.',
-    DIRECTORY_NOT_EMPTY: (dir) => `Directory ${chalk.yellow(dir)} is not empty. Remove existing files and continue?`,
+    DIRECTORY_NOT_EMPTY: (dir, entries) => `Directory ${chalk.yellow(dir)} is not empty (${listEntries(entries)}). Remove existing files and continue?`,
+    NOT_A_DIRECTORY: (dir) => `${dir} already exists and is not a directory, so nothing was written. Choose another project name.`,
+    // Shown instead of the question above when it cannot be asked: under -y, or
+    // without a terminal. -y never answers it (#945), so this must not suggest -y.
+    DIRECTORY_NOT_EMPTY_REFUSED: (dir, entries) => `Directory ${dir} is not empty (${listEntries(entries)}), so nothing was written.\n` +
+        '  Re-run with --overwrite to delete its contents first, or choose a new or empty directory.\n' +
+        '  -y alone never deletes files.',
     EMPTYING_DIRECTORY: (dir) => `\n  Emptying ${dir}...`,
     CREATING_PROJECT: (path) => `✔ Creating project in ${chalk.bold(path)}`,
     TEMPLATE_NOT_FOUND: (template) => `Template not found at ${template}`,
@@ -24,6 +38,8 @@ export const MESSAGES = {
     NEXT_STEPS: 'Next steps:',
     HAPPY_CODING: 'Happy coding! 🎉',
     SKILLS_ADDED: '✔ Installed bestax AI skills into .claude/skills/ (+ CLAUDE.md, .claude/launch.json)',
+    ICON_CSS_NOT_ADDED: (file, importStatement) => `  Warning: ${file} has no bestax stylesheet import to follow, so ${importStatement} ` +
+        'was not added. Add it by hand or the icons will not render.',
     TELEMETRY_NOTICE: 'Help improve bestax — share anonymous usage stats?\n' +
         'Sends only the options you chose (template, Bulma flavor, icon library,\n' +
         'skills, package manager) plus CLI version, Node major, and OS name.\n' +
@@ -118,14 +134,13 @@ cases. Before writing \`style\`, translate each declaration with this table:
 | \`display: 'flex'\` + flex properties      | same-named props: \`display="flex"\`, \`flexDirection\`, \`justifyContent\`, \`alignItems\`, \`flexWrap\`                                   |
 | \`height: '100%'\` on a flex child         | \`flexGrow="1"\`                                                                                                                            |
 | \`display: 'none'\`                        | \`visibility="hidden"\`, or responsive \`display*\` props (\`displayMobile\`, \`displayTablet\`, …)                                         |
+| \`gap: '1rem'\` (flex or grid)             | \`gap="2"\`, or one axis: \`columnGap\`, \`rowGap\`; gap scale: \`1\`=0.5rem, \`2\`=1rem, \`4\`=2rem, half steps (\`"1.5"\`)               |
 
 - Spacing, typography, and flex helpers are on every component; \`textColor\`/\`bgColor\` are
   on the content components (\`Box\`, \`Block\`, \`Title\`, \`Content\`, \`Hero\`, \`Card\`, …) — the
   ones with a semantic \`color\` variant (\`Tag\`, \`Tabs\`, \`Panel\`) take \`color\` instead.
   \`Notification\` is the mixed case: it takes \`textColor\`, but its background comes from
   the semantic \`color\` prop, not \`bgColor\`.
-- Flex layouts have no \`gap\` helper — space children with margins (\`Grid\` and \`Columns\`
-  take a \`gap\` prop, so prefer that there).
 - No helper matches (e.g. \`maxWidth\`, a one-off gradient)? Add a named class to
   \`src/App.css\` and pass it via \`className\` — still never inline \`style\`.
 - Don't hand-write Bulma utility classes either — bare text/markup has wrapper elements that

package/dist/file-system.d.ts

@@ -1,5 +1,12 @@
 export declare function checkDirectoryExists(targetPath: string): Promise<boolean>;
 export declare function isDirectoryEmpty(targetPath: string): Promise<boolean>;
+/**
+ * Whether something other than a directory, such as a file, already sits at
+ * targetPath. listDirectoryEntries cannot read one, so callers check first.
+ */
+export declare function existsAsNonDirectory(targetPath: string): Promise<boolean>;
+/** A directory's top-level entries, sorted; none when it does not exist. */
+export declare function listDirectoryEntries(targetPath: string): Promise<string[]>;
 export declare function emptyDirectory(targetPath: string): Promise<void>;
 export declare function ensureDirectory(targetPath: string): Promise<void>;
 export declare function copyDirectory(source: string, destination: string, renames?: Record<string, string>): Promise<void>;

package/dist/file-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../src/file-system.ts"],"names":[],"mappings":"AAIA,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM3E;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE5E;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,SAAI,GACT,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAQf"}
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../src/file-system.ts"],"names":[],"mappings":"AAIA,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM3E;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,4EAA4E;AAC5E,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAKnB;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE5E;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,SAAI,GACT,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/file-system.js

@@ -11,6 +11,21 @@ export async function isDirectoryEmpty(targetPath) {
     const files = fs.readdirSync(targetPath);
     return files.length === 0;
 }
+/**
+ * Whether something other than a directory, such as a file, already sits at
+ * targetPath. listDirectoryEntries cannot read one, so callers check first.
+ */
+export async function existsAsNonDirectory(targetPath) {
+    const stat = fs.statSync(targetPath, { throwIfNoEntry: false });
+    return stat !== undefined && !stat.isDirectory();
+}
+/** A directory's top-level entries, sorted; none when it does not exist. */
+export async function listDirectoryEntries(targetPath) {
+    if (!fs.existsSync(targetPath)) {
+        return [];
+    }
+    return fs.readdirSync(targetPath).sort();
+}
 export async function emptyDirectory(targetPath) {
     await fs.emptyDir(targetPath);
 }

package/dist/index.js

@@ -14,6 +14,6 @@ if (majorVersion < MINIMUM_NODE_VERSION) {
         `Please upgrade your Node.js version.`);
     process.exit(1);
 }
-const { createCLI } = await import('./cli.js');
-await createCLI().parseAsync(process.argv);
+const { runCLI } = await import('./cli.js');
+await runCLI();
 export {};

package/dist/project-creator.d.ts

@@ -13,12 +13,32 @@ export interface CLIOptions {
     skills?: boolean;
     telemetry?: boolean;
     yes?: boolean;
+    overwrite?: boolean;
 }
+/**
+ * What create() does with the target directory once every prompt is answered:
+ * write into it as is ('empty'), remove what it holds first ('overwrite'), or
+ * nothing at all ('stop', with the reason already shown).
+ */
+export type ExistingDirectoryPlan = 'empty' | 'overwrite' | 'stop';
 export declare class ProjectCreator {
     private templatesDir;
     constructor(templatesDir?: string);
     getProjectName(projectDir?: string): Promise<string | null>;
-    checkExistingDirectory(targetPath: string, targetDir: string): Promise<boolean>;
+    /**
+     * Decides what happens to an existing target directory without touching it:
+     * create() empties it only after the last prompt, so a Ctrl+C at any later
+     * question leaves the user's files where they were (#945). Only --overwrite
+     * or a yes at the prompt removes files. -y never does, and neither -y nor a
+     * missing terminal can ask, so both stop at a non-empty directory instead.
+     * A file at the target path stops the run too, whatever the flags say.
+     */
+    checkExistingDirectory(targetPath: string, targetDir: string, options?: CLIOptions): Promise<ExistingDirectoryPlan>;
+    /**
+     * Every flag's value is checked here, before any prompt runs or anything on
+     * disk changes, so a typo can never cost the user an emptied directory (#945).
+     */
+    validateOptions(options?: CLIOptions): string | null;
     getTemplatePath(template: string): string;
     copyTemplate(template: string, targetPath: string): Promise<void>;
     updateIndexHtmlTitle(targetPath: string, projectName: string): Promise<void>;

package/dist/project-creator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-creator.d.ts","sourceRoot":"","sources":["../src/project-creator.ts"],"names":[],"mappings":"AA6BA,OAAO,EAOL,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAWxB,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,CAAC,EAAE,MAAM;IAI3B,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAa3D,sBAAsB,CAC1B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC;IAkBnB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAInC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAgBV,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAqBV,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAmDhB,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,YAAY;IAYd,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IA+IV,mBAAmB,CACvB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAmEV,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAgJtE;;;;;;;;OAQG;YACW,eAAe;CA2B9B"}
+{"version":3,"file":"project-creator.d.ts","sourceRoot":"","sources":["../src/project-creator.ts"],"names":[],"mappings":"AA8BA,OAAO,EAQL,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAWxB,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;AAEnE,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,CAAC,EAAE,MAAM;IAI3B,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAajE;;;;;;;OAOG;IACG,sBAAsB,CAC1B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,qBAAqB,CAAC;IA2BjC;;;OAGG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAmBpD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAInC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAgBV,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAqBV,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAmDhB,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,YAAY;IAYd,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IA4JV,mBAAmB,CACvB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAmEV,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAmItE;;;;;;;;OAQG;YACW,eAAe;CA2B9B"}

package/dist/project-creator.js

@@ -2,12 +2,12 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 import chalk from 'chalk';
 import fs from 'fs-extra';
-import { checkDirectoryExists, isDirectoryEmpty, emptyDirectory, ensureDirectory, copyDirectory, updatePackageJson, } from './file-system.js';
+import { checkDirectoryExists, listDirectoryEntries, existsAsNonDirectory, emptyDirectory, ensureDirectory, copyDirectory, updatePackageJson, } from './file-system.js';
 import { promptProjectName, promptOverwriteDirectory, promptTemplate, promptIconLibrary, promptBulmaFlavor, promptInstallSkills, promptTelemetryConsent, } from './prompts.js';
 import { reportScaffold } from './telemetry.js';
 import { displayHeader, displaySuccess, displayError, displayCancelled, } from './display.js';
-import { validateProjectName } from './validators.js';
-import { MESSAGES, ICON_LIBRARIES, BULMA_FLAVORS, CLAUDE_MD, LAUNCH_JSON, CONFIG_PROVIDER_ICON_VALUES, } from './constants.js';
+import { validateProjectName, toValidPackageName } from './validators.js';
+import { MESSAGES, TEMPLATES, ICON_LIBRARIES, BULMA_FLAVORS, CLAUDE_MD, LAUNCH_JSON, CONFIG_PROVIDER_ICON_VALUES, } from './constants.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 // npm strips literal `.gitignore` files from published tarballs, so the
 // templates track `_gitignore` instead and the scaffolder renames it back
@@ -31,18 +31,54 @@ export class ProjectCreator {
         }
         return promptProjectName();
     }
-    async checkExistingDirectory(targetPath, targetDir) {
-        const exists = await checkDirectoryExists(targetPath);
-        const isEmpty = await isDirectoryEmpty(targetPath);
-        if (exists && !isEmpty) {
-            const shouldOverwrite = await promptOverwriteDirectory(targetDir);
-            if (!shouldOverwrite) {
-                return false;
-            }
-            console.log(chalk.yellow(`\n  Emptying ${targetDir}...`));
-            await emptyDirectory(targetPath);
+    /**
+     * Decides what happens to an existing target directory without touching it:
+     * create() empties it only after the last prompt, so a Ctrl+C at any later
+     * question leaves the user's files where they were (#945). Only --overwrite
+     * or a yes at the prompt removes files. -y never does, and neither -y nor a
+     * missing terminal can ask, so both stop at a non-empty directory instead.
+     * A file at the target path stops the run too, whatever the flags say.
+     */
+    async checkExistingDirectory(targetPath, targetDir, options) {
+        if (await existsAsNonDirectory(targetPath)) {
+            displayError(MESSAGES.NOT_A_DIRECTORY(targetDir));
+            return 'stop';
+        }
+        const entries = await listDirectoryEntries(targetPath);
+        if (entries.length === 0) {
+            return 'empty';
+        }
+        if (options?.overwrite) {
+            return 'overwrite';
+        }
+        if (options?.yes || !process.stdin.isTTY) {
+            displayError(MESSAGES.DIRECTORY_NOT_EMPTY_REFUSED(targetDir, entries));
+            return 'stop';
+        }
+        if (!(await promptOverwriteDirectory(targetDir, entries))) {
+            displayCancelled();
+            return 'stop';
         }
-        return true;
+        return 'overwrite';
+    }
+    /**
+     * Every flag's value is checked here, before any prompt runs or anything on
+     * disk changes, so a typo can never cost the user an emptied directory (#945).
+     */
+    validateOptions(options) {
+        const validTemplates = TEMPLATES.map(t => t.name);
+        if (options?.template && !validTemplates.includes(options.template)) {
+            return `Invalid template: ${options.template}. Valid options are: ${validTemplates.join(', ')}`;
+        }
+        const validFlavors = BULMA_FLAVORS.map(f => f.name);
+        if (options?.bulma && !validFlavors.includes(options.bulma)) {
+            return `Invalid Bulma flavor: ${options.bulma}. Valid options are: ${validFlavors.join(', ')}`;
+        }
+        const validLibraries = ICON_LIBRARIES.map(lib => lib.name);
+        if (options?.icon && !validLibraries.includes(options.icon)) {
+            return `Invalid icon library: ${options.icon}. Valid options are: ${validLibraries.join(', ')}`;
+        }
+        return null;
     }
     getTemplatePath(template) {
         return path.join(this.templatesDir, template);
@@ -193,8 +229,10 @@ export class ProjectCreator {
                     const mainFilePath = path.join(targetPath, 'src', mainFileName);
                     if (fs.existsSync(mainFilePath)) {
                         let content = await fs.readFile(mainFilePath, 'utf8');
-                        // Add the icon library import after the CSS imports
-                        const cssImportMatch = content.match(/import\s+['"](?:@allxsmith\/bestax-bulma\/(?:bestax|extras)\.css|bulma\/css\/.*?)['"]\s*;?/);
+                        // Add the icon library import after the bestax stylesheet import,
+                        // whichever one the flavor wrote: bestax.css for complete, a
+                        // versions/bestax-*.css file for every other flavor (#946).
+                        const cssImportMatch = content.match(/import\s+['"](?:@allxsmith\/bestax-bulma\/[^'"]+\.css|bulma\/css\/.*?)['"]\s*;?/);
                         if (cssImportMatch) {
                             const insertPosition = cssImportMatch.index + cssImportMatch[0].length;
                             content =
@@ -204,6 +242,11 @@ export class ProjectCreator {
                                     content.slice(insertPosition);
                             await fs.writeFile(mainFilePath, content);
                         }
+                        else {
+                            // Without its stylesheet every icon renders blank or as its
+                            // name, so say so rather than finish as if it worked (#946).
+                            console.log(chalk.yellow(MESSAGES.ICON_CSS_NOT_ADDED(`src/${mainFileName}`, library.importStatement)));
+                        }
                     }
                 }
             }
@@ -306,6 +349,11 @@ export class ProjectCreator {
     }
     async create(projectDir, options) {
         displayHeader();
+        const optionsError = this.validateOptions(options);
+        if (optionsError) {
+            displayError(optionsError);
+            process.exit(1);
+        }
         // Get project name
         const targetDir = await this.getProjectName(projectDir);
         if (!targetDir) {
@@ -315,30 +363,15 @@ export class ProjectCreator {
         }
         const targetPath = path.resolve(process.cwd(), targetDir);
         const projectName = path.basename(targetPath);
-        // Check existing directory (skip prompt if --yes is provided)
-        const canContinue = options?.yes
-            ? true
-            : await this.checkExistingDirectory(targetPath, targetDir);
-        if (!canContinue) {
-            displayCancelled();
+        // Decide about an existing directory now, but empty it only after the
+        // last prompt below (#945).
+        const directoryPlan = await this.checkExistingDirectory(targetPath, targetDir, options);
+        if (directoryPlan === 'stop') {
             process.exit(1);
         }
-        // If --yes and directory exists, empty it
-        if (options?.yes &&
-            (await checkDirectoryExists(targetPath)) &&
-            !(await isDirectoryEmpty(targetPath))) {
-            console.log(chalk.yellow(`\n  Emptying ${targetDir}...`));
-            await emptyDirectory(targetPath);
-        }
         // Select template (use option or prompt)
         let template;
         if (options?.template) {
-            // Validate the provided template
-            const validTemplates = ['vite', 'vite-ts'];
-            if (!validTemplates.includes(options.template)) {
-                displayError(`Invalid template: ${options.template}. Valid options are: ${validTemplates.join(', ')}`);
-                process.exit(1);
-            }
             template = options.template;
         }
         else if (options?.yes) {
@@ -354,12 +387,6 @@ export class ProjectCreator {
         // Select Bulma flavor (use option or prompt)
         let bulmaFlavor;
         if (options?.bulma) {
-            // Validate the provided Bulma flavor
-            const validFlavors = BULMA_FLAVORS.map(f => f.name);
-            if (!validFlavors.includes(options.bulma)) {
-                displayError(`Invalid Bulma flavor: ${options.bulma}. Valid options are: ${validFlavors.join(', ')}`);
-                process.exit(1);
-            }
             bulmaFlavor = options.bulma;
         }
         else if (options?.yes) {
@@ -375,12 +402,6 @@ export class ProjectCreator {
         // Select icon library (use option or prompt)
         let iconLibrary;
         if (options?.icon) {
-            // Validate the provided icon library
-            const validLibraries = ICON_LIBRARIES.map(lib => lib.name);
-            if (!validLibraries.includes(options.icon)) {
-                displayError(`Invalid icon library: ${options.icon}. Valid options are: ${validLibraries.join(', ')}`);
-                process.exit(1);
-            }
             iconLibrary = options.icon;
         }
         else if (options?.yes) {
@@ -403,13 +424,25 @@ export class ProjectCreator {
         }
         else {
             installSkills = await promptInstallSkills();
+            if (installSkills === null) {
+                displayCancelled();
+                process.exit(1);
+            }
         }
-        // Create project
-        console.log();
-        console.log(chalk.green(MESSAGES.CREATING_PROJECT(targetPath)));
         try {
+            if (directoryPlan === 'overwrite') {
+                console.log(chalk.yellow(MESSAGES.EMPTYING_DIRECTORY(targetDir)));
+                await emptyDirectory(targetPath);
+            }
+            // Create project
+            console.log();
+            console.log(chalk.green(MESSAGES.CREATING_PROJECT(targetPath)));
+            const packageName = toValidPackageName(projectName);
+            if (packageName !== projectName) {
+                console.log(chalk.dim(MESSAGES.PACKAGE_NAME_NORMALIZED(packageName)));
+            }
             await this.copyTemplate(template, targetPath);
-            await updatePackageJson(targetPath, projectName);
+            await updatePackageJson(targetPath, packageName);
             await this.updateIndexHtmlTitle(targetPath, projectName);
             await this.setupBulmaFlavor(targetPath, bulmaFlavor, template);
             await this.setupIconLibrary(targetPath, iconLibrary, template);

package/dist/prompts.d.ts

@@ -1,6 +1,11 @@
 export declare function promptProjectName(): Promise<string | null>;
-export declare function promptOverwriteDirectory(targetDir: string): Promise<boolean>;
-export declare function promptInstallSkills(): Promise<boolean>;
+/** Asks to remove `entries` from targetDir, naming them, since a yes deletes them. */
+export declare function promptOverwriteDirectory(targetDir: string, entries: string[]): Promise<boolean>;
+/**
+ * Returns null when the user cancels (Ctrl+C), like every other scaffold
+ * question, so the caller stops instead of reading the cancel as "no" (#950).
+ */
+export declare function promptInstallSkills(): Promise<boolean | null>;
 export declare function promptTemplate(): Promise<string | null>;
 export declare function promptIconLibrary(): Promise<string | null>;
 /**

package/dist/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAyBA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWhE;AAED,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAU5D;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAa7D;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAchE;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CA2BtE;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBhE"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAyBA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWhE;AAED,sFAAsF;AACtF,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAUnE;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAa7D;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAchE;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CA2BtE;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBhE"}

package/dist/prompts.js

@@ -25,16 +25,21 @@ export async function promptProjectName() {
     });
     return response.projectName || null;
 }
-export async function promptOverwriteDirectory(targetDir) {
+/** Asks to remove `entries` from targetDir, naming them, since a yes deletes them. */
+export async function promptOverwriteDirectory(targetDir, entries) {
     ensureInteractive();
     const response = await prompts({
         type: 'confirm',
         name: 'overwrite',
-        message: MESSAGES.DIRECTORY_NOT_EMPTY(targetDir),
+        message: MESSAGES.DIRECTORY_NOT_EMPTY(targetDir, entries),
         initial: false,
     });
     return response.overwrite === true;
 }
+/**
+ * Returns null when the user cancels (Ctrl+C), like every other scaffold
+ * question, so the caller stops instead of reading the cancel as "no" (#950).
+ */
 export async function promptInstallSkills() {
     ensureInteractive();
     const response = await prompts({
@@ -43,7 +48,7 @@ export async function promptInstallSkills() {
         message: PROMPT_MESSAGES.INSTALL_SKILLS,
         initial: true,
     });
-    return response.skills === true;
+    return typeof response.skills === 'boolean' ? response.skills : null;
 }
 export async function promptTemplate() {
     ensureInteractive();

package/dist/validators.d.ts

@@ -1,3 +1,10 @@
 export declare function validateProjectName(value: string): boolean | string;
 export declare function isValidProjectName(name: string): boolean;
+/**
+ * The package.json name for a project directory. npm rejects capitals and a
+ * leading "_" or ".", so the name is lower-cased the way `npm init` does and
+ * those leading characters are dropped, as create-vite does (#950). The
+ * directory itself keeps the name as typed.
+ */
+export declare function toValidPackageName(projectName: string): string;
 //# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAMA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAqBnE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAMA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAyBnE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D"}