create-crust 0.0.15 → 0.0.17

package/README.md

@@ -8,7 +8,14 @@ Scaffold a new [Crust](https://crustjs.com) CLI project in seconds.
 bun create crust my-cli
 ```
 
-This will prompt for your project directory, install dependencies, and optionally initialize a git repository. The package name is inferred from the directory name. The generated project includes:
+This will prompt for your project directory, template style, whether to install dependencies, and optionally initialize a git repository. The package name is inferred from the directory name.
+
+`create-crust` includes two templates:
+
+- `Minimal` — single-file starter (`src/cli.ts`)
+- `Modular` — file-splitting pattern with `.sub()` and `.command(builder)`
+
+Every generated project includes:
 
 - `src/cli.ts` — entry point with a sample command
 - `package.json` — configured with `crust build` and `bun run` dev scripts

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env bun
 // @bun
-import{existsSync as O}from"fs";import{basename as Z,resolve as Q}from"path";import{defineCommand as $,runMain as b}from"@crustjs/core";import{detectPackageManager as E,isInGitRepo as H,runSteps as T,scaffold as L}from"@crustjs/create";import{confirm as F,input as V,spinner as x}from"@crustjs/prompts";var y=/[<>:"|?*\\]/;function G(z){if(!z)return"Project name cannot be empty";if(y.test(z))return`Project name contains invalid characters: ${z}`;return!0}var R=$({meta:{name:"create-crust",description:"Scaffold a new Crust CLI project"},args:[{name:"directory",type:"string",description:"Project directory to scaffold into"}],async run({args:z}){let w=z.directory??await V({message:"Project directory",default:"my-cli",validate:G}),q=Q(process.cwd(),w),J=Z(q);if(w!=="."&&O(q)){if(!await F({message:`Directory "${J}" already exists. Overwrite?`,default:!1})){console.log("Aborted.");return}}let U=await F({message:"Install dependencies?",default:!0}),W=O(q)?q:Q(q,".."),X=H(W)?!1:await F({message:"Initialize a git repository?",default:!0}),K=J;if(await L({template:"templates/base",dest:q,context:{name:K},conflict:"overwrite"}),U){let B=E(q),Y=B==="npm"?"npm install":`${B} install`;await T([{type:"command",cmd:Y}],q)}if(X)await x({message:"Initializing git repository...",task:()=>T([{type:"git-init",commit:"chore: initial commit"}],q)});if(console.log(`
+import{existsSync as O}from"fs";import{basename as $,resolve as Q}from"path";import{Crust as b}from"@crustjs/core";import{detectPackageManager as E,isInGitRepo as H,runSteps as T,scaffold as L}from"@crustjs/create";import{confirm as F,input as V,select as x,spinner as y}from"@crustjs/prompts";var G=/[<>:"|?*\\]/;function M(z){if(!z)return"Project name cannot be empty";if(G.test(z))return`Project name contains invalid characters: ${z}`;return!0}var R=new b("create-crust").meta({description:"Scaffold a new Crust CLI project"}).args([{name:"directory",type:"string",description:"Project directory to scaffold into"}]).run(async({args:z})=>{let w=z.directory??await V({message:"Project directory",default:"my-cli",validate:M}),q=Q(process.cwd(),w),J=$(q);if(w!=="."&&O(q)){if(!await F({message:`Directory "${J}" already exists. Overwrite?`,default:!1})){console.log("Aborted.");return}}let U=await F({message:"Install dependencies?",default:!0}),W=await x({message:"Template style",choices:[{label:"Minimal",value:"minimal",hint:"single-file starter"},{label:"Modular",value:"modular",hint:"file split with .sub()"}],default:"minimal"})==="minimal"?"templates/base":"templates/modular",X=O(q)?q:Q(q,".."),Y=H(X)?!1:await F({message:"Initialize a git repository?",default:!0}),K=J;if(await L({template:W,dest:q,context:{name:K},conflict:"overwrite"}),U){let B=E(q),Z=B==="npm"?"npm install":`${B} install`;await T([{type:"command",cmd:Z}],q)}if(Y)await y({message:"Initializing git repository...",task:()=>T([{type:"git-init",commit:"chore: initial commit"}],q)});if(console.log(`
 Created ${K}!
-`),console.log("Next steps:"),w!=="."){let B=w.startsWith("/")?w:`./${w}`;console.log(`  cd ${B}`)}console.log("  bun run dev"),console.log("  bun run build")}});b(R);
+`),console.log("Next steps:"),w!=="."){let B=w.startsWith("/")?w:`./${w}`;console.log(`  cd ${B}`)}console.log("  bun run dev"),console.log("  bun run build")});await R.execute();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "create-crust",
-	"version": "0.0.15",
+	"version": "0.0.17",
 	"description": "Scaffold a new Crust CLI project.",
 	"type": "module",
 	"license": "MIT",
