create-thally-docs 0.10.78 → 0.10.80

package/dist/index.js

@@ -1,27 +1,88 @@
 #!/usr/bin/env node
 import {
-  migrateDocs,
+  migrateDocs
+} from "./chunk-VGE5L66Z.js";
+import {
   parseFrontmatter,
   runCheck
-} from "./chunk-VGGE6JIL.js";
+} from "./chunk-DIX4EUI4.js";
+import "./chunk-KDLP27DS.js";
 import {
   logo,
+  previewCommand,
   scaffold,
   slugify,
   success
-} from "./chunk-QLMRRNLL.js";
+} from "./chunk-KGKSB3PU.js";
 import "./chunk-4VKRBJV2.js";
-import "./chunk-W5WQ2V7P.js";
+import "./chunk-J7255UQA.js";
+import "./chunk-WWIATVAD.js";
 import "./chunk-RI56XMBI.js";
 import "./chunk-BP2REWTO.js";
+import {
+  acquireTerminalAccent,
+  formatHelp,
+  terminal
+} from "./chunk-L2YCVQBR.js";
 
 // src/index.ts
 import { existsSync as existsSync2, readdirSync } from "fs";
 import { createRequire } from "module";
 import { resolve as resolve2 } from "path";
 
+// src/interactive-prompts.ts
+import * as clack from "@clack/prompts";
+import * as inquirer from "@inquirer/prompts";
+async function withAccent(prompt) {
+  const release = acquireTerminalAccent();
+  try {
+    return await prompt();
+  } finally {
+    release();
+  }
+}
+function answerOrCancel(answer) {
+  if (clack.isCancel(answer)) {
+    throw Object.assign(new Error("Cancelled."), { exitCode: 130 });
+  }
+  return answer;
+}
+async function input2(options) {
+  if (!terminal.isRich) return inquirer.input(options);
+  return answerOrCancel(await withAccent(() => clack.text({
+    message: options.message.trim(),
+    initialValue: options.default,
+    // Clack otherwise finalizes an empty answer as undefined. Optional fields
+    // such as the repository URL must keep Inquirer's empty-string contract.
+    defaultValue: "",
+    validate: options.validate ? (value) => {
+      const result = options.validate(value);
+      return result === true ? void 0 : result;
+    } : void 0
+  })));
+}
+async function select3(options) {
+  if (!terminal.isRich) return inquirer.select(options);
+  return answerOrCancel(await withAccent(() => clack.select({
+    message: options.message.trim(),
+    initialValue: options.default,
+    // Every existing choice has a label, including nonprimitive values such as
+    // undefined; Clack's conditional Option type cannot infer this for a generic.
+    options: options.choices.map((choice) => ({
+      label: choice.name,
+      value: choice.value
+    }))
+  })));
+}
+async function confirm3(options) {
+  if (!terminal.isRich) return inquirer.confirm(options);
+  return answerOrCancel(await withAccent(() => clack.confirm({
+    message: options.message.trim(),
+    initialValue: options.default ?? true
+  })));
+}
+
 // src/prompts.ts
-import { confirm, input, select } from "@inquirer/prompts";
 import { basename, resolve } from "path";
 import {
   parseGitHubRepositoryUrl
@@ -43,7 +104,7 @@ async function gatherMigrationPlatform(value, useDefaults) {
     );
     return void 0;
   }
