create-textmode 1.0.7 → 1.1.1

package/src/cli.js

@@ -9,14 +9,14 @@ import { runCommand, runCommandLogged } from './runCommand.js';
 import { printUsage } from './usage.js';
 import { addons, templates } from './constants.js';
 import {
-  promptAddons,
-  promptInstall,
-  promptProjectName,
-  promptRun,
-  promptTemplate,
-  promptOverwrite,
-  suggestProjectName,
-  promptTextmodeVersion
+	promptAddons,
+	promptInstall,
+	promptProjectName,
+	promptRun,
+	promptTemplate,
+	promptOverwrite,
+	suggestProjectName,
+	promptTextmodeVersion,
 } from './prompts.js';
 import { printHeader } from './banner.js';
 import { parseArgv, ensureKnownAddons, ensureKnownTemplate, parseAddons } from './args.js';
@@ -27,140 +27,135 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 export async function run() {
-  await printHeader();
-  intro(
-    kleur.cyan('Welcome to textmode.js - let’s scaffold a new project! ✿  ') +
-      kleur.gray('(Press Ctrl+C at any time to cancel.)')
-  );
-
-  const argv = parseArgv(process.argv.slice(2));
-
-  if (argv.help) {
-    printUsage();
-    return;
-  }
-
-  if (argv.version) {
-    const pkgJson = JSON.parse(await readFile(path.join(__dirname, '..', 'package.json'), 'utf8'));
-    console.log(pkgJson.version);
-    return;
-  }
-
-  // --- Gather project info ---
-  let projectName = argv._[0] || argv.name;
-  if (!projectName) {
-    const suggested = suggestProjectName();
-    projectName = await promptProjectName(suggested);
-  }
-  const targetDir = path.resolve(process.cwd(), projectName);
-
-  ensureKnownTemplate(argv.template);
-  let templateName = argv.template;
-  if (!templateName) {
-    templateName = await promptTemplate();
-  }
-
-  const template = templates.find((t) => t.name === templateName);
-  const templateDir = path.join(__dirname, '..', 'templates', template.dir);
-
-  // --- Resolve add-ons ---
-  ensureKnownAddons(argv.addons);
-  let selectedAddons = parseAddons(argv.addons);
-  if (selectedAddons.length === 0 && !argv.addons) {
-    selectedAddons = (await promptAddons())
-      .map((name) => addons.find((a) => a.name === name))
-      .filter(Boolean);
-  }
-
-  // --- Resolve textmode.js version ---
-  // Only versions >= the global minimum are offered; add-ons are always at
-  // their latest version, so they impose no additional floor here.
-  const requestedTextmodeVersion = argv['textmode-version'];
-  const { textmodeVersion } = await resolveTextmodeVersion(
-    requestedTextmodeVersion,
-    promptTextmodeVersion
-  );
-
-  // --- Pre-scaffold checks ---
-  const pm = argv.pm || detectPackageManager();
-  const pmCmds = pmCommands(pm);
-
-  const targetExists = await pathExists(targetDir);
-  if (targetExists && !(await isEmptyDir(targetDir)) && !argv.force) {
-    const overwrite = await promptOverwrite(targetDir);
-    if (!overwrite) {
-      outro('Aborted.');
-      return;
-    }
-  }
-
-  // --- Scaffold project ---
-  const scaffoldSpin = spinner();
-  scaffoldSpin.start('Scaffolding project...');
-  await scaffoldTemplate({ templateDir, targetDir, projectName, textmodeVersion, addons: selectedAddons });
-  scaffoldSpin.stop('Scaffold complete.');
-
-  // --- Install dependencies ---
-  let installDone = false;
-
-  const userInstall = argv.install;
-  const userNoInstall = argv['no-install'];
-  const hasInstallFlag = userInstall !== null || userNoInstall === true;
-  let doInstall = userInstall === true;
-
-  if (!hasInstallFlag) {
-    doInstall = await promptInstall(pm);
-  }
-
-  if (doInstall) {
-    const installSpin = spinner();
-    installSpin.start(`Installing dependencies with ${pm}...`);
-    let seenOutput = false;
-    try {
-      await runCommandLogged(pm, pmCmds.install, targetDir, (line) => {
-        if (!seenOutput) {
-          installSpin.stop(`Installing dependencies with ${pm}...`);
-          seenOutput = true;
-        }
-        console.log(`│  ${line}`);
-      });
-      installDone = true;
-      if (!seenOutput) installSpin.stop('Dependencies installed.');
-      log.success('Dependencies installed.');
-    } catch (err) {
-      installSpin.stop('Dependency installation failed.');
-      log.error(`Dependency installation failed: ${err.message || err}`);
-    }
-  }
-
-  // --- Run dev server ---
-  let runDone = false;
-
-  if (installDone) {
-    const userRun = argv.run;
-    const userNoRun = argv['no-run'];
-    const hasRunFlag = userRun !== null || userNoRun === true;
-    let doRun = userRun === true;
-
-    if (!hasRunFlag) {
-      doRun = await promptRun(pm);
-    }
-
-    if (doRun) {
-      log.step('Starting dev server...');
-      try {
-        await runCommand(pm, pmCmds.runDev, targetDir);
-        runDone = true;
-      } catch (err) {
-        log.error(err.message || String(err));
-      }
-    }
-  }
-
-  // --- Summary ---
-  log.message('');
-  printSummary({ projectName, pm, pmCmds, installDone, runDone, addons: selectedAddons });
-  outro(kleur.green('Enjoy textmode.js! ツ'));
+	await printHeader();
+	intro(
+		kleur.cyan('Welcome to textmode.js - let’s scaffold a new project! ✿  ') +
+			kleur.gray('(Press Ctrl+C at any time to cancel.)')
+	);
+
+	const argv = parseArgv(process.argv.slice(2));
+
+	if (argv.help) {
+		printUsage();
+		return;
+	}
+
+	if (argv.version) {
+		const pkgJson = JSON.parse(await readFile(path.join(__dirname, '..', 'package.json'), 'utf8'));
+		console.log(pkgJson.version);
+		return;
+	}
+
+	// --- Gather project info ---
+	let projectName = argv._[0] || argv.name;
+	if (!projectName) {
+		const suggested = suggestProjectName();
+		projectName = await promptProjectName(suggested);
+	}
+	const targetDir = path.resolve(process.cwd(), projectName);
+
+	ensureKnownTemplate(argv.template);
+	let templateName = argv.template;
+	if (!templateName) {
+		templateName = await promptTemplate();
+	}
+
+	const template = templates.find((t) => t.name === templateName);
+	const templateDir = path.join(__dirname, '..', 'templates', template.dir);
+
+	// --- Resolve add-ons ---
+	ensureKnownAddons(argv.addons);
+	let selectedAddons = parseAddons(argv.addons);
+	if (selectedAddons.length === 0 && !argv.addons) {
+		selectedAddons = (await promptAddons()).map((name) => addons.find((a) => a.name === name)).filter(Boolean);
+	}
+
+	// --- Resolve textmode.js version ---
+	// Only versions >= the global minimum are offered; add-ons are always at
+	// their latest version, so they impose no additional floor here.
+	const requestedTextmodeVersion = argv['textmode-version'];
+	const { textmodeVersion } = await resolveTextmodeVersion(requestedTextmodeVersion, promptTextmodeVersion);
+
+	// --- Pre-scaffold checks ---
+	const pm = argv.pm || detectPackageManager();
+	const pmCmds = pmCommands(pm);
+
+	const targetExists = await pathExists(targetDir);
+	if (targetExists && !(await isEmptyDir(targetDir)) && !argv.force) {
+		const overwrite = await promptOverwrite(targetDir);
+		if (!overwrite) {
+			outro('Aborted.');
+			return;
+		}
+	}
+
+	// --- Scaffold project ---
+	const scaffoldSpin = spinner();
+	scaffoldSpin.start('Scaffolding project...');
+	await scaffoldTemplate({ templateDir, targetDir, projectName, textmodeVersion, addons: selectedAddons });
+	scaffoldSpin.stop('Scaffold complete.');
+
+	// --- Install dependencies ---
+	let installDone = false;
+
+	const userInstall = argv.install;
+	const userNoInstall = argv['no-install'];
+	const hasInstallFlag = userInstall !== null || userNoInstall === true;
+	let doInstall = userInstall === true;
+
+	if (!hasInstallFlag) {
+		doInstall = await promptInstall(pm);
+	}
+
+	if (doInstall) {
+		const installSpin = spinner();
+		installSpin.start(`Installing dependencies with ${pm}...`);
+		let seenOutput = false;
+		try {
+			await runCommandLogged(pm, pmCmds.install, targetDir, (line) => {
+				if (!seenOutput) {
+					installSpin.stop(`Installing dependencies with ${pm}...`);
+					seenOutput = true;
+				}
+				console.log(`│  ${line}`);
+			});
+			installDone = true;
+			if (!seenOutput) installSpin.stop('Dependencies installed.');
+			log.success('Dependencies installed.');
+		} catch (err) {
+			installSpin.stop('Dependency installation failed.');
+			log.error(`Dependency installation failed: ${err.message || err}`);
+		}
+	}
+
+	// --- Run dev server ---
+	let runDone = false;
+
+	if (installDone) {
+		const userRun = argv.run;
+		const userNoRun = argv['no-run'];
+		const hasRunFlag = userRun !== null || userNoRun === true;
+		let doRun = userRun === true;
+
+		if (!hasRunFlag) {
+			doRun = await promptRun(pm);
+		}
+
+		if (doRun) {
+			log.step('Starting dev server...');
+			try {
+				await runCommand(pm, pmCmds.runDev, targetDir);
+				runDone = true;
+			} catch (err) {
+				log.error(err.message || String(err));
+			}
+		}
+	}
+
+	// --- Summary ---
+	log.message('');
+	printSummary({ projectName, pm, pmCmds, installDone, runDone, addons: selectedAddons });
+	outro(kleur.green('Enjoy textmode.js! ツ'));
 }
 
 export default run;

