@thallylabs/migrate 0.2.33 → 0.2.35

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

@@ -165,6 +165,12 @@ interface MigrationNavigationGroup {
     hidden?: boolean;
     pages: Array<string | MigrationNavigationGroup>;
 }
+/** A group of an API tab's authored sidebar: `METHOD /path` operation keys and nested groups. */
+interface MigrationApiGroup {
+    group: string;
+    icon?: string;
+    pages: Array<string | MigrationApiGroup>;
+}
 interface MigrationNavigationTab {
     tab: string;
     /** Reader-facing label when `tab` includes a version for unique identity. */
@@ -180,6 +186,7 @@ interface MigrationNavigationTab {
     api?: {
         source: string;
         navigation?: boolean;
+        groups?: Array<MigrationApiGroup>;
     };
 }
 interface MigrationBannerConfig {
@@ -238,6 +245,8 @@ interface MigrationDocsConfig {
     stylesheets?: Array<string>;
     /** `false` hides the breadcrumb trail; Mintlify pages show only a group eyebrow. */
     breadcrumbs?: boolean;
+    /** `path` shows the full group path above the title (Mintlify `styling.eyebrows: "breadcrumbs"`); the default shows the nearest group. */
+    eyebrow?: 'group' | 'path';
     tabs: Array<MigrationNavigationTab>;
     navigation?: {
         /** How sibling documentation collections are presented to readers. */
@@ -272,6 +281,7 @@ interface MigrationDocsConfig {
     colors?: Partial<Record<'light' | 'dark', {
         primary?: string;
         accent?: string;
+        background?: string;
     }>>;
     icons?: {
         library?: 'lucide' | 'fontawesome' | 'tabler';
@@ -439,6 +449,10 @@ interface RemoteApiSpec {
     hidden?: boolean;
     /** Every `directory` docs.json mounts this spec under: several API tabs may share one spec URL. */
     directories?: Array<RemoteApiSpecDirectory>;
+    /** The operation groups docs.json authors for the tab this spec binds to, merged across every reference that shares it. */
+    groups?: Array<MigrationApiGroup>;
+    /** Every reference sharing the tab lists operations and none survives (all hidden or restricted): no endpoint navigation is generated for it. */
+    navigation?: false;
     /** 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. */

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-_wVauqSg.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-peVzTLjL.js';

package/dist/url-migration.js

@@ -1065,8 +1065,11 @@ var JS_GLOBALS = /* @__PURE__ */ new Set([
   "MessageChannel",
   "BroadcastChannel"
 ]);
-function parse(source) {
-  return ts.createSourceFile("inline.tsx", source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+function scriptKindFor(fileName) {
+  return /\.[cm]?ts$/.test(fileName) ? ts.ScriptKind.TS : ts.ScriptKind.TSX;
+}
+function parse(source, fileName = "inline.tsx") {
+  return ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, scriptKindFor(fileName));
 }
 function bindingNames(name, into) {
   if (ts.isIdentifier(name)) into.add(name.text);
@@ -1075,20 +1078,44 @@ function bindingNames(name, into) {
 function isFunctionLike(node) {
   return ts.isFunctionDeclaration(node) || ts.isFunctionExpression(node) || ts.isArrowFunction(node) || ts.isMethodDeclaration(node) || ts.isConstructorDeclaration(node) || ts.isGetAccessorDeclaration(node) || ts.isSetAccessorDeclaration(node);
 }
+function hoistedVarNames(root, into) {
+  const collect = (node) => {
+    if (isFunctionLike(node) || ts.isClassLike(node) || ts.isModuleDeclaration(node)) return;
+    if (ts.isVariableDeclaration(node) && !ts.isCatchClause(node.parent) && !(ts.getCombinedNodeFlags(node) & ts.NodeFlags.BlockScoped)) bindingNames(node.name, into);
+    ts.forEachChild(node, collect);
+  };
+  collect(root);
+}
 function functionScope(fn) {
   const scope = /* @__PURE__ */ new Set();
   if ((ts.isFunctionExpression(fn) || ts.isFunctionDeclaration(fn)) && fn.name) scope.add(fn.name.text);
   for (const parameter of fn.parameters) bindingNames(parameter.name, scope);
-  function collect(node) {
-    if (ts.isVariableDeclaration(node)) bindingNames(node.name, scope);
-    if ((ts.isFunctionDeclaration(node) || ts.isClassDeclaration(node)) && node.name) scope.add(node.name.text);
-    if (isFunctionLike(node)) return;
-    ts.forEachChild(node, collect);
-  }
-  if (fn.body) ts.forEachChild(fn.body, collect);
-  if (fn.body && !ts.isBlock(fn.body)) collect(fn.body);
   return scope;
 }
+function lexicalNames(statements) {
+  const names = /* @__PURE__ */ new Set();
+  for (const statement of statements) {
+    if (ts.isVariableStatement(statement)) {
+      if (statement.declarationList.flags & ts.NodeFlags.BlockScoped) for (const declaration of statement.declarationList.declarations) bindingNames(declaration.name, names);
+    } else if ((ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement)) && statement.name) names.add(statement.name.text);
+  }
+  return names;
+}
+function ownScope(node) {
+  if (ts.isBlock(node)) return lexicalNames(node.statements);
+  if (ts.isCaseBlock(node)) return lexicalNames(node.clauses.flatMap((clause) => [...clause.statements]));
+  if ((ts.isForStatement(node) || ts.isForInStatement(node) || ts.isForOfStatement(node)) && node.initializer && ts.isVariableDeclarationList(node.initializer)) {
+    const names = /* @__PURE__ */ new Set();
+    if (node.initializer.flags & ts.NodeFlags.BlockScoped) for (const declaration of node.initializer.declarations) bindingNames(declaration.name, names);
+    return names;
+  }
+  if (ts.isCatchClause(node) && node.variableDeclaration) {
+    const names = /* @__PURE__ */ new Set();
+    bindingNames(node.variableDeclaration.name, names);
+    return names;
+  }
+  return void 0;
+}
 function collectRefs(root) {
   const refs = [];
   const assigned = [];
@@ -1103,13 +1130,22 @@ function collectRefs(root) {
   function walkNode(node, scopes, inAsync) {
     if (ts.isTypeNode(node)) return;
     if (isFunctionLike(node)) {
-      const nextScopes = [...scopes, functionScope(node)];
+      const parameterScopes = [...scopes, functionScope(node)];
       const async = !!node.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.AsyncKeyword);
       for (const parameter of node.parameters) {
-        if (!ts.isIdentifier(parameter.name)) walkNode(parameter.name, nextScopes, async);
-        if (parameter.initializer) walkNode(parameter.initializer, nextScopes, async);
+        if (!ts.isIdentifier(parameter.name)) walkNode(parameter.name, parameterScopes, async);
+        if (parameter.initializer) walkNode(parameter.initializer, parameterScopes, async);
       }
-      if (node.body) walkNode(node.body, nextScopes, async);
+      if (node.body) {
+        const hoisted = /* @__PURE__ */ new Set();
+        hoistedVarNames(node.body, hoisted);
+        walkNode(node.body, [...parameterScopes, hoisted], async);
+      }
+      return;
+    }
+    const own = ownScope(node);
+    if (own) {
+      ts.forEachChild(node, (child) => walkNode(child, [...scopes, own], inAsync));
       return;
     }
     if (ts.isAwaitExpression(node) && !inAsync) awaitOutsideAsync = true;
@@ -1233,12 +1269,14 @@ function expressionRefs(expression) {
 function pageScopeNames(esmSources) {
   const names = /* @__PURE__ */ new Set();
   for (const source of esmSources) {
-    for (const statement of parse(source).statements) {
+    const sf = parse(source);
+    for (const statement of sf.statements) {
       for (const local of importLocals(statement.getText())) names.add(local);
       if (ts.isImportDeclaration(statement)) continue;
       const target2 = ts.isExportDeclaration(statement) || ts.isExportAssignment(statement) ? void 0 : statement;
       if (target2) for (const name of declaredNames(target2).names) names.add(name);
     }
+    hoistedVarNames(sf, names);
   }
   return names;
 }
@@ -4303,13 +4341,7 @@ function hash2(value) {
   return createHash2("sha256").update(value).digest("hex").slice(0, 12);
 }
 function sourceFile(source, filename) {
-  return ts2.createSourceFile(
-    filename,
-    source,
-    ts2.ScriptTarget.Latest,
-    true,
-    /\.[cm]?ts$/.test(filename) ? ts2.ScriptKind.TS : ts2.ScriptKind.TSX
-  );
+  return ts2.createSourceFile(filename, source, ts2.ScriptTarget.Latest, true, scriptKindFor(filename));
 }
 function mergeComponentRegistry(existing, incoming) {
   const fingerprint = hash2(incoming);