dsh-theme-palette 1.8.1 → 1.8.2

package/CHANGELOG.md

@@ -4,6 +4,30 @@
 
 ## 版本一览
 
+### 1.8.2
+**暖砂字体体系修正**（用户反馈“和其他两套不一样，尤其字体颜色”）：
+
+- **根因 1：深色正文字色度没有按色域归一**。`paperC` 是绝对值，×2.4 后暖砂请求 130%、靛蓝 166% 色域上限，
+  实际色度被裁成 0.0244 / 0.0115 / 0.0303——暖砂深正文几乎是靛蓝的两倍黄。现在三套统一 `paperC=0.0053`
+  （标准档实际 ≈0.0127），浅/深正文色度比降到 1.21 / 1.10
+- **根因 2：暖砂是唯一「深色面 60°、正文 84°」的双色相预置**。深色面橙棕、正文黄绿，色相分裂 24°；
+  现在 `paper` 角色跟随 `darkHue`，并把暖砂 `hue` 84→72、`darkHue` 60→66，全套色相收敛到 12° 内
+- 新增断言：深正文色相偏离 `darkHue` ≤12°、三套浅色正文色度比 ≤1.25、深色 ≤1.5
+- 新增 `tools/preview-typography.mjs`：三套 × 明暗并排渲染同一段文字，发版前目检
+
+语法高亮跟随配色（1.8.1 里“未做”的那条，前提已实测）：
+
+- **实测依据**：宿主渲染器用 Shiki 的 `css-variables` 模式（`class="shiki css-variables"`，
+  `style="background-color:var(--shiki-background)"`），token 颜色走 CSS 变量，
+  所以覆盖 `--shiki-token-*` 生效，不需要 `!important`
+- **色相策略**：从强调色相取 3 个色族（强调 / +150° 冷族 / -60° 暖族），
+  同族靠明度分常/表达；每个 token 对代码块底求解到 **≥4.6:1**，四族最小 ΔE **≥10**
+- 覆盖 9 类 token（keyword / function / constant / parameter / string / string-expression /
+  comment / punctuation / link）+ `--shiki-background` / `--shiki-foreground`
+- **md=off 时不输出**任何 shiki token，交回宿主原色
+- 新增 `tools/preview-code.mjs`：用生产 token 渲染一段真实代码，发版前肉眼确认
+- 断言：9 类 token 对比度 ≥4.6、四族 ΔE ≥10、shiki 背景与代码块一致、md=off 无输出
+
 ### 1.8.1
 Markdown 配色丰富化（非加色相，而是加层级 + 修代码块底）：
 

package/client.js

