Changelog

**`(feat):`** Custom MDX components (`experimental.mdx-components`) can now import third-party libraries. The CLI bundles component files with rolldown (via npx) at docs build time, inlining dependencies resolved from the docs project's node\_modules.

**`(fix):`** Validate that a docs instance's `url` and `custom-domain` share the same basepath for all sites, not just basepath-aware ones. Navigation links and redirects are generated relative to the basepath, so the CLI now fails with a clear error when they differ.

**`(fix):`** Docs configs with a `path` input library no longer crash `fern docs dev` and `fern generate --docs`. `parseLibrariesConfiguration` now accepts both `git` and `path` library inputs instead of throwing on `path`, so a site whose library docs were generated locally with `fern docs md generate --local` can be previewed and published.

**`(fix):`** `fern check` now fails when `docs.yml` contains both `navigation` and `products`. These are mutually exclusive (as `navigation` and `versions` already were): in a multi-product site the navigation lives in each product's referenced file, so a top-level `navigation` block silently overrides the products and renders empty navigation.

**`(chore):`** Bump `@fern-api/generator-cli` to 0.9.44 so every local-only commit is signed when pushing to GitHub, not just HEAD.

**`(fix):`** Improve `fern docs dev` initial build time by pre-fetching external `<Code src="https://..."/>` URLs in parallel instead of sequentially, and optimizing image processing with early-exit checks and streaming scanning. For large docs sites with many external code snippets, this reduces initial build time from \~57s to \~14s (75% faster).

**`(fix):`** Fix relative .md/.mdx link resolution in translated documentation pages. Previously, translated pages passed an empty markdownFilesToPathName map, so relative markdown links (e.g., ../reference/support-matrix.md) were not resolved to their published slug URLs.

**`(fix):`** Improve error messages when ledger docs publishing fails: surface the server-side validation issues (field paths and messages) so the exact failing field is visible without needing server-side log access.

**`(fix):`** Improve `fern docs dev` reload performance for content edits (35s → 4-5s). Reduces debounce from 1000ms to 300ms, skips background validation for markdown-only changes, and writes a generation counter file for the docs bundle to detect stale cache entries without HTTP round-trips.

**`(feat):`** Add support for `x-fern-global-parameters` OpenAPI extension. Allows declaring global defaults for request body, query, header, and path fields that are set once at the SDK client level and injected at the declared wire location, with per-call values winning. IR bumped to 67.10.0.

**`(fix):`** Fix GraphQL namespace types (e.g. Inventory, Geography) being excluded from the type registry and missing parent operations for query pages. Namespace types are now registered so their fields render correctly on landing pages.

**`(fix):`** Prevent --version AUTO from embedding literal 'AUTO' in generated SDK code during remote generation. The magic placeholder is now substituted before IR generation in the remote path, matching the local generation fix.

**`(feat):`** Extend dynamic IR OAuth types with custom properties and populate them in DynamicSnippetsConverter, enabling dynamic snippet generators to include custom OAuth token endpoint request parameters in generated code examples.

**`(fix):`** Strip CLI-only config keys (e.g. `user-agent`) from the custom config before forwarding to generator containers, preventing strict validation errors in generators that reject unknown keys.