create-textmode 1.0.7 → 1.1.0

package/src/prompts.js

@@ -2,101 +2,102 @@ import path from 'path';
 import { confirm, isCancel, cancel, multiselect, select, text } from '@clack/prompts';
 import kleur from 'kleur';
 import { uniqueNamesGenerator, adjectives, colors, animals } from 'unique-names-generator';
-import { addons, templates } from './constants.js';
+import { addons, templates, MIN_TEXTMODE_VERSION } from './constants.js';
 
 /**
  * Handle user cancellation uniformly.
- * @param {unknown} value - The value returned from a prompt.
- * @returns {boolean} True if the user cancelled.
+ *
+ * @param value - The value returned from a prompt.
+ * @returns True if the user cancelled.
  */
 export function handleCancel(value) {
-  if (isCancel(value)) {
-    cancel('Operation cancelled.');
-    process.exit(0);
-  }
-  return false;
+	if (isCancel(value)) {
+		cancel('Operation cancelled.');
+		process.exit(0);
+	}
+	return false;
 }
 
 export async function promptTemplate() {
-  const choice = await select({
-    message: `${kleur.cyan('Select a template')} ${kleur.gray('(↑↓ move, ↵ confirm)')}`,
-    options: templates.map((t) => ({ value: t.name, label: t.label })),
-    initialValue: templates[0].name
-  });
-
-  handleCancel(choice);
-  return choice;
+	const choice = await select({
+		message: `${kleur.cyan('Select a template')} ${kleur.gray('(↑↓ move, ↵ confirm)')}`,
+		options: templates.map((t) => ({ value: t.name, label: t.label })),
+		initialValue: templates[0].name,
+	});
+
+	handleCancel(choice);
+	return choice;
 }
 
 export async function promptAddons() {
-  const selection = await multiselect({
-    message: `${kleur.cyan('Select add-on libraries to pre-install')} ${kleur.gray('(space to toggle, ↵ confirm, none = skip)')}`,
-    options: addons.map((a) => ({ value: a.name, label: a.label, hint: a.description })),
-    required: false,
-    initialValue: []
-  });
-
-  handleCancel(selection);
-  return Array.isArray(selection) ? selection : [];
+	const selection = await multiselect({
+		message: `${kleur.cyan('Select add-on libraries to pre-install')} ${kleur.gray('(space to toggle, ↵ confirm, none = skip)')}`,
+		options: addons.map((a) => ({ value: a.name, label: a.label, hint: a.description })),
+		required: false,
+		initialValue: [],
+	});
+
+	handleCancel(selection);
+	return Array.isArray(selection) ? selection : [];
 }
 
 export function suggestProjectName() {
-  return uniqueNamesGenerator({
-    dictionaries: [adjectives, colors, animals],
-    separator: '-',
-    length: 3
-  });
+	return uniqueNamesGenerator({
+		dictionaries: [adjectives, colors, animals],
+		separator: '-',
+		length: 3,
+	});
 }
 
 export async function promptProjectName(defaultName) {
-  const name = await text({
-    message: `${kleur.cyan('Project name')} ${kleur.gray('(enter to accept default)')}`,
-    initialValue: defaultName,
-    validate: (value) => (value && value.trim().length > 0 ? undefined : 'Name cannot be empty')
-  });
-
-  handleCancel(name);
-  return name.trim();
+	const name = await text({
+		message: `${kleur.cyan('Project name')} ${kleur.gray('(enter to accept default)')}`,
+		initialValue: defaultName,
+		validate: (value) => (value && value.trim().length > 0 ? undefined : 'Name cannot be empty'),
+	});
+
+	handleCancel(name);
+	return name.trim();
 }
 
 export async function promptOverwrite(targetDir) {
-  const response = await confirm({
-    message: `Directory ${path.basename(targetDir)} is not empty. Continue?`,
-    initialValue: false
-  });
+	const response = await confirm({
+		message: `Directory ${path.basename(targetDir)} is not empty. Continue?`,
+		initialValue: false,
+	});
 
-  handleCancel(response);
-  return response;
+	handleCancel(response);
+	return response;
 }
 
 export async function promptInstall(pm) {
-  const decision = await confirm({
-    message: `Install dependencies with ${pm}?`,
-    initialValue: true
-  });
+	const decision = await confirm({
+		message: `Install dependencies with ${pm}?`,
+		initialValue: true,
+	});
 
-  handleCancel(decision);
-  return decision;
+	handleCancel(decision);
+	return decision;
 }
 
 export async function promptRun(pm) {
-  const decision = await confirm({
-    message: `Run dev server now with ${pm}?`,
-    initialValue: false
-  });
+	const decision = await confirm({
+		message: `Run dev server now with ${pm}?`,
+		initialValue: false,
+	});
 
-  handleCancel(decision);
-  return decision;
+	handleCancel(decision);
+	return decision;
 }
 
 export async function promptTextmodeVersion(options) {
-  const choice = await select({
-    message: `${kleur.cyan('Select textmode.js version')} ${kleur.gray('(latest recommended, >= 0.17.1)')}`,
-    options,
-    initialValue: options[0]?.value,
-    maxItems: 5
-  });
-
-  handleCancel(choice);
-  return choice;
+	const choice = await select({
+		message: `${kleur.cyan('Select textmode.js version')} ${kleur.gray(`(latest recommended, >= ${MIN_TEXTMODE_VERSION})`)}`,
+		options,
+		initialValue: options[0]?.value,
+		maxItems: 5,
+	});
+
+	handleCancel(choice);
+	return choice;
 }

