create-thally-docs 0.10.52 → 0.10.53

package/README.md

@@ -53,7 +53,10 @@ scripts and CI, pass
 `--platform mintlify`, `--platform docusaurus`, or `--platform auto`; `--yes`
 keeps backward-compatible auto-detection when no platform flag is supplied.
 Explicit `--platform auto` and `--yes` runs print the live-site limitation
-without introducing an interactive prompt.
+without introducing an interactive prompt. Running `migrate` without
+`--platform` or `--yes` from a non-interactive shell (a script, a CI job, a
+piped command) also skips the platform prompt — it can't be answered there —
+and auto-detects instead, with a warning naming the flag that silences it.
 
 Mintlify repository migrations preserve the source information architecture
 instead of rebuilding navigation from folders: nested project roots, `$ref`

package/dist/{chunk-5GIP6NA7.js → chunk-5DNAAGM6.js}

@@ -5,7 +5,7 @@ import {
   readDocsJson,
   scaffold,
   writeDocsJson
-} from "./chunk-S344UFCS.js";
+} from "./chunk-YFOGBPFV.js";
 
 // src/migrate/index.ts
 import { existsSync as existsSync3, mkdirSync, mkdtempSync, readFileSync as readFileSync3, rmSync, writeFileSync } from "fs";
@@ -55,6 +55,7 @@ function parseFrontmatter(raw) {
 // src/check.ts
 import { parse as parseYaml2 } from "yaml";
 import { projectNavigationContract } from "@thallylabs/core/navigation";
+import { slugify } from "@thallylabs/core/slugify";
 function gitLocal(projectDir, args) {
   try {
     const out = execFileSync("git", args, { cwd: projectDir, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
@@ -142,14 +143,16 @@ function addOrphanToNav(projectDir, pageId) {
     writeDocsJson(projectDir, config);
   }
 }
-function slugify(text) {
-  return text.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-");
-}
+var EXPLICIT_ID_ATTRIBUTE = /\bid=(?:"([^"]*)"|'([^']*)'|\{["']([^"'}]*)["']\})/g;
 function extractHeadingAnchors(content) {
   const anchors = /* @__PURE__ */ new Set();
   for (const line of content.split("\n")) {
-    const m = /^#{1,6}\s+(.+?)\s*#*\s*$/.exec(line);
-    if (m) anchors.add(slugify(m[1]));
+    const heading = /^ {0,3}#{1,6}\s+(.+?)\s*#*\s*$/.exec(line);
+    if (heading) anchors.add(slugify(heading[1]));
+    for (const idMatch of line.matchAll(EXPLICIT_ID_ATTRIBUTE)) {
+      const id = idMatch[1] ?? idMatch[2] ?? idMatch[3];
+      if (id) anchors.add(id);
+    }
   }
   return anchors;
 }
@@ -173,6 +176,26 @@ function extractLinks(content) {
   }
   return links;
 }
