create-thally-docs 0.10.79 → 0.10.80

package/dist/{chunk-IZQHRVPV.js → chunk-VGE5L66Z.js}

@@ -23,9 +23,11 @@ import { setImmediate } from "timers/promises";
 import { basename, dirname, isAbsolute, join as join2, relative, resolve, sep } from "path";
 import {
   cloneGitHubRepository,
+  importSourceRef,
   hydrateRemoteApiSpecs,
   migrateUrl,
-  parseGitHubRepositoryUrl
+  parseGitHubRepositoryUrl,
+  sourceRefOversizeReason
 } from "@thallylabs/migrate";
 
 // src/migration-work.ts
@@ -163,9 +165,29 @@ function resetFreshMigrationContent(projectDir) {
     rmSync(projectPath(projectDir, sampleSpec), { force: true });
   }
 }
+async function fetchSourceRefs(mappings, warnings) {
+  const imports = [];
+  for (const mapping of mappings) {
+    const root = mkdtempSync(join2(tmpdir(), "thally-source-ref-"));
+    try {
+      const source = parseGitHubRepositoryUrl(`https://github.com/${mapping.repo}`);
+      const tooLarge = await sourceRefOversizeReason(mapping.repo);
+      if (tooLarge) throw new Error(tooLarge);
+      const cloneDir = join2(root, "repository");
+      await cloneGitHubRepository(source, cloneDir, warnings, { skipSubmodules: true });
+      imports.push(importSourceRef(mapping, cloneDir));
+    } catch (error) {
+      warnings.push({ code: "fetch-failed", message: `sourceRef ${mapping.repo} was not imported: ${error instanceof Error ? error.message : String(error)}` });
+    } finally {
+      rmSync(root, { recursive: true, force: true });
+    }
+  }
+  return imports;
+}
 async function discoverMigration(options) {
   const url = new URL(options.sourceUrl);
   if (url.hostname.toLowerCase() !== "github.com") {
+    if (options.sourceRefs?.length) terminal.warn("--source-ref applies only to GitHub repository sources and was ignored.");
     return terminal.step("Discovering public documentation", () => {
       const discovery = {
         sourceUrl: options.sourceUrl,
@@ -182,7 +204,9 @@ async function discoverMigration(options) {
   try {
     const cloneWarnings = [];
     await terminal.step(`Cloning ${source.owner}/${source.repo}`, () => cloneGitHubRepository(source, cloneDir, cloneWarnings), "Source repository cloned");
+    const sourceRefs = options.sourceRefs?.length ? await terminal.step("Importing sourceRef repositories", () => fetchSourceRefs(options.sourceRefs ?? [], cloneWarnings), "sourceRef repositories imported") : [];
     const bundle = await terminal.step("Converting repository documentation", () => convertRepository({
+      sourceRefs,
       repositoryDir: cloneDir,
       sourceUrl: options.sourceUrl,
       docsDir: options.docsDir ?? (source.docsDir || void 0),
@@ -293,6 +317,7 @@ async function migrateDocs(options) {
     pages: bundle.pages.length,
     assets: bundle.assets.length,
     components: bundle.componentFiles?.length ?? 0,
+    sourceRefs: bundle.sourceRefs ?? [],
     quarantined: quarantinedPages,
     quarantinedAssets: (bundle.quarantinedFiles?.length ?? 0) - quarantinedPages,
     droppedGatedPages: bundle.droppedGatedPages ?? 0,

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "./chunk-IZQHRVPV.js";
+} from "./chunk-VGE5L66Z.js";
 import {
   parseFrontmatter,
   runCheck
@@ -268,7 +268,7 @@ 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";
@@ -690,7 +690,8 @@ 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", "--verbose"]),
@@ -704,6 +705,7 @@ var commandFlags = {
     "--max-pages",
     "--platform",
     "--skip-validation",
+    "--source-ref",
     "--verbose",
     "--yes",
     "-y"
@@ -752,6 +754,8 @@ 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
@@ -867,6 +871,20 @@ async function runMigrateCommand() {
   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,
@@ -877,7 +895,8 @@ async function runMigrateCommand() {
     maxPages,
     platform,
     yes,
-    skipValidation: flags.includes("--skip-validation")
+    skipValidation: flags.includes("--skip-validation"),
+    sourceRefs
   });
   terminal.section("Migration summary", [
     `${result.pagesWritten} pages \xB7 ${result.assetsWritten} assets \xB7 ${result.platform}`,

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,7 +1,7 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-IZQHRVPV.js";
+} from "../chunk-VGE5L66Z.js";
 import "../chunk-KDLP27DS.js";
 import "../chunk-KGKSB3PU.js";
 import "../chunk-4VKRBJV2.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.10.79",
+  "version": "0.10.80",
   "description": "Scaffold an open-source Thally docs site for people, search engines, and AI tools.",
   "type": "module",
   "engines": {
@@ -50,7 +50,7 @@
     "@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",