Files
Genarrative/apps/ai-game-creator-shell/tests/resourceCanvasAssetGenerationTasksSidebarStyle.test.ts
T
suzmii 2a2e4c1cea 按 review 修:动画在途拦截、样式守卫扩到三面板、窄屏差异显式放行、用例不再依赖 cwd
- 在途拦截补齐生成动画:提交记录的「属于哪张资源」从 draftKey 拆成 resourcePath,
  `resourceCanvasResourceEditSubmissionBlocksResource` 被快速编辑与生成动画共用;
  此前动画这条键对不上、拦不住,重开面板再提交会复用同一 operationId 卡在原生锁上,
  或(改了提示词)直接多出一笔付费生成
- 样式缺口守卫扩到三块面板(动画面板 / 快速编辑面板 / 生图面板),判据改为按
  「选择器分支 + 声明」逐条比对;两个面板的实测缺口一并照抄补上(快速编辑面板的
  `overflow: auto → visible` 与窄屏底栏两条按宿主差异显式登记,不静默漂移)
- 窄屏只搬动画面板那一支:网页端 ≤760px 会把快速编辑浮层也变成整宽底栏,AGC 的
  快速编辑是「居中贴资源卡」的绝对定位,跟随它会压住栏目工具栏与任务侧栏
- 用例路径不再依赖 cwd:新增 tests/repoPath.ts(按 import.meta.url 反推仓库根),
  19 个用例文件的 `resolve(process.cwd(), …)` 统一改用它;顺手修掉
  `HOST_STYLE_SHEETS.filter(existsSync)` 把仓库相对路径交给 cwd 解析的假红
- 清掉两处死代码:不可达的 `quickEditPanel.status === 'generating'` 判据与
  未被使用的 prune 导出
2026-09-21 01:23:35 +08:00

238 lines
9.2 KiB
TypeScript

