create-thally-docs 0.10.78 → 0.10.80

package/dist/chunk-KGKSB3PU.js

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+import {
+  personalizeStarter,
+  updateEnvExample
+} from "./chunk-4VKRBJV2.js";
+import {
+  resetTrackingConfig,
+  writeTrackingConfig
+} from "./chunk-J7255UQA.js";
+import {
+  downloadStarter
+} from "./chunk-WWIATVAD.js";
+import {
+  terminal
+} from "./chunk-L2YCVQBR.js";
+
+// src/scaffold.ts
+import { existsSync, mkdirSync, readdirSync } from "fs";
+import { resolve as resolve2 } from "path";
+
+// src/utils.ts
+import { execFileSync, execSync, spawn } from "child_process";
+import { resolve } from "path";
+function slugify(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+}
+async function runProjectCommand(command, args, cwd, timeout, onProgress) {
+  const isQuiet = terminal.isRich && !terminal.isVerbose;
+  await new Promise((complete, reject) => {
+    const child = spawn(command, args, {
+      cwd,
+      detached: process.platform !== "win32",
+      stdio: isQuiet ? ["ignore", "pipe", "pipe"] : "inherit",
+      // Windows resolves npm via a .cmd shim; command and arguments here are
+      // fixed by the toolchain, never interpolated from imported content.
+      shell: process.platform === "win32" && command === "npm"
+    });
+    let tail = Buffer.alloc(0);
+    let omitted = false;
+    const collect = (chunk) => {
+      const combined = Buffer.concat([tail, chunk]);
+      omitted ||= combined.length > 64 * 1024;
+      tail = combined.subarray(Math.max(0, combined.length - 64 * 1024));
+      const stages = chunk.toString("utf8").split(/[\r\n]+/).map((line) => line.trim()).filter((line) => /^(?:>|npm (?:warn|error)|added \d+|.*(?:Creating an optimized|Compiled successfully|Collecting page data|Generating static pages|Finalizing page optimization))/.test(line));
+      if (stages.length) onProgress?.(stages.at(-1));
+    };
+    child.stdout?.on("data", collect);
+    child.stderr?.on("data", collect);
+    let interrupted;
+    let didTimeOut = false;
+    let escalation;
+    const killTree = (signal) => {
+      if (!child.pid) return;
+      try {
+        if (process.platform === "win32") {
+          execFileSync("taskkill", ["/pid", String(child.pid), "/T", "/F"], { stdio: "ignore" });
+        } else {
+          process.kill(-child.pid, signal);
+        }
+      } catch {
+        child.kill(signal);
+      }
+    };
+    const interrupt = (signal) => {
+      interrupted = signal;
+      killTree(signal);
+      escalation = setTimeout(() => killTree("SIGKILL"), 1e3);
+    };
+    const onInterrupt = () => interrupt("SIGINT");
+    const onTerminate = () => interrupt("SIGTERM");
+    const onExit = () => killTree("SIGKILL");
+    const deadline = timeout ? setTimeout(() => {
+      didTimeOut = true;
+      interrupt("SIGTERM");
+    }, timeout) : void 0;
+    process.once("SIGINT", onInterrupt);
+    process.once("SIGTERM", onTerminate);
+    process.once("exit", onExit);
+    const cleanup = () => {
+      if (interrupted) killTree("SIGKILL");
+      if (deadline) clearTimeout(deadline);
+      if (escalation) clearTimeout(escalation);
+      process.removeListener("SIGINT", onInterrupt);
+      process.removeListener("SIGTERM", onTerminate);
+      process.removeListener("exit", onExit);
+    };
+    child.once("error", (error) => {
+      cleanup();
+      reject(error);
+    });
+    child.once("close", (code, signal) => {
+      cleanup();
+      if (code === 0 && !interrupted) {
+        complete();
+        return;
+      }
+      const failure = new Error(`${command} ${args.join(" ")} failed (${interrupted ?? signal ?? `exit ${code}`}).`);
+      if (didTimeOut) failure.message += ` Timed out after ${timeout}ms.`;
+      if (interrupted && !didTimeOut) failure.exitCode = interrupted === "SIGINT" ? 130 : 143;
+      failure.output = `${omitted ? "Earlier output omitted; use --verbose for the full log.\n" : ""}${tail.toString("utf8")}`;
+      reject(failure);
+    });
+  });
+}
+async function initGit(targetDir) {
+  try {
+    await terminal.step("Initialize Git repository", async (update) => {
+      update("Initialize Git repository");
+      await runProjectCommand("git", ["init"], targetDir);
+      update("Stage generated project files");
+      await runProjectCommand("git", ["add", "-A"], targetDir);
+      update("Create initial project commit");
+      await runProjectCommand("git", ["commit", "-m", "Initial commit from create-thally-docs"], targetDir);
+    }, "Git repository initialized");
+  } catch (error) {
+    if (error.exitCode === 130 || error.exitCode === 143) throw error;
+    const failure = error;
+    const diagnostic = [failure.output, failure.stdout, failure.stderr].filter(Boolean).map((value) => String(value)).join("\n").slice(-64 * 1024);
+    if (diagnostic.trim()) terminal.error(diagnostic.trimEnd());
+    terminal.warn("Could not finish Git setup. Run git status in the project directory, fix the reported issue, then retry the commit.");
+  }
+}
+async function installDeps(targetDir) {
+  try {
+    await terminal.step("Install dependencies", (update) => runProjectCommand("npm", [
+      "install",
+      "--prefer-offline",
+      "--no-audit",
+      "--no-fund",
+      "--progress=false"
+    ], targetDir, void 0, (message) => update(`Install dependencies: ${message}`)), "Dependencies installed");
+  } catch (error) {
+    const failure = error;
+    if (failure.output?.trim()) terminal.error(failure.output.trimEnd());
+    throw error;
+  }
+}
+function quoteDirectory(directory) {
+  const absolute = resolve(directory);
+  return process.platform === "win32" ? `"${absolute.replace(/"/g, '""')}"` : `'${absolute.replace(/'/g, "'\\''")}'`;
+}
+function previewCommand(directory, needsInstall = false) {
+  return `cd ${quoteDirectory(directory)} && ${needsInstall ? "npm install && " : ""}npm run dev`;
+}
+function logo(version) {
+  terminal.intro("init", version, "Build and publish docs for people and AI tools.");
+}
+function success(projectDir, projectName, dependenciesInstalled) {
+  terminal.detail("Project", projectName);
+  terminal.detail("Output", projectDir);
+  terminal.section("Make it yours", [
+    "src/content/      Write your documentation",
+    "docs.json         Set up navigation",
+    "src/data/site.ts  Name, links, and branding"
+  ]);
+  terminal.outro("Your docs project is ready. The dev server will print your preview URL.");
+  terminal.nextAction("Preview locally", previewCommand(projectDir, !dependenciesInstalled));
+}
+
+// src/scaffold.ts
+async function scaffold(options) {
+  const {
+    projectDir,
+    projectName,
+    description,
+    brandPreset,
+    repoUrl,
+    doInstall,
+    enableAiChat = true,
+    i18nLocales,
+    trackRepos,
+    colors
+  } = options;
+  const targetDir = resolve2(projectDir);
+  if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
+    throw new Error(`Directory "${targetDir}" already exists and is not empty.`);
+  }
+  mkdirSync(targetDir, { recursive: true });
+  const slug = slugify(projectName);
+  await terminal.step(
+    "Downloading starter",
+    () => downloadStarter(targetDir, projectName, void 0, { announce: false }),
+    "Starter downloaded"
+  );
+  await terminal.step("Configuring project", () => {
+    personalizeStarter(targetDir, {
+      projectName,
+      packageName: slug,
+      description,
+      brandPreset,
+      repoUrl,
+      enableAiChat,
+      i18nLocales,
+      colors
+    });
+    resetTrackingConfig(targetDir);
+    if (trackRepos?.length) writeTrackingConfig(targetDir, trackRepos);
+    updateEnvExample(targetDir);
+  }, "Project configured");
+  if (trackRepos?.length) {
+    const list = trackRepos.map((r) => `${r.owner}/${r.repo}`).join(", ");
+    terminal.info(`Thally Track enabled \u2014 watching ${list} (branch main, all files; refine in docs.json).`);
+    terminal.info("To finish wiring it: `thally track setup` (pick a trigger) + `thally agent init`,");
+    terminal.info("then add your ANTHROPIC_API_KEY. See /guides/thally-track.");
+  }
+  if (doInstall) {
+    await installDeps(targetDir);
+  }
+  await initGit(targetDir);
+  return { projectDir: targetDir };
+}
+
+export {
+  slugify,
+  runProjectCommand,
+  initGit,
+  installDeps,
+  previewCommand,
+  logo,
+  success,
+  scaffold
+};

