@thallylabs/migrate 0.2.10 → 0.2.11

package/README.md

@@ -26,6 +26,25 @@ instead of silently dropping that API tab's reference. AsyncAPI has no Thally
 renderer, so it always produces a clear warning naming the spec instead of
 disappearing.
 
+In-content links to auto-generated API operation pages are rewritten to the
+matching Thally `/api/...` route. A link under a known API section that matches
+no operation points to that section's overview page instead, and one warning
+lists the affected links (up to ten). A Mintlify default version's pages also
+get a redirect from their address without the version segment, since the
+original site serves them both ways.
+
+A repository is limited to 5,000 documentation files and, separately, 5,000
+asset files. Past that, files are kept in navigation order with the default
+version first, then pages not listed in navigation, and one warning counts and
+names (the first three of) the pages left out and suggests `--docs-dir` to
+migrate a smaller part of the repository. Scanning itself stops after 100,000
+files with its own warning. Individual assets over 25 MB, or beyond 500 MB in
+total, are not copied and are warned about one by one.
+
+Headings written with an explicit `{#custom-id}` become a preceding
+`<a id="custom-id"></a>` anchor and keep their text, so links to that id still
+work and the page still compiles as MDX.
+
 Docusaurus sidebars are parsed as bounded, data-only JSON5—never executed—and
 preserve explicit categories, autogenerated slices, document IDs/slugs,
 positions, generated indexes, admonitions, tabs, and `static/` assets where

package/dist/index.d.ts

@@ -159,6 +159,8 @@ interface MigrationPage {
     openapi?: string;
     body: string;
     source: string;
+    /** Set when the page's frontmatter was invalid YAML; the page is kept with a best-effort salvage. */
+    frontmatterError?: string;
 }
 interface MigrationAsset {
     /** Path below `public`, always normalized and traversal-free. */
@@ -389,6 +391,13 @@ declare function readFernConfig(fernRoot: string): {
 declare function projectFernNavigation(input: {
     config: Record<string, unknown>;
     fernRoot: string;
+    /**
+     * The whole repository checkout — the security boundary for anything a
+     * config file references (e.g. a `versions:` file living outside
+     * `fern/`). Defaults to `fernRoot` for callers with no wider repository
+     * context (e.g. unit tests), which reproduces the previous fernRoot-only
+     * confinement.
+     */
     repositoryRoot?: string;
 }): FernNavigationResult;