package/src/runCommand.js

@@ -2,45 +2,45 @@ import { spawn } from 'child_process';
 import readline from 'readline';
 
 export function runCommand(cmd, args, cwd) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(cmd, args, {
-      cwd,
-      stdio: 'inherit',
-      shell: process.platform === 'win32'
-    });
-
-    child.on('exit', (code) => {
-      if (code === 0) resolve();
-      else reject(new Error(`${cmd} ${args.join(' ')} exited with code ${code}`));
-    });
-
-    child.on('error', reject);
-  });
+	return new Promise((resolve, reject) => {
+		const child = spawn(cmd, args, {
+			cwd,
+			stdio: 'inherit',
+			shell: process.platform === 'win32',
+		});
+
+		child.on('exit', (code) => {
+			if (code === 0) resolve();
+			else reject(new Error(`${cmd} ${args.join(' ')} exited with code ${code}`));
+		});
+
+		child.on('error', reject);
+	});
 }
 
 export function runCommandLogged(cmd, args, cwd, onLine) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(cmd, args, {
-      cwd,
-      stdio: ['inherit', 'pipe', 'pipe'],
-      shell: process.platform === 'win32'
-    });
-
-    const forward = (stream) => {
-      if (!stream) return;
-      const rl = readline.createInterface({ input: stream });
-      rl.on('line', (line) => onLine(line));
-      rl.on('error', () => {});
-    };
-
-    forward(child.stdout);
-    forward(child.stderr);
-
-    child.on('exit', (code) => {
-      if (code === 0) resolve();
-      else reject(new Error(`${cmd} ${args.join(' ')} exited with code ${code}`));
-    });
-
-    child.on('error', reject);
-  });
+	return new Promise((resolve, reject) => {
+		const child = spawn(cmd, args, {
+			cwd,
+			stdio: ['inherit', 'pipe', 'pipe'],
+			shell: process.platform === 'win32',
+		});
+
+		const forward = (stream) => {
+			if (!stream) return;
+			const rl = readline.createInterface({ input: stream });
+			rl.on('line', (line) => onLine(line));
+			rl.on('error', () => {});
+		};
+
+		forward(child.stdout);
+		forward(child.stderr);
+
+		child.on('exit', (code) => {
+			if (code === 0) resolve();
+			else reject(new Error(`${cmd} ${args.join(' ')} exited with code ${code}`));
+		});
+
+		child.on('error', reject);
+	});
 }

