@thallylabs/migrate 0.2.41 → 0.2.43

package/README.md

@@ -10,6 +10,12 @@ ordered navigation and binary assets), or uses ordinary local fetching. Hosted
 callers must inject their own network-safe text/capture and binary boundaries.
 No browser, model, credentials, sandbox or publishing provider is bundled here.
 
+Default page requests advertise HTML to retain rendered content and declared
+alternates. An explicit same-origin, same-route Markdown alternate shares the
+article's destination; the rendered article takes precedence even when the
+Markdown URL was discovered first or restored from an interrupted checkpoint.
+Independent pages still report destination collisions.
+
 Server applications should import `@thallylabs/migrate/svg-policy` for the passive
 SVG validator, or `@thallylabs/migrate/url-migration` for the URL runner, renderer
 and their types. These independent entries avoid tracing repository cloning and
@@ -99,8 +105,13 @@ Missing primary counterparts and projected path collisions require review; the
 engine does not invent translations. Fresh HTML captures also observe `html lang`; conflicting or unsupported
 language evidence requires review. Capture adapters can supply `locale` when
 no language is declared in HTML or identified by the scoped URL path.
-The `url-evidence-v6` converter rejects earlier journals: replay retained raw
+The `url-evidence-v7` converter rejects earlier journals: replay retained raw
 captures into a new journal rather than relabelling previously hashed pages.
+Distinct observed redirect routes can retain their own sidebar titles through
+noindex page metadata and portable internal redirects to the captured article.
+Conflicting labels on the same route still require review. Markdown image and
+link destinations are localized by source spans, including escaped query strings,
+without changing matching labels, titles, or fenced examples.
 
 `stopReason` distinguishes a resumable `capture-limit` from hard `page-limit`
 or `byte-limit` outcomes. Hosts must not automatically retry a hard limit as an
@@ -723,3 +734,11 @@ initialized one at a time, best-effort,
 after a successful clone — a submodule that can't be fetched (private,
 deleted, network trouble) is named in a warning instead of failing the
 whole migration.
+
+`migrateUrl({ sourceUrl, openapiUrl })` accepts an explicit HTTPS OpenAPI URL,
+using the same bounded specification fetch boundary as repository imports.
+A single publisher-linked `openapi.json` or `openapi.yaml` can also be discovered.
+Crawled endpoint pages with a unique tag/title route become interactive while
+retaining their prose; generated API navigation lists only unrepresented operations.
+This HTTP adapter never reads local paths. Trusted local CLI imports use a separate
+bounded snapshot before calling the existing repository converter.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MigrationPage, a as MigrationAsset, b as MigrationNavigationGroup, R as RenderedMigrationFile, c as MigrationWarning, d as MigrationFetcher, e as MigrationPlatform, f as MigrationBundle, g as MigrationDocsConfig, E as EndpointTabSlot } from './url-run-mSKFqHx_.js';
-export { h as MigrationCapture, i as MigrationCaptureProvider, j as MigrationCaptureState, k as MigrationCapturedAsset, l as MigrationEvidence, m as MigrationFetchRequest, n as MigrationFetchResponse, o as MigrationJournalAsset, p as MigrationNavigationOccurrence, q as MigrationNavigationTab, U as UrlMigrationCheckpoint, r as UrlMigrationCheckpointDelta, s as UrlMigrationIssue, t as UrlMigrationRecord, u as UrlMigrationRun, v as UrlMigrationRunOptions, w as UrlMigrationValidation, x as classifyMigrationResponse, y as mergeMigrationConfig, z as renderMigrationFiles, A as runUrlMigration, B as validateUrlMigration } from './url-run-mSKFqHx_.js';
+import { M as MigrationPage, a as MigrationAsset, b as MigrationNavigationGroup, R as RenderedMigrationFile, c as MigrationWarning, d as MigrationFetcher, e as MigrationPlatform, f as MigrationBundle, g as MigrationDocsConfig, E as EndpointTabSlot } from './url-run-CPzQfjRW.js';
+export { h as MigrationCapture, i as MigrationCaptureProvider, j as MigrationCaptureState, k as MigrationCapturedAsset, l as MigrationEvidence, m as MigrationFetchRequest, n as MigrationFetchResponse, o as MigrationJournalAsset, p as MigrationNavigationOccurrence, q as MigrationNavigationTab, U as UrlMigrationCheckpoint, r as UrlMigrationCheckpointDelta, s as UrlMigrationIssue, t as UrlMigrationRecord, u as UrlMigrationRun, v as UrlMigrationRunOptions, w as UrlMigrationValidation, x as classifyMigrationResponse, y as mergeMigrationConfig, z as renderMigrationFiles, A as runUrlMigration, B as validateUrlMigration } from './url-run-CPzQfjRW.js';
 export { isPassiveSvg } from './svg-policy.js';
 
 /**
@@ -113,9 +113,37 @@ options?: {
 declare function detectRepositoryPlatform(repositoryDir: string, docsDir?: string): MigrationPlatform;
 /** Pick the first conventional content root containing Markdown. */
 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;
 
