@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.
- package/README.md +5 -2
- package/package.json +2 -1
- package/public/app.js +602 -64
- package/public/assets.js +25 -10
- package/public/boards.js +8 -3
- package/public/frame-identity.js +25 -12
- package/public/icons.js +7 -0
- package/public/index.html +14 -2
- 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/style.css +17 -2
- package/public/tokens.css +6 -0
- package/public/view-boards.css +131 -0
- package/public/view-boards.js +350 -0
- package/public/view-route.js +1 -1
- package/src/boards/motion-board.mjs +202 -0
- package/src/boards/token-board.mjs +9 -5
- package/src/cli-output.mjs +3 -1
- package/src/cli.mjs +52 -18
- package/src/http.mjs +5 -2
- 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 +229 -18
- package/src/toolkit/arch-git.mjs +8 -14
- 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 +93 -2
- package/src/toolkit/compare.mjs +13 -11
- package/src/toolkit/config.mjs +2 -2
- package/src/toolkit/diff-inputs.mjs +35 -26
- package/src/toolkit/diff.mjs +24 -11
- 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 +2 -2
- package/src/toolkit/impact.mjs +17 -3
- 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/owner.mjs +19 -6
- package/src/toolkit/play-endpoint.mjs +66 -0
- package/src/toolkit/project-index.mjs +2 -2
- package/src/toolkit/recent-structure.mjs +201 -0
- package/src/toolkit/results.mjs +2 -2
- package/src/toolkit/review-document.mjs +9 -4
- package/src/toolkit/review-embed-document.mjs +671 -0
- package/src/toolkit/review-filmstrip.mjs +76 -0
- package/src/toolkit/review-motion-card.mjs +51 -0
- package/src/toolkit/review-motion.mjs +159 -0
- package/src/toolkit/review-playback.js +123 -0
- package/src/toolkit/review-sheet.mjs +36 -28
- package/src/toolkit/review.mjs +131 -31
- package/src/toolkit/runtime.mjs +7 -1
- package/src/viewer-cache.mjs +48 -12
package/src/toolkit/review.mjs
CHANGED
|
@@ -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
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
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
|
|
99
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
137
|
-
if (
|
|
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
|
+
}
|
package/src/toolkit/runtime.mjs
CHANGED
|
@@ -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) }; }
|
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
|
}
|