fix(deps): update dependency vitepress to v2.0.0-alpha.19

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
vitepress (source)	2.0.0-alpha.12 → 2.0.0-alpha.19

---

Release Notes

vuejs/vitepress (vitepress)

v2.0.0-alpha.19

Compare Source

Bug Fixes

• build: apply rewrites when computing createContentLoader urls (9e2148d)
• build: clear markdown cache with rewritten path on include change (5eac447), closes #​5035
• build: compose markdown preConfig hook when extending configs (c39a85a), closes #​5205
• build: don't apply docsearch css transform to pages matching its filter (fa0e48c)
• build: don't rely on checkout directory name when externalizing types (e6ba9d8)
• build: report links to pre-rewrite paths of rewritten pages as dead (3cf3f37)
• build: resolve additional configs by source path (5e4a9e7)
• build: resolve rewrites against externally injected pages too (769c10e)
• build: respect cleanUrls in content loader render (027f046), closes #​4331 #​5299
• build: track include importers by module id (c961655)
• build: prevent duplicate IDs in MiniSearch (#​5303) (505278c)
• build: remove stackTraceLimit Infinity for DEBUG (#​5318) (865d04b)
• build: retry file reads when out of file descriptors (da71173)
• cli: avoid onAfterConfigResolve (3fbaf9c)
• client: make the route the single source of truth for the URL hash (dcb7a75)
• markdown: preserve user-defined attributes (3f4530b), closes #​5123
• markdown: remove extra whitespace from container markup (b6d9cb8)
• markdown: skip circular includes (3372516)
• markdown: remove deprecated cjkFriendly option (27762ea)
• markdown: rename image option lazyLoading to lazyLoad (078786a)
• search: index changed files with srcDir-relative paths in dev (6b64f35), closes #​3374
• search: only index pages on dev updates (559fb24)
• search: serve a fresh search index after dev updates (1534a67)
• search: skip pages that fail to render instead of crashing dev server (3ffefa2)
• theme: use ul and li for lists (#​5326) (3f99872)
• theme: align docsearch breakpoints with the default theme (90c28d4), closes #​5213
• theme: align local search breakpoint (#​5217) (a425113)
• theme: correct anchor scroll margins across viewports (dabc5e9)
• theme: ensure outline marker follows click (#​3879) (31287c0)
• theme: external link icon not showing in navbar links (225c94a), closes #​5306
• theme: pass target and rel to prev/next page links (#​5297) (6b5e770)
• theme: preserve url params when switching languages (#​5312) (9ee401d)
• theme: prevent TypeError when navigating to page without outline (#​5329) (9376c58)
• theme: remove font-synthesis style (#​5309) (c34769c)
• theme: safari not showing external link icon properly (7118402)
• theme: rebuild the base styles on tailwind's preflight (f1ee913)
• theme: route cjk punctuation to matching system fonts (91b06b6)
• theme: remove deprecated disableDetailedView local search option (cec4998)
• theme: remove deprecated lastUpdatedText option (18d1b47)
• theme: remove deprecated outlineTitle option (95c0420)
• types: declare Badge as a global component (ca8ba5b)
• types: import EnhanceAppContext from package entry in theme.d.ts (8ff1f3e), closes #​5156

Features

• add web-types.json for JetBrains IDE support (1d448c9), closes #​5157
• auto-add width/height to local images to avoid layout shift (#​5311) (3868b64)
• client: declare $frontmatter and $params as ComponentCustomProperties (0535009)
• client: declare Content and ClientOnly components as GlobalComponents (#​5156) (6629577), closes #​5154
• cli: show vite version in startup log (#​5328) (4666fc2)
• enable metaChunk by default (#​5325) (8e42f31)
• init: use async fs in scaffolding (38b59f9)
• markdown: accept booleans for plugin options (c2be0bf)
• markdown: add region marker engine (b303dd3)
• markdown: allow disabling table tabindex attribute (bffe1e1)
• markdown: support disabling built-in markdown plugins (b8d9c8f), closes #​4484 #​4556
• markdown: support footnotes (430a890)
• markdown: support GitHub-style task lists (97f8781), closes #​413 #​1923 #​3648 #​5110
• markdown: support per-locale markdown strings (faaa4a1), closes #​4431
• markdown: support registering custom containers (962f00e), closes #​3591 #​3603 #​4228
• markdown: support title-less containers (4c7a030), closes #​4928 #​4932 #​4929
• markdown: rebase relative urls in included files (6a337ef)
• markdown: group code copy button strings into one option (2fa0ded), closes #​4431
• markdown: replace markdown-it-attrs with @​mdit/plugin-attrs (18380b0)
• markdown: replace markdown-it-emoji with @​mdit/plugin-emoji (018887f)
• markdown: replace markdown-it-anchor with @​mdit/plugin-anchor (7550517)
• markdown: support attrs: false for disabling attrs plugin (e235dbe)
• markdown: support note, important, caution markdown containers (#​5161) (3b560a0), closes #​4427 #​3928
• theme: allow internal social links (51ff681), closes #​5305
• theme: cover all Inter glyphs, generate font subsets from a script (705c1be)
• update option stability annotations (ab1896f)

Performance Improvements

• build: reuse lastUpdated from markdown rendering in sitemap generation (fdd68e3)
• md: bypass gray-matter's unbounded cache (4f8703d)
• md: limit the compile cache's memory usage (2fb6bda)
• use hook filters in vite plugins (fa24c6d)

Reverts

• Revert "fix: prevent DocSearch SVG clipping in WebKit" (#​5304) (c8313a4), closes #​5304 #​5240

BREAKING CHANGES

• markdown.anchor options are now typed by @mdit/plugin-anchor. Common options (level, slugify, permalink, getTokensText, tabIndex, etc.) are unchanged, but the deprecated markdown-it-anchor permalink options (permalinkSymbol, renderPermalink, ...) are no longer accepted. Permalink builders like headerLink are named exports of @mdit/plugin-anchor instead of properties of the plugin.

• markdown.attrs options are now typed by @mdit/plugin-attrs: leftDelimiter, rightDelimiter, and allowedAttributes are renamed to left, right, and allowed. A rule option is available for toggling individual attribute rules (VitePress disables fence by default).

• markdown.codeCopyButtonTitle is now markdown.codeCopyButton.tooltipText, and its default changed from "Copy Code" to "Copy code". The --vp-code-copy-copied-text-content CSS variable and its built-in per-language :lang() defaults are removed - set codeCopyButton.copiedText (per locale) instead.

• useData().hash has been removed. Read the hash from useRoute() instead.

• callers of vitepress' build() will now notice the version banner gets printed. To disable that, pass a noop function:

  build(root, {
    onAfterConfigResolve() {}
  })

• custom themeConfig.i18nRouting functions now receive the current Route as their second argument instead of the hash

• normalize-level defaults differ from the old reset - native select and number-input chrome is restored, headings inherit font size and weight, the hidden attribute is enforced with !important, and every element starts with zero margin/padding and border-style: solid. Sites layering custom CSS on the default theme may notice.

• relative urls in included markdown files resolve against the included file rather than the including page. Partials written for one specific location may need their links updated, or markdown.include.rebaseRelativeUrls set to false to keep resolving them from the including page. Absolute and external urls are unaffected. Note that the marker comments shift the line numbers reported for dead links following an include, which already pointed into the include-expanded source rather than the original file.

• init: scaffold() now returns a Promise<string> and must be awaited.

• The defs property of markdown.emoji has been renamed to definitions.

• The markdown.attrs.disable option has been removed. Set markdown.attrs to false instead.

• The markdown.image.lazyLoading option has been renamed to markdown.image.lazyLoad.

• The deprecated disableDetailedView option of local search has been removed. Use detailedView: false instead.

• The deprecated markdown.cjkFriendly option has been removed. Use markdown.cjkFriendlyEmphasis instead.

• The deprecated themeConfig.lastUpdatedText option has been removed. Use themeConfig.lastUpdated.text instead.

• The deprecated themeConfig.outlineTitle option has been removed. Use themeConfig.outline.label instead.

• The Inter4CJK font family has been renamed to 'Inter Core'. Custom --vp-font-family-base overrides referencing Inter4CJK must be updated.

v2.0.0-alpha.18

Compare Source

Bug Fixes

• build: apply base to links with download attribute (#​5186) (01987c4)
• build: normalize rewrite drive letters (#​5245) (5c50b99)
• build: show dead link line numbers (#​5230) (c37bde6)
• compose markdown config when extending configs (#​5236) (04f4fba)
• delete undefined values while merging sidepanel props (cc30b10)
• disable pluginTimings and invalidAnnotation for now (9315fc1)
• don't invalidate framework chunk when a new asset is added (c0e2e18)
• escape description in head (d96bf1d)
• index rewritten local search pages by locale (#​5241) (80cf265)
• keep translation links in the current tab (#​5158) (202ee70)
• normalize /index to / (856858d), closes #​5165
• preserve Agent Studio DocSearch options (#​5254) (f29ffdb)
• preserve external sidebar links with base (#​5243) (ddf178a)
• prevent DocSearch SVG clipping in WebKit (#​5240) (a357e5e)
• strip frontmatter before heading includes (#​5246) (e68fade)
• theme: avatars misaligned in team member cards (6730fb8), closes #​5160
• theme: correct mixed LTR/RTL text rendering in code blocks (73f7b0b)
• theme: keep external link icon inline (#​5232) (756a88c)
• theme: prevent sub and sup elements from affecting line height (19357f9), closes #​5173
• use resolveDynamicComponent instead of resolveComponent (9da1e3e)

Features

• add macOS local search navigation shortcuts (#​5237) (e635e9e)
• add support for format option in Carbon options (#​5188) (6ee01bf)
• allow custom i18n routing (#​5239) (eef5742)
• allow VPContent to use custom components (#​5176) (c0b38d5)
• markdown: expose Shiki color replacements in markdown options (#​5153) (fccc617)
• migrate to vite 8 (228eef1)
• show local search loading state (#​5252) (7e2273a)
• support scroll-margin / scroll-padding (6cce766)
• support social link target option (#​5242) (d0159c8)

BREAKING CHANGES

• VitePress now uses Vite 8. If you are using Vite plugins in your config, please check the Vite 8 migration guide for any breaking changes that may affect you.
• Node 20 support is dropped. v22 or higher is needed.
• scrollOffset from config is removed. Users wanting to customize scroll offset should customize scroll-margin-top via CSS instead. smoothScroll support from router.go is also removed as it didn't work as expected for most users. Users wanting smooth scrolling should set scroll-behavior: smooth in CSS, ideally inside a @media (prefers-reduced-motion: no-preference) block.

v2.0.0-alpha.17

Compare Source

Bug Fixes

• build: processIncludes no longer swallows errors (fb21fdf)
• build: deterministic local search indexing and non-blocking initial scan (closes #​4081) (fc0f203)
• client: await clipboard.writeText so that fallback works in non-secure contexts (#​5119) (b544df8)
• disable brotli compression in preview server (ca1e875)
• theme: add rel="alternate" and hreflang to links in language menu (#​5108) (f09593b)
• theme: add margin to images in vp-doc (closes #​5136) (896e49a)
• theme: close sidebar on resize (closes #​5145) (17696c3)
• theme: disable text autospace in <pre> (closes #​5115) (21a5fb6)
• theme: enable line-break: strict for <li> too (f811d58)
• theme: keep pnum,tnum features in Inter (f1bef95), closes #​5096
• theme: navbar menu group is incorrectly highlighted (#​5113) (b28667b)
• theme: strip system-ui from font-family-base (#​4988) (8096eac)

Features

• theme: add home-hero-actions-before-actions slot (#​5151) (74a73d8)
• support text-fragments (#​5140) (44e2675)
• theme: add Japanese translation for "copied" label (#​5106) (a01bba0)
• theme: enable text-autospace and text-spacing-trim (closes #​4996) (d7effff)
• theme: support specifying list of details in home page features (closes #​5101) (3146ce4)

BREAKING CHANGES

Previously, the <!-- @&#8203;include: ./path/to/file --> syntax silently ignored errors when files did not exist. This behavior was originally intended as an escape hatch while documenting includes, but better solutions now exist using Shiki transformers.

For most users, no code changes are required. If you now see errors, it means your includes are broken and were earlier not being reported.

Users who intentionally reference non-existent files or want to document includes without resolving them can configure markdown.codeTransformers with a postprocess hook. See docs/.vitepress/config.ts in this repo for an example.

v2.0.0-alpha.16

Compare Source

Bug Fixes

• always log error when failed to fetch page (66cf64e)
• theme: add fallback for heroImageSlotExists (#​5076) (f119b18)
• theme: align badges in h1 and h2 (#​5087) (closes #​5063) (b200865)
• theme: highlight active link in mobile nav menu (#​5086) (closes #​5068, closes #​5074) (923aa90)
• theme: overflow clip is buggy on safari (8ed6ea0), closes #​5050 #​5039 #​5027
• theme: remove margin between code groups and blocks in markdown containers (a28e171), closes #​5099

Features

• theme: upgrade DocSearch to 4.5 with sidepanel (#​5092) (0d646a6)
• theme: use @layer __vitepress_base to wrap the styles in base.css (#​4905) (f8d8c0d)

v2.0.0-alpha.15

Compare Source

Bug Fixes

• theme: navbar overflowing on mobile devices (06f0e1a), closes #​5039

v2.0.0-alpha.14

Compare Source

Bug Fixes

• log dead links in dev mode too (179ee62), closes #​4419
• theme: sidebar alignment when scrollbar is there on page (0ee7158), closes #​5027

Features

• client: emit vitepress:codeGroupTabActivate custom event when a code group tab is activated (dfb02a4), closes #​5023

v2.0.0-alpha.13

Compare Source

Bug Fixes

• client,a11y: improve focus handling and scrolling behavior in router (#​4943) (d46107f)
• disable markdown-it-attrs for fenced code blocks (0899618)
• git log parsing when there are empty commits in history (#​4965) (612c458)
• print full path in dead links check (2b77fb3), closes #​4919
• rename markdown.cjkFriendly to markdown.cjkFriendlyEmphasis (bce0b53), closes #​4952
• respect markdown.cache = false on build too (6d7422f)
• simplify lang extraction logic; use markdown-it plugins in type-safe manner; bump deps (4e548f5)
• theme: add lang and dir attributes to language picker (f0b29d7)
• theme: adjust margin of code blocks inside containers (82fac5d), closes #​4921
• theme: avoid use of :where in selector list for now (c2eaccd), closes #​4923
• theme: disable whitespace wrapping for VPBadge (#​4968) (113d230)
• theme: use nav height css var for curtain top in sidebar (#​4993) (be260fd)

Features

• export cacheAllGitTimestamps and getGitTimestamp (31d87e2)
• i18n,a11y: change last update logic (#​4935) (187bf25)
• markdown: support custom display-name for fenced code blocks (#​4960) (3d61619)
• prevent $ symbol selection in shell code (#​5025) (bf2715e)
• theme: allow passing functions for nav links (#​4963) (34cfa91)

Performance Improvements

• make a single git call for timestamps instead of calling it for each file (#​4958) (6dfcdd3)

BREAKING CHANGES

• markdown-it-attrs is disabled for fenced code blocks. For most users no change is required. If you want to add classes to code blocks, do it using shiki transformers instead.
• Rename cjkFriendly to cjkFriendlyEmphasis in your vitepress config. Most people should be unaffected unless they want to disable the CJK emphasis behavior added v2.0.0-alpha.12.

---

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.

[netlify]

✅ Deploy Preview for winjs-docs ready!

Name	Link
🔨 Latest commit	34447fb
🔍 Latest deploy log	https://app.netlify.com/projects/winjs-docs/deploys/6a6ed55a420b9b000ae56f56
😎 Deploy Preview	https://deploy-preview-53--winjs-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.