+/**
+ * Final pass over a migrated redirect set. Next.js applies a redirect before it
+ * looks for a page, so a redirect whose source is a served page hides that page,
+ * and two redirects that point at each other never settle. Next also parses a
+ * redirect source as a route pattern, so one with pattern operators fails the
+ * whole build. Every platform and every step that adds redirects (source
+ * config, generated aliases, remote API specs) is checked here once, instead of
+ * each caller guarding its own additions.
+ *
+ * A site runs on either of two servers: `next start` matches a redirect source
+ * without regard to letter case, while the Cloudflare build matches it exactly.
+ * A conflict is judged by the stricter reading, so a redirect that would hide a
+ * page or loop on either server is left out.
+ */
+
+/** `exactRoute` in lower case: the form routes are compared in, so `/Guide` and `/guide` are one address. */
+declare function literalRoute(route: string): string | null;
+/**
+ * Every address that opens a page. That is `pageRoutes`, plus the site root for
+ * the home document: the runtime serves `introduction` at `/` (`navigationPagePath`
+ * in `@thallylabs/core`, which is also what its sidebar links to) and still accepts
+ * `/introduction` as an alias (`matchesNavigationPath`). A redirect that has to take
+ * a page over must cover all of them.
+ */
+declare function pageEntryRoutes(page: Pick<MigrationPage, 'id'>): Array<string>;
+
 /**
  * Mintlify-only helpers: page access rules, site-wide CSS/JS/font assets,
  * and appearance settings. Kept apart from the generic repository walk so the
@@ -342,6 +370,8 @@ declare function validateIntegrations(integrations: unknown): Array<string>;
 
 interface UrlMigrationOptions {
     sourceUrl: string;
+    /** Explicit HTTPS OpenAPI specification when the publisher has no operation mirrors. */
+    openapiUrl?: string;
     /** Explicit caller selection; omitted callers retain source auto-detection. */
     platform?: MigrationPlatform;
     fetcher?: MigrationFetcher;
@@ -356,6 +386,9 @@ declare const defaultMigrationFetcher: MigrationFetcher;
 /** Crawl one public docs origin into a canonical, caller-independent bundle. */
 declare function migrateUrl(options: UrlMigrationOptions): Promise<MigrationBundle>;
 
+/** Bind unique crawled endpoints in place and generate only missing operation navigation. */
+declare function hydrateUrlOpenApi(bundle: MigrationBundle, specUrl: string, fetcher?: MigrationFetcher): Promise<MigrationBundle>;
+
 /**
  * Attach safely downloaded specs to the exact authored API tabs. A spec
  * mounted under Mintlify `directory` folders gets a redirect from each
@@ -371,4 +404,4 @@ declare function migrateUrl(options: UrlMigrationOptions): Promise<MigrationBund
  */
 declare function hydrateRemoteApiSpecs(bundle: MigrationBundle, fetcher?: MigrationFetcher): Promise<MigrationBundle>;
 
-export { type GitHubRepositorySource, MigrationAsset, MigrationBundle, MigrationDocsConfig, MigrationFetcher, MigrationNavigationGroup, MigrationPage, MigrationPlatform, MigrationWarning, RenderedMigrationFile, type RepositoryMigrationOptions, SOURCE_REF_MAX_BYTES, SOURCE_REF_MAX_FILES, SOURCE_REF_MAX_REPOSITORY_KB, type SourceRefImport, type SourceRefMapping, type UrlMigrationOptions, addMintlifyDirectoryRedirects, buildNavigationFromPages, cloneGitHubRepository, defaultMigrationFetcher, detectRepositoryDocsDir, detectRepositoryPlatform, gitmodulePaths, hydrateRemoteApiSpecs, importSourceRef, migrateRepository, migrateUrl, normalizeMdx, parseGitHubRepositoryUrl, parseMarkdownPage, parseSourceRefFlags, projectFernNavigation, projectMintlifyIntegrations, projectMintlifyNavigation, pruneMissingNavigationPages, readFernConfig, readMintlifyConfig, sourceRefOversizeReason, validateIntegrations, validateMigrationUrl };
+export { type GitHubRepositorySource, MigrationAsset, MigrationBundle, MigrationDocsConfig, MigrationFetcher, MigrationNavigationGroup, MigrationPage, MigrationPlatform, MigrationWarning, RenderedMigrationFile, type RepositoryMigrationOptions, SOURCE_REF_MAX_BYTES, SOURCE_REF_MAX_FILES, SOURCE_REF_MAX_REPOSITORY_KB, type SourceRefImport, type SourceRefMapping, type UrlMigrationOptions, addMintlifyDirectoryRedirects, buildNavigationFromPages, cloneGitHubRepository, defaultMigrationFetcher, detectRepositoryDocsDir, detectRepositoryPlatform, gitmodulePaths, hydrateRemoteApiSpecs, hydrateUrlOpenApi, importSourceRef, literalRoute, migrateRepository, migrateUrl, migrationApiRoutes, normalizeMdx, pageEntryRoutes, parseGitHubRepositoryUrl, parseMarkdownPage, parseSourceRefFlags, projectFernNavigation, projectMintlifyIntegrations, projectMintlifyNavigation, pruneMissingNavigationPages, readFernConfig, readMintlifyConfig, sourceRefOversizeReason, validateIntegrations, validateMigrationUrl };