@@ -40,9 +40,9 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@crustjs/core": "0.0.9",
+		"@crustjs/core": "0.0.10",
 		"@crustjs/create": "0.0.4",
-		"@crustjs/prompts": "0.0.6"
+		"@crustjs/prompts": "0.0.7"
 	},
 	"devDependencies": {
 		"@crustjs/config": "0.0.0",

package/templates/base/src/cli.ts

@@ -1,33 +1,29 @@
-import { defineCommand, runMain } from "@crustjs/core";
+import { Crust } from "@crustjs/core";
 import { helpPlugin, versionPlugin } from "@crustjs/plugins";
 import pkg from "../package.json";
 
-const main = defineCommand({
-	meta: {
-		name: "{{name}}",
-		description: "A CLI built with Crust",
-	},
-	args: [
+const cli = new Crust("{{name}}")
+	.meta({ description: "A CLI built with Crust" })
+	.use(versionPlugin(pkg.version))
+	.use(helpPlugin())
+	.args([
 		{
 			name: "name",
 			type: "string",
 			description: "Your name",
 			default: "world",
 		},
-	],
-	flags: {
+	])
+	.flags({
 		greet: {
 			type: "string",
 			description: "Greeting to use",
 			default: "Hello",
-			alias: "g",
+			short: "g",
 		},
-	},
-	run({ args, flags }) {
+	})
+	.run(({ args, flags }) => {
 		console.log(`${flags.greet}, ${args.name}!`);
-	},
-});
+	});
 
-runMain(main, {
-	plugins: [versionPlugin(pkg.version), helpPlugin()],
-});
+await cli.execute();

package/templates/modular/README.md

@@ -0,0 +1,29 @@
+# {{name}}
+
+A modular CLI built with [Crust](https://crustjs.com).
+
+This template demonstrates the file-splitting pattern with `.sub()` and `.command(builder)`.
+
+## Development
+
+```sh
+# Run in dev mode
+bun run dev
+
+# Type-check
+bun run check:types
+
+# Build standalone executable
+bun run build
+```
+
+## Usage
+
+```sh
+# Run the greet subcommand
+{{name}} greet world
+{{name}} greet --greet Hey world
+
+# Show help
+{{name}} --help
+```

package/templates/modular/_gitignore

@@ -0,0 +1,34 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+*.log
+report.*.*.*.*.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store

package/templates/modular/package.json

@@ -0,0 +1,27 @@
+{
+	"name": "{{name}}",
+	"version": "0.0.0",
+	"type": "module",
+	"description": "A CLI built with Crust",
+	"files": [
+		"dist"
+	],
+	"bin": {
+		"{{name}}": "dist/cli"
+	},
+	"scripts": {
+		"dev": "bun run src/cli.ts",
+		"build": "crust build",
+		"start": "./dist/cli",
+		"check:types": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@crustjs/core": "latest",
+		"@crustjs/plugins": "latest"
+	},
+	"devDependencies": {
+		"@crustjs/crust": "latest",
+		"@types/bun": "latest",
+		"typescript": "^5"
+	}
+}

package/templates/modular/src/app.ts

@@ -0,0 +1,13 @@
+import { Crust } from "@crustjs/core";
+
+export const app = new Crust("{{name}}")
+	.meta({ description: "A CLI built with Crust" })
+	.flags({
+		greet: {
+			type: "string",
+			description: "Greeting to use",
+			default: "Hello",
+			short: "g",
+			inherit: true,
+		},
+	});

package/templates/modular/src/cli.ts

@@ -0,0 +1,10 @@
+import { helpPlugin, versionPlugin } from "@crustjs/plugins";
+import pkg from "../package.json";
+import { app } from "./app.ts";
+import { greetCmd } from "./commands/greet.ts";
+
+await app
+	.use(versionPlugin(pkg.version))
+	.use(helpPlugin())
+	.command(greetCmd)
+	.execute();

package/templates/modular/src/commands/greet.ts

@@ -0,0 +1,16 @@
+import { app } from "../app.ts";
+
+export const greetCmd = app
+	.sub("greet")
+	.meta({ description: "Greet someone" })
+	.args([
+		{
+			name: "name",
+			type: "string",
+			description: "Your name",
+			default: "world",
+		},
+	])
+	.run(({ args, flags }) => {
+		console.log(`${flags.greet}, ${args.name}!`);
+	});

package/templates/modular/tsconfig.json

@@ -0,0 +1,17 @@
+{
+	"compilerOptions": {
+		"lib": ["ESNext"],
+		"target": "ESNext",
+		"module": "Preserve",
+		"moduleDetection": "force",
+		"moduleResolution": "bundler",
+		"allowImportingTsExtensions": true,
+		"verbatimModuleSyntax": true,
+		"noEmit": true,
+		"strict": true,
+		"skipLibCheck": true,
+		"noFallthroughCasesInSwitch": true,
+		"noUncheckedIndexedAccess": true
+	},
+	"include": ["src"]
+}