-  return select({
+  return select3({
     message: "  Which platform currently hosts these docs?",
     choices: [
       { name: "Mintlify", value: "mintlify" },
@@ -69,7 +130,7 @@ async function resolveAutoDetectedMigrationSource(sourceUrl, shouldPrompt) {
   console.warn(`
   \u26A0 ${LIVE_URL_MIGRATION_WARNING}`);
   if (!shouldPrompt) return sourceUrl;
-  const sourcePreference = await select({
+  const sourcePreference = await select3({
     message: "  Which source should Thally migrate?",
     choices: [
       {
@@ -84,14 +145,14 @@ async function resolveAutoDetectedMigrationSource(sourceUrl, shouldPrompt) {
     default: "github"
   });
   if (sourcePreference === "github") {
-    const repositoryUrl = await input({
+    const repositoryUrl = await input2({
       message: "  GitHub repository URL:",
       validate: validateGitHubRepositorySource
     });
     parseGitHubRepositoryUrl(repositoryUrl);
     return repositoryUrl;
   }
-  const hasAcceptedAlignment = await confirm({
+  const hasAcceptedAlignment = await confirm3({
     message: "  Continue knowing the migration may need manual alignment, using the Thally MCP afterward if needed?",
     default: false
   });
@@ -119,23 +180,23 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
   } else if (useDefaults) {
     projectDir = resolve("my-docs");
   } else {
-    const dirName = await input({
+    const dirName = await input2({
       message: "  Project directory:",
       default: "my-docs"
     });
     projectDir = resolve(dirName);
   }
   const defaultName = basename(projectDir).replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
-  const projectName = useDefaults ? defaultName : await input({
+  const projectName = useDefaults ? defaultName : await input2({
     message: "  Project name:",
     default: defaultName
   });
   const defaultDesc = `Documentation for ${projectName}.`;
-  const description = useDefaults ? defaultDesc : await input({
+  const description = useDefaults ? defaultDesc : await input2({
     message: "  Description:",
     default: defaultDesc
   });
-  const brandPreset = useDefaults ? "primary" : await select({
+  const brandPreset = useDefaults ? "primary" : await select3({
     message: "  Brand preset:",
     choices: [
       { name: "primary", value: "primary" },
@@ -143,18 +204,18 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
     ],
     default: "primary"
   });
-  const repoUrl = useDefaults ? "" : await input({
+  const repoUrl = useDefaults ? "" : await input2({
     message: "  GitHub repo URL (optional):",
     default: ""
   });
   let trackRepos;
   if (!useDefaults) {
-    const enableTrack = await input({
+    const enableTrack = await input2({
       message: "  Keep your docs in sync automatically with Thally Track? When a PR merges in a repo you list,\n  the docs agent drafts the doc updates as a PR for you to review. (y/N):",
       default: "N"
     });
     if (enableTrack.trim().toLowerCase() === "y") {
-      const reposInput = await input({
+      const reposInput = await input2({
         message: "  Which repo(s) should Thally watch? (comma-separated owner/repo or GitHub URLs, e.g. acme/api,acme/web):",
         default: ""
       });
@@ -165,7 +226,7 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
   }
   let doInstall = installPreference ?? false;
   if (!useDefaults && installPreference === void 0) {
-    const shouldInstall = await input({
+    const shouldInstall = await input2({
       message: "  Install dependencies now? (y/N):",
       default: "N"
     });
@@ -173,12 +234,12 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
   }
   let i18nLocales;
   if (!useDefaults) {
-    const enableI18n = await input({
+    const enableI18n = await input2({
       message: "  Add another documentation language? (y/N):",
       default: "N"
     });
     if (enableI18n.toLowerCase() === "y") {
-      const localesInput = await input({
+      const localesInput = await input2({
         message: "  Which additional locales? (comma-separated codes, e.g. fr,de,ja):",
         default: "fr"
       });
@@ -207,12 +268,12 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
 }
 
 // src/index.ts
-import { parseGitHubRepositoryUrl as parseGitHubRepositoryUrl2 } from "@thallylabs/migrate";
+import { parseGitHubRepositoryUrl as parseGitHubRepositoryUrl2, parseSourceRefFlags } from "@thallylabs/migrate";
 
 // src/translate.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
 import { join, dirname } from "path";
-import { input as input2 } from "@inquirer/prompts";
+import { input as input3 } from "@inquirer/prompts";
 import Anthropic from "@anthropic-ai/sdk";
 import pLimit from "p-limit";
 
@@ -480,7 +541,7 @@ ${examples.maskedSource}`
       }
     ]
   });
-  const text = message.content.filter((block) => block.type === "text").map((block) => block.text).join("");
+  const text2 = message.content.filter((block) => block.type === "text").map((block) => block.text).join("");
   const values = [];
   for (let start = 0; start < examples.segments.length; start += 32) {
     const sourceSegments = examples.segments.slice(start, start + 32);
@@ -498,7 +559,7 @@ ${examples.maskedSource}`
     }
     values.push(...translated);
   }
-  return examples.restore(text.trim(), values);
+  return examples.restore(text2.trim(), values);
 }
 async function runTranslateCommand(locale, pages, force, apiKey, model, yes, projectDir) {
   const config = readDocsJson(projectDir);
@@ -569,11 +630,11 @@ async function runTranslateCommand(locale, pages, force, apiKey, model, yes, pro
   }
   console.log("");
   if (!yes) {
-    const confirm2 = await input2({
+    const confirm4 = await input3({
       message: "  Proceed? (Y/n):",
       default: "Y"
     });
-    if (confirm2.toLowerCase() === "n") {
+    if (confirm4.toLowerCase() === "n") {
       console.log("\n  Aborted.");
       return;
     }
@@ -629,10 +690,11 @@ var valueFlags = /* @__PURE__ */ new Set([
   "--max-pages",
   "--model",
   "--pages",
-  "--platform"
+  "--platform",
+  "--source-ref"
 ]);
 var commandFlags = {
-  scaffold: /* @__PURE__ */ new Set(["--help", "-h", "--yes", "-y", "--install", "--no-install"]),
+  scaffold: /* @__PURE__ */ new Set(["--help", "-h", "--yes", "-y", "--install", "--no-install", "--verbose"]),
   migrate: /* @__PURE__ */ new Set([
     "--help",
     "-h",
@@ -643,6 +705,8 @@ var commandFlags = {
     "--max-pages",
     "--platform",
     "--skip-validation",
+    "--source-ref",
+    "--verbose",
     "--yes",
     "-y"
   ]),
@@ -673,6 +737,7 @@ Scaffold options:
   -y, --yes       Accept defaults and skip interactive prompts
   --install       Install project dependencies after scaffolding
   --no-install    Skip dependency installation without prompting
+  --verbose       Show detailed installation and Git output
   -h, --help      Show this help
   -v, -V, --version  Show the installed version
 
@@ -689,7 +754,10 @@ Options:
   --docs-dir <path>    Override the detected documentation directory
   --max-pages <count>  Limit a public URL crawl to 1-1000 pages
   --platform <name>    Use mintlify, docusaurus, fern, or auto
+  --source-ref <owner/repo>=<path>
+                       Import a Mintlify sourceRef repository under <path> (repeatable)
   --skip-validation   Import only; explicitly skip content and build verification
+  --verbose           Show detailed installation, build, and Git output
   --api-key <key>      Anthropic API key for non-Markdown conversion
   -y, --yes            Skip interactive prompts
   -h, --help           Show this help
@@ -743,7 +811,7 @@ function resolveCommand(subcommand) {
   return "scaffold";
 }
 function printHelp(command) {
-  console.log(command === "scaffold" ? mainHelp : commandHelp[command]);
+  console.log(formatHelp(command === "scaffold" ? mainHelp : commandHelp[command]));
 }
 function validateFlags(command) {
   const unknownFlag = flags.find((flag) => !commandFlags[command].has(flag));
@@ -772,10 +840,11 @@ async function runMigrateCommand() {
   const branch = getFlagValue("--branch");
   const docsDir = getFlagValue("--docs-dir");
   const yes = flags.includes("--yes") || flags.includes("-y");
+  terminal.intro("migrate", packageMetadata.version, "Bring your docs to Thally. Built for people and AI tools.");
   const platformFlag = getFlagValue("--platform");
   const platform = await gatherMigrationPlatform(platformFlag, yes);
   if (platform === void 0) {
-    const shouldPromptForSource = platformFlag === void 0 && !yes;
+    const shouldPromptForSource = platformFlag === void 0 && !yes && Boolean(process.stdin.isTTY);
     sourceUrl = await resolveAutoDetectedMigrationSource(sourceUrl, shouldPromptForSource);
     source = new URL(sourceUrl);
   }
@@ -797,15 +866,25 @@ async function runMigrateCommand() {
     console.error("\n  \u274C --max-pages must be an integer between 1 and 1000.");
     process.exit(1);
   }
-  logo();
-  console.log("  \u{1F680} Thally Migrate");
-  console.log("");
-  console.log(`  Source:  ${sourceUrl}`);
-  console.log(`  Target:  ${projectDir}`);
-  if (branch) console.log(`  Branch:  ${branch}`);
-  if (docsDir) console.log(`  Docs dir: ${docsDir}`);
-  console.log(`  Platform: ${platform ?? "auto-detect"}`);
-  console.log("");
+  terminal.detail("Source", `${source.origin}${source.pathname}`);
+  terminal.detail("Output", projectDir);
+  if (branch) terminal.detail("Branch", branch);
+  if (docsDir) terminal.detail("Docs dir", docsDir);
+  terminal.detail("Platform", platform ?? "auto-detect");
+  let sourceRefs;
+  try {
+    const sourceRefValues = args.flatMap((arg, index) => {
+      if (arg !== "--source-ref") return [];
+      const value = args[index + 1];
+      if (value === void 0 || value.startsWith("-")) throw new Error("--source-ref needs a value such as owner/repo=client-sdks/typescript.");
+      return [value];
+    });
+    sourceRefs = parseSourceRefFlags(sourceRefValues);
+  } catch (err) {
+    console.error(`
+  \u274C ${err instanceof Error ? err.message : err}`);
+    process.exit(1);
+  }
   const result = await migrateDocs({
     sourceUrl,
     projectDir,
@@ -816,16 +895,23 @@ async function runMigrateCommand() {
     maxPages,
     platform,
     yes,
-    skipValidation: flags.includes("--skip-validation")
+    skipValidation: flags.includes("--skip-validation"),
+    sourceRefs
   });
-  console.log("");
-  console.log(`  Migrated docs: ${result.projectDir}`);
-  const quotedDir = process.platform === "win32" ? `"${result.projectDir.replace(/"/g, '""')}"` : `'${result.projectDir.replace(/'/g, "'\\''")}'`;
-  console.log(`  To preview: cd ${quotedDir} && npm run dev`);
+  terminal.section("Migration summary", [
+    `${result.pagesWritten} pages \xB7 ${result.assetsWritten} assets \xB7 ${result.platform}`,
+    `Content: ${result.validation.content} \xB7 Build: ${result.validation.build}`,
+    `${result.warnings.length} migration warning(s)`
+  ]);
+  terminal.detail("Output", result.projectDir);
+  terminal.detail("Report", result.reportPath);
+  const isVerified = result.validation.content === "passed" && result.validation.build === "passed";
+  terminal.outro(isVerified ? "Migration verified. Review any warnings before publishing." : "Import saved. Validation is incomplete; review the migration report.");
+  terminal.nextAction("Preview locally", previewCommand(result.projectDir, !existsSync2(resolve2(result.projectDir, "node_modules"))));
   if (result.validation.content === "failed" || result.validation.build === "failed") process.exitCode = 1;
 }
 async function runScaffoldCommand() {
-  const useDefaults = flags.includes("--yes") || flags.includes("-y");
+  const useDefaults = flags.includes("--yes") || flags.includes("-y") || !process.stdin.isTTY;
   const installPreference = flags.includes("--install") ? true : flags.includes("--no-install") ? false : void 0;
   const dirArg = positional[0];
   if (dirArg) {
@@ -873,9 +959,7 @@ async function runTranslateSubcommand() {
   const model = getFlagValue("--model") ?? "claude-sonnet-4-6";
   const yes = flags.includes("--yes") || flags.includes("-y");
   const projectDir = resolve2(positional[1] ?? ".");
-  logo();
-  console.log("  \u{1F310} Thally Translate");
-  console.log("");
+  terminal.intro("translate", packageMetadata.version, "Make your docs available in another language.");
   await runTranslateCommand(locale, pages, force, apiKey, model, yes, projectDir);
 }
 async function main() {
@@ -897,11 +981,11 @@ async function main() {
   } else if (subcommand === "translate") {
     await runTranslateSubcommand();
   } else {
-    logo();
+    logo(packageMetadata.version);
     await runScaffoldCommand();
   }
 }
 main().catch((err) => {
-  console.error("\n  \u274C Error:", err.message);
-  process.exit(1);
+  terminal.error(err.message);
+  process.exit(err.exitCode ?? 1);
 });

package/dist/migrate/index.d.ts

@@ -1,4 +1,4 @@
-import { MigrationPlatform, MigrationFetcher, MigrationBundle, MigrationWarning } from '@thallylabs/migrate';
+import { MigrationPlatform, MigrationFetcher, SourceRefMapping, MigrationBundle, MigrationWarning } from '@thallylabs/migrate';
 
 /**
  * Validate authored navigation and links against the routes the runtime can
@@ -42,6 +42,8 @@ interface MigrateOptions {
     fetcher?: MigrationFetcher;
     /** Explicitly opt out of content/build gates; the report remains unverified. */
     skipValidation?: boolean;
+    /** Mintlify `sourceRef` repositories to import, from `--source-ref owner/repo=<path>`. */
+    sourceRefs?: Array<SourceRefMapping>;
 }
 interface MigrateResult {
     pagesWritten: number;

package/dist/migrate/index.js

@@ -1,12 +1,15 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-VGGE6JIL.js";
-import "../chunk-QLMRRNLL.js";
+} from "../chunk-VGE5L66Z.js";
+import "../chunk-KDLP27DS.js";
+import "../chunk-KGKSB3PU.js";
 import "../chunk-4VKRBJV2.js";
-import "../chunk-W5WQ2V7P.js";
+import "../chunk-J7255UQA.js";
+import "../chunk-WWIATVAD.js";
 import "../chunk-RI56XMBI.js";
 import "../chunk-BP2REWTO.js";
+import "../chunk-L2YCVQBR.js";
 export {
   migrateDocs
 };

package/dist/migration-worker.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/migration-worker.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import {
+  runCheck
+} from "./chunk-DIX4EUI4.js";
+import "./chunk-KDLP27DS.js";
+import "./chunk-J7255UQA.js";
+
+// src/migration-worker.ts
+import { parentPort, workerData } from "worker_threads";
+import { migrateRepository, migrateUrl, renderMigrationFiles } from "@thallylabs/migrate";
+async function execute(request) {
+  if (request.operation === "check") {
+    let diagnostics = [];
+    const code = await runCheck(request.args[0], {
+      fix: false,
+      ci: true,
+      silent: true,
+      onIssues: (issues) => {
+        diagnostics = issues;
+      }
+    });
+    return { code, diagnostics };
+  }
+  if (request.operation === "repository") {
+    return migrateRepository(...request.args);
+  }
+  if (request.operation === "url") {
+    return migrateUrl(...request.args);
+  }
+  return renderMigrationFiles(...request.args);
+}
+if (!parentPort) throw new Error("Migration worker requires a parent thread.");
+try {
+  parentPort.postMessage({ result: await execute(workerData) });
+} catch (error) {
+  parentPort.postMessage({ error: error instanceof Error ? error : new Error(String(error)) });
+}

package/dist/scaffold.d.ts

@@ -27,6 +27,11 @@ interface StarterArchiveEntryMetadata {
  */
 declare function validateStarterArchiveEntry(archivePath: string, entry: StarterArchiveEntryMetadata, archiveRoot?: string): void;
 
+/**
+ * Create a customer-owned project from the immutable starter release. Progress
+ * wraps each operation without changing the starter contents or owner fields.
+ */
+
 interface ScaffoldOptions {
     projectDir: string;
     projectName: string;
@@ -54,6 +59,7 @@ interface ScaffoldOptions {
 interface ScaffoldResult {
     projectDir: string;
 }
+/** Download, personalize, and optionally install a new documentation project. */
 declare function scaffold(options: ScaffoldOptions): Promise<ScaffoldResult>;
 
 export { STARTER_ARCHIVE_ROOT, STARTER_COMMIT_SHA, STARTER_REPOSITORY, type ScaffoldOptions, type ScaffoldResult, scaffold, validateStarterArchiveEntry };

package/dist/scaffold.js

@@ -1,18 +1,20 @@
 #!/usr/bin/env node
 import {
   scaffold
-} from "./chunk-QLMRRNLL.js";
+} from "./chunk-KGKSB3PU.js";
 import "./chunk-4VKRBJV2.js";
+import "./chunk-J7255UQA.js";
 import {
   STARTER_ARCHIVE_ROOT,
   STARTER_COMMIT_SHA,
   STARTER_REPOSITORY,
   validateStarterArchiveEntry
-} from "./chunk-W5WQ2V7P.js";
+} from "./chunk-WWIATVAD.js";
 import "./chunk-RI56XMBI.js";
 import {
   STABLE_SCAFFOLD_RELEASE
 } from "./chunk-BP2REWTO.js";
+import "./chunk-L2YCVQBR.js";
 export {
   STABLE_SCAFFOLD_RELEASE,
   STARTER_ARCHIVE_ROOT,

package/dist/starter-update.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   downloadStarter
-} from "./chunk-W5WQ2V7P.js";
+} from "./chunk-WWIATVAD.js";
 import {
   applyStarterRuntimeSyncPlan,
   mergeStarterOwnershipContracts,
@@ -14,6 +14,7 @@ import {
   STABLE_SCAFFOLD_RELEASE,
   SUPPORTED_SCAFFOLD_RELEASES
 } from "./chunk-BP2REWTO.js";
+import "./chunk-L2YCVQBR.js";
 
 // src/starter-update.ts
 import {

package/dist/terminal.d.ts

@@ -0,0 +1,75 @@
+/** Product-wide promise; command subtitles describe the immediate task. */
+declare const PRODUCT_TAGLINE = "Product knowledge, kept in step with your code.";
+/**
+ * Scope Clack's fixed cyan/magenta/green UI colors to our olive accent.
+ * Clack 0.11 has no theme option. Adapt only its color SGRs while a prompt or
+ * spinner owns stdout; preserve text, cursor controls, warnings, and errors.
+ * Release restores the original writer, including on cancellation or failure.
+ */
+declare function acquireTerminalAccent(): () => void;
+interface TerminalOptions {
+    stdout?: Pick<NodeJS.WriteStream, 'write' | 'isTTY' | 'columns'>;
+    stderr?: Pick<NodeJS.WriteStream, 'write' | 'isTTY' | 'columns'>;
+    env?: NodeJS.ProcessEnv;
+    argv?: Array<string>;
+}
+/** Remove terminal escape sequences and non-printing controls from source text. */
+declare function terminalText(value: string): string;
+/** Create a terminal renderer; injected streams support deterministic transcripts. */
+declare function createTerminal(options?: TerminalOptions): {
+    /** Whether interactive decoration is supported by the current output. */
+    readonly isRich: boolean;
+    /** Whether the caller requested detailed subprocess output. */
+    readonly isVerbose: boolean;
+    /** Introduce a command with the responsive wordmark and its immediate task. */
+    intro(command: string, version?: string, subtitle?: string): void;
+    /** Display a source, destination, or result with a consistent label. */
+    detail(label: string, value: string): void;
+    /** Display a neutral fact without implying success. */
+    info(message: string): void;
+    /** Record a completed operation in the retained transcript. */
+    success(message: string): void;
+    /** Keep warnings visible on stderr even when successful task logs are quiet. */
+    warn(message: string): void;
+    /** Keep errors visible on stderr and separate from machine-readable stdout. */
+    error(message: string): void;
+    /** Group next steps or results without a fixed-width box. */
+    section(title: string, lines: Array<string>): void;
+    /** Make the next action prominent while retaining one intact shell command. */
+    nextAction(title: string, command: string): void;
+    /** Finish a command without masking warnings or incomplete validation. */
+    outro(message: string): void;
+    /** Render progress, retain the outcome, and always release Clack's cursor hooks. */
+    step<T>(label: string, action: (update: (message: string) => void) => T | Promise<T>, completedLabel?: string): Promise<T>;
+};
+/** Process-local shared presentation; importing it never writes output. */
+declare const terminal: {
+    /** Whether interactive decoration is supported by the current output. */
+    readonly isRich: boolean;
+    /** Whether the caller requested detailed subprocess output. */
+    readonly isVerbose: boolean;
+    /** Introduce a command with the responsive wordmark and its immediate task. */
+    intro(command: string, version?: string, subtitle?: string): void;
+    /** Display a source, destination, or result with a consistent label. */
+    detail(label: string, value: string): void;
+    /** Display a neutral fact without implying success. */
+    info(message: string): void;
+    /** Record a completed operation in the retained transcript. */
+    success(message: string): void;
+    /** Keep warnings visible on stderr even when successful task logs are quiet. */
+    warn(message: string): void;
+    /** Keep errors visible on stderr and separate from machine-readable stdout. */
+    error(message: string): void;
+    /** Group next steps or results without a fixed-width box. */
+    section(title: string, lines: Array<string>): void;
+    /** Make the next action prominent while retaining one intact shell command. */
+    nextAction(title: string, command: string): void;
+    /** Finish a command without masking warnings or incomplete validation. */
+    outro(message: string): void;
+    /** Render progress, retain the outcome, and always release Clack's cursor hooks. */
+    step<T>(label: string, action: (update: (message: string) => void) => T | Promise<T>, completedLabel?: string): Promise<T>;
+};
+/** Highlight help headings only on capable terminals; preserve plain help bytes otherwise. */
+declare function formatHelp(text: string): string;
+
+export { PRODUCT_TAGLINE, type TerminalOptions, acquireTerminalAccent, createTerminal, formatHelp, terminal, terminalText };

package/dist/terminal.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import {
+  PRODUCT_TAGLINE,
+  acquireTerminalAccent,
+  createTerminal,
+  formatHelp,
+  terminal,
+  terminalText
+} from "./chunk-L2YCVQBR.js";
+export {
+  PRODUCT_TAGLINE,
+  acquireTerminalAccent,
+  createTerminal,
+  formatHelp,
+  terminal,
+  terminalText
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.10.78",
+  "version": "0.10.80",
   "description": "Scaffold an open-source Thally docs site for people, search engines, and AI tools.",
   "type": "module",
   "engines": {
@@ -29,7 +29,11 @@
       "import": "./dist/starter-update.js"
     },
     "./migrate": "./dist/migrate/index.js",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./terminal": {
+      "types": "./dist/terminal.d.ts",
+      "import": "./dist/terminal.js"
+    }
   },
   "files": [
     "dist",
@@ -43,9 +47,10 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.36.0",
+    "@clack/prompts": "^0.11.0",
     "@inquirer/prompts": "^7.0.0",
     "@thallylabs/core": "0.2.11",
-    "@thallylabs/migrate": "0.2.24",
+    "@thallylabs/migrate": "0.2.25",
     "p-limit": "^6.1.0",
     "remark-mdx": "^3.1.1",
     "remark-parse": "^11.0.0",