@thallylabs/migrate 0.2.31 → 0.2.33

package/dist/{url-migration-Coy62q1L.d.ts → url-migration-_wVauqSg.d.ts}

@@ -424,12 +424,21 @@ interface MigrationWarning {
     source?: string;
 }
 /** A repository-configured remote OpenAPI spec, downloaded after the bundle is built. */
+/** A route prefix Mintlify served one spec's generated endpoint pages under (`openapi: { source, directory }`). */
+interface RemoteApiSpecDirectory {
+    /** The authored `directory`, without leading or trailing slashes. */
+    directory: string;
+    /** `METHOD /path` operations docs.json lists under that reference, in authored order; absent when Mintlify generates every operation. */
+    operations?: Array<string>;
+}
 interface RemoteApiSpec {
     url: string;
     tabLabel?: string;
     parentTab?: string;
     icon?: string;
     hidden?: boolean;
+    /** Every `directory` docs.json mounts this spec under: several API tabs may share one spec URL. */
+    directories?: Array<RemoteApiSpecDirectory>;
     /** Operation keys (`get /x`) only access-restricted pages document; marked `x-excluded` after download. */
     withheldOperations?: Array<string>;
     /** Operation keys published pages or docs.json also name; keeps a shared `$ref` path item public. */
@@ -443,6 +452,16 @@ interface MigrationBundle {
     assets: Array<MigrationAsset>;
     /** Repository-configured remote specs awaiting a bounded network fetch by the host. */
     remoteApiSpecs?: Array<RemoteApiSpec>;
+    /**
+     * Repository OpenAPI specs docs.json mounts under a `directory` (no surrounding slashes), with the tab each is bound to; the remote ones are in
+     * `remoteApiSpecs[].directories`. Present only alongside remote specs: a spec's id depends on which remote tabs bind ahead of it, so
+     * hydration links the local and remote mounts together once every download has settled, and the links stay as authored until then.
+     */
+    localApiMounts?: Array<{
+        filename: string;
+        directory: string;
+        tab?: string;
+    }>;
     /** Customer-owned component source and registry; paths are repository-relative. */
     componentFiles?: Array<RenderedMigrationFile>;
     /**

package/dist/url-migration.d.ts

@@ -1 +1 @@
-export { a as MigrationAsset, f as MigrationBundle, h as MigrationCapture, i as MigrationCaptureProvider, j as MigrationCaptureState, k as MigrationCapturedAsset, g as MigrationDocsConfig, l as MigrationEvidence, m as MigrationFetchRequest, n as MigrationFetchResponse, d as MigrationFetcher, o as MigrationJournalAsset, b as MigrationNavigationGroup, p as MigrationNavigationOccurrence, q as MigrationNavigationTab, M as MigrationPage, e as MigrationPlatform, c as MigrationWarning, R as RenderedMigrationFile, U as UrlMigrationCheckpoint, r as UrlMigrationCheckpointDelta, s as UrlMigrationIssue, t as UrlMigrationRecord, u as UrlMigrationRun, v as UrlMigrationRunOptions, w as UrlMigrationValidation, x as classifyMigrationResponse, z as renderMigrationFiles, A as runUrlMigration, B as validateUrlMigration } from './url-migration-Coy62q1L.js';
+export { a as MigrationAsset, f as MigrationBundle, h as MigrationCapture, i as MigrationCaptureProvider, j as MigrationCaptureState, k as MigrationCapturedAsset, g as MigrationDocsConfig, l as MigrationEvidence, m as MigrationFetchRequest, n as MigrationFetchResponse, d as MigrationFetcher, o as MigrationJournalAsset, b as MigrationNavigationGroup, p as MigrationNavigationOccurrence, q as MigrationNavigationTab, M as MigrationPage, e as MigrationPlatform, c as MigrationWarning, R as RenderedMigrationFile, U as UrlMigrationCheckpoint, r as UrlMigrationCheckpointDelta, s as UrlMigrationIssue, t as UrlMigrationRecord, u as UrlMigrationRun, v as UrlMigrationRunOptions, w as UrlMigrationValidation, x as classifyMigrationResponse, z as renderMigrationFiles, A as runUrlMigration, B as validateUrlMigration } from './url-migration-_wVauqSg.js';

package/dist/url-migration.js

@@ -3299,7 +3299,7 @@ ${fence}
 }
 
 // src/url-run.ts
-var CONVERTER_VERSION = "url-evidence-v3";
+var CONVERTER_VERSION = "url-evidence-v4";
 var parser = unified3().use(remarkParse3).use(remarkMdx3);
 var ACCEPT = "text/markdown,text/html,application/xhtml+xml;q=0.9";
 var MAX_RESPONSE_BYTES = 8e6;
@@ -3558,21 +3558,22 @@ function resolveMigrationRecord(records, record) {
   }
   return record;
 }
-function navigationConfig(navigation, records) {
+function navigationConfig(checkpoint, records) {
+  const navigation = checkpoint.navigation;
+  const projection = localeProjection(checkpoint);
   const project = (nodes) => nodes.flatMap((node) => {
     const record = node.url ? records.get(canonical(node.url, node.url) ?? "") : void 0;
     const target2 = resolveMigrationRecord(records, record);
     const page = target2?.page;
     const children = project(node.children ?? []);
     if (children.length) {
-      const contains = (entries) => entries.some((entry) => typeof entry === "string" ? entry === page?.navigationId : contains(entry.pages));
-      return [{ group: node.label || "Documentation", pages: [...page && !contains(children) ? [page.navigationId] : [], ...children] }];
+      const contains = (entries) => entries.some((entry) => typeof entry === "string" ? entry === (page && projection.navigationId(page)) : contains(entry.pages));
+      return [{ group: node.label || "Documentation", pages: [...page && !contains(children) ? [projection.navigationId(page)] : [], ...children] }];
     }
-    return page ? [page.navigationId] : [];
+    return page ? [projection.navigationId(page)] : [];
   });
   const tabs = navigation.filter((node) => node.kind === "tab");
   if (tabs.length) {
-    const projection = localeProjection({ records: [...records.values()] });
     const locales = [...new Set(tabs.map((tab) => tab.locale ?? projection.defaultLocale))];
     const localizedTabs = (locale) => tabs.filter((tab) => (tab.locale ?? projection.defaultLocale) === locale).flatMap((tab) => {
       const pages2 = project(tab.children ?? []);
@@ -3590,16 +3591,16 @@ function navigationConfig(navigation, records) {
   const pages = project(navigation);
   return pages.length ? { tabs: [{ tab: "Documentation", pages }] } : null;
 }
+function canonicalLanguage(value) {
+  if (!/^[a-z]{2,3}(?:-[a-z0-9]{2,8}){0,4}$/i.test(value)) return void 0;
+  try {
+    return Intl.getCanonicalLocales(value)[0];
+  } catch {
+    return void 0;
+  }
+}
 function observedLocale(document, id, scopePath) {
   const issues = [];
-  const canonicalLanguage = (value) => {
-    if (!/^[a-z]{2,3}(?:-[a-z0-9]{2,8}){0,4}$/i.test(value)) return void 0;
-    try {
-      return Intl.getCanonicalLocales(value)[0];
-    } catch {
-      return void 0;
-    }
-  };
   const candidates = [];
   if (document.locale) {
     const locale = canonicalLanguage(document.locale);
@@ -3621,25 +3622,60 @@ function observedLocale(document, id, scopePath) {
 }
 function localeProjection(checkpoint) {
   const pages = checkpoint.records.flatMap((record) => record.page ? [record.page] : []);
-  const canonicalLocale = (page) => {
+  const declaredLocale = (page) => {
     try {
       return page.locale ? Intl.getCanonicalLocales(page.locale)[0] : void 0;
     } catch {
       return void 0;
     }
   };
+  const declaredLocales = [...new Set(pages.map(declaredLocale).filter((locale) => Boolean(locale)))];
+  const defaultLocale = pages.some((page) => !page.locale) || declaredLocales.includes("en") ? "en" : declaredLocales[0] ?? "en";
+  const records = new Map(checkpoint.records.map((record) => [record.url, record]));
+  const memberships = /* @__PURE__ */ new Map();
+  const observe = (nodes, parentLocale) => {
+    for (const node of nodes) {
+      const locale = node.locale ? canonicalLanguage(node.locale) : parentLocale;
+      const entry = node.url ? records.get(canonical(node.url, checkpoint.sourceUrl) ?? "") : void 0;
+      const page = resolveMigrationRecord(records, entry)?.page;
+      if (page && locale) {
+        const languages = memberships.get(page) ?? /* @__PURE__ */ new Set();
+        languages.add(locale);
+        memberships.set(page, languages);
+      }
+      observe(node.children ?? [], locale);
+    }
+  };
+  observe(checkpoint.navigation);
+  const primaryIds = new Set(pages.filter((page) => !declaredLocale(page) || declaredLocale(page) === defaultLocale).filter((page) => memberships.get(page)?.has(defaultLocale)).map((page) => page.navigationId));
+  const remapped = /* @__PURE__ */ new Map();
+  for (const page of pages) {
+    const languages = memberships.get(page);
+    if (languages?.size !== 1) continue;
+    const locale = [...languages][0];
+    const prefix = `${locale.toLowerCase()}-`;
+    if (locale === defaultLocale || !page.navigationId.toLowerCase().startsWith(prefix)) continue;
+    const navigationId2 = page.navigationId.slice(prefix.length);
+    if (primaryIds.has(navigationId2)) remapped.set(page, { locale, navigationId: navigationId2 });
+  }
+  const canonicalLocale = (page) => remapped.get(page)?.locale ?? declaredLocale(page);
+  const navigationId = (page) => remapped.get(page)?.navigationId ?? page.navigationId;
   const locales = [...new Set(pages.map(canonicalLocale).filter((locale) => Boolean(locale)))];
-  const defaultLocale = pages.some((page) => !page.locale) || locales.includes("en") ? "en" : locales[0] ?? "en";
   const pageId = (page) => {
     const locale = canonicalLocale(page);
-    return locale ? `${locale === defaultLocale ? "" : `${locale}/`}${page.navigationId}` : page.id;
+    return locale ? `${locale === defaultLocale ? "" : `${locale}/`}${navigationId(page)}` : page.id;
   };
   const route = (page) => {
     const locale = canonicalLocale(page);
     const prefix = locale && locale !== defaultLocale ? `/${locale}` : "";
-    return `${prefix}${page.navigationId === "introduction" ? "/" : `/${page.navigationId}`}`;
+    return `${prefix}${navigationId(page) === "introduction" ? "/" : `/${navigationId(page)}`}`;
   };
-  return { canonicalLocale, locales, defaultLocale, pageId, route };
+  const redirects = checkpoint.records.flatMap((record) => {
+    if (!record.page || !remapped.has(record.page)) return [];
+    const source = new URL(record.url);
+    return source.search || !/^\/[A-Za-z0-9/_~.%+-]*$/.test(source.pathname) ? [] : [{ source: source.pathname, destination: route(record.page), permanent: true }];
+  });
+  return { canonicalLocale, navigationId, locales, defaultLocale, pageId, route, redirects };
 }
 function validateUrlMigration(checkpoint, cancelled = false) {
   const issues = [];
@@ -3648,7 +3684,7 @@ function validateUrlMigration(checkpoint, cancelled = false) {
   const records = new Map(checkpoint.records.map((record) => [record.url, record]));
   const source = new URL(checkpoint.sourceUrl);
   const projection = localeProjection(checkpoint);
-  const primaryIds = new Set(checkpoint.records.flatMap((record) => record.page && (!record.page.locale || projection.canonicalLocale(record.page) === projection.defaultLocale) ? [record.page.navigationId] : []));
+  const primaryIds = new Set(checkpoint.records.flatMap((record) => record.page && (!projection.canonicalLocale(record.page) || projection.canonicalLocale(record.page) === projection.defaultLocale) ? [projection.navigationId(record.page)] : []));
   const outputIds = /* @__PURE__ */ new Set();
   const resolve3 = (url) => {
     const record = records.get(canonical(url, checkpoint.sourceUrl) ?? "");
@@ -3662,8 +3698,8 @@ function validateUrlMigration(checkpoint, cancelled = false) {
     const outputId = projection.pageId(record.page);
     if (outputIds.has(outputId)) issues.push({ code: "collision", source: record.url, message: `Multiple source pages map to runtime path ${outputId}.` });
     outputIds.add(outputId);
-    if (record.page.locale && projection.canonicalLocale(record.page) !== projection.defaultLocale && !primaryIds.has(record.page.navigationId)) {
-      issues.push({ code: "missing-page", source: record.url, message: `Secondary locale ${record.page.locale} requires a primary ${projection.defaultLocale} page at ${record.page.navigationId}; the runtime cannot serve an orphan translation.` });
+    if (projection.canonicalLocale(record.page) && projection.canonicalLocale(record.page) !== projection.defaultLocale && !primaryIds.has(projection.navigationId(record.page))) {
+      issues.push({ code: "missing-page", source: record.url, message: `Secondary locale ${projection.canonicalLocale(record.page)} requires a primary ${projection.defaultLocale} page at ${projection.navigationId(record.page)}; the runtime cannot serve an orphan translation.` });
     }
     const actual = markdownCode(record.page.body);
     if (JSON.stringify(actual) !== JSON.stringify(record.evidence.code)) issues.push({ code: "code-mismatch", source: record.url, message: "Source code payloads differ from converted code payloads." });
@@ -3697,13 +3733,20 @@ function validateUrlMigration(checkpoint, cancelled = false) {
       }
     }
   }
-  const visit = (nodes) => {
+  const visit = (nodes, parentLocale) => {
     for (const node of nodes) {
+      const locale = node.locale ? canonicalLanguage(node.locale) : parentLocale;
       if (node.url) {
         const url = new URL(node.url, source);
-        if (inScope(url, source, checkpoint.scopePath) && !resolve3(url.toString())?.page) issues.push({ code: "navigation-missing", source: node.url, message: `Source navigation target ${node.label} was not imported.` });
+        if (inScope(url, source, checkpoint.scopePath)) {
+          const page = resolve3(url.toString())?.page;
+          if (!page) issues.push({ code: "navigation-missing", source: node.url, message: `Source navigation target ${node.label} was not imported.` });
+          else if (locale && locale !== projection.defaultLocale && !outputIds.has(`${locale}/${projection.navigationId(page)}`)) {
+            issues.push({ code: "navigation-missing", source: node.url, message: `The ${locale} sidebar target ${node.label} has no authored localized runtime page.` });
+          }
+        }
       }
-      visit(node.children ?? []);
+      visit(node.children ?? [], locale);
     }
   };
   visit(checkpoint.navigation);
@@ -4121,7 +4164,7 @@ ${difference}`;
     }
   };
   labelPages(checkpoint.navigation);
-  const pages = checkpoint.records.flatMap((record) => record.page ? [{ ...record.page, id: projection.pageId(record.page), ...record.page.locale ? { locale: projection.canonicalLocale(record.page) } : {}, ...navigationLabels.has(record.url) ? { navTitle: navigationLabels.get(record.url) } : {}, body: rewriteMarkdownDestinations(record.page.body, (value) => {
+  const pages = checkpoint.records.flatMap((record) => record.page ? [{ ...record.page, id: projection.pageId(record.page), navigationId: projection.navigationId(record.page), ...projection.canonicalLocale(record.page) ? { locale: projection.canonicalLocale(record.page) } : {}, ...navigationLabels.has(record.url) ? { navTitle: navigationLabels.get(record.url) } : {}, body: rewriteMarkdownDestinations(record.page.body, (value) => {
     let url;
     try {
       url = new URL(value, record.evidence.finalUrl);
@@ -4151,11 +4194,12 @@ ${difference}`;
     platform: options.platform ?? "generic",
     pages,
     assets: [...assets.values()],
-    docsConfig: navigationConfig(checkpoint.navigation, records) ?? buildNavigationFromPages(pages),
+    docsConfig: navigationConfig(checkpoint, records) ?? buildNavigationFromPages(pages),
     warnings: [...validation.issues, ...validation.warnings ?? []].map((issue) => ({ code: issue.code === "missing-page" ? "missing-page" : "unsupported-config", message: issue.message, source: issue.source })),
     urlMigrationValidation: validation,
     stats: { discovered: records.size, imported: pages.length, skipped: records.size - pages.length }
   };
+  if (projection.redirects.length) bundle.docsConfig.redirects = projection.redirects;
   if (projection.locales.length) {
     const locales = [.../* @__PURE__ */ new Set([projection.defaultLocale, ...projection.locales])];
     bundle.docsConfig.i18n = { ...bundle.docsConfig.i18n, defaultLocale: projection.defaultLocale, locales: locales.map((code) => ({ code, label: code === "en" ? "English" : code })) };