@thallylabs/migrate 0.2.44 → 0.2.46

package/dist/index.d.ts

@@ -118,7 +118,6 @@ declare function detectRepositoryPlatform(repositoryDir: string, docsDir?: strin
 declare function detectRepositoryDocsDir(repositoryDir: string): string;
 /** Enumerate generated endpoint routes using the same spec visibility, tab ids and slugs as migration linking. */
 declare function migrationApiRoutes(bundle: Pick<MigrationBundle, 'docsConfig' | 'assets'>): Array<string>;
-/** Import an already-available repository directory into a canonical bundle. */
 declare function migrateRepository(options: RepositoryMigrationOptions): MigrationBundle;
 
 /**

package/dist/index.js

@@ -8217,7 +8217,122 @@ function propertyStart(source, name) {
   }
   return -1;
 }
-function staticStringBindings(source) {
+function staticModulePath(repositoryRoot, specifier) {
+  if (!specifier.startsWith(".")) return null;
+  try {
+    const relativePath = specifier.replace(/^\.\/+/, "");
+    return ["", ".ts", ".tsx", ".js", ".jsx", ".mjs", ".json"].map((extension) => withinRealRoot(resolveWithin(repositoryRoot, `${relativePath}${extension}`), repositoryRoot)).find((candidate) => existsSync4(candidate) && lstatSync4(candidate).isFile()) ?? null;
+  } catch {
+    return null;
+  }
+}
+function staticObjectStrings(objectText) {
+  const fields = /* @__PURE__ */ new Map();
+  try {
+    const parsed = JSON5.parse(objectText);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return fields;
+    for (const [key, value] of Object.entries(parsed)) {
+      if (typeof value === "string") fields.set(key, value);
+    }
+  } catch {
+    return fields;
+  }
+  return fields;
+}
+function defaultExportObjectLiteralText(source) {
+  const exported = /\bexport\s+default\s+/.exec(source);
+  if (!exported) return null;
+  const start = exported.index + exported[0].length;
+  const literal = matchingObjectLiteral(source, start);
+  if (literal) return literal;
+  const identifier = source.slice(start).match(/^([A-Za-z_$][\w$]*)/)?.[1];
+  if (!identifier) return null;
+  const declaration = new RegExp(
+    `\\b(?:const|let|var)\\s+${identifier}\\b(?:\\s*:\\s*[^=;]+)?\\s*=\\s*`
+  ).exec(source);
+  return declaration ? matchingObjectLiteral(source, declaration.index + declaration[0].length) : null;
+}
+function namedExportStringText(source, name) {
+  const match = new RegExp(
+    `\\bexport\\s+(?:const|let|var)\\s+${name}\\b(?:\\s*:\\s*[^=;]+)?\\s*=\\s*`
+  ).exec(source);
+  if (!match) return void 0;
+  const quoted = source.slice(match.index + match[0].length).match(/^("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*')/);
+  if (!quoted) return void 0;
+  try {
+    const parsed = JSON5.parse(quoted[1]);
+    return typeof parsed === "string" ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function staticImportBindings(source, repositoryRoot) {
+  const bindings = /* @__PURE__ */ new Map();
+  const addObject = (local, specifier, exported) => {
+    const modulePath = staticModulePath(repositoryRoot, specifier);
+    if (!modulePath) return;
+    const moduleSource = readBoundedText(modulePath);
+    const objectText = extname5(modulePath).toLowerCase() === ".json" ? moduleSource : exported === "default" ? defaultExportObjectLiteralText(moduleSource) : namedExportObjectLiteralText(moduleSource, exported);
+    if (!objectText) return;
+    for (const [key, value] of staticObjectStrings(objectText)) {
+      bindings.set(`${local}.${key}`, value);
+    }
+  };
+  const addString = (local, specifier, exported) => {
+    const modulePath = staticModulePath(repositoryRoot, specifier);
+    if (!modulePath || extname5(modulePath).toLowerCase() === ".json") return;
+    const value = namedExportStringText(readBoundedText(modulePath), exported);
+    if (value !== void 0) bindings.set(local, value);
+  };
+  const addNamespace = (local, specifier) => {
+    const modulePath = staticModulePath(repositoryRoot, specifier);
+    if (!modulePath) return;
+    const moduleSource = readBoundedText(modulePath);
+    if (extname5(modulePath).toLowerCase() === ".json") {
+      for (const [key, value] of staticObjectStrings(moduleSource)) {
+        bindings.set(`${local}.${key}`, value);
+      }
+      return;
+    }
+    const defaultText = defaultExportObjectLiteralText(moduleSource);
+    if (defaultText) {
+      for (const [key, value] of staticObjectStrings(defaultText)) {
+        bindings.set(`${local}.default.${key}`, value);
+      }
+    }
+    for (const match of moduleSource.matchAll(/\bexport\s+(?:const|let|var)\s+([A-Za-z_$][\w$]*)\b/g)) {
+      const name = match[1];
+      const value = namedExportStringText(moduleSource, name);
+      if (value !== void 0) bindings.set(`${local}.${name}`, value);
+      const objectText = namedExportObjectLiteralText(moduleSource, name);
+      if (!objectText) continue;
+      for (const [key, objectValue5] of staticObjectStrings(objectText)) {
+        bindings.set(`${local}.${name}.${key}`, objectValue5);
+      }
+    }
+  };
+  for (const match of source.matchAll(
+    /\bimport\s+([A-Za-z_$][\w$]*)\s*(?:,\s*\{[^}]*\})?\s+from\s*(['"])([^'"]+)\2/g
+  )) {
+    addObject(match[1], match[3], "default");
+  }
+  for (const match of source.matchAll(
+    /\bimport\s+\*\s+as\s+([A-Za-z_$][\w$]*)\s+from\s*(['"])([^'"]+)\2/g
+  )) {
+    addNamespace(match[1], match[3]);
+  }
+  for (const match of source.matchAll(/\bimport\s*\{([^}]*)\}\s*from\s*(['"])([^'"]+)\2/g)) {
+    for (const entry of match[1].split(",")) {
+      const [imported, alias] = entry.split(/\s+as\s+/).map((part) => part.trim());
+      if (!imported || !/^[A-Za-z_$][\w$]*$/.test(imported)) continue;
+      const local = alias && /^[A-Za-z_$][\w$]*$/.test(alias) ? alias : imported;
+      addObject(local, match[3], imported);
+      addString(local, match[3], imported);
+    }
+  }
+  return bindings;
+}
+function staticStringBindings(source, repositoryRoot) {
   const bindings = /* @__PURE__ */ new Map();
   for (const match of source.matchAll(/\bconst\s+([A-Z][A-Z0-9_]*)\s*=\s*((?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'))/g)) {
     try {
@@ -8226,6 +8341,11 @@ function staticStringBindings(source) {
     } catch {
     }
   }
+  if (repositoryRoot) {
+    for (const [reference, value] of staticImportBindings(source, repositoryRoot)) {
+      bindings.set(reference, value);
+    }
+  }
   return bindings;
 }
 function staticArrayField(source, name) {
@@ -8293,8 +8413,8 @@ function staticStringField(source, name, bindings) {
   if (start < 0) return void 0;
   const quoted = source.slice(start).match(/^("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*')/);
   if (!quoted) {
-    const binding = source.slice(start).match(/^([A-Z][A-Z0-9_]*)\b/)?.[1];
-    return binding ? bindings?.get(binding) : void 0;
+    const reference = source.slice(start).match(/^([A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*)/)?.[1];
+    return reference ? bindings?.get(reference) : void 0;
   }
   try {
     const parsed = JSON5.parse(quoted[1]);
@@ -8303,15 +8423,28 @@ function staticStringField(source, name, bindings) {
     return void 0;
   }
 }
+var COPYRIGHT_YEAR = /\$\{\s*new Date\(\)\s*\.\s*getFullYear\(\)\s*\}/g;
+var COPYRIGHT_TOKEN = /\$\{([^}]*)\}/g;
+var DOCUSAURUS_CREDIT = /\s*\bBuilt with Docusaurus\b[.!]*/gi;
+function docusaurusCopyright(source, bindings, unresolved) {
+  const value = source.replace(COPYRIGHT_YEAR, "{year}").replace(COPYRIGHT_TOKEN, (_match, expression) => {
+    const reference = expression.trim();
+    const resolved = /^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*$/.test(reference) ? bindings.get(reference) : void 0;
+    if (resolved !== void 0) return resolved;
+    unresolved.push(reference);
+    return "";
+  }).replace(DOCUSAURUS_CREDIT, "").replace(/[ \t]{2,}/g, " ").replace(/\s+([.,;!?])/g, "$1").trim();
+  return value || void 0;
+}
 function readDocusaurusSiteSettings(repositoryRoot) {
   const empty2 = { docsRouteBasePath: "docs", defaultColorMode: "light", navbarLinks: [], footerLinks: [] };
   const configPath = findDocusaurusConfigPath(repositoryRoot);
   if (!configPath) return empty2;
   const source = readBoundedText(configPath);
-  const bindings = staticStringBindings(source);
+  const bindings = staticStringBindings(source, repositoryRoot);
   const presets = staticArrayField(source, "presets");
   const classicDocs = presets && [...presets.matchAll(/["']?docs["']?\s*:\s*/g)].map((match) => matchingObjectLiteral(presets, (match.index ?? 0) + match[0].length)).find((object3) => Boolean(object3));
-  const docsRouteBasePath = classicDocs && staticStringField(classicDocs, "routeBasePath") || "docs";
+  const docsRouteBasePath = classicDocs && staticStringField(classicDocs, "routeBasePath", bindings) || "docs";
   const themeStart = propertyStart(source, "themeConfig");
   const theme = themeStart < 0 ? null : matchingObjectLiteral(source, themeStart);
   const colorModeStart = theme ? propertyStart(theme, "colorMode") : -1;
@@ -8349,26 +8482,38 @@ function readDocusaurusSiteSettings(repositoryRoot) {
     });
     return items.length > 0 ? [{ heading, items }] : [];
   }) : [];
-  const copyright = footer && propertyStart(footer, "copyright") >= 0 ? staticStringField(footer, "copyright") ?? footer.slice(propertyStart(footer, "copyright")).match(/^`([^`]+)`/)?.[1]?.replace(/\$\{new Date\(\)\.getFullYear\(\)\}/g, "{year}") : void 0;
+  const copyrightStart = footer ? propertyStart(footer, "copyright") : -1;
+  const copyrightSource = copyrightStart < 0 ? void 0 : staticStringField(footer, "copyright", bindings) ?? footer.slice(copyrightStart).match(/^`([^`]+)`/)?.[1];
+  const unresolvedCopyright = [];
+  const copyright = copyrightSource === void 0 ? void 0 : docusaurusCopyright(copyrightSource, bindings, unresolvedCopyright);
   const announcementStart = theme ? propertyStart(theme, "announcementBar") : -1;
   const announcement = announcementStart < 0 ? null : matchingObjectLiteral(theme, announcementStart);
   const announcementContent = announcement && staticStringField(announcement, "content") || announcement?.slice(propertyStart(announcement, "content")).match(/^`([^`]+)`/)?.[1];
   const bannerContent = announcementContent ? announcementMarkdown(announcementContent) : "";
+  const name = staticStringField(source, "title", bindings);
+  const description = staticStringField(source, "tagline", bindings);
+  const navbarTitle = navbar ? staticStringField(navbar, "title", bindings) : void 0;
+  const unresolvedIdentity = [];
+  if (!name && propertyStart(source, "title") >= 0) unresolvedIdentity.push("title");
+  if (!description && propertyStart(source, "tagline") >= 0) unresolvedIdentity.push("tagline");
+  if (!navbarTitle && navbar && propertyStart(navbar, "title") >= 0) unresolvedIdentity.push("navbarTitle");
   return {
     ...bannerContent ? { banner: { content: bannerContent, dismissible: !/isCloseable\s*:\s*false/.test(announcement), ...staticStringField(announcement, "id") ? { id: staticStringField(announcement, "id") } : {} } } : {},
-    name: staticStringField(source, "title"),
-    description: staticStringField(source, "tagline"),
-    ...navbar && staticStringField(navbar, "title") ? { navbarTitle: staticStringField(navbar, "title") } : {},
+    ...name ? { name } : {},
+    ...description ? { description } : {},
+    ...navbarTitle ? { navbarTitle } : {},
+    ...unresolvedIdentity.length > 0 ? { unresolvedIdentity } : {},
+    ...unresolvedCopyright.length > 0 ? { unresolvedCopyright } : {},
     defaultColorMode,
     docsRouteBasePath,
-    ...logo && staticStringField(logo, "src") ? {
+    ...logo && staticStringField(logo, "src", bindings) ? {
       logo: {
-        light: staticStringField(logo, "src"),
-        ...staticStringField(logo, "srcDark") ? { dark: staticStringField(logo, "srcDark") } : {},
-        showTitle: Boolean(navbar && staticStringField(navbar, "title"))
+        light: staticStringField(logo, "src", bindings),
+        ...staticStringField(logo, "srcDark", bindings) ? { dark: staticStringField(logo, "srcDark", bindings) } : {},
+        showTitle: Boolean(navbarTitle)
       }
     } : {},
-    ...staticStringField(source, "favicon") ? { favicon: staticStringField(source, "favicon") } : {},
+    ...staticStringField(source, "favicon", bindings) ? { favicon: staticStringField(source, "favicon", bindings) } : {},
     navbarLinks,
     footerLinks,
     ...copyright ? { copyright } : {}
@@ -15838,6 +15983,46 @@ function componentSourceIdentity(sourceUrl, repositoryDir, siteRoot, namespace)
   const docsRoot = relative6(repositoryDir, siteRoot).replace(/\\/g, "/");
   return JSON.stringify(namespace ? [repository, docsRoot, namespace] : [repository, docsRoot]);
 }
+function sourcePackageName(repositoryDir) {
+  try {
+    const path = withinRealRoot(resolveWithin(repositoryDir, "package.json"), repositoryDir);
+    const metadata = lstatSync6(path);
+    if (!metadata.isFile() || metadata.size > MAX_PAGE_BYTES) return void 0;
+    const parsed = JSON.parse(readFileSync6(path, "utf8"));
+    if (typeof parsed.name !== "string") return void 0;
+    return parsed.name.split("/").pop()?.trim() || void 0;
+  } catch {
+    return void 0;
+  }
+}
+function docusaurusProjectName(settings, repositoryDir, sourceUrl) {
+  const configured = settings.navbarTitle ?? settings.name;
+  if (configured) return { name: configured };
+  const packageName = sourcePackageName(repositoryDir);
+  if (packageName) return { name: packageName, origin: "the source package.json name" };
+  const sourceName = (() => {
+    try {
+      const segment = new URL(sourceUrl).pathname.split("/").filter(Boolean).pop();
+      return segment ? decodeURIComponent(segment).replace(/\.git$/i, "") : void 0;
+    } catch {
+      return void 0;
+    }
+  })();
+  if (sourceName) return { name: sourceName, origin: "the source repository name" };
+  const sourceHost = (() => {
+    try {
+      return new URL(sourceUrl).hostname || void 0;
+    } catch {
+      return void 0;
+    }
+  })();
+  return sourceHost ? { name: sourceHost, origin: "the source host" } : void 0;
+}
+var DOCUSAURUS_IDENTITY_LABELS = {
+  title: "site title",
+  tagline: "site tagline",
+  navbarTitle: "navbar title"
+};
 function migrateRepository(options) {
   const repositoryDir = options.repositoryDir;
   const platform = options.platform ?? detectRepositoryPlatform(repositoryDir, options.docsDir);
@@ -17506,7 +17691,22 @@ ${reasons.map((reason) => `- ${reason}`).join("\n")}` : "No importable Markdown
   const isTopLevelDocusaurus = platform === "docusaurus" && docusaurusProjectRoot && !options.docusaurusSkipRedirects;
   const docusaurusSettings = isTopLevelDocusaurus ? readDocusaurusSiteSettings(docusaurusProjectRoot) : void 0;
   const presentation = docusaurusSettings ? readDocusaurusPresentation(docusaurusProjectRoot) : void 0;
+  const docusaurusIdentity = docusaurusSettings ? docusaurusProjectName(docusaurusSettings, repositoryDir, options.sourceUrl) : void 0;
   if (docusaurusSettings) {
+    for (const field of docusaurusSettings.unresolvedIdentity ?? []) {
+      const namesTheProject = field === "title" || field === "navbarTitle";
+      const fallback = namesTheProject && docusaurusIdentity?.origin ? ` The project name was taken from ${docusaurusIdentity.origin}.` : "";
+      warnings.push({
+        code: "unsupported-config",
+        message: `The Docusaurus ${DOCUSAURUS_IDENTITY_LABELS[field]} could not be read without running the config and was left out of the migration.${fallback} Use a string literal, or plain data in an imported module, to import it.`
+      });
+    }
+    for (const token of docusaurusSettings.unresolvedCopyright ?? []) {
+      warnings.push({
+        code: "unsupported-config",
+        message: `The Docusaurus footer copyright references ${token}, which could not be read without running the config, so the placeholder was removed. Use a literal value, or plain data in an imported module, to import it.`
+      });
+    }
     if (presentation) {
       assets.push({ path: "_thally/source-theme.css", content: Buffer.from(presentation.css) });
       docsConfig = { ...docsConfig, stylesheets: [...docsConfig.stylesheets ?? [], "/_thally/source-theme.css"], ...presentation.headingFont ? { fonts: { ...docsConfig.fonts, heading: { family: presentation.headingFont, weight: ["400", "500", "600", "700"] } } } : {} };
@@ -17753,9 +17953,9 @@ ${reasons.map((reason) => `- ${reason}`).join("\n")}` : "No importable Markdown
         ...typeof fernRawConfig.title === "string" ? { name: fernRawConfig.title } : {},
         ...themeColors ? { colors: themeColors } : {}
       }
-    } : docusaurusSettings && (docusaurusSettings.name || docusaurusSettings.description || themeColors) ? {
+    } : docusaurusSettings && (docusaurusIdentity?.name || docusaurusSettings.description || themeColors) ? {
       site: {
-        ...docusaurusSettings.navbarTitle || docusaurusSettings.name ? { name: docusaurusSettings.navbarTitle ?? docusaurusSettings.name } : {},
+        ...docusaurusIdentity?.name ? { name: docusaurusIdentity.name } : {},
         ...docusaurusSettings.description ? { description: docusaurusSettings.description } : {},
         ...themeColors ? { colors: themeColors } : {}
       }