package/src/summary.js

@@ -2,42 +2,37 @@ import kleur from 'kleur';
 import boxen from 'boxen';
 
 export function printSummary({ projectName, pm, pmCmds, installDone, runDone, addons = [] }) {
-  const installCmd = `${pm} ${pmCmds.install.join(' ')}`;
-  const runCmd = `${pm} ${pmCmds.runDev.join(' ')}`;
+	const installCmd = `${pm} ${pmCmds.install.join(' ')}`;
+	const runCmd = `${pm} ${pmCmds.runDev.join(' ')}`;
 
-  const steps = [
-    `cd ${projectName}`,
-    installDone ? `✓ already ran ${installCmd}` : installCmd,
-    runDone ? `✓ dev server is running (${runCmd})` : runCmd
-  ]
-    .filter(Boolean)
-    .join('\n');
+	const steps = [
+		`cd ${projectName}`,
+		installDone ? `✓ already ran ${installCmd}` : installCmd,
+		runDone ? `✓ dev server is running (${runCmd})` : runCmd,
+	]
+		.filter(Boolean)
+		.join('\n');
 
-  const addonLines =
-    addons.length > 0
-      ? [
-          '',
-          '',
-          kleur.bold().cyan('Add-ons installed:'),
-          addons.map((a) => `  ${a.label}`).join('\n')
-        ].join('\n')
-      : '';
+	const addonLines =
+		addons.length > 0
+			? ['', '', kleur.bold().cyan('Add-ons installed:'), addons.map((a) => `  ${a.label}`).join('\n')].join('\n')
+			: '';
 
-  const infoLines = [
-    addonLines,
-    '',
-    kleur.bold().cyan('Helpful links:'),
-    `${kleur.cyan('  Documentation:')} https://code.textmode.art`,
-    `${kleur.cyan('  Community:')} https://discord.gg/sjrw8QXNks`,
-    `${kleur.cyan('  CLI issues:')} https://github.com/humanbydefinition/create-textmode/issues`
-  ].join('\n');
+	const infoLines = [
+		addonLines,
+		'',
+		kleur.bold().cyan('Helpful links:'),
+		`${kleur.cyan('  Documentation:')} https://code.textmode.art`,
+		`${kleur.cyan('  Community:')} https://discord.gg/sjrw8QXNks`,
+		`${kleur.cyan('  CLI issues:')} https://github.com/humanbydefinition/create-textmode/issues`,
+	].join('\n');
 
-  const boxed = boxen(`${kleur.bold().cyan('Next steps:')}\n${steps}${infoLines}`, {
-    padding: { top: 0, bottom: 0, left: 2, right: 2 },
-    margin: { top: 0, bottom: 0 },
-    borderStyle: 'round',
-    borderColor: 'cyan'
-  });
+	const boxed = boxen(`${kleur.bold().cyan('Next steps:')}\n${steps}${infoLines}`, {
+		padding: { top: 0, bottom: 0, left: 2, right: 2 },
+		margin: { top: 0, bottom: 0 },
+		borderStyle: 'round',
+		borderColor: 'cyan',
+	});
 
-  console.log(boxed);
+	console.log(boxed);
 }

package/src/textmodeVersion.js

