@mooncellwiki/prts-design-tokens 0.1.4 → 0.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mooncellwiki/prts-design-tokens",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "PRTS Design · 明日方舟网页设计系统的设计令牌：W3C DTCG 格式的 JSON5 源 + CSS 变量版 tokens.css（亮 / 暗 / 跟随系统 / 局部主题）+ 解析后的 tokens.json（每个令牌带 CSS 写法与亮 / 暗解析值）",
   "license": "MIT",
   "type": "module",

package/src/base/size.json5

@@ -30,8 +30,8 @@
       $type: "dimension",
       "header-h": { $value: "56px" },
       "local-nav-h": { $value: "48px", $description: "二级吸顶栏（<1400 出现：菜单 / 本页目录）" },
-      "sidebar-w": { $value: "248px" },
-      "toc-w": { $value: "240px" },
+      "sidebar-w": { $value: "208px" },
+      "toc-w": { $value: "200px" },
       "content-max": { $value: "1240px", $description: "阅读区最大宽度；表格密集页可加 .ak-wide" },
       "content-narrow": { $value: "760px" },
       gutter: { $value: "24px" },

package/src/base/typography.json5

@@ -36,7 +36,12 @@
       "fs-body": { $value: "1rem", $description: "16" },
       "fs-sm": { $value: "0.875rem", $description: "14" },
       "fs-xs": { $value: "0.75rem", $description: "12" },
-      "fs-overline": { $value: "0.6875rem", $description: "11" },
+      "fs-overline": { $value: "0.6875rem", $description: "11（低分屏 12，见 functional/low-dpi）" },
+    },
+    legibility: {
+      $description: "中文小字的字号下限：可能出现中文的 9–10px 小字（卡片副题、解锁条件、标签、页签计数…）写成 max(设计字号, var(--ak-fs-cjk-min))",
+      $type: "dimension",
+      "fs-cjk-min": { $value: "0px", $description: "高分屏 0 = 不干预、照设计字号；低分屏抬到 12px（functional/low-dpi）" },
     },
     "line-height": {
       $description: "行高",

package/src/functional/low-dpi.json5

@@ -7,5 +7,15 @@
         $value: "\"Source Han Sans SC\", \"Microsoft YaHei\", \"Noto Sans SC\", \"Noto Sans CJK SC\", \"PingFang SC\", \"HarmonyOS Sans SC\", system-ui, -apple-system, sans-serif",
       },
     },
+    "font-size": {
+      $description: "低分屏的 overline：一个汉字只分到 11 个设备像素，粗体中文（目录 / 导航 / 页脚栏目 / 属性名 / 潜能…）笔画挤成一团——抬到 12px（文档「中文最小 12px」），纯拉丁的 overline 一并跟着大 1px。",
+      $type: "dimension",
+      "fs-overline": { $value: "0.75rem", $description: "12（高分屏 11）" },
+    },
+    legibility: {
+      $description: "低分屏的中文小字下限：9–10px 的中文在 1× 屏上只有 9–10 个设备像素，换哪款字都糊（雅黑也救不回来）。",
+      $type: "dimension",
+      "fs-cjk-min": { $value: "12px", $description: "= 文档「中文最小 12px」；写了 max(…, var(--ak-fs-cjk-min)) 的小字抬到这里" },
+    },
   },
 }

package/tokens.css

@@ -116,7 +116,10 @@
   --ak-fs-body: 1rem;                      /* 16 */
   --ak-fs-sm: 0.875rem;                    /* 14 */
   --ak-fs-xs: 0.75rem;                     /* 12 */
-  --ak-fs-overline: 0.6875rem;             /* 11 */
+  --ak-fs-overline: 0.6875rem;             /* 11（低分屏 12，见 functional/low-dpi） */
+
+  /* ─── typography · legibility · 中文小字的字号下限：可能出现中文的 9–10px 小字（卡片副题、解锁条件、标签、页签计数…）写成 max(设计字号, var(--ak-fs-cjk-min)) */
+  --ak-fs-cjk-min: 0px;                    /* 高分屏 0 = 不干预、照设计字号；低分屏抬到 12px（functional/low-dpi） */
 
   /* ─── typography · line-height · 行高 */
   --ak-lh-body: 1.7;                       /* CJK 正文 */
@@ -159,8 +162,8 @@
   /* ─── size · layout · Layout · 与 Codex 断点一致: 320 / 640 / 1120 / 1680 */
   --ak-header-h: 56px;
   --ak-local-nav-h: 48px;                  /* 二级吸顶栏（<1400 出现：菜单 / 本页目录） */
-  --ak-sidebar-w: 248px;
-  --ak-toc-w: 240px;
+  --ak-sidebar-w: 208px;
+  --ak-toc-w: 200px;
   --ak-content-max: 1240px;                /* 阅读区最大宽度；表格密集页可加 .ak-wide */
   --ak-content-narrow: 760px;
   --ak-gutter: 24px;
