create-jst 0.4.9 → 0.4.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-jst",
-  "version": "0.4.9",
+  "version": "0.4.11",
   "description": "Create a web application from the JST template.",
   "type": "module",
   "packageManager": "npm@11.6.2",
@@ -12,7 +12,7 @@
     "src"
   ],
   "engines": {
-    "node": ">=24.15.0 <25"
+    "node": ">=22.14.0"
   },
   "scripts": {
     "lint": "eslint . --max-warnings 0",
@@ -34,6 +34,8 @@
   "license": "MIT",
   "dependencies": {
     "@clack/prompts": "^1.8.1",
+    "@reatom/core": "^1001.3.0",
+    "@reatom/react": "^1001.0.1",
     "degit": "^3.10.0"
   },
   "devDependencies": {

package/src/application/projectInitializer.mjs

@@ -29,11 +29,21 @@ export function createProjectInitializer({ onProgress = () => undefined, project
 					onProgress({ type: 'git.initialization.started', specification })
 					await projectGateway.initializeGit(temporaryDestination)
 				}
+				else {
+					await projectGateway.removeGitMetadata(temporaryDestination)
+				}
+				if (specification.install) {
+					await projectGateway.assertRuntimeSupported(temporaryDestination)
+				}
 				await projectGateway.commitDestination(temporaryDestination, specification.destination)
 				rollbackDestination = specification.destination
 				if (specification.install) {
 					onProgress({ type: 'dependencies.installation.started', specification })
-					await projectGateway.installDependencies(specification.destination, specification.packageManager)
+					await projectGateway.installDependencies(
+						specification.destination,
+						specification.packageManager,
+						{ gitHooks: specification.initGit },
+					)
 				}
 
 				onProgress({ type: 'project.initialized', specification })

package/src/domain/projectSpecification.mjs

@@ -3,7 +3,7 @@ export const PRIMARY_COLORS = ['dark', 'gray', 'red', 'pink', 'grape', 'violet',
 export const PACKAGE_MANAGERS = ['npm', 'pnpm']
 export const STYLE_LANGUAGES = ['css', 'scss']
 export const EXAMPLES = ['clean', 'showcase']
-export const TEMPLATE_SOURCE = 'jst-stack/jst#v0.4.3'
+export const TEMPLATE_SOURCE = 'jst-stack/jst#v0.4.6'
 export const SHOWCASE_SOURCE = 'jst-stack/jst-showcase#62bc760f9df49fe110c055b914b087ba0d95402a'
 
 export function buildProjectSpecification(input) {

package/src/infrastructure/nodeProjectGateway.mjs

@@ -16,6 +16,7 @@ const textExtensions = new Set(['.md', '.mjs', '.yaml', '.yml'])
 export function createNodeProjectGateway({ nodeExecutable, signal }) {
 	return {
 		assertDestinationIsEmpty,
+		assertRuntimeSupported,
 		cleanupDestination,
 		commitDestination,
 		configureExample,
@@ -24,6 +25,7 @@ export function createNodeProjectGateway({ nodeExecutable, signal }) {
 		initializeGit,
 		installDependencies,
 		prepareDestination,
+		removeGitMetadata,
 		validateTemplate,
 	}
 
@@ -53,6 +55,7 @@ export function createNodeProjectGateway({ nodeExecutable, signal }) {
 		return run(nodeExecutable, [
 			'scripts/setup-template.mjs',
 			'--yes',
+			'--quiet',
 			'--name', specification.name,
 			'--title', specification.title,
 			'--description', specification.description,
@@ -63,19 +66,13 @@ export function createNodeProjectGateway({ nodeExecutable, signal }) {
 		], specification.destination, { signal })
 	}
 
-	async function configureExample(specification) {
-		const manifestPath = join(specification.destination, 'package.json')
-		const manifest = JSON.parse(await readFile(manifestPath, 'utf8'))
-		manifest.name = specification.name
-		await writeFile(manifestPath, `${JSON.stringify(manifest, null, '\t')}\n`)
-	}
-
 	function initializeGit(destination) {
 		return run('git', ['init', '--initial-branch=main'], destination, { signal })
 	}
 
-	function installDependencies(destination, packageManager) {
+	function installDependencies(destination, packageManager, { gitHooks = true } = {}) {
 		return run(packageManager, installCommands[packageManager], destination, {
+			env: gitHooks ? undefined : { ...process.env, HUSKY: '0' },
 			shell: process.platform === 'win32',
 			signal,
 		})
@@ -99,6 +96,42 @@ export function createNodeProjectGateway({ nodeExecutable, signal }) {
 	}
 }
 
+async function configureExample(specification) {
+	const manifestPath = join(specification.destination, 'package.json')
+	const manifest = JSON.parse(await readFile(manifestPath, 'utf8'))
+	manifest.name = specification.name
+	await writeFile(manifestPath, `${JSON.stringify(manifest, null, '\t')}\n`)
+}
+
+function removeGitMetadata(destination) {
+	return rm(join(destination, '.git'), { force: true, recursive: true })
+}
+
+async function assertRuntimeSupported(destination) {
+	const manifest = JSON.parse(await readFile(join(destination, 'package.json'), 'utf8'))
+	const required = manifest.engines?.node
+	const match = /^>=(\d+)\.(\d+)\.(\d+) <(\d+)$/u.exec(required ?? '')
+	if (!match) {
+		return
+	}
+	const current = process.versions.node.split('.').map(Number)
+	const minimum = match.slice(1, 4).map(Number)
+	const maximumMajor = Number(match[4])
+	if (current[0] < maximumMajor && compareVersions(current, minimum) >= 0) {
+		return
+	}
+	throw new Error(`This template requires Node.js ${required}; detected ${process.versions.node}. Upgrade Node and run create-jst again.`)
+}
+
+function compareVersions(left, right) {
+	for (let index = 0; index < right.length; index += 1) {
+		if (left[index] !== right[index]) {
+			return left[index] - right[index]
+		}
+	}
+	return 0
+}
+
 async function configurePackageManager(destination, packageManager, signal) {
 	const manifestPath = join(destination, 'package.json')
 	const manifest = JSON.parse(await readFile(manifestPath, 'utf8'))
@@ -195,9 +228,9 @@ async function prepareDestination(destination) {
 	return temporaryDestination
 }
 
-function run(command, args, cwd, { shell = false, signal } = {}) {
+function run(command, args, cwd, { env, shell = false, signal } = {}) {
 	return new Promise((resolve, reject) => {
-		const child = spawn(command, args, { cwd, shell, signal, stdio: 'inherit' })
+		const child = spawn(command, args, { cwd, env, shell, signal, stdio: 'inherit' })
 		child.once('error', error => reject(new Error(`Could not run ${command}: ${error.message}`)))
 		child.once('close', code => {
 			if (code === 0) {

package/src/ui/command.mjs

@@ -89,6 +89,11 @@ Usage:
 The interactive wizard only asks about decisions that affect the generated project.
 Application title and description are derived from the directory; pass flags only when automation needs overrides.
 
+Examples:
+  npm create jst@latest my-app
+  npm create jst@latest my-app -- --yes --style scss
+  npm create jst@latest jst-showcase -- --example showcase
+
 Options:
   --package-manager <manager>    auto, npm, or pnpm
   --no-install                   create the project without installing dependencies

package/src/ui/reporter.mjs

@@ -74,14 +74,43 @@ export function createReporter(output, environment = {}) {
 				output.write(`${dim('  ◌')} ${message(event.specification)}\n`)
 		},
 		success(specification) {
-			if (usesClack) {
-				activeSpinner?.stop('Project created')
-				prompts.outro(`Ready. Run \`${specification.packageManager} run dev\` in ${basename(specification.destination)}.`)
-				return
-			}
-			output.write(`\n${paint('38;5;114', 'Ready.')} ${specification.title} is in ${paint('38;5;203', basename(specification.destination))}.\n\n`)
-			output.write(`  ${dim('$')} cd ${basename(specification.destination)}\n`)
-			output.write(`  ${dim('$')} ${specification.packageManager} run dev\n\n`)
+			renderSuccess({ activeSpinner, dim, output, paint, specification, usesClack })
 		},
 	}
 }
+
+function renderSuccess({ activeSpinner, dim, output, paint, specification, usesClack }) {
+	const directory = basename(specification.destination)
+	const { guidance, setup } = getNextSteps(specification, directory)
+	if (usesClack) {
+		activeSpinner?.stop('Project created')
+		prompts.note([...setup, '', ...guidance].join('\n'), 'Next steps')
+		prompts.outro(`${specification.title} is ready.`)
+		return
+	}
+	output.write(`\n${paint('38;5;114', 'Ready.')} ${specification.title} is in ${paint('38;5;203', directory)}.\n\n`)
+	for (const command of setup) {
+		output.write(`  ${dim('$')} ${command}\n`)
+	}
+	output.write('\n')
+	for (const instruction of guidance) {
+		output.write(`  ${instruction}\n`)
+	}
+	output.write('\n')
+}
+
+function getNextSteps(specification, directory) {
+	const { install, packageManager } = specification
+	return {
+		guidance: [
+			`First slice  ${packageManager} run create:slice -- feature firstFeature`,
+			`Fast gate    ${packageManager} run validate`,
+			`Release gate ${packageManager} run check:release`,
+		],
+		setup: [
+			`cd ${directory}`,
+			...(install ? [] : [`${packageManager} install`]),
+			`${packageManager} run dev`,
+		],
+	}
+}