vitepress 2.0.0-alpha.2 → 2.0.0-alpha.21

package/dist/client/theme-default/styles/icons.css

@@ -1,6 +1,9 @@
 [class^='vpi-'],
 [class*=' vpi-'],
 .vp-icon {
+  /* an unresolved icon masks to nothing instead of a currentColor box */
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg'/%3E");
+  display: inline-block;
   width: 1em;
   height: 1em;
 }
@@ -22,72 +25,89 @@
 }
 
 /* internal icons - used under ISC from https://lucide.dev/ */
-.vpi-align-left {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M21 6H3M15 12H3M17 18H3'/%3E%3C/svg%3E");
+.vpi-text-align-start {
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M21 5H3m12 7H3m14 7H3'/%3E%3C/svg%3E");
 }
 .vpi-arrow-right,
 .vpi-arrow-down,
 .vpi-arrow-left,
 .vpi-arrow-up {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M5 12h14M12 5l7 7-7 7'/%3E%3C/svg%3E");
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M5 12h14m-7-7l7 7l-7 7'/%3E%3C/svg%3E");
 }
 .vpi-chevron-right,
 .vpi-chevron-down,
 .vpi-chevron-left,
 .vpi-chevron-up {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='m9 18 6-6-6-6'/%3E%3C/svg%3E");
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='m9 18l6-6l-6-6'/%3E%3C/svg%3E");
 }
 .vpi-chevron-down,
 .vpi-arrow-down {
-  /*rtl:ignore*/
   transform: rotate(90deg);
 }
 .vpi-chevron-left,
 .vpi-arrow-left {
-  /*rtl:ignore*/
   transform: rotate(180deg);
 }
 .vpi-chevron-up,
 .vpi-arrow-up {
-  /*rtl:ignore*/
   transform: rotate(-90deg);
 }
+/* these point along the reading direction ("right" means forward), so they
+   mirror in rtl; the vertical variants and the key glyphs stay put */
+.vpi-text-align-start,
+.vpi-arrow-left,
+.vpi-arrow-right,
+.vpi-chevron-left,
+.vpi-chevron-right {
+  scale: var(--vp-direction-multiplier) 1;
+}
 .vpi-square-pen {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M12 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7'/%3E%3Cpath d='M18.375 2.625a2.121 2.121 0 1 1 3 3L12 15l-4 1 1-4Z'/%3E%3C/svg%3E");
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cg fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2'%3E%3Cpath d='M12 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7'/%3E%3Cpath d='M18.375 2.625a1 1 0 0 1 3 3l-9.013 9.014a2 2 0 0 1-.853.505l-2.873.84a.5.5 0 0 1-.62-.62l.84-2.873a2 2 0 0 1 .506-.852z'/%3E%3C/g%3E%3C/svg%3E");
 }
 .vpi-plus {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M5 12h14M12 5v14'/%3E%3C/svg%3E");
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M5 12h14m-7-7v14'/%3E%3C/svg%3E");
 }
 .vpi-sun {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Ccircle cx='12' cy='12' r='4'/%3E%3Cpath d='M12 2v2M12 20v2M4.93 4.93l1.41 1.41M17.66 17.66l1.41 1.41M2 12h2M20 12h2M6.34 17.66l-1.41 1.41M19.07 4.93l-1.41 1.41'/%3E%3C/svg%3E");
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cg fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2'%3E%3Ccircle cx='12' cy='12' r='4'/%3E%3Cpath d='M12 2v2m0 16v2M4.93 4.93l1.41 1.41m11.32 11.32l1.41 1.41M2 12h2m16 0h2M6.34 17.66l-1.41 1.41M19.07 4.93l-1.41 1.41'/%3E%3C/g%3E%3C/svg%3E");
 }
 .vpi-moon {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z'/%3E%3C/svg%3E");
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401'/%3E%3C/svg%3E");
 }
-.vpi-more-horizontal {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Ccircle cx='12' cy='12' r='1'/%3E%3Ccircle cx='19' cy='12' r='1'/%3E%3Ccircle cx='5' cy='12' r='1'/%3E%3C/svg%3E");
+.vpi-ellipsis {
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cg fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2'%3E%3Ccircle cx='12' cy='12' r='1'/%3E%3Ccircle cx='19' cy='12' r='1'/%3E%3Ccircle cx='5' cy='12' r='1'/%3E%3C/g%3E%3C/svg%3E");
 }
 .vpi-languages {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='m5 8 6 6M4 14l6-6 2-3M2 5h12M7 2h1M22 22l-5-10-5 10M14 18h6'/%3E%3C/svg%3E");
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='m5 8l6 6m-7 0l6-6l2-3M2 5h12M7 2h1m14 20l-5-10l-5 10m2-4h6'/%3E%3C/svg%3E");
 }
 .vpi-heart {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M19 14c1.49-1.46 3-3.21 3-5.5A5.5 5.5 0 0 0 16.5 3c-1.76 0-3 .5-4.5 2-1.5-1.5-2.74-2-4.5-2A5.5 5.5 0 0 0 2 8.5c0 2.3 1.5 4.05 3 5.5l7 7Z'/%3E%3C/svg%3E");
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 9.5a5.5 5.5 0 0 1 9.591-3.676a.56.56 0 0 0 .818 0A5.49 5.49 0 0 1 22 9.5c0 2.29-1.5 4-3 5.5l-5.492 5.313a2 2 0 0 1-3 .019L5 15c-1.5-1.5-3-3.2-3-5.5'/%3E%3C/svg%3E");
 }
 .vpi-search {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cpath d='m21 21-4.3-4.3'/%3E%3C/svg%3E");
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cg fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2'%3E%3Cpath d='m21 21l-4.34-4.34'/%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3C/g%3E%3C/svg%3E");
+}
+.vpi-sparkles {
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cg fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='1.8'%3E%3Cpath d='M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594zM20 2v4m2-2h-4'/%3E%3Ccircle cx='4' cy='20' r='2'/%3E%3C/g%3E%3C/svg%3E");
 }
 .vpi-layout-list {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Crect width='7' height='7' x='3' y='3' rx='1'/%3E%3Crect width='7' height='7' x='3' y='14' rx='1'/%3E%3Cpath d='M14 4h7M14 9h7M14 15h7M14 20h7'/%3E%3C/svg%3E");
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cg fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2'%3E%3Crect width='7' height='7' x='3' y='3' rx='1'/%3E%3Crect width='7' height='7' x='3' y='14' rx='1'/%3E%3Cpath d='M14 4h7m-7 5h7m-7 6h7m-7 5h7'/%3E%3C/g%3E%3C/svg%3E");
 }
 .vpi-delete {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M20 5H9l-7 7 7 7h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2ZM18 9l-6 6M12 9l6 6'/%3E%3C/svg%3E");
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M10 5a2 2 0 0 0-1.344.519l-6.328 5.74a1 1 0 0 0 0 1.481l6.328 5.741A2 2 0 0 0 10 19h10a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2zm2 4l6 6m0-6l-6 6'/%3E%3C/svg%3E");
 }
 .vpi-corner-down-left {
-  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='m9 10-5 5 5 5'/%3E%3Cpath d='M20 4v7a4 4 0 0 1-4 4H4'/%3E%3C/svg%3E");
+  --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cg fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2'%3E%3Cpath d='M20 4v7a4 4 0 0 1-4 4H4'/%3E%3Cpath d='m9 10l-5 5l5 5'/%3E%3C/g%3E%3C/svg%3E");
 }
 :root {
   /* clipboard */
-  --vp-icon-copy: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='rgba(128,128,128,1)' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Crect width='8' height='4' x='8' y='2' rx='1' ry='1'/%3E%3Cpath d='M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2'/%3E%3C/svg%3E");
-  /* clipboard-copy */
-  --vp-icon-copied: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='rgba(128,128,128,1)' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Crect width='8' height='4' x='8' y='2' rx='1' ry='1'/%3E%3Cpath d='M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2'/%3E%3Cpath d='m9 14 2 2 4-4'/%3E%3C/svg%3E");
+  --vp-icon-copy: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cg fill='none' stroke='rgba(128,128,128,1)' stroke-linecap='round' stroke-linejoin='round' stroke-width='2'%3E%3Crect width='8' height='4' x='8' y='2' rx='1' ry='1'/%3E%3Cpath d='M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2'/%3E%3C/g%3E%3C/svg%3E");
+  /* clipboard-check */
+  --vp-icon-copied: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cg fill='none' stroke='rgba(128,128,128,1)' stroke-linecap='round' stroke-linejoin='round' stroke-width='2'%3E%3Crect width='8' height='4' x='8' y='2' rx='1' ry='1'/%3E%3Cpath d='M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2'/%3E%3Cpath d='m9 14l2 2l4-4'/%3E%3C/g%3E%3C/svg%3E");
+}
+
+:root,
+[dir='ltr'] {
+  --vp-icon-external-link: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' %3E%3Cpath fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M9 5h10v10M19 5 5 19'/%3E%3C/svg%3E");
+}
+[dir='rtl'] {
+  --vp-icon-external-link: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' %3E%3Cpath fill='none' stroke='black' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M5 15V5h10M5 5l14 14'/%3E%3C/svg%3E");
 }

package/dist/client/theme-default/styles/vars.css

@@ -69,6 +69,11 @@
   --vp-c-yellow-3: #9f6a00;
   --vp-c-yellow-soft: rgba(234, 179, 8, 0.14);
 
+  --vp-c-orange-1: #9a4224;
+  --vp-c-orange-2: #b95a00;
+  --vp-c-orange-3: #c16200;
+  --vp-c-orange-soft: rgba(249, 115, 22, 0.14);
+
   --vp-c-red-1: #b8272c;
   --vp-c-red-2: #d5393e;
   --vp-c-red-3: #e0575b;
@@ -103,6 +108,11 @@
   --vp-c-yellow-3: #a46a0a;
   --vp-c-yellow-soft: rgba(234, 179, 8, 0.16);
 
+  --vp-c-orange-1: #fb8c00;
+  --vp-c-orange-2: #e46a02;
+  --vp-c-orange-3: #b45309;
+  --vp-c-orange-soft: rgba(249, 115, 22, 0.16);
+
   --vp-c-red-1: #f66f81;
   --vp-c-red-2: #f14158;
   --vp-c-red-3: #b62a3c;
@@ -256,22 +266,42 @@
   --vp-c-caution-soft: var(--vp-c-red-soft);
 }
 
+:root:where(:has(.vp-graded-containers)) {
+  --vp-c-warning-1: var(--vp-c-orange-1);
+  --vp-c-warning-2: var(--vp-c-orange-2);
+  --vp-c-warning-3: var(--vp-c-orange-3);
+  --vp-c-warning-soft: var(--vp-c-orange-soft);
+
+  --vp-c-caution-1: var(--vp-c-yellow-1);
+  --vp-c-caution-2: var(--vp-c-yellow-2);
+  --vp-c-caution-3: var(--vp-c-yellow-3);
+  --vp-c-caution-soft: var(--vp-c-yellow-soft);
+}
+
 /**
  * Typography
  * -------------------------------------------------------------------------- */
 
 :root {
-  --vp-font-family-base: 'Inter', ui-sans-serif, system-ui, sans-serif,
-    'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';
-  --vp-font-family-mono: ui-monospace, 'Menlo', 'Monaco', 'Consolas',
-    'Liberation Mono', 'Courier New', monospace;
-  font-optical-sizing: auto;
-}
-
-:root:where(:lang(zh)) {
-  --vp-font-family-base: 'Punctuation SC', 'Inter', ui-sans-serif, system-ui,
-    sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol',
-    'Noto Color Emoji';
+  --vp-font-family-base:
+    -apple-system, BlinkMacSystemFont, sans-serif, 'Apple Color Emoji',
+    'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';
+  --vp-font-family-mono:
+    ui-monospace, 'Menlo', 'Monaco', 'Consolas', 'Liberation Mono',
+    'Courier New', monospace;
+}
+
+[lang]:where(:lang(zh), :lang(ja), :lang(ko)) {
+  h1,
+  h2,
+  h3,
+  h4,
+  h5,
+  h6,
+  li,
+  p {
+    line-break: strict;
+  }
 }
 
 /**
@@ -283,7 +313,8 @@
   --vp-shadow-2: 0 3px 12px rgba(0, 0, 0, 0.07), 0 1px 4px rgba(0, 0, 0, 0.07);
   --vp-shadow-3: 0 12px 32px rgba(0, 0, 0, 0.1), 0 2px 6px rgba(0, 0, 0, 0.08);
   --vp-shadow-4: 0 14px 44px rgba(0, 0, 0, 0.12), 0 3px 9px rgba(0, 0, 0, 0.12);
-  --vp-shadow-5: 0 18px 56px rgba(0, 0, 0, 0.16), 0 4px 12px rgba(0, 0, 0, 0.16);
+  --vp-shadow-5:
+    0 18px 56px rgba(0, 0, 0, 0.16), 0 4px 12px rgba(0, 0, 0, 0.16);
 }
 
 /**
@@ -299,18 +330,33 @@
   --vp-z-index-sidebar: 60;
 }
 
-@media (min-width: 960px) {
+@media (min-width: 60rem) {
   :root {
     --vp-z-index-sidebar: 25;
   }
 }
 
+/**
+ * Direction
+ * -------------------------------------------------------------------------- */
+
+:root,
+[dir='ltr'] {
+  --vp-direction-multiplier: 1;
+  --vp-direction-mark: '\200E';
+}
+
+[dir='rtl'] {
+  --vp-direction-multiplier: -1;
+  --vp-direction-mark: '\200F';
+}
+
 /**
  * Layouts
  * -------------------------------------------------------------------------- */
 
 :root {
-  --vp-layout-max-width: 1440px;
+  --vp-layout-max-width: 90rem;
 }
 
 /**
@@ -337,10 +383,10 @@
   --vp-code-block-bg: var(--vp-c-bg-alt);
   --vp-code-block-divider-color: var(--vp-c-gutter);
 
-  --vp-code-lang-color: var(--vp-c-text-3);
+  --vp-code-lang-color: var(--vp-c-text-2);
 
   --vp-code-line-highlight-color: var(--vp-c-default-soft);
-  --vp-code-line-number-color: var(--vp-c-text-3);
+  --vp-code-line-number-color: var(--vp-c-text-2);
 
   --vp-code-line-diff-add-color: var(--vp-c-success-soft);
   --vp-code-line-diff-add-symbol-color: var(--vp-c-success-1);
@@ -356,7 +402,6 @@
   --vp-code-copy-code-hover-border-color: var(--vp-c-divider);
   --vp-code-copy-code-hover-bg: var(--vp-c-bg);
   --vp-code-copy-code-active-text: var(--vp-c-text-2);
-  --vp-code-copy-copied-text-content: 'Copied';
 
   --vp-code-tab-divider: var(--vp-code-block-divider-color);
   --vp-code-tab-text-color: var(--vp-c-text-2);
@@ -366,23 +411,6 @@
   --vp-code-tab-active-bar-color: var(--vp-c-brand-1);
 }
 
-:lang(es),
-:lang(pt) {
-  --vp-code-copy-copied-text-content: 'Copiado';
-}
-:lang(fa) {
-  --vp-code-copy-copied-text-content: 'کپی شد';
-}
-:lang(ko) {
-  --vp-code-copy-copied-text-content: '복사됨';
-}
-:lang(ru) {
-  --vp-code-copy-copied-text-content: 'Скопировано';
-}
-:lang(zh) {
-  --vp-code-copy-copied-text-content: '已复制';
-}
-
 /**
  * Component: Button
  * -------------------------------------------------------------------------- */
@@ -424,8 +452,8 @@
  * -------------------------------------------------------------------------- */
 
 :root {
-  --vp-custom-block-font-size: 14px;
-  --vp-custom-block-code-font-size: 13px;
+  --vp-custom-block-font-size: 0.875rem;
+  --vp-custom-block-code-font-size: 0.8125rem;
 
   --vp-custom-block-info-border: transparent;
   --vp-custom-block-info-text: var(--vp-c-text-1);
@@ -447,6 +475,11 @@
   --vp-custom-block-important-bg: var(--vp-c-important-soft);
   --vp-custom-block-important-code-bg: var(--vp-c-important-soft);
 
+  --vp-custom-block-caution-border: transparent;
+  --vp-custom-block-caution-text: var(--vp-c-text-1);
+  --vp-custom-block-caution-bg: var(--vp-c-caution-soft);
+  --vp-custom-block-caution-code-bg: var(--vp-c-caution-soft);
+
   --vp-custom-block-warning-border: transparent;
   --vp-custom-block-warning-text: var(--vp-c-text-1);
   --vp-custom-block-warning-bg: var(--vp-c-warning-soft);
@@ -457,11 +490,6 @@
   --vp-custom-block-danger-bg: var(--vp-c-danger-soft);
   --vp-custom-block-danger-code-bg: var(--vp-c-danger-soft);
 
-  --vp-custom-block-caution-border: transparent;
-  --vp-custom-block-caution-text: var(--vp-c-text-1);
-  --vp-custom-block-caution-bg: var(--vp-c-caution-soft);
-  --vp-custom-block-caution-code-bg: var(--vp-c-caution-soft);
-
   --vp-custom-block-details-border: var(--vp-custom-block-info-border);
   --vp-custom-block-details-text: var(--vp-custom-block-info-text);
   --vp-custom-block-details-bg: var(--vp-custom-block-info-bg);
@@ -484,10 +512,24 @@
  * -------------------------------------------------------------------------- */
 
 :root {
-  --vp-nav-height: 64px;
+  --vp-nav-height: 4rem;
   --vp-nav-bg-color: var(--vp-c-bg);
+
+  /**
+   * Background while on top of the home page (unscrolled). Set it to
+   * var(--vp-nav-bg-color) to opt out of the transparent treatment.
+   */
+  --vp-nav-home-bg-color: transparent;
+
+  /**
+   * Applied to the navbar surface, e.g. `saturate(180%) blur(8px)` combined
+   * with a translucent --vp-nav-bg-color for a frosted-glass bar.
+   */
+  --vp-nav-backdrop-filter: none;
+
+  --vp-nav-divider-color: var(--vp-c-gutter);
   --vp-nav-screen-bg-color: var(--vp-c-bg);
-  --vp-nav-logo-height: 24px;
+  --vp-nav-logo-height: 1.5rem;
 }
 
 .hide-nav {
@@ -495,7 +537,7 @@
 }
 
 .hide-nav .VPSidebar {
-  --vp-nav-height: 22px;
+  --vp-nav-height: 1.375rem;
 }
 
 /**
@@ -503,7 +545,18 @@
  * -------------------------------------------------------------------------- */
 
 :root {
-  --vp-local-nav-bg-color: var(--vp-c-bg);
+  /**
+   * Follows the navbar surface by default, so a translucent
+   * --vp-nav-bg-color with --vp-nav-backdrop-filter extends the
+   * frosted-glass treatment to the local nav as well.
+   */
+  --vp-local-nav-bg-color: var(--vp-nav-bg-color);
+
+  /**
+   * The local nav's bottom rule. Follows the navbar's divider color by
+   * default.
+   */
+  --vp-local-nav-divider-color: var(--vp-nav-divider-color);
 }
 
 /**
@@ -511,7 +564,7 @@
  * -------------------------------------------------------------------------- */
 
 :root {
-  --vp-sidebar-width: 272px;
+  --vp-sidebar-width: 17rem;
   --vp-sidebar-bg-color: var(--vp-c-bg-alt);
 }
 
@@ -544,10 +597,22 @@
   --vp-badge-info-text: var(--vp-c-text-2);
   --vp-badge-info-bg: var(--vp-c-default-soft);
 
+  --vp-badge-note-border: transparent;
+  --vp-badge-note-text: var(--vp-c-note-1);
+  --vp-badge-note-bg: var(--vp-c-note-soft);
+
   --vp-badge-tip-border: transparent;
   --vp-badge-tip-text: var(--vp-c-tip-1);
   --vp-badge-tip-bg: var(--vp-c-tip-soft);
 
+  --vp-badge-important-border: transparent;
+  --vp-badge-important-text: var(--vp-c-important-1);
+  --vp-badge-important-bg: var(--vp-c-important-soft);
+
+  --vp-badge-caution-border: transparent;
+  --vp-badge-caution-text: var(--vp-c-caution-1);
+  --vp-badge-caution-bg: var(--vp-c-caution-soft);
+
   --vp-badge-warning-border: transparent;
   --vp-badge-warning-text: var(--vp-c-warning-1);
   --vp-badge-warning-bg: var(--vp-c-warning-soft);

package/dist/client/theme-default/support/docsearch.d.ts

@@ -0,0 +1,57 @@
+import { DefaultTheme } from "vitepress/theme";
+import { SidepanelProps } from "@docsearch/sidepanel-js";
+import { DocSearchAskAi } from "../../../../types/docsearch.js";
+//#region src/client/theme-default/support/docsearch.d.ts
+export type FacetFilter = string | string[] | FacetFilter[];
+export interface ValidatedCredentials {
+  valid: boolean;
+  appId?: string;
+  apiKey?: string;
+  indexName?: string;
+}
+export type DocSearchMode = 'auto' | 'sidePanel' | 'hybrid' | 'modal';
+export interface ResolvedMode {
+  mode: DocSearchMode;
+  showKeywordSearch: boolean;
+  useSidePanel: boolean;
+}
+export type ResolvedSidePanelProps = SidepanelProps & {
+  agentStudio?: boolean;
+  searchParameters?: DocSearchAskAi['searchParameters'];
+  suggestedQuestions?: boolean;
+  useStagingEnv?: boolean;
+};
+/**
+ * Resolves the effective mode based on config and available features.
+ *
+ * - 'auto': infer hybrid vs sidePanel-only from provided config
+ * - 'sidePanel': force sidePanel-only even if keyword search is configured
+ * - 'hybrid': force hybrid (error if keyword search is not configured)
+ * - 'modal': force modal even if sidePanel is configured
+ */
+export declare function resolveMode(options: Pick<DefaultTheme.AlgoliaSearchOptions, 'appId' | 'apiKey' | 'indexName' | 'askAi' | 'mode'>): ResolvedMode;
+export declare function hasKeywordSearch(options: Pick<DefaultTheme.AlgoliaSearchOptions, 'appId' | 'apiKey' | 'indexName'>): boolean;
+export declare function hasAskAi(askAi: DefaultTheme.AlgoliaSearchOptions['askAi']): boolean;
+/**
+ * Removes existing `lang:` filters and appends `lang:${lang}`.
+ * Handles both flat arrays and nested arrays (for OR conditions).
+ */
+export declare function mergeLangFacetFilters(rawFacetFilters: FacetFilter | FacetFilter[] | undefined, lang: string): FacetFilter[];
+/**
+ * Validates that required Algolia credentials are present.
+ */
+export declare function validateCredentials(options: Pick<DefaultTheme.AlgoliaSearchOptions, 'appId' | 'apiKey' | 'indexName'>): ValidatedCredentials;
+/**
+ * Builds Ask AI configuration from various input formats.
+ */
+export declare function buildAskAiConfig(askAiProp: NonNullable<DefaultTheme.AlgoliaSearchOptions['askAi']>, options: DefaultTheme.AlgoliaSearchOptions, lang: string): DocSearchAskAi;
+/**
+ * Builds the DocSearch side panel config from the resolved Ask AI options.
+ */
+export declare function buildSidePanelProps(askAi: DocSearchAskAi, options: DefaultTheme.AlgoliaSearchOptions): ResolvedSidePanelProps;
+/**
+ * Resolves Algolia search options for the given language,
+ * merging in locale-specific overrides and language facet filters.
+ */
+export declare function resolveOptionsForLanguage(options: DefaultTheme.AlgoliaSearchOptions, localeIndex: string, lang: string): DefaultTheme.AlgoliaSearchOptions;
+//#endregion

package/dist/client/theme-default/support/docsearch.js

@@ -0,0 +1,145 @@
+import { isObject } from "../../shared.js";
+//#region src/client/theme-default/support/docsearch.ts
+/**
+* Resolves the effective mode based on config and available features.
+*
+* - 'auto': infer hybrid vs sidePanel-only from provided config
+* - 'sidePanel': force sidePanel-only even if keyword search is configured
+* - 'hybrid': force hybrid (error if keyword search is not configured)
+* - 'modal': force modal even if sidePanel is configured
+*/
+function resolveMode(options) {
+	const mode = options.mode ?? "auto";
+	const hasKeyword = hasKeywordSearch(options);
+	const askAi = options.askAi;
+	const hasSidePanelConfig = Boolean(askAi && typeof askAi === "object" && askAi.sidePanel);
+	switch (mode) {
+		case "sidePanel": return {
+			mode,
+			showKeywordSearch: false,
+			useSidePanel: true
+		};
+		case "hybrid":
+			if (!hasKeyword) console.error("[vitepress] mode: \"hybrid\" requires keyword search credentials (appId, apiKey, indexName).");
+			return {
+				mode,
+				showKeywordSearch: hasKeyword,
+				useSidePanel: true
+			};
+		case "modal": return {
+			mode,
+			showKeywordSearch: hasKeyword,
+			useSidePanel: false
+		};
+		default: return {
+			mode: "auto",
+			showKeywordSearch: hasKeyword,
+			useSidePanel: hasSidePanelConfig
+		};
+	}
+}
+function hasKeywordSearch(options) {
+	return Boolean(options.appId && options.apiKey && options.indexName);
+}
+function hasAskAi(askAi) {
+	if (!askAi) return false;
+	if (typeof askAi === "string") return askAi.length > 0;
+	return Boolean(askAi.assistantId);
+}
+/**
+* Removes existing `lang:` filters and appends `lang:${lang}`.
+* Handles both flat arrays and nested arrays (for OR conditions).
+*/
+function mergeLangFacetFilters(rawFacetFilters, lang) {
+	return [...(Array.isArray(rawFacetFilters) ? rawFacetFilters : rawFacetFilters ? [rawFacetFilters] : []).map((filter) => {
+		if (Array.isArray(filter)) return filter.filter((f) => typeof f === "string" && !f.startsWith("lang:"));
+		return filter;
+	}).filter((filter) => {
+		if (typeof filter === "string") return !filter.startsWith("lang:");
+		return Array.isArray(filter) && filter.length > 0;
+	}), `lang:${lang}`];
+}
+/**
+* Validates that required Algolia credentials are present.
+*/
+function validateCredentials(options) {
+	const appId = options.appId;
+	const apiKey = options.apiKey;
+	const indexName = options.indexName;
+	return {
+		valid: Boolean(appId && apiKey && indexName),
+		appId,
+		apiKey,
+		indexName
+	};
+}
+/**
+* Builds Ask AI configuration from various input formats.
+*/
+function buildAskAiConfig(askAiProp, options, lang) {
+	const isAskAiString = typeof askAiProp === "string";
+	const askAiSearchParameters = !isAskAiString && askAiProp.searchParameters ? { ...askAiProp.searchParameters } : void 0;
+	const isAgentStudio = !isAskAiString && askAiProp.agentStudio === true;
+	const askAiFacetFilters = mergeLangFacetFilters(askAiSearchParameters?.facetFilters ?? options.searchParameters?.facetFilters, lang);
+	const mergedAskAiSearchParameters = isAgentStudio ? askAiSearchParameters : {
+		...askAiSearchParameters,
+		facetFilters: askAiFacetFilters.length ? askAiFacetFilters : void 0
+	};
+	const result = {
+		...isAskAiString ? {} : askAiProp,
+		indexName: isAskAiString ? options.indexName : askAiProp.indexName,
+		apiKey: isAskAiString ? options.apiKey : askAiProp.apiKey,
+		appId: isAskAiString ? options.appId : askAiProp.appId,
+		assistantId: isAskAiString ? askAiProp : askAiProp.assistantId
+	};
+	if (mergedAskAiSearchParameters && Object.values(mergedAskAiSearchParameters).some((v) => v != null)) result.searchParameters = mergedAskAiSearchParameters;
+	return result;
+}
+/**
+* Builds the DocSearch side panel config from the resolved Ask AI options.
+*/
+function buildSidePanelProps(askAi, options) {
+	const { sidePanel, ...askAiRest } = JSON.parse(JSON.stringify(askAi));
+	return {
+		container: "#vp-docsearch-sidepanel",
+		indexName: options.indexName,
+		appId: options.appId,
+		apiKey: options.apiKey,
+		...askAiRest,
+		...sidePanel && sidePanel !== true ? sidePanel : {}
+	};
+}
+/**
+* Resolves Algolia search options for the given language,
+* merging in locale-specific overrides and language facet filters.
+*/
+function resolveOptionsForLanguage(options, localeIndex, lang) {
+	options = deepMerge(options, options.locales?.[localeIndex] || {});
+	const facetFilters = mergeLangFacetFilters(options.searchParameters?.facetFilters, lang);
+	const askAi = options.askAi ? buildAskAiConfig(options.askAi, options, lang) : void 0;
+	return {
+		...options,
+		searchParameters: {
+			...options.searchParameters,
+			facetFilters
+		},
+		askAi
+	};
+}
+function deepMerge(target, source) {
+	const result = { ...target };
+	for (const key in source) {
+		const value = source[key];
+		if (value === void 0) continue;
+		if (key === "searchParameters") {
+			result[key] = value;
+			continue;
+		}
+		if (isObject(value) && isObject(result[key])) result[key] = deepMerge(result[key], value);
+		else result[key] = value;
+	}
+	delete result.locales;
+	return result;
+}
+//#endregion
+export { buildAskAiConfig, buildSidePanelProps, hasAskAi, hasKeywordSearch, mergeLangFacetFilters, resolveMode, resolveOptionsForLanguage, validateCredentials };

package/dist/client/theme-default/support/local-search.d.ts

@@ -0,0 +1,9 @@
+import MiniSearch from "minisearch";
+import { DefaultTheme } from "vitepress/theme";
+//#region src/client/theme-default/support/local-search.d.ts
+/**
+ * Loads a serialized local search index with the same options that were used
+ * to build it (functions are not serialized) plus the default search options.
+ */
+export declare function loadLocalSearchIndex<T = Record<string, any>>(json: string, miniSearch?: DefaultTheme.MiniSearchOptions): MiniSearch<T>;
+//#endregion