package/src/constants.js

@@ -8,49 +8,49 @@ export const HEADER = `
 `;
 
 export const templates = [
-  { name: 'vanilla-js', label: 'Vanilla JavaScript (vite)', dir: 'vanilla-js' },
-  { name: 'vanilla-ts', label: 'Vanilla TypeScript (vite)', dir: 'vanilla-ts' },
-  { name: 'vanilla-js-tweakpane', label: 'Vanilla JavaScript + Tweakpane (vite)', dir: 'vanilla-js-tweakpane' },
-  { name: 'vanilla-ts-tweakpane', label: 'Vanilla TypeScript + Tweakpane (vite)', dir: 'vanilla-ts-tweakpane' }
+	{ name: 'vanilla-js', label: 'Vanilla JavaScript (vite)', dir: 'vanilla-js' },
+	{ name: 'vanilla-ts', label: 'Vanilla TypeScript (vite)', dir: 'vanilla-ts' },
+	{ name: 'vanilla-js-tweakpane', label: 'Vanilla JavaScript + Tweakpane (vite)', dir: 'vanilla-js-tweakpane' },
+	{ name: 'vanilla-ts-tweakpane', label: 'Vanilla TypeScript + Tweakpane (vite)', dir: 'vanilla-ts-tweakpane' },
 ];
 
 // Official textmode.js add-on libraries that can be pre-installed. The `plugin`
 // value is the named ESM export each package provides. Add-ons are always
 // installed at their latest version.
 export const addons = [
-  {
-    name: 'export',
-    label: 'textmode.export.js',
-    description: 'Export finished artworks (PNG, GIF, video, JSON, SVG, TXT)',
-    package: 'textmode.export.js',
-    plugin: 'ExportPlugin'
-  },
-  {
-    name: 'synth',
-    label: 'textmode.synth.js',
-    description: 'Shader-backed live-coded synth scenes',
-    package: 'textmode.synth.js',
-    plugin: 'SynthPlugin'
-  },
-  {
-    name: 'figlet',
-    label: 'textmode.figlet.js',
-    description: 'FIGlet display typography',
-    package: 'textmode.figlet.js',
-    plugin: 'FigletPlugin'
-  },
-  {
-    name: 'filters',
-    label: 'textmode.filters.js',
-    description: 'GPU-accelerated image filters',
-    package: 'textmode.filters.js',
-    plugin: 'FiltersPlugin'
-  }
+	{
+		name: 'export',
+		label: 'textmode.export.js',
+		description: 'Export finished artworks (PNG, GIF, video, JSON, SVG, TXT)',
+		package: 'textmode.export.js',
+		plugin: 'ExportPlugin',
+	},
+	{
+		name: 'synth',
+		label: 'textmode.synth.js',
+		description: 'Shader-backed live-coded synth scenes',
+		package: 'textmode.synth.js',
+		plugin: 'SynthPlugin',
+	},
+	{
+		name: 'figlet',
+		label: 'textmode.figlet.js',
+		description: 'FIGlet display typography',
+		package: 'textmode.figlet.js',
+		plugin: 'FigletPlugin',
+	},
+	{
+		name: 'filters',
+		label: 'textmode.filters.js',
+		description: 'GPU-accelerated image filters',
+		package: 'textmode.filters.js',
+		plugin: 'FiltersPlugin',
+	},
 ];
 
 // Minimum textmode.js version the scaffolder will offer. All official add-ons
 // peer-depend on a lower bound well below this floor, so it also covers them.
