create-textmode 1.0.7 → 1.1.0

package/README.md

@@ -48,7 +48,7 @@ The CLI will prompt for project name, template, textmode.js version, official ad
 
 ```bash
 # TypeScript template, pin textmode.js, auto-install, do not run dev server
-npm create textmode@latest my-textmode-app -- --template vanilla-ts --textmode-version 0.17.1 --install --no-run
+npm create textmode@latest my-textmode-app -- --template vanilla-ts --textmode-version 0.17.2 --install --no-run
 
 # JavaScript template with pnpm, skip install and run
 pnpm create textmode@latest demo -- --template vanilla-js --pm pnpm --no-install --no-run
@@ -62,7 +62,7 @@ npm create textmode@latest audio-art -- --template vanilla-js --addons synth,exp
 - `--template <name>`: choose a template *(prompts if omitted)*
 - `--addons <name1,name2,...>`: pre-install official textmode.js add-ons and wire their plugins into the starter sketch *(prompts via multi-select if omitted)*
 - `--name <projectName>` or first positional arg: directory/package name *(default suggestion if omitted)*
-- `--textmode-version <ver>`: pin textmode.js *(prompts from fetched stable versions >= 0.17.1; defaults to `latest`)*
+- `--textmode-version <ver>`: pin textmode.js *(prompts from fetched stable versions >= 0.17.2; defaults to `latest`)*
 - `--pm <npm|pnpm|yarn|bun>`: force a package manager *(auto-detected otherwise)*
 - `--install` / `--no-install`: install dependencies after scaffold *(prompts if neither is provided)*
 - `--run` / `--no-run`: start the dev server after install *(prompts if neither is provided)*
@@ -98,9 +98,9 @@ All official textmode.js add-on libraries are supported. When selected, the CLI
 
 ```bash
 npm install        # also installs git hooks (commitlint, lint-staged, pre-push protection)
-npm run check      # lint + test
-npm run lint       # node --check syntax gate
-npm test           # vitest (run once)
+npm run check      # format check + lint + test
+npm run lint       # ESLint across codebase
+npm test           # Vitest (run once)
 
 # Run CLI directly (no npm-create shim); no "--" needed
 node bin/index.js demo --template vanilla-js --pm pnpm --no-install --no-run

package/bin/index.js

@@ -3,6 +3,6 @@ import kleur from 'kleur';
 import { run } from '../src/cli.js';
 
 run().catch((err) => {
-  console.error(kleur.red(err.stack || err.message || err));
-  process.exit(1);
+	console.error(kleur.red(err.stack || err.message || err));
+	process.exit(1);
 });

package/package.json

