create-bijou-tui-app 1.3.0

package/README.md

@@ -0,0 +1,55 @@
+# `create-bijou-tui-app`
+
+Scaffold a new Bijou TUI app with batteries-included defaults.
+
+## Usage
+
+```sh
+npm create bijou-tui-app@latest my-app
+cd my-app
+npm run dev
+```
+
+The generated app can also be run directly with:
+
+```sh
+npx tsx src/main.ts
+```
+
+## What it generates
+
+- TypeScript Node app entrypoint using `createTuiAppSkeleton()`
+- Dependencies:
+  - `@flyingrobots/bijou`
+  - `@flyingrobots/bijou-node`
+  - `@flyingrobots/bijou-tui`
+  - `@flyingrobots/bijou-tui-app`
+- Starter scripts: `dev`, `build`, `start`
+- Strict `tsconfig.json`
+
+## Flags
+
+- `-h`, `--help`: show usage
+- `-y`, `--yes`, `--force`: allow writing into a non-empty target directory
+- `--install`: run dependency installation (default)
+- `--no-install`: skip dependency installation
+
+## Test this scaffolder locally (from this monorepo)
+
+From the repository root:
+
+```sh
+# Run scaffolder unit tests
+npx vitest run --config vitest.config.ts packages/create-bijou-tui-app/src/index.test.ts
+
+# Smoke-test generated files without installing dependencies
+TMP="$(mktemp -d /tmp/bijou-scaffold-XXXXXX)"
+TARGET="$TMP/my-app"
+npx tsx packages/create-bijou-tui-app/src/cli.ts "$TARGET" --no-install
+find "$TARGET" -maxdepth 2 -type f | sort
+
+# Run the generated app
+cd "$TARGET"
+npm install
+npm run dev
+```

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+/** CLI entrypoint for create-bijou-tui-app. */
+export declare function runCli(argv: readonly string[]): number;
+//# 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":";AAWA,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CA4CtD"}

