docs: patch comark-docs for vitesse code themes; brand-green highlighted text

Author: antfubot

docs/app/assets/css/devframe.css

@@ -19,14 +19,19 @@
 }
 
 /*
- * The comark-docs layer pins the semantic `--ui-primary` to neutral for its
- * monochrome look; devframe uses its brand green as the primary accent
- * (buttons, links, active nav). Loaded after the layer's theme, so this wins.
+ * The comark-docs layer pins the semantic `--ui-primary` and highlighted text
+ * to neutral for its monochrome look; devframe uses its brand green for both
+ * the primary accent (buttons, links, active nav) and highlighted text
+ * (headings, emphasis). The doubled `:root:root` / `:root.dark` selectors give
+ * these a higher specificity than the layer's plain `:root` / `.dark`, so they
+ * win regardless of stylesheet load order.
  */
-:root {
+:root:root {
   --ui-primary: var(--ui-color-primary-500);
+  --ui-text-highlighted: var(--ui-color-primary-700);
 }
 
-.dark {
+:root.dark {
   --ui-primary: var(--ui-color-primary-400);
+  --ui-text-highlighted: var(--ui-color-primary-300);
 }

docs/nuxt.config.ts

@@ -1,5 +1,4 @@
 import process from 'node:process'
-import { fileURLToPath } from 'node:url'
 
 export default defineNuxtConfig({
   compatibilityDate: '2026-08-21',
@@ -10,12 +9,6 @@ export default defineNuxtConfig({
 
   css: ['~/assets/css/devframe.css'],
 
-  // Redirect the layer's rangi highlighter import to a shim that renders code
-  // with Shiki's vitesse-light / vitesse-dark themes.
-  alias: {
-    'comark/plugins/rangi': fileURLToPath(new URL('./shims/rangi.ts', import.meta.url)),
-  },
-
   site: {
     url: 'https://devfra.me',
     name: 'Devframe',

docs/package.json

@@ -8,7 +8,6 @@
     "docs:serve": "nuxt preview"
   },
   "dependencies": {
-    "@shikijs/themes": "catalog:docs",
     "comark-docs": "catalog:docs",
     "nuxt": "catalog:build",
     "ufo": "catalog:deps"

docs/shims/rangi.ts

@@ -40,12 +40,7 @@
       // Nuxt auto-registers `app/components` and `app/composables`; the files
       // here shadow same-named pieces of the comark-docs layer (AppHeaderBrand,
       // useFilteredNavigation, ...), so nothing imports them explicitly.
-      // `shims/rangi.ts` is wired in through `nuxt.config.ts`'s `alias`.
-      "entry": ["app/components/*.vue", "app/composables/*.ts", "shims/*.ts"],
-      // `comark` is the comark-docs layer's own (pkg.pr.new pinned) dep; the
-      // rangi->shiki shim imports `comark/plugins/shiki` from it, resolved
-      // through the workspace's hoisted store.
-      "ignoreDependencies": ["comark"]
+      "entry": ["app/components/*.vue", "app/composables/*.ts"]
     },
     "examples/hub-next": {
       // The React client build's root sits at `src/client` (`next dev

knip.jsonc

@@ -0,0 +1,31 @@
+diff --git a/server/utils/content.ts b/server/utils/content.ts
+index e30eeb312d00dd6111b5574680e6b8b725d7cb76..2d6d6e570dfef6537276dc4a613f3cd5fcbf4e8c 100644
+--- a/server/utils/content.ts
++++ b/server/utils/content.ts
+@@ -1,14 +1,15 @@
+ import { defineContentPlugin, type ComarkContent, type CacheOptions, comarkContent  } from 'comark-content';
+ import fs from 'comark-content/sources/fs'
+ import github from 'comark-content/sources/github'
+-import rangi from 'comark/plugins/rangi'
++import shiki from 'comark/plugins/shiki'
+ import security from 'comark/plugins/security'
+ import emoji from 'comark/plugins/emoji'
+ import toc from 'comark/plugins/toc'
+ import mermaid from 'comark/plugins/mermaid'
+ import yaml from 'comark-content/plugins/yaml'
+ import tracingOtel from 'comark-content/plugins/tracing/otel'
+-import { githubLight, githubDark } from 'rangi/themes'
++import vitesseDark from '@shikijs/themes/vitesse-dark'
++import vitesseLight from '@shikijs/themes/vitesse-light'
+ import { contentTracer } from './tracer.ts'
+ 
+ // Rebuilt only when the head advances (see `getProdContent`). Holds the *promise*, not the instance: the
+@@ -18,7 +19,7 @@ let content: Promise<ComarkContent> | undefined
+ // Bump CONTENT_PARSER_VERSION in `cache.ts` when these plugins or their options change cached output.
+ const comarkPlugins = [
+   mermaid({ theme: 'zinc-light', themeDark: 'zinc-dark' }),
+-  rangi({ theme: { light: githubLight, dark: githubDark } }),
++  shiki({ registerDefaultThemes: false, themes: { light: vitesseLight, dark: vitesseDark } }),
+   toc({ depth: 3 }),
+   emoji(),
+   security({

patches/comark-docs@0.0.1.patch

@@ -72,9 +72,14 @@ overrides:
   semver: ^7.8.5
   shell-quote: ^1.10.0
 
+update:
+  ignoreDeps:
+    - typescript@7
+patchedDependencies:
+  comark-docs@0.0.1: patches/comark-docs@0.0.1.patch
 catalogs:
   build:
-    '@nuxt/kit': *nuxt
+    '@nuxt/kit': ^4.5.2
     '@preact/preset-vite': ^2.10.6
     '@rsbuild/core': ^2.1.13
     '@sveltejs/adapter-node': ^5.3.3
@@ -128,7 +133,6 @@ catalogs:
     zigpty: ^0.2.1
     zod: ^4.4.3
   docs:
-    '@shikijs/themes': ^4.4.3
     comark-docs: github:comarkdown/comark-docs
   frontend:
     '@antfu/design': ^0.3.4
@@ -141,10 +145,10 @@ catalogs:
     '@radix-ui/react-scroll-area': ^1.2.18
     '@radix-ui/react-slot': ^1.3.3
     '@sveltejs/vite-plugin-svelte': ^7.3.0
-    '@unocss/postcss': *unocss
-    '@unocss/preset-icons': *unocss
-    '@unocss/reset': *unocss
-    '@vueuse/core': *vueuse
+    '@unocss/postcss': ^66.7.5
+    '@unocss/preset-icons': ^66.7.5
+    '@unocss/reset': ^66.7.5
+    '@vueuse/core': ^14.4.0
     '@xterm/addon-fit': ^0.11.0
     '@xterm/xterm': ^6.0.0
     axe-core: ^4.13.0
@@ -165,21 +169,21 @@ catalogs:
     splitpanes: ^4.1.2
     svelte: ^5.56.9
     tailwind-merge: ^3.6.0
-    unocss: *unocss
+    unocss: ^66.7.5
     vite-plugin-css-injected-by-js: ^5.0.2
     vue: ^3.5.41
   inlined:
     '@antfu/utils': ^9.3.0
     jora: ^1.0.0-beta.16
     ua-parser-modern: ^0.1.1
   storybook:
-    '@storybook/addon-a11y': *storybook
-    '@storybook/addon-docs': *storybook
-    '@storybook/react-vite': *storybook
-    '@storybook/svelte-vite': *storybook
-    '@storybook/vue3-vite': *storybook
+    '@storybook/addon-a11y': ^10.5.8
+    '@storybook/addon-docs': ^10.5.8
+    '@storybook/react-vite': ^10.5.8
+    '@storybook/svelte-vite': ^10.5.8
+    '@storybook/vue3-vite': ^10.5.8
     '@vitejs/plugin-react-oxc': ^0.4.3
-    storybook: *storybook
+    storybook: ^10.5.8
     storybook-solidjs-vite: ^10.6.0
   testing:
     '@playwright/test': ^1.62.1
@@ -202,6 +206,3 @@ catalogs:
     '@types/react': ^19.2.18
     '@types/react-dom': ^19.2.4
     '@types/ws': ^8.18.1
-update:
-  ignoreDeps:
-    - typescript@7