chore(deps): update docusaurus-plugin-llms to ^0.6.0

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
docusaurus-plugin-llms (source)	^0.2.2 → ^0.6.0

---

Release Notes

rachfop/docusaurus-plugin-llms (docusaurus-plugin-llms)

v0.6.0

Compare Source

Fixed

• <TabItem label="A > B"> leaked tag fragments: the TabItem label
  emitter cut its tag match at the first >, so a quoted label containing >
  dumped the rest of the tag into the output as prose. The matcher is now
  attribute-aware, like the PascalCase stripper.
• Multi-line descriptions rendered as broken blockquotes: a frontmatter
  description spanning lines quoted only its first line, leaving the rest as
  prose under the heading. Every line is now blockquoted.
• $ sequences corrupted partial content: partial files were spliced
  with a string replacement, so shell/perl patterns like echo $1, kill $$,
  or $& in a partial's code samples were silently rewritten (attr values
  substituted, tags re-inserted, document fragments duplicated). The splice
  now ignores replacement patterns.
• CRLF line endings corrupted output: files authored or checked out with
  Windows line endings had their fenced code blocks unmasked (imports and HTML
  inside code samples were stripped) and their descriptions mis-extracted (a
  heading-only file got the heading as description; a heading-less file got
  the entire document). readFile now normalizes CRLF/CR to LF.
• Root slug (slug: "/") crossed version subtrees: in multi-version
  mode, a section-root page linked to the current version's route (e.g.
  /docs) instead of its own version's (/stable/docs). Root-slug resolution
  now honors version and section scoping.
• siteConfig.url with a trailing slash produced //baseUrl in every
  generated URL, mismatching sitemap.xml.
• routeBasePath with a leading/trailing slash (e.g. '/docs') silently
  disabled route scoping for that section, falling every doc back to
  heuristic URLs. Slashes are now normalized.
• Blog detection misclassified sibling sections: any directory whose name
  merely started with the blog dir (e.g. a blog-api docs section next to
  blog) was treated as the blog for fallback URL construction.
• Code-fence samples containing import statements were rewritten: a
  fenced sample of an import line was resolved as a real partial import and
  spliced the partial's content into the code sample (or dropped the line when
  the target did not exist). Partial-import resolution now runs on fence-masked
  content.
• llms-full.txt flattened heading hierarchy: each document's inner
  ## Foo stayed at ##, colliding with the ## {title} document header, and
  the document's own title H1 appeared again under its header. Inner headings
  are now demoted one level under the document header, and the duplicate title
  heading is removed.
• Individual .md files duplicated their title and intro: the file header
  emitted # {title} plus the description blockquote, then the body repeated
  the identical H1 and (for pages whose description was auto-extracted from
  the first paragraph) the identical paragraph. Both duplicates are now
  stripped from the body.
• Triple blank lines in llms-full.txt: stripping a body's duplicate
  title heading left its surrounding blank lines behind. Gaps now collapse to
  a single blank line.
• Numeric frontmatter description dropped: an unquoted YAML number
  (description: 2024) was silently discarded instead of used as text; it is
  now coerced like title/slug/id.
• applyMdExtension mangled bare origins: a bare site URL would become
  https://site.com.md; the trailing slash is now preserved.

Added

