merge: incorporate master base-path fixes

Author: LessUp

docs/.vitepress/tests/theme-primitives.test.mjs

@@ -16,6 +16,21 @@ function read(relativePath) {
   return fs.readFileSync(path.join(themeDir, relativePath), 'utf8')
 }
 
+function readAllCss() {
+  const mainCss = read('style.css')
+  const tokensDir = path.join(themeDir, 'tokens')
+  let allCss = mainCss
+
+  if (fs.existsSync(tokensDir)) {
+    const tokenFiles = fs.readdirSync(tokensDir).filter(file => file.endsWith('.css'))
+    for (const file of tokenFiles) {
+      allCss += `\n${fs.readFileSync(path.join(tokensDir, file), 'utf8')}`
+    }
+  }
+
+  return allCss
+}
+
 function extractLandingArray(content, propName) {
   const match = content.match(new RegExp(`:${propName}='\\[(.*?)\\]'`, 's'))
 
@@ -92,8 +107,7 @@ async function loadSfcComponent(relativePath) {
 }
 
 test('style.css keeps tokenized selectors for the live homepage, Mermaid, and SVG surfaces', () => {
-  const css = read('style.css')
-  const colorTokens = read('tokens/colors.css')
+  const css = readAllCss()
 
   for (const token of [
     '--wp-paper-1',
@@ -109,7 +123,7 @@ test('style.css keeps tokenized selectors for the live homepage, Mermaid, and SV
     '--wp-diagram-stroke',
     '--wp-icon-muted',
   ]) {
-    assert.match(colorTokens, new RegExp(token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')))
+    assert.match(css, new RegExp(token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')))
   }
 
   for (const selector of [
@@ -187,6 +201,7 @@ test('bilingual landing pages preserve copy while using shared whitepaper primit
 
   assert.match(enIndex, /<BaseAwareLink href="\/en\/getting-started\/quickstart">Quick Start guide<\/BaseAwareLink>/)
   assert.match(zhIndex, /<BaseAwareLink href="\/zh\/getting-started\/quickstart">快速开始指南<\/BaseAwareLink>/)
+  assert.match(read('SectionIndex.vue'), /BaseAwareLink/)
   assert.match(enIndex, /:actions='/)
   assert.match(zhIndex, /:actions='/)
   assert.doesNotMatch(enIndex, /href: "\.\//)

docs/.vitepress/tests/whitepaper-content.test.mjs

@@ -62,7 +62,7 @@ test('landing page states the stronger thesis and validation ladder', () => {
   const content = read('en/index.md')
 
   assert.match(content, /performance advice as something to compile, test, benchmark, and falsify/i)
-  assert.match(content, /debug→ubsan/)
+  assert.match(content, /debug→ubsan/i)
   assert.match(content, /## Who should read this guide\?/) 
   assert.match(content, /## Recommended study path/)
   assert.match(content, /## First-run route/)

docs/.vitepress/theme/LandingHero.vue

@@ -38,11 +38,10 @@ const props = withDefaults(defineProps<{
 })
 
 const isVisible = ref(false)
-
 const actionItems = props.actions ?? props.links ?? []
 
 onMounted(() => {
-  // Trigger entrance animation after mount
+  // Trigger entrance animation after mount.
   requestAnimationFrame(() => {
     setTimeout(() => {
       isVisible.value = true
@@ -86,8 +85,18 @@ onMounted(() => {
             :class="{ 'landing-hero__cta--primary': action.primary }"
           >
             {{ action.label }}
-            <svg v-if="action.primary" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-              <path d="M5 12h14M12 5l7 7-7 7"/>
+            <svg
+              v-if="action.primary"
+              width="16"
+              height="16"
+              viewBox="0 0 24 24"
+              fill="none"
+              stroke="currentColor"
+              stroke-width="2"
+              stroke-linecap="round"
+              stroke-linejoin="round"
+            >
+              <path d="M5 12h14M12 5l7 7-7 7" />
             </svg>
           </BaseAwareLink>
         </nav>