package/dist/chunk-L2YCVQBR.js

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+
+// src/terminal.ts
+import { intro, outro, spinner } from "@clack/prompts";
+import { stripVTControlCharacters } from "util";
+var PRODUCT_TAGLINE = "Product knowledge, kept in step with your code.";
+var OLIVE = { rgb: "38;2;174;187;106", palette: "38;5;143" };
+var OLIVE_EDGE = { rgb: "38;2;115;121;56", palette: "38;5;101" };
+function oliveCode(env, edge = false) {
+  const color = edge ? OLIVE_EDGE : OLIVE;
+  return env.COLORTERM === "truecolor" || env.COLORTERM === "24bit" || ["iTerm.app", "vscode", "WezTerm"].includes(env.TERM_PROGRAM ?? "") ? color.rgb : color.palette;
+}
+var accentUsers = 0;
+var restoreAccent;
+function acquireTerminalAccent() {
+  if (!terminal.isRich) return () => {
+  };
+  if (accentUsers === 0) {
+    const output = process.stdout;
+    const previous = output.write;
+    const writeOriginal = previous.bind(output);
+    const opening = `\x1B[${oliveCode(process.env)}m`;
+    const themed = function(chunk, encodingOrCallback, callback) {
+      const text = typeof chunk === "string" ? chunk.replace(/\x1b\[(?:32|35|36)m/g, opening) : chunk;
+      return typeof encodingOrCallback === "string" ? writeOriginal(text, encodingOrCallback, callback) : writeOriginal(text, encodingOrCallback);
+    };
+    output.write = themed;
+    restoreAccent = () => {
+      if (output.write === themed) output.write = previous;
+    };
+  }
+  accentUsers += 1;
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    accentUsers -= 1;
+    if (accentUsers === 0) {
+      restoreAccent?.();
+      restoreAccent = void 0;
+    }
+  };
+}
+var WORDMARK = [
+  "\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557     \u2588\u2588\u2557     \u2588\u2588\u2557   \u2588\u2588\u2557",
+  "\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     \u2588\u2588\u2551     \u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D",
+  "   \u2588\u2588\u2551   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551      \u255A\u2588\u2588\u2588\u2588\u2554\u255D ",
+  "   \u2588\u2588\u2551   \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551       \u255A\u2588\u2588\u2554\u255D  ",
+  "   \u2588\u2588\u2551   \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557   \u2588\u2588\u2551   ",
+  "   \u255A\u2550\u255D   \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D   \u255A\u2550\u255D   "
+];
+var SMALL_WORDMARK = [
+  "\u2580\u2588\u2580 \u2588 \u2588 \u2584\u2580\u2588 \u2588   \u2588   \u2588 \u2588",
+  " \u2588  \u2588\u2580\u2588 \u2588\u2580\u2588 \u2588   \u2588    \u2588 ",
+  " \u2580  \u2580 \u2580 \u2580 \u2580 \u2580\u2580\u2580 \u2580\u2580\u2580  \u2580 "
+];
+function terminalText(value) {
+  return stripVTControlCharacters(value).replace(/[\u0000-\u0009\u000b-\u001f\u007f-\u009f]/g, "");
+}
+function createTerminal(options = {}) {
+  const output = options.stdout ?? process.stdout;
+  const errors = options.stderr ?? process.stderr;
+  const environment = () => options.env ?? process.env;
+  const arguments_ = () => options.argv ?? process.argv.slice(2);
+  const isRich = () => Boolean(output.isTTY) && !environment().CI && environment().TERM !== "dumb" && environment().NO_COLOR === void 0;
+  const canAnimate = () => isRich() && Boolean(process.stdin.isTTY) && output === process.stdout && errors === process.stderr && !arguments_().includes("--verbose");
+  const paint = (text, code, rich = isRich()) => rich ? `\x1B[${code}m${text}\x1B[0m` : text;
+  const accent = (text, edge = false) => paint(text, oliveCode(environment(), edge));
+  const write = (text) => output.write(`${text}
+`);
+  const wordmark = () => {
+    const columns = output.columns ?? 80;
+    const lines = columns >= Math.max(...WORDMARK.map((line) => line.length)) + 2 ? WORDMARK : SMALL_WORDMARK;
+    if (!isRich() || columns < Math.max(...lines.map((line) => line.length)) + 2) {
+      write(`  ${accent("THALLY")}`);
+      return;
+    }
+    const lettering = lines.map((line) => line.split(/(█+)/).map((part) => accent(part, !part.includes("\u2588"))).join(""));
+    for (const line of lettering) write(`  ${line}`);
+  };
+  const diagnostic = (message, isError) => {
+    const rich = isRich() && Boolean(errors.isTTY);
+    const symbol = isError ? rich ? "\u25A0" : "[error]" : rich ? "\u25B2" : "[warn]";
+    const line = `  ${paint(symbol, isError ? 31 : 33, rich)} ${terminalText(message)}`;
+    if (errors === process.stderr) console.warn(line);
+    else errors.write(`${line}
+`);
+  };
+  const render = {
+    /** Whether interactive decoration is supported by the current output. */
+    get isRich() {
+      return isRich();
+    },
+    /** Whether the caller requested detailed subprocess output. */
+    get isVerbose() {
+      return arguments_().includes("--verbose");
+    },
+    /** Introduce a command with the responsive wordmark and its immediate task. */
+    intro(command, version, subtitle = PRODUCT_TAGLINE) {
+      const heading = `${terminalText(command)}${version ? ` ${isRich() ? "\xB7" : "-"} v${terminalText(version)}` : ""}`;
+      write("");
+      wordmark();
+      write("");
+      write(`  ${PRODUCT_TAGLINE}`);
+      if (subtitle !== PRODUCT_TAGLINE) write(`  ${paint(terminalText(subtitle), 2)}`);
+      write("");
+      if (isRich() && output === process.stdout) intro(accent(heading));
+      else write(`  ${accent(heading)}`);
+      write("");
+    },
+    /** Display a source, destination, or result with a consistent label. */
+    detail(label, value) {
+      write(`  ${paint(terminalText(label).padEnd(10), 2)} ${terminalText(value)}`);
+    },
+    /** Display a neutral fact without implying success. */
+    info(message) {
+      write(`  ${paint(isRich() ? "\u2502" : "-", 2)} ${terminalText(message)}`);
+    },
+    /** Record a completed operation in the retained transcript. */
+    success(message) {
+      write(`  ${accent(isRich() ? "\u2713" : "[ok]")} ${terminalText(message)}`);
+    },
+    /** Keep warnings visible on stderr even when successful task logs are quiet. */
+    warn(message) {
+      diagnostic(message, false);
+    },
+    /** Keep errors visible on stderr and separate from machine-readable stdout. */
+    error(message) {
+      diagnostic(message, true);
+    },
+    /** Group next steps or results without a fixed-width box. */
+    section(title, lines) {
+      write("");
+      write(`  ${paint(terminalText(title), 1)}`);
+      for (const line of lines) write(`    ${terminalText(line)}`);
+      write("");
+    },
+    /** Make the next action prominent while retaining one intact shell command. */
+    nextAction(title, command) {
+      const cleanTitle = terminalText(title);
+      const cleanCommand = terminalText(command);
+      write("");
+      if (!isRich()) {
+        write(`  Next action: ${cleanTitle}`);
+        write("  Copy and run this command:");
+        write(`    ${cleanCommand}`);
+        write("");
+        return;
+      }
+      const label = `NEXT \u2192 ${cleanTitle}`;
+      write(`  ${paint(paint(paint(` ${label} `, 1), 30), oliveCode(environment()).replace(/^38;/, "48;"))}`);
+      write("");
+      write("  Copy and run to open your local preview:");
+      const canFrame = !cleanCommand.includes("\n") && cleanCommand.length + 8 <= (output.columns ?? 80);
+      if (canFrame) {
+        const width = cleanCommand.length + 4;
+        write(`  ${accent(`\u256D${"\u2500".repeat(width)}\u256E`)}`);
+        write(`  ${accent("\u2502")}${" ".repeat(width)}${accent("\u2502")}`);
+        write(`  ${accent("\u2502")}  ${accent(paint(cleanCommand, 1))}  ${accent("\u2502")}`);
+        write(`  ${accent("\u2502")}${" ".repeat(width)}${accent("\u2502")}`);
+        write(`  ${accent(`\u2570${"\u2500".repeat(width)}\u256F`)}`);
+      } else write(`    ${accent(paint(cleanCommand, 1))}`);
+      write("");
+    },
+    /** Finish a command without masking warnings or incomplete validation. */
+    outro(message) {
+      if (isRich() && output === process.stdout) outro(terminalText(message));
+      else {
+        write("");
+        write(`  ${terminalText(message)}`);
+        write("");
+      }
+    },
+    /** Render progress, retain the outcome, and always release Clack's cursor hooks. */
+    async step(label, action, completedLabel = label) {
+      const progress = canAnimate() ? spinner({ indicator: "timer" }) : void 0;
+      const releaseAccent = progress ? acquireTerminalAccent() : void 0;
+      const cleanLabel = terminalText(label).replace(/\n/g, " ");
+      const limit = Math.max(8, (output.columns ?? 80) - 16);
+      const fit = (message) => Array.from(terminalText(message).replace(/\n/g, " ")).slice(0, limit).join("");
+      let activity = cleanLabel;
+      const began = Date.now();
+      const update = (message) => {
+        const next = terminalText(message).replace(/\n/g, " ");
+        if (next === activity) return;
+        activity = next;
+        if (progress) progress.message(fit(next));
+        else render.info(next);
+      };
+      const heartbeat = !progress ? setInterval(() => {
+        render.info(`${activity} (${Math.floor((Date.now() - began) / 1e3)}s elapsed)`);
+      }, 15e3) : void 0;
+      const cancel = () => {
+        progress?.stop("Cancelled", 1);
+        releaseAccent?.();
+        process.exit(130);
+      };
+      const terminate = () => {
+        progress?.stop("Cancelled", 1);
+        releaseAccent?.();
+        process.exit(143);
+      };
+      if (progress) {
+        process.once("SIGINT", cancel);
+        process.once("SIGTERM", terminate);
+      }
+      try {
+        if (progress) progress.start(fit(cleanLabel));
+        else render.info(cleanLabel);
+        const result = await action(update);
+        if (progress) progress.stop(terminalText(completedLabel));
+        else render.success(completedLabel);
+        return result;
+      } catch (error) {
+        if (progress) progress.stop(`${cleanLabel}: failed`, 2);
+        else render.error(`${cleanLabel}: failed`);
+        throw error;
+      } finally {
+        releaseAccent?.();
+        if (heartbeat) clearInterval(heartbeat);
+        if (progress) {
+          process.removeListener("SIGINT", cancel);
+          process.removeListener("SIGTERM", terminate);
+        }
+      }
+    }
+  };
+  return render;
+}
+var terminal = createTerminal();
+function formatHelp(text) {
+  if (!terminal.isRich) return text;
+  const accent = `\x1B[${oliveCode(process.env)}m`;
+  return text.split("\n").map((line) => {
+    const heading = line.trimStart();
+    if (heading.length < 2 || !heading.endsWith(":")) return line;
+    const indentation = line.slice(0, line.length - heading.length);
+    return `${indentation}${accent}${heading}\x1B[0m`;
+  }).join("\n");
+}
+
+export {
+  PRODUCT_TAGLINE,
+  acquireTerminalAccent,
+  terminalText,
+  createTerminal,
+  terminal,
+  formatHelp
+};