• preserveComponents option: an array of MDX/JSX component names whose
  tags pass through untouched instead of being stripped, for components that
  render meaningful content themselves (e.g. a swizzled
  <PackageManagerTabs command="add my-package" />). Matching is exact on
  the component name, and tags inside code fences are still left alone.
  (#​64)
• CI workflow: the repository now runs build + unit + integration tests on
  Node 18/20/22 for every pull request and push to main.

Fixed

• Prop content lost in JSX stripping: the attribute-aware stripper
  (0.5.0) dropped non-children prop values wholesale, deleting content like
  the command inside <PackageManagerTabs command="..." />. Attribute values
  are now parsed and their text is preserved. (#​68,
  #​64)
• <TabItem> collapsed its label: <TabItem> tags now degrade to a
  readable outline instead of a bare body: the label (or value) is emitted
  as a bold line before the tab body. (#​64)
• Imported MDX page bodies silently dropped: only imports whose path
  contained _ or /partials/ were inlined; a normally-named .mdx page body
  imported as a component was stripped without its content. Every .mdx/.md
  import is now inlined, and imports using webpack-style aliases other than
  @site (e.g. @global/components/x.mdx) resolve against the site directory.
  Failed resolutions warn with the specifier and importing file. (#​65)
• Imports inside partial code fences stripped: when a partial was inlined,
  import lines inside its fenced code samples were removed. Code fences are
  masked before partial splicing, so samples survive verbatim. (#​69)
• Absolute slugs double-prefixed: a frontmatter slug starting with /
  was prefixed with the route base path again, producing URLs like
  .../docs/team-b/docs/faq.md. Absolute slugs are now used as-is. (#​63)
• Multiple docsDir entries collapsed to the first: with
  docsDir: ['docs', 'blog'], every page resolved to the first matching
  section, mis-routing pages and leaking blog URLs into docs output.
  Sections now resolve per-file, routes are scoped per-section, and the new
  blogDir/blogRouteBasePath options configure a blog alongside docs. (#​67)

Documentation

• README restructured into a full docs/ site: installation, configuration,
  output files, content cleaning, best practices, and per-feature guides. (#​61)
• Corrected the JSDoc default for generateMarkdownFiles. (#​62)
• New "Validating the deployed output" section in best practices. (#​66)

Thanks

This release exists because of its contributors. Thanks to everyone who
opened pull requests: adeelehsan,
AlexAdiaconitei,
anupamme, canuto,
deka0106, F-OBrien,
ilanazholobovsky,
kingsword09, Konkrad,
nicolasiscoding,
portdeveloper,
puehringer, scottamain,
smol-ninja, statico,
and svrnm.

Thanks to everyone who filed issues that shaped this release:
allxsmith, anvme,
benfoster, canuto,
critesjosh, ctauchen,
cyrusmith, dineshpinto,
emertechie, fflaten,
ilanazholobovsky,
johngrimes, manuelmeurer,
nicolasiscoding, PaulRBerg,
prdai, quangdusk,
Rajesh11082005, ratansen,
Rob-Purbrick, scottamain,
smol-ninja,
sujanmoi-kasm, thomhurst,
wparad, and yada.
If you reported a problem, tested a pre-release, or shared feedback along
the way, that work made 0.6.0 better. Thank you.

v0.5.1

Compare Source

Fixed

• Numeric frontmatter slug/id ignored: an unquoted numeric slug/id
  (YAML parses slug: 2025 as a number) is now coerced to a string, matching how
  Docusaurus routes it, so the .md is written at the correct route instead of a
  fallback filename. (#​58)
• baseUrl applied twice on disk: with a non-root baseUrl, individual
  .md files were written nested under the baseUrl segment, so their links
  404'd. The baseUrl path is now stripped before deriving the physical file
  location. (#​59)
• Compound numeric prefixes: ordering prefixes are now parsed like
  Docusaurus's DefaultNumberPrefixParser (e.g. 03--1.6.X → 1.6.X), and
  version-like names such as 7.0-foo are preserved. (#​59)
• Explicit frontmatter slug/id overridden by a coincidental route: an
  authoritative slug/id (including slug: "/") is now consulted before the
  filename-tail heuristic, so a root page no longer loses its route to an
  unrelated file. (#​59)

v0.5.0

Compare Source

Added

• Multi-version output via a new versions option. Generate a separate set
  of LLM files per documentation version, each written under its own
  subdirectory with links scoped to that version's routes. Accepts an explicit
  array of versions ({ name, label, docsDir, path, customLLMFiles, includeOrder })
  or 'auto' to detect them from Docusaurus docs versioning (versions.json +
  versioned_docs/). Omitting versions preserves the existing single-root
  behavior. Unset per-version fields fall back to the top-level options.

v0.4.0

Compare Source

What's New

• Append .md to llms.txt link URLs — Per the llmstxt.org spec, links in llms.txt now point to markdown versions of pages (e.g. /docs/intro.md instead of /docs/intro/). (#​38)
• Fix import/export in descriptions — .mdx files starting with import or export statements no longer use those lines as page descriptions. (#​39)
• Added test coverage for import/export description extraction fix. (#​40)

Breaking Change

addMdExtension defaults to true. All link URLs in generated llms.txt files will now have .md appended. To preserve the previous behavior, set addMdExtension: false in your plugin config.

Full Changelog: rachfop/docusaurus-plugin-llms@v0.3.1...v0.4.0

v0.3.1

Compare Source

Fixed

• [#​31] Doubled docs/docs/ paths when routeBasePath: '/' and docs live in a nested docs/ subdirectory
• [#​30] trailingSlash: true not reflected in generated URLs

Changed

• Replaced routeMap construction with suffix-based matching against Docusaurus's routesPaths, removing ~150 lines of production code and five edge-case helper functions
• pathTransformation is now only applied as a fallback when a file cannot be matched to a known Docusaurus route

v0.3.0

Compare Source

Fixed

Critical Bug Fixes (GitHub Issues)

• #​19 PluginOptions type compatibility with Docusaurus - Added index signature to resolve TypeScript errors (322f17a)
• #​23 YAML encoding for special characters and emojis - Added proper YAML.stringify options (adce852)
• #​25 includeOrder pattern matching - Now matches against both site-relative and docs-relative paths (14e21e5)
• #​15 Numbered prefix handling - Uses Docusaurus resolved routes before manual prefix removal (b28c6c9)

Data Integrity & Validation

• Strip UTF-8 BOM from markdown files to prevent parsing errors (1aa2f8a)
• Validate and handle empty frontmatter fields (d16ff49)
• Add type validation for frontmatter properties (54aa9a4)
• Add error handling for URL constructor to prevent crashes (e00fbfc)
• Add proper URL encoding for path segments (2629e6f)
• Escape regex special characters in ignorePath to prevent syntax errors (c1039ed)
• Prevent regex lastIndex state leakage in import detection (057f6ac)

Path & File Handling

• Improve filename sanitization to preserve valid characters (ebb89d8)
• Add path length validation and shortening for Windows compatibility (0a7e7f2)
• Handle whitespace-only strings in path operations (696e30d)
• Handle slugs with / as nested directory paths (ae371f1)
• Correct baseUrl concatenation logic (84c9a39)

Safety & Robustness

• Add bounds checking for array access to prevent undefined propagation (3cebd65, ff77b91)
• Add iteration limit to prevent infinite loops in path collision detection (61a859b)
• Add iteration limit to unique identifier generation (3248176)
• Standardize null/undefined handling patterns (1e24c75)
• Improve error type safety with unknown instead of any (d2894f3)
• Standardize empty collection handling with consistent logging (40846c5)

Performance & Scalability

• Add batch processing to prevent OOM on large sites (1000+ pages) (caa85a2)

Added

Features

• Configurable logging system for better debugging and quieter output (79dab0d)
• Comprehensive input validation utilities (112ad2c)
• Ignored files warning feature for better user feedback (c6559c1)

Documentation

• Add batch processing documentation to README (6df318b)
• Improve JSDoc documentation for normalizePath function (0e1b0d8)
• Add pattern matching documentation and examples (14e21e5)
• Add numbered prefix handling documentation (b28c6c9)

Changed

Code Quality Improvements

• Extract nested conditionals to helper functions (5e31591)
• Extract magic numbers to named constants and improve truncation (9d95f4b)

Testing

• Add integration test for plugin options validation (1db8a94, e690ffc)
• Add comprehensive filename sanitization tests (16de4d9)
• Add comprehensive Windows path normalization tests (4151051)
• Add YAML encoding test suite (adce852)
• Add pattern matching test suite with 8 scenarios (14e21e5)
• Add numbered prefix test suite (b28c6c9)
• Add URL encoding tests (2629e6f)
• Add URL error handling tests (e00fbfc)
• Add regex escaping tests (c1039ed)
• Add regex lastIndex tests (057f6ac)
• Add whitespace path tests (696e30d)
• Add unique identifier iteration limit tests (3248176)
• Add batch processing tests (caa85a2)
• Add input validation tests (112ad2c)
• Add BOM handling tests (1aa2f8a)
• Add path length validation tests (0a7e7f2)
• Add nested path tests (ae371f1)
• Add baseURL handling tests (84c9a39)
• Total: 300+ tests across 50 test files, all passing

Technical Details

This release focuses on stability, robustness, and addressing edge cases. Key improvements:

• Windows Compatibility: Path length validation, proper path normalization
• Large Site Support: Batch processing prevents OOM on sites with 1000+ pages
• Type Safety: Improved TypeScript types, proper error handling
• Input Validation: Comprehensive validation prevents crashes from invalid input
• Pattern Matching: Flexible pattern matching supports multiple path formats
• URL Handling: Robust URL construction with proper encoding and error handling
• Frontmatter Parsing: Handles special characters, emojis, and edge cases
• Code Quality: Reduced complexity, extracted helper functions, named constants

Breaking Changes

None. This release maintains backward compatibility with v0.2.x.

Migration Guide

No migration required. All changes are backward compatible.

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • "every weekend"
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.