create-jst 0.4.9 → 0.4.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-jst",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "description": "Create a web application from the JST template.",
   "type": "module",
   "packageManager": "npm@11.6.2",

package/src/application/projectInitializer.mjs

@@ -33,7 +33,11 @@ export function createProjectInitializer({ onProgress = () => undefined, project
 				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.5'
 export const SHOWCASE_SOURCE = 'jst-stack/jst-showcase#62bc760f9df49fe110c055b914b087ba0d95402a'
 
 export function buildProjectSpecification(input) {

package/src/infrastructure/nodeProjectGateway.mjs

@@ -53,6 +53,7 @@ export function createNodeProjectGateway({ nodeExecutable, signal }) {
 		return run(nodeExecutable, [
 			'scripts/setup-template.mjs',
 			'--yes',
+			'--quiet',
 			'--name', specification.name,
 			'--title', specification.title,
 			'--description', specification.description,
@@ -74,8 +75,9 @@ export function createNodeProjectGateway({ nodeExecutable, signal }) {
 		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,
 		})
@@ -195,9 +197,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`,
+			`Full gate    ${packageManager} run check`,
+		],
+		setup: [
+			`cd ${directory}`,
+			...(install ? [] : [`${packageManager} install`]),
+			`${packageManager} run dev`,
+		],
+	}
+}