@@ -27,7 +27,7 @@ window.__ModuleLoader__.load({
     const React = require('react')
     const h = React.createElement
 
-    const PLUGIN_VERSION = '1.8.1'
+    const PLUGIN_VERSION = '1.8.2'
     const STORE_KEY = 'dsh-theme-palette.v1'
     const OVERRIDE_SOURCE = 'dsh-theme-palette'
 
@@ -107,22 +107,22 @@ window.__ModuleLoader__.load({
       { id: 'mono', label: '黑白', desc: '无色调 · 默认', tinted: false },
       {
         id: 'warm', label: '暖砂', desc: '米白 + 棕调', tinted: true,
-        hue: 84, darkHue: 60, lightC: 0.030, midC: 0.010, textC: 0.004,
-        darkC: 0.014, darkLift: 0.026, paperC: 0.014, // 深底 #1e1b14 L 0.223 / 30% 色域
+        hue: 72, darkHue: 66, lightC: 0.030, midC: 0.010, textC: 0.004,
+        darkC: 0.014, darkLift: 0.026, paperC: 0.0053, // 深正文按色域归一：×2.4 后 ≈0.0127
         accentHue: 60, accentC: 0.101, accentL: 0.58, // 标准色 #A9683E
         accentScale: 1.0,
       },
       {
         id: 'indigo', label: '靛蓝', desc: '冷白 + 蓝调', tinted: true,
         hue: 266, lightC: 0.020, midC: 0.010, textC: 0.004,
-        darkC: 0.028, darkLift: 0.032, paperC: 0.009, // 深底 #161c2a L 0.227 / 19% 色域
+        darkC: 0.028, darkLift: 0.032, paperC: 0.0053, // 同上：三套统一，避免被色域裁成两倍差
         accentHue: 259, accentC: 0.107, accentL: 0.5108, // 标准色 #3F66A3
         accentScale: 1.0,
       },
       {
         id: 'moss', label: '苔绿', desc: '浅灰绿 + 绿调', tinted: true,
         hue: 162, lightC: 0.016, midC: 0.010, textC: 0.004,
-        darkC: 0.015, darkLift: 0.042, paperC: 0.0125, // 深底 #1a211b L 0.239 / 24% 色域
+        darkC: 0.015, darkLift: 0.042, paperC: 0.0053, // 同上
         accentHue: 139, accentC: 0.096, accentL: 0.5335, // 标准色 #4F7A42
         accentScale: 1.0,
       },
@@ -495,9 +495,10 @@ window.__ModuleLoader__.load({
         // 换成 60°（橙棕）才是咖啡色。浅色侧仍是 88°（米白）。
         // 文字档（含深色正文 paper）跟随「文字」这一项自己的色相；预设没有 textHue，行为不变。
         const tintRole = role === 'text' || role === 'paper'
+        // 深色角色（含深色正文 paper）统一走 darkHue，避免「深色面橙棕、正文黄绿」的双色相
         const hue = tintRole && scheme.textHue !== undefined
           ? scheme.textHue
-          : (role === 'dark' && scheme.darkHue !== undefined ? scheme.darkHue : scheme.hue)
+          : ((role === 'dark' || role === 'paper') && scheme.darkHue !== undefined ? scheme.darkHue : scheme.hue)
         bluish[step] = fromOklch(clamp(compressL(lifted), 0, 0.995), roleChroma(role, weight, scheme, scales), hue)
       }
       const neutral = {}
@@ -935,6 +936,50 @@ window.__ModuleLoader__.load({
         light: mixHex(ramps.deepseek['500'], ramps.bluish['50'], 0.05),
         dark: mixHex(ramps.deepseek['400'], ramps.bluish['900'], 0.07),
       }
+      /* ---- 语法高亮（1.8.2）----
+       * 宿主渲染器用 Shiki 的 `css-variables` 模式（className="shiki css-variables"，
+       * 样式走 var(--shiki-*)），所以覆盖这些变量有效，不需要 !important。
+       *
+       * 色相策略：不引入与配色无关的固定色，而是从强调色相出发取 3 个色族
+       * （强调 / +150° 的冷族 / -55° 的暖族），再用明度与色度拉开可辨度；
+       * 每个 token 都必须对代码块底达到 4.6:1，否则沿远离背景的方向调整明度。
+       */
+      if (params.tinted && mdMode === 'on') {
+        const baseHue = params.accentHue === undefined ? scheme.hue : params.accentHue
+        const pickL = (bg) => (contrast('#ffffff', bg) >= contrast('#000000', bg) ? 0.80 : 0.45)
+        const dirOf = (bg) => (contrast('#ffffff', bg) >= contrast('#000000', bg) ? 1 : -1)
+        const ink = (bg, hue, chroma, startL, target) => {
+          const dir = dirOf(bg)
+          let L = startL
+          for (let i = 0; i < 160; i++) {
+            const c = fromOklch(clamp(L, 0.02, 0.99), chroma, hue)
+            if (contrast(c, bg) >= target) return c
+            L += dir * 0.004
+          }
+          return fromOklch(clamp(L, 0.02, 0.99), chroma, hue)
+        }
+        // 每个色族自带目标对比度：同族靠明度分"常/表达"，异族靠色相差 55–150°
+        const families = {
+          keyword: [baseHue, 0.15, 4.6],
+          function: [baseHue + 70, 0.12, 5.0],
+          constant: [baseHue - 60, 0.13, 4.8],
+          parameter: [baseHue + 30, 0.10, 5.6],
+          string: [baseHue + 150, 0.10, 4.8],
+          'string-expression': [baseHue + 150, 0.085, 5.8],
+          comment: [baseHue, 0.015, 4.6],
+          punctuation: [baseHue, 0.02, 6.0],
+        }
+        for (const [name, [hue, chroma, target]] of Object.entries(families)) {
+          const key = '--shiki-token-' + name
+          pairs[key] = {
+            light: ink(codeFill.light, hue, chroma, pickL(codeFill.light), target),
+            dark: ink(codeFill.dark, hue, chroma, pickL(codeFill.dark), target),
+          }
+        }
+        pairs['--shiki-token-link'] = { light: lightLink(ramps, false), dark: ramps.deepseek['400'] }
+        pairs['--shiki-background'] = codeFill
+        pairs['--shiki-foreground'] = { light: ramps.bluish['1000'], dark: ramps.bluish['50'] }
+      }
       const scroll = scrollbarTokens(ramps, params, scrollMode)
       for (const [name, pair] of Object.entries(scroll)) pairs[name] = pair
       // 开关/勾选/单选的共用支点：brand-primary 本来是近黑/近白，改成强调色。
@@ -2078,7 +2123,7 @@ body[data-ds-dark-theme] .dsh-tp-check{background:var(--t-accent-d);color:var(--
 
     // 开发期接口：palette-dev.mjs 通过它拿到同一套引擎（避免「报表好看、上线不一样」）
     if (DEV_OPT_IN && typeof window !== 'undefined' && typeof window.__DSH_THEME_PALETTE_DEV__ === 'function') {
-      window.__DSH_THEME_PALETTE_DEV__({ buildTokens, SCHEMES, SIDEBAR_MODES, TEXT_MODES, RIGHTBAR_MODES, SCROLL_MODES, CONTROL_MODES, MD_MODES, HC_MODES, contrast, toOklch, rampsFor, floors, encodeConfig, decodeConfig, customScheme, readCustom, writeCustom, CONTRAST_SURFACES, CONTRAST_ROLES, settingsCss: SETTINGS_CSS, cardColors })
+      window.__DSH_THEME_PALETTE_DEV__({ buildTokens, SCHEMES, SIDEBAR_MODES, TEXT_MODES, RIGHTBAR_MODES, SCROLL_MODES, CONTROL_MODES, MD_MODES, HC_MODES, contrast, toOklch, fromOklch, rampsFor, floors, encodeConfig, decodeConfig, customScheme, readCustom, writeCustom, CONTRAST_SURFACES, CONTRAST_ROLES, settingsCss: SETTINGS_CSS, cardColors })
     }
 
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-theme-palette",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "description": "DSH 主题配色：4 套配色 × 明暗两模式，OKLCH 色域安全重建 + 真实承载面对比度求解，可调强度与面板表面。",
   "type": "module",
   "main": "index.js",