kasy-cli 1.5.2 → 1.6.0

package/lib/utils/checks.js

@@ -3,6 +3,7 @@ const { promisify } = require('node:util');
 const readline = require('node:readline');
 const kleur = require('kleur');
 const oraPackage = require('ora');
+const ui = require('./ui');
 const { createTranslator, detectDefaultLanguage } = require('./i18n');
 
 const execAsync = promisify(exec);
@@ -144,6 +145,17 @@ function getBackendChecks(backend) {
   return [...(BACKEND_CHECKS[backend] || [])];
 }
 
+function diagnoseFailure(err) {
+  const text = `${err?.stderr || ''}\n${err?.stdout || ''}\n${err?.message || ''}`.toLowerCase();
+  if (text.includes('xcode') && text.includes('license')) {
+    return 'xcodeLicense';
+  }
+  if (text.includes('xcode-select') || text.includes('command line tools') || text.includes('no developer tools')) {
+    return 'xcodeCli';
+  }
+  return null;
+}
+
 function extractVersion(stdout, checkName) {
   const raw = (stdout || '').trim();
   if (!raw) return null;
@@ -200,7 +212,8 @@ async function runSingleCheck(check, options = {}) {
       }
     }
     return { ...check, ok: true, version: version || null };
-  } catch {
+  } catch (err) {
+    const diagnosis = diagnoseFailure(err);
     if (check.tryInstall) {
       if (!silent) spinner.text = t(check.tryInstallMessageKey || 'setup.flutterfire.installing');
       try {
@@ -242,7 +255,10 @@ async function runSingleCheck(check, options = {}) {
     if (!silent) {
       if (check.required) {
         const detail = autoInstallFailed ? ` — ${t('checks.install.failed')}` : '';
-        spinner.fail(t('checks.missing', { name: check.name }) + detail);
+        const diagSuffix = diagnosis ? `\n    ${kleur.dim(`→ ${t(`checks.diagnostic.${diagnosis}`, { name: check.name })}`)}` : '';
+        spinner.fail(t('checks.missing', { name: check.name }) + detail + diagSuffix);
+      } else if (diagnosis) {
+        spinner.warn(t(`checks.diagnostic.${diagnosis}`, { name: check.name }));
       } else {
         const hint = !check.waitPrompt && check.failHint ? `\n    ${kleur.dim(`→ ${check.failHint}`)}` : '';
         if (check.warnMessage) {
@@ -255,7 +271,7 @@ async function runSingleCheck(check, options = {}) {
       }
     }
 
-    return { ...check, ok: false, autoInstallFailed };
+    return { ...check, ok: false, autoInstallFailed, diagnosis };
   }
 }
 
@@ -275,7 +291,8 @@ async function runChecks(checks, title, options = {}) {
 
   // Compact mode: single spinner, show failures only
   const { spinnerLabel = title, doneLabel = title } = options;
-  process.stdout.write(`  ${kleur.dim(spinnerLabel + '...')}\n`);
+  const spinner = ui.spinner();
+  spinner.start(spinnerLabel);
 
   const results = [];
   for (const check of checks) {
@@ -283,23 +300,35 @@ async function runChecks(checks, title, options = {}) {
   }
 
   const failures = results.filter((r) => !r.ok);
+  const requiredFailures = failures.filter((r) => r.required);
 
   if (failures.length === 0) {
-    console.log(kleur.green(`  ✔ ${doneLabel}`));
+    spinner.stop(doneLabel);
     return results;
   }
 
+  // Close the spinner reflecting what actually happened: red ▲ if a required
+  // check failed, default green ✦ if only optional checks failed (warnings).
+  if (requiredFailures.length > 0) {
+    spinner.error(doneLabel);
+  } else {
+    spinner.stop(doneLabel);
+  }
+
   for (const result of failures) {
-    const hint = result.failHint ? `\n    ${kleur.dim(`→ ${result.failHint}`)}` : '';
+    const hint = result.failHint ? `\n${kleur.dim(`→ ${result.failHint}`)}` : '';
     if (result.required) {
       const detail = result.autoInstallFailed ? ` — ${t('checks.install.failed')}` : '';
-      console.log(kleur.red(`  ✖ ${t('checks.missing', { name: result.name })}${detail}${hint}`));
+      const diagSuffix = result.diagnosis ? `\n${kleur.dim(`→ ${t(`checks.diagnostic.${result.diagnosis}`, { name: result.name })}`)}` : '';
+      ui.log.error(`${t('checks.missing', { name: result.name })}${detail}${diagSuffix}${hint}`);
+    } else if (result.diagnosis) {
+      ui.log.warn(t(`checks.diagnostic.${result.diagnosis}`, { name: result.name }));
     } else if (result.warnMessage) {
-      console.log(kleur.yellow(`  ⚠ ${result.warnMessage}${hint}`));
+      ui.log.warn(`${result.warnMessage}${hint}`);
     } else if (result.warnMessageKey) {
-      console.log(kleur.yellow(`  ⚠ ${t(result.warnMessageKey)}${hint}`));
+      ui.log.warn(`${t(result.warnMessageKey)}${hint}`);
     } else {
-      console.log(kleur.yellow(`  ⚠ ${t('checks.notFound', { name: result.name })}${hint}`));
+      ui.log.warn(`${t('checks.notFound', { name: result.name })}${hint}`);
     }
   }
 

package/lib/utils/i18n.js

@@ -96,6 +96,8 @@ const MESSAGES = {
     'checks.notFound': '{name} not found',
     'checks.flutter.warn': 'Flutter SDK not found. Install Flutter to build and run apps: https://docs.flutter.dev/get-started/install',
     'checks.install.failed': 'auto-install failed — run the command manually',
+    'checks.diagnostic.xcodeLicense': '{name} is installed, but Xcode needs the license accepted. Run: sudo xcodebuild -license',
+    'checks.diagnostic.xcodeCli': '{name} is installed, but Xcode Command Line Tools are missing. Run: xcode-select --install',
     'banner.title': 'Kasy CLI · Flutter SaaS Generator',
     'welcome.firstRun': 'Welcome to Kasy CLI!',
     'welcome.chooseLanguage': 'First, choose your language:',
@@ -551,7 +553,9 @@ const MESSAGES = {
     'new.api.success.fcm': '• Firebase is required for push notifications (FCM) — configure APNs key in Firebase console',
     'new.api.success.auth': '• Implement the social auth endpoints (Google, Apple) on your backend',
 
-    'new.outdated.continueAnyway': 'Continue creating the project with the current version?',
+    'new.outdated.hint': "projects created now won't include the latest improvements.",
+    'new.outdated.upgradeNow': 'Upgrade to the latest version before creating? (requires active subscription)',
+    'new.outdated.upgraded': 'kasy updated! Run kasy new again.',
     'new.success.title': 'Project created successfully!',
     'new.success.nextSteps': 'Next steps:',
     'new.success.step.cd': 'Go to your project folder:',
@@ -584,6 +588,8 @@ const MESSAGES = {
     // run command
     'cli.command.run.description': '▶ Run the Flutter app using .env (launch.json dart-defines fallback)',
     'run.launching': 'Launching Flutter app...',
+    'run.updateHint.prefix': 'Project improvements available —',
+    'run.updateHint.suffix': 'to see what\'s new',
     'run.error.notFlutterProject': 'No pubspec.yaml found. Run this command from inside a Flutter project.',
     'run.error.flutterNotFound': 'Flutter not found. Make sure Flutter is installed and on your PATH.',
 
@@ -815,6 +821,8 @@ const MESSAGES = {
     'checks.notFound': '{name} nao encontrado',
     'checks.flutter.warn': 'Flutter SDK nao encontrado. Instale o Flutter para compilar e executar apps: https://docs.flutter.dev/get-started/install',
     'checks.install.failed': 'instalacao automatica falhou — execute o comando manualmente',
+    'checks.diagnostic.xcodeLicense': '{name} esta instalado, mas o Xcode precisa que a licenca seja aceita. Execute: sudo xcodebuild -license',
+    'checks.diagnostic.xcodeCli': '{name} esta instalado, mas faltam as Command Line Tools do Xcode. Execute: xcode-select --install',
     'banner.title': 'Kasy CLI · Gerador Flutter SaaS',
     'welcome.firstRun': 'Bem-vindo ao Kasy CLI!',
     'welcome.chooseLanguage': 'Primeiro, escolha seu idioma:',
@@ -1270,7 +1278,9 @@ const MESSAGES = {
     'new.api.success.fcm': '• Firebase e necessario para notificacoes push (FCM) — configure a chave APNs no console do Firebase',
     'new.api.success.auth': '• Implemente os endpoints de auth social (Google, Apple) no seu backend',
 
-    'new.outdated.continueAnyway': 'Continuar criando o projeto com a versao atual?',
+    'new.outdated.hint': 'projetos criados agora não terão as últimas melhorias.',
+    'new.outdated.upgradeNow': 'Atualizar antes de criar? (requer assinatura ativa)',
+    'new.outdated.upgraded': 'kasy atualizado! Rode kasy new novamente.',
     'new.success.title': 'Projeto criado com sucesso!',
     'new.success.nextSteps': 'Proximos passos:',
     'new.success.step.cd': 'Entre na pasta do projeto:',
@@ -1303,6 +1313,8 @@ const MESSAGES = {
     // run command
     'cli.command.run.description': '▶ Executa o app Flutter usando .env (fallback para dart-defines do launch.json)',
     'run.launching': 'Iniciando app Flutter...',
+    'run.updateHint.prefix': 'Melhorias disponíveis para o projeto —',
+    'run.updateHint.suffix': 'para ver o que há de novo',
     'run.error.notFlutterProject': 'Nenhum pubspec.yaml encontrado. Execute este comando dentro de um projeto Flutter.',
     'run.error.flutterNotFound': 'Flutter nao encontrado. Verifique se o Flutter esta instalado e no PATH.',
 
@@ -1534,6 +1546,8 @@ const MESSAGES = {
     'checks.notFound': '{name} no encontrado',
     'checks.flutter.warn': 'Flutter SDK no encontrado. Instala Flutter para compilar y ejecutar apps: https://docs.flutter.dev/get-started/install',
     'checks.install.failed': 'instalación automática falló — ejecuta el comando manualmente',
+    'checks.diagnostic.xcodeLicense': '{name} está instalado, pero Xcode necesita que aceptes la licencia. Ejecuta: sudo xcodebuild -license',
+    'checks.diagnostic.xcodeCli': '{name} está instalado, pero faltan las Command Line Tools de Xcode. Ejecuta: xcode-select --install',
     'banner.title': 'Kasy CLI · Generador Flutter SaaS',
     'welcome.firstRun': '¡Bienvenido a Kasy CLI!',
     'welcome.chooseLanguage': 'Primero, elige tu idioma:',
@@ -1989,7 +2003,9 @@ const MESSAGES = {
     'new.api.success.fcm': '• Firebase es necesario para notificaciones push (FCM) — configura la clave APNs en la consola de Firebase',
     'new.api.success.auth': '• Implementa los endpoints de auth social (Google, Apple) en tu backend',
 
-    'new.outdated.continueAnyway': '¿Continuar creando el proyecto con la version actual?',
+    'new.outdated.hint': 'los proyectos creados ahora no tendrán las últimas mejoras.',
+    'new.outdated.upgradeNow': '¿Actualizar a la última versión antes de crear? (requiere suscripción activa)',
+    'new.outdated.upgraded': '¡kasy actualizado! Ejecuta kasy new nuevamente.',
     'new.success.title': '¡Proyecto creado con exito!',
     'new.success.nextSteps': 'Proximos pasos:',
     'new.success.step.cd': 'Ve a la carpeta del proyecto:',
@@ -2022,6 +2038,8 @@ const MESSAGES = {
     // run command
     'cli.command.run.description': '▶ Ejecuta el app Flutter usando .env (fallback a dart-defines del launch.json)',
     'run.launching': 'Iniciando app Flutter...',
+    'run.updateHint.prefix': 'Mejoras disponibles para el proyecto —',
+    'run.updateHint.suffix': 'para ver las novedades',
     'run.error.notFlutterProject': 'No se encontro pubspec.yaml. Ejecuta este comando dentro de un proyecto Flutter.',
     'run.error.flutterNotFound': 'Flutter no encontrado. Verifica que Flutter este instalado y en el PATH.',
 

package/lib/utils/prompts.js

@@ -1,4 +1,4 @@
-const prompts = require('prompts');
+const ui = require('./ui');
 const { isLicenseFormatValid } = require('./license');
 const {
   LANGUAGE_CHOICES,
@@ -15,11 +15,9 @@ const {
 
 const KASY_AUDIENCE = process.env.KASY_INTERNAL === '1' ? 'internal' : 'public';
 
-function getPromptOptions(t) {
-  return {
-    onCancel: () => {
-      throw new Error(t('prompt.cancelled'));
-    }
+function makeCancel(t) {
+  return () => {
+    throw new Error(t('prompt.cancelled'));
   };
 }
 
@@ -30,178 +28,120 @@ async function promptLanguage(language) {
   }
 
   const detectedLanguage = detectDefaultLanguage();
-  const initial = Math.max(
-    0,
-    LANGUAGE_CHOICES.findIndex((choice) => choice.value === detectedLanguage)
-  );
-
   const t = createTranslator(detectedLanguage);
-  const response = await prompts(
-    {
-      type: 'select',
-      name: 'language',
-      message: t('prompt.language.select'),
-      choices: LANGUAGE_CHOICES,
-      initial
-    },
-    getPromptOptions(t)
-  );
 
-  return normalizeLanguage(response.language) || detectedLanguage;
+  const value = await ui.select({
+    message: t('prompt.language.select'),
+    initialValue: detectedLanguage,
+    options: LANGUAGE_CHOICES.map((choice) => ({
+      value: choice.value,
+      label: choice.title,
+    })),
+    onCancel: makeCancel(t),
+  });
+
+  return normalizeLanguage(value) || detectedLanguage;
 }
 
 async function promptLicenseKey(initial = '', options = {}) {
   const t = options.t || createTranslator(options.language);
-  const response = await prompts(
-    {
-      type: 'text',
-      name: 'licenseKey',
-      message: t('prompt.license.enter'),
-      initial,
-      validate: (value) => {
-        if (isLicenseFormatValid(value)) {
-          return true;
-        }
-
-        return t('prompt.license.invalid');
-      }
-    },
-    getPromptOptions(t)
-  );
-
-  return response.licenseKey;
+  const value = await ui.text({
+    message: t('prompt.license.enter'),
+    initialValue: initial,
+    validate: (v) => (isLicenseFormatValid(v) ? undefined : t('prompt.license.invalid')),
+    onCancel: makeCancel(t),
+  });
+  return value;
 }
 
 async function promptProjectName(options = {}) {
   const t = options.t || createTranslator(options.language);
-  const response = await prompts(
-    {
-      type: 'text',
-      name: 'projectName',
-      message: t('prompt.projectName.enter'),
-      initial: t('prompt.projectName.default'),
-      validate: (value) => (value && value.trim() ? true : t('prompt.projectName.required'))
-    },
-    getPromptOptions(t)
-  );
-  return response.projectName.trim();
+  const value = await ui.text({
+    message: t('prompt.projectName.enter'),
+    initialValue: t('prompt.projectName.default'),
+    validate: (v) => (v && v.trim() ? undefined : t('prompt.projectName.required')),
+    onCancel: makeCancel(t),
+  });
+  return String(value).trim();
 }
 
 async function runSetupWizard(options = {}) {
   const t = options.t || createTranslator(options.language);
+  const cancel = makeCancel(t);
   const defaultAppName = options.defaultAppName || 'MyApp';
   const selectedFeaturesFromArgv = parseFeatureList(options.selectedFeatures);
 
-  const baseQuestions = [
-    {
-      type: 'text',
-      name: 'appName',
-      message: t('prompt.appName.enter'),
-      initial: defaultAppName,
-      validate: (value) => (value && value.trim() ? true : t('prompt.appName.required'))
+  const appName = await ui.text({
+    message: t('prompt.appName.enter'),
+    initialValue: defaultAppName,
+    validate: (v) => (v && v.trim() ? undefined : t('prompt.appName.required')),
+    onCancel: cancel,
+  });
+  const bundleId = await ui.text({
+    message: t('prompt.bundleId.enter'),
+    initialValue: 'com.example.app',
+    validate: (v) => {
+      if (!v || !v.trim()) return t('prompt.bundleId.required');
+      const valid = /^[a-zA-Z][\w]*(\.[a-zA-Z][\w]*)+$/.test(v.trim());
+      return valid ? undefined : t('prompt.bundleId.invalid');
     },
-    {
-      type: 'text',
-      name: 'bundleId',
-      message: t('prompt.bundleId.enter'),
-      initial: 'com.example.app',
-      validate: (value) => {
-        if (!value || !value.trim()) {
-          return t('prompt.bundleId.required');
-        }
-
-        const valid = /^[a-zA-Z][\w]*(\.[a-zA-Z][\w]*)+$/.test(value.trim());
-        return valid ? true : t('prompt.bundleId.invalid');
-      }
-    }
-  ];
+    onCancel: cancel,
+  });
+
+  const core = { appName, bundleId };
 
   const backendFromArgv = normalizeBackend(options.selectedBackend);
-  if (!backendFromArgv) {
-    baseQuestions.push({
-      type: 'select',
-      name: 'backend',
+  let backend = backendFromArgv;
+  if (!backend) {
+    backend = await ui.select({
       message: t('prompt.backend.select'),
-      choices: AVAILABLE_BACKENDS.map((backend) => ({
-        title: backend.id,
-        value: backend.id
-      })),
-      initial: 0
+      initialValue: AVAILABLE_BACKENDS[0]?.id,
+      options: AVAILABLE_BACKENDS.map((b) => ({ value: b.id, label: b.id })),
+      onCancel: cancel,
     });
   }
 
-  if (selectedFeaturesFromArgv.length === 0) {
-    baseQuestions.push({
-      type: 'multiselect',
-      name: 'features',
+  let features;
+  if (selectedFeaturesFromArgv.length > 0) {
+    features = selectedFeaturesFromArgv;
+  } else {
+    const selected = await ui.multiselect({
       message: t('prompt.features.select'),
-      instructions: t('prompt.features.instructions'),
-      choices: getVisibleFeatures({ audience: KASY_AUDIENCE }).map((feature) => ({
-        title: feature.status === 'internal' ? `${feature.id} [beta]` : feature.id,
+      options: getVisibleFeatures({ audience: KASY_AUDIENCE }).map((feature) => ({
         value: feature.id,
-        selected: false
+        label: feature.status === 'internal' ? `${feature.id} [beta]` : feature.id,
       })),
-      min: 0
+      initialValues: [],
+      required: false,
+      onCancel: cancel,
     });
+    features = parseFeatureList(selected);
   }
 
-  const core = await prompts(baseQuestions, getPromptOptions(t));
-  const backend = backendFromArgv || core.backend;
-  const features = selectedFeaturesFromArgv.length > 0
-    ? selectedFeaturesFromArgv
-    : parseFeatureList(core.features);
-
   if (backend === 'firebase') {
-    const firebaseAnswers = await prompts(
-      {
-        type: 'text',
-        name: 'firebaseProjectId',
-        message: t('prompt.firebase.projectId.enter'),
-        validate: (value) => (value && value.trim() ? true : t('prompt.firebase.projectId.required'))
-      },
-      getPromptOptions(t)
-    );
-
-    return {
-      ...core,
-      backend,
-      features,
-      ...firebaseAnswers
-    };
+    const firebaseProjectId = await ui.text({
+      message: t('prompt.firebase.projectId.enter'),
+      validate: (v) => (v && v.trim() ? undefined : t('prompt.firebase.projectId.required')),
+      onCancel: cancel,
+    });
+    return { ...core, backend, features, firebaseProjectId };
   }
 
   if (backend === 'supabase') {
-    const supabaseAnswers = await prompts(
-      [
-        {
-          type: 'text',
-          name: 'supabaseUrl',
-          message: t('prompt.supabase.url.enter'),
-          validate: (value) => (value && value.trim() ? true : t('prompt.supabase.url.required'))
-        },
-        {
-          type: 'text',
-          name: 'supabaseAnonKey',
-          message: t('prompt.supabase.anonKey.enter'),
-          validate: (value) => (value && value.trim() ? true : t('prompt.supabase.anonKey.required'))
-        }
-      ],
-      getPromptOptions(t)
-    );
-
-    return {
-      ...core,
-      backend,
-      features,
-      ...supabaseAnswers
-    };
+    const supabaseUrl = await ui.text({
+      message: t('prompt.supabase.url.enter'),
+      validate: (v) => (v && v.trim() ? undefined : t('prompt.supabase.url.required')),
+      onCancel: cancel,
+    });
+    const supabaseAnonKey = await ui.text({
+      message: t('prompt.supabase.anonKey.enter'),
+      validate: (v) => (v && v.trim() ? undefined : t('prompt.supabase.anonKey.required')),
+      onCancel: cancel,
+    });
+    return { ...core, backend, features, supabaseUrl, supabaseAnonKey };
   }
 
-  return {
-    ...core,
-    backend,
-    features
-  };
+  return { ...core, backend, features };
 }
 
 module.exports = {

package/lib/utils/ui.js

@@ -0,0 +1,174 @@
+/**
+ * UI wrapper around @clack/prompts.
+ *
+ * Goal: centralize prompt/styling primitives so commands don't import
+ * `@clack/prompts` directly. This keeps the migration from the legacy
+ * `prompts` package incremental — commands can adopt this module one
+ * by one without touching the rest.
+ *
+ * Cancel handling: every prompt auto-detects Ctrl+C via `isCancel`
+ * and calls the optional `onCancel` callback (or exits with code 0
+ * and a friendly message). Callers don't need to wire `onCancel`
+ * in each call like they did with the old `prompts` library.
+ */
+
+const clack = require('@clack/prompts');
+
+function handleCancel(result, onCancel) {
+  if (clack.isCancel(result)) {
+    if (typeof onCancel === 'function') {
+      onCancel();
+    } else {
+      clack.cancel('Operação cancelada.');
+    }
+    process.exit(0);
+  }
+  return result;
+}
+
+async function select({ message, options, initialValue, onCancel }) {
+  const result = await clack.select({ message, options, initialValue });
+  return handleCancel(result, onCancel);
+}
+
+async function text({ message, placeholder, initialValue, defaultValue, validate, onCancel }) {
+  const result = await clack.text({
+    message,
+    placeholder,
+    initialValue,
+    defaultValue,
+    validate: validate
+      ? (value) => {
+          const out = validate(value);
+          if (out === true || out == null) return undefined;
+          return out;
+        }
+      : undefined,
+  });
+  return handleCancel(result, onCancel);
+}
+
+async function password({ message, mask, validate, onCancel }) {
+  const result = await clack.password({
+    message,
+    mask,
+    validate: validate
+      ? (value) => {
+          const out = validate(value);
+          if (out === true || out == null) return undefined;
+          return out;
+        }
+      : undefined,
+  });
+  return handleCancel(result, onCancel);
+}
+
+async function confirm({ message, initialValue = true, onCancel }) {
+  const result = await clack.confirm({ message, initialValue });
+  return handleCancel(result, onCancel);
+}
+
+async function multiselect({ message, options, initialValues, required = false, onCancel }) {
+  const result = await clack.multiselect({ message, options, initialValues, required });
+  return handleCancel(result, onCancel);
+}
+
+function intro(title) { clack.intro(title); }
+function outro(message) { clack.outro(message); }
+function note(message, title) { clack.note(message, title); }
+function cancel(message) { clack.cancel(message); }
+
+/**
+ * Spinner integrated with Clack's vertical line (│).
+ * Returns: { start(msg), message(msg), stop(msg, code?) }
+ * code: 0 = success (✦), 1 = cancel (■), 2 = error (▲)
+ */
+function spinner() { return clack.spinner(); }
+
+/**
+ * Multi-step spinner: each .next(text) succeeds the previous step
+ * with the previous message, then starts a new step with `text`.
+ * Mimics the old ora-based makeProgressSpinner() but uses Clack's
+ * vertical-line aesthetic so the line stays connected.
+ */
+function makeStepper() {
+  let current = null;
+  let currentMsg = '';
+  return {
+    next(text) {
+      if (current) current.stop(currentMsg);
+      current = clack.spinner();
+      currentMsg = text;
+      current.start(text);
+    },
+    update(text) {
+      if (current) {
+        currentMsg = text;
+        current.message(text);
+      }
+    },
+    succeed(text) {
+      if (current) {
+        current.stop(text || currentMsg);
+        current = null;
+        currentMsg = '';
+      }
+    },
+    fail(text) {
+      if (current) {
+        // .error() renders the red ▲ icon; .stop() defaults to green ✦ success.
+        current.error(text || currentMsg);
+        current = null;
+        currentMsg = '';
+      }
+    },
+    warn(text) {
+      // Clack has no "warn" terminal state — prefix with ⚠ and close as success.
+      if (current) {
+        current.stop(`⚠ ${text || currentMsg}`);
+        current = null;
+        currentMsg = '';
+      }
+    },
+    stop() {
+      if (current) {
+        current.stop(currentMsg);
+        current = null;
+        currentMsg = '';
+      }
+    },
+  };
+}
+
+/**
+ * Long-running task with rolling log output (e.g. pub get, build_runner).
+ * Shows last N lines while running; collapses to a single ✦ on success.
+ * Options: { title, limit, retainLog }
+ */
+function taskLog(options) { return clack.taskLog(options); }
+
+/**
+ * Progress bar for operations with known total steps.
+ * Returns: { start(msg), advance(n, msg?), message(msg), stop(msg) }
+ */
+function progress(options) { return clack.progress(options); }
+
+const log = clack.log;
+
+module.exports = {
+  select,
+  text,
+  password,
+  confirm,
+  multiselect,
+  intro,
+  outro,
+  note,
+  cancel,
+  spinner,
+  makeStepper,
+  taskLog,
+  progress,
+  log,
+  isCancel: clack.isCancel,
+};