@@ -650,7 +653,7 @@ html.skin-theme-clientpref-night,
   --ak-canvas-attachment: scroll;
 }
 
-/* ═══ 低分屏：正文链把微软雅黑提到 Noto Sans SC 前面（Windows 100% / 125% 缩放下未 hinting 的 Noto 发虚；没装雅黑的系统不受影响） ═══ */
+/* ═══ 低分屏：正文链把微软雅黑提到 Noto Sans SC 前面（Windows 100% / 125% 缩放下未 hinting 的 Noto 发虚；没装雅黑的系统不受影响）；中文小字抬到 12px（1× 屏上 9–11px 的汉字分不到足够像素） ═══ */
 @media (max-resolution: 1.49dppx) {
   :root {
     /* ─── typography */
@@ -660,6 +663,12 @@ html.skin-theme-clientpref-night,
      * 没装雅黑的系统（macOS / Linux / 移动端）照旧落到 Noto，高分屏的 Windows 也仍用 Noto。雅黑只有 Regular / Bold：500 落 Regular，600 / 800 落 Bold。
      * 装机的 Source Han Sans SC 仍排最前（与 :root 的链同序）。 */
     --ak-font-body: "Source Han Sans SC", "Microsoft YaHei", "Noto Sans SC", "Noto Sans CJK SC", "PingFang SC", "HarmonyOS Sans SC", system-ui, -apple-system, sans-serif;
+
+    /* ─── typography · font-size · 低分屏的 overline：一个汉字只分到 11 个设备像素，粗体中文（目录 / 导航 / 页脚栏目 / 属性名 / 潜能…）笔画挤成一团——抬到 12px（文档「中文最小 12px」），纯拉丁的 overline 一并跟着大 1px。 */
+    --ak-fs-overline: 0.75rem;             /* 12（高分屏 11） */
+
+    /* ─── typography · legibility · 低分屏的中文小字下限：9–10px 的中文在 1× 屏上只有 9–10 个设备像素，换哪款字都糊（雅黑也救不回来）。 */
+    --ak-fs-cjk-min: 12px;                 /* = 文档「中文最小 12px」；写了 max(…, var(--ak-fs-cjk-min)) 的小字抬到这里 */
   }
 }
 

package/tokens.json

@@ -20,6 +20,7 @@
     "color.sp": "Skill SP 回复类型（对应游戏内技能框配色，近似取值）",
     "typography.font": "Typography —— 每条链的前两段都由 fonts.css 自托管（人人一致，也是「上线效果」）：\n① 官网同源的 Novecento Sans Wide / Bender（ASCII 子集：· » — × ° 等非 ASCII 会逐字落到 ②）\n② OFL 的 Noto Sans SC / Oswald / Chakra Petch / JetBrains Mono\n之后是装机备选 → 系统字。fonts.css 没加载（Gadget 关掉 / 离线单文件）时自然退到后两段。",
     "typography.font-size": "字号（rem；注释为 px）",
+    "typography.legibility": "中文小字的字号下限：可能出现中文的 9–10px 小字（卡片副题、解锁条件、标签、页签计数…）写成 max(设计字号, var(--ak-fs-cjk-min))",
     "typography.line-height": "行高",
     "typography.tracking": "字距",
     "size.space": "Spacing (4px grid)",
@@ -1054,13 +1055,28 @@
         "fs-overline"
       ],
       "type": "dimension",
-      "description": "11",
+      "description": "11（低分屏 12，见 functional/low-dpi）",
       "css": "0.6875rem",
       "resolved": {
         "light": "0.6875rem",
         "dark": "0.6875rem"
       }
     },
+    {
+      "name": "--ak-fs-cjk-min",
+      "path": [
+        "typography",
+        "legibility",
+        "fs-cjk-min"
+      ],
+      "type": "dimension",
+      "description": "高分屏 0 = 不干预、照设计字号；低分屏抬到 12px（functional/low-dpi）",
+      "css": "0px",
+      "resolved": {
+        "light": "0px",
+        "dark": "0px"
+      }
+    },
     {
       "name": "--ak-lh-body",
       "path": [
@@ -1422,10 +1438,10 @@
         "sidebar-w"
       ],
       "type": "dimension",
-      "css": "248px",
+      "css": "208px",
       "resolved": {
-        "light": "248px",
-        "dark": "248px"
+        "light": "208px",
+        "dark": "208px"
       }
     },
     {
@@ -1436,10 +1452,10 @@
         "toc-w"
       ],
       "type": "dimension",
-      "css": "240px",
+      "css": "200px",
       "resolved": {
-        "light": "240px",
-        "dark": "240px"
+        "light": "200px",
+        "dark": "200px"
       }
     },
     {