create-bestax 1.1.0

package/README.md

@@ -0,0 +1,35 @@
+# create-bestax
+
+CLI tool for scaffolding new bestax-bulma projects.
+
+## Usage
+
+```bash
+npx create-bestax my-app
+```
+
+## Templates
+
+Available templates:
+- `vite` - Vite + JavaScript
+- `vite-ts` - Vite + TypeScript
+- `nextjs` - Next.js (coming soon)
+- `nextjs-ts` - Next.js + TypeScript (coming soon)
+
+## Development
+
+```bash
+npm run build    # Build the CLI
+npm run dev      # Watch mode
+npm test         # Run tests
+```
+
+## Publishing
+
+This package uses semantic-release with scope-based rules. Only commits with `feat(create-bestax)` or `fix(create-bestax)` will trigger releases.
+
+## Known Issues
+
+**Templates Location**: Currently templates exist in both `/templates/` (root) and `/create-bestax/templates/`. The package.json references `templates` which will look for `/create-bestax/templates/` when published to npm. The root `/templates/` directory should be removed to avoid confusion, but is currently committed in the monorepo root.
+
+**Workaround**: The CLI code uses `path.resolve(__dirname, '../../templates')` which correctly resolves to the package's templates folder when running from the compiled dist.

package/dist/__mocks__/chalk.d.ts

@@ -0,0 +1,14 @@
+declare const chalk: {
+    yellow: (str: string) => string;
+    blue: (str: string) => string;
+    cyan: (str: string) => string;
+    magenta: (str: string) => string;
+    green: (str: string) => string;
+    red: (str: string) => string;
+    dim: (str: string) => string;
+    bold: {
+        cyan: (str: string) => string;
+    };
+};
+export default chalk;
+//# sourceMappingURL=chalk.d.ts.map

package/dist/__mocks__/chalk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chalk.d.ts","sourceRoot":"","sources":["../../src/__mocks__/chalk.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,KAAK;kBACK,MAAM;gBACR,MAAM;gBACN,MAAM;mBACH,MAAM;iBACR,MAAM;eACR,MAAM;eACN,MAAM;;oBAEH,MAAM;;CAErB,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/__mocks__/chalk.js

@@ -0,0 +1,13 @@
+const chalk = {
+    yellow: (str) => str,
+    blue: (str) => str,
+    cyan: (str) => str,
+    magenta: (str) => str,
+    green: (str) => str,
+    red: (str) => str,
+    dim: (str) => str,
+    bold: {
+        cyan: (str) => str,
+    },
+};
+export default chalk;

package/dist/__mocks__/prompts.d.ts

@@ -0,0 +1,3 @@
+declare const prompts: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+export default prompts;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/__mocks__/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/__mocks__/prompts.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,OAAO,+DAAY,CAAC;AAE1B,eAAe,OAAO,CAAC"}

package/dist/__mocks__/prompts.js

@@ -0,0 +1,3 @@
+import { jest } from '@jest/globals';
+const prompts = jest.fn();
+export default prompts;

package/dist/cli.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { ProjectCreator, type CLIOptions } 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';
+export type { Template, IconLibrary, BulmaFlavor } from './constants.js';
+export { ProjectCreator };
+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 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(): void;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,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;AAED,wBAAgB,SAAS,IAAI,OAAO,CAwBnC;AAED,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,wBAAgB,MAAM,IAAI,IAAI,CAG7B"}