package/dist/cli.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+import { relative, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { parseArgs, scaffoldProject, usage, } from './index.js';
+/** CLI entrypoint for create-bijou-tui-app. */
+export function runCli(argv) {
+    const parsedOrCode = parseCliArgs(argv);
+    if (typeof parsedOrCode === 'number') {
+        return parsedOrCode;
+    }
+    const parsed = parsedOrCode;
+    if (parsed.help) {
+        process.stdout.write(`${usage()}\n`);
+        return 0;
+    }
+    try {
+        const result = scaffoldProject({
+            targetDir: parsed.targetDirArg,
+            install: parsed.install,
+            force: parsed.force,
+        });
+        const relDir = relative(process.cwd(), result.targetDir) || '.';
+        const suggestedDir = relDir === '.'
+            ? '.'
+            : (relDir.startsWith('..') ? result.targetDir : relDir);
+        process.stdout.write(`\nCreated project in ${result.targetDir}\n`);
+        process.stdout.write(`\nNext steps:\n`);
+        if (suggestedDir !== '.') {
+            process.stdout.write(`  cd ${quotePath(suggestedDir)}\n`);
+        }
+        if (!result.installed) {
+            process.stdout.write(`  ${installCommand(result.packageManager)}\n`);
+        }
+        process.stdout.write(`  ${runDevCommand(result.packageManager)}\n\n`);
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`create-bijou-tui-app: ${message}\n`);
+        if (isInstallFailure(message)) {
+            process.stderr.write('Tip: rerun with --no-install, then install dependencies manually.\n');
+        }
+        else {
+            process.stderr.write('Tip: run with --help to see CLI options.\n');
+        }
+        return 1;
+    }
+}
+function parseCliArgs(argv) {
+    try {
+        return parseArgs(argv);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`create-bijou-tui-app: ${message}\n`);
+        process.stderr.write(`\n${usage()}\n`);
+        return 1;
+    }
+}
+function quotePath(value) {
+    if (process.platform === 'win32') {
+        const escaped = value
+            .replace(/%/g, '%%')
+            .replace(/\^/g, '^^')
+            .replace(/"/g, '""');
+        return `"${escaped}"`;
+    }
+    return `'${value.replace(/'/g, "'\"'\"'")}'`;
+}
+function isInstallFailure(message) {
+    return message.includes(' install failed');
+}
+function installCommand(pm) {
+    if (pm === 'yarn')
+        return 'yarn';
+    if (pm === 'bun')
+        return 'bun install';
+    return `${pm} install`;
+}
+function runDevCommand(pm) {
+    if (pm === 'yarn')
+        return 'yarn dev';
+    if (pm === 'bun')
+        return 'bun run dev';
+    return `${pm} run dev`;
+}
+if (isEntrypoint()) {
+    process.exitCode = runCli(process.argv.slice(2));
+}
+function isEntrypoint() {
+    if (process.argv[1] === undefined)
+        return false;
+    return import.meta.url === pathToFileURL(resolve(process.argv[1])).href;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+/** Supported package managers for post-scaffold install instructions. */
+export type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';
+/** Parsed CLI arguments for the scaffolder command. */
+export interface ParsedArgs {
+    /** Optional target directory argument (relative to cwd). */
+    readonly targetDirArg?: string;
+    /** Whether to run dependency installation after writing files. */
+    readonly install: boolean;
+    /** Whether to allow scaffolding into a non-empty target directory. */
+    readonly force: boolean;
+    /** Whether to print usage/help and exit. */
+    readonly help: boolean;
+}
+/** Input options for {@link scaffoldProject}. */
+export interface ScaffoldOptions {
+    /** Target directory path (relative to `cwd` or absolute). */
+    readonly targetDir?: string;
+    /** Working directory used to resolve relative target paths. Defaults to process cwd. */
+    readonly cwd?: string;
+    /** Whether to run package install after file generation. Defaults to true. */
+    readonly install?: boolean;
+    /** Package manager to use for install/instructions. Defaults to auto-detection. */
+    readonly packageManager?: PackageManager;
+    /** Allow writing into a non-empty target directory. Defaults to false. */
+    readonly force?: boolean;
+}
+/** Resolved scaffold metadata returned by {@link scaffoldProject}. */
+export interface ScaffoldResult {
+    /** Absolute target directory path where files were written. */
+    readonly targetDir: string;
+    /** Package name used in generated package.json. */
+    readonly packageName: string;
+    /** Package manager selected for install/instructions. */
+    readonly packageManager: PackageManager;
+    /** Whether dependencies were installed by the scaffolder. */
+    readonly installed: boolean;
+}
+/** Default directory name when caller omits positional target argument. */
+export declare const DEFAULT_TARGET_DIR = "bijou-tui-app";
+/**
+ * Parse command-line arguments for the scaffolder.
+ *
+ * Supported flags:
+ * - `-h`, `--help`
+ * - `-y`, `--yes`, `--force`
+ * - `--install`, `--no-install`
+ */
+export declare function parseArgs(argv: readonly string[]): ParsedArgs;
+/** Detect package manager from npm user agent env. */
+export declare function detectPackageManager(env?: NodeJS.ProcessEnv): PackageManager;
+/**
+ * Normalize target directory and derive package name.
+ */
+export declare function resolveTarget(targetDir: string | undefined, cwd: string): {
+    readonly targetDir: string;
+    readonly absTargetDir: string;
+    readonly packageName: string;
+};
+/**
+ * Create scaffolded file contents keyed by relative file path.
+ */
+export declare function createTemplateFiles(packageName: string): Readonly<Record<string, string>>;
+/**
+ * Scaffold a new Bijou TUI app project.
+ */
+export declare function scaffoldProject(options?: ScaffoldOptions): ScaffoldResult;
+/** Build usage/help text for CLI output. */
+export declare function usage(): string;
+//# 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":"AAIA,yEAAyE;AACzE,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7D,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,wFAAwF;IACxF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAiC7D;AAED,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,cAAc,CAMzF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAaA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkFzF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CA0B7E;AAED,4CAA4C;AAC5C,wBAAgB,KAAK,IAAI,MAAM,CAW9B"}

package/dist/index.js

@@ -0,0 +1,233 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync, lstatSync, mkdirSync, readdirSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+/** Default directory name when caller omits positional target argument. */
+export const DEFAULT_TARGET_DIR = 'bijou-tui-app';
+/**
+ * Parse command-line arguments for the scaffolder.
+ *
+ * Supported flags:
+ * - `-h`, `--help`
+ * - `-y`, `--yes`, `--force`
+ * - `--install`, `--no-install`
+ */
+export function parseArgs(argv) {
+    let targetDirArg;
+    let install = true;
+    let force = false;
+    let help = false;
+    for (const arg of argv) {
+        if (arg === '-h' || arg === '--help') {
+            help = true;
+            continue;
+        }
+        if (arg === '-y' || arg === '--yes' || arg === '--force') {
+            force = true;
+            continue;
+        }
+        if (arg === '--install') {
+            install = true;
+            continue;
+        }
+        if (arg === '--no-install') {
+            install = false;
+            continue;
+        }
+        if (arg.startsWith('-')) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        if (targetDirArg !== undefined) {
+            throw new Error('Only one target directory argument is supported');
+        }
+        targetDirArg = arg;
+    }
+    return { targetDirArg, install, force, help };
+}
+/** Detect package manager from npm user agent env. */
+export function detectPackageManager(env = process.env) {
+    const ua = env['npm_config_user_agent'] ?? '';
+    if (ua.startsWith('pnpm/'))
+        return 'pnpm';
+    if (ua.startsWith('yarn/'))
+        return 'yarn';
+    if (ua.startsWith('bun/'))
+        return 'bun';
+    return 'npm';
+}
+/**
+ * Normalize target directory and derive package name.
+ */
+export function resolveTarget(targetDir, cwd) {
+    const normalizedTarget = targetDir?.trim().length
+        ? targetDir
+        : DEFAULT_TARGET_DIR;
+    const absTargetDir = resolve(cwd, normalizedTarget);
+    const base = basename(absTargetDir) || DEFAULT_TARGET_DIR;
+    return {
+        targetDir: normalizedTarget,
+        absTargetDir,
+        packageName: toPackageName(base),
+    };
+}
+/**
+ * Create scaffolded file contents keyed by relative file path.
+ */
+export function createTemplateFiles(packageName) {
+    const pkg = {
+        name: packageName,
+        private: true,
+        type: 'module',
+        scripts: {
+            dev: 'tsx src/main.ts',
+            build: 'tsc -p tsconfig.json',
+            start: 'node dist/main.js',
+        },
+        dependencies: {
+            '@flyingrobots/bijou': 'latest',
+            '@flyingrobots/bijou-node': 'latest',
+            '@flyingrobots/bijou-tui': 'latest',
+            '@flyingrobots/bijou-tui-app': 'latest',
+        },
+        devDependencies: {
+            '@types/node': '^22.0.0',
+            tsx: '^4.21.0',
+            typescript: '^5.9.3',
+        },
+    };
+    const tsconfig = {
+        compilerOptions: {
+            target: 'ESNext',
+            module: 'NodeNext',
+            moduleResolution: 'NodeNext',
+            strict: true,
+            noUnusedLocals: true,
+            noUnusedParameters: true,
+            noImplicitReturns: true,
+            noFallthroughCasesInSwitch: true,
+            noUncheckedIndexedAccess: true,
+            noImplicitOverride: true,
+            noPropertyAccessFromIndexSignature: true,
+            skipLibCheck: true,
+            outDir: 'dist',
+            rootDir: 'src',
+        },
+        include: ['src/**/*.ts'],
+        exclude: ['node_modules', 'dist'],
+    };
+    const mainTs = `import { initDefaultContext } from '@flyingrobots/bijou-node';
+import { run } from '@flyingrobots/bijou-tui';
+import { createTuiAppSkeleton } from '@flyingrobots/bijou-tui-app';
+
+const ctx = initDefaultContext();
+
+await run(createTuiAppSkeleton({
+  ctx,
+  title: 'My Bijou App',
+  statusMessage: ({ activeTabTitle }) => \`${'${activeTabTitle}'} ready\`,
+}));
+`;
+    const readme = `# ${packageName}
+
+Scaffolded with \`create-bijou-tui-app\`.
+
+## Run
+
+\`\`\`sh
+npm install
+npm run dev
+\`\`\`
+
+The default shell includes:
+- full-screen framed app layout
+- two starter tabs (drawer + split)
+- command palette and help integration
+- quit confirmation on \`q\` / \`ctrl+c\`
+`;
+    return {
+        '.gitignore': 'node_modules\ndist\n',
+        'package.json': `${JSON.stringify(pkg, null, 2)}\n`,
+        'tsconfig.json': `${JSON.stringify(tsconfig, null, 2)}\n`,
+        'README.md': `${readme}\n`,
+        'src/main.ts': mainTs,
+    };
+}
+/**
+ * Scaffold a new Bijou TUI app project.
+ */
+export function scaffoldProject(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const target = resolveTarget(options.targetDir, cwd);
+    const packageManager = options.packageManager ?? detectPackageManager();
+    const install = options.install ?? true;
+    const force = options.force ?? false;
+    ensureTargetWritable(target.absTargetDir, force);
+    const files = createTemplateFiles(target.packageName);
+    for (const [relPath, content] of Object.entries(files)) {
+        const absPath = join(target.absTargetDir, relPath);
+        mkdirSync(dirname(absPath), { recursive: true });
+        writeFileSync(absPath, content, 'utf8');
+    }
+    if (install) {
+        runInstall(packageManager, target.absTargetDir);
+    }
+    return {
+        targetDir: target.absTargetDir,
+        packageName: target.packageName,
+        packageManager,
+        installed: install,
+    };
+}
+/** Build usage/help text for CLI output. */
+export function usage() {
+    return [
+        'Usage: npm create bijou-tui-app@latest [directory] [options]',
+        '',
+        'Options:',
+        '  -h, --help        Show this help message',
+        '  -y, --yes         Allow writing into non-empty target directory',
+        '  --force           Alias for --yes',
+        '  --install         Run dependency installation (default)',
+        '  --no-install      Skip dependency installation',
+    ].join('\n');
+}
+function ensureTargetWritable(absTargetDir, force) {
+    if (!existsSync(absTargetDir)) {
+        mkdirSync(absTargetDir, { recursive: true });
+        return;
+    }
+    if (!lstatSync(absTargetDir).isDirectory()) {
+        throw new Error(`Target path is not a directory: ${absTargetDir}\n` +
+            'Choose a different directory path.');
+    }
+    const entries = readdirSync(absTargetDir)
+        .filter((name) => name !== '.git' && name !== '.DS_Store');
+    if (entries.length > 0 && !force) {
+        throw new Error(`Target directory is not empty: ${absTargetDir}\n` +
+            'Pass --yes to allow writing into a non-empty directory.');
+    }
+}
+function runInstall(packageManager, cwd) {
+    const args = packageManager === 'yarn' ? [] : ['install'];
+    const result = spawnSync(packageManager, args, {
+        cwd,
+        stdio: 'inherit',
+        shell: process.platform === 'win32',
+    });
+    if (result.status !== 0) {
+        throw new Error(`${packageManager} install failed`);
+    }
+}
+/**
+ * Convert a directory basename into a valid npm package name.
+ */
+function toPackageName(input) {
+    const normalized = input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/^[._-]+/, '')
+        .replace(/-+/g, '-')
+        .replace(/[._-]+$/, '');
+    return normalized.length > 0 ? normalized : DEFAULT_TARGET_DIR;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "create-bijou-tui-app",
+  "version": "1.3.0",
+  "description": "Scaffold a new Bijou TUI app with batteries-included defaults.",
+  "type": "module",
+  "bin": {
+    "create-bijou-tui-app": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "prepack": "tsc -b",
+    "lint": "tsc --noEmit",
+    "test": "vitest run --config ../../vitest.config.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "create",
+    "scaffold",
+    "cli",
+    "terminal",
+    "tui",
+    "bijou"
+  ],
+  "author": "James Ross <james@flyingrobots.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/flyingrobots/bijou.git",
+    "directory": "packages/create-bijou-tui-app"
+  },
+  "homepage": "https://github.com/flyingrobots/bijou",
+  "bugs": "https://github.com/flyingrobots/bijou/issues",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}