fix(motion): DEC-N3 的 8 条动效违反归零,判据从令牌声明移到消费点
6 处写死贝塞尔收进 ease-ink [0.22,1,0.36,1](各处注释标 CONTEXT.md:77 出处); globals.css:1486 的裸时长 opacity 0.6s 改 var(--transition-slower)。 --transition-gentle = 1000ms 这一条量过再定:实测 src/ 里零消费 (只有 tailwind.config.js 的 duration-gentle 映射,无一处使用),入场消费点 0 ⇒ 原「令牌声明一律 ≤700ms」是把 CONTEXT.md:82 的**入场**红线读成了对调色板的禁令。 现口径改为按用途在消费点判红:非 infinite 的声明(含 var() 解析出的时长)>700ms 必红, infinite 循环环境动效维持豁免。 负对照(真树注入→还原):塞回 [0.16,1,0.3,1] + opacity 900ms 裸字面量 + opacity var(--transition-gentle) ⇒ check:motion EXIT=1,4 红命中 easing-palette×1、 css-transition-token×1、entrance-cap×2;还原后 EXIT=0、违规 0。 读数:check:motion EXIT=0(0 违反)、check:motion:test EXIT=0(21/21)。
This commit is contained in:
1 parent
f3e66f7d36
commit
4afab7c929
6 files changed
+73
-23
No files matched your search
@@ -272,7 +272,8 @@ describe('违规夹具:每条规则都必须能判红(防「常绿」)', (
|
||||
expect(result.byRule('token-band').map((v) => v.token)).toEqual(['250ms', '400ms']);
|
||||
});
|
||||
|
||||
it('R2 entrance-cap —— 令牌 1200ms / framer 1.4s / duration-900 类 / 配置串 1.1s', () => {
|
||||
it('R2 entrance-cap —— framer 1.4s / duration-900 类 / 内联 0.9s / 配置串 1.1s / 超上限令牌被非循环声明消费', () => {
|
||||
// DEC-N3(2026-10-08)后口径:令牌声明自身不判(声明无用途),**消费点**判红。
|
||||
const result = scanFixture({
|
||||
css: `
|
||||
:root {
|
||||
@@ -295,10 +296,10 @@ describe('违规夹具:每条规则都必须能判红(防「常绿」)', (
|
||||
config: `module.exports = { theme: { extend: { animation: { 'slow-in': 'fadeIn 1.1s var(--ease-ink) forwards' } } } };`,
|
||||
});
|
||||
expect(result.exitCode).toBe(EXIT_VIOLATION);
|
||||
// 令牌自身 + 经 var() 解析到该令牌的声明 + framer 1.4s + duration-900 类 + 内联 0.9s + 配置串 1.1s
|
||||
expect(result.countOf('entrance-cap')).toBe(6);
|
||||
// 经 var() 解析到超上限令牌的 .banner 声明 + framer 1.4s + duration-900 类 + 内联 0.9s + 配置串 1.1s。
|
||||
// `--transition-gentle: 1200ms` 声明本身**不再**计入(用途未知,判红在消费点)。
|
||||
expect(result.countOf('entrance-cap')).toBe(5);
|
||||
expect(result.byRule('entrance-cap').map((violation) => violation.file)).toEqual([
|
||||
'src/app/globals.css',
|
||||
'src/app/globals.css',
|
||||
'src/components/card.tsx',
|
||||
'src/components/card.tsx',
|
||||
@@ -307,6 +308,35 @@ describe('违规夹具:每条规则都必须能判红(防「常绿」)', (
|
||||
]);
|
||||
});
|
||||
|
||||
it('R2 按用途分类(DEC-N3)—— 超上限令牌:零消费不判红;被非循环声明消费必判红;仅 infinite 消费豁免', () => {
|
||||
const tokenCss = (usage: string) => `
|
||||
:root {
|
||||
--transition-instant: 100ms;
|
||||
--transition-fast: 180ms;
|
||||
--transition-normal: 280ms;
|
||||
--transition-gentle: 1000ms;
|
||||
--ease-ink: cubic-bezier(0.22, 1, 0.36, 1);
|
||||
}
|
||||
${usage}
|
||||
`;
|
||||
// ① 真实仓库形状:1000ms 档存在但 src/ 零消费 ⇒ 不得判红(这正是 DEC-N3 的拍定依据)
|
||||
const unconsumed = scanFixture({ css: tokenCss('') });
|
||||
expect(unconsumed.countOf('entrance-cap')).toBe(0);
|
||||
expect(unconsumed.exitCode).toBe(EXIT_CLEAN);
|
||||
|
||||
// ② 负对照:把它接入一个非循环 transition ⇒ **必须**在消费点判 entrance-cap
|
||||
const consumed = scanFixture({ css: tokenCss('.hero { transition: opacity var(--transition-gentle) var(--ease-ink); }') });
|
||||
expect(consumed.exitCode).toBe(EXIT_VIOLATION);
|
||||
expect(consumed.countOf('entrance-cap')).toBe(1);
|
||||
expect(consumed.byRule('entrance-cap')[0]?.file).toBe('src/app/globals.css');
|
||||
|
||||
// ③ 循环环境动效(infinite)消费 ⇒ 按既有豁免不属「入场」
|
||||
const ambient = scanFixture({
|
||||
css: tokenCss('.aura { animation: auraPulse var(--transition-gentle) var(--ease-ink) infinite; }'),
|
||||
});
|
||||
expect(ambient.countOf('entrance-cap')).toBe(0);
|
||||
});
|
||||
|
||||
it('R3 css-transition-token —— 裸 ms/s 字面量与悬空 var() 引用', () => {
|
||||
const result = scanFixture({
|
||||
css: `
|
||||
|
||||
@@ -26,8 +26,15 @@
|
||||
* 例外一:带 `infinite` 的循环动画不计入(循环不属「入场」,另立门禁)。
|
||||
* 例外二:`*-delay` 声明判的是**延迟/错落**而非时长,属 `CONTEXT.md:78`
|
||||
* 的 stagger 口径(子元素 30–60ms、Section 间 100–150ms),本脚本不判。
|
||||
* `--transition-*` 家族里非 fast/normal/instant 的成员(slow / slower / gentle)
|
||||
* 同样受此上限约束 —— `gentle: 1000ms` 就是这么被抓出来的。
|
||||
* ── DEC-N3(2026-10-08):**按用途分类判定,不再一刀切判令牌声明**。
|
||||
* CONTEXT.md:82 禁的是「>700ms 的**入场**动效」;令牌声明自身不携带用途,
|
||||
* 用途只存在于消费点。实测 `--transition-gentle = 1000ms` 在 src/ 零消费
|
||||
* (仅 tailwind.config.js 的 duration-gentle 映射,无一处使用),
|
||||
* 入场消费点为 0 ⇒ 原「令牌声明一律 ≤700ms」是把红线读成了对调色板的禁令。
|
||||
* 现口径:**消费点判红** —— 任何非 infinite 的 transition/animation 声明
|
||||
* (含经 var(--transition-*) 解析出的时长)超过 700ms 即判红;infinite
|
||||
* 循环环境动效维持既有豁免。闸的失败面(负对照)见 R2 测试:
|
||||
* 把超上限令牌接入非循环声明,必判红。
|
||||
* R3 `css-transition-token` CSS/内联 transition 声明的时长必须走 `var(--transition-*)` 令牌,
|
||||
* 不得写裸 ms/s 字面量(令牌层是唯一事实来源)。
|
||||
* 例外:含 `!important` 的 `prefers-reduced-motion` 硬开关(globals.css:767-775)。
|
||||
@@ -110,9 +117,9 @@ export const MOTION_RULES: readonly RuleSpec[] = [
|
||||
},
|
||||
{
|
||||
id: 'entrance-cap',
|
||||
title: 'R2 时长硬上限:任何动效时长不得超过 700ms(infinite 循环动画除外)',
|
||||
title: 'R2 时长硬上限:任何**消费点**的动效时长不得超过 700ms(infinite 循环动画豁免;令牌声明按用途在消费点判定,DEC-N3)',
|
||||
source: 'CONTEXT.md:82',
|
||||
suggestion: '降到 ≤ 700ms,入场动画应落到 var(--transition-fast)…var(--transition-normal)',
|
||||
suggestion: '降到 ≤ 700ms,入场动画应落到 var(--transition-fast)…var(--transition-normal);超上限档位(如 --transition-gentle)禁止接入非循环声明',
|
||||
},
|
||||
{
|
||||
id: 'css-transition-token',
|
||||
@@ -463,14 +470,11 @@ export function scanCssText(
|
||||
`--transition-${name} 是入场档,必须落在 ${MOTION_SPEC.entranceMinMs}–${MOTION_SPEC.entranceMaxMs}ms(实测 ${ms}ms)`,
|
||||
);
|
||||
}
|
||||
if (ms > MOTION_SPEC.entranceCapMs) {
|
||||
push(
|
||||
'entrance-cap',
|
||||
declaration.line,
|
||||
declaration.value.trim(),
|
||||
`--transition-${name} = ${ms}ms 超过 ${MOTION_SPEC.entranceCapMs}ms 入场硬上限`,
|
||||
);
|
||||
}
|
||||
// DEC-N3(2026-10-08):此处**不再**对令牌声明做 700ms 上限判定。
|
||||
// CONTEXT.md:82 的禁令对象是「入场动效」,而声明自身无用途;用途在消费点,
|
||||
// 由本文件下方「R2 消费点」分支(裸字面量 / var() 解析)判红,infinite 循环豁免照旧。
|
||||
// 负对照:`--transition-x: 1000ms` + `.y { transition: opacity var(--transition-x) }`
|
||||
// 必在 .y 那一行触发 entrance-cap(见 __tests__ R2 按用途分类用例)。
|
||||
continue;
|
||||
}
|
||||
|
||||
|
||||
Reference in new issue
Block a user