chore(deps): update dependency vitepress-sidebar to v1.39.0

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
vitepress-sidebar (source)	1.36.1 → 1.39.0

---

Release Notes

jooy2/vitepress-sidebar (vitepress-sidebar)

v1.39.0

Compare Source

• useTitleFromFileHeading no longer reads a comment written inside the frontmatter as the heading of a page. A comment starts with #, exactly like an h1 does, so a line such as # https://vitepress.dev/reference/default-theme-home-page left at the top of a frontmatter became the title of the item. The frontmatter block is now removed before the content is read for a heading, and a file that holds no heading below it falls back to its file name, as it already did. The block is located by its delimiters, the way VitePress locates it, so it is removed even when what it holds is not valid YAML. (#​223)
• sortMenusByFrontmatterOrder now compares the order of the frontmatter as a number instead of as text, so a negative or a decimal value is placed where its value belongs. -2 no longer comes after -1, and 2.25 no longer comes after 2.5. The sorting relied on the numeric option of Intl.Collator, which is a natural sort of the digit runs inside a string and reads neither a leading - as a sign nor a . as a decimal point, so it only agreed with numeric order for small positive integers. Sorting by a file name or a title is unaffected, as it is still the natural sort that is wanted there. An order that does not read as a number now falls back to frontmatterOrderDefaultValue, as the documentation describes, instead of being sorted as NaN. (#​233)

v1.38.0

Compare Source

• Add sortMenusByCustomFunction option, which sorts the items of every folder with a function of your own, written in the form Array.prototype.sort expects. Each item being compared carries text, link, fileName, filePath, isDirectory, createDate, modifyDate and frontmatter, so an order can be decided from something the other options never read, such as a date kept in version control. The file times and the frontmatter are only read when the function accesses them. It decides the order of a whole folder by itself, so it cannot be used together with another sorting option, and a function cannot be written in JSON, so it is not available in a sidebar.config.json. (#​188)
• withSidebar now honors the srcExclude of the VitePress configuration, so a page that is excluded from the build no longer has to be excluded a second time to keep it out of the sidebar. Its patterns are resolved from documentRootPath, exactly like VitePress resolves them from srcDir, and are applied on top of excludeByGlobPattern and the other exclusion options rather than replacing them. Excluding a dynamic route template excludes every page it generates. generateSidebar is not given the VitePress configuration, so it cannot read srcExclude. (#​181)
• sortMenusOrderNumericallyFromLink now sorts a folder that has no link by its own path, instead of placing every such folder at one end of the list. Folders and files are ordered together by the number in their names even when the titles come from elsewhere, such as with useFolderTitleFromIndexFile and useTitleFromFileHeading. (#​183)

v1.37.0

Compare Source

• A sidebar.config.json file placed in any folder now configures that folder and everything below it. The options it declares take priority over the options passed to withSidebar or generateSidebar, and documentRootPath can be omitted when such a file exists. (#​166)
• The $folder key of a sidebar.config.json describes the folder it lives in (order, text, link) instead of its contents, and is not inherited by subfolders. A folder can now be ordered, named and linked without an index.md, and the position of a folder no longer depends on where its index.md sits inside it. (#​197)
• Add includeDynamicRoutes option, which shows a dynamic route as the pages it generates instead of as the template file it is generated from. A parameter may appear in a folder name as well, and both a .paths.ts file and an asynchronous paths() function are supported. (#​199)
• Add dynamicRouteTitleParam option, which names the route parameter that holds the sidebar title of a generated page. A title written as {{ $params.name }} in the template is resolved as well, and the order and date parameters are read by sortMenusByFrontmatterOrder and sortMenusByFrontmatterDate.
• Sorting options are no longer overwritten by the folders above them.

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • At any time (no schedule defined)
• 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.

[Copilot]

Copilot wasn't able to review any files in this pull request.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.