@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
@@ -1,6 +1,7 @@
1
+ import { liveDependencies } from './input-generation.mjs';
1
2
  import { randomUUID } from 'node:crypto';
2
3
  import { existsSync } from 'node:fs';
3
- import { mkdir, rename, rm, writeFile } from 'node:fs/promises';
4
+ import { mkdir, rename, rm, stat, writeFile } from 'node:fs/promises';
4
5
  import { availableParallelism } from 'node:os';
5
6
  import path from 'node:path';
6
7
  import { CliError } from '../cli-output.mjs';
@@ -10,9 +11,12 @@ import { launch, loadFrame } from './browser.mjs';
10
11
  import { diff } from './diff.mjs';
11
12
  import { installFramePrimitives } from './frame-primitives.mjs';
12
13
  import { impactRowKey, withImpacted } from './impact-selection.mjs';
13
- import { readGroups } from './project.mjs';
14
+ import { readGroups, relative } from './project.mjs';
15
+ import { reviewEdgeCandidates, reviewMotion } from './review-motion.mjs';
14
16
  import { reviewDocument } from './review-document.mjs';
17
+ import { reviewEmbedDocument } from './review-embed-document.mjs';
15
18
  import { observeFrame } from './review-observation.mjs';
19
+ import { renderReviewSheet } from './review-sheet.mjs';
16
20
  import { compileSpecimens } from './review-specimens.mjs';
17
21
  import { resolveThemes } from './theme.mjs';
18
22
 
@@ -82,59 +86,155 @@ async function observeUnchanged(session, theme) {
82
86
  }
83
87
  }
84
88
 
89
+ const maxEmbedCards = 8;
90
+
91
+ function selectEmbedEntries(model, comparisons, groups) {
92
+ const byId = new Map([...model.sections.added, ...model.sections.changed].map(entry => [identity(entry), entry]));
93
+ const selected = [], seen = new Set();
94
+ const push = entry => {
95
+ if (!entry || selected.length >= maxEmbedCards) return;
96
+ const key = identity(entry);
97
+ if (seen.has(key)) return;
98
+ seen.add(key);
99
+ selected.push(entry);
100
+ };
101
+ for (const entry of model.sections.added) if (comparisons.get(identity(entry))?.proposed) push(entry);
102
+ for (const entry of model.sections.added) push(entry);
103
+ for (const entry of model.sections.changed) if (entry.change?.kind !== 'inherited') push(entry);
104
+ for (const group of groups ?? []) {
105
+ if (group.representative) push(byId.get(identity(group.representative)));
106
+ for (const outlier of group.outliers ?? []) push(byId.get(identity(outlier)));
107
+ }
108
+ return selected;
109
+ }
110
+
111
+ function buildHtmlReview(model, data, built, theme, locate, format = 'html') {
112
+ const { compileFrame, assets } = compileSpecimens({ built, theme });
113
+ const comparisons = new Map(data.comparisons.filter(row => row.theme === theme).map(row => [identity(row), row]));
114
+ const allEntries = [...model.sections.added, ...model.sections.changed];
115
+ const selected = format === 'embed' ? selectEmbedEntries(model, comparisons, data.review.groups) : allEntries;
116
+ const omitted = allEntries.length - selected.length;
117
+ const cards = selected.map((entry, index) => {
118
+ const row = comparisons.get(identity(entry));
119
+ const changed = entry.status === 'changed';
120
+ const before = changed ? compileFrame(row.before, row.beforeSize, 'before') : null;
121
+ const after = compileFrame(row.after, row.afterSize, 'after');
122
+ const difference = format === 'embed' ? null : (changed ? entry.themes.find(item => item.theme === theme)?.images.difference : null);
123
+ return { index, source: entry.source, frame: entry.frame, status: entry.status, change: entry.change, origin: locate(entry),
124
+ previousOrigin: entry.previousSource && locate(row.before), before, after, difference, differentPixels: row.pixels?.differentPixels,
125
+ proposed: row?.proposed ?? null, note: row?.note?.after ?? row?.note?.before ?? null };
126
+ });
127
+ const report = { title: model.label, theme, base: model.base.sha, head: model.current.head, counts: model.counts, cards, omitted,
128
+ groups: data.review.groups, removed: model.sections.removed.map(entry => ({ ...entry, origin: locate(entry, true) })),
129
+ motion: model.motion, moved: model.movePairs.map(({ before, after }) => ({ before: locate(before, true), after: locate(after) })), failures: model.failures };
130
+ return format === 'embed' ? reviewEmbedDocument(report, assets()) : reviewDocument(report, assets());
131
+ }
132
+
85
133
  /** Generate a standalone, single-theme review without starting a viewer. */
