@whzxc/agent-design-gallery 0.15.0 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. package/README.md +5 -2
  2. package/package.json +2 -1
  3. package/public/app.js +602 -64
  4. package/public/assets.js +25 -10
  5. package/public/boards.js +8 -3
  6. package/public/frame-identity.js +25 -12
  7. package/public/icons.js +7 -0
  8. package/public/index.html +14 -2
  9. package/public/motion-flow.js +28 -0
  10. package/public/motion-identity.js +100 -0
  11. package/public/motion-paint.js +332 -0
  12. package/public/motion-scene.js +165 -0
  13. package/public/motion-specimens.js +335 -0
  14. package/public/player.css +270 -0
  15. package/public/player.js +753 -0
  16. package/public/recent-updates.js +535 -0
  17. package/public/style.css +17 -2
  18. package/public/tokens.css +6 -0
  19. package/public/view-boards.css +131 -0
  20. package/public/view-boards.js +350 -0
  21. package/public/view-route.js +1 -1
  22. package/src/boards/motion-board.mjs +202 -0
  23. package/src/boards/token-board.mjs +9 -5
  24. package/src/cli-output.mjs +3 -1
  25. package/src/cli.mjs +52 -18
  26. package/src/http.mjs +5 -2
  27. package/src/recent-frames.mjs +295 -0
  28. package/src/recent-history.mjs +100 -0
  29. package/src/recent-job.mjs +63 -0
  30. package/src/recent-worker.mjs +171 -0
  31. package/src/server.mjs +229 -18
  32. package/src/toolkit/arch-git.mjs +8 -14
  33. package/src/toolkit/browser.mjs +1 -13
  34. package/src/toolkit/build-store.mjs +9 -1
  35. package/src/toolkit/build-worker.mjs +6 -0
  36. package/src/toolkit/build.mjs +22 -16
  37. package/src/toolkit/commands.mjs +93 -2
  38. package/src/toolkit/compare.mjs +13 -11
  39. package/src/toolkit/config.mjs +2 -2
  40. package/src/toolkit/diff-inputs.mjs +35 -26
  41. package/src/toolkit/diff.mjs +24 -11
  42. package/src/toolkit/frame-declarations.mjs +36 -0
  43. package/src/toolkit/git-blobs.mjs +50 -0
  44. package/src/toolkit/impact-inputs.mjs +11 -19
  45. package/src/toolkit/impact-selection.mjs +2 -2
  46. package/src/toolkit/impact.mjs +17 -3
  47. package/src/toolkit/implementation-map.mjs +17 -6
  48. package/src/toolkit/input-generation.mjs +15 -0
  49. package/src/toolkit/inspect-output.mjs +1 -1
  50. package/src/toolkit/inspect.d.ts +9 -1
  51. package/src/toolkit/inspect.mjs +25 -1
  52. package/src/toolkit/motion-check.mjs +382 -0
  53. package/src/toolkit/motion-css.mjs +105 -0
  54. package/src/toolkit/motion-flows.mjs +95 -0
  55. package/src/toolkit/motion-impact.mjs +87 -0
  56. package/src/toolkit/motion-inventory.mjs +202 -0
  57. package/src/toolkit/motion-label.mjs +111 -0
  58. package/src/toolkit/motion-patterns.mjs +216 -0
  59. package/src/toolkit/motion-primitives.mjs +94 -0
  60. package/src/toolkit/motion-queries.mjs +169 -0
  61. package/src/toolkit/motion.mjs +300 -0
  62. package/src/toolkit/owner.mjs +19 -6
  63. package/src/toolkit/play-endpoint.mjs +66 -0
  64. package/src/toolkit/project-index.mjs +2 -2
  65. package/src/toolkit/recent-structure.mjs +201 -0
  66. package/src/toolkit/results.mjs +2 -2
  67. package/src/toolkit/review-document.mjs +9 -4
  68. package/src/toolkit/review-embed-document.mjs +671 -0
  69. package/src/toolkit/review-filmstrip.mjs +76 -0
  70. package/src/toolkit/review-motion-card.mjs +51 -0
  71. package/src/toolkit/review-motion.mjs +159 -0
  72. package/src/toolkit/review-playback.js +123 -0
  73. package/src/toolkit/review-sheet.mjs +36 -28
  74. package/src/toolkit/review.mjs +131 -31
  75. package/src/toolkit/runtime.mjs +7 -1
  76. package/src/viewer-cache.mjs +48 -12
