create-crust 0.0.31 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chenxin Yan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,19 +1,36 @@
-# @crustjs/create-crust
+# create-crust
 
 Scaffold a new [Crust](https://crustjs.com) CLI project in seconds.
 
 ## Usage
 
 ```sh
-bun create crust my-cli
+npm create crust@latest my-cli
+# or
+pnpm create crust@latest my-cli
+# or
+bunx create-crust@latest my-cli
+# or
+bun create crust@latest my-cli
+# or
+deno run -A npm:create-crust@latest my-cli
 ```
 
-This will prompt for your project directory, template style, distribution mode (standalone binaries recommended, or Bun runtime package), whether to install dependencies, and optionally initialize a git repository. The package name is inferred from the directory name.
+The initializer collects the destination, any required overwrite decision, distribution mode, dependency installation choice, and Git initialization choice. Explicit flags skip the corresponding prompts; prompts can also use defaults without rendering non-interactively. The package name is inferred from the directory name.
 
-`create-crust` includes two templates:
+## Options
 
-- `Minimal` — single-file starter (`src/cli.ts`)
-- `Modular` — file-splitting pattern with `.sub()` and `.command(builder)`
+```text
+create-crust [directory] [--distribution binary|runtime] [--install|--no-install] [--git|--no-git] [--overwrite|--no-overwrite]
+```
+
+- `directory` sets the destination; otherwise the directory prompt defaults to `my-cli`.
+- `--distribution` selects `binary` for standalone executables or `runtime` for a JavaScript build run with Bun. The default is `binary`.
+- `--install` / `--no-install` installs or skips dependencies. The default is to install.
+- `--git` / `--no-git` initializes or skips a Git repository when the destination is not already inside one. The default is to initialize.
+- When the destination requires an overwrite decision, `--overwrite` overwrites conflicting files without confirmation; `--no-overwrite` aborts without prompting. The default is not to overwrite.
+
+Generated projects use the single-file starter (`src/cli.ts`).
 
 Every generated project includes:
 
@@ -39,7 +56,9 @@ The binary templates intentionally keep `build` and `package` as separate script
 
 If you need public build-time constants, `crust build` can use Bun's cwd env by default or explicit `--env-file` inputs.
 
-> **Note:** The template's top-level `package.json` has `"files": ["dist"]` and `"bin"` pointing to `dist/cli` for local development. When publishing via `crust publish`, the staged packages in `dist/npm/` each have their own `package.json` with the correct `files` and `bin` entries — the top-level fields are not used for npm distribution.
+> **Note:** Binary projects use a top-level `bin` entry at `dist/cli` for local development. `crust build --package` generates staged packages in `dist/npm/`, each with its own platform-appropriate `files` and `bin` entries; those staged manifests are used for binary npm distribution. The generated binary template's own `files` list excludes Extension artifact directories; use the staged packages to include them.
+
+Bun runtime projects use `bun build src/cli.ts --target bun --outfile dist/cli.js` and run the result with `bun run dist/cli.js`. This separate workflow does not use `crust build --runtime node`, snapshot preparation, or Extension build hooks.
 
 ## Documentation
 

package/dist/index.js

@@ -1,5 +1,2 @@
-#!/usr/bin/env bun
-// @bun
-import{existsSync as x}from"fs";import{basename as Y,resolve as j}from"path";import{Crust as Z}from"@crustjs/core";import{isInGitRepo as $,runSteps as m}from"@crustjs/create";import{spinner as g}from"@crustjs/progress";import{confirm as y,input as F,select as C}from"@crustjs/prompts";import{runSteps as R,scaffold as n}from"@crustjs/create";var w={name:"@crustjs/core",version:"0.0.19",description:"Core library for the Crust CLI framework",type:"module",license:"MIT",author:"chenxin-yan",repository:{type:"git",url:"git+https://github.com/chenxin-yan/crust.git",directory:"packages/core"},homepage:"https://crustjs.com",bugs:{url:"https://github.com/chenxin-yan/crust/issues"},keywords:["cli","command","framework","parser","bun","typescript"],files:["dist"],exports:{".":{import:"./dist/index.js",types:"./dist/index.d.ts"}},publishConfig:{access:"public"},scripts:{build:"bunup",dev:"bunup --watch","check:types":"tsc --noEmit",test:"bun test",publish:"bun publish --no-git-checks || true"},dependencies:{"@crustjs/utils":"workspace:*"},devDependencies:{"@crustjs/config":"workspace:*",bunup:"catalog:"},peerDependencies:{typescript:"catalog:"}};var k={name:"@crustjs/crust",version:"0.0.24",description:"CLI tooling for the Crust framework",type:"module",license:"MIT",author:"chenxin-yan",repository:{type:"git",url:"git+https://github.com/chenxin-yan/crust.git",directory:"packages/crust"},homepage:"https://crustjs.com",bugs:{url:"https://github.com/chenxin-yan/crust/issues"},keywords:["cli","build","compile","standalone","bun","typescript"],files:["dist/cli","dist/cli.cmd","dist/*-bun-*"],publishConfig:{access:"public"},bin:{crust:"dist/cli"},scripts:{build:"bunup && bun dist/cli.js build --package --entry src/cli.ts --name crust","build:dev":"bunup && bun dist/cli.js build --entry src/cli.ts --name crust",publish:"bun dist/cli.js publish --stage-dir dist/npm || true",dev:"bun ./src/cli.ts",start:"./dist/cli","check:types":"tsc --noEmit",test:"bun test"},devDependencies:{"@crustjs/man":"workspace:*","@crustjs/core":"workspace:*","@crustjs/plugins":"workspace:*","@crustjs/style":"workspace:*","@crustjs/config":"workspace:*",bunup:"catalog:"},peerDependencies:{typescript:"catalog:"}};var e={name:"@crustjs/plugins",version:"0.1.2",description:"Official plugins for the Crust CLI framework",type:"module",license:"MIT",author:"chenxin-yan",repository:{type:"git",url:"git+https://github.com/chenxin-yan/crust.git",directory:"packages/plugins"},homepage:"https://crustjs.com",bugs:{url:"https://github.com/chenxin-yan/crust/issues"},keywords:["cli","plugin","help","version","did-you-mean","man","bun","typescript"],files:["dist"],exports:{".":{import:"./dist/index.js",types:"./dist/index.d.ts"}},publishConfig:{access:"public"},scripts:{build:"bunup",dev:"bunup --watch","check:types":"tsc --noEmit",test:"bun test",publish:"bun publish --no-git-checks || true"},dependencies:{"@crustjs/style":"workspace:*"},devDependencies:{"@crustjs/config":"workspace:*","@crustjs/core":"workspace:*",bunup:"catalog:"},peerDependencies:{"@crustjs/core":"workspace:*",typescript:"catalog:"}};var W={crustCoreVersion:w.version,crustPluginsVersion:e.version,crustCliVersion:k.version};async function o(c){let{resolvedDir:s,name:t,template:u,distributionMode:p}=c,h=u==="minimal"?"templates/minimal":"templates/modular",b=p==="binary"?"templates/distribution/binary":"templates/distribution/runtime",i={name:t,...W};await n({template:"templates/base",dest:s,context:i}),await n({template:h,dest:s,context:i,conflict:"overwrite"}),await n({template:b,dest:s,context:i,conflict:"overwrite"})}var H=/[<>:"|?*\\]/;function O(c){if(!c)throw Error("Project name cannot be empty");if(H.test(c))throw Error(`Project name contains invalid characters: ${c}`)}function U(c){if(c===void 0)return;if(c==="minimal"||c==="modular")return c;throw Error(`Invalid template "${c}". Expected "minimal" or "modular".`)}function X(c){if(c===void 0)return;if(c==="binary"||c==="runtime")return c;throw Error(`Invalid distribution "${c}". Expected "binary" or "runtime".`)}var E=new Z("create-crust").meta({description:"Scaffold a new Crust CLI project"}).flags({template:{type:"string",description:'Template style ("minimal" or "modular")'},distribution:{type:"string",description:'Distribution mode ("binary" or "runtime")'},install:{type:"boolean",description:"Install dependencies after scaffolding"},git:{type:"boolean",description:"Initialize a git repository after scaffolding"},overwrite:{type:"boolean",description:"Overwrite the destination directory if it already exists"}}).args([{name:"directory",type:"string",description:"Project directory to scaffold into"}]).run(async({args:c,flags:s})=>{let t=c.directory??await F({message:"Project directory",default:"my-cli",validate:O}),u=j(process.cwd(),t),p=Y(u),h=U(s.template),b=X(s.distribution);if(t!=="."&&x(u)){if(s.overwrite===!0)console.log(`Directory "${p}" already exists; overwriting (--overwrite).`);if(!await y({message:`Directory "${p}" already exists. Overwrite?`,default:!1,...s.overwrite!==void 0?{initial:s.overwrite}:{}})){console.log("Aborted.");return}}let i=await C({message:"Template style",choices:[{label:"Minimal",value:"minimal",hint:"single-file starter"},{label:"Modular",value:"modular",hint:"file split with .sub()"}],default:"minimal",...h!==void 0?{initial:h}:{}}),L=await C({message:"Distribution mode",choices:[{label:"Standalone binaries (recommended)",value:"binary",hint:"compile with crust build, publish self-contained executables"},{label:"Bun runtime package",value:"runtime",hint:"ship JS build that runs with Bun"}],default:"binary",...b!==void 0?{initial:b}:{}}),q=await y({message:"Install dependencies?",default:!0,...s.install!==void 0?{initial:s.install}:{}}),z=x(u)?u:j(u,".."),B=$(z)?!1:await y({message:"Initialize a git repository?",default:!0,...s.git!==void 0?{initial:s.git}:{}}),r=p;if(await g({message:"Scaffolding project...",task:()=>o({resolvedDir:u,name:r,template:i,distributionMode:L})}),q)await m([{type:"install"}],u);if(B)await g({message:"Initializing git repository...",task:()=>m([{type:"git-init",commit:"chore: initial commit"}],u)});if(console.log(`
-Created ${r}!
-`),console.log("Next steps:"),t!=="."){let d=t.startsWith("/")?t:`./${t}`;console.log(`  cd ${d}`)}console.log("  bun run dev"),console.log("  bun run build")});await E.execute();
+#!/usr/bin/env node
+import{existsSync as e,readdirSync as t}from"node:fs";import{basename as n,resolve as r}from"node:path";import{Crust as i}from"@crustjs/core";import{isInGitRepo as a,runSteps as o,scaffold as s}from"@crustjs/create";import{spinner as c}from"@crustjs/progress";import{confirm as l,input as u,select as d}from"@crustjs/prompts";const f={crustCoreVersion:`0.2.1`,crustExtensionsVersion:`0.2.1`,crustCliVersion:`0.2.1`},p=/[<>:"|?*\\]/;function m(e){if(!e)throw Error(`Project name cannot be empty`);if(p.test(e))throw Error(`Project name contains invalid characters: ${e}`)}await new i(`create-crust`,{description:`Scaffold a new Crust CLI project`}).flags({name:`distribution`,type:`string`,choices:[`binary`,`runtime`],description:`Distribution mode ("binary" or "runtime")`},{name:`install`,type:`boolean`,description:`Install dependencies after scaffolding`},{name:`git`,type:`boolean`,description:`Initialize a git repository after scaffolding`},{name:`overwrite`,type:`boolean`,description:`Overwrite the destination directory if it already exists`}).args({name:`directory`,type:`string`,description:`Project directory to scaffold into`}).action(async({args:i,flags:p})=>{let h=i.directory??await u({message:`Project directory`,default:`my-cli`,validate:m}),g=r(process.cwd(),h),_=n(g),v=p.distribution,y=h===`.`?t(g).length>0:e(g),b=!1;if(y&&(b=await l({message:h===`.`?`Current directory is not empty. Overwrite conflicting files?`:`Directory "${_}" already exists. Overwrite?`,default:!1,...p.overwrite===void 0?{}:{initial:p.overwrite}}),!b)){console.log(`Aborted.`);return}let x=await d({message:`Distribution mode`,choices:[{label:`Standalone binaries (recommended)`,value:`binary`,hint:`compile with crust build, publish self-contained executables`},{label:`Bun runtime package`,value:`runtime`,hint:`ship JS build that runs with Bun`}],default:`binary`,...v===void 0?{}:{initial:v}}),S=await l({message:`Install dependencies?`,default:!0,...p.install===void 0?{}:{initial:p.install}}),C=e(g)?g:r(g,`..`),w=!a(C)&&await l({message:`Initialize a git repository?`,default:!0,...p.git===void 0?{}:{initial:p.git}}),T=_,E=e=>new URL(`../templates/${e}`,import.meta.url),D={name:T,...f};if(await c({message:`Scaffolding project...`,task:async()=>{await s({template:E(`base`),dest:g,context:D,...b?{conflict:`overwrite`}:{}}),await s({template:E(`minimal`),dest:g,context:D,conflict:`overwrite`}),await s({template:E(`distribution/${x}`),dest:g,context:D,conflict:`overwrite`})}}),S&&await o([{type:`install`}],g),w&&await c({message:`Initializing git repository...`,task:()=>o([{type:`git-init`,commit:`chore: initial commit`}],g)}),console.log(`\nCreated ${T}!\n`),console.log(`Next steps:`),h!==`.`){let e=h.startsWith(`/`)?h:`./${h}`;console.log(`  cd ${e}`)}console.log(`  bun run dev`),console.log(`  bun run build`)}).execute();export{};

package/package.json

@@ -1,8 +1,9 @@
 {
 	"name": "create-crust",
-	"version": "0.0.31",
+	"version": "0.2.1",
 	"description": "Scaffold a new Crust CLI project.",
 	"type": "module",
+	"sideEffects": false,
 	"license": "MIT",
 	"author": "chenxin-yan",
 	"repository": {
@@ -34,24 +35,28 @@
 		"create-crust": "dist/index.js"
 	},
 	"scripts": {
-		"build": "bunup",
-		"dev": "bunup --watch",
+		"build": "tsdown",
+		"dev": "tsdown --watch",
 		"check:types": "tsc --noEmit",
 		"test": "bun test",
 		"test:smoke": "bun test tests/cli.smoke.test.ts",
-		"publish": "bun publish --no-git-checks || true"
+		"prepack": "cp ../../LICENSE LICENSE",
+		"postpack": "rm -f LICENSE"
 	},
 	"dependencies": {
-		"@crustjs/core": "0.0.19",
-		"@crustjs/create": "0.0.7",
-		"@crustjs/progress": "0.0.4",
-		"@crustjs/prompts": "0.1.0"
+		"@crustjs/core": "^0.2.1",
+		"@crustjs/create": "^0.1.1",
+		"@crustjs/progress": "^0.1.1",
+		"@crustjs/prompts": "^0.2.1"
 	},
 	"devDependencies": {
 		"@crustjs/config": "0.0.0",
-		"bunup": "^0.16.31"
+		"@crustjs/extensions": "0.2.1",
+		"tsdown": "^0.23.0"
 	},
-	"peerDependencies": {
-		"typescript": "^6.0.3"
+	"engines": {
+		"bun": ">=1.4.0",
+		"node": ">=22",
+		"deno": ">=2.8"
 	}
 }

package/templates/distribution/binary/package.json

@@ -22,8 +22,8 @@
 	"devDependencies": {
 		"@crustjs/core": "^{{crustCoreVersion}}",
 		"@crustjs/crust": "^{{crustCliVersion}}",
-		"@crustjs/plugins": "^{{crustPluginsVersion}}",
+		"@crustjs/extensions": "^{{crustExtensionsVersion}}",
 		"@types/bun": "latest",
-		"typescript": "^6"
+		"typescript": "^7.0.2"
 	}
 }

package/templates/distribution/runtime/package.json

@@ -18,11 +18,11 @@
 	},
 	"dependencies": {
 		"@crustjs/core": "^{{crustCoreVersion}}",
-		"@crustjs/plugins": "^{{crustPluginsVersion}}"
+		"@crustjs/extensions": "^{{crustExtensionsVersion}}"
 	},
 	"devDependencies": {
 		"@crustjs/crust": "^{{crustCliVersion}}",
 		"@types/bun": "latest",
-		"typescript": "^6"
+		"typescript": "^7.0.2"
 	}
 }

package/templates/minimal/README.md

@@ -18,7 +18,7 @@ bun run build
 This template supports two distribution modes:
 
 - **Standalone binaries (recommended)**: use `bun run build` for raw binaries, then `bun run package` for npm-ready staged packages.
-- **Bun runtime package**: distribute with runtime dependencies (`@crustjs/core` and `@crustjs/plugins` in `dependencies`).
+- **Bun runtime package**: distribute with runtime dependencies (`@crustjs/core` and `@crustjs/extensions` in `dependencies`).
 
 ## Publishing
 

package/templates/minimal/src/cli.ts

@@ -1,30 +1,25 @@
 import { Crust } from "@crustjs/core";
-import { helpPlugin, versionPlugin } from "@crustjs/plugins";
+import { help, version } from "@crustjs/extensions";
 
 import pkg from "../package.json";
 
-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",
-		},
-	])
+const app = new Crust("{{name}}", { description: "A CLI built with Crust", version: pkg.version })
+	.extend(version(), help())
+	.args({
+		name: "name",
+		type: "string",
+		description: "Your name",
+		default: "world",
+	})
 	.flags({
-		greet: {
-			type: "string",
-			description: "Greeting to use",
-			default: "Hello",
-			short: "g",
-		},
+		name: "greet",
+		type: "string",
+		description: "Greeting to use",
+		default: "Hello",
+		short: "g",
 	})
-	.run(({ args, flags }) => {
-		console.log(`${flags.greet}, ${args.name}!`);
+	.action(({ args, flags, stdout }) => {
+		stdout(`${flags.greet}, ${args.name}!`);
 	});
 
-await cli.execute();
+await app.execute();

package/templates/modular/README.md

@@ -1,42 +0,0 @@
-# {{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 distribution output
-bun run build
-```
-
-This template supports two distribution modes:
-
-- **Standalone binaries (recommended)**: use `bun run build` for raw binaries, then `bun run package` for npm-ready staged packages.
-- **Bun runtime package**: distribute with runtime dependencies (`@crustjs/core` and `@crustjs/plugins` in `dependencies`).
-
-## Publishing
-
-- **Standalone binaries**:
-  `bun run build` produces raw binaries.
-  `bun run package` stages npm packages in `dist/npm/`.
-  `bun run publish` publishes the staged packages in manifest order.
-- **Bun runtime package**: keep `bin` -> `dist/cli.js`, build with Bun (`bun build ... --outfile dist/cli.js`), and keep runtime deps in `dependencies`.
-
-## Usage
-
-```sh
-# Run the greet subcommand
-{{name}} greet world
-{{name}} greet --greet Hey world
-
-# Show help
-{{name}} --help
-```

package/templates/modular/src/app.ts

@@ -1,11 +0,0 @@
-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

@@ -1,7 +0,0 @@
-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

@@ -1,16 +0,0 @@
-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}!`);
-	});