86
134
  export async function review(config, values, { log = console.log } = {}) {
87
135
  const started = performance.now();
136
+ const format = values.format ?? 'html';
137
+ const htmlLike = format === 'html' || format === 'embed';
88
138
  const [theme] = resolveThemes(values.theme ?? 'system');
89
- const destination = path.resolve(config.root, values.out ?? path.join(config.output, 'review.html'));
90
- const projectURL = values['viewer-url'] ?? await hubProjectURL(config.root);
91
- const viewer = projectURL ? previewURL(projectURL, previewTarget({})) : null;
92
- if (viewer) viewer.search = '';
93
- const locate = sourceLocator(config, viewer);
139
+ const destination = path.resolve(config.root, values.out ?? path.join(config.output, format === 'embed' ? 'review-embed.html' : `review.${format}`));
140
+ let locate;
141
+ if (htmlLike) {
142
+ const projectURL = values['viewer-url'] ?? await hubProjectURL(config.root);
143
+ const viewer = projectURL ? previewURL(projectURL, previewTarget({})) : null;
144
+ if (viewer) viewer.search = '';
145
+ locate = sourceLocator(config, viewer);
146
+ }
94
147
  const options = { base: values.base, theme, impacted: true, json: true };
95
- let model, built, skipped;
148
+ let model, built, skipped, baseConfig;
96
149
  const { data, warnings } = await withImpacted(config, [], options, 'diff', async session => {
150
+ const candidates = reviewEdgeCandidates(session, theme);
97
151
  skipped = values.exact ? new Set() : await observeUnchanged(session, theme);
98
- const buildFrames = session.diffInputs.buildFrames, scheduled = session.scheduled;
99
- session.diffInputs.buildFrames = async options => (built = await buildFrames(options));
152
+ const scheduled = session.scheduled;
153
+ if (htmlLike) {
154
+ const buildFrames = session.diffInputs.buildFrames;
155
+ session.diffInputs.buildFrames = async options => (built = await buildFrames(options));
156
+ }
157
+ baseConfig = session.diffInputs.before.config;
100
158
  session.scheduled = (row, theme) => scheduled(row, theme) && !skipped.has(impactRowKey(row, theme));
159
+ let result;
101
160
  try {
102
- return await diff(config, [], options, { session, reviewOnly: true, onReview: value => { model = value; } });
161
+ result = await diff(config, [], options, { session, reviewFormat: format, onReview: value => { model = value; } });
103
162
  } catch (error) {
104
163
  if (error.code !== 'DIFF_FAILED' && !error.partialSourceFailures) throw error;
105
- return { data: error.data, warnings: error.warnings };
164
+ result = { data: error.data, warnings: error.warnings };
106
165
  } finally {
107
166
  session.scheduled = scheduled;
108
167
  }
168
+ model.motion = await reviewMotion(session, candidates, model, result.data.comparisons, theme);
169
+ if (model.failures.length) model.complete = false;
170
+ if (model.motion) result.data.motion = { count: model.motion.cards.length };
171
+ return result;
109
172
  });
110
173
 
111
- const { compileFrame, assets } = compileSpecimens({ built, theme });
112
- const comparisons = new Map(data.comparisons.filter(row => row.theme === theme).map(row => [identity(row), row]));
113
- const cards = [...model.sections.added, ...model.sections.changed].map((entry, index) => {
114
- const row = comparisons.get(identity(entry));
115
- const changed = entry.status === 'changed';
116
- const before = changed ? compileFrame(row.before, row.beforeSize, 'before') : null;
117
- const after = compileFrame(row.after, row.afterSize, 'after');
118
- const difference = changed ? entry.themes.find(item => item.theme === theme)?.images.difference : null;
119
- return { index, source: entry.source, frame: entry.frame, status: entry.status, change: entry.change, origin: locate(entry),
120
- previousOrigin: entry.previousSource && locate(row.before), before, after, difference, differentPixels: row.pixels?.differentPixels };
121
- });
122
- const report = { title: model.label, theme, base: model.base.sha, head: model.current.head, counts: model.counts, cards,
123
- groups: data.review.groups, removed: model.sections.removed.map(entry => ({ ...entry, origin: locate(entry, true) })),
124
- moved: model.movePairs.map(({ before, after }) => ({ before: locate(before, true), after: locate(after) })), failures: model.failures };
125
- const html = reviewDocument(report, assets());
126
174
  const temporary = `${destination}.${randomUUID()}.tmp`;
127
175
  await mkdir(path.dirname(destination), { recursive: true });
176
+ let bytes;
128
177
  try {
129
- await writeFile(temporary, html);
178
+ if (format === 'png') {
179
+ const browser = await launch();
180
+ try {
181
+ const designDirs = { before: relative(baseConfig, baseConfig.design), after: relative(config, config.design) };
182
+ await renderReviewSheet(browser, model, theme, temporary, data.comparisons, designDirs);
183
+ } finally {
184
+ await browser.close();
185
+ }
186
+ } else {
187
+ await writeFile(temporary, buildHtmlReview(model, data, built, theme, locate, format));
188
+ }
189
+ ({ size: bytes } = await stat(temporary));
130
190
  await rename(temporary, destination);
131
191
  } finally {
132
192
  await rm(temporary, { force: true });
133
193
  }
134
- const result = { path: destination, base: model.base, current: model.current, theme, counts: model.counts, groups: data.review.groups,
194
+ const result = { path: destination, format, base: model.base, current: model.current, theme, counts: model.counts, groups: data.review.groups,
135
195
  mode: values.exact ? 'exact' : 'hybrid', structureMatches: skipped.size, pixelComparisons: data.summary.comparisons,
136
- complete: model.complete, failures: model.failures, bytes: Buffer.byteLength(html), generationMs: performance.now() - started };
137
- if (!values.json) log(`${destination}\n${result.counts.added} added, ${result.counts.changed} changed, ${result.counts.removed} removed, ${result.counts.moved} moved.`);
196
+ complete: model.complete, failures: model.failures, bytes, generationMs: performance.now() - started };
197
+ if (model.motion) {
198
+ result.motion = { added: 0, changed: 0, removed: 0 };
199
+ for (const card of model.motion.cards) result.motion[card.kind]++;
200
+ }
201
+ if (!values.json) {
202
+ log(`${destination}\n${result.counts.added} added, ${result.counts.changed} changed, ${result.counts.removed} removed, ${result.counts.moved} moved.`);
203
+ if (result.motion) log(`Transitions: ${result.motion.added} added, ${result.motion.changed} changed, ${result.motion.removed} removed.`);
204
+ }
138
205
  if (!result.complete) throw new CliError('SOURCE_BUILD_FAILED', 'Review contains source build failures.', { data: result, warnings });
139
206
  return { data: result, warnings };
140
207
  }