// @vitest-environment jsdom
import { readFileSync } from 'node:fs';
import { describe, expect, test } from 'vitest';
import { repoPath } from './repoPath';
import {
declaration,
parseStyleSheet,
resolveDeclarations,
type StyleRule,
} from './styleCascade';
/**
* 侧栏样式的声明级断言。
*
* jsdom 不加载这个 CSS 文件,所以这里按仓库既有做法(`styleCascade`)直接解析**真实生效的声明**:
* 「状态 tone 映射」「等宽数字」「圆角 / 悬停」「过渡」「reduced-motion 关动效」都用声明钉住。
*/
const SIDEBAR_CSS_PATH = repoPath(
'apps/ai-game-creator-shell/src/features/resource-canvas/resourceCanvasAssetGenerationTasksSidebar.css',
);
const rules = parseStyleSheet(readFileSync(SIDEBAR_CSS_PATH, 'utf8'));
/**
* `styleCascade` 的求值器只认识宽度媒体查询,遇到 `prefers-reduced-motion` 会主动报错;
* 那条规则的生效与否单独在下面按声明断言,所以求值时先把它排除掉。
*/
const widthRules = rules.filter(
(rule) => !(rule.media ?? '').includes('prefers-reduced-motion'),
);
function resolved(
selectors: readonly string[],
viewportWidth = 1280,
): Map<string, string> {
return resolveDeclarations(widthRules, selectors, viewportWidth);
}
function toneRule(tone: string): StyleRule | undefined {
return rules.find((rule) =>
rule.selectors.includes(
`.game-resource-generation-task-badge[data-tone='${tone}']`,
),
);
}
describe('「生成任务」侧栏样式', () => {
test('四种状态各有一档 tone,取值全部来自平台 token 而不硬编码颜色', () => {
const tones = ['queued', 'running', 'completed', 'failed'] as const;
const resolvedTones = tones.map((tone) =>
resolved([
'.game-resource-generation-task-badge',
`.game-resource-generation-task-badge[data-tone='${tone}']`,
]),
);
const signature = (map: Map<string, string>) =>
['border-color', 'background', 'color']
.map((property) => declaration(map, property))
.join(' | ');
const signatures = resolvedTones.map(signature);
// 四档必须互不相同,否则「状态徽标成体系」这条就退化成同一个样子。
expect(new Set(signatures).size).toBe(4);
expect(signatures[0]).toContain('--platform-neutral');
expect(signatures[1]).toContain('--platform-accent');
expect(signatures[2]).toContain('--platform-success');
expect(signatures[3]).toContain('--platform-button-danger');
for (const one of signatures) {
expect(one).not.toMatch(/#[0-9a-f]{3,8}|rgba?\(|hsla?\(/iu);
}
// 四档 tone 必须在 CSS 里真实存在(少一档这条断言就红)。
for (const tone of tones) {
expect(toneRule(tone)).toBeDefined();
}
});
test('生成中只有「在动」的呼吸感,没有伪造百分比', () => {
const running = resolved([
'.game-resource-generation-task-badge',
".game-resource-generation-task-badge[data-tone='running']",
]);
// 徽标本身不承载进度数值:文案由组件按后端状态给,样式里不出现百分比工具。
expect(declaration(running, 'color')).toBe('var(--platform-accent)');
const pulse = rules.find((rule) =>
rule.selectors.includes(
".game-resource-generation-task-badge[data-tone='running']::before",
),
);
expect(pulse?.declarations.get('animation')).toContain('pulse');
});
test('阶段是次要信息、已耗时等宽数字右对齐', () => {
const phase = resolved(['.game-resource-generation-task-card-phase']);
expect(declaration(phase, 'color')).toBe('var(--platform-text-muted)');
expect(declaration(phase, 'font-size')).toBe('0.7rem');
const elapsed = resolved(['.game-resource-generation-task-card-elapsed']);
expect(declaration(elapsed, 'font-variant-numeric')).toBe('tabular-nums');
expect(declaration(elapsed, 'text-align')).toBe('right');
});
test('条目卡片有圆角与悬停反馈,失败原因可折行不截断', () => {
const card = resolved(['.game-resource-generation-task-card']);
expect(declaration(card, 'border-radius')).toBe('0.5rem');
const hover = resolved([
'.game-resource-generation-task-card',
'.game-resource-generation-task-card:hover',
]);
expect(declaration(hover, 'box-shadow')).toBe(
'var(--platform-desktop-hover-shadow)',
);
expect(declaration(hover, 'transform')).toBe('translateY(-1px)');
const error = resolved(['.game-resource-generation-task-card-error']);
expect(declaration(error, 'white-space')).toBe('normal');
expect(declaration(error, 'overflow-wrap')).toBe('anywhere');
const locate = resolved(['.game-resource-generation-task-locate']);
expect(declaration(locate, 'text-decoration')).toContain('underline');
});
test('进场动画留在侧栏上,删除的折叠把手不再有样式残留', () => {
const sidebar = resolved(['.game-resource-generation-tasks-sidebar']);
expect(declaration(sidebar, 'animation')).toContain(
'game-resource-generation-tasks-enter',
);
expect(declaration(sidebar, 'border-radius')).toBe('0.75rem');
expect(declaration(sidebar, 'backdrop-filter')).toBe('blur(10px)');
// 折叠把手与底部关闭条都已删除:对应类名不得再出现在样式表里。
for (const removed of [
'.game-resource-generation-tasks-handle',
'.game-resource-generation-tasks-handle-label',
'.game-resource-generation-tasks-handle-badge',
'.game-resource-generation-tasks-sidebar-footer',
]) {
expect(rules.some((rule) => rule.selectors.includes(removed))).toBe(
false,
);
}
});
test('收起与进场同源反向:is-leaving 挂上收起动画,减动效下同样关掉', () => {
const leaving = resolved([
'.game-resource-generation-tasks-sidebar',
'.game-resource-generation-tasks-sidebar.is-leaving',
]);
const animation = declaration(leaving, 'animation');
expect(animation).toContain('game-resource-generation-tasks-leave');
expect(animation).toContain('160ms');
// 动画期间不该还能点到里面(此刻它在播退场,点它只会在卸载前留下半截状态)。
expect(declaration(leaving, 'pointer-events')).toBe('none');
expect(
rules.some((rule) =>
rule.selectors.includes(
'.game-resource-generation-tasks-sidebar.is-leaving',
),
),
).toBe(true);
// 减少动效:收起动画同样关掉,组件那边会立即卸载,不白等 160ms。
const reduced = rules.filter((rule) =>
(rule.media ?? '').includes('prefers-reduced-motion'),
);
expect(
reduced.some(
(rule) =>
rule.selectors.includes(
'.game-resource-generation-tasks-sidebar.is-leaving',
) && rule.declarations.get('animation') === 'none',
),
).toBe(true);
});
test('列表滚动条是细样式,滚动区域有界', () => {
const scroll = resolved(['.game-resource-generation-tasks-scroll']);
expect(declaration(scroll, 'overflow-y')).toBe('auto');
expect(declaration(scroll, 'scrollbar-width')).toBe('thin');
expect(declaration(scroll, 'overscroll-behavior')).toBe('contain');
const thumb = rules.find((rule) =>
rule.selectors.includes(
'.game-resource-generation-tasks-scroll::-webkit-scrollbar-thumb',
),
);
expect(thumb?.declarations.get('background')).toBe(
'var(--platform-line-soft)',
);
// 侧栏高度有界:上下边界都给死,不靠内容撑高(内容再多也只滚列表)。
const sidebar = resolved(['.game-resource-generation-tasks-sidebar']);
expect(declaration(sidebar, 'top')).toBe('4rem');
expect(declaration(sidebar, 'bottom')).toBe('6rem');
expect(declaration(sidebar, 'width')).toBe('min(300px, 80vw)');
});
test('窄屏(360px)下侧栏不溢出不挡把手', () => {
const narrow = resolved(['.game-resource-generation-tasks-sidebar'], 360);
expect(declaration(narrow, 'width')).toBe('auto');
expect(declaration(narrow, 'left')).toBe('0.5rem');
expect(declaration(narrow, 'right')).toBe('0.5rem');
});
test('prefers-reduced-motion 下进场动画与过渡都被关掉', () => {
const reduced = rules.filter((rule) =>
(rule.media ?? '').includes('prefers-reduced-motion'),
);
expect(reduced.length).toBeGreaterThan(0);
const motionless = (selector: string, property: string) =>
reduced.some(
(rule) =>
rule.selectors.includes(selector) &&
rule.declarations.get(property) === 'none',
);
expect(
motionless('.game-resource-generation-tasks-sidebar', 'animation'),
).toBe(true);
expect(
motionless('.game-resource-generation-task-card', 'transition'),
).toBe(true);
});
test('焦点环可见(键盘可见焦点用平台 token)', () => {
const focusRule = rules.find((rule) =>
rule.selectors.includes(
'.game-resource-generation-tasks-sidebar-icon-button:focus-visible',
),
);
expect(focusRule?.declarations.get('outline')).toBe(
'2px solid var(--platform-accent)',
);
expect(focusRule?.declarations.get('box-shadow')).toBe(
'0 0 0 3px var(--platform-input-focus-ring)',
);
});
});