@@ -3,55 +3,55 @@ import { compareSemverDesc, getTextmodeVersions, filterAtLeast } from './version
 import { MIN_TEXTMODE_VERSION } from './constants.js';
 
 export async function resolveTextmodeVersion(requestedTextmodeVersion, promptTextmodeVersion) {
-  let textmodeVersion = 'latest';
-  let stableVersions = [];
+	let textmodeVersion = 'latest';
+	let stableVersions;
 
-  const versionSpinner = spinner();
-  versionSpinner.start('Fetching textmode.js versions...');
-  try {
-    stableVersions = await getTextmodeVersions();
-    if (stableVersions.length === 0) throw new Error('No versions found');
-    versionSpinner.stop('Fetched textmode.js versions.');
-  } catch (err) {
-    versionSpinner.stop('Could not fetch versions.');
-    log.warn('Using latest version as fallback.');
-    stableVersions = [];
-    textmodeVersion = 'latest';
-  }
+	const versionSpinner = spinner();
+	versionSpinner.start('Fetching textmode.js versions...');
+	try {
+		stableVersions = await getTextmodeVersions();
+		if (stableVersions.length === 0) throw new Error('No versions found');
+		versionSpinner.stop('Fetched textmode.js versions.');
+	} catch {
+		versionSpinner.stop('Could not fetch versions.');
+		log.warn('Using latest version as fallback.');
+		stableVersions = [];
+		textmodeVersion = 'latest';
+	}
 
-  // Only offer versions at or above the global minimum (e.g. >= 0.17.1).
-  // Every official add-on peer-depends on a lower floor, so this also covers
-  // add-on compatibility.
-  const eligibleVersions = filterAtLeast(stableVersions, MIN_TEXTMODE_VERSION);
+	// Only offer versions at or above the global minimum (e.g. >= 0.17.1).
+	// Every official add-on peer-depends on a lower floor, so this also covers
+	// add-on compatibility.
+	const eligibleVersions = filterAtLeast(stableVersions, MIN_TEXTMODE_VERSION);
 
-  const latestVersion = eligibleVersions[0] || stableVersions[0];
-  const availableOptions = [
-    {
-      value: 'latest',
-      label: latestVersion ? `latest (${latestVersion})` : 'latest (recommended)'
-    },
-    ...eligibleVersions.slice(1).map((v) => ({ value: v, label: v }))
-  ];
+	const latestVersion = eligibleVersions[0] || stableVersions[0];
+	const availableOptions = [
+		{
+			value: 'latest',
+			label: latestVersion ? `latest (${latestVersion})` : 'latest (recommended)',
+		},
+		...eligibleVersions.slice(1).map((v) => ({ value: v, label: v })),
+	];
 
-  if (requestedTextmodeVersion) {
-    const found = availableOptions.find((opt) => opt.value === requestedTextmodeVersion);
-    if (found) {
-      textmodeVersion = requestedTextmodeVersion;
-    } else if (stableVersions.includes(requestedTextmodeVersion)) {
-      textmodeVersion = requestedTextmodeVersion;
-      if (compareSemverDesc(requestedTextmodeVersion, MIN_TEXTMODE_VERSION) > 0) {
-        log.warn(
-          `textmode.js must be >= ${MIN_TEXTMODE_VERSION}, but ${requestedTextmodeVersion} is older. Upgrading to latest.`
-        );
-        textmodeVersion = 'latest';
-      }
-    } else {
-      log.warn(`Requested textmode.js@${requestedTextmodeVersion} not found; using latest instead.`);
-      textmodeVersion = 'latest';
-    }
-  } else if (eligibleVersions.length > 0) {
-    textmodeVersion = await promptTextmodeVersion(availableOptions);
-  }
+	if (requestedTextmodeVersion) {
+		const found = availableOptions.find((opt) => opt.value === requestedTextmodeVersion);
+		if (found) {
+			textmodeVersion = requestedTextmodeVersion;
+		} else if (stableVersions.includes(requestedTextmodeVersion)) {
+			textmodeVersion = requestedTextmodeVersion;
+			if (compareSemverDesc(requestedTextmodeVersion, MIN_TEXTMODE_VERSION) > 0) {
+				log.warn(
+					`textmode.js must be >= ${MIN_TEXTMODE_VERSION}, but ${requestedTextmodeVersion} is older. Upgrading to latest.`
+				);
+				textmodeVersion = 'latest';
+			}
+		} else {
+			log.warn(`Requested textmode.js@${requestedTextmodeVersion} not found; using latest instead.`);
+			textmodeVersion = 'latest';
+		}
+	} else if (eligibleVersions.length > 0) {
+		textmodeVersion = await promptTextmodeVersion(availableOptions);
+	}
 
-  return { textmodeVersion, stableVersions, availableOptions };
+	return { textmodeVersion, stableVersions, availableOptions };
 }

