iter(g337): 可访问名纳入 verify 门禁

This commit is contained in:
HIsheR
2026-10-27 02:13:10 +08:00
parent c3791c5a51
commit 1d25c8a4f5
4 changed files with 39 additions and 2 deletions
+28 -1
View File
@@ -1630,6 +1630,32 @@ function checkVisualChecklist() {
}
/*** 清单一致性校验:组件文档块的 id / props 说明 / demo 锚点必须与代码和演示产物对齐 ***/
/*** 校验输入控件的可访问名:role=combobox / slider 与原生 range 不自带名字,缺 aria-label 时读屏只念「编辑框 / 滑块」
* 只查这三类「必须有名字」的控件,包裹式 <label> 与 aria-labelledby 都算通过,避免误伤复用标签的写法 ***/
function checkAriaNames(pkgs) {
const issues = [];
for (const pkg of pkgs) {
if (pkg.type !== 'skin-dom') continue; // 只有皮肤包会产生 DOM
const srcDir = path.join(ROOT, pkg.dir, 'src');
if (!fs.existsSync(srcDir)) continue;
for (const file of fs.readdirSync(srcDir).filter((f) => f.endsWith('.ts'))) {
const lines = fs.readFileSync(path.join(srcDir, file), 'utf8').split(/\r?\n/); // 归一换行:CRLF 文件不会把一行拆成两半
lines.forEach((line, i) => {
if (!/role: '(combobox|slider)'|type: 'range'/.test(line)) return; // 卫语句:只关心这三类无名即失声的控件
let head = i; // 回退到 h('input' / h('textarea' / h('select' 那一行:一处控件的属性只在同一次调用里
while (head > 0 && !/h\('(input|textarea|select)'/.test(lines[head])) head--;
let tail = i; // 前进到这次调用的收尾行(`})` 或 `}) as ...`),窗口只取这一个创建块
while (tail < lines.length - 1 && !/\}\)/.test(lines[tail])) tail++;
const block = lines.slice(head, tail + 1).join(' ');
if (/aria-label|aria-labelledby/.test(block)) return; // 同名两法都算过(后者由外部 label 提供)
if (/setAttribute\('aria-label'/.test(lines.slice(tail + 1, tail + 4).join(' '))) return; // 也认「建完立刻 setAttribute」的写法
issues.push(`${pkg.name}/${file}:${i + 1} 的 ${line.trim().slice(0, 40)} 缺可访问名(role=combobox / slider 与 range 都不会从内容里取名,读屏只念控件类型)`);
});
}
}
return issues;
}
/*** 校验同义词表:目标 id 必须真实存在(改名后残留会让回退指到空气),同一个词不得归两组(歧义会让结果随表序漂移) ***/
function checkSynonyms(ids) {
const issues = [];
@@ -1710,6 +1736,7 @@ function cmdVerify() {
.flatMap((p) => p.docs?.components ?? []).length;
issues.push(...checkCountDocs(skinTotal));
issues.push(...checkReadme(pkgs));
issues.push(...checkAriaNames(pkgs)); // 输入控件必须有可访问名
issues.push(...checkSynonyms(new Set(pkgs.flatMap((p) => (p.docs?.components ?? []).map((c) => c.id))))); // 同义词表指向的组件必须真实存在
checkDarkTokens(issues);
checkTokenParity(issues);
@@ -1722,7 +1749,7 @@ function cmdVerify() {
console.error(`${issues.length} violation(s)`);
process.exit(1);
}
console.log('verify OK (manifest ↔ docs ↔ demo 一致,文档 props ↔ 入参接口双向一致,皮肤无硬编码颜色与未定义令牌、暗色令牌齐全、tokens.json ↔ tokens.css 名字与值双源一致、@keyframes 无复制粘贴的重复帧、滚动容器全在细条规则内,README 组件清单与分组同步,backlog ↔ 留痕双向一致(编号严格递增、无重复 id、留痕时间线单调且带 +08:00,每个 iter 提交都有留痕),组合配方结构完整,MCP 工具清单三处一致,搜索同义词表目标存在且无歧义,视觉回归抽查清单十八组件 × 五维度齐全)');
console.log('verify OK (manifest ↔ docs ↔ demo 一致,文档 props ↔ 入参接口双向一致,皮肤无硬编码颜色与未定义令牌、暗色令牌齐全、tokens.json ↔ tokens.css 名字与值双源一致、@keyframes 无复制粘贴的重复帧、滚动容器全在细条规则内,README 组件清单与分组同步,backlog ↔ 留痕双向一致(编号严格递增、无重复 id、留痕时间线单调且带 +08:00,每个 iter 提交都有留痕),组合配方结构完整,MCP 工具清单三处一致,搜索同义词表目标存在且无歧义,combobox / slider / range 控件都有可访问名,视觉回归抽查清单十八组件 × 五维度齐全)');
}
/*** 校验 git 提交信息是否符合 COMMITTING.md 规范(参数为 message 文件路径或直接 message 文本),违规退出码 1 ***/