@brust/create-app 2.0.0-alpha.4 → 2.0.0-alpha.5

package/README.md

@@ -17,4 +17,4 @@ bun run dev                       # http://127.0.0.1:1337
 
 `bun create` rejects `-t` and `-y`; use the long flags (the short ones work with `bunx @brust/create-app`).
 
-Full guide: [docs/create-app.md](https://github.com/AssetsArt/brust/blob/v2/docs/create-app.md).
+Full guide: [docs/create-app.md](https://github.com/AssetsArt/brust/blob/main/docs/create-app.md).

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@brust/create-app",
-  "version": "2.0.0-alpha.4",
+  "version": "2.0.0-alpha.5",
   "description": "Scaffold a brust v2 app — bun create @brust/app <name>",
   "license": "MIT",
+  "homepage": "https://brust.dev",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AssetsArt/brust.git",
     "directory": "packages/create-app"
   },
+  "bugs": {
+    "url": "https://github.com/AssetsArt/brust/issues"
+  },
   "type": "module",
   "bin": {
     "create-app": "./bin/create-app.ts"

package/src/args.ts

@@ -5,7 +5,7 @@ import { isAbsolute, resolve } from 'node:path'
 const NAME_RE = /^[a-z0-9][a-z0-9_-]*$/
 const MAX_NAME_LEN = 50
 
-export const USAGE = 'usage: bun create @brust/app <name> [--template blank|pokedex] [--tailwind] [--dir <path>] [--yes] [--brust-dep <spec>]'
+export const USAGE = 'usage: bun create @brust/app <name> [--template blank|pokedex] [--tailwind] [--dir <path>] [--yes] [--brust-dep <spec>] [--version]'
 
 export interface ParsedArgs {
   projectName: string
@@ -16,6 +16,8 @@ export interface ParsedArgs {
   /** `--tailwind` (L21): accepted and ignored since L28: the blank template uses Tailwind CSS v4 by default. */
   tailwind: boolean
   help: boolean
+  /** `--version` (F131): print the bare version and exit; no short form (see the note above). */
+  version: boolean
 }
 
 export function parseArgs(args: string[]): ParsedArgs {
@@ -26,6 +28,7 @@ export function parseArgs(args: string[]): ParsedArgs {
   let yes = false
   let tailwind = false
   let help = false
+  let version = false
   const need = (flag: string, v: string | undefined): string => {
     if (!v) throw new Error(`create-app: ${flag} requires a value`)
     return v
@@ -35,6 +38,7 @@ export function parseArgs(args: string[]): ParsedArgs {
     const a = args[i]!
     if (a === '--') continue
     if (a === '--help' || a === '-h') help = true
+    else if (a === '--version') version = true
     else if (a === '--dir') dir = need('--dir', args[++i])
     else if (a.startsWith('--dir=')) dir = need('--dir', a.slice('--dir='.length))
     else if (a === '--template' || a === '-t') template = need('--template', args[++i])
@@ -48,7 +52,7 @@ export function parseArgs(args: string[]): ParsedArgs {
     else throw new Error(`create-app: unexpected positional argument "${a}"`)
   }
 
-  if (help) return { projectName: name ?? '', targetDir: '', template, yes, brustDep, tailwind, help }
+  if (help || version) return { projectName: name ?? '', targetDir: '', template, yes, brustDep, tailwind, help, version }
   if (!name) throw new Error(`create-app: missing project name. ${USAGE}`)
   if (name.length > MAX_NAME_LEN) throw new Error(`create-app: project name too long (max ${MAX_NAME_LEN} chars)`)
   if (!NAME_RE.test(name)) {
@@ -56,5 +60,5 @@ export function parseArgs(args: string[]): ParsedArgs {
   }
   const cwd = process.cwd()
   const targetDir = dir ? (isAbsolute(dir) ? dir : resolve(cwd, dir)) : resolve(cwd, name)
-  return { projectName: name, targetDir, template, yes, brustDep, tailwind, help }
+  return { projectName: name, targetDir, template, yes, brustDep, tailwind, help, version }
 }

package/src/cli.ts

@@ -1,5 +1,5 @@
 // `create-app` main — a port of 0.1.x runNew (runtime/cli/new.ts:221-294) with the v2 dependency resolution.
-import { existsSync } from 'node:fs'
+import { existsSync, readFileSync } from 'node:fs'
 import { readdir, rm } from 'node:fs/promises'
 import { copyTemplate } from './copy.ts'
 import { parseArgs, USAGE } from './args.ts'
@@ -7,6 +7,9 @@ import { applyOverrides, monorepoRoot, resolveBrustDep } from './dep.ts'
 import { TAILWIND_DEFAULT_NOTE } from './tailwind.ts'
 import { selectTemplate } from './templates.ts'
 
+// F131: read at run time from the package.json that `bun publish` ships, so release-bump.ts stays the only place versions change.
+const ownVersion = (): string => (JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')) as { version?: string }).version ?? '0.0.0'
+
 const fail = (msg: string): never => {
   console.error(msg)
   process.exit(1)
@@ -20,6 +23,11 @@ export async function main(argv: string[]): Promise<void> {
     console.log(USAGE)
     return
   }
+  if (parsed.version) {
+    console.log(ownVersion())
+    return
+  }
+  console.log(`@brust/create-app ${ownVersion()}\n`)
   const { projectName, targetDir } = parsed
 
   const targetExisted = existsSync(targetDir)
@@ -47,13 +55,13 @@ export async function main(argv: string[]): Promise<void> {
     if (!targetExisted) await rm(targetDir, { recursive: true, force: true }).catch(() => {})
     return fail(`create-app: failed to scaffold (${msg(e)})`)
   }
-  printNextSteps(projectName, targetDir, tmpl.name, dep.kind === 'workspace')
+  printNextSteps(projectName, targetDir, tmpl.name, dep.spec, dep.kind === 'workspace')
 }
 
-function printNextSteps(name: string, targetDir: string, template: string, workspace: boolean): void {
+function printNextSteps(name: string, targetDir: string, template: string, spec: string, workspace: boolean): void {
   const cwd = process.cwd()
   const displayPath = targetDir.startsWith(`${cwd}/`) ? `./${targetDir.slice(cwd.length + 1)}` : targetDir
-  console.log(`Created ${name} at ${targetDir} (template: ${template})\n`)
+  console.log(`Created ${name} at ${targetDir} (template: ${template}, @brust/core ${spec})\n`)
   console.log('Next:')
   console.log(`  cd ${displayPath}`)
   console.log(workspace ? '  bun install   # run it at the brust repo root: this app is a workspace member' : '  bun install')

package/templates/blank/README.md.tmpl

@@ -9,7 +9,7 @@ bun install
 bun run dev        # brust dev routes.tsx (hot reload)  ->  http://127.0.0.1:1337
 ```
 
-Scripts: `dev` (build then start), `build`, `start`, `typecheck`, `dev:cf` (build for Cloudflare Workers and run `wrangler dev`), `deploy:cf` (build and `wrangler deploy`).
+Scripts: `dev` (`brust dev`, with hot reload), `build`, `start`, `typecheck`, `dev:cf` (build for Cloudflare Workers and run `wrangler dev`), `deploy:cf` (build and `wrangler deploy`).
 
 ## Layout
 
@@ -39,5 +39,5 @@ const { data } = await api.hello.get({ query: { name: 'ash' } })
 
 ## Docs
 
-- Actions: https://github.com/AssetsArt/brust/blob/v2/docs/actions.md
-- The unified store: https://github.com/AssetsArt/brust/blob/v2/docs/store.md
+- Actions: https://github.com/AssetsArt/brust/blob/main/docs/actions.md
+- The unified store: https://github.com/AssetsArt/brust/blob/main/docs/store.md

package/templates/pokedex/README.md.tmpl

@@ -55,5 +55,5 @@ bunx @tailwindcss/cli@4 -i styles/app.css -o public/app.css --minify
 
 ## Docs
 
-- Actions: https://github.com/AssetsArt/brust/blob/v2/docs/actions.md
-- The unified store: https://github.com/AssetsArt/brust/blob/v2/docs/store.md
+- Actions: https://github.com/AssetsArt/brust/blob/main/docs/actions.md
+- The unified store: https://github.com/AssetsArt/brust/blob/main/docs/store.md