v1.9.0 — Release Notes

New Features

5 new additions

Migration: require() path conversion — the Docusaurus migration script now converts require('@site/static/img/foo.png').default and similar patterns to static URL strings ('/img/foo.png'). Remaining require() calls that can't be auto-converted produce a warning
Migration: MDX partial includes — relative .mdx imports (import Foo from './_foo.mdx') are now converted to @include directives, and the corresponding <Foo /> usages are replaced automatically
Migration: auto-generated TypeScript types — JavaScript components renamed to .tsx during migration now get auto-generated prop interfaces inferred from destructuring patterns, default values, and naming conventions. Includes useState generics, event handler types, and 'use client' directive injection
Migration: enhanced report — the post-migration report now lists custom components with Trellis built-in equivalents that were skipped, components used in content but not found in src/components/, and suggested variables for repeated strings
Migration: @docusaurus/* import stripping — imports from @docusaurus/ packages are now removed alongside @theme/ and @site/ imports

1 enhancements

CLI scaffolder — the create-trellis-docs scaffolder now generates a platform-specific .npmrc at project creation time, ensuring native optional dependencies (lightningcss, @tailwindcss/oxide) install correctly regardless of the user's global npm configuration

1 issues resolved

Migration: code block preservation — content transforms (comment conversion, import stripping) now skip fenced code blocks entirely, preventing false positives inside examples and snippets