@thallylabs/migrate 0.2.34 → 0.2.37

package/dist/{url-migration-EwtII4P-.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. */
@@ -440,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-EwtII4P-.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

@@ -3760,7 +3760,7 @@ function validateUrlMigration(checkpoint, cancelled = false) {
         } catch {
         }
         if (!destination.evidence?.anchors.includes(anchor)) {
-          warnings.push({ code: "source-link-warning", source: record.url, message: `The original source link refers to an absent source anchor: ${link}` });
+          warnings.push({ code: "source-link-warning", source: record.url, message: `The original source link refers to an absent source anchor; the imported link opens the page instead: ${link}` });
         } else if (destination.page) {
           const nodes = markdownNodes(destination.page.body);
           const explicit = nodes.flatMap((node) => node.name === "a" ? (node.attributes ?? []).flatMap((attribute) => attribute.name === "id" && typeof attribute.value === "string" ? [attribute.value] : []) : []);
@@ -4209,8 +4209,17 @@ ${difference}`;
     } catch {
       return value;
     }
-    const route = routeMap.get(canonical(url.toString(), sourceUrl));
-    return route ? `${route}${url.hash}` : value;
+    const identity = canonical(url.toString(), sourceUrl);
+    const route = routeMap.get(identity);
+    if (!route) return value;
+    const destination = resolveMigrationRecord(records, records.get(identity));
+    let anchor = url.hash.slice(1);
+    try {
+      anchor = decodeURIComponent(anchor);
+    } catch {
+    }
+    const hasBrokenSourceAnchor = Boolean(url.hash && destination?.outcome === "imported" && destination.evidence && !destination.evidence.anchors.includes(anchor));
+    return `${route}${hasBrokenSourceAnchor ? "" : url.hash}`;
   }) }] : []);
   const validation = validateUrlMigration(checkpoint, Boolean(options.signal?.aborted));
   validation.issues.push(...navigationIssues);