feat(品牌标识): 几何 K 图标(favicon/顶栏标记/theme-color) + 并行会话成果入库

## 品牌标识（本次会话）起因：品牌此前没有任何图形标识 —— 唯一 favicon 是内联 data-URI 里的字母「A」，那是 v2.0.0「Aurora Admin → Kole UI」改名漏掉的一处（PC 顶栏也是「A」，移动端站已是「K」；移动端文档站则完全没有 favicon）。 - 几何：24 网格三个互不接触的笔画（竖 + 两斜），圆头描边；描边 2.25 → 16px 标签页尺寸下正好 1.5px = 规范原文「描边1.5px」 - 取色分两套（刻意）：favicon 硬编码品牌蓝/白（渲染在浏览器标签栏，不继承 kole-dark）；顶栏标记走 currentColor（实测暗色下自动转 rgb(20,22,28)） - 新增 theme-color 双条（light #FFFFFF / dark #1C1F26，取 --kole-color-card-bg） - 修 site/app.js hero 标语 KOLE ADMIN → KOLE UI（改名变形残留） - 移动端 7 个模板补 favicon（此前计数 0）验收：门禁 9 条全 OK（site-routing/site-routes/mobile-docs/mobile-site/isolation/ theme/nav/i18n/icons）；PC 回归 1464/1464 · 移动端 807/807，各连跑 8 次一致；两端 favicon 405 字节逐字节一致；PC 站控制台错误 1→0。 ## 并行会话成果（本次一并入库） - 图标系统：2576 图标（TDesign/Element Plus，MIT）+ 11 端注入 + 5 个构建门禁工具 + IconPreview 预览页 + ICON-SPEC.md 冻结规格 - 移动端平台：47 组件 × 6 端 + 文档站 53 页 + 隔离门禁 - PC 组件：103 个大后台组件 / 组件11 批次 - uni-app：PC 端试点 + 移动端端实现 + 真实编译验证 ## 工程 - .gitignore 补 .scratch/ 与 .zcode-preexisting-*.txt（会话中间产物，实测 9.1MB，不入库） - CHANGELOG 补品牌标识条目 - ROADMAP 登 S8-P4（品牌标识任务包 + og:image/apple-touch-icon 未做部分）
2026-09-21 10:05:48 +08:00
parent eb25feedaf
commit f1fbfc2ddb
2541 changed files with 270385 additions and 25873 deletions
@@ -0,0 +1,87 @@
+import React from 'react';
+import './List.css';
+
+/* 列表（移动端）— 规格 §24
+   一行 = 前缀位 + 主区 + 后缀位；可点行是原生 button（整行热区、键盘可达），
+   纯展示行用 div + role="listitem"（原生语义优先于 listitem）。
+   本端不接管滚动、不做虚拟列表（规格 §24.5）；inline 控件要自己阻止冒泡，避免一次点击触发两个动作。 */
+export default function List({
+  items = [],
+  size = 'default',
+  border = true,
+  divider = 'inset',
+  header = '',
+  footer = '',
+  emptyText = '',
+  onSelect,
+  children = null,
+  empty = null,
+}) {
+  const cls =
+    'kole-m-list' +
+    (size === 'compact' ? ' kole-m-list--compact' : '') +
+    (border ? ' kole-m-list--border' : '') +
+    ` kole-m-list--${divider}`;
+
+  const suffixOf = (it) => (
+    <>
+      {it.value ? <span className="kole-m-list__value">{it.value}</span> : null}
+      {it.arrow ? (
+        <span className="kole-m-list__arrow" aria-hidden="true">
+          ›
+        </span>
+      ) : null}
+    </>
+  );
+
+  const bodyOf = (it) => (
+    <>
+      {it.prefix ? <span className="kole-m-list__prefix">{it.prefix}</span> : null}
+      <span className="kole-m-list__body">
+        <span className="kole-m-list__title">{it.title}</span>
+        {it.desc ? <span className="kole-m-list__desc">{it.desc}</span> : null}
+      </span>
+    </>
+  );
+
+  if (!items.length) {
+    return (
+      <div className={cls} role="list" aria-live="polite">
+        {header ? <p className="kole-m-list__header">{header}</p> : null}
+        {empty || <p className="kole-m-list__empty">{emptyText || '暂无数据'}</p>}
+        {footer ? <p className="kole-m-list__footer">{footer}</p> : null}
+      </div>
+    );
+  }
+
+  return (
+    <div className={cls} role="list">
+      {header ? <p className="kole-m-list__header">{header}</p> : null}
+      {items.map((it, i) =>
+        it && it.static ? (
+          /* 纯展示行：div + role="listitem"，不绑点击（规格 §24.6） */
+          <div key={it.key || i} className={'kole-m-list__item' + (it.disabled ? ' is-disabled' : '')} role="listitem" aria-disabled={it.disabled ? 'true' : undefined}>
+            {bodyOf(it)}
+            <span className="kole-m-list__suffix">{suffixOf(it)}</span>
+          </div>
+        ) : (
+          <button
+            key={it.key || i}
+            className={'kole-m-list__item' + (it.disabled ? ' is-disabled' : '')}
+            type="button"
+            disabled={!!it.disabled}
+            onClick={(e) => {
+              if (it.disabled) return;
+              if (onSelect) onSelect(i, e);
+            }}
+          >
+            {bodyOf(it)}
+            <span className="kole-m-list__suffix">{suffixOf(it)}</span>
+          </button>
+        )
+      )}
+      {children}
+      {footer ? <p className="kole-m-list__footer">{footer}</p> : null}
+    </div>
+  );
+}