package/dist/cli.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { ProjectCreator } from './project-creator.js';
+import { copyDirectory } from './file-system.js';
+// Re-export for backward compatibility with tests
+export { validateProjectName } from './validators.js';
+export { TEMPLATES, ICON_LIBRARIES, BULMA_FLAVORS } from './constants.js';
+// Re-export individual functions for testing
+export { ProjectCreator };
+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';
+// Helper function for tests
+export async function getProjectName(projectDir) {
+    const projectCreator = new ProjectCreator();
+    return projectCreator.getProjectName(projectDir);
+}
+export async function checkExistingDirectory(targetPath, targetDir) {
+    const projectCreator = new ProjectCreator();
+    return projectCreator.checkExistingDirectory(targetPath, targetDir);
+}
+export function getTemplatePath(template) {
+    const projectCreator = new ProjectCreator();
+    return projectCreator.getTemplatePath(template);
+}
+export async function copyTemplate(templatePath, targetPath) {
+    // Direct pass-through to copyDirectory
+    return copyDirectory(templatePath, targetPath);
+}
+export async function createProject(projectDir, options) {
+    const projectCreator = new ProjectCreator();
+    return projectCreator.create(projectDir, options);
+}
+export function createCLI() {
+    const program = new Command();
+    const projectCreator = new ProjectCreator();
+    program
+        .name('create-bestax')
+        .description('Create a new bestax-bulma project')
+        .version('0.1.0')
+        .argument('[project-directory]', 'project directory to create')
+        .option('-t, --template <template>', 'template to use (vite, vite-ts)')
+        .option('-b, --bulma <flavor>', 'Bulma CSS flavor (complete, prefixed, no-helpers, no-helpers-prefixed, no-dark-mode)')
+        .option('-i, --icon <library>', 'icon library (none, fontawesome, mdi, ionicons, material-icons, material-symbols)')
+        .option('-y, --yes', 'skip prompts and use defaults or provided options')
+        .action((projectDir, options) => {
+        projectCreator.create(projectDir, options);
+    });
+    return program;
+}
+export function isMainModule(importMetaUrl, argv1) {
+    return importMetaUrl === `file://${argv1}`;
+}
+export function runCLI() {
+    const program = createCLI();
+    program.parse();
+}
+// Only run if this is the main module
+/* istanbul ignore next */
+if (isMainModule(import.meta.url, process.argv[1])) {
+    runCLI();
+}

package/dist/constants.d.ts

@@ -0,0 +1,48 @@
+import chalk from 'chalk';
+export interface Template {
+    name: string;
+    display: string;
+    color: typeof chalk.yellow;
+}
+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 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 OPERATION_CANCELLED: "✖ Operation cancelled";
+    readonly DIRECTORY_NOT_EMPTY: (dir: string) => string;
+    readonly EMPTYING_DIRECTORY: (dir: string) => string;
+    readonly CREATING_PROJECT: (path: string) => string;
+    readonly TEMPLATE_NOT_FOUND: (template: string) => string;
+    readonly PROJECT_CREATED: "✔ Done! Project created successfully.";
+    readonly NEXT_STEPS: "Next steps:";
+    readonly HAPPY_CODING: "Happy coding! 🎉";
+};
+export declare const PROMPTS: {
+    readonly PROJECT_NAME: "Project name:";
+    readonly SELECT_FRAMEWORK: "Select a framework:";
+    readonly SELECT_ICON_LIBRARY: "Would you like to add an icon library?";
+    readonly SELECT_BULMA_FLAVOR: "Which Bulma CSS flavor would you like to use?";
+};
+export interface IconLibrary {
+    name: string;
+    display: string;
+    color: typeof chalk.yellow;
+    packageName?: string;
+    importStatement?: string;
+    setupInstructions?: string;
+}
+export declare const ICON_LIBRARIES: IconLibrary[];
+export interface BulmaFlavor {
+    name: string;
+    display: string;
+    description?: string;
+    color: typeof chalk.yellow;
+    importStatement: string;
+    needsPrefix?: boolean;
+}
+export declare const BULMA_FLAVORS: BulmaFlavor[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +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;;;;;wCAMQ,MAAM;uCAEP,MAAM;sCACP,MAAM;4CAEA,MAAM;;;;CAI7B,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;CAKV,CAAC;AAEX,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;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc,EAAE,WAAW,EAyCvC,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,EAuCtC,CAAC"}

package/dist/constants.js

@@ -0,0 +1,108 @@
+import chalk from 'chalk';
+export const TEMPLATES = [
+    { name: 'vite', display: 'Vite', color: chalk.yellow },
+    { name: 'vite-ts', display: 'Vite + TypeScript', color: chalk.blue },
+];
+export const DEFAULT_PROJECT_NAME = 'my-bestax-app';
+export const MAX_PROJECT_NAME_LENGTH = 214;
+export const PROJECT_NAME_REGEX = /^[a-zA-Z0-9-._]+$/;
+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',
+    OPERATION_CANCELLED: '✖ Operation cancelled',
+    DIRECTORY_NOT_EMPTY: (dir) => `Directory ${chalk.yellow(dir)} is not empty. Remove existing files and continue?`,
+    EMPTYING_DIRECTORY: (dir) => `\n  Emptying ${dir}...`,
+    CREATING_PROJECT: (path) => `✔ Creating project in ${chalk.bold(path)}`,
+    TEMPLATE_NOT_FOUND: (template) => `Template not found at ${template}`,
+    PROJECT_CREATED: '✔ Done! Project created successfully.',
+    NEXT_STEPS: 'Next steps:',
+    HAPPY_CODING: 'Happy coding! 🎉',
+};
+export const PROMPTS = {
+    PROJECT_NAME: 'Project name:',
+    SELECT_FRAMEWORK: 'Select a framework:',
+    SELECT_ICON_LIBRARY: 'Would you like to add an icon library?',
+    SELECT_BULMA_FLAVOR: 'Which Bulma CSS flavor would you like to use?',
+};
+export const ICON_LIBRARIES = [
+    {
+        name: 'none',
+        display: "None (I'll add icons later)",
+        color: chalk.gray,
+    },
+    {
+        name: 'fontawesome',
+        display: 'Font Awesome',
+        color: chalk.blue,
+        packageName: '@fortawesome/fontawesome-free',
+        importStatement: "import '@fortawesome/fontawesome-free/css/all.min.css';",
+    },
+    {
+        name: 'mdi',
+        display: 'Material Design Icons',
+        color: chalk.cyan,
+        packageName: '@mdi/font',
+        importStatement: "import '@mdi/font/css/materialdesignicons.min.css';",
+    },
+    {
+        name: 'ionicons',
+        display: 'Ionicons',
+        color: chalk.green,
+        // Note: ionicons doesn't need packageName or importStatement
+        // as it's loaded via CDN in index.html
+    },
+    {
+        name: 'material-icons',
+        display: 'Google Material Icons',
+        color: chalk.yellow,
+        packageName: 'material-icons',
+        importStatement: "import 'material-icons';",
+    },
+    {
+        name: 'material-symbols',
+        display: 'Material Symbols',
+        color: chalk.magenta,
+        packageName: 'material-symbols',
+        importStatement: "import 'material-symbols';",
+    },
+];
+export const BULMA_FLAVORS = [
+    {
+        name: 'complete',
+        display: 'Complete (Recommended)',
+        description: 'Full Bulma CSS with all components and helpers',
+        color: chalk.green,
+        importStatement: "import 'bulma/css/bulma.min.css';",
+    },
+    {
+        name: 'prefixed',
+        display: 'Prefixed',
+        description: 'All classes prefixed with "bulma-" to avoid conflicts',
+        color: chalk.blue,
+        importStatement: "import 'bulma/css/versions/bulma-prefixed.min.css';",
+        needsPrefix: true,
+    },
+    {
+        name: 'no-helpers',
+        display: 'No Helpers',
+        description: 'Core components only, no utility classes',
+        color: chalk.yellow,
+        importStatement: "import 'bulma/css/versions/bulma-no-helpers.min.css';",
+    },
+    {
+        name: 'no-helpers-prefixed',
+        display: 'No Helpers, Prefixed',
+        description: 'Core components only with "bulma-" prefix',
+        color: chalk.magenta,
+        importStatement: "import 'bulma/css/versions/bulma-no-helpers-prefixed.min.css';",
+        needsPrefix: true,
+    },
+    {
+        name: 'no-dark-mode',
+        display: 'No Dark Mode',
+        description: 'Light mode only, smaller bundle size',
+        color: chalk.cyan,
+        importStatement: "import 'bulma/css/versions/bulma-no-dark-mode.min.css';",
+    },
+];