package/src/usage.js

@@ -1,21 +1,23 @@
-import { addons, templates } from './constants.js';
+import { addons, templates, MIN_TEXTMODE_VERSION } from './constants.js';
 
 export function printUsage() {
-  const list = templates.map((t) => `  - ${t.name}`).join('\n');
-  const addonList = addons.map((a) => `  - ${a.name} (${a.package})`).join('\n');
+	const list = templates.map((t) => `  - ${t.name}`).join('\n');
+	const addonList = addons.map((a) => `  - ${a.name} (${a.package})`).join('\n');
 
-  console.log(`Usage: npm create textmode@latest [project-name] -- [options]\n`);
-  console.log('Options:');
-  console.log('  --template <name>          Choose a template');
-  console.log('  --addons <name1,name2,...> Pre-install official textmode.js add-ons');
-  console.log('  --name <name>              Project directory name (alias: positional arg)');
-  console.log('  --pm <npm|pnpm|yarn|bun>   Force package manager (auto-detected if omitted)');
-  console.log('  --textmode-version <ver>   Pin textmode.js version (default: latest; only >= 0.17.1 offered)');
-  console.log('  --install / --no-install   Install dependencies after scaffold');
-  console.log('  --run / --no-run           Run dev server after install');
-  console.log('  --force                    Allow using a non-empty directory');
-  console.log('  --help                     Show this help');
-  console.log('  --version                  Show CLI version');
-  console.log('\nTemplates:\n' + list);
-  console.log('\nAdd-ons:\n' + addonList);
+	console.log(`Usage: npm create textmode@latest [project-name] -- [options]\n`);
+	console.log('Options:');
+	console.log('  --template <name>          Choose a template');
+	console.log('  --addons <name1,name2,...> Pre-install official textmode.js add-ons');
+	console.log('  --name <name>              Project directory name (alias: positional arg)');
+	console.log('  --pm <npm|pnpm|yarn|bun>   Force package manager (auto-detected if omitted)');
+	console.log(
+		`  --textmode-version <ver>   Pin textmode.js version (default: latest; only >= ${MIN_TEXTMODE_VERSION} offered)`
+	);
+	console.log('  --install / --no-install   Install dependencies after scaffold');
+	console.log('  --run / --no-run           Run dev server after install');
+	console.log('  --force                    Allow using a non-empty directory');
+	console.log('  --help                     Show this help');
+	console.log('  --version                  Show CLI version');
+	console.log('\nTemplates:\n' + list);
+	console.log('\nAdd-ons:\n' + addonList);
 }

package/src/versions.js