@@ -1,70 +1,76 @@
 {
-  "name": "create-textmode",
-  "version": "1.0.7",
-  "description": "Scaffold textmode.js projects with zero friction",
-  "type": "module",
-  "bin": {
-    "create-textmode": "bin/index.js"
-  },
-  "files": [
-    "bin",
-    "src",
-    "templates",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "keywords": [
-    "textmode",
-    "textmode.js",
-    "create",
-    "scaffold",
-    "template"
-  ],
-  "author": "humanbydefinition",
-  "license": "AGPL-3.0",
-  "homepage": "https://github.com/humanbydefinition/create-textmode#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/humanbydefinition/create-textmode.git"
-  },
-  "bugs": {
-    "url": "https://github.com/humanbydefinition/create-textmode/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:verbose": "vitest run --reporter=verbose",
-    "lint": "node --check bin/index.js && node --check src/*.js && node --check tests/*.js",
-    "check": "npm run lint && npm run test",
-    "prepare": "install-git-hooks"
-  },
-  "dependencies": {
-    "@clack/prompts": "^0.11.0",
-    "boxen": "^7.1.1",
-    "kleur": "^4.1.5",
-    "minimist": "^1.2.8",
-    "unique-names-generator": "^4.7.1"
-  },
-  "devDependencies": {
-    "@commitlint/cli": "^21.2.1",
-    "@textmode/commitlint-config": "^0.1.1",
-    "@textmode/tooling-scripts": "^0.5.0",
-    "lint-staged": "^17.0.8",
-    "textmode.js": "^0.8.1",
-    "vitest": "^4.1.10"
-  },
-  "commitlint": {
-    "extends": [
-      "@textmode/commitlint-config"
-    ]
-  },
-  "lint-staged": {
-    "*.{js,mjs,cjs}": "node --check"
-  }
+	"name": "create-textmode",
+	"version": "1.1.0",
+	"description": "Scaffold textmode.js projects with zero friction",
+	"type": "module",
+	"bin": {
+		"create-textmode": "bin/index.js"
+	},
+	"files": [
+		"bin",
+		"src",
+		"templates",
+		"README.md",
+		"LICENSE"
+	],
+	"engines": {
+		"node": ">=24"
+	},
+	"devEngines": {
+		"runtime": {
+			"name": "node",
+			"version": ">=24.0.0",
+			"onFail": "warn"
+		},
+		"packageManager": {
+			"name": "npm",
+			"version": ">=10.0.0",
+			"onFail": "warn"
+		}
+	},
+	"keywords": [
+		"textmode",
+		"textmode.js",
+		"create",
+		"scaffold",
+		"template"
+	],
+	"author": "humanbydefinition",
+	"license": "AGPL-3.0",
+	"homepage": "https://github.com/humanbydefinition/create-textmode#readme",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/humanbydefinition/create-textmode.git"
+	},
+	"bugs": {
+		"url": "https://github.com/humanbydefinition/create-textmode/issues"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"test": "textmode-build test",
+		"test:watch": "textmode-build test:watch",
+		"format": "textmode-lint format",
+		"format:check": "textmode-lint format:check",
+		"lint": "textmode-lint lint .",
+		"lint:markdown": "textmode-lint lint:markdown",
+		"check": "npm run format:check && npm run lint && npm run test",
+		"release": "textmode-release release",
+		"prepare": "textmode-release hooks"
+	},
+	"dependencies": {
+		"@clack/prompts": "^1.7.0",
+		"boxen": "^8.0.1",
+		"kleur": "^4.1.5",
+		"minimist": "^1.2.8",
+		"unique-names-generator": "^4.7.1"
+	},
+	"prettier": "@textmode/lint/prettier",
+	"devDependencies": {
+		"@textmode/build": "^0.1.0",
+		"@textmode/lint": "^0.1.0",
+		"@textmode/release": "^0.2.1",
+		"textmode.js": "^0.17.2"
+	}
 }

package/src/args.js

@@ -4,54 +4,57 @@ import { addons, templates } from './constants.js';
 import { printUsage } from './usage.js';
 
 export function parseArgv(rawArgs) {
-  return minimist(rawArgs, {
-    alias: {
-      h: 'help',
-      t: 'template',
-      n: 'name',
-      f: 'force',
-      v: 'version',
-      tv: 'textmode-version'
-    },
-    string: ['template', 'name', 'pm', 'textmode-version', 'addons'],
-    boolean: ['help', 'force', 'version', 'install', 'run', 'no-install', 'no-run'],
-    default: { install: null, run: null }
-  });
+	return minimist(rawArgs, {
+		alias: {
+			h: 'help',
+			t: 'template',
+			n: 'name',
+			f: 'force',
+			v: 'version',
+			tv: 'textmode-version',
+		},
+		string: ['template', 'name', 'pm', 'textmode-version', 'addons'],
+		boolean: ['help', 'force', 'version', 'install', 'run', 'no-install', 'no-run'],
+		default: { install: null, run: null },
+	});
 }
 
 export function ensureKnownTemplate(name) {
-  if (!name) return;
-  const found = templates.find((t) => t.name === name);
-  if (found) return;
+	if (!name) return;
+	const found = templates.find((t) => t.name === name);
+	if (found) return;
 
-  console.error(kleur.red(`Unknown template: ${name}`));
-  printUsage();
-  process.exit(1);
+	console.error(kleur.red(`Unknown template: ${name}`));
+	printUsage();
+	process.exit(1);
 }
 
 export function ensureKnownAddons(names) {
-  if (!names) return;
-  const requested = names.split(',').map((s) => s.trim()).filter(Boolean);
-  const unknown = requested.filter((name) => !addons.find((a) => a.name === name));
-  if (unknown.length === 0) return;
-
-  console.error(kleur.red(`Unknown add-on(s): ${unknown.join(', ')}`));
-  console.error(kleur.gray(`Valid add-ons: ${addons.map((a) => a.name).join(', ')}`));
-  printUsage();
-  process.exit(1);
+	if (!names) return;
+	const requested = names
+		.split(',')
+		.map((s) => s.trim())
+		.filter(Boolean);
+	const unknown = requested.filter((name) => !addons.find((a) => a.name === name));
+	if (unknown.length === 0) return;
+
+	console.error(kleur.red(`Unknown add-on(s): ${unknown.join(', ')}`));
+	console.error(kleur.gray(`Valid add-ons: ${addons.map((a) => a.name).join(', ')}`));
+	printUsage();
+	process.exit(1);
 }
 
 export function parseAddons(names) {
-  if (!names) return [];
-
-  const uniqueNames = [...new Set(
-    names
-      .split(',')
-      .map((s) => s.trim())
-      .filter(Boolean)
-  )];
-
-  return uniqueNames
-    .map((name) => addons.find((a) => a.name === name))
-    .filter(Boolean);
+	if (!names) return [];
+
+	const uniqueNames = [
+		...new Set(
+			names
+				.split(',')
+				.map((s) => s.trim())
+				.filter(Boolean)
+		),
+	];
+
+	return uniqueNames.map((name) => addons.find((a) => a.name === name)).filter(Boolean);
 }