package/dist/display.d.ts

@@ -0,0 +1,6 @@
+export declare function displayHeader(): void;
+export declare function displaySuccess(targetDir: string): void;
+export declare function displayError(message: string): void;
+export declare function displayInfo(message: string): void;
+export declare function displayCancelled(): void;
+//# sourceMappingURL=display.d.ts.map

package/dist/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../src/display.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAmBtD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/display.js

@@ -0,0 +1,34 @@
+import chalk from 'chalk';
+import { MESSAGES } from './constants.js';
+export function displayHeader() {
+    console.log();
+    console.log(chalk.cyan('━'.repeat(50)));
+    console.log(chalk.cyan(chalk.bold('  🐝 Create Bestax App')));
+    console.log(chalk.cyan('━'.repeat(50)));
+    console.log();
+}
+export function displaySuccess(targetDir) {
+    console.log();
+    console.log(chalk.green(MESSAGES.PROJECT_CREATED));
+    console.log();
+    console.log(chalk.bold(MESSAGES.NEXT_STEPS));
+    console.log();
+    console.log(chalk.cyan(`  cd ${targetDir}`));
+    console.log(chalk.cyan('  npm install'));
+    console.log(chalk.cyan('  npm run dev'));
+    console.log();
+    console.log(chalk.dim(MESSAGES.HAPPY_CODING));
+    console.log();
+    console.log(chalk.yellow('⭐ If you enjoy using bestax-bulma, please star us on GitHub!'));
+    console.log(chalk.dim('   https://github.com/allxsmith/bestax'));
+    console.log();
+}
+export function displayError(message) {
+    console.error(chalk.red(`✖ ${message}`));
+}
+export function displayInfo(message) {
+    console.log(chalk.yellow(message));
+}
+export function displayCancelled() {
+    console.log(chalk.red(MESSAGES.OPERATION_CANCELLED));
+}