@@ -0,0 +1,76 @@
1
+ import { build } from 'esbuild';
2
+ import { createHash } from 'node:crypto';
3
+ import { fileURLToPath } from 'node:url';
4
+ import { launch } from './browser.mjs';
5
+ import { canonicalBytes } from './impact-proof.mjs';
6
+
7
+ const hash = value => createHash('sha256').update(value).digest('hex');
8
+
9
+ export function assetStore() {
10
+ const assets = Object.create(null);
11
+ return { assets, put(value) {
12
+ const key = hash(typeof value === 'string' ? value : canonicalBytes(value));
13
+ assets[key] ??= value;
14
+ return key;
15
+ } };
16
+ }
17
+
18
+ export async function withFilmstrip(theme, store, work) {
19
+ const bundle = await build({ entryPoints: [fileURLToPath(new URL('./review-playback.js', import.meta.url))],
20
+ bundle: true, format: 'iife', globalName: 'reviewPlayback', minify: true, write: false });
21
+ const script = bundle.outputFiles[0].text.trim();
22
+ const environment = { colorScheme: theme, reducedMotion: 'no-preference', deviceScaleFactor: 1, locale: 'en-US', timezoneId: 'UTC' };
23
+ const browser = await launch();
24
+ try {
25
+ const page = await browser.newPage(environment);
26
+ await page.setContent('<style>*{margin:0}iframe{display:block;border:0}</style>');
27
+ await page.addScriptTag({ content: script });
28
+ await page.evaluate(async () => { window.stageFrame = await reviewPlayback.createStage(document.body); });
29
+ const capture = async () => {
30
+ const image = await page.locator('iframe').screenshot({ animations: 'disabled', caret: 'hide' });
31
+ return { image: store.put('data:image/png;base64,' + image.toString('base64')),
32
+ width: image.readUInt32BE(16), height: image.readUInt32BE(20) };
33
+ };
34
+ const endpoints = new Map(), samples = new Map(), loaded = new Set();
35
+ async function load(key) {
36
+ const endpoint = store.assets[key];
37
+ const entries = Object.fromEntries([key, endpoint.html, ...endpoint.styles].filter(k => !loaded.has(k)).map(k => [k, store.assets[k]]));
38
+ await page.evaluate(entries => Object.assign(window.motionAssets ??= {}, entries), entries);
39
+ Object.keys(entries).forEach(k => loaded.add(k));
40
+ }
41
+ async function endpoint(key) {
42
+ if (!endpoints.has(key)) {
43
+ await load(key);
44
+ const rows = await page.evaluate(async ({ key, theme }) => {
45
+ const scene = motionAssets[key];
46
+ const stage = await reviewPlayback.showEndpoint(stageFrame, scene, motionAssets, theme);
47
+ return reviewPlayback.identities(stage, scene.design);
48
+ }, { key, theme });
49
+ endpoints.set(key, { rows, ...await capture() });
50
+ }
51
+ return endpoints.get(key);
52
+ }
53
+ async function filmstrip(side) {
54
+ const key = hash(canonicalBytes([side.from, side.to, side.edge, environment, browser.version(), hash(script)]));
55
+ if (samples.has(key)) return samples.get(key);
56
+ const opening = await endpoint(side.from), final = await endpoint(side.to);
57
+ const info = await page.evaluate(async ({ side, theme }) => {
58
+ window.paint?.dispose();
59
+ window.paint = await reviewPlayback.prepare(stageFrame, side, motionAssets, theme);
60
+ return { duration: paint?.duration ?? 0, boundaries: paint?.boundaries ?? [], fallback: paint?.fallback };
61
+ }, { side, theme });
62
+ const { duration, boundaries, fallback } = info;
63
+ const sample = ({ image, width, height }, ms, state) => ({ image, width, height, ms, state });
64
+ const strip = [sample(opening, 0, 'From')];
65
+ for (const ms of [...new Set([duration / 2, ...boundaries])].filter(ms => ms > 0 && ms < duration).sort((a,b) => a-b)) {
66
+ await page.evaluate(p => paint.seek(p), ms / duration);
67
+ strip.push(sample(await capture(), ms, ''));
68
+ }
69
+ strip.push(sample(final, duration, 'To'));
70
+ const result = { duration, fallback, samples: strip };
71
+ samples.set(key, result);
72
+ return result;
73
+ }
74
+ return await work({ endpoint, filmstrip, script });
75
+ } finally { await browser.close(); }
76
+ }
@@ -0,0 +1,51 @@
1
+ import { escape } from './html.mjs';
2
+ const esc = value => escape(value ?? '');
3
+ const ref = r => r ? r.source + '#' + r.frame : 'Unknown endpoint';
4
+ const target = t => t?.anchor ?? (t?.part ? t.part + (t.key == null ? '' : ' · ' + t.key) : 'frame');
5
+ const focus = f => typeof f === 'object' ? target(f?.target) : ({
6
+ 'restore-trigger': 'restore trigger, or frame when unavailable', preserve: 'preserve focus, or frame when unavailable'
7
+ }[f] ?? f);
8
+
9
+ export function motionCard(card, index, assets) {
10
+ const sheet = !!assets;
11
+ const sideHtml = name => {
12
+ const side = card[name];
13
+ if (!side) return '';
14
+ const edge = side.edge;
15
+ const label = name === 'before' ? 'Before' : 'After';
16
+ const fallback = [side.fallback, ...(edge.unsupported ?? []).map(u => u.effect + ' · ' + u.reason)].filter(Boolean);
17
+ return `<section class="motion-side"><h4>${label} · ${esc(edge.label ?? card.id)}</h4>
18
+ <div>${esc(edge.gesture ?? edge.trigger?.on)} · ${esc(target(edge.trigger?.target))} · ${edge.proposed ? 'Proposed · ' + esc(edge.proposed) : 'Current'}</div>
19
+ <code>${esc(ref(edge.from))} → ${esc(ref(edge.to))}</code>
20
+ <div>Focus · ${esc(focus(edge.focus))}</div>
21
+ ${side.error ? '<p role="alert">Partial · ' + esc(side.error) + '</p>' : `<div>${esc(edge.duration)} · ${side.duration} ms</div>
22
+ ${fallback.length ? '<p>' + esc(fallback.join(' · ')) + '</p>' : ''}
23
+ <div class="filmstrip">${side.samples.map(s => `<figure><img ${sheet ? 'src="' + assets[s.image] + '"' : 'data-image="' + s.image + '"'} alt="${label} at ${s.ms} ms"><figcaption>${s.state} ${s.ms} ms</figcaption></figure>`).join('')}</div>
24
+ ${sheet ? '' : `<div class="motion-controls"><button data-play="${name}">Play ${name}</button><button data-preview="${name}">Preview ${name}</button><output data-elapsed="${name}">0 ms</output></div>`}`}
25
+ </section>`;
26
+ };
27
+ const control = !sheet && (card.before?.samples || card.after?.samples);
28
+ return `<article class="frame-card motion-card" data-motion="${index}" data-edge="${esc(card.id)}">
29
+ <header class="card-head"><h3>${esc(card.after?.edge.label ?? card.before?.edge.label ?? card.id)}</h3><span>${esc(card.kind)}</span></header>
30
+ <div class="motion-content"><code>${esc(card.id)}</code> · ${esc(card.reasons.join(' · '))}
31
+ <div class="motion-sides">${sideHtml('before')}${sideHtml('after')}</div>
32
+ ${control ? `<label class="motion-controls">Seek both sides <input type="range" min="0" max="100" value="0"></label>
33
+ <div class="motion-stage"><img class="motion-cover" hidden alt="Source endpoint"></div><div role="status"></div>` : ''}</div></article>`;
34
+ }
35
+
36
+ export const motionStyle = `
37
+ .motion-card code,.motion-card h4 {overflow-wrap:anywhere}
38
+ .motion-content {padding:12px}
39
+ .motion-sides {display:grid;grid-template-columns:repeat(auto-fit,minmax(min(270px,100%),1fr));gap:12px}
40
+ .motion-side {min-width:0}
41
+ .motion-card h4 {margin:10px 0 4px}
42
+ .filmstrip {display:flex;flex-wrap:wrap;gap:6px;margin:8px 0}
43
+ .filmstrip figure {min-width:0;flex:1 1 70px;margin:0}
44
+ .filmstrip img {width:100%;height:80px;object-fit:contain}
45
+ .filmstrip figcaption {font-size:11px;text-align:center}
46
+ .motion-controls {display:flex;align-items:center;flex-wrap:wrap;gap:8px;margin:8px 0}
47
+ .motion-controls button {border:1px solid var(--line);border-radius:6px;background:var(--panel);color:inherit;padding:4px 9px;cursor:pointer}
48
+ .motion-stage {position:relative;overflow:hidden}
49
+ .motion-stage iframe,.motion-cover {position:absolute;inset:0;border:0;transform-origin:top left;pointer-events:none}
50
+ .motion-cover {z-index:1}
51
+ `;
@@ -0,0 +1,159 @@
1
+ import { canonicalBytes } from './impact-proof.mjs';
2
+ import { relative } from './project.mjs';
3
+ import { parseTokens } from './tokens.mjs';
4
+ import { playbackEdge } from './play-endpoint.mjs';
5
+ import { timingRefs } from './motion.mjs';
6
+ import { assetStore, withFilmstrip } from './review-filmstrip.mjs';
7
+
8
+ const equal = (a, b) => canonicalBytes(a) === canonicalBytes(b);
9
+ const sides = ['before', 'after'];
10
+ const refKey = ref => JSON.stringify([ref.source, ref.frame]);
11
+
12
+ // Impact owns the per-revision indexes. Preserve incident IDs even when a failed
13
+ // source was removed from the static comparison inventory on both sides.
14
+ export function reviewEdgeCandidates({ views, motionIds, data, assessments }, theme) {
15
+ const ids = new Set(motionIds);
16
+ const failed = new Set(data.failures.map(f => f.source));
17
+ for (const view of views) for (const { edge, valid } of view.motion.records) {
18
+ if (!valid) continue;
19
+ for (const ref of [edge.from, edge.to]) {
20
+ if (failed.has(ref.source)) ids.add(edge.id);
21
+ // Unassessed frames can change even without a lexical impact seed.
22
+ const assessment = assessments.get(JSON.stringify([ref.source, ref.frame, theme]));
23
+ if (assessment?.disposition !== 'render') continue;
24
+ const [a, b] = views.map(v => v.built.get(ref.source));
25
+ const [first, last] = [a, b].map(build => build?.frames.find(f => f.name === ref.frame));
26
+ if (a?.css !== b?.css || first?.html !== last?.html || first?.width !== last?.width ||
27
+ first?.height !== last?.height || first?.proposed !== last?.proposed) ids.add(edge.id);
28
+ }
29
+ }
30
+ return [...ids].map(id => views.map(v => v.motion.ids.get(id)?.[0]));
31
+ }
32
+
33
+ function revision(view, side, store, failures, theme) {
34
+ const tokens = parseTokens(view.tokenBytes.toString()), design = relative(view.config, view.config.design);
35
+ const cache = new Map();
36
+ const buildFailures = new Map(failures.filter(f => f.side === side).map(f => [f.source, f.message]));
37
+ async function endpoint(ref) {
38
+ const key = refKey(ref);
39
+ if (cache.has(key)) return cache.get(key);
40
+ if (buildFailures.has(ref.source)) throw Error(buildFailures.get(ref.source));
41
+ const built = view.built.get(ref.source) ?? await view.index.materialize(ref.source);
42
+ const frame = built.frames.find(f => f.name === ref.frame);
43
+ if (!frame) throw Error('Missing frame ' + ref.frame);
44
+ const result = { frame, hash: store.put({ frame: ref.frame, design, width: frame.width, height: frame.height,
45
+ html: store.put(frame.html), styles: [built.cssBeforeTokens, built.tokenCss, built.cssAfterTokens].map(store.put) }) };
46
+ cache.set(key, result);
47
+ return result;
48
+ }
49
+ return async record => {
50
+ if (!record) return;
51
+ const { edge, owner } = record;
52
+ let source = owner;
53
+ try {
54
+ if (!record.valid) throw Error('Invalid transition declaration: ' + edge.id);
55
+ source = edge.from.source;
56
+ const from = await endpoint(edge.from);
57
+ source = edge.to.source;
58
+ const to = await endpoint(edge.to);
59
+ source = owner;
60
+ const resolved = playbackEdge(edge, from.frame, tokens, theme, design);
61
+ const timings = Object.fromEntries(timingRefs(edge).map(({ name, pointer }) => [name, resolved.timings[pointer]]));
62
+ return { from: from.hash, to: to.hash, edge: resolved,
63
+ endpointStatus: [from.frame.proposed, to.frame.proposed].map(v => v ?? 'current'), timings };
64
+ } catch (error) {
65
+ if (!failures.some(f => f.source === source && f.side === side))
66
+ failures.push({ source, side, code: 'SOURCE_BUILD_FAILED', message: error.message });
67
+ return { edge, error: side + ' · ' + source + ' · ' + error.message };
68
+ }
69
+ };
70
+ }
71
+
72
+ export async function reviewMotion(session, candidates, model, comparisons, theme) {
73
+ if (!candidates.length) return;
74
+ const store = assetStore(), failures = model.failures;
75
+ const readers = session.views.map((v, i) => revision(v, i === 0 ? 'base' : 'current', store, failures, theme));
76
+ const moves = new Map([...model.movePairs, ...comparisons.filter(r => r.previousSource)].map(({before, after}) =>
77
+ [refKey(before), {source: after.source, frame: after.frame}]));
78
+ const relocate = ref => ref && (moves.get(refKey(ref)) ?? ref);
79
+ // Qualify part selectors by a relocated source only when established moves
80
+ // agree on its new owner. Frame references always use their exact pair.
81
+ const owners = new Map();
82
+ for (const [ref, to] of moves) {
83
+ const [source] = JSON.parse(ref);
84
+ if (!owners.has(source)) owners.set(source, new Set());
85
+ owners.get(source).add(to.source);
86
+ }
87
+ const relocatePart = part => {
88
+ const [source, name] = part.split('#');
89
+ const paths = owners.get(source);
90
+ return paths?.size === 1 ? [...paths][0] + '#' + name : part;
91
+ };
92
+ const normalize = edge => JSON.parse(JSON.stringify({ ...edge, from: relocate(edge.from), to: relocate(edge.to) },
93
+ (key, value) => key === 'part' && typeof value === 'string' ? relocatePart(value) : value));
94
+ const pending = [];
95
+ for (const records of candidates) {
96
+ const versions = await Promise.all(records.map((r, i) => readers[i](r)));
97
+ const [a, b] = versions;
98
+ if (a && b && !a.error && !b.error && a.from === b.from && a.to === b.to &&
99
+ equal(a.endpointStatus, b.endpointStatus) && equal(a.edge, b.edge)) continue;
100
+ pending.push({records, versions});
101
+ }
102
+ if (!pending.length) return;
103
+ const cards = [];
104
+ return withFilmstrip(theme, store, async renderer => {
105
+ for (const {records, versions} of pending) {
106
+ const [old, next] = records.map(r => r?.edge);
107
+ const reasons = [], kind = !old ? 'added' : !next ? 'removed' : 'changed';
108
+ const former = old && normalize(old);
109
+ if (!equal(former, next)) reasons.push('Direct declaration');
110
+ const [a, b] = versions;
111
+ if (a?.error || b?.error) reasons.push('Incomplete endpoint');
112
+ if (a?.timings && b?.timings) {
113
+ const changed = Object.keys(a.timings).filter(k => k in b.timings && a.timings[k] !== b.timings[k]).sort();
114
+ if (changed.length) reasons.push('Inherited timing · ' + changed.join(', '));
115
+ if (equal(former.trigger, next.trigger) && a.edge.gesture !== b.edge.gesture) reasons.push('Inherited trigger name');
116
+ if (!equal(a.endpointStatus, b.endpointStatus)) reasons.push('Inherited endpoint status');
117
+ for (const end of ['from', 'to']) {
118
+ if (a[end] === b[end] || !equal(relocate(old[end]), next[end])) continue;
119
+ const first = await renderer.endpoint(a[end]), last = await renderer.endpoint(b[end]);
120
+ const rows = first.rows.map(row => ({
121
+ ...row, parts: row.parts.map(relocatePart),
122
+ keys: row.keys.map(key => key.owner ? { ...key, owner: relocatePart(key.owner) } : key)
123
+ }));
124
+ if (first.image !== last.image || !equal(rows, last.rows)) reasons.push('Inherited ' + end + ' endpoint');
125
+ }
126
+ }
127
+ if (!reasons.length) continue;
128
+ const record = records[1] ?? records[0];
129
+ const card = { id: record.edge.id, owner: record.owner, kind, reasons };
130
+ for (const [i, version] of versions.entries()) {
131
+ if (!version) continue;
132
+ if (!version.error) {
133
+ try { Object.assign(version, await renderer.filmstrip(version)); }
134
+ catch (error) {
135
+ const side = i === 0 ? 'base' : 'current', source = version.edge.from.source;
136
+ version.error = side + ' · ' + source + ' · ' + error.message;
137
+ failures.push({ source, side, code: 'SOURCE_BUILD_FAILED', message: error.message });
138
+ }
139
+ }
140
+ card[sides[i]] = version;
141
+ }
142
+ cards.push(card);
143
+ }
144
+ if (!cards.length) return;
145
+ cards.sort((a, b) => a.owner.localeCompare(b.owner,'en') || a.id.localeCompare(b.id,'en'));
146
+ // Keep only assets referenced by final cards. Candidate observations are disposable.
147
+ const live = new Set();
148
+ for (const card of cards) for (const name of sides) {
149
+ const side = card[name];
150
+ if (!side?.samples) continue;
151
+ for (const key of [side.from, side.to]) {
152
+ const endpoint = store.assets[key];
153
+ for (const id of [key, endpoint.html, ...endpoint.styles]) live.add(id);
154
+ }
155
+ for (const sample of side.samples) live.add(sample.image);
156
+ }
157
+ return { cards, assets: Object.fromEntries([...live].map(k => [k, store.assets[k]])), theme, script: renderer.script };
158
+ });
159
+ }
@@ -0,0 +1,123 @@
1
+ // Bundled into the standalone report and used by the filmstrip renderer.
2
+ import { createStage, mountScene, observeScene, readySceneResources } from '../../public/motion-scene.js';
3
+ import { preparePaint, playTimeline } from '../../public/motion-paint.js';
4
+
5
+ export { createStage };
6
+
7
+ export async function showEndpoint(frame, endpoint, assets, theme) {
8
+ const doc = frame.contentDocument;
9
+ const size = (width, height) => Object.assign(frame.style, { width: width + 'px', height: height + 'px' });
10
+ size(endpoint.width || 1600, endpoint.height || 1200);
11
+ const stage = await mountScene(doc, {
12
+ ...endpoint, html: assets[endpoint.html], css: endpoint.styles.map(key => assets[key]).join('')
13
+ }, theme);
14
+ const rect = stage.getBoundingClientRect();
15
+ size(endpoint.width || Math.max(1, Math.ceil(rect.width)), endpoint.height || Math.max(1, Math.ceil(rect.height)));
16
+ await readySceneResources(doc);
17
+ return stage;
18
+ }
19
+
20
+ export async function prepare(frame, side, assets, theme) {
21
+ const from = assets[side.from], to = assets[side.to];
22
+ const origin = await showEndpoint(frame, from, assets, theme);
23
+ const first = side.edge.unsupported ? null : observeScene(origin, from.design, true);
24
+ const stage = await showEndpoint(frame, to, assets, theme);
25
+ return first ? preparePaint(stage, first, observeScene(stage, to.design, true), side.edge) : null;
26
+ }
27
+
28
+ export function identities(stage, design) {
29
+ return observeScene(stage, design).map(({ box, parts, keys, anchor, parent }) => ({
30
+ box, parts, anchor, parent,
31
+ keys: keys.map(({ owner, ...key }) => owner
32
+ ? { ...key, owner: [design, owner.source].filter(Boolean).join('/') + '#' + owner.export }
33
+ : key)
34
+ }));
35
+ }
36
+
37
+ export function mountReport() {
38
+ const data = JSON.parse(document.querySelector('#motion-data').textContent);
39
+ let active, pending = Promise.resolve(), generation = 0;
40
+ async function activate(card, sideName, play, ticket) {
41
+ if (ticket !== generation) return;
42
+ active?.stop?.();
43
+ active?.paint?.dispose();
44
+ active?.frame?.remove();
45
+ if (active) {
46
+ active.card.querySelector('.motion-cover').hidden = true;
47
+ active.card.querySelector('.motion-stage').style.height = '';
48
+ active.card.querySelector('[role=status]').textContent = '';
49
+ }
50
+ active?.fit?.disconnect();
51
+ active = null;
52
+ const side = data.cards[card.dataset.motion][sideName];
53
+ const host = card.querySelector('.motion-stage');
54
+ const frame = await createStage(host);
55
+ frame.inert = true;
56
+ if (ticket !== generation) { frame.remove(); return; }
57
+ const state = active = { frame, sideName, card };
58
+ card.querySelector('[role=status]').textContent = sideName === 'before' ? 'Previewing before' : 'Previewing after';
59
+ // A new selection can arrive while the sandbox waits for fonts.
60
+ const paint = await prepare(frame, side, data.assets, data.theme);
61
+ if (ticket !== generation) { paint?.dispose(); return; }
62
+ state.paint = paint;
63
+ const endWidth = frame.offsetWidth, endHeight = frame.offsetHeight;
64
+ const cover = card.querySelector('.motion-cover');
65
+ const first = side.samples[0];
66
+ cover.src = data.assets[first.image];
67
+ const draw = p => {
68
+ const atStart = p === 0 || (!side.duration && p < 1);
69
+ cover.hidden = !atStart;
70
+ frame.style.visibility = atStart ? 'hidden' : 'visible';
71
+ paint?.seek(p);
72
+ const w = atStart ? first.width : endWidth, h = atStart ? first.height : endHeight;
73
+ const scale = Math.min(1, host.clientWidth / w, 400 / h);
74
+ host.style.height = Math.ceil(h * scale) + 'px';
75
+ frame.style.transform = 'scale(' + scale + ')';
76
+ cover.style.width = w * scale + 'px';
77
+ };
78
+ state.draw = draw;
79
+ const slider = card.querySelector('input');
80
+
81
+ state.fit = new ResizeObserver(() => draw(Number(card.dataset[sideName] || 0)));
82
+ state.fit.observe(host.parentElement);
83
+ function advance(p) {
84
+ card.dataset[sideName] = p;
85
+ card.querySelector('[data-elapsed="' + sideName + '"]').value = elapsed(side.duration * p);
86
+ draw(p);
87
+ }
88
+ draw(Number(card.dataset[sideName] || 0));
89
+ if (play) {
90
+ advance(0);
91
+ if (side.duration) state.stop = playTimeline(side.duration, 0, 1, advance, () => {});
92
+ else advance(1);
93
+ }
94
+ slider.setAttribute('aria-valuetext', slider.value + '%');
95
+ }
96
+ function elapsed(value) { return Number(value.toFixed(2)) + ' ms'; }
97
+ for (const card of document.querySelectorAll('[data-motion]')) {
98
+ const model = data.cards[card.dataset.motion];
99
+ for (const image of card.querySelectorAll('[data-image]')) image.src = data.assets[image.dataset.image];
100
+ const start = (side, play) => {
101
+ const ticket = ++generation;
102
+ pending = pending.then(() => activate(card, side, play, ticket)).catch(err => {
103
+ if (ticket === generation) card.querySelector('[role=status]').textContent = err.message;
104
+ });
105
+ };
106
+ for (const button of card.querySelectorAll('[data-play],[data-preview]')) {
107
+ button.onclick = () => start(button.dataset.play ?? button.dataset.preview, button.hasAttribute('data-play'));
108
+ }
109
+ if (!card.querySelector('input')) continue;
110
+ card.querySelector('input').oninput = event => {
111
+ const p = event.target.valueAsNumber / 100;
112
+ for (const name of ['before', 'after']) {
113
+ const side = model[name];
114
+ if (!side?.samples) continue;
115
+ card.dataset[name] = p;
116
+ card.querySelector('[data-elapsed="' + name + '"]').value = elapsed(side.duration * p);
117
+ }
118
+ event.target.setAttribute('aria-valuetext', event.target.value + '%');
119
+ if (active?.card === card && active.draw) { active.stop?.(); active.draw(p); }
120
+ else start(model.after?.samples ? 'after' : 'before', false);
121
+ };
122
+ }
123
+ }
@@ -1,4 +1,4 @@
1
- import { groupReview } from './review-groups.mjs';
1
+ import { motionCard, motionStyle } from './review-motion-card.mjs';
2
2
  import { renderReviewFailures } from './diff-document.mjs';