208
+
209
+ // Project the same two-theme visual verdicts into rows before generating any report or image assets.
210
+ export async function reviewFrameChanges(config, options) {
211
+ const values = { ...options, theme: 'both', impacted: true, json: true };
212
+ let model;
213
+ let dependencies;
214
+ options.onProgress?.({phase:'Resolving frame inputs'});
215
+ const { data } = await withImpacted(config, [], values, 'diff', async session => {
216
+ const scheduled = session.scheduled;
217
+ const skipped = new Set();
218
+ for (const theme of session.themes) {
219
+ options.onProgress?.({phase:'Inspecting '+theme+' frames'});
220
+ for (const key of await observeUnchanged(session, theme)) skipped.add(key);
221
+ }
222
+ options.onProgress?.({phase:'Comparing frame images'});
223
+ session.scheduled = (row, theme) => scheduled(row, theme) && !skipped.has(impactRowKey(row, theme));
224
+ dependencies = await liveDependencies(session.views,options.temporaryDirectory);
225
+ try {
226
+ return await diff(session.diffInputs.after.config, [], values, {
227
+ session, reviewFormat: 'rows', onReview: value => { model = value; }
228
+ });
229
+ } catch (error) {
230
+ if (error.code !== 'DIFF_FAILED' && !error.partialSourceFailures) throw error;
231
+ return { data: error.data, warnings: error.warnings ?? [] };
232
+ }
233
+ });
234
+ const rows = Object.values(model.sections).flat().map(({source,frame,status,previousSource}) => {
235
+ const former = previousSource && data.comparisons.find(c => c.source === source && c.frame === frame)?.before;
236
+ return { source,frame,status, ...(former ? {former} : {}) };
237
+ });
238
+ for (const {before,after} of model.movePairs) rows.push({...after,status:'moved',former:before});
239
+ return { rows, complete:model.complete, failures:model.failures, dependencies };
240
+ }
@@ -44,8 +44,14 @@ export function jsx(type, props = {}, key = props.key) {
44
44
  return result;
45
45
  }