package/src/banner.js

@@ -6,52 +6,52 @@ const SPLIT_FLAP_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789#@%&/\\<>[]=+*';
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
 function randomFlapChar() {
-  const idx = Math.floor(Math.random() * SPLIT_FLAP_CHARS.length);
-  return SPLIT_FLAP_CHARS[idx];
+	const idx = Math.floor(Math.random() * SPLIT_FLAP_CHARS.length);
+	return SPLIT_FLAP_CHARS[idx];
 }
 
 async function animateSplitFlap(lines, { flips = 16, frameDelay = 32, columnStagger = 6 } = {}) {
-  const canAnimate = process.stdout.isTTY && process.env.CI !== 'true';
-  if (!canAnimate) {
-    console.log(kleur.cyan(lines.join('\n')));
-    return;
-  }
-
-  const lineCount = lines.length;
-  const blankFrame = lines.map((line) => line.replace(/[^\s]/g, ' '));
-  let firstRender = true;
-
-  const render = (frame) => {
-    if (!firstRender) {
-      process.stdout.write(`\x1b[${lineCount}F`);
-    } else {
-      firstRender = false;
-    }
-    process.stdout.write(frame.join('\n'));
-    process.stdout.write('\n');
-  };
-
-  render(blankFrame);
-
-  for (let flip = 0; flip < flips; flip++) {
-    const frameLines = lines.map((line) => {
-      const chars = line.split('').map((ch, idx) => {
-        if (ch === ' ') return ' ';
-        const shouldSettle = flip >= flips - 2 || flip > Math.floor(idx / columnStagger);
-        return shouldSettle ? ch : randomFlapChar();
-      });
-      return kleur.cyan(chars.join(''));
-    });
-    render(frameLines);
-    await sleep(frameDelay + flip * 6);
-  }
-
-  render(lines.map((line) => kleur.cyan(line)));
+	const canAnimate = process.stdout.isTTY && process.env.CI !== 'true';
+	if (!canAnimate) {
+		console.log(kleur.cyan(lines.join('\n')));
+		return;
+	}
+
+	const lineCount = lines.length;
+	const blankFrame = lines.map((line) => line.replace(/[^\s]/g, ' '));
+	let firstRender = true;
+
+	const render = (frame) => {
+		if (!firstRender) {
+			process.stdout.write(`\x1b[${lineCount}F`);
+		} else {
+			firstRender = false;
+		}
+		process.stdout.write(frame.join('\n'));
+		process.stdout.write('\n');
+	};
+
+	render(blankFrame);
+
+	for (let flip = 0; flip < flips; flip++) {
+		const frameLines = lines.map((line) => {
+			const chars = line.split('').map((ch, idx) => {
+				if (ch === ' ') return ' ';
+				const shouldSettle = flip >= flips - 2 || flip > Math.floor(idx / columnStagger);
+				return shouldSettle ? ch : randomFlapChar();
+			});
+			return kleur.cyan(chars.join(''));
+		});
+		render(frameLines);
+		await sleep(frameDelay + flip * 6);
+	}
+
+	render(lines.map((line) => kleur.cyan(line)));
 }
 
 export async function printHeader() {
-  const headerLines = HEADER.trim().split('\n');
-  console.log('');
-  await animateSplitFlap(headerLines);
-  console.log('');
+	const headerLines = HEADER.trim().split('\n');
+	console.log('');
+	await animateSplitFlap(headerLines);
+	console.log('');
 }