@whzxc/agent-design-gallery 0.14.1 → 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.
- package/README.md +29 -16
- package/package.json +2 -1
- package/public/access.css +15 -2
- package/public/app.js +1284 -521
- package/public/arrangement-worker.js +7 -7
- package/public/arrangement.js +35 -30
- package/public/assets.js +85 -48
- package/public/auth.js +59 -4
- package/public/boards.js +129 -0
- package/public/comment-anchors.js +50 -0
- package/public/comments.css +400 -0
- package/public/comments.js +1106 -0
- package/public/context-menu.js +97 -0
- package/public/frame-identity.js +51 -14
- package/public/hub.css +25 -3
- package/public/hub.html +10 -2
- package/public/hub.js +127 -23
- package/public/icons.js +9 -0
- package/public/index.html +26 -10
- package/public/instance-actions.js +9 -2
- package/public/layout.js +156 -86
- package/public/motion-flow.js +28 -0
- package/public/motion-identity.js +100 -0
- package/public/motion-paint.js +332 -0
- package/public/motion-scene.js +165 -0
- package/public/motion-specimens.js +335 -0
- package/public/player.css +270 -0
- package/public/player.js +753 -0
- package/public/recent-updates.js +535 -0
- package/public/selection.js +1 -1
- package/public/style.css +91 -154
- package/public/switcher.css +5 -4
- package/public/switcher.js +109 -34
- package/public/token-catalog.js +8 -3
- package/public/tokens.css +20 -1
- package/public/view-boards.css +131 -0
- package/public/view-boards.js +350 -0
- package/public/view-route.js +1 -2
- package/src/boards/board.mjs +30 -0
- package/src/boards/motion-board.mjs +202 -0
- package/src/boards/token-board.mjs +200 -0
- package/src/cli-output.mjs +10 -5
- package/src/cli.mjs +89 -35
- package/src/comments.mjs +293 -0
- package/src/http.mjs +7 -5
- package/src/hub/project-link.mjs +41 -0
- package/src/hub/registry.mjs +5 -0
- package/src/hub.mjs +14 -10
- package/src/link.mjs +13 -1
- package/src/recent-frames.mjs +295 -0
- package/src/recent-history.mjs +100 -0
- package/src/recent-job.mjs +63 -0
- package/src/recent-worker.mjs +171 -0
- package/src/server.mjs +285 -110
- package/src/service.mjs +46 -12
- package/src/toolkit/arch-git.mjs +8 -14
- package/src/toolkit/arch.mjs +3 -2
- package/src/toolkit/asset-rules.mjs +24 -1
- package/src/toolkit/browser.mjs +1 -13
- package/src/toolkit/build-store.mjs +9 -1
- package/src/toolkit/build-worker.mjs +6 -0
- package/src/toolkit/build.mjs +22 -16
- package/src/toolkit/commands.mjs +105 -9
- package/src/toolkit/compare.mjs +13 -11
- package/src/toolkit/config.mjs +2 -2
- package/{public/review.js → src/toolkit/diff-document.mjs} +137 -43
- package/src/toolkit/diff-inputs.mjs +97 -52
- package/src/toolkit/diff.mjs +198 -43
- package/src/toolkit/frame-declarations.mjs +36 -0
- package/src/toolkit/git-blobs.mjs +50 -0
- package/src/toolkit/impact-inputs.mjs +11 -19
- package/src/toolkit/impact-selection.mjs +27 -12
- package/src/toolkit/impact.mjs +49 -15
- package/src/toolkit/implementation-map.mjs +17 -6
- package/src/toolkit/input-generation.mjs +15 -0
- package/src/toolkit/inspect-output.mjs +1 -1
- package/src/toolkit/inspect.d.ts +9 -1
- package/src/toolkit/inspect.mjs +25 -1
- package/src/toolkit/motion-check.mjs +382 -0
- package/src/toolkit/motion-css.mjs +105 -0
- package/src/toolkit/motion-flows.mjs +95 -0
- package/src/toolkit/motion-impact.mjs +87 -0
- package/src/toolkit/motion-inventory.mjs +202 -0
- package/src/toolkit/motion-label.mjs +111 -0
- package/src/toolkit/motion-patterns.mjs +216 -0
- package/src/toolkit/motion-primitives.mjs +94 -0
- package/src/toolkit/motion-queries.mjs +169 -0
- package/src/toolkit/motion.mjs +300 -0
- package/src/toolkit/move-pairing.mjs +140 -0
- package/src/toolkit/owner.mjs +19 -6
- package/src/toolkit/play-endpoint.mjs +66 -0
- package/src/toolkit/project-index.mjs +4 -4
- package/src/toolkit/recent-structure.mjs +201 -0
- package/src/toolkit/results.mjs +3 -3
- package/src/toolkit/review-document.mjs +440 -0
- package/src/toolkit/review-embed-document.mjs +671 -0
- package/src/toolkit/review-filmstrip.mjs +76 -0
- package/src/toolkit/review-groups.mjs +29 -0
- package/src/toolkit/review-motion-card.mjs +51 -0
- package/src/toolkit/review-motion.mjs +159 -0
- package/src/toolkit/review-observation.mjs +131 -0
- package/src/toolkit/review-playback.js +123 -0
- package/src/toolkit/review-sheet.mjs +125 -0
- package/src/toolkit/review-specimens.mjs +60 -0
- package/src/toolkit/review.mjs +240 -0
- package/src/toolkit/runtime.mjs +8 -2
- package/src/toolkit/theme.mjs +16 -0
- package/src/viewer-cache.mjs +48 -12
- package/public/annotations.js +0 -816
- package/public/labels.js +0 -122
- package/src/annotations.mjs +0 -238
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import { motionCard, motionStyle } from './review-motion-card.mjs';
|
|
2
|
+
import { renderReviewFailures } from './diff-document.mjs';
|
|
3
|
+
import { browserTask, readyResources } from './browser.mjs';
|
|
4
|
+
|
|
5
|
+
const escapeHtml = value => String(value ?? '').replace(/[&<>"']/g, char => (
|
|
6
|
+
{ '&': '&', '<': '<', '>': '>', '"': '"', "'": ''' }[char]
|
|
7
|
+
));
|
|
8
|
+
|
|
9
|
+
export function reviewSheetHtml(review, theme, frameOrder = [], designDirs = { before: 'design', after: 'design' }) {
|
|
10
|
+
const order = new Map(frameOrder.map((row, index) => [JSON.stringify([row.source, row.frame]), index]));
|
|
11
|
+
const compare = (a, b) => a.source.localeCompare(b.source, 'en') ||
|
|
12
|
+
(order.get(JSON.stringify([a.source, a.frame])) ?? 0) - (order.get(JSON.stringify([b.source, b.frame])) ?? 0);
|
|
13
|
+
const added = [...review.sections.added].sort(compare);
|
|
14
|
+
const direct = review.sections.changed.filter(entry => entry.change?.kind !== 'inherited').sort(compare);
|
|
15
|
+
const removed = [...review.sections.removed].sort(compare);
|
|
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
|
+
const representativeByFrame = new Map(groups.map(group => [group.representative, group]));
|
|
19
|
+
const outliers = groups.flatMap(group => group.outliers);
|
|
20
|
+
const inherited = groups.flatMap(group => [group.representative, ...group.outliers]);
|
|
21
|
+
const [firstAdded, ...otherAdded] = added;
|
|
22
|
+
const [firstDirect, ...otherDirect] = direct;
|
|
23
|
+
const motion = review.motion?.cards ?? [];
|
|
24
|
+
const priority = new Map([firstAdded, firstDirect, ...motion, ...representativeByFrame.keys(), ...otherAdded, ...otherDirect,
|
|
25
|
+
...outliers].filter(Boolean).slice(0, 12).map((entry, index) => [entry, index]));
|
|
26
|
+
const name = (entry, dir) => {
|
|
27
|
+
const source = dir && entry.source.startsWith(`${dir}/`) ? entry.source.slice(dir.length + 1) : entry.source;
|
|
28
|
+
return `<code>${escapeHtml(source.replace(/\.[^./]+$/, ''))}#${escapeHtml(entry.frame)}</code>`;
|
|
29
|
+
};
|
|
30
|
+
const card = entry => {
|
|
31
|
+
const row = entry.themes.find(row => row.theme === theme);
|
|
32
|
+
const capture = side => {
|
|
33
|
+
const src = row?.images?.[side];
|
|
34
|
+
const sizeInfo = row?.[`${side}Size`];
|
|
35
|
+
const width = sizeInfo && sizeInfo.width * Math.min(1, 480 / sizeInfo.height);
|
|
36
|
+
const size = Number.isFinite(width) && width > 0 ? ` style="width:${width}px"` : '';
|
|
37
|
+
const image = src?.startsWith('data:image/png;base64,') ? `<img src="${escapeHtml(src)}" alt=""${size}>` : '';
|
|
38
|
+
return `<div class="capture">${image}</div>`;
|
|
39
|
+
};
|
|
40
|
+
const images = entry.status === 'added' ? capture('after') :
|
|
41
|
+
`${capture('before')}<span class="arrow" aria-hidden="true">→</span>${capture('after')}`;
|
|
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>`;
|
|
46
|
+
};
|
|
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;
|
|
52
|
+
return `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>${escapeHtml(review.label)}</title>
|
|
53
|
+
<style>
|
|
54
|
+
:root { color-scheme:light; --canvas:#f5f5f3; --text:#20211f; --muted:#575953; --border:#d0d1cc; }
|
|
55
|
+
.added { --accent:#235c38; --edge:#95b89f; }
|
|
56
|
+
.changed { --accent:#76500f; --edge:#c5ad77; }
|
|
57
|
+
.removed { --accent:#923a3a; --edge:#c89595; }
|
|
58
|
+
.moved { --accent:#32567a; --edge:#91abc5; }
|
|
59
|
+
@media (prefers-color-scheme: dark) {
|
|
60
|
+
:root { color-scheme:dark; --canvas:#121212; --text:#efefed; --muted:#b3b3ae; --border:#52534e; }
|
|
61
|
+
.added { --accent:#a4d5ae; --edge:#557a60; }
|
|
62
|
+
.changed { --accent:#edd097; --edge:#8d7547; }
|
|
63
|
+
.removed { --accent:#e9aaaa; --edge:#925e5e; }
|
|
64
|
+
.moved { --accent:#abccec; --edge:#58789a; }
|
|
65
|
+
}
|
|
66
|
+
* { box-sizing:border-box; }
|
|
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; }
|
|
68
|
+
header { max-height:3800px; overflow:hidden; }
|
|
69
|
+
.review-failures { padding:16px; border:1px solid var(--border); border-radius:8px; margin-top:16px; overflow-wrap:anywhere; }
|
|
70
|
+
h1 { margin:0; font-size:26px; }
|
|
71
|
+
h2 { margin:0 0 8px; color:var(--accent); font-size:18px; }
|
|
72
|
+
body > section { margin-top:16px; }
|
|
73
|
+
code { font-family:ui-monospace,Menlo,Consolas,monospace; overflow-wrap:anywhere; }
|
|
74
|
+
.cells { display:grid; grid-template-columns:repeat(2,minmax(0,1fr)); gap:10px; align-items:start; margin:0; padding:0; list-style:none; }
|
|
75
|
+
.cells > * { min-width:0; padding:8px 12px; border:1px solid var(--edge); border-radius:8px; font-size:14px; }
|
|
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; }
|
|
78
|
+
.images { display:flex; align-items:center; gap:8px; margin-top:8px; }
|
|
79
|
+
.capture { flex:1; min-width:0; }
|
|
80
|
+
.changed .capture:first-child img { margin-inline-start:auto; }
|
|
81
|
+
.arrow { color:var(--muted); flex:none; font-size:20px; line-height:1; }
|
|
82
|
+
img { display:block; max-width:100%; height:auto; max-height:480px; object-fit:contain; object-position:left top; }
|
|
83
|
+
footer { margin-top:12px; color:var(--muted); }
|
|
84
|
+
${motion.length ? motionStyle : ''}</style></head><body data-theme="${escapeHtml(theme)}">
|
|
85
|
+
<header><h1>${escapeHtml(review.label)}</h1>${renderReviewFailures(review.failures)}</header>
|
|
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>
|
|
95
|
+
</body></html>`;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
export async function renderReviewSheet(browser, review, theme, file, frameOrder, designDirs) {
|
|
99
|
+
const page = await browserTask(browser, () => browser.newPage({ viewport: { width: 1600, height: 900 }, deviceScaleFactor: 2, colorScheme: theme, reducedMotion: 'reduce' }));
|
|
100
|
+
try {
|
|
101
|
+
await browserTask(browser, async () => {
|
|
102
|
+
await page.setContent(reviewSheetHtml(review, theme, frameOrder, designDirs));
|
|
103
|
+
await page.evaluate(readyResources);
|
|
104
|
+
await page.evaluate(() => {
|
|
105
|
+
const footer = document.querySelector('footer');
|
|
106
|
+
const listEntries = [...document.querySelectorAll('[data-list-entry]')].reverse();
|
|
107
|
+
const cells = [...document.querySelectorAll('[data-priority]')]
|
|
108
|
+
.sort((a, b) => Number(b.dataset.priority) - Number(a.dataset.priority));
|
|
109
|
+
let more = Number(footer.dataset.more), omittedMotion = Number(footer.dataset.motionMore);
|
|
110
|
+
for (const entry of [...listEntries, ...cells]) {
|
|
111
|
+
if (document.body.getBoundingClientRect().height <= 4000) break;
|
|
112
|
+
const grid = entry.parentElement;
|
|
113
|
+
entry.remove();
|
|
114
|
+
if (!grid.childElementCount) grid.closest('section').remove();
|
|
115
|
+
more++;
|
|
116
|
+
if (entry.querySelector('[data-motion]')) omittedMotion++;
|
|
117
|
+
footer.textContent = `+${more} more in the full review` + (omittedMotion ? ` · ${omittedMotion} transition cards omitted` : '');
|
|
118
|
+
footer.hidden = false;
|
|
119
|
+
}
|
|
120
|
+
});
|
|
121
|
+
await page.locator('body').screenshot({ path: file, type: 'png', animations: 'disabled', caret: 'hide' });
|
|
122
|
+
});
|
|
123
|
+
return { path: file, theme };
|
|
124
|
+
} finally { await page.close(); }
|
|
125
|
+
}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import * as css from 'css-tree';
|
|
2
|
+
import { parseFragment, serialize } from 'parse5';
|
|
3
|
+
|
|
4
|
+
export function compileSpecimens({ built, theme }) {
|
|
5
|
+
const properties = new Set(), styles = new Map(), templates = [];
|
|
6
|
+
function scopedUnits(ast) {
|
|
7
|
+
css.walk(ast, { visit: 'Dimension', enter(node, item) {
|
|
8
|
+
if (/^[sld]?v(w|h|min|max)$/i.test(node.unit)) {
|
|
9
|
+
const unit = node.unit.toLowerCase().replace(/^[sld]/, '');
|
|
10
|
+
item.data = css.parse(`calc(${node.value} * var(--review-${unit}))`, { context: 'value' }).children.first;
|
|
11
|
+
}
|
|
12
|
+
} });
|
|
13
|
+
return ast;
|
|
14
|
+
}
|
|
15
|
+
function compileStyle(source) {
|
|
16
|
+
if (styles.has(source)) return styles.get(source).index;
|
|
17
|
+
const ast = scopedUnits(css.parse(source));
|
|
18
|
+
css.walk(ast, (node, item, list) => {
|
|
19
|
+
if (node.type === 'Atrule' && node.name === 'property') {
|
|
20
|
+
properties.add(css.generate(node));
|
|
21
|
+
list.remove(item);
|
|
22
|
+
} else if (node.type === 'PseudoClassSelector' && ['root', 'host'].includes(node.name) && !node.children) {
|
|
23
|
+
item.data = { type: 'ClassSelector', name: 'review-root' };
|
|
24
|
+
} else if (node.type === 'TypeSelector' && ['html', 'body'].includes(node.name)) {
|
|
25
|
+
node.name = node.name === 'html' ? 'review-document' : 'review-body';
|
|
26
|
+
}
|
|
27
|
+
});
|
|
28
|
+
const index = styles.size;
|
|
29
|
+
styles.set(source, { index, text: css.generate(ast) });
|
|
30
|
+
return index;
|
|
31
|
+
}
|
|
32
|
+
function compileFrame(ref, size, side) {
|
|
33
|
+
if (!ref) return null;
|
|
34
|
+
const source = built[side].get(ref.source);
|
|
35
|
+
const frame = source?.frames.find(frame => frame.name === ref.frame);
|
|
36
|
+
if (!frame || !size) throw Error(`Missing ${side} source for ${ref.source}#${ref.frame}`);
|
|
37
|
+
const fragment = parseFragment(frame.html);
|
|
38
|
+
function scopeInlineStyles(node) {
|
|
39
|
+
const style = node.attrs?.find(attr => attr.name === 'style');
|
|
40
|
+
if (style && /[\d.]v(?:h|w|min|max)\b|[\d.][sld]v(?:h|w|min|max)\b/i.test(style.value)) {
|
|
41
|
+
style.value = css.generate(scopedUnits(css.parse(style.value, { context: 'declarationList' })));
|
|
42
|
+
}
|
|
43
|
+
for (const child of node.childNodes ?? []) scopeInlineStyles(child);
|
|
44
|
+
}
|
|
45
|
+
scopeInlineStyles(fragment);
|
|
46
|
+
const index = templates.length;
|
|
47
|
+
const { width, height } = size;
|
|
48
|
+
const widthStyle = frame.width ? `width:${frame.width}px;` : 'width:max-content;';
|
|
49
|
+
const heightStyle = frame.height ? `height:${frame.height}px;` : '';
|
|
50
|
+
const name = frame.name.replaceAll('&', '&').replaceAll('"', '"');
|
|
51
|
+
templates.push(`<template id="frame-${index}"><review-document class="review-root" data-theme="${theme}"><review-body><div data-adg-frame="${name}" style="${widthStyle}${heightStyle}">${serialize(fragment)}</div></review-body></review-document></template>`);
|
|
52
|
+
const defaults = source.cssAfterTokens;
|
|
53
|
+
// Drop only the backdrop appended by ADG. Authored element and stylesheet paint stays intact.
|
|
54
|
+
const stylesheet = defaults && source.css.endsWith(defaults)
|
|
55
|
+
? source.css.slice(0, -defaults.length) + defaults.replaceAll(';background:var(--canvas)', '')
|
|
56
|
+
: source.css;
|
|
57
|
+
return { template: index, style: compileStyle(stylesheet), width, height };
|
|
58
|
+
}
|
|
59
|
+
return { compileFrame, assets: () => ({ properties: [...properties], styles: [...styles.values()].map(style => style.text), templates }) };
|
|
60
|
+
}
|
|
@@ -0,0 +1,240 @@
|
|
|
1
|
+
import { liveDependencies } from './input-generation.mjs';
|
|
2
|
+
import { randomUUID } from 'node:crypto';
|
|
3
|
+
import { existsSync } from 'node:fs';
|
|
4
|
+
import { mkdir, rename, rm, stat, writeFile } from 'node:fs/promises';
|
|
5
|
+
import { availableParallelism } from 'node:os';
|
|
6
|
+
import path from 'node:path';
|
|
7
|
+
import { CliError } from '../cli-output.mjs';
|
|
8
|
+
import { hubProjectURL } from '../hub/project-link.mjs';
|
|
9
|
+
import { previewTarget, previewURL } from '../link.mjs';
|
|
10
|
+
import { launch, loadFrame } from './browser.mjs';
|
|
11
|
+
import { diff } from './diff.mjs';
|
|
12
|
+
import { installFramePrimitives } from './frame-primitives.mjs';
|
|
13
|
+
import { impactRowKey, withImpacted } from './impact-selection.mjs';
|
|
14
|
+
import { readGroups, relative } from './project.mjs';
|
|
15
|
+
import { reviewEdgeCandidates, reviewMotion } from './review-motion.mjs';
|
|
16
|
+
import { reviewDocument } from './review-document.mjs';
|
|
17
|
+
import { reviewEmbedDocument } from './review-embed-document.mjs';
|
|
18
|
+
import { observeFrame } from './review-observation.mjs';
|
|
19
|
+
import { renderReviewSheet } from './review-sheet.mjs';
|
|
20
|
+
import { compileSpecimens } from './review-specimens.mjs';
|
|
21
|
+
import { resolveThemes } from './theme.mjs';
|
|
22
|
+
|
|
23
|
+
const identity = ({ source, frame }) => JSON.stringify([source, frame]);
|
|
24
|
+
const abbreviations = { adg: 'ADG', ai: 'AI', api: 'API', hpc: 'HPC', html: 'HTML', llm: 'LLM', macos: 'macOS', mcp: 'MCP', pdf: 'PDF', scnet: 'SCNet', ui: 'UI' };
|
|
25
|
+
|
|
26
|
+
function readable(value, titleCase = false) {
|
|
27
|
+
return value.split(/[-_]+/).map((part, index) => abbreviations[part.toLowerCase()] ?? (index === 0 || titleCase
|
|
28
|
+
? part.charAt(0).toUpperCase() + part.slice(1) : part)).join(' ');
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
function sourceLocator(config, viewer) {
|
|
32
|
+
const design = path.relative(config.root, config.design).split(path.sep).join('/');
|
|
33
|
+
const chapters = new Map();
|
|
34
|
+
for (const { title, assets } of readGroups(config.design, config.sources)) for (const asset of assets) {
|
|
35
|
+
if (!chapters.has(asset)) chapters.set(asset, title);
|
|
36
|
+
}
|
|
37
|
+
return ({ source, frame }, removed = false) => {
|
|
38
|
+
const architecture = source.endsWith('.mmd');
|
|
39
|
+
const asset = architecture ? source : path.posix.relative(design, source);
|
|
40
|
+
const parts = asset.split('/'), layer = architecture ? 'arch' : parts[0];
|
|
41
|
+
const filename = parts.at(-1);
|
|
42
|
+
const title = filename === 'index.tsx' ? parts.at(-2) : filename.replace(/\.(tsx|svg|mmd)$/, '');
|
|
43
|
+
const target = !removed ? { asset, frame } : existsSync(path.join(config.root, source)) ? { asset } : { layer };
|
|
44
|
+
return { layer: architecture ? 'Architecture' : readable(layer, true), chapter: chapters.get(asset), title: readable(title, true),
|
|
45
|
+
frame: readable(frame), href: viewer ? previewURL(viewer.href, previewTarget(target)).href : null };
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
async function observeUnchanged(session, theme) {
|
|
50
|
+
const key = row => impactRowKey(row, theme);
|
|
51
|
+
const candidates = session.chosen.filter(row => row.status === 'matched' && session.scheduled(row, theme) &&
|
|
52
|
+
row.source.endsWith('.tsx') && !session.assessments.get(key(row))?.unassessedReasons?.length);
|
|
53
|
+
const skipped = new Set();
|
|
54
|
+
if (!candidates.length) return skipped;
|
|
55
|
+
const browser = await launch();
|
|
56
|
+
try {
|
|
57
|
+
const parents = new Set(session.chosen.filter(row => row.status === 'added' && row.after.parent).map(row => key(row.after.parent)));
|
|
58
|
+
const prepared = await session.diffInputs.buildFrames({ browser, deferParts: true });
|
|
59
|
+
const eligible = new Set(candidates.map(key));
|
|
60
|
+
const frames = prepared.frames.filter(row => eligible.has(key(row)) && !parents.has(key(row)));
|
|
61
|
+
const context = await browser.newContext({ deviceScaleFactor: 2, locale: 'en-US', timezoneId: 'UTC' });
|
|
62
|
+
const pages = await Promise.all(Array.from({ length: Math.min(4, availableParallelism(), frames.length) }, () => context.newPage()));
|
|
63
|
+
let index = 0;
|
|
64
|
+
await Promise.all(pages.map(async page => {
|
|
65
|
+
async function read(frame) {
|
|
66
|
+
await loadFrame(page, frame, theme);
|
|
67
|
+
await page.evaluate(installFramePrimitives);
|
|
68
|
+
return page.evaluate(observeFrame);
|
|
69
|
+
}
|
|
70
|
+
while (index < frames.length) {
|
|
71
|
+
const row = frames[index++];
|
|
72
|
+
try {
|
|
73
|
+
const before = await read(row.before);
|
|
74
|
+
if (before.uncertain.length) continue;
|
|
75
|
+
const after = await read(row.after);
|
|
76
|
+
if (!after.uncertain.length && JSON.stringify(before) === JSON.stringify(after)) skipped.add(key(row));
|
|
77
|
+
} catch (error) {
|
|
78
|
+
if (!browser.isConnected()) throw error;
|
|
79
|
+
// Unobserved frames remain eligible for pixel comparison.
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
}));
|
|
83
|
+
return skipped;
|
|
84
|
+
} finally {
|
|
85
|
+
await browser.close();
|
|
86
|
+
}
|
|
87
|
+
}
|
|
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
|
+
|
|
133
|
+
/** Generate a standalone, single-theme review without starting a viewer. */
|
|
134
|
+
export async function review(config, values, { log = console.log } = {}) {
|
|
135
|
+
const started = performance.now();
|
|
136
|
+
const format = values.format ?? 'html';
|
|
137
|
+
const htmlLike = format === 'html' || format === 'embed';
|
|
138
|
+
const [theme] = resolveThemes(values.theme ?? 'system');
|
|
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
|
+
}
|
|
147
|
+
const options = { base: values.base, theme, impacted: true, json: true };
|
|
148
|
+
let model, built, skipped, baseConfig;
|
|
149
|
+
const { data, warnings } = await withImpacted(config, [], options, 'diff', async session => {
|
|
150
|
+
const candidates = reviewEdgeCandidates(session, theme);
|
|
151
|
+
skipped = values.exact ? new Set() : await observeUnchanged(session, theme);
|
|
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;
|
|
158
|
+
session.scheduled = (row, theme) => scheduled(row, theme) && !skipped.has(impactRowKey(row, theme));
|
|
159
|
+
let result;
|
|
160
|
+
try {
|
|
161
|
+
result = await diff(config, [], options, { session, reviewFormat: format, onReview: value => { model = value; } });
|
|
162
|
+
} catch (error) {
|
|
163
|
+
if (error.code !== 'DIFF_FAILED' && !error.partialSourceFailures) throw error;
|
|
164
|
+
result = { data: error.data, warnings: error.warnings };
|
|
165
|
+
} finally {
|
|
166
|
+
session.scheduled = scheduled;
|
|
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;
|
|
172
|
+
});
|
|
173
|
+
|
|
174
|
+
const temporary = `${destination}.${randomUUID()}.tmp`;
|
|
175
|
+
await mkdir(path.dirname(destination), { recursive: true });
|
|
176
|
+
let bytes;
|
|
177
|
+
try {
|
|
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));
|
|
190
|
+
await rename(temporary, destination);
|
|
191
|
+
} finally {
|
|
192
|
+
await rm(temporary, { force: true });
|
|
193
|
+
}
|
|
194
|
+
const result = { path: destination, format, base: model.base, current: model.current, theme, counts: model.counts, groups: data.review.groups,
|
|
195
|
+
mode: values.exact ? 'exact' : 'hybrid', structureMatches: skipped.size, pixelComparisons: data.summary.comparisons,
|
|
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
|
+
}
|
|
205
|
+
if (!result.complete) throw new CliError('SOURCE_BUILD_FAILED', 'Review contains source build failures.', { data: result, warnings });
|
|
206
|
+
return { data: result, warnings };
|
|
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
|
+
}
|
package/src/toolkit/runtime.mjs
CHANGED
|
@@ -12,7 +12,7 @@ export function children(value) {
|
|
|
12
12
|
export function attributes(props) {
|
|
13
13
|
return Object.entries(props).filter(([key, value]) => !['children', 'key', '__source'].includes(key) && value != null && value !== false).map(([key, value]) => {
|
|
14
14
|
if (/^on/i.test(key) || key === 'className' || key === 'dangerouslySetInnerHTML') throw Error(`Forbidden attribute ${key}; use static markup and class`);
|
|
15
|
-
if (key === 'style' && typeof value === 'object') value = Object.entries(value).map(([name, v]) => `${name.startsWith('--') ? name : name.replace(/[A-Z]/g, c => '-' + c.toLowerCase())}:${typeof v === 'number' && !/^(opacity|zIndex|fontWeight|lineHeight|flex|flexGrow|flexShrink|order|gridColumn|gridRow|scale)$/.test(name) && !name.startsWith('--') ? v + 'px' : v}`).join(';');
|
|
15
|
+
if (key === 'style' && typeof value === 'object') value = Object.entries(value).filter(([, v]) => v !== undefined && v !== null && v !== false).map(([name, v]) => `${name.startsWith('--') ? name : name.replace(/[A-Z]/g, c => '-' + c.toLowerCase())}:${typeof v === 'number' && !/^(opacity|zIndex|fontWeight|lineHeight|flex|flexGrow|flexShrink|order|gridColumn|gridRow|scale)$/.test(name) && !name.startsWith('--') ? v + 'px' : v}`).join(';');
|
|
16
16
|
return ` ${key}="${escape(value === true ? '' : value)}"`;
|
|
17
17
|
}).join('');
|
|
18
18
|
}
|
|
@@ -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 {
|
|
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) }; }
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { execFileSync } from 'node:child_process';
|
|
2
|
+
import { CliError } from '../cli-output.mjs';
|
|
3
|
+
|
|
4
|
+
export function systemTheme({ platform = process.platform, readAppearance = () => execFileSync('defaults', ['read', '-g', 'AppleInterfaceStyle'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }) } = {}) {
|
|
5
|
+
if (platform !== 'darwin') return 'light';
|
|
6
|
+
try { return readAppearance().trim() === 'Dark' ? 'dark' : 'light'; }
|
|
7
|
+
catch { return 'light'; }
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
export function resolveThemes(option = 'both', readSystemTheme = systemTheme) {
|
|
11
|
+
if (!['both', 'light', 'dark', 'system'].includes(option)) {
|
|
12
|
+
throw new CliError('USAGE_INVALID', 'Choose --theme=both, light, dark, or system.');
|
|
13
|
+
}
|
|
14
|
+
if (option === 'both') return ['light', 'dark'];
|
|
15
|
+
return [option === 'system' ? readSystemTheme() : option];
|
|
16
|
+
}
|
package/src/viewer-cache.mjs
CHANGED
|
@@ -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
|
-
|
|
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,{
|
|
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
|
|
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
|
|
48
|
-
if(
|
|
49
|
-
|
|
50
|
-
|
|
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
|
-
|
|
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
|
|
61
|
-
|
|
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
|
-
|
|
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
|
}
|