46
46
  export const jsxs = jsx;
47
+ let frameOrigins;
48
+ export const captureFrameOrigins = () => (frameOrigins ??= new WeakMap());
47
49
  export function jsxDEV(type, props, key, isStatic, source) {
48
- try { return jsx(type, props, key); }
50
+ try {
51
+ const value = jsx(type, props, key);
52
+ if (frameOrigins && type === Frame && source) frameOrigins.set(value,source);
53
+ return value;
54
+ }
49
55
  catch (error) { if (!error.located && source) { error.message = `${source.fileName}:${source.lineNumber}:${source.columnNumber}: ${error.message}`; error.located = true; } throw error; }
50
56
  }
51
57
  export function Frame({ children: content, ...props }) { return { frame: true, ...props, html: children(content) }; }
@@ -16,11 +16,11 @@ export async function createViewerCache(directory, {memoryBytes=32*1024*1024,dis
16
16
  } catch(error) {if(error.code!=='ENOENT' && !(error instanceof SyntaxError)) throw error;}
17
17
  total=[...entries.values()].reduce((n,entry)=>n+entry.bytes,0);
18
18
  const keyFor=(hash,theme,context)=>digest(JSON.stringify([hash,theme,context]));
19
- function remember(key,metadata) {
19
+ // Version-1 entries can omit metadataBytes. Count only their UTF-8 metadata.
20
+ function remember(key,text,bytes=Buffer.byteLength(text)) {
20
21
  if(resident.has(key)){residentBytes-=resident.get(key).bytes;resident.delete(key);}
21
- const bytes=Buffer.byteLength(JSON.stringify(metadata));
22
22
  if(bytes>memoryBytes)return;
23
- resident.set(key,{metadata,bytes});residentBytes+=bytes;
23
+ resident.set(key,{text,bytes});residentBytes+=bytes;
24
24
  while(residentBytes>memoryBytes){const first=resident.keys().next().value;residentBytes-=resident.get(first).bytes;resident.delete(first);}
25
25
  }
26
26
  async function persist() {
@@ -41,13 +41,33 @@ export async function createViewerCache(directory, {memoryBytes=32*1024*1024,dis
41
41
  pending=result.catch(()=>{});
42
42
  return result;
43
43
  }
44
- async function get(hash,theme,context) {
44
+ async function readMetadata(hash,theme,context) {
45
45
  const key=keyFor(hash,theme,context),entry=entries.get(key);
46
46
  if(!entry)return null;
47
- let metadata=resident.get(key)?.metadata;
48
- if(!metadata){try{metadata=JSON.parse(await readFile(path.join(directory,key,'metadata.json'),'utf8'));}catch(error){if(error.code==='ENOENT')return null;throw error;}}
49
- if(resident.has(key)){const item=resident.get(key);resident.delete(key);resident.set(key,item);}else remember(key,metadata);entry.used=Date.now();
50
- return {metadata,previewIds:Object.keys(entry.previews)};
47
+ let cached=resident.get(key);
48
+ if(cached) {
49
+ resident.delete(key);resident.set(key,cached);
50
+ } else {
51
+ let text;
52
+ try {text=await readFile(path.join(directory,key,'metadata.json'),'utf8');}
53
+ catch(error){if(error.code==='ENOENT')return null;throw error;}
54
+ cached={text};
55
+ remember(key,text,entry.metadataBytes);
56
+ }
57
+ entry.used=Date.now();
58
+ return {text:cached.text,previewIds:Object.keys(entry.previews)};
59
+ }
60
+ async function get(hash,theme,context) {
61
+ const saved=await readMetadata(hash,theme,context);
62
+ return saved && {metadata:JSON.parse(saved.text),previewIds:saved.previewIds};
63
+ }
64
+ async function layout(hash,theme,context) {
65
+ const key=keyFor(hash,theme,context);
66
+ const entry=entries.get(key);
67
+ if (!entry || entry.layoutBytes === undefined) return;
68
+ if (!entry.layoutBytes) return (await get(hash,theme,context))?.metadata;
69
+ try { return JSON.parse(await readFile(path.join(directory,key,'layout.json'),'utf8')); }
70
+ catch(error) { if(error.code==='ENOENT')return;throw error; }
51
71
  }
52
72
  async function save(hash,theme,context,metadata) {
53
73
  return mutate(async()=>{
@@ -55,10 +75,25 @@ export async function createViewerCache(directory, {memoryBytes=32*1024*1024,dis
55
75
  await mkdir(location,{recursive:true});
56
76
  const temporary=path.join(location,'metadata.'+randomUUID()+'.tmp');
57
77
  await writeFile(temporary,text);
58
- await rename(temporary,path.join(location,'metadata.json'));
78
+ const outline=JSON.stringify({...metadata,parts:metadata.parts.map(({elements,...part})=>part)});
59
79
  const old=entries.get(key),bytes=Buffer.byteLength(text);
60
- const entry={key,hash,theme,context,metadataBytes:bytes,previews:old?.previews??{},bytes:bytes+Object.values(old?.previews??{}).reduce((n,p)=>n+p.bytes,0),used:Date.now()};
61
- total+=entry.bytes-(old?.bytes??0);entries.set(key,entry);remember(key,metadata);
80
+ const layoutBytes=outline===text ? 0 : Buffer.byteLength(outline);
81
+ const layoutFile=path.join(location,'layout.json');
82
+ const layoutTemp=layoutBytes && path.join(location,'layout.'+randomUUID()+'.tmp');
83
+ try {
84
+ if(layoutTemp)await writeFile(layoutTemp,outline);
85
+ // An interrupted overwrite leaves a projection miss. Readers can still
86
+ // recover the complete record from the atomically replaced metadata.
87
+ if(old)await rm(layoutFile,{force:true});
88
+ await rename(temporary,path.join(location,'metadata.json'));
89
+ if(layoutTemp)await rename(layoutTemp,layoutFile);
90
+ } catch (error) {
91
+ await rm(temporary,{force:true});
92
+ if(layoutTemp)await rm(layoutTemp,{force:true});
93
+ throw error;
94
+ }
95
+ const entry={key,hash,theme,context,metadataBytes:bytes,layoutBytes,previews:old?.previews??{},bytes:bytes+layoutBytes+Object.values(old?.previews??{}).reduce((n,p)=>n+p.bytes,0),used:Date.now()};
96
+ total+=entry.bytes-(old?.bytes??0);entries.set(key,entry);remember(key,text,bytes);
62
97
  await trim();await persist();
63
98
  });
64
99
  }
@@ -81,5 +116,6 @@ export async function createViewerCache(directory, {memoryBytes=32*1024*1024,dis
81
116
  catch(error){if(error.code==='ENOENT')return null;throw error;}
82
117
  }
83
118
  const reference=(hash,theme,context)=>{const entry=entries.get(keyFor(hash,theme,context));if(entry)entry.used=Date.now();return entry?{previewIds:Object.keys(entry.previews)}:null;};
84
- return {get,reference,save,savePreview,preview,close:()=>pending,stats:()=>({entries:entries.size,residentBytes,diskBytes:total})};
119
+ const hasLayout=(hash,theme,context)=>entries.get(keyFor(hash,theme,context))?.layoutBytes !== undefined;
120
+ return {get,layout,hasLayout,readMetadata,reference,save,savePreview,preview,close:()=>pending,stats:()=>({entries:entries.size,residentBytes,diskBytes:total})};
85
121
  }