-export const MIN_TEXTMODE_VERSION = '0.17.1';
+export const MIN_TEXTMODE_VERSION = '0.18.0';
 
 // File name patterns considered text for placeholder replacement.
 export const TEXT_FILE_REGEX = /\.(json|js|jsx|ts|tsx|vue|md|html|txt|cjs|mjs)$/i;

package/src/fs-utils.js

@@ -3,134 +3,131 @@ import { cp, mkdir, readdir, readFile, rename, stat, writeFile } from 'fs/promis
 import { IGNORED_DIR_ENTRIES, TEXT_FILE_REGEX } from './constants.js';
 
 export async function pathExists(p) {
-  try {
-    await stat(p);
-    return true;
-  } catch (err) {
-    if (err.code === 'ENOENT') return false;
-    throw err;
-  }
+	try {
+		await stat(p);
+		return true;
+	} catch (err) {
+		if (err.code === 'ENOENT') return false;
+		throw err;
+	}
 }
 
 export async function isEmptyDir(dir) {
-  try {
-    const entries = await readdir(dir);
-    const filtered = entries.filter((name) => !IGNORED_DIR_ENTRIES.includes(name));
-    return filtered.length === 0;
-  } catch (err) {
-    if (err.code === 'ENOENT') return true;
-    throw err;
-  }
+	try {
+		const entries = await readdir(dir);
+		const filtered = entries.filter((name) => !IGNORED_DIR_ENTRIES.includes(name));
+		return filtered.length === 0;
+	} catch (err) {
+		if (err.code === 'ENOENT') return true;
+		throw err;
+	}
 }
 
 async function replacePlaceholders(root, projectName) {
-  const entries = await readdir(root, { withFileTypes: true });
+	const entries = await readdir(root, { withFileTypes: true });
 
-  for (const entry of entries) {
-    const fullPath = path.join(root, entry.name);
+	for (const entry of entries) {
+		const fullPath = path.join(root, entry.name);
 
-    if (entry.isDirectory()) {
-      await replacePlaceholders(fullPath, projectName);
-      continue;
-    }
+		if (entry.isDirectory()) {
+			await replacePlaceholders(fullPath, projectName);
+			continue;
+		}
 
-    if (entry.name === '_gitignore') {
-      await rename(fullPath, path.join(root, '.gitignore'));
-      continue;
-    }
+		if (entry.name === '_gitignore') {
+			await rename(fullPath, path.join(root, '.gitignore'));
+			continue;
+		}
 
-    if (!TEXT_FILE_REGEX.test(entry.name)) continue;
+		if (!TEXT_FILE_REGEX.test(entry.name)) continue;
 
-    const data = await readFile(fullPath, 'utf8');
-    if (!data.includes('{{name}}')) continue;
+		const data = await readFile(fullPath, 'utf8');
+		if (!data.includes('{{name}}')) continue;
 
-    const next = data.replace(/{{name}}/g, projectName);
-    await writeFile(fullPath, next, 'utf8');
-  }
+		const next = data.replace(/{{name}}/g, projectName);
+		await writeFile(fullPath, next, 'utf8');
+	}
 }
 
 export async function setPackageName(targetDir, projectName) {
-  const pkgPath = path.join(targetDir, 'package.json');
-  try {
-    const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
-    pkg.name = projectName;
-    await writeFile(pkgPath, JSON.stringify(pkg, null, 2));
-  } catch (err) {
-    // If no package.json exists, ignore; templates without package.json are allowed.
-  }
+	const pkgPath = path.join(targetDir, 'package.json');
+	try {
+		const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
+		pkg.name = projectName;
+		await writeFile(pkgPath, JSON.stringify(pkg, null, 2));
+	} catch {
+		// If no package.json exists, ignore; templates without package.json are allowed.
+	}
 }
 
 export async function setTextmodeVersion(targetDir, textmodeVersion) {
-  if (!textmodeVersion) return;
-  const pkgPath = path.join(targetDir, 'package.json');
-  try {
-    const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
-    if (!pkg.dependencies) pkg.dependencies = {};
-    if (pkg.dependencies['textmode.js'] !== undefined) {
-      pkg.dependencies['textmode.js'] = textmodeVersion;
-      await writeFile(pkgPath, JSON.stringify(pkg, null, 2));
-    }
-  } catch (err) {
-    // Ignore templates without package.json or invalid JSON.
-  }
+	if (!textmodeVersion) return;
+	const pkgPath = path.join(targetDir, 'package.json');
+	try {
+		const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
+		if (!pkg.dependencies) pkg.dependencies = {};
+		if (pkg.dependencies['textmode.js'] !== undefined) {
+			pkg.dependencies['textmode.js'] = textmodeVersion;
+			await writeFile(pkgPath, JSON.stringify(pkg, null, 2));
+		}
+	} catch {
+		// Ignore templates without package.json or invalid JSON.
+	}
 }
 
 export async function addAddonDependencies(targetDir, addons) {
-  if (!addons || addons.length === 0) return;
-  const pkgPath = path.join(targetDir, 'package.json');
-  try {
-    const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
-    if (!pkg.dependencies) pkg.dependencies = {};
-    for (const addon of addons) {
-      pkg.dependencies[addon.package] = 'latest';
-    }
-    await writeFile(pkgPath, JSON.stringify(pkg, null, 2));
-  } catch (err) {
-    // Ignore templates without package.json or invalid JSON.
-  }
+	if (!addons || addons.length === 0) return;
+	const pkgPath = path.join(targetDir, 'package.json');
+	try {
+		const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
+		if (!pkg.dependencies) pkg.dependencies = {};
+		for (const addon of addons) {
+			pkg.dependencies[addon.package] = 'latest';
+		}
+		await writeFile(pkgPath, JSON.stringify(pkg, null, 2));
+	} catch {
+		// Ignore templates without package.json or invalid JSON.
+	}
 }
 
 export async function wireAddonsIntoSketch(targetDir, addons) {
-  if (!addons || addons.length === 0) return;
-
-  const tsPath = path.join(targetDir, 'src', 'sketch.ts');
-  const filePath = (await pathExists(tsPath)) ? tsPath : path.join(targetDir, 'src', 'sketch.js');
-  if (!(await pathExists(filePath))) return;
-
-  let data = await readFile(filePath, 'utf8');
-
-  // Insert add-on imports directly after the textmode.js import.
-  const importLines = addons.map((a) => `import { ${a.plugin} } from '${a.package}';`).join('\n');
-  data = data.replace(
-    /(import\s*\{[^}]*textmode[^}]*\}\s*from\s*'textmode\.js';)/,
-    `$1\n${importLines}`
-  );
-
-  // Register the plugins on the textmode.create({...}) call.
-  const pluginsStr = addons.map((a) => a.plugin).join(', ');
-  data = data.replace(/(textmode\.create\(\{)([^}]*)(\}\))/, (match, open, body, close) => {
-    if (/\bplugins\s*:/.test(body)) {
-      // Existing plugins key: append to the array.
-      const merged = body.replace(
-        /(plugins:\s*\[)([^\]]*)(\])/,
-        (m, p1, p2, p3) => p1 + (p2.trim() ? `${p2.trim()}, ` : '') + pluginsStr + p3
-      );
-      return open + ' ' + merged.trim() + ' ' + close;
-    }
-    const inner = body.trim();
-    return open + (inner ? ` ${inner}, ` : ' ') + `plugins: [${pluginsStr}] ` + close;
-  });
-
-  await writeFile(filePath, data, 'utf8');
+	if (!addons || addons.length === 0) return;
+
+	const tsPath = path.join(targetDir, 'src', 'sketch.ts');
+	const filePath = (await pathExists(tsPath)) ? tsPath : path.join(targetDir, 'src', 'sketch.js');
+	if (!(await pathExists(filePath))) return;
+
+	let data = await readFile(filePath, 'utf8');
+
+	// Insert add-on imports directly after the textmode.js import.
+	const importLines = addons.map((a) => `import { ${a.plugin} } from '${a.package}';`).join('\n');
+	data = data.replace(/(import\s*\{[^}]*textmode[^}]*\}\s*from\s*'textmode\.js';)/, `$1\n${importLines}`);
+
+	// Register the plugins on the textmode.create({...}) call.
+	const pluginsStr = addons.map((a) => a.plugin).join(', ');
+	data = data.replace(/(textmode\.create\(\{)([^}]*)(\}\))/, (match, open, body, close) => {
+		if (/\bplugins\s*:/.test(body)) {
+			// Existing plugins key: append to the array.
+			const merged = body.replace(
+				/(plugins:\s*\[)([^\]]*)(\])/,
+				(m, p1, p2, p3) => p1 + (p2.trim() ? `${p2.trim()}, ` : '') + pluginsStr + p3
+			);
+			return open + ' ' + merged.trim() + ' ' + close;
+		}
+		const inner = body.trim();
+		return open + (inner ? ` ${inner}, ` : ' ') + `plugins: [${pluginsStr}] ` + close;
+	});
+
+	await writeFile(filePath, data, 'utf8');
 }
 
 export async function scaffoldTemplate({ templateDir, targetDir, projectName, textmodeVersion, addons = [] }) {
-  await mkdir(targetDir, { recursive: true });
-  await cp(templateDir, targetDir, { recursive: true, force: true });
-
-  await replacePlaceholders(targetDir, projectName);
-  await setPackageName(targetDir, projectName);
-  await setTextmodeVersion(targetDir, textmodeVersion);
-  await addAddonDependencies(targetDir, addons);
-  await wireAddonsIntoSketch(targetDir, addons);
+	await mkdir(targetDir, { recursive: true });
+	await cp(templateDir, targetDir, { recursive: true, force: true });
+
+	await replacePlaceholders(targetDir, projectName);
+	await setPackageName(targetDir, projectName);
+	await setTextmodeVersion(targetDir, textmodeVersion);
+	await addAddonDependencies(targetDir, addons);
+	await wireAddonsIntoSketch(targetDir, addons);
 }

package/src/packageManager.js

@@ -1,18 +1,18 @@
 export function detectPackageManager() {
-  const ua = process.env.npm_config_user_agent || '';
-  if (ua.includes('pnpm')) return 'pnpm';
-  if (ua.includes('yarn')) return 'yarn';
-  if (ua.includes('bun')) return 'bun';
-  return 'npm';
+	const ua = process.env.npm_config_user_agent || '';
+	if (ua.includes('pnpm')) return 'pnpm';
+	if (ua.includes('yarn')) return 'yarn';
+	if (ua.includes('bun')) return 'bun';
+	return 'npm';
 }
 
 export function pmCommands(pm) {
-  switch (pm) {
-    case 'pnpm':
-    case 'yarn':
-    case 'bun':
-      return { install: ['install'], runDev: ['run', 'dev'] };
-    default:
-      return { install: ['install'], runDev: ['run', 'dev'] };
-  }
+	switch (pm) {
+		case 'pnpm':
+		case 'yarn':
+		case 'bun':
+			return { install: ['install'], runDev: ['run', 'dev'] };
+		default:
+			return { install: ['install'], runDev: ['run', 'dev'] };
+	}
 }