+function extractImageRefs(content) {
+  const refs = [];
+  const lines = content.split("\n");
+  let inFence = false;
+  for (let i = 0; i < lines.length; i++) {
+    if (/^\s*(```|~~~)/.test(lines[i])) {
+      inFence = !inFence;
+      continue;
+    }
+    if (inFence) continue;
+    const line = lines[i].replace(/`[^`]*`/g, "");
+    for (const m of line.matchAll(/!\[[^\]]*\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g)) {
+      refs.push({ target: m[1], line: i + 1 });
+    }
+    for (const m of line.matchAll(/\bsrc=["']([^"']+)["']/g)) {
+      refs.push({ target: m[1], line: i + 1 });
+    }
+  }
+  return refs;
+}
 function localizedPage(pageId, secondaryLocales) {
   const [first, ...rest] = pageId.split("/");
   if (secondaryLocales.has(first) && rest.length > 0) {
@@ -322,7 +345,7 @@ async function runCheck(projectDir, options) {
     validPaths.add(`/${pageId}`);
     anchorsByPath.set(path, anchors);
     anchorsByPath.set(`/${pageId}`, anchors);
-    linksByFile.push({ file: rel2, path, anchors, links: extractLinks(content), offset: lineOffset });
+    linksByFile.push({ file: rel2, path, anchors, links: extractLinks(content), images: extractImageRefs(content), offset: lineOffset });
   }
   for (const [path, anchors] of [...anchorsByPath]) {
     if (secondaryLocales.has(path.split("/")[1])) continue;
@@ -358,6 +381,24 @@ async function runCheck(projectDir, options) {
       }
     }
   }
+  const publicDir = join(projectDir, "public");
+  for (const { file, images, offset } of linksByFile) {
+    for (const { target, line: contentLine } of images) {
+      const line = contentLine + offset;
+      if (/^(https?:|data:|\{)/i.test(target)) continue;
+      if (!target.startsWith("/")) continue;
+      const pathOnly = target.split(/[?#]/, 1)[0];
+      let decoded;
+      try {
+        decoded = decodeURIComponent(pathOnly);
+      } catch {
+        continue;
+      }
+      if (!existsSync(join(publicDir, decoded))) {
+        issues.push({ severity: "warning", message: `Image not found: "${target}" has no file under public/`, file, line });
+      }
+    }
+  }
   for (const tab of config.tabs) {
     if (tab.api?.source) validateOpenApi(projectDir, tab.api.source, issues);
   }
@@ -490,13 +531,15 @@ async function discoverMigration(options) {
   const cloneDir = join3(temporaryRoot, "repository");
   console.log(`  \u{1F4E6} Cloning ${source.owner}/${source.repo}...`);
   try {
-    await cloneGitHubRepository(source, cloneDir);
-    return migrateRepository({
+    const cloneWarnings = [];
+    await cloneGitHubRepository(source, cloneDir, cloneWarnings);
+    const bundle = migrateRepository({
       repositoryDir: cloneDir,
       sourceUrl: options.sourceUrl,
       docsDir: options.docsDir ?? (source.docsDir || void 0),
       platform: options.platform
     });
+    return cloneWarnings.length > 0 ? { ...bundle, warnings: [...cloneWarnings, ...bundle.warnings] } : bundle;
   } finally {
     rmSync(temporaryRoot, { recursive: true, force: true });
   }
@@ -515,7 +558,8 @@ async function migrateDocs(options) {
       // Source provenance is not the destination repository. Migrated pages
       // live at new paths, so source URLs cannot power edit/issue actions.
       repoUrl: "",
-      doInstall: false
+      doInstall: false,
+      colors: bundle.site?.colors
     });
     resetFreshMigrationContent(projectDir);
   } else if (!existsSync3(projectDir)) {

package/dist/{chunk-ORUAMPNF.js → chunk-XYRM4GAT.js}

@@ -66,7 +66,39 @@ function replaceRequired(source, pattern, replacement, field) {
   }
   return source.replace(pattern, replacement);
 }
-function updateSiteConfig(targetDir, projectName, description, brandPreset, repoUrl) {
+var HEX_COLOR_PATTERN = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+function contrastForeground(hex) {
+  const digits = hex.slice(1);
+  const value = digits.length <= 4 ? digits.slice(0, 3).split("").map((c) => c + c).join("") : digits.slice(0, 6);
+  const channel = (index) => {
+    const c = Number.parseInt(value.slice(index, index + 2), 16) / 255;
+    return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+  };
+  const luminance = 0.2126 * channel(0) + 0.7152 * channel(2) + 0.0722 * channel(4);
+  const contrastWithWhite = 1.05 / (luminance + 0.05);
+  const contrastWithBlack = (luminance + 0.05) / 0.05;
+  return contrastWithWhite >= contrastWithBlack ? "#ffffff" : "#000000";
+}
+function replaceHexKey(block, key, hex) {
+  const pattern = new RegExp(`(${key}:[ \\t]*)'#[0-9a-fA-F]{3,8}'`);
+  return pattern.test(block) ? block.replace(pattern, `$1'${hex}'`) : block;
+}
+function replacePresetAccent(source, preset, mode, hex) {
+  const presetPattern = new RegExp(`  ${preset}: \\{[\\s\\S]*?\\n  \\},`);
+  const presetBlock = source.match(presetPattern)?.[0];
+  if (!presetBlock) return source;
+  const modePattern = new RegExp(`    ${mode}: \\{[\\s\\S]*?\\n    \\},`);
+  const modeBlock = presetBlock.match(modePattern)?.[0];
+  if (!modeBlock) return source;
+  let updatedModeBlock = modeBlock;
+  updatedModeBlock = replaceHexKey(updatedModeBlock, "accent", hex);
+  updatedModeBlock = replaceHexKey(updatedModeBlock, "ring", hex);
+  updatedModeBlock = replaceHexKey(updatedModeBlock, "sidebarActiveText", hex);
+  updatedModeBlock = replaceHexKey(updatedModeBlock, "accentForeground", contrastForeground(hex));
+  if (updatedModeBlock === modeBlock) return source;
+  return source.replace(presetBlock, presetBlock.replace(modeBlock, updatedModeBlock));
+}
+function updateSiteConfig(targetDir, projectName, description, brandPreset, repoUrl, colors) {
   if (!projectName.trim() || /[\0\r\n]/.test(projectName)) {
     throw new Error("The documentation project name is invalid.");
   }
@@ -120,6 +152,14 @@ function updateSiteConfig(targetDir, projectName, description, brandPreset, repo
       ""
     );
   }
+  const lightAccent = colors?.dark ?? colors?.primary;
+  const darkAccent = colors?.light ?? colors?.primary;
+  if (lightAccent && HEX_COLOR_PATTERN.test(lightAccent)) {
+    source = replacePresetAccent(source, brandPreset, "light", lightAccent);
+  }
+  if (darkAccent && HEX_COLOR_PATTERN.test(darkAccent)) {
+    source = replacePresetAccent(source, brandPreset, "dark", darkAccent);
+  }
   writeFileSync(siteFile, source, "utf8");
 }
 function updatePackageIdentity(targetDir, packageName) {
@@ -171,7 +211,8 @@ function personalizeStarter(targetDir, options) {
     options.projectName,
     options.description,
     options.brandPreset,
-    options.repoUrl
+    options.repoUrl,
+    options.colors
   );
   updatePackageIdentity(targetDir, options.packageName);
   updateCloudflareRuntimeName(targetDir, options.packageName);

package/dist/{chunk-S344UFCS.js → chunk-YFOGBPFV.js}

@@ -2,7 +2,7 @@
 import {
   personalizeStarter,
   updateEnvExample
-} from "./chunk-ORUAMPNF.js";
+} from "./chunk-XYRM4GAT.js";
 import {
   downloadStarter
 } from "./chunk-5TY2RFVK.js";
@@ -114,7 +114,8 @@ async function scaffold(options) {
     doInstall,
     enableAiChat = true,
     i18nLocales,
-    trackRepos
+    trackRepos,
+    colors
   } = options;
   const targetDir = resolve(projectDir);
   if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
@@ -130,7 +131,8 @@ async function scaffold(options) {
     brandPreset,
     repoUrl,
     enableAiChat,
-    i18nLocales
+    i18nLocales,
+    colors
   });
   resetTrackingConfig(targetDir);
   if (trackRepos?.length) {

package/dist/customize.d.ts

@@ -17,6 +17,12 @@ interface StarterPersonalizationOptions {
     repoUrl: string;
     enableAiChat: boolean;
     i18nLocales?: Array<StarterLocale>;
+    /** Source theme accent color(s) to apply over the chosen brand preset. */
+    colors?: {
+        primary?: string;
+        light?: string;
+        dark?: string;
+    };
 }
 /**
  * Personalize only the owner-controlled settings in `docs.json`.
@@ -26,7 +32,11 @@ interface StarterPersonalizationOptions {
  */
 declare function updateStarterDocsConfig(targetDir: string, enableAiChat: boolean, repoUrl: string, i18nLocales?: Array<StarterLocale>): void;
 /** Personalize the documented identity and repository fields in `site.ts`. */
-declare function updateSiteConfig(targetDir: string, projectName: string, description: string, brandPreset: string, repoUrl: string): void;
+declare function updateSiteConfig(targetDir: string, projectName: string, description: string, brandPreset: string, repoUrl: string, colors?: {
+    primary?: string;
+    light?: string;
+    dark?: string;
+}): void;
 /** Rename only the root package identity; dependency pins belong to starter. */
 declare function updatePackageIdentity(targetDir: string, packageName: string): void;
 /** Update the provider-portable Worker name without recreating its config. */

package/dist/customize.js

@@ -6,7 +6,7 @@ import {
   updatePackageIdentity,
   updateSiteConfig,
   updateStarterDocsConfig
-} from "./chunk-ORUAMPNF.js";
+} from "./chunk-XYRM4GAT.js";
 export {
   personalizeStarter,
   updateCloudflareRuntimeName,

package/dist/index.js

@@ -3,14 +3,14 @@ import {
   migrateDocs,
   parseFrontmatter,
   runCheck
-} from "./chunk-5GIP6NA7.js";
+} from "./chunk-5DNAAGM6.js";
 import {
   logo,
   scaffold,
   slugify,
   success
-} from "./chunk-S344UFCS.js";
-import "./chunk-ORUAMPNF.js";
+} from "./chunk-YFOGBPFV.js";
+import "./chunk-XYRM4GAT.js";
 import "./chunk-5TY2RFVK.js";
 import "./chunk-GI5TSGSK.js";
 import "./chunk-EHH4OP7W.js";
@@ -28,17 +28,27 @@ import {
 } from "@thallylabs/migrate";
 function parseMigrationPlatform(value) {
   if (!value || value === "auto") return void 0;
-  if (value === "mintlify" || value === "docusaurus") return value;
-  throw new Error("--platform must be mintlify, docusaurus, or auto.");
+  if (value === "mintlify" || value === "docusaurus" || value === "fern") return value;
+  throw new Error("--platform must be mintlify, docusaurus, fern, or auto.");
+}
+function isInteractiveStdin() {
+  return Boolean(process.stdin.isTTY);
 }
 async function gatherMigrationPlatform(value, useDefaults) {
   const configured = parseMigrationPlatform(value);
   if (configured || value === "auto" || useDefaults) return configured;
+  if (!isInteractiveStdin()) {
+    console.warn(
+      "\n  \u26A0 No platform was specified and this shell is not interactive; auto-detecting the source platform instead. Pass --platform mintlify|docusaurus|fern (or -y) to skip detection and avoid this warning."
+    );
+    return void 0;
+  }
   return select({
     message: "  Which platform currently hosts these docs?",
     choices: [
       { name: "Mintlify", value: "mintlify" },
       { name: "Docusaurus", value: "docusaurus" },
+      { name: "Fern", value: "fern" },
       { name: "Other / detect automatically", value: void 0 }
     ],
     default: "mintlify"
@@ -498,7 +508,7 @@ Options:
   --branch <name>      Override the detected Git branch
   --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, or auto
+  --platform <name>    Use mintlify, docusaurus, fern, or auto
   --skip-validation   Import only; explicitly skip content and build verification
   --api-key <key>      Anthropic API key for non-Markdown conversion
   -y, --yes            Skip interactive prompts

package/dist/migrate/index.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-5GIP6NA7.js";
-import "../chunk-S344UFCS.js";
-import "../chunk-ORUAMPNF.js";
+} from "../chunk-5DNAAGM6.js";
+import "../chunk-YFOGBPFV.js";
+import "../chunk-XYRM4GAT.js";
 import "../chunk-5TY2RFVK.js";
 import "../chunk-GI5TSGSK.js";
 import "../chunk-EHH4OP7W.js";

package/dist/scaffold.d.ts

@@ -44,6 +44,12 @@ interface ScaffoldOptions {
         owner: string;
         repo: string;
     }>;
+    /** Source theme accent color(s) to apply over the chosen brand preset. */
+    colors?: {
+        primary?: string;
+        light?: string;
+        dark?: string;
+    };
 }
 interface ScaffoldResult {
     projectDir: string;

package/dist/scaffold.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   scaffold
-} from "./chunk-S344UFCS.js";
-import "./chunk-ORUAMPNF.js";
+} from "./chunk-YFOGBPFV.js";
+import "./chunk-XYRM4GAT.js";
 import {
   STARTER_ARCHIVE_ROOT,
   STARTER_COMMIT_SHA,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.10.52",
+  "version": "0.10.53",
   "description": "Scaffold an open-source Thally docs site for people, search engines, and AI tools.",
   "type": "module",
   "engines": {
@@ -45,7 +45,7 @@
     "@anthropic-ai/sdk": "^0.36.0",
     "@inquirer/prompts": "^7.0.0",
     "@thallylabs/core": "0.2.8",
-    "@thallylabs/migrate": "0.2.6",
+    "@thallylabs/migrate": "0.2.7",
     "p-limit": "^6.1.0",
     "tar": "^7.5.22",
     "yaml": "^2.6.0"