package/dist/file-system.d.ts

@@ -0,0 +1,9 @@
+export declare function checkDirectoryExists(targetPath: string): Promise<boolean>;
+export declare function isDirectoryEmpty(targetPath: string): Promise<boolean>;
+export declare function emptyDirectory(targetPath: string): Promise<void>;
+export declare function ensureDirectory(targetPath: string): Promise<void>;
+export declare function copyDirectory(source: string, destination: string): Promise<void>;
+export declare function readJsonFile<T = unknown>(filePath: string): Promise<T>;
+export declare function writeJsonFile(filePath: string, data: unknown, spaces?: number): Promise<void>;
+export declare function updatePackageJson(targetPath: string, projectName: string): Promise<void>;
+//# sourceMappingURL=file-system.d.ts.map

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

@@ -0,0 +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,GAClB,OAAO,CAAC,IAAI,CAAC,CAKf;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

@@ -0,0 +1,39 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { MESSAGES } from './constants.js';
+export async function checkDirectoryExists(targetPath) {
+    return fs.existsSync(targetPath);
+}
+export async function isDirectoryEmpty(targetPath) {
+    if (!fs.existsSync(targetPath)) {
+        return true;
+    }
+    const files = fs.readdirSync(targetPath);
+    return files.length === 0;
+}
+export async function emptyDirectory(targetPath) {
+    await fs.emptyDir(targetPath);
+}
+export async function ensureDirectory(targetPath) {
+    await fs.ensureDir(targetPath);
+}
+export async function copyDirectory(source, destination) {
+    if (!(await checkDirectoryExists(source))) {
+        throw new Error(MESSAGES.TEMPLATE_NOT_FOUND(source));
+    }
+    await fs.copy(source, destination);
+}
+export async function readJsonFile(filePath) {
+    return fs.readJson(filePath);
+}
+export async function writeJsonFile(filePath, data, spaces = 2) {
+    await fs.writeJson(filePath, data, { spaces });
+}
+export async function updatePackageJson(targetPath, projectName) {
+    const packageJsonPath = path.join(targetPath, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+        const packageJson = await fs.readJson(packageJsonPath);
+        packageJson.name = projectName;
+        await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { createCLI } from './cli.js';
+const program = createCLI();
+program.parse();

package/dist/project-creator.d.ts

@@ -0,0 +1,28 @@
+export interface ProjectConfig {
+    projectName: string;
+    template: string;
+    targetPath: string;
+    iconLibrary?: string;
+    bulmaFlavor?: string;
+}
+export interface CLIOptions {
+    template?: string;
+    bulma?: string;
+    icon?: string;
+    yes?: boolean;
+}
+export declare class ProjectCreator {
+    private templatesDir;
+    constructor(templatesDir?: string);
+    getProjectName(projectDir?: string): Promise<string | null>;
+    checkExistingDirectory(targetPath: string, targetDir: string): Promise<boolean>;
+    getTemplatePath(template: string): string;
+    copyTemplate(template: string, targetPath: string): Promise<void>;
+    setupBulmaFlavor(targetPath: string, bulmaFlavor: string, template: string): Promise<void>;
+    private getIconName;
+    private getIconProps;
+    setupIconLibrary(targetPath: string, iconLibrary: string, template: string): Promise<void>;
+    setupConfigProvider(targetPath: string, bulmaFlavor: string, iconLibrary: string, template: string): Promise<void>;
+    create(projectDir?: string, options?: CLIOptions): Promise<void>;
+}
+//# sourceMappingURL=project-creator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-creator.d.ts","sourceRoot":"","sources":["../src/project-creator.ts"],"names":[],"mappings":"AA8BA,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,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,CAAC,EAAE,MAAM;IAK3B,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,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAyChB,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;IA0IV,mBAAmB,CACvB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAwEV,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAwHvE"}

package/dist/project-creator.js

@@ -0,0 +1,380 @@
+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 { promptProjectName, promptOverwriteDirectory, promptTemplate, promptIconLibrary, promptBulmaFlavor, } from './prompts.js';
+import { displayHeader, displaySuccess, displayError, displayCancelled, } from './display.js';
+import { validateProjectName } from './validators.js';
+import { MESSAGES, ICON_LIBRARIES, BULMA_FLAVORS } from './constants.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export class ProjectCreator {
+    templatesDir;
+    constructor(templatesDir) {
+        this.templatesDir =
+            templatesDir || path.resolve(__dirname, '../../templates');
+    }
+    async getProjectName(projectDir) {
+        if (projectDir) {
+            const validation = validateProjectName(projectDir);
+            if (validation !== true) {
+                console.log(chalk.red(`✖ ${validation}`));
+                return null;
+            }
+            return projectDir;
+        }
+        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);
+        }
+        return true;
+    }
+    getTemplatePath(template) {
+        return path.join(this.templatesDir, template);
+    }
+    async copyTemplate(template, targetPath) {
+        const templatePath = this.getTemplatePath(template);
+        await ensureDirectory(targetPath);
+        await copyDirectory(templatePath, targetPath);
+    }
+    async setupBulmaFlavor(targetPath, bulmaFlavor, template) {
+        const flavor = BULMA_FLAVORS.find(f => f.name === bulmaFlavor);
+        if (!flavor) {
+            console.log(`Warning: Bulma flavor '${bulmaFlavor}' not found in BULMA_FLAVORS`);
+            return;
+        }
+        const isTypeScript = template.includes('-ts');
+        const mainFileName = isTypeScript ? 'main.tsx' : 'main.jsx';
+        const mainFilePath = path.join(targetPath, 'src', mainFileName);
+        if (fs.existsSync(mainFilePath)) {
+            let content = await fs.readFile(mainFilePath, 'utf8');
+            // Replace the default Bulma import with the selected flavor
+            const bulmaImportRegex = /import\s+['"]bulma\/css\/bulma\.min\.css['"]\s*;?/;
+            if (bulmaImportRegex.test(content)) {
+                content = content.replace(bulmaImportRegex, flavor.importStatement);
+            }
+            else {
+                // If no Bulma import found, add it after React import
+                const reactImportMatch = content.match(/import\s+.*\s+from\s+['"]react['"]/);
+                if (reactImportMatch) {
+                    const insertPosition = reactImportMatch.index + reactImportMatch[0].length;
+                    content =
+                        content.slice(0, insertPosition) +
+                            '\n' +
+                            flavor.importStatement +
+                            content.slice(insertPosition);
+                }
+            }
+            await fs.writeFile(mainFilePath, content);
+        }
+    }
+    getIconName(iconLibrary, iconType) {
+        const iconMappings = {
+            fontawesome: { rocket: 'rocket', book: 'book', code: 'code' },
+            mdi: {
+                rocket: 'rocket-launch',
+                book: 'book-open-page-variant',
+                code: 'code-tags',
+            },
+            ionicons: { rocket: 'rocket', book: 'book', code: 'code-slash' },
+            'material-icons': {
+                rocket: 'rocket_launch',
+                book: 'menu_book',
+                code: 'code',
+            },
+            'material-symbols': {
+                rocket: 'rocket_launch',
+                book: 'menu_book',
+                code: 'code',
+            },
+        };
+        return iconMappings[iconLibrary]?.[iconType] || '';
+    }
+    getIconProps(iconLibrary, iconType) {
+        const iconName = this.getIconName(iconLibrary, iconType);
+        if (!iconName)
+            return '';
+        return iconLibrary === 'fontawesome'
+            ? `name="${iconName}" variant="solid"`
+            : `name="${iconName}"`;
+    }
+    async setupIconLibrary(targetPath, iconLibrary, template) {
+        if (iconLibrary === 'none')
+            return;
+        const library = ICON_LIBRARIES.find(lib => lib.name === iconLibrary);
+        if (!library)
+            return;
+        // Special handling for ionicons - add to index.html instead of package.json
+        if (iconLibrary === 'ionicons') {
+            const indexHtmlPath = path.join(targetPath, 'index.html');
+            if (fs.existsSync(indexHtmlPath)) {
+                let htmlContent = await fs.readFile(indexHtmlPath, 'utf8');
+                // Add ionicons scripts before the closing </head> tag
+                const headEndMatch = htmlContent.match(/<\/head>/);
+                if (headEndMatch) {
+                    const insertPosition = headEndMatch.index;
+                    const ioniconScripts = `    <!-- Ionicons -->
+    <script type="module" src="https://unpkg.com/ionicons@8.0.13/dist/ionicons/ionicons.esm.js"></script>
+    <script nomodule src="https://unpkg.com/ionicons@8.0.13/dist/ionicons/ionicons.js"></script>
+  `;
+                    htmlContent =
+                        htmlContent.slice(0, insertPosition) +
+                            ioniconScripts +
+                            htmlContent.slice(insertPosition);
+                    await fs.writeFile(indexHtmlPath, htmlContent);
+                }
+            }
+        }
+        else if (!library.packageName) {
+            return;
+        }
+        // For non-ionicons libraries, add the package to package.json dependencies
+        if (iconLibrary !== 'ionicons') {
+            const packageJsonPath = path.join(targetPath, 'package.json');
+            if (fs.existsSync(packageJsonPath)) {
+                const packageJson = await fs.readJson(packageJsonPath);
+                if (!packageJson.dependencies) {
+                    packageJson.dependencies = {};
+                }
+                if (library.packageName) {
+                    packageJson.dependencies[library.packageName] = 'latest';
+                }
+                await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+                // Add import statement to main file
+                if (library.importStatement) {
+                    const isTypeScript = template.includes('-ts');
+                    const mainFileName = isTypeScript ? 'main.tsx' : 'main.jsx';
+                    const mainFilePath = path.join(targetPath, 'src', mainFileName);
+                    if (fs.existsSync(mainFilePath)) {
+                        let content = await fs.readFile(mainFilePath, 'utf8');
+                        // Add the icon library import before the Bulma CSS import
+                        const bulmaImportMatch = content.match(/import\s+['"]bulma\/css\/.*?['"]/);
+                        if (bulmaImportMatch) {
+                            const insertPosition = bulmaImportMatch.index;
+                            content =
+                                content.slice(0, insertPosition) +
+                                    library.importStatement +
+                                    '\n' +
+                                    content.slice(insertPosition);
+                            await fs.writeFile(mainFilePath, content);
+                        }
+                    }
+                }
+            }
+        }
+        // Now add Icon components to App.jsx/App.tsx (for all icon libraries)
+        const isTypeScript = template.includes('-ts');
+        const appFileName = isTypeScript ? 'App.tsx' : 'App.jsx';
+        const appFilePath = path.join(targetPath, 'src', appFileName);
+        if (fs.existsSync(appFilePath)) {
+            let appContent = await fs.readFile(appFilePath, 'utf8');
+            // Add Icon import to the bestax-bulma imports
+            const bulmaImportRegex = /(import\s+\{[\s\S]*?)(}\s+from\s+['"]@allxsmith\/bestax-bulma['"])/;
+            if (bulmaImportRegex.test(appContent) && !appContent.includes('Icon')) {
+                // Check if the import ends with a comma or not
+                const importMatch = appContent.match(bulmaImportRegex);
+                if (importMatch) {
+                    const beforeClosingBrace = importMatch[1];
+                    // Remove any trailing comma and whitespace, then add Icon properly
+                    const cleanedImport = beforeClosingBrace.replace(/,?\s*$/, '');
+                    appContent = appContent.replace(bulmaImportRegex, cleanedImport + ',\n  Icon$2');
+                }
+            }
+            // Add icon examples in the Cards section
+            // Find the Quick Start Card and add an icon
+            const quickStartRegex = /(Card\.Header\.Title>\s*Quick Start\s*<\/Card\.Header\.Title>)/;
+            if (quickStartRegex.test(appContent)) {
+                const iconProps = this.getIconProps(iconLibrary, 'rocket');
+                if (iconProps) {
+                    appContent = appContent.replace(quickStartRegex, `Card.Header.Title>\n                          <Icon ${iconProps} size="small" mr="2" />\n                          Quick Start\n                        </Card.Header.Title>`);
+                }
+            }
+            // Add icon to Documentation Card
+            const docsRegex = /(Card\.Header\.Title>\s*Documentation\s*<\/Card\.Header\.Title>)/;
+            if (docsRegex.test(appContent)) {
+                const iconProps = this.getIconProps(iconLibrary, 'book');
+                if (iconProps) {
+                    appContent = appContent.replace(docsRegex, `Card.Header.Title>\n                          <Icon ${iconProps} size="small" mr="2" />\n                          Documentation\n                        </Card.Header.Title>`);
+                }
+            }
+            // Add icon to Examples Card
+            const examplesRegex = /(Card\.Header\.Title>\s*Examples\s*<\/Card\.Header\.Title>)/;
+            if (examplesRegex.test(appContent)) {
+                const iconProps = this.getIconProps(iconLibrary, 'code');
+                if (iconProps) {
+                    appContent = appContent.replace(examplesRegex, `Card.Header.Title>\n                          <Icon ${iconProps} size="small" mr="2" />\n                          Examples\n                        </Card.Header.Title>`);
+                }
+            }
+            await fs.writeFile(appFilePath, appContent);
+        }
+    }
+    async setupConfigProvider(targetPath, bulmaFlavor, iconLibrary, template) {
+        const flavor = BULMA_FLAVORS.find(f => f.name === bulmaFlavor);
+        const needsPrefix = flavor?.needsPrefix || false;
+        // Don't add ConfigProvider for 'none' or 'fontawesome' (default)
+        const needsIconLibrary = iconLibrary !== 'none' && iconLibrary !== 'fontawesome';
+        // Only add ConfigProvider if we need prefix or non-default icon library
+        if (!needsPrefix && !needsIconLibrary)
+            return;
+        const isTypeScript = template.includes('-ts');
+        const mainFileName = isTypeScript ? 'main.tsx' : 'main.jsx';
+        const mainFilePath = path.join(targetPath, 'src', mainFileName);
+        if (fs.existsSync(mainFilePath)) {
+            let content = await fs.readFile(mainFilePath, 'utf8');
+            // Add ConfigProvider import from bestax-bulma
+            const configProviderImport = "import { ConfigProvider } from '@allxsmith/bestax-bulma';";
+            // Check if ConfigProvider is already imported
+            if (!content.includes('ConfigProvider')) {
+                // Add import after the App import line
+                const appImportMatch = content.match(/import\s+App\s+from\s+['"]\.\/App\.(jsx|tsx)?['"]\s*;?/);
+                if (appImportMatch) {
+                    const insertPosition = appImportMatch.index + appImportMatch[0].length;
+                    content =
+                        content.slice(0, insertPosition) +
+                            '\n' +
+                            configProviderImport +
+                            content.slice(insertPosition);
+                }
+            }
+            // Build ConfigProvider props
+            const configProps = [];
+            if (needsPrefix) {
+                configProps.push('classPrefix="bulma-"');
+            }
+            if (needsIconLibrary) {
+                // Map the icon library name to the correct value for ConfigProvider
+                const iconLibraryMap = {
+                    mdi: 'mdi',
+                    ionicons: 'ion',
+                    'material-icons': 'material-icons',
+                    'material-symbols': 'material-symbols',
+                };
+                const iconLibraryValue = iconLibraryMap[iconLibrary];
+                if (iconLibraryValue) {
+                    configProps.push(`iconLibrary="${iconLibraryValue}"`);
+                }
+            }
+            // Wrap <App /> with ConfigProvider in the render call
+            const appRegex = /<App\s*\/>/;
+            if (appRegex.test(content)) {
+                const propsString = configProps.length > 0 ? ' ' + configProps.join(' ') : '';
+                content = content.replace(appRegex, `<ConfigProvider${propsString}>\n      <App />\n    </ConfigProvider>`);
+            }
+            await fs.writeFile(mainFilePath, content);
+        }
+    }
+    async create(projectDir, options) {
+        displayHeader();
+        // Get project name
+        const targetDir = await this.getProjectName(projectDir);
+        if (!targetDir) {
+            displayCancelled();
+            process.exit(1);
+            return; // TypeScript flow control
+        }
+        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();
+            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) {
+            template = 'vite'; // default template
+        }
+        else {
+            template = await promptTemplate();
+            if (!template) {
+                displayCancelled();
+                process.exit(1);
+            }
+        }
+        // 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) {
+            bulmaFlavor = 'complete'; // default flavor
+        }
+        else {
+            bulmaFlavor = await promptBulmaFlavor();
+            if (bulmaFlavor === null) {
+                displayCancelled();
+                process.exit(1);
+            }
+        }
+        // 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) {
+            iconLibrary = 'none'; // default icon library
+        }
+        else {
+            iconLibrary = await promptIconLibrary();
+            if (iconLibrary === null) {
+                displayCancelled();
+                process.exit(1);
+            }
+        }
+        // Create project
+        console.log();
+        console.log(chalk.green(MESSAGES.CREATING_PROJECT(targetPath)));
+        try {
+            await this.copyTemplate(template, targetPath);
+            await updatePackageJson(targetPath, projectName);
+            await this.setupBulmaFlavor(targetPath, bulmaFlavor, template);
+            await this.setupIconLibrary(targetPath, iconLibrary, template);
+            await this.setupConfigProvider(targetPath, bulmaFlavor, iconLibrary, template);
+            displaySuccess(targetDir);
+        }
+        catch (error) {
+            displayError(error.message);
+            process.exit(1);
+        }
+    }
+}

package/dist/prompts.d.ts

@@ -0,0 +1,6 @@
+export declare function promptProjectName(): Promise<string | null>;
+export declare function promptOverwriteDirectory(targetDir: string): Promise<boolean>;
+export declare function promptTemplate(): Promise<string | null>;
+export declare function promptIconLibrary(): Promise<string | null>;
+export declare function promptBulmaFlavor(): Promise<string | null>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAWA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUhE;AAED,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CASlB;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAY7D;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAahE;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAehE"}

package/dist/prompts.js

@@ -0,0 +1,60 @@
+import prompts from 'prompts';
+import { TEMPLATES, DEFAULT_PROJECT_NAME, PROMPTS as PROMPT_MESSAGES, MESSAGES, ICON_LIBRARIES, BULMA_FLAVORS, } from './constants.js';
+import { validateProjectName } from './validators.js';
+export async function promptProjectName() {
+    const response = await prompts({
+        type: 'text',
+        name: 'projectName',
+        message: PROMPT_MESSAGES.PROJECT_NAME,
+        initial: DEFAULT_PROJECT_NAME,
+        validate: validateProjectName,
+    });
+    return response.projectName || null;
+}
+export async function promptOverwriteDirectory(targetDir) {
+    const response = await prompts({
+        type: 'confirm',
+        name: 'overwrite',
+        message: MESSAGES.DIRECTORY_NOT_EMPTY(targetDir),
+        initial: false,
+    });
+    return response.overwrite === true;
+}
+export async function promptTemplate() {
+    const response = await prompts({
+        type: 'select',
+        name: 'template',
+        message: PROMPT_MESSAGES.SELECT_FRAMEWORK,
+        choices: TEMPLATES.map(template => ({
+            title: template.color(template.display),
+            value: template.name,
+        })),
+    });
+    return response.template || null;
+}
+export async function promptIconLibrary() {
+    const response = await prompts({
+        type: 'select',
+        name: 'iconLibrary',
+        message: PROMPT_MESSAGES.SELECT_ICON_LIBRARY,
+        choices: ICON_LIBRARIES.map(lib => ({
+            title: lib.color(lib.display),
+            value: lib.name,
+        })),
+        initial: 0, // Default to 'none'
+    });
+    return response.iconLibrary || null;
+}
+export async function promptBulmaFlavor() {
+    const response = await prompts({
+        type: 'select',
+        name: 'bulmaFlavor',
+        message: PROMPT_MESSAGES.SELECT_BULMA_FLAVOR,
+        choices: BULMA_FLAVORS.map(flavor => ({
+            title: flavor.color(`${flavor.display}${flavor.description ? ` - ${flavor.description}` : ''}`),
+            value: flavor.name,
+        })),
+        initial: 0, // Default to 'complete' (recommended)
+    });
+    return response.bulmaFlavor || null;
+}

package/dist/validators.d.ts

@@ -0,0 +1,3 @@
+export declare function validateProjectName(value: string): boolean | string;
+export declare function isValidProjectName(name: string): boolean;
+//# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -0,0 +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,CAcnE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/validators.js

@@ -0,0 +1,16 @@
+import { PROJECT_NAME_REGEX, MAX_PROJECT_NAME_LENGTH, MESSAGES, } from './constants.js';
+export function validateProjectName(value) {
+    if (!value) {
+        return MESSAGES.PROJECT_NAME_REQUIRED;
+    }
+    if (value.length > MAX_PROJECT_NAME_LENGTH) {
+        return MESSAGES.PROJECT_NAME_TOO_LONG;
+    }
+    if (!PROJECT_NAME_REGEX.test(value)) {
+        return MESSAGES.PROJECT_NAME_INVALID_CHARS;
+    }
+    return true;
+}
+export function isValidProjectName(name) {
+    return validateProjectName(name) === true;
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "create-bestax",
+  "version": "1.1.0",
+  "description": "Create a new bestax-bulma project",
+  "type": "module",
+  "bin": {
+    "create-bestax": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "NODE_OPTIONS=\"--experimental-vm-modules\" jest",
+    "test:watch": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watch",
+    "test:coverage": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --coverage",
+    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx}\"",
+    "clean": "rimraf dist",
+    "release": "npx semantic-release"
+  },
+  "keywords": [
+    "bestax",
+    "bulma",
+    "react",
+    "create",
+    "cli",
+    "scaffold"
+  ],
+  "author": "Alex Smith",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/allxsmith/bestax.git",
+    "directory": "create-bestax"
+  },
+  "homepage": "https://bestax.io",
+  "bugs": {
+    "url": "https://github.com/allxsmith/bestax/issues"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "fs-extra": "^11.2.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.20",
+    "@types/prompts": "^2.4.9",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}