@@ -3,54 +3,54 @@ import https from 'https';
 let cachedVersions = null;
 
 function fetchJson(url) {
-  return new Promise((resolve, reject) => {
-    https
-      .get(url, (res) => {
-        let data = '';
-        res.on('data', (chunk) => {
-          data += chunk;
-        });
-        res.on('end', () => {
-          try {
-            resolve(JSON.parse(data));
-          } catch (err) {
-            reject(err);
-          }
-        });
-      })
-      .on('error', reject);
-  });
+	return new Promise((resolve, reject) => {
+		https
+			.get(url, (res) => {
+				let data = '';
+				res.on('data', (chunk) => {
+					data += chunk;
+				});
+				res.on('end', () => {
+					try {
+						resolve(JSON.parse(data));
+					} catch (err) {
+						reject(err);
+					}
+				});
+			})
+			.on('error', reject);
+	});
 }
 
 export function isStable(version) {
-  // Exclude prerelease tags like -beta, -rc, etc.
-  return !version.includes('-');
+	// Exclude prerelease tags like -beta, -rc, etc.
+	return !version.includes('-');
 }
 
 export function compareSemverDesc(a, b) {
-  const pa = a.split('.').map(Number);
-  const pb = b.split('.').map(Number);
-  for (let i = 0; i < Math.max(pa.length, pb.length); i += 1) {
-    const va = pa[i] || 0;
-    const vb = pb[i] || 0;
-    if (va > vb) return -1;
-    if (va < vb) return 1;
-  }
-  return 0;
+	const pa = a.split('.').map(Number);
+	const pb = b.split('.').map(Number);
+	for (let i = 0; i < Math.max(pa.length, pb.length); i += 1) {
+		const va = pa[i] || 0;
+		const vb = pb[i] || 0;
+		if (va > vb) return -1;
+		if (va < vb) return 1;
+	}
+	return 0;
 }
 
 export function filterAtLeast(versions, min) {
-  return versions.filter((v) => compareSemverDesc(v, min) <= 0);
+	return versions.filter((v) => compareSemverDesc(v, min) <= 0);
 }
 
 export async function getTextmodeVersions(limit = 20) {
-  if (cachedVersions) return cachedVersions.slice(0, limit);
+	if (cachedVersions) return cachedVersions.slice(0, limit);
 
-  const data = await fetchJson('https://registry.npmjs.org/textmode.js');
-  const versions = Object.keys(data.versions || {})
-    .filter(isStable)
-    .sort(compareSemverDesc);
+	const data = await fetchJson('https://registry.npmjs.org/textmode.js');
+	const versions = Object.keys(data.versions || {})
+		.filter(isStable)
+		.sort(compareSemverDesc);
 
-  cachedVersions = versions;
-  return versions.slice(0, limit);
+	cachedVersions = versions;
+	return versions.slice(0, limit);
 }

package/templates/vanilla-js/package.json

@@ -9,18 +9,18 @@
     "preview": "vite preview",
     "format": "prettier --write \"src/**/*.{js,ts}\"",
     "format:check": "prettier --check \"src/**/*.{js,ts}\"",
-    "lint": "eslint src --ext .js",
-    "lint:fix": "eslint src --ext .js --fix"
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
   },
   "dependencies": {
     "textmode.js": "latest"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.1",
-    "eslint": "^9.39.1",
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.8.1",
     "eslint-config-prettier": "^10.1.8",
-    "globals": "^15.14.0",
-    "prettier": "^3.7.4",
-    "vite": "^7.2.7"
+    "globals": "^16.0.0",
+    "prettier": "^3.9.5",
+    "vite": "^8.1.3"
   }
 }

package/templates/vanilla-js-tweakpane/package.json

@@ -9,19 +9,19 @@
     "preview": "vite preview",
     "format": "prettier --write \"src/**/*.{js,ts}\"",
     "format:check": "prettier --check \"src/**/*.{js,ts}\"",
-    "lint": "eslint src --ext .js",
-    "lint:fix": "eslint src --ext .js --fix"
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
   },
   "dependencies": {
     "textmode.js": "latest",
     "tweakpane": "^4.0.5"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.1",
-    "eslint": "^9.39.1",
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.8.1",
     "eslint-config-prettier": "^10.1.8",
-    "globals": "^15.14.0",
-    "prettier": "^3.7.4",
-    "vite": "^7.2.7"
+    "globals": "^16.0.0",
+    "prettier": "^3.9.5",
+    "vite": "^8.1.3"
   }
 }

package/templates/vanilla-ts/package.json

@@ -9,22 +9,22 @@
     "preview": "vite preview",
     "format": "prettier --write \"src/**/*.{js,ts}\"",
     "format:check": "prettier --check \"src/**/*.{js,ts}\"",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "textmode.js": "latest"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.1",
-    "@types/node": "^24.10.2",
-    "eslint": "^9.39.1",
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^26.1.2",
+    "eslint": "^10.8.1",
     "eslint-config-prettier": "^10.1.8",
-    "globals": "^15.14.0",
-    "prettier": "^3.7.4",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.49.0",
-    "vite": "^7.2.7"
+    "globals": "^16.0.0",
+    "prettier": "^3.9.5",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.66.0",
+    "vite": "^8.1.3"
   }
 }