create-textmode 1.0.6 → 1.0.7

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';
-}
-
-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'] };
-  }
-}
+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';
+}
+
+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'] };
+  }
+}

package/src/prompts.js

@@ -1,90 +1,102 @@
-import path from 'path';
-import { confirm, isCancel, cancel, select, text } from '@clack/prompts';
-import kleur from 'kleur';
-import { uniqueNamesGenerator, adjectives, colors, animals } from 'unique-names-generator';
-import { templates } from './constants.js';
-
-/**
- * Handle user cancellation uniformly.
- * @param {unknown} value - The value returned from a prompt.
- * @returns {boolean} True if the user cancelled.
- */
-export function handleCancel(value) {
-  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;
-}
-
-export function suggestProjectName() {
-  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();
-}
-
-export async function promptOverwrite(targetDir) {
-  const response = await confirm({
-    message: `Directory ${path.basename(targetDir)} is not empty. Continue?`,
-    initialValue: false
-  });
-
-  handleCancel(response);
-  return response;
-}
-
-export async function promptInstall(pm) {
-  const decision = await confirm({
-    message: `Install dependencies with ${pm}?`,
-    initialValue: true
-  });
-
-  handleCancel(decision);
-  return decision;
-}
-
-export async function promptRun(pm) {
-  const decision = await confirm({
-    message: `Run dev server now with ${pm}?`,
-    initialValue: false
-  });
-
-  handleCancel(decision);
-  return decision;
-}
-
-export async function promptTextmodeVersion(options) {
-  const choice = await select({
-    message: `${kleur.cyan('Select textmode.js version')} ${kleur.gray('(latest recommended)')}`,
-    options,
-    initialValue: options[0]?.value,
-    maxItems: 5
-  });
-
-  handleCancel(choice);
-  return choice;
-}
+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';
+
+/**
+ * Handle user cancellation uniformly.
+ * @param {unknown} value - The value returned from a prompt.
+ * @returns {boolean} True if the user cancelled.
+ */
+export function handleCancel(value) {
+  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;
+}
+
+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 : [];
+}
+
+export function suggestProjectName() {
+  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();
+}
+
+export async function promptOverwrite(targetDir) {
+  const response = await confirm({
+    message: `Directory ${path.basename(targetDir)} is not empty. Continue?`,
+    initialValue: false
+  });
+
+  handleCancel(response);
+  return response;
+}
+
+export async function promptInstall(pm) {
+  const decision = await confirm({
+    message: `Install dependencies with ${pm}?`,
+    initialValue: true
+  });
+
+  handleCancel(decision);
+  return decision;
+}
+
+export async function promptRun(pm) {
+  const decision = await confirm({
+    message: `Run dev server now with ${pm}?`,
+    initialValue: false
+  });
+
+  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;
+}

package/src/runCommand.js

@@ -1,46 +1,46 @@
-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);
-  });
-}
-
-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);
-  });
-}
+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);
+  });
+}
+
+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);
+  });
+}

package/src/summary.js

@@ -1,33 +1,43 @@
-import kleur from 'kleur';
-import boxen from 'boxen';
-
-export function printSummary({ projectName, pm, pmCmds, installDone, runDone }) {
-  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 infoLines = [
-    '',
-    '',
-    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'
-  });
-
-  console.log(boxed);
-}
+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 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 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'
+  });
+
+  console.log(boxed);
+}

package/src/textmodeVersion.js

@@ -1,45 +1,57 @@
-import { spinner, log } from '@clack/prompts';
-import { getTextmodeVersions } from './versions.js';
-
-export async function resolveTextmodeVersion(requestedTextmodeVersion, promptTextmodeVersion) {
-  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 latestVersion = stableVersions[0];
-  const availableOptions = [
-    {
-      value: 'latest',
-      label: latestVersion ? `latest (${latestVersion})` : 'latest (recommended)'
-    },
-    ...stableVersions.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;
-    } else {
-      log.warn(`Requested textmode.js@${requestedTextmodeVersion} not found; using latest instead.`);
-      textmodeVersion = 'latest';
-    }
-  } else if (stableVersions.length > 0) {
-    textmodeVersion = await promptTextmodeVersion(availableOptions);
-  }
-
-  return { textmodeVersion, stableVersions, availableOptions };
-}
+import { spinner, log } from '@clack/prompts';
+import { compareSemverDesc, getTextmodeVersions, filterAtLeast } from './versions.js';
+import { MIN_TEXTMODE_VERSION } from './constants.js';
+
+export async function resolveTextmodeVersion(requestedTextmodeVersion, promptTextmodeVersion) {
+  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';
+  }
+
+  // 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 }))
+  ];
+
+  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 };
+}

package/src/usage.js

@@ -1,18 +1,21 @@
-import { templates } from './constants.js';
-
-export function printUsage() {
-  const list = templates.map((t) => `  - ${t.name}`).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('  --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, prompts if omitted)');
-  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);
-}
+import { addons, templates } 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');
+
+  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);
+}

package/src/versions.js

@@ -1,52 +1,56 @@
-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);
-  });
-}
-
-export function isStable(version) {
-  // 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;
-}
-
-export async function getTextmodeVersions(limit = 20) {
-  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);
-
-  cachedVersions = versions;
-  return versions.slice(0, limit);
-}
+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);
+  });
+}
+
+export function isStable(version) {
+  // 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;
+}
+
+export function filterAtLeast(versions, min) {
+  return versions.filter((v) => compareSemverDesc(v, min) <= 0);
+}
+
+export async function getTextmodeVersions(limit = 20) {
+  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);
+
+  cachedVersions = versions;
+  return versions.slice(0, limit);
+}