3
3
  import { browserTask, readyResources } from './browser.mjs';
4
4
 
@@ -10,22 +10,19 @@ export function reviewSheetHtml(review, theme, frameOrder = [], designDirs = { b
10
10
  const order = new Map(frameOrder.map((row, index) => [JSON.stringify([row.source, row.frame]), index]));
11
11
  const compare = (a, b) => a.source.localeCompare(b.source, 'en') ||
12
12
  (order.get(JSON.stringify([a.source, a.frame])) ?? 0) - (order.get(JSON.stringify([b.source, b.frame])) ?? 0);
13
- const grouped = groupReview(review);
14
13
  const added = [...review.sections.added].sort(compare);
15
14
  const direct = review.sections.changed.filter(entry => entry.change?.kind !== 'inherited').sort(compare);
16
15
  const removed = [...review.sections.removed].sort(compare);
17
- const groups = grouped.groups.map(group => ({ ...group, outliers: group.outliers.filter(entry => entry !== group.representative) }));
16
+ const moved = [...review.movePairs].sort((a, b) => compare(a.after, b.after));
17
+ const groups = review.groups.map(group => ({ ...group, outliers: group.outliers.filter(entry => entry !== group.representative) }));
18
18
  const representativeByFrame = new Map(groups.map(group => [group.representative, group]));
19
19
  const outliers = groups.flatMap(group => group.outliers);
20
- const changed = [...direct, ...groups.flatMap(group => [group.representative, ...group.outliers])];
20
+ const inherited = groups.flatMap(group => [group.representative, ...group.outliers]);
21
21
  const [firstAdded, ...otherAdded] = added;
22
22
  const [firstDirect, ...otherDirect] = direct;
23
- const priority = new Map([firstAdded, firstDirect, ...representativeByFrame.keys(), ...otherAdded, ...otherDirect,
23
+ const motion = review.motion?.cards ?? [];
24
+ const priority = new Map([firstAdded, firstDirect, ...motion, ...representativeByFrame.keys(), ...otherAdded, ...otherDirect,
24
25
  ...outliers].filter(Boolean).slice(0, 12).map((entry, index) => [entry, index]));
25
- const frameCount = entry => {
26
- const group = representativeByFrame.get(entry);
27
- return group ? group.frames.length - group.outliers.length : 1;
28
- };
29
26
  const name = (entry, dir) => {
30
27
  const source = dir && entry.source.startsWith(`${dir}/`) ? entry.source.slice(dir.length + 1) : entry.source;
31
28
  return `<code>${escapeHtml(source.replace(/\.[^./]+$/, ''))}#${escapeHtml(entry.frame)}</code>`;
@@ -42,23 +39,29 @@ export function reviewSheetHtml(review, theme, frameOrder = [], designDirs = { b
42
39
  };
43
40
  const images = entry.status === 'added' ? capture('after') :
44
41
  `${capture('before')}<span class="arrow" aria-hidden="true">→</span>${capture('after')}`;
45
- const others = (representativeByFrame.get(entry)?.frames.length ?? 1) - 1;
46
- return `<article data-source="${escapeHtml(entry.source)}" data-frame="${escapeHtml(entry.frame)}" data-priority="${priority.get(entry)}" data-frame-count="${frameCount(entry)}"><div class="label">${name(entry, designDirs.after)}${others ? `<span>+${others}</span>` : ''}</div><div class="images">${images}</div></article>`;
42
+ const group = representativeByFrame.get(entry);
43
+ const role = group ? `Representative · ${group.frames.length} ${group.frames.length === 1 ? 'frame' : 'frames'}` :
44
+ entry.change?.kind === 'inherited' ? 'Outlier' : '';
45
+ return `<article data-priority="${priority.get(entry)}"><div class="label">${name(entry, designDirs.after)}${role ? `<span>${role}</span>` : ''}</div><div class="images">${images}</div></article>`;
47
46
  };
48
- const section = (label, entries, render, list = 'div') => entries.length ?
49
- `<section class="${label.toLowerCase()}"><h2>${label}</h2><${list} class="cells">${entries.map(render).join('')}</${list}></section>` : '';
50
- const more = [...added, ...changed].filter(entry => !priority.has(entry)).reduce((sum, entry) => sum + frameCount(entry), 0);
47
+ const section = (kind, label, entries, render, list = 'div') => entries.length ?
48
+ `<section class="${kind}"><h2>${label}</h2><${list} class="cells">${entries.map(render).join('')}</${list}></section>` : '';
49
+ const total = added.length + review.sections.changed.length + removed.length + moved.length + motion.length;
50
+ const more = added.length + review.sections.changed.length + motion.length - priority.size;
51
+ const omittedMotion = motion.filter(entry => !priority.has(entry)).length;
51
52
  return `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>${escapeHtml(review.label)}</title>
52
53
  <style>
53
54
  :root { color-scheme:light; --canvas:#f5f5f3; --text:#20211f; --muted:#575953; --border:#d0d1cc; }
54
55
  .added { --accent:#235c38; --edge:#95b89f; }
55
56
  .changed { --accent:#76500f; --edge:#c5ad77; }
56
57
  .removed { --accent:#923a3a; --edge:#c89595; }
58
+ .moved { --accent:#32567a; --edge:#91abc5; }
57
59
  @media (prefers-color-scheme: dark) {
58
60
  :root { color-scheme:dark; --canvas:#121212; --text:#efefed; --muted:#b3b3ae; --border:#52534e; }
59
61
  .added { --accent:#a4d5ae; --edge:#557a60; }
60
62
  .changed { --accent:#edd097; --edge:#8d7547; }
61
63
  .removed { --accent:#e9aaaa; --edge:#925e5e; }
64
+ .moved { --accent:#abccec; --edge:#58789a; }
62
65
  }
63
66
  * { box-sizing:border-box; }
64
67
  body { margin:0; padding:24px; width:1600px; max-width:100%; background:var(--canvas); color:var(--text); font:16px/1.5 -apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif; }
@@ -70,20 +73,25 @@ body > section { margin-top:16px; }
70
73
  code { font-family:ui-monospace,Menlo,Consolas,monospace; overflow-wrap:anywhere; }
71
74
  .cells { display:grid; grid-template-columns:repeat(2,minmax(0,1fr)); gap:10px; align-items:start; margin:0; padding:0; list-style:none; }
72
75
  .cells > * { min-width:0; padding:8px 12px; border:1px solid var(--edge); border-radius:8px; font-size:14px; }
73
- .label { display:flex; gap:10px; align-items:baseline; font-weight:600; }
74
- .label span { flex:none; }
76
+ .label { display:flex; flex-wrap:wrap; gap:4px 10px; align-items:baseline; font-weight:600; }
77
+ .label span { color:var(--muted); font-weight:400; }
75
78
  .images { display:flex; align-items:center; gap:8px; margin-top:8px; }
76
79
  .capture { flex:1; min-width:0; }
77
80
  .changed .capture:first-child img { margin-inline-start:auto; }
78
81
  .arrow { color:var(--muted); flex:none; font-size:20px; line-height:1; }
79
82
  img { display:block; max-width:100%; height:auto; max-height:480px; object-fit:contain; object-position:left top; }
80
83
  footer { margin-top:12px; color:var(--muted); }
81
- </style></head><body data-theme="${escapeHtml(theme)}">
84
+ ${motion.length ? motionStyle : ''}</style></head><body data-theme="${escapeHtml(theme)}">
82
85
  <header><h1>${escapeHtml(review.label)}</h1>${renderReviewFailures(review.failures)}</header>
83
- ${section('Added', added.filter(entry => priority.has(entry)), card)}
84
- ${section('Changed', changed.filter(entry => priority.has(entry)), card)}
85
- ${section('Removed', removed, entry => `<li data-frame="${escapeHtml(entry.frame)}" data-removed>${name(entry, designDirs.before)}</li>`, 'ul')}
86
- <footer data-more="${more}"${more ? '' : ' hidden'}>${more ? `+${more} more in the review page` : ''}</footer>
86
+ ${total || review.failures.length ? '' : '<p>No design changes.</p>'}
87
+ ${section('added', 'Added', added.filter(entry => priority.has(entry)), card)}
88
+ ${section('changed', 'Direct changes', direct.filter(entry => priority.has(entry)), card)}
89
+ ${section('changed', 'Inherited changes', inherited.filter(entry => priority.has(entry)), card)}
90
+ ${section('changed', 'Transition changes', motion.filter(e => priority.has(e)), e =>
91
+ `<div data-priority="${priority.get(e)}">${motionCard(e, priority.get(e), review.motion.assets)}</div>`)}
92
+ ${section('removed', 'Removed', removed, entry => `<li data-list-entry>${name(entry, designDirs.before)}</li>`, 'ul')}
93
+ ${section('moved', 'Moved', moved, ({ before, after }) => `<li data-list-entry>${name(before, designDirs.before)} → ${name(after, designDirs.after)}</li>`, 'ul')}
94
+ <footer data-motion-more="${omittedMotion}" data-more="${more}"${more ? '' : ' hidden'}>${more ? `+${more} more in the full review${omittedMotion ? ' · ' + omittedMotion + ' transition cards omitted' : ''}` : ''}</footer>
87
95
  </body></html>`;
88
96
  }
89
97
 
@@ -95,22 +103,22 @@ export async function renderReviewSheet(browser, review, theme, file, frameOrder
95
103
  await page.evaluate(readyResources);
96
104
  await page.evaluate(() => {
97
105
  const footer = document.querySelector('footer');
98
- const removed = [...document.querySelectorAll('[data-removed]')].reverse();
106
+ const listEntries = [...document.querySelectorAll('[data-list-entry]')].reverse();
99
107
  const cells = [...document.querySelectorAll('[data-priority]')]
100
108
  .sort((a, b) => Number(b.dataset.priority) - Number(a.dataset.priority));
101
- let more = Number(footer.dataset.more);
102
- for (const entry of [...removed, ...cells]) {
109
+ let more = Number(footer.dataset.more), omittedMotion = Number(footer.dataset.motionMore);
110
+ for (const entry of [...listEntries, ...cells]) {
103
111
  if (document.body.getBoundingClientRect().height <= 4000) break;
104
112
  const grid = entry.parentElement;
105
113
  entry.remove();
106
114
  if (!grid.childElementCount) grid.closest('section').remove();
107
- more += Number(entry.dataset.frameCount ?? 1);
108
- footer.dataset.more = more;
109
- footer.textContent = `+${more} more in the review page`;
115
+ more++;
116
+ if (entry.querySelector('[data-motion]')) omittedMotion++;
117
+ footer.textContent = `+${more} more in the full review` + (omittedMotion ? ` · ${omittedMotion} transition cards omitted` : '');
110
118
  footer.hidden = false;
111
119
  }
112
120
  });
113
- await page.locator('body').screenshot({ path: file, animations: 'disabled', caret: 'hide' });
121
+ await page.locator('body').screenshot({ path: file, type: 'png', animations: 'disabled', caret: 'hide' });
114
122
  });
115
123
  return { path: file, theme };
116
124
  } finally { await page.close(); }