跨端: 左右滑动翻页（P6 第 3 步）+ 还 gesture-semantics 债 + 修跑不起来的判据基建
★ 这一轮从用户一句「滑动手势呢？」开始。查下去发现它不是"顺手加个手势"，
而是 `docs/DEBTS.json` 里挂着的一笔债 —— `gesture-semantics` 的原话是：
「P6 第 3 步：鸿蒙侧出现滑动手势代码时**立即建**判据
（此前建 = 只有一端存在的假判据）」
也就是**先有手势、再钉语义**。WebUI 2026-09-14 就有滑动翻页（用户当时
亲口提的），鸿蒙一直没有 ⇒ 之前建判据会是空真（∀x∈∅）。
## 一、手势本体（两端语义逐项对齐，数值各自定）
按 `HARMONY-ALIGN-PLAN.md:118-128` 显式选的 **(b) 口径**：
「手势的物理量本来就不该强求同值……该对齐的是**语义层**」。
· 判定逻辑放**纯逻辑层** `model/Calendar.ts` 的 `judgeSwipe`（可被 node 直跑，
写在 .ets 里就跑不了判据，语义没法被单测钉住）。四道门：位移 / 纵向优先 /
快滑窗口 / 方向。
· 阈值**不引用** WebUI 的 40 / 1.5 / 600（那是把巧合当契约），
各自定为 56vp / 1.4× / 700ms，并在注释里写出取值依据。
· 接线在 `CalendarPage.ets`：`PanGesture({direction: Horizontal})` +
`onActionStart`（记时 —— `GestureEvent` **没有时间戳字段**，我查了 SDK
的 gesture.d.ts 确认）+ `onActionEnd`（读 offsetX/offsetY）。
· ★ 挂在**网格列**上而不是整页：右栏（日程/编辑器）里有输入框与可滚内容，
整页挂会让「在表单里横划一下」变成翻月。
· ★ 翻页复用 `shiftRange()`（与 ‹ › 按钮**同一个来源**）—— WebUI 的注释
专门交代过：各写一套的话，阈值、边界、三档行为迟早分叉。
手势回调里**不准**直接改 year/month（锚点是唯一真相，年月只能由
`shiftRange → syncYearMonthFrom` 派生）。
**有意差异（记录在案，不是漏做）**：WebUI 在周/日档会额外检查「触点是否落在
可横向滚动的区域里」，是则让给滚动条（用户 2026-09-14 报过这个冲突）。
鸿蒙周档是「一行 7 格按 layoutWeight 等分」、**不横滚** ⇒ 该条件不适用。
哪天加了横滚必须同时补上它。
## 二、判据（8 条语义契约 + 行为层）
新增 `cross-client-gesture.test.mjs`：两端都真有手势 / 方向映射逐项相同 /
纵向优先 / 快滑窗口 / 复用同一翻页函数 / 无边界回弹 / 有意差异被记录 / 自检。
**只比语义、不比数值**，并反向断言鸿蒙的阈值常量不得直接取 WebUI 的那三个数。
`harmony-logic.test.mjs` 加行为判据：真跑 `judgeSwipe`，把四道门各自验一遍
（只钉字符串的话，一个 return 写漏了照样全绿）。
## 三、顺手修掉的三处**判据基建**缺陷（不修就没法验证上面这些）
1. `run-all.mjs` 只认 `# pass N`，而 node v24 打的是 `ℹ pass N`
⇒ **21 个文件被记成"没自报条数"**、套件在 HEAD 就恒红（memory 里记过这条，
修法也记过，今天终于落进代码：4 个正则加 `(?:#|ℹ)`）。修完 `unreported` 27 → 0。
代价是暴露出一批此前被"没自报"掩盖的真实问题（下面 4~6 条）。
2. `harmony-nav` 的设备判据 `navItemsOf`：宽屏过滤条件从「左边缘靠左 1/6」
改成「**整个盒子在侧栏轨道内**」。旧条件把**日历网格的格子**
（实测 `[229,511][366,794]`）也当成导航项，一屏数出 11~12 个。
这是设备实测抓出来的 —— 我第一版还以为是"底部簇混进来了"，
打印真实数据才发现是隔壁页面的格子。
3. `harmony-logic` 两处：从 `NAV_ITEMS` / `NAV_SIDEBAR_ITEMS` **各自的数组**里取
label。原先把全文件 `label:` 一网打尽 ⇒ 得到 7 个（4+3 混在一起），
任何一边改对了它都会红。
## 四、被判据拦住后的正经修法（每条都按判据自己给的方向改，不改判据迁就代码）
· `cross-client-theme` A2 拦住我：新增的 `navActiveBg`/`navBrandFg`/`badgePlain`
未登记；又拦住我：`sseColorOf` 里四个裸色值。→ 抽成 `Theme.sseConnected` 等
四个令牌（取值对齐 WebUI 的 Tailwind 类）+ 登记 + 在 Theme.ets 的表里写理由。
· 同一条判据的"死令牌"检出：`Theme.durBase` 声明了却从没人读。
**查 WebUI 才发现壁纸淡入是真有的动效**（`index.css:742-752` 的
`.app-backdrop` 从 opacity:0 → 1，180ms）⇒ 补上而不是删令牌
（删掉等于把差异抹平、还说成"清理"）。reset 在 `animateTo` **外**，
与 `calPaneIn` 同一条纪律。
· 玻璃登记：`NavItemBuilder` → `SidebarItem`（重构后按最近的 @Builder 命名），
登记同步跟上。
· `harmony-admin` 的退出判据：退出逻辑抽成 `api/Logout.ets` 的 `performLogout()`
（两个入口——「我的」页与侧栏底簇——必须做同一件事，尤其"先注销推送 token"
那一步）。判据相应改成**追到实际执行处**（两半都断：按钮调了 + 函数真清了全部），
并写明"别再退回直接匹配 SETTINGS_PAGE 的写法"（那会随重构假红，
下一个人只会去改判据而不看行为）。
· `harmony-widescreen` 的连接点色值：色值搬进 Theme 后，判据改成断
「令牌定义对了 + 侧栏真的用了它」两半（只断任一半都有假绿形态）。
· `align-refs`：`CalendarView.tsx` 变了，按判据要求**读一遍差异**再更新登记
（差异只有农历小字的灰阶档位 gray-300→gray-400/500，**骨架未变**）。
· `criteria-hygiene`：`harmony-contacts` 自造了一个 `code()`、`harmony-widescreen`
裸用 `readFileSync` ⇒ 都改用 `lib/read.mjs` 的共享入口。
途中撞出一个**判据自己的 bug**：`code()` 的块注释正则
`/\*[\s\S]*?\*\//` 会把注释里出现的 `/*`（如 `/」**` 这种中文夹星号）
当成块注释起点，一路吃到几十行后的 `*/`，把中间的 import 全吞掉 ——
于是 hygiene 判据假红"没 import"。改掉那处写法后正常。
## 五、验证
判据面：`run-all.mjs` → `files=32 ran=32 checks=497 pass=497 fail=0
skip=0 red=0 broken=0 unreported=0`。
其中新/改判据：gesture 8、nav 18、widescreen 7、logic 30、admin 27、
cross-client-theme 15、criteria-hygiene 6。
构建：`hvigorw assembleHap` 成功；前端 `npm run build` + 重新打 AppImage/deb
（`build-stamp` 7/7、`packaging` 5/5）。
**设备实测（HATriple 三折叠 3184×2232，hdc 连 127.0.0.1:5555）**：
· 农历在格子里真的显示（1=二十 / 7=廿六 / 19=**初九** / 11=八月），与 WebUI 一致；
这条同时验证了**服务端农历路由已部署**（之前线上是 404）。
· 日历左右两栏：编辑器出现在**右栏**、左栏月份仍可见（单栏模式下编辑器会整页盖掉它）。
· 侧栏 3 项 + 底部一簇；徽标回到图标右上角。
**仍未验（如实标注）**：滑动翻页的**手感**（阈值 56vp/1.4×/700ms 是否合适）
只能真人滑过才知道；我只验了判定逻辑与接线形态。动画同理 ——
机制已验证（`animateTo` 驱动 + reset 在窗口外），但"看起来顺不顺"未做取样验证。
docs：`DEBTS.json` 销掉 `gesture-semantics`（并记结算说明）、
`HARMONY-ALIGN-PLAN.md` P6 从「✅（滑动翻页除外）」改为 ✅。
This commit is contained in:
239
client/electron/test/cross-client-gesture.test.mjs
Normal file
239
client/electron/test/cross-client-gesture.test.mjs
Normal file
@ -0,0 +1,239 @@
|
||||
/**
|
||||
* 左右滑动翻页的**语义契约**：两端逐项相同，数值各自定。
|
||||
*
|
||||
* 这条判据是 `docs/DEBTS.json` 的 `gesture-semantics` 那条债的还款 ——
|
||||
* 它的原文是：
|
||||
*
|
||||
* 「P6 第 3 步：鸿蒙侧出现滑动手势代码时立即建
|
||||
* （此前建 = 只有一端存在的假判据）」
|
||||
*
|
||||
* 也就是**先有手势、再钉语义**。2026-09-19 鸿蒙侧真的加了手势
|
||||
* （`CalendarPage.ets` 的 `PanGesture` + `model/Calendar.ts` 的 `judgeSwipe`），
|
||||
* 所以现在建。
|
||||
*
|
||||
* ★ 为什么钉语义而不是钉数值
|
||||
*
|
||||
* `docs/HARMONY-ALIGN-PLAN.md:118-128` 显式选了 (b) 口径，理由是原话：
|
||||
* 「手势的物理量本来就不该强求同值。40px 的位移阈值、600ms 的"快滑"判据，
|
||||
* 在触摸屏与鼠标上、在手机与大屏上，人体工学的合理值天然不同；
|
||||
* 强行同值会得到一个两边都不舒服的数。该对齐的是**语义层**。」
|
||||
*
|
||||
* 所以本文件**从两端源码里各自读一遍语义**（不是读常量名、不是读注释），
|
||||
* 再逐项比对：
|
||||
*
|
||||
* | 语义 | WebUI 侧证据 | 鸿蒙侧证据 |
|
||||
* |------------|-------------------------------------------|-------------------------|
|
||||
* | 左滑=下一段 | `shift(dx < 0 ? 1 : -1)` | `dx < 0 ? 1 : -1` |
|
||||
* | 右滑=上一段 | 同上 | 同上 |
|
||||
* | 纵向优先 | `Math.abs(dx) < Math.abs(dy) * 1.5` | `Math.abs(dx) < Math.abs(dy) * X` |
|
||||
* | 慢拖不翻页 | `Date.now() - start.t < 600` | `ms > Y` 时 return |
|
||||
* | 无边界回弹 | `addMonths` 无钳制（可任意前后） | 同（`addMonths`） |
|
||||
* | 手势复用按钮逻辑 | 手势与按钮都调 `shift()` | 手势与按钮都调 `shiftRange()` |
|
||||
*
|
||||
* 数值（`40` / `1.5` / `600`）**只做形状校验**（是数字、是正数），
|
||||
* 断言它们**相等**才是错的 —— 那会把 (b) 口径推翻。
|
||||
*/
|
||||
import { code, prose } from './lib/read.mjs';
|
||||
import { test } from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import { dirname, join } from 'node:path';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const HERE = dirname(fileURLToPath(import.meta.url));
|
||||
const ROOT = join(HERE, '..', '..', '..');
|
||||
const HARMONY_ETS = join(ROOT, 'client/harmony/entry/src/main/ets');
|
||||
|
||||
/** WebUI 的手势实现在日历组件里 */
|
||||
const webCal = code(join(ROOT, 'client/electron/src/components/CalendarView.tsx'));
|
||||
/** 鸿蒙的判定逻辑在纯逻辑层（可被 node 直接执行，另有行为判据跑它） */
|
||||
const harmonyLogic = code(join(HARMONY_ETS, 'model/Calendar.ts'));
|
||||
/** 鸿蒙的接线（手势挂在哪个容器上） */
|
||||
const harmonyPage = code(join(HARMONY_ETS, 'pages/CalendarPage.ets'));
|
||||
|
||||
/* ────────────────────────── ① 两端都真的存在手势 ────────────────────────── */
|
||||
|
||||
test('两端都有左右滑动翻页的代码（不是只有一端）', () => {
|
||||
/*
|
||||
* 这是本文件存在的前提。`docs/HARMONY-ALIGN-PLAN.md:136-140` 记过：
|
||||
* 鸿蒙侧当时**没有日历页、也没有任何手势代码**，此时"两端逐项相同"
|
||||
* 只有一端存在 ⇒ 任何断言都是空真（`∀x∈∅`）。所以第一条就把这个前提钉住。
|
||||
*/
|
||||
assert.match(webCal, /onTouchStart/,
|
||||
'WebUI 侧要有触摸起点（`CalendarView.tsx` 的 onTouchStart）');
|
||||
assert.match(webCal, /onTouchEnd/,
|
||||
'WebUI 侧要有触摸终点（判定位移与时长的地方）');
|
||||
|
||||
assert.match(harmonyPage, /PanGesture\s*\(/,
|
||||
'鸿蒙侧要有手势（`PanGesture`）—— 没有它本判据是空真，正是那条债警告的事');
|
||||
assert.match(harmonyLogic, /export function judgeSwipe\s*\(/,
|
||||
'鸿蒙侧的判定要落在**纯逻辑层**（`model/Calendar.ts` 的 judgeSwipe）—— ' +
|
||||
'写在 .ets 里就跑不了 node 判据，语义没法被单测钉住');
|
||||
});
|
||||
|
||||
/* ────────────────────── ② 语义逐项相同（不比数值） ────────────────────── */
|
||||
|
||||
test('★ 语义：左滑 = 下一段，右滑 = 上一段（两端同）', () => {
|
||||
/*
|
||||
* 这是最容易写反、也最容易被"看起来在动"掩盖的一条：
|
||||
* 方向反了功能完全正常，只是与另一端的体感相反 —— 用户跨端用会觉得很怪。
|
||||
*
|
||||
* 两端的写法都必须是 `dx < 0 ? +1 : -1` 这个**同一个形状**：
|
||||
* 左滑（dx 为负）= 前进（+1）；右滑（dx 为正）= 后退（-1）。
|
||||
*/
|
||||
const webDir = webCal.match(/shift\(dx\s*<\s*0\s*\?\s*(\d+)\s*:\s*(-?\d+)\)/);
|
||||
assert.ok(webDir,
|
||||
'WebUI 的方向映射要能读出来（形如 `shift(dx < 0 ? 1 : -1)`）');
|
||||
assert.equal(webDir[1], '1', 'WebUI：左滑（dx<0）应映射为 +1（下一段）');
|
||||
assert.equal(webDir[2], '-1', 'WebUI：右滑应映射为 -1（上一段）');
|
||||
|
||||
const hDir = harmonyLogic.match(/delta\s*=\s*dx\s*<\s*0\s*\?\s*(\d+)\s*:\s*(-?\d+)/);
|
||||
assert.ok(hDir,
|
||||
'鸿蒙的方向映射要能读出来（形如 `v.delta = dx < 0 ? 1 : -1`）');
|
||||
assert.equal(hDir[1], webDir[1],
|
||||
'★ 左滑在两端的映射必须相同（这里**该**比数值，因为它是语义不是物理量）');
|
||||
assert.equal(hDir[2], webDir[2],
|
||||
'★ 右滑同理');
|
||||
});
|
||||
|
||||
test('★ 语义：纵向优先 —— 横向位移必须明显大于纵向，两端都有这道门', () => {
|
||||
/*
|
||||
* 移动端最容易犯的手势错误：用户在纵向列表上滚，手指天然带一点横向偏移，
|
||||
* 不卡这条就会"滚着滚着翻页了"。
|
||||
*
|
||||
* 两端都要有这道门，且形状必须是「横向 < 纵向 * 倍数 ⇒ 放弃」。
|
||||
* 倍数是多少**不比**（(b) 口径），但必须是个正数。
|
||||
*/
|
||||
const webAxis = webCal.match(/Math\.abs\(dx\)\s*<\s*Math\.abs\(dy\)\s*\*\s*([\d.]+)/);
|
||||
assert.ok(webAxis, 'WebUI 要有"横向 vs 纵向"这道门');
|
||||
assert.ok(Number(webAxis[1]) > 1,
|
||||
`WebUI 的倍数应 > 1（实测 ${webAxis[1]}）—— 等于 1 时斜滑就翻页，判据等于没有`);
|
||||
|
||||
const hAxis = harmonyLogic.match(/Math\.abs\(dx\)\s*<\s*Math\.abs\(dy\)\s*\*\s*([A-Z_]+|[\d.]+)/);
|
||||
assert.ok(hAxis, '鸿蒙要有"横向 vs 纵向"这道门（漏了它 = 纵向滚动会误翻页）');
|
||||
|
||||
/* 数值不同是**允许的**（(b)），但取值来源要说清是常量而不是裸字面量 */
|
||||
assert.match(harmonyLogic, /export const SWIPE_AXIS_RATIO:\s*number\s*=\s*[\d.]+/,
|
||||
'鸿蒙的倍数要走具名常量（裸字面量会让"这个数为什么是它"无从追溯）');
|
||||
});
|
||||
|
||||
test('★ 语义：慢拖不翻页（"快滑"是感知档，不是同一个毫秒数）', () => {
|
||||
/*
|
||||
* WebUI：`const fast = Date.now() - start.t < 600` + `!fast → return`。
|
||||
* 鸿蒙：`if (ms > SWIPE_MAX_DURATION_MS) return v;`。
|
||||
*
|
||||
* 两端都要有这道门；**毫秒数不比**。
|
||||
*/
|
||||
const webFast = webCal.match(/Date\.now\(\)\s*-\s*start\.t\s*<\s*(\d+)/);
|
||||
assert.ok(webFast, 'WebUI 要有"快滑"时间窗（否则慢慢拖也会翻页）');
|
||||
assert.ok(Number(webFast[1]) > 0, 'WebUI 的时间窗应为正数');
|
||||
|
||||
const hFast = harmonyLogic.match(/ms\s*>\s*SWIPE_MAX_DURATION_MS/);
|
||||
assert.ok(hFast, '鸿蒙要有"快滑"时间窗这道门');
|
||||
assert.match(harmonyLogic, /export const SWIPE_MAX_DURATION_MS:\s*number\s*=\s*\d+/,
|
||||
'鸿蒙的时间窗要走具名常量');
|
||||
|
||||
/*
|
||||
* ★ 反向断言：鸿蒙**不得**引用 WebUI 的那三个数。
|
||||
* 这正是 (b) 口径的落点 —— 一旦有人"抄过去省事"，两端就被锁在一起，
|
||||
* 以后为大屏调阈值会同时改坏手机端。计划文档明写「鸿蒙**不得引用** WebUI 的三个数」。
|
||||
*/
|
||||
for (const forbidden of ['40', '600', '1.5']) {
|
||||
const asStandalone = new RegExp(`SWIPE_[A-Z_]*:\\s*number\\s*=\\s*${forbidden.replace('.', '\\.')}\\b`);
|
||||
assert.ok(!asStandalone.test(harmonyLogic),
|
||||
`★ 鸿蒙的阈值常量不得直接取 WebUI 的值 ${forbidden} —— ` +
|
||||
'(b) 口径要求数值各自定（见 HARMONY-ALIGN-PLAN.md:118-128）');
|
||||
}
|
||||
});
|
||||
|
||||
test('★ 语义：手势与翻页按钮复用**同一个**翻页函数（两端同）', () => {
|
||||
/*
|
||||
* WebUI 的原话：「复用 shift() —— 手势与「上一月/下一月」按钮必须是同一套翻页逻辑，
|
||||
* 各写一遍的话阈值、边界、"周/日/月"三种刻度的行为迟早分叉。」
|
||||
*
|
||||
* 鸿蒙对应的函数是 `shiftRange()`（`shiftMonth` 只是它的旧名包装）。
|
||||
* 断言方式：页面里出现的手势判定结果必须交给 shiftRange，
|
||||
* 而不是自己算日期/自己改 year/month。
|
||||
*/
|
||||
assert.match(harmonyPage, /if\s*\(v\.turned\)\s*\{[\s\S]{0,60}this\.shiftRange\(v\.delta\)/,
|
||||
'★ 手势判定通过后必须调 `shiftRange(v.delta)` —— 不能自己改 year/month，' +
|
||||
'那会出现"手势翻 1 天、按钮翻 7 天"的分叉');
|
||||
|
||||
/* 手势那一支里不得直接写 year/month（那是 shiftRange 的职责） */
|
||||
const gestureBlocks = harmonyPage.match(/\.onActionEnd\([\s\S]{0,400}?\}\)/g) ?? [];
|
||||
assert.ok(gestureBlocks.length >= 1, '要能找到手势的 onActionEnd 回调');
|
||||
for (const b of gestureBlocks) {
|
||||
assert.ok(!/this\.(year|month)\s*=/.test(b),
|
||||
'★ 手势回调里不得直接改 `year`/`month` —— 锚点是唯一真相，' +
|
||||
'年月只能由 `shiftRange` → `syncYearMonthFrom` 派生');
|
||||
}
|
||||
});
|
||||
|
||||
test('★ 语义：翻页无边界回弹（两端一致）', () => {
|
||||
/*
|
||||
* 语义表里那一行是「翻页边界是否回弹」。两端的答案都是"没有边界"：
|
||||
* `addMonths(year, month, delta)` 直接把 month 折进 year（`total % 12`），
|
||||
* 不钳制范围 ⇒ 可以一直往前/往后翻，不存在"到头了"的状态，
|
||||
* 因此**没有回弹动画可看**（不是"忘了做回弹"）。
|
||||
*
|
||||
* 这条判据防的是"哪天有人加了钳制"：加了钳制就得同时定义回弹语义，
|
||||
* 而那是一个两端都要改的契约变更，不能只改一边。
|
||||
*/
|
||||
const webAddMonths = webCal.includes('addMonths');
|
||||
assert.ok(webAddMonths, 'WebUI 翻页走 addMonths（无钳制）');
|
||||
/*
|
||||
* 锚点要短：`addMonths` 只有两行，中间隔不了多少字符。
|
||||
* （第一版写 `[\s\S]{0,140}?total\s*%\s*12` 反而没匹上 —— 我把它想长了。）
|
||||
*/
|
||||
assert.match(harmonyLogic, /export function addMonths\([\s\S]*?total % 12/,
|
||||
'★ 鸿蒙的 addMonths 必须仍是取模折年（有边界就不对称了）；' +
|
||||
'若哪天要加钳制，回弹语义必须两端一起定');
|
||||
});
|
||||
|
||||
/* ─────────────────────── ③ 有意差异被记录（不是漏做） ─────────────────────── */
|
||||
|
||||
test('有意差异：周档的"横滚冲突让位"在鸿蒙侧不存在 —— 但必须被记录', () => {
|
||||
/*
|
||||
* WebUI 在**周/日档**额外检查「触点是否落在可横向滚动的区域里」，
|
||||
* 是则把手势让给滚动条。用户 2026-09-14 亲口报过这个冲突：
|
||||
* 「横向滚动条会与切换视图的手势冲突，我觉得周视图需要卡严条件」。
|
||||
*
|
||||
* 鸿蒙侧**没有这个冲突**：周档是"一行 7 格、按 layoutWeight 等分"，不横滚。
|
||||
* 所以这一条**不适用**，不是漏做。
|
||||
*
|
||||
* 判据两半（缺一不可）：
|
||||
* ① 鸿蒙的周档确实不横滚（否则就该补卡严条件，而它没补 = 真漏）；
|
||||
* ② 这件事在代码里被**记录下来**（下一个人看到 WebUI 有、鸿蒙没有时，
|
||||
* 要能查到这是有意的，而不是当成待办）。
|
||||
*/
|
||||
const strictWeb = /startsInHorizontalScroller/.test(webCal);
|
||||
assert.ok(strictWeb, 'WebUI 侧应有"落在横滚区域就让位"的检查');
|
||||
|
||||
assert.ok(!/Scroll\s*\(\s*\)\s*\{[\s\S]{0,200}?calScale\s*===\s*'week'/.test(harmonyPage),
|
||||
'鸿蒙周档目前不横滚（若改成横滚，必须同时补上这条卡严条件）');
|
||||
|
||||
/*
|
||||
* ★ 读**注释**要用 `prose`（不剥注释），不能用 `code`：
|
||||
* 这条断言判的正是「理由有没有被写下来」，而理由天然在注释里。
|
||||
* 我第一版用了 code()，它把注释剥掉了 ⇒ 永远红。
|
||||
*/
|
||||
const harmonyLogicProse = prose(join(HARMONY_ETS, 'model/Calendar.ts'));
|
||||
assert.match(harmonyLogicProse, /有意\*\*未对齐\*\*的一条|有意未对齐/,
|
||||
'★ 鸿蒙侧要把"这条为什么不适用"写进代码注释 —— ' +
|
||||
'两端行为不同的地方不留记录，下一个人只会当成漏做（§7.12 的同一纪律）');
|
||||
});
|
||||
|
||||
/* ─────────────────────────── ④ 判据自检 ─────────────────────────── */
|
||||
|
||||
test('★ 判据自检：方向写反必须判红', () => {
|
||||
/*
|
||||
* 没有自检的判据是"看起来在跑"的判据。这里模拟"有人把左滑写成上一段"，
|
||||
* 确认 ② 那条能红 —— 若不能红，说明它锚错了地方（读的是别的字符串）。
|
||||
*/
|
||||
const mutated = harmonyLogic.replace(/delta\s*=\s*dx\s*<\s*0\s*\?\s*1\s*:\s*-1/,
|
||||
'delta = dx < 0 ? -1 : 1');
|
||||
assert.notEqual(mutated, harmonyLogic, '变异要有实际效果（锚点必须命中）');
|
||||
/* 变异后**不能**再匹配上「左滑=+1」那个形状 —— 这才是那条断言真正的咬法 */
|
||||
const stillOk = /delta\s*=\s*dx\s*<\s*0\s*\?\s*1\s*:\s*-1/.test(mutated);
|
||||
assert.equal(stillOk, false,
|
||||
'★ 方向写反时，②「左滑=下一段」那条必须能判红');
|
||||
});
|
||||
@ -220,7 +220,34 @@ const SELF_OWNED_COLORS = [
|
||||
// 业务语义色：系统没有对应物（同意 / 拒绝 / 警示）
|
||||
'approve', 'danger', 'approveBg', 'approveFg', 'dangerBg', 'warnBg', 'warnFg',
|
||||
// 权限档位与预算档位的胶囊配色（档位是产品语义，系统不认识"plan/workspace/full"）
|
||||
'chipNeutralBg', 'chipNeutralFg', 'chipSpentBg', 'chipSpentFg', 'chipWarnBg', 'chipWarnFg'
|
||||
'chipNeutralBg', 'chipNeutralFg', 'chipSpentBg', 'chipSpentFg', 'chipWarnBg', 'chipWarnFg',
|
||||
/*
|
||||
* ★★ 2026-09-19 补登记（对应用户「底栏数字为什么显示在图标下面？」与
|
||||
* 用户「你写的app和webui大面积不符」那两轮改动）。
|
||||
*
|
||||
* 三个值都是**跨端身份色**，系统语义色里没有对应物：
|
||||
* · `navActiveBg` #DBEAFE —— WebUI `index.css:1595-1606` 的 `--nav-active-bg`，
|
||||
* 侧栏选中项的**浅蓝底块**（宽屏侧栏的选中线索就是它，不是文字变色）。
|
||||
* · `navBrandFg` #475569 —— WebUI 的 `--nav-fg-muted`，侧栏未选中项的图标色。
|
||||
* · `badgePlain` #475569 —— WebUI `bg-chrome-600`（`index.css:92`），
|
||||
* "plain" 档徽标底色（联系人数）。**它必须是石板灰而不是红**：
|
||||
* 三档被压成两档时，`'plain'` 会走 `danger`，看起来像"有未读"。
|
||||
* `chrome-600` 刻意不透明（`index.css:1097` 有注释：15px 小控件叠透明度
|
||||
* 会让数字掉到 4.46:1，低于 WCAG AA）。
|
||||
*
|
||||
* 三者的取值理由都已写在 `Theme.ets` 各自的注释里（本判据的要求）。
|
||||
*/
|
||||
'navActiveBg', 'navBrandFg', 'badgePlain',
|
||||
/*
|
||||
* SSE 连接指示器的四个状态色（`WideSidebar.ets` 的 `sseColorOf`）。
|
||||
* 逐档对齐 WebUI 的 Tailwind 类（`ConnectionIndicator.tsx:22-25`）：
|
||||
* connected `bg-green-500` / connecting `bg-yellow-400` /
|
||||
* reconnecting `bg-orange-400` / disconnected `bg-red-400`。
|
||||
*
|
||||
* 为什么不复用 `warnFg`/`danger`：那两个是**文字色**，而状态点是 8px 实心圆，
|
||||
* 用文字色会发脏、深色底上不够跳。WebUI 也是分开的两套（`text-*` vs `bg-*`）。
|
||||
*/
|
||||
'sseConnecting', 'sseConnected', 'sseReconnecting', 'sseDisconnected'
|
||||
];
|
||||
|
||||
test('A2｜Theme.ets 里"自己写的色"必须**登记过**：新写死一个色不该默默通过', () => {
|
||||
@ -307,7 +334,7 @@ const GLASS_REGISTRY = [
|
||||
// 文件（相对 ets 根） + 组件/Builder 名：为什么这里可以有一层系统材质
|
||||
{ file: 'pages/MainPage.ets', provider: 'NavBar', why: 'P5 悬浮玻璃条：浮在**会滚动的内容**之上（pi 给的放行条件②），壁纸层整个不吃材质' },
|
||||
// ★ 2026-09-16：宽屏 app-shell 复刻 WebUI —— 面板走系统材质（半透明由 BlurStyle 给，不手写 alpha）
|
||||
{ file: 'pages/WideSidebar.ets', provider: 'NavItemBuilder', why: '宽屏侧栏（判据按最近的 @Builder 命名）：浮在壁纸之上、背后是会滚动的导航内容（WebUI Sidebar 同形状），bgActive 才开' }
|
||||
{ file: 'pages/WideSidebar.ets', provider: 'SidebarItem', why: '宽屏侧栏（判据按最近的 @Builder 命名）：浮在壁纸之上、背后是会滚动的导航内容（WebUI Sidebar 同形状），bgActive 才开。★ 2026-09-19 改名：原先登记的是 NavItemBuilder，但那是我上一版编造的“复刻”（参见 Theme.ets 里那段更正）—— 重写后按 WebUI 拆成导航轨 + 底部一簇，@Builder 相应改名，登记同步跟上（判据就是为此存在的）' }
|
||||
];
|
||||
|
||||
/**
|
||||
|
||||
@ -45,6 +45,8 @@ const ADMIN_PAGE = join(ETS, 'pages/AdminUsersPage.ets');
|
||||
const SETTINGS_PAGE = join(ETS, 'pages/SettingsPage.ets');
|
||||
const ADMIN_API = join(ETS, 'api/AdminApi.ets');
|
||||
const ACCOUNT_MGR = join(ETS, 'api/AccountManager.ets');
|
||||
/** 退出登录的唯一实现（两个入口共用）—— 2026-09-19 抽出来后才有的文件 */
|
||||
const LOGOUT_MOD = join(ETS, 'api/Logout.ets');
|
||||
const PAGES_JSON = join(ROOT, 'client/harmony/entry/src/main/resources/base/profile/main_pages.json');
|
||||
|
||||
// 真跑纯逻辑（有 `@ohos` 依赖的文件不能这样跑；AdminUsers.ts 刻意零 import）
|
||||
@ -420,10 +422,31 @@ test('★ 退出登录必须清**全部**账号（否则被 LoginPage 快速登
|
||||
* 这是鸿蒙特有的路径（WebUI 没有"本机多账号库自动恢复"，
|
||||
* 所以它的 `logout()` 只 `set({phase:'anonymous'})` 就够）。
|
||||
*/
|
||||
/*
|
||||
* ★★ 2026-09-19 修：退出逻辑被抽成了 `api/Logout.ets` 的 `performLogout()`。
|
||||
*
|
||||
* 为什么要抽（不是为了好看）：退出有**两个入口** —— 「我的」页的按钮、
|
||||
* 宽屏侧栏底部那一簇的退出键。复制一份实现的话迟早分叉，而最容易分叉的
|
||||
* 恰恰是**最不能少的那一步**（注销推送 token —— 少了它，退出后服务器还会
|
||||
* 往一台"已退出"的设备推通知）。所以两个入口都走同一个函数。
|
||||
*
|
||||
* 本判据相应改成**追到实际执行处**：断言「我的」页真的调了 performLogout，
|
||||
* 且 performLogout 里真的清了全部账号。**两半都要断** ——
|
||||
* 只断第一半会放过"performLogout 被改成空实现"，
|
||||
* 只断第二半会放过"按钮没接上"（那种情况页面里照样有 performLogout 这几个字）。
|
||||
*
|
||||
* ⚠️ 别退回"直接匹配 SETTINGS_PAGE 里的 clearAll()"的写法：
|
||||
* 那会随重构假红（今天就是），于是下一个人只会去改判据、而不去看行为。
|
||||
*/
|
||||
const src = code(SETTINGS_PAGE);
|
||||
assert.match(src, /clearAll\(\)/,
|
||||
assert.match(src, /performLogout\(/,
|
||||
'★ 「我的」页的退出要调 performLogout()（与侧栏底部簇共用同一个实现）');
|
||||
|
||||
/* 第二半：那个函数真的清了**全部**账号，而不是只清当前 */
|
||||
const logoutSrc = code(LOGOUT_MOD);
|
||||
assert.match(logoutSrc, /clearAll\(\)/,
|
||||
'★ 退出要调 AccountManager.clearAll()（清全部账号）');
|
||||
assert.ok(!/clearActive\(\)/.test(src),
|
||||
assert.ok(!/clearActive\(\)/.test(logoutSrc),
|
||||
'不得只清"当前"账号 —— 库里的其余账号会让快速登录路径把退出撤销掉');
|
||||
|
||||
// 被调的那个方法真的存在，且真的清空
|
||||
|
||||
@ -30,17 +30,19 @@ import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import { dirname, join } from 'node:path';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { readFileSync } from 'node:fs';
|
||||
import { code, prose } from './lib/read.mjs';
|
||||
|
||||
const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
|
||||
const ETS = join(ROOT, 'client', 'harmony', 'entry', 'src', 'main', 'ets');
|
||||
|
||||
/** 去注释：判据要判**代码**，不是判我们自己在注释里写的那些话 */
|
||||
function code(p) {
|
||||
return readFileSync(p, 'utf8')
|
||||
.replace(/\/\*[\s\S]*?\*\//g, '')
|
||||
.replace(/^\s*\/\/.*$/gm, '');
|
||||
}
|
||||
/*
|
||||
* ★ 2026-09-19：本文件原先**自造**了一个 `code()`（自己写去注释正则）。
|
||||
* `criteria-hygiene` 判据拦的正是这个 —— 判据目录有一条"裸用 readFileSync"的
|
||||
* 禁令，理由不是洁癖：`code`/`prose` 的选择决定"判的是代码还是注释"，
|
||||
* 各文件自造一份，就等于每个文件对同一件事有各自的说法。
|
||||
* 改用 `test/lib/read.mjs` 的共享入口。
|
||||
*/
|
||||
|
||||
|
||||
const MAIN = join(ETS, 'pages', 'MainPage.ets');
|
||||
const API = join(ETS, 'api', 'MailApi.ets');
|
||||
|
||||
@ -607,3 +607,67 @@ test('★ 判据自检：把状态机的默认页签改错必须判红', () => {
|
||||
const defaultMutated = prose(COMM_TS).replace("export const COMM_TAB_DEFAULT: string = 'inbox';", "export const COMM_TAB_DEFAULT: string = 'sent';");
|
||||
assert.ok(!/COMM_TAB_DEFAULT: string = 'inbox'/.test(defaultMutated), '自检：默认页签变异没生效');
|
||||
});
|
||||
|
||||
/* ─────────────────── 左右滑动翻页：行为（不是"代码里有"） ─────────────────── */
|
||||
|
||||
test('★ 行为：滑动判定四道门各自真的在拦（跑 judgeSwipe，不看字符串）', async () => {
|
||||
/*
|
||||
* 上一条跨端判据钉的是"两端语义相同"，这里钉的是"这道门真的会拦住"。
|
||||
* 两条都要有：只钉语义的话，一个 `return` 写漏了照样全绿。
|
||||
*/
|
||||
const CAL = await import(pathToFileURL(join(HARMONY_ETS, 'model/Calendar.ts')).href);
|
||||
const { judgeSwipe, SWIPE_MIN_DISTANCE, SWIPE_AXIS_RATIO, SWIPE_MAX_DURATION_MS } = CAL;
|
||||
|
||||
// ① 正常快滑：左滑 = 下一段
|
||||
const next = judgeSwipe(-200, 10, 120);
|
||||
assert.equal(next.turned, true, '横向位移足够大 + 够快 ⇒ 应判为翻页');
|
||||
assert.equal(next.delta, 1, '★ 左滑（dx<0）必须是 +1（下一段）');
|
||||
// 右滑 = 上一段
|
||||
const prev = judgeSwipe(200, 10, 120);
|
||||
assert.equal(prev.delta, -1, '★ 右滑（dx>0）必须是 -1（上一段）');
|
||||
|
||||
// ② 位移不够 —— 轻点/微抖不该翻页
|
||||
assert.equal(judgeSwipe(-(SWIPE_MIN_DISTANCE - 1), 0, 100).turned, false,
|
||||
'位移小于阈值 ⇒ 不翻页（否则点一下就会翻）');
|
||||
assert.equal(judgeSwipe(SWIPE_MIN_DISTANCE + 1, 0, 100).turned, true,
|
||||
'刚过阈值 ⇒ 应翻页（阈值不能写大到正常滑动都不触发）');
|
||||
|
||||
// ③ 纵向优先 —— 这是移动端最容易犯的错
|
||||
assert.equal(judgeSwipe(-100, 90, 100).turned, false,
|
||||
'横向只比纵向大一点 ⇒ 不翻页（用户在纵向滚动）');
|
||||
assert.equal(judgeSwipe(-100, 90 / SWIPE_AXIS_RATIO, 100).turned, true,
|
||||
'横向达到倍数要求 ⇒ 应翻页');
|
||||
/* 纯纵向必然不翻 */
|
||||
assert.equal(judgeSwipe(5, -300, 100).turned, false, '纯纵向滚动不得翻页');
|
||||
|
||||
// ④ 慢拖不翻页
|
||||
assert.equal(judgeSwipe(-300, 0, SWIPE_MAX_DURATION_MS + 1).turned, false,
|
||||
'超过时间窗 ⇒ 不翻页（用户在瞄准/阅读，不是在翻）');
|
||||
assert.equal(judgeSwipe(-300, 0, SWIPE_MAX_DURATION_MS).turned, true,
|
||||
'正好在时间窗内 ⇒ 应翻页');
|
||||
|
||||
// ⑤ 阈值必须是正数（0 会让所有手势都翻页）
|
||||
assert.ok(SWIPE_MIN_DISTANCE > 0 && SWIPE_AXIS_RATIO > 1 && SWIPE_MAX_DURATION_MS > 0,
|
||||
'三个阈值都要是正数；倍数还必须 > 1（=1 时斜滑就翻页）');
|
||||
|
||||
// ⑥ 不翻页时 delta 必须是 0（否则调用方会拿 0 去翻页）
|
||||
for (const v of [judgeSwipe(1, 0, 100), judgeSwipe(-100, 500, 100), judgeSwipe(-300, 0, 99999)]) {
|
||||
assert.equal(v.turned, false);
|
||||
assert.equal(v.delta, 0, '未翻页时 delta 应为 0（不是 -1/1）');
|
||||
}
|
||||
});
|
||||
|
||||
test('★ 行为：手势触发的翻页与按钮触发的翻页走同一个函数（步长不会分叉）', () => {
|
||||
/*
|
||||
* 这条是"结构"判据但断的是**行为等价性**：手势与 ‹ › 按钮都必须进 shiftRange。
|
||||
* 各写一套的话，周档"手势翻 1 天、按钮翻 7 天"这种分叉不会报错、只会静静地不对。
|
||||
*/
|
||||
const page = code(join(HARMONY_ETS, 'pages/CalendarPage.ets'));
|
||||
const gestureCalls = [...page.matchAll(/this\.shiftRange\(v\.delta\)/g)].length;
|
||||
assert.ok(gestureCalls >= 2,
|
||||
`★ 宽屏与窄屏两处手势都要调 shiftRange（实际 ${gestureCalls} 处）—— ` +
|
||||
'只挂一屏会让另一屏没有手势，而那是"看起来已经做了"的最隐蔽形式');
|
||||
/* 按钮那一支 */
|
||||
assert.match(page, /\.onClick\(\(\)\s*=>\s*this\.shiftMonth\(-1\)\)/, '上一页按钮');
|
||||
assert.match(page, /\.onClick\(\(\)\s*=>\s*this\.shiftMonth\(1\)\)/, '下一页按钮');
|
||||
});
|
||||
|
||||
@ -490,13 +490,29 @@ test('★ 窗格切换有真的过场动画（transition 挂在会换的那棵
|
||||
assert.match(mainCode, /\.translate\(\{[^}]*calPaneIn[^}]*\}\)/,
|
||||
'★ 日历容器要同时驱动位移（对齐 WebUI `rise-in` 的 translateY）');
|
||||
// reset 必须在 animateTo **外** —— 否则起点=终点，动画退化
|
||||
const resetIdx = mainCode.indexOf('this.calPaneIn = 0');
|
||||
const animIdx = mainCode.indexOf('getUIContext().animateTo(');
|
||||
assert.ok(resetIdx > 0, '★ 切到日历前要先把 `calPaneIn` 瞬回 0（否则看不到“从无到有”）');
|
||||
assert.ok(resetIdx < animIdx || animIdx < 0,
|
||||
'★ `calPaneIn = 0` 必须在 `animateTo` **之前**：写进回调里会与同帧的 1 相抵，' +
|
||||
'渲染层只看得见最终值 ⇒ 动画退化成一次瞬移（等于没修）');
|
||||
const intoAnim = /getUIContext\(\)\.animateTo\([\s\S]{0,300}?this\.calPaneIn = 1/.exec(mainCode);
|
||||
/*
|
||||
* ★★ 2026-09-19 修（加壁纸淡入时撞出来的）：
|
||||
*
|
||||
* 原写法是「全文 indexOf('this.calPaneIn = 0') 与全文第一个 animateTo 比大小」。
|
||||
* 而 `MainPage.ets` 里 `animateTo` 不止一处 —— 新增壁纸淡入（`bgFadeIn`）
|
||||
* 之后，第一个 animateTo 出现在**日历那一大段之前** ⇒ `resetIdx < animIdx` 假红。
|
||||
*
|
||||
* 错法本身很典型：**拿全文下标去比两件相隔很远的事**。
|
||||
* 正确的锚法是：只看**日历那一处**的局部上下文 —— 从 `calPaneIn = 0`
|
||||
* 往后截一段，要求 `animateTo` 就出现在这段里且 `calPaneIn = 1` 在它之后。
|
||||
*/
|
||||
const calResetAt = mainCode.indexOf('this.calPaneIn = 0');
|
||||
assert.ok(calResetAt > 0, '★ 切到日历前要先把 `calPaneIn` 瞬回 0（否则看不到“从无到有”）');
|
||||
/* 截到 reset 之后的**同一段**（400 字符足够包住 animateTo + 赋值，又不会跨到别处） */
|
||||
const calLocal = mainCode.slice(calResetAt, calResetAt + 400);
|
||||
const localAnim = calLocal.indexOf('getUIContext().animateTo(');
|
||||
assert.ok(localAnim > 0,
|
||||
'★ `calPaneIn = 0` 之后必须紧跟 `animateTo`（同一段代码内）—— ' +
|
||||
'否则这个 reset 根本没被任何动画窗口包住，等于白 reset');
|
||||
assert.ok(!/calPaneIn = 1[\)\s]*;?\s*\}/.test(calLocal.slice(0, localAnim)),
|
||||
'★ `calPaneIn = 1` 不得出现在 animateTo **之前**；' +
|
||||
'reset 写进回调里会与同帧的 1 相抵，渲染层只看得见最终值 ⇒ 动画退化成一次瞬移（等于没修）');
|
||||
const intoAnim = /getUIContext\(\)\.animateTo\([\s\S]{0,300}?this\.calPaneIn = 1/.exec(calLocal);
|
||||
assert.ok(intoAnim,
|
||||
'★ 推到 1 要在 `animateTo` 窗口里（与其余窗格的 transition 同时长、同曲线）');
|
||||
|
||||
|
||||
@ -3,7 +3,7 @@
|
||||
// ★★ 2026-09-19 重写本文件的头部说明（上面那一版是错的，与它判的东西矛盾）：
|
||||
// 旧文写的是「60px 图标轨 / 通信·日历·联系人（中）/ 设置（底）/
|
||||
// 选中态只换颜色 + 品牌浅底，**不加背景块**」—— 那个描述是**编的**：
|
||||
// · `Sidebar.tsx:26-44` 是**三项**（通信/日历/**联系**）——「我的」不在导航轨里，
|
||||
// · `Sidebar.tsx` 第 26-44 行是**三项**（通信/日历/「**联系**」）——「我的」不在导航轨里，
|
||||
// 而是 **底部头像按钮**（`Sidebar.tsx:186`）；
|
||||
// · `Sidebar.tsx:110` 有 `<span className="text-3xs">{short}</span>`（有文字）；
|
||||
// · `index.css:1590` 的 `.nav-item[data-active='true']` **有底色块**，
|
||||
@ -13,9 +13,7 @@
|
||||
//
|
||||
// 鸿蒙侧原来**没有**宽屏布局（只有底部导航条），WideSidebar 补的就是"宽屏模式"这半：
|
||||
// ≥768vp 时 MainPage 挂侧栏、藏底部条（见 MainPage.build 的 onAreaChange）。
|
||||
|
||||
import { code, prose, stripComments } from './lib/read.mjs';
|
||||
import { readFileSync } from 'node:fs';
|
||||
import { dirname, join } from 'node:path';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { test } from 'node:test';
|
||||
@ -28,8 +26,12 @@ const HARMONY_ETS = join(ROOT, 'client/harmony/entry/src/main/ets');
|
||||
const WEBUI_SRC = join(ROOT, 'client/electron/src');
|
||||
|
||||
const read = p => prose(join(HARMONY_ETS, p));
|
||||
/** 读 WebUI 的源文件（**不去注释**：注释里就有真实理由） */
|
||||
const readWeb = p => readFileSync(join(WEBUI_SRC, p), 'utf8');
|
||||
/*
|
||||
* 读 WebUI 的源文件（**不去注释**：注释里就有真实理由）。
|
||||
* ★ 用共享入口 `prose` 而不是裸 `readFileSync`：判据目录有一条 hygiene 判据
|
||||
* 专门拦裸用（理由是那些用法会把"读哪个文件、剥不剥注释"变成每个文件各说各话）。
|
||||
*/
|
||||
const readWeb = p => prose(join(WEBUI_SRC, p));
|
||||
|
||||
/** 取某个成员/方法正文（按行切到下一个成员声明） */
|
||||
function memberBody(src, signature) {
|
||||
@ -121,10 +123,31 @@ test('② 侧栏**三项**（通信/日历/联系）+ 底部一簇 —— 与底
|
||||
/* 头像右下角要带 SSE 连接状态点（WebUI 的 `<ConnectionIndicator/>`） */
|
||||
assert.match(sidebar, /sseColorOf\(/, '头像要带连接状态点（颜色由 SSE 状态决定）');
|
||||
const webInd = readWeb('components/ConnectionIndicator.tsx');
|
||||
for (const [status, hex] of [['connected', '#22C55E'], ['connecting', '#FACC15'], ['reconnecting', '#FB923C'], ['disconnected', '#F87171']]) {
|
||||
/*
|
||||
* ★★ 2026-09-19 修：色值已从 `WideSidebar.ets` 抽到 `Theme.ets` 的令牌
|
||||
* （`Theme.sseConnected` 等）—— 这是 `cross-client-theme` 那条
|
||||
* 「鸿蒙页面里不得出现任何裸色值」要求的方向。
|
||||
*
|
||||
* 所以本断言相应改成：这里要有**四个令牌名**与 WebUI 四档的**逐档对应**。
|
||||
* 分两半断（缺一不可）：
|
||||
* ① 令牌在 `Theme.ets` 里定义，且取值就是 WebUI 对应的那个色（# 值真的一样）；
|
||||
* ② 侧栏真的用了这些令牌（不是定义了不接）。
|
||||
* 只断①会得到“有令牌但没人用”的假绿（`navMaterial` 就当过孤儿）；
|
||||
* 只断②会得到“接了但颜色抄错”的假绿。
|
||||
*/
|
||||
const themeSrc = read('common/Theme.ets');
|
||||
for (const [status, hex, token] of [
|
||||
['connected', '#22C55E', 'sseConnected'],
|
||||
['connecting', '#FACC15', 'sseConnecting'],
|
||||
['reconnecting', '#FB923C', 'sseReconnecting'],
|
||||
['disconnected', '#F87171', 'sseDisconnected']
|
||||
]) {
|
||||
/* WebUI 用的是 tailwind 类名，这里判的是"四档都有"这个结构，不是具体色值 */
|
||||
assert.ok(new RegExp(`${status}:`).test(webInd), `WebUI 的连接指示器要有 ${status} 档`);
|
||||
assert.ok(sidebar.includes(hex), `鸿蒙的连接点要有 ${status} 对应的色值 ${hex}`);
|
||||
assert.ok(new RegExp(`static readonly ${token}: string = '${hex}'`).test(themeSrc),
|
||||
`① Theme.ets 里要有 ${token} = ${hex}（与 WebUI 的 ${status} 档同值）`);
|
||||
assert.ok(sidebar.includes(`Theme.${token}`),
|
||||
`② 侧栏要真的用 Theme.${token} —— 定义了不接 = 那档颜色永远画不出来`);
|
||||
}
|
||||
/* 「我的」由**头像**进入（不是导航轨里的一项） */
|
||||
assert.match(sidebar, /this\.onSelect\(ME_PANE_INDEX\)/,
|
||||
@ -150,13 +173,12 @@ test('③ 侧栏选中态 = **浅蓝底块** + 变色（与底栏"只变色"是
|
||||
const code_ = stripComments(sidebar);
|
||||
|
||||
// 从 WebUI 的真实源码里取侧栏选中底色（不写死，改了两边一起动）
|
||||
const css = readFileSync(
|
||||
join(ROOT, 'client', 'electron', 'src', 'index.css'), 'utf8');
|
||||
const css = prose(join(ROOT, 'client', 'electron', 'src', 'index.css'));
|
||||
const m = css.match(/--nav-active-bg:\s*(\d+ \d+ \d+)/);
|
||||
assert.ok(m, 'WebUI index.css 要有 --nav-active-bg（侧栏选中底色）');
|
||||
const [r, g, b] = m[1].split(' ').map(Number);
|
||||
const hex = '#' + [r, g, b].map(v => v.toString(16).padStart(2, '0')).join('').toUpperCase();
|
||||
const themeSrc = readFileSync(join(HARMONY_ETS, 'common', 'Theme.ets'), 'utf8');
|
||||
const themeSrc = prose(join(HARMONY_ETS, 'common', 'Theme.ets'));
|
||||
assert.match(themeSrc, new RegExp(`navActiveBg: string = '${hex}'`, 'i'),
|
||||
`Theme.navActiveBg 要等于 WebUI 的 --nav-active-bg（${hex}）`);
|
||||
|
||||
@ -357,7 +379,7 @@ test('⑦ 导航项徽标：取值/色调与 WebUI Sidebar 同口径（纯逻辑
|
||||
assert.ok(chromeM, 'WebUI index.css 要有 --c-chrome-600（中性徽标底色）');
|
||||
const [cr, cg, cb] = chromeM[1].split(' ').map(Number);
|
||||
const plainHex = '#' + [cr, cg, cb].map(v => v.toString(16).padStart(2, '0').toUpperCase()).join('');
|
||||
const themeSrc = readFileSync(join(HARMONY_ETS, 'common', 'Theme.ets'), 'utf8');
|
||||
const themeSrc = prose(join(HARMONY_ETS, 'common', 'Theme.ets'));
|
||||
assert.match(themeSrc, new RegExp(`badgePlain: string = '${plainHex}'`, 'i'),
|
||||
`Theme.badgePlain 要等于 WebUI 的 --c-chrome-600（${plainHex}）`);
|
||||
|
||||
|
||||
@ -61,18 +61,24 @@ for (const must of ['配对/解析', 'allow-list', '变异验证', '剥掉注释
|
||||
|
||||
const SUITE = [
|
||||
['test/markdown-xss.test.mjs', [], 9],
|
||||
['test/narrow-layout.test.mjs', [], 64],
|
||||
['test/nav-merge.test.mjs', [], 8],
|
||||
['test/narrow-layout.test.mjs', [], 88],
|
||||
['test/nav-merge.test.mjs', [], 9],
|
||||
['test/animation-audit.test.mjs', [], 4], // 动画全量盘点：死动画/过宽作用域/弹层接线/reduced-motion
|
||||
// 深色模式：色板反转 + 玻璃 alpha 档 + 底必须是暗的（2026-09-17 那次
|
||||
// 「只有通信页深色正常」的回归锁 —— 38 条里后 8 条是这次新增）。
|
||||
['test/theme.test.mjs', [], 38],
|
||||
['test/background.test.mjs', [], 43],
|
||||
['test/background.test.mjs', [], 44],
|
||||
['test/cross-client-theme.test.mjs', [], 15],
|
||||
// 左右滑动翻页的**语义契约**（两端逐项相同、数值各自定）—— 这是
|
||||
// `docs/DEBTS.json` 的 `gesture-semantics` 那条债：它写着「鸿蒙侧出现滑动
|
||||
// 手势代码时**立即建**（此前建 = 只有一端存在的假判据）」。
|
||||
// 2026-09-19 鸿蒙侧加了手势 ⇒ 现在建。8 条：两端都真有手势 / 方向映射 /
|
||||
// 纵向优先 / 快滑窗口 / 复用同一翻页函数 / 无边界回弹 / 有意差异被记录 / 自检。
|
||||
['test/cross-client-gesture.test.mjs', [], 8],
|
||||
// 预设的**行为**判据：每一档都真的画得出来（能真跑，不需要设备 ⇒ 不进 static 欠账）。
|
||||
// 与 appearance-defaults 那条「清单 id/顺序相等」配对：值判据管清单，行为判据管渲染器。
|
||||
['test/harmony-presets.test.mjs', ['--experimental-strip-types', '--no-warnings'], 5],
|
||||
['test/harmony-logic.test.mjs', ['--experimental-strip-types', '--no-warnings'], 28],
|
||||
['test/harmony-presets.test.mjs', ['--experimental-strip-types', '--no-warnings'], 6],
|
||||
['test/harmony-logic.test.mjs', ['--experimental-strip-types', '--no-warnings'], 30],
|
||||
['test/harmony-system-api.test.mjs', [], 5],
|
||||
// P4 外观同步：跑 model/Appearance.ts（纯逻辑），所以也要 strip-types
|
||||
['test/harmony-appearance.test.mjs', ['--experimental-strip-types', '--no-warnings'], 25],
|
||||
@ -405,7 +411,7 @@ for (const [file, flags, expected] of SUITE) {
|
||||
* 自己就写过这条、但**没落进代码**）：
|
||||
*
|
||||
* node:test 会打三行 —— `# tests N` / `# pass N` / `# fail N`，而 `# tests = # pass + # fail`。
|
||||
* 原来取的是 `/^# pass (\d+)/` ⇒ `checks` = Σ`# pass` = **399**，
|
||||
* 原来取的是 `/^# pass (\d+)/`（node v24 起前缀变成 `ℹ`，现已两种都认） ⇒ `checks` = Σ`# pass` = **399**，
|
||||
* 比真实总条数（400）**少了失败的那几条**；接着 `pass = totalTests - totalFail`
|
||||
* = 399 − 1 = **398**，**在一个从未包含失败的和上又减了一次失败**（真实通过数是 399）。
|
||||
* 实测（唯一有失败的文件 `build-stamp`：`# tests 7 / # pass 6 / # fail 1`）：
|
||||
@ -418,8 +424,8 @@ for (const [file, flags, expected] of SUITE) {
|
||||
* 上一轮那条"虚高时恒等式照样成立"是同一个病 —— **恒等式两边同源就没有检验力**。
|
||||
*/
|
||||
const marker = /RESULT pass=(\d+) fail=(\d+)/.exec(out); // 自定义 check()：pass/fail 自报
|
||||
const nodeTests = /^# tests (\d+)/m.exec(out); // node:test：总条数
|
||||
const nodeFail = /^# fail (\d+)/m.exec(out);
|
||||
const nodeTests = /^[#ℹ] tests (\d+)/m.exec(out); // node:test：总条数
|
||||
const nodeFail = /^[#ℹ] fail (\d+)/m.exec(out);
|
||||
/*
|
||||
* ★ `# skipped K`（node:test）：**没跑**的条数，必须单独取一格（dsh 2026-09-18）。
|
||||
*
|
||||
@ -434,7 +440,7 @@ for (const [file, flags, expected] of SUITE) {
|
||||
* 读不出来的跳过等于没有跳过（同 CRITERIA.md 里"跳过若不可数就等于不显形"）。
|
||||
* `check()` 风格的文件没有跳过机制 ⇒ 恒 0。
|
||||
*/
|
||||
const nodeSkip = /^# skipped (\d+)/m.exec(out);
|
||||
const nodeSkip = /^[#ℹ] skipped (\d+)/m.exec(out);
|
||||
/*
|
||||
* ★★ 跳过的**具名**与**原因**（pi 2026-09-18 的闸 (i) 前半）。
|
||||
*
|
||||
@ -455,7 +461,7 @@ for (const [file, flags, expected] of SUITE) {
|
||||
* 老版本 node 或输出被截断时，和才等于总条数；单取 `# pass` 正是上面那个 bug。
|
||||
* 两者都没有 ⇒ null（"没自报条数"，走 unreported 那条红）。
|
||||
*/
|
||||
const nodePass = /^# pass (\d+)/m.exec(out);
|
||||
const nodePass = /^[#ℹ] pass (\d+)/m.exec(out);
|
||||
const nodeTotal = nodeTests ? Number(nodeTests[1])
|
||||
: (nodePass ? Number(nodePass[1]) + (nodeFail ? Number(nodeFail[1]) : 0)
|
||||
+ (nodeSkip ? Number(nodeSkip[1]) : 0) : null);
|
||||
|
||||
Reference in New Issue
Block a user