@whzxc/agent-design-gallery 0.0.0-stage → 0.6.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 (55) hide show
  1. package/LICENSE +69 -0
  2. package/README.md +216 -2
  3. package/package.json +43 -4
  4. package/public/access.css +10 -0
  5. package/public/app.js +1646 -0
  6. package/public/assets.js +344 -0
  7. package/public/auth.js +69 -0
  8. package/public/favicon.svg +6 -0
  9. package/public/hub.css +67 -0
  10. package/public/hub.html +33 -0
  11. package/public/hub.js +165 -0
  12. package/public/icons.js +50 -0
  13. package/public/index.html +70 -0
  14. package/public/instance-actions.js +27 -0
  15. package/public/labels.js +122 -0
  16. package/public/layout.js +103 -0
  17. package/public/relationships.js +28 -0
  18. package/public/selection.js +20 -0
  19. package/public/style.css +194 -0
  20. package/public/switcher.css +37 -0
  21. package/public/switcher.js +176 -0
  22. package/public/token-catalog.js +129 -0
  23. package/public/tokens.css +61 -0
  24. package/public/view-route.js +66 -0
  25. package/src/cli.mjs +105 -0
  26. package/src/http.mjs +37 -0
  27. package/src/hub/auth.mjs +40 -0
  28. package/src/hub/instances.mjs +99 -0
  29. package/src/hub/proxy.mjs +28 -0
  30. package/src/hub/registry.mjs +147 -0
  31. package/src/hub.mjs +113 -0
  32. package/src/link.mjs +54 -0
  33. package/src/open.mjs +57 -0
  34. package/src/server.mjs +642 -0
  35. package/src/service.mjs +163 -0
  36. package/src/toolkit/arch-browser.mjs +40 -0
  37. package/src/toolkit/arch-git.mjs +54 -0
  38. package/src/toolkit/arch-overlay.mjs +225 -0
  39. package/src/toolkit/arch.mjs +217 -0
  40. package/src/toolkit/asset-rules.mjs +14 -0
  41. package/src/toolkit/browser.mjs +21 -0
  42. package/src/toolkit/build-store.mjs +258 -0
  43. package/src/toolkit/build-worker.mjs +32 -0
  44. package/src/toolkit/build.mjs +133 -0
  45. package/src/toolkit/commands.mjs +273 -0
  46. package/src/toolkit/compare.mjs +175 -0
  47. package/src/toolkit/config.mjs +135 -0
  48. package/src/toolkit/document.mjs +85 -0
  49. package/src/toolkit/migrate.mjs +73 -0
  50. package/src/toolkit/project.mjs +160 -0
  51. package/src/toolkit/runtime.d.ts +14 -0
  52. package/src/toolkit/runtime.mjs +54 -0
  53. package/src/toolkit/text.mjs +12 -0
  54. package/src/toolkit/tokens.mjs +36 -0
  55. package/src/viewer-cache.mjs +85 -0
package/src/server.mjs ADDED
@@ -0,0 +1,642 @@
1
+ // Adapted from ARC's MIT-licensed tooling/design-server.mjs.
2
+ import { randomUUID, createHash } from 'node:crypto';
3
+ import { directLocal, viewerFile, shell, json } from './http.mjs';
4
+ import { createServer } from "node:http";
5
+ import {
6
+ readFile,
7
+ writeFile,
8
+ mkdir,
9
+ readdir,
10
+ stat,
11
+ realpath,
12
+ } from "node:fs/promises";
13
+ import { watch, existsSync } from "node:fs";
14
+ import path from "node:path";
15
+ import os from "node:os";
16
+
17
+ import { createBuildStore } from './toolkit/build-store.mjs';
18
+ import { createViewerCache } from './viewer-cache.mjs';
19
+ import { refreshTypes, archFiles, isSourcePath, readGroups, sourceDirectories } from './toolkit/project.mjs';
20
+ import { loadConfig } from './toolkit/config.mjs';
21
+ import { parseTokens } from './toolkit/tokens.mjs';
22
+ import { sourceRelationships } from '../public/relationships.js';
23
+ import { resolveScope } from '../public/assets.js';
24
+ const digest = value => createHash('sha256').update(value).digest('hex');
25
+ const tokenFile = 'tokens.css';
26
+ function tokenSourcePath(directory, project) {
27
+ const base = project.design === directory ? project.root : path.dirname(directory);
28
+ return path.relative(base, path.join(directory, tokenFile)).split(path.sep).join('/');
29
+ }
30
+ const viewerVersion = Promise.all(['assets.js','layout.js','selection.js'].map(file => readFile(new URL('../public/'+file,import.meta.url)))).then(parts => digest(Buffer.concat(parts)));
31
+ const defaultState = path.join(
32
+ process.env.XDG_STATE_HOME || path.join(os.homedir(), ".local/state"),
33
+ "agent-design-gallery",
34
+ );
35
+ export async function startServer({
36
+ directory,
37
+ port = 0,
38
+ stateDirectory = defaultState,
39
+ fixtures = null,
40
+ readOnly = false,
41
+ instanceId = randomUUID(),
42
+ } = {}) {
43
+ let state = { recent: [], views: {}, selections: {}, theme: "system" };
44
+ const statePath = path.join(stateDirectory, "state.json");
45
+ try {
46
+ state = { ...state, ...JSON.parse(await readFile(statePath, "utf8")) };
47
+ } catch (e) {
48
+ if (e.code !== "ENOENT")
49
+ throw new Error(`Cannot read preferences: ${e.message}`);
50
+ }
51
+ let root,
52
+ tokenSource = null,
53
+ sources = sourceDirectories(),
54
+ files = new Map(),
55
+ groups = [],
56
+ watcher, archWatcher, activeProject,
57
+ refreshTimer,
58
+ revision = 0,
59
+ closing = false,
60
+ buildStore, viewerCache, codePaths=new Set();
61
+ const overlayStores = new Map(), overlayHashes = new Set();
62
+ let resettingOverlays = false;
63
+ const knownBuilds = new Map(), legacyDependencies = new Map(), failedSources=new Set(), dirtyBuilds=new Set();
64
+ const describe=built=>({...built,css:undefined,frames:built.frames.map(({html,...frame})=>frame)});
65
+ const clients = new Set(),
66
+ svgCache = new Map(),
67
+ frameCounts = new Map(),
68
+ touched = new Set();
69
+ let writes = Promise.resolve();
70
+ const persist = () => {
71
+ if (fixtures) return Promise.resolve();
72
+ const data = JSON.stringify(state, null, 2);
73
+ writes = writes
74
+ .catch(() => {})
75
+ .then(async () => {
76
+ await mkdir(stateDirectory, { recursive: true });
77
+ await writeFile(statePath, data);
78
+ });
79
+ return writes;
80
+ };
81
+ const emit = (data) => {
82
+ for (const client of clients)
83
+ client.write(`data: ${JSON.stringify(data)}\n\n`);
84
+ };
85
+ async function closeOverlays() {
86
+ resettingOverlays = true;
87
+ try { await Promise.all([...overlayStores.values()].map(async pending=>(await pending).close())); }
88
+ finally { overlayStores.clear();overlayHashes.clear();resettingOverlays = false; }
89
+ }
90
+ async function overlayStore(base) {
91
+ if(closing || resettingOverlays)throw Object.assign(Error('Overlay build superseded; retry after refresh.'),{name:'AbortError'});
92
+ const key=base.sha+'\0'+base.rev;
93
+ if(!overlayStores.has(key)) {
94
+ const pending=createBuildStore({config:{...activeProject,design:root,sources,sourceFiles:[...codePaths].sort(),overlay:base},
95
+ cacheDirectory:path.join(stateDirectory,'cache',digest(root),'overlay',base.sha,digest(base.rev))}).then(async store=>{
96
+ for(const built of await store.metadata())overlayHashes.add(built.hash);
97
+ return store;
98
+ });
99
+ overlayStores.set(key,pending);
100
+ pending.catch(()=>{if(overlayStores.get(key)===pending)overlayStores.delete(key);});
101
+ }
102
+ return overlayStores.get(key);
103
+ }
104
+ async function invalidateBuilds(paths) {
105
+ const affected=new Set(buildStore?.invalidate(paths)??[]);
106
+ for(const pending of overlayStores.values())for(const name of (await pending).invalidate(paths))affected.add(name);
107
+ return [...affected];
108
+ }
109
+ async function overlayBuild(name,base) {
110
+ const built=await (await overlayStore(base)).get(name);
111
+ overlayHashes.add(built.hash);frameCounts.set(name,built.frames.length);
112
+ return built;
113
+ }
114
+ async function collect(base, relative = "", out = new Map(), sourceNames = sources, discoveredCode = new Set()) {
115
+ for (const entry of await readdir(path.join(base, relative), {
116
+ withFileTypes: true,
117
+ })) {
118
+ if (entry.name.startsWith(".") || entry.name === "node_modules" || (relative === "" && entry.name === "art" && !sourceNames.includes("art"))) continue;
119
+ const name = path.posix.join(relative, entry.name);
120
+ if (entry.isDirectory()) await collect(base, name, out, sourceNames, discoveredCode);
121
+ else if (entry.isFile()) {
122
+ if(/\.[jt]sx?$/.test(name))discoveredCode.add(name);
123
+ if(!(/\.svg$/i.test(name)||isSourcePath(name,sourceNames)))continue;
124
+ const info = await stat(path.join(base, name));
125
+ const version = `${info.mtimeMs}-${info.size}`;
126
+ const old = base === root ? files.get(name) : undefined;
127
+ out.set(
128
+ name,
129
+ old?.stamp === version
130
+ ? old
131
+ : {
132
+ path: name,
133
+ name: path.basename(name, path.extname(name)),
134
+ version,
135
+ stamp: version,
136
+ size: info.size,
137
+ modifiedAt: info.mtimeMs,
138
+ },
139
+ );
140
+ }
141
+ }
142
+ return out;
143
+ }
144
+ async function collectProject(base, project, sourceNames, discoveredCode) {
145
+ const out=await collect(base,'',new Map(),sourceNames,discoveredCode);
146
+ if(project.design !== base) return out;
147
+ for(const file of archFiles(project.arch)) {
148
+ const name=path.relative(project.root,file).split(path.sep).join('/'),info=await stat(file),stamp=`${info.mtimeMs}-${info.size}`;
149
+ const old=files.get(name);
150
+ out.set(name,old?.stamp===stamp?old:{path:name,name:path.basename(name,'.mmd'),layer:'arch',version:stamp,stamp,size:info.size,modifiedAt:info.mtimeMs});
151
+ }
152
+ return out;
153
+ }
154
+ function watchArch(project,base) {
155
+ archWatcher?.close();archWatcher=null;
156
+ const directory=project.archDirectory;
157
+ if(project.design!==base || !directory || !existsSync(directory)) return;
158
+ archWatcher=watch(directory,{recursive:true},(_event,filename)=>{
159
+ if(!filename || !/\.(mmd|md)$/.test(String(filename)))return;
160
+ const file=path.join(directory,String(filename));
161
+ const dependency=path.relative(base,file).split(path.sep).join('/');
162
+ const name=path.relative(project.root,file).split(path.sep).join('/');
163
+ touched.add(dependency);touched.add(name);invalidateBuilds([dependency,name]).catch(e=>emit({error:e.message}));
164
+ clearTimeout(refreshTimer);refreshTimer=setTimeout(()=>refresh().catch(e=>emit({error:e.message})),80);
165
+ });
166
+ archWatcher.on('error',e=>emit({error:`Architecture watcher: ${e.message}`}));
167
+ }
168
+ async function openDirectory(input) {
169
+ let next;
170
+ try { next = await realpath(path.resolve(input.replace(/^~(?=$|[\\/])/, os.homedir()))); }
171
+ catch (error) {
172
+ if (error.code === 'ENOENT' || error.code === 'ENOTDIR') throw new Error(`Directory not found: ${input}; choose an existing directory.`);
173
+ throw error;
174
+ }
175
+ if (!(await stat(next)).isDirectory())
176
+ throw new Error("Choose a directory containing SVG files.");
177
+ const hasTokens = (await readdir(next)).includes(tokenFile);
178
+ if (hasTokens && !readOnly) refreshTypes({design:next});
179
+ const project = await loadConfig(next);
180
+ const nextSources = project.design === next ? project.sources : sourceDirectories({design:next});
181
+ const nextCode=new Set(), nextFiles = await collectProject(next, project, nextSources, nextCode),
182
+ nextGroups = await readGroups(next, nextSources);
183
+
184
+ const cacheBase=path.join(stateDirectory,'cache',digest(next));
185
+ const nextStore=await createBuildStore({config:{...project,design:next,sources:nextSources,sourceFiles:[...nextCode].sort()},cacheDirectory:path.join(cacheBase,'build')});
186
+ const nextViewerCache=await createViewerCache(path.join(cacheBase,'viewer'));
187
+ await buildStore?.close();await closeOverlays();await viewerCache?.close();
188
+ buildStore=nextStore;viewerCache=nextViewerCache;knownBuilds.clear();dirtyBuilds.clear();failedSources.clear();frameCounts.clear();
189
+ for(const built of await buildStore.metadata()) {
190
+ if(nextFiles.has(built.path)) {knownBuilds.set(built.path,built);Object.assign(nextFiles.get(built.path),{hash:built.hash,version:built.hash});frameCounts.set(built.path,built.frames.length);}
191
+ }
192
+ // Complete discovery before starting the watcher.
193
+ const nextWatcher = watch(next, { recursive: true }, (_event, filename) => {
194
+ if (filename && String(filename).split(path.sep).some(part => part.startsWith("."))) return;
195
+ if (filename) {
196
+ const name=String(filename).split(path.sep).join('/');
197
+ touched.add(name);
198
+ invalidateBuilds([name]).catch(e=>emit({error:e.message}));
199
+ }
200
+ clearTimeout(refreshTimer);
201
+ refreshTimer = setTimeout(
202
+ () => refresh().catch((e) => emit({ error: e.message })),
203
+ 80,
204
+ );
205
+ });
206
+ nextWatcher.on("error", (e) =>
207
+ emit({ error: `File watcher: ${e.message}` }),
208
+ );
209
+ watcher?.close();
210
+ watcher = nextWatcher;
211
+ activeProject=project;watchArch(project,next);
212
+ root = next;
213
+ tokenSource = hasTokens ? tokenSourcePath(next, project) : null;
214
+ codePaths=nextCode;
215
+ sources = nextSources;
216
+ touched.clear();
217
+ files = nextFiles;
218
+ groups = nextGroups;
219
+ revision++;
220
+ svgCache.clear();
221
+ state.recent = [root, ...state.recent.filter((p) => p !== root)].slice(
222
+ 0,
223
+ 12,
224
+ );
225
+ await persist();
226
+ emit({ revision });
227
+ }
228
+ let refreshing = false,
229
+ refreshAgain = false;
230
+ async function refresh() {
231
+ if(closing)return;
232
+ if (refreshing) {
233
+ refreshAgain = true;
234
+ return;
235
+ }
236
+ refreshing = true;
237
+ try {
238
+ const observed = [...touched];
239
+ touched.clear();
240
+ const base = root,
241
+ project = await loadConfig(base),
242
+ nextSources = project.design===base ? project.sources : sourceDirectories({design:base}),
243
+ nextCode=new Set(),
244
+ next = await collectProject(base,project,nextSources,nextCode),
245
+ nextGroups = await readGroups(base, nextSources);
246
+ const tokensChanged = observed.includes(tokenFile);
247
+ const hasTokens = tokensChanged ? (await readdir(base)).includes(tokenFile) : !!tokenSource;
248
+ const nextTokenSource = hasTokens ? tokenSourcePath(base, project) : null;
249
+ if (root !== base) return;
250
+ const stamps=[...new Set([...files.keys(),...next.keys()])].filter(name=>files.get(name)?.stamp!==next.get(name)?.stamp);
251
+ const grouping=JSON.stringify(groups)!==JSON.stringify(nextGroups);
252
+ const configChanged=JSON.stringify(sources)!==JSON.stringify(nextSources)||activeProject.arch!==project.arch;
253
+ const structural=configChanged || [...new Set([...codePaths,...nextCode])].some(name=>codePaths.has(name)!==nextCode.has(name));
254
+ if(structural){await closeOverlays();await buildStore.close();buildStore=await createBuildStore({config:{...project,design:base,sources:nextSources,sourceFiles:[...nextCode].sort()},cacheDirectory:path.join(stateDirectory,'cache',digest(base),'build')});}
255
+ const observedPaths=[...new Set([...observed,...stamps])];
256
+ const affected=new Set(await invalidateBuilds(structural?[...knownBuilds.keys(),...observedPaths]:observedPaths));
257
+ for(const name of failedSources)affected.add(name);
258
+ for(const name of stamps)if(/\.(tsx|mmd)$/.test(name)&&next.has(name))affected.add(name);
259
+ const legacyDirty=[...legacyDependencies.values()].some(dependencies=>dependencies.some(name=>observedPaths.includes(name)));
260
+ if(!stamps.length&&!affected.size&&!grouping&&!legacyDirty&&!configChanged&&!tokensChanged&&nextTokenSource===tokenSource)return;
261
+ const changed=[...new Set([...stamps,...affected])];
262
+ for (const name of affected) {
263
+ if (knownBuilds.delete(name)) dirtyBuilds.add(name);
264
+ frameCounts.delete(name);
265
+ if (!next.has(name)) { dirtyBuilds.delete(name); failedSources.delete(name); continue; }
266
+ if (!/\.(tsx|mmd)$/.test(name)) continue;
267
+ const entry = next.get(name);
268
+ next.set(name, {...entry, hash:undefined, version:`${entry.stamp}-${revision+1}`});
269
+ }
270
+ for (const [name,entry] of next) {
271
+ const built = knownBuilds.get(name);
272
+ if (built) Object.assign(entry,{hash:built.hash,version:built.hash});
273
+ }
274
+ const dirty=new Set(observedPaths);
275
+ for(const [name,dependencies] of legacyDependencies) {
276
+ if(!next.has(name)){legacyDependencies.delete(name);continue;}
277
+ if(dependencies.some(dependency=>dirty.has(dependency))) {
278
+ for(const theme of ['light','dark'])svgCache.delete(`${name}\0${theme}`);
279
+ next.set(name,{...next.get(name),version:`${next.get(name).stamp}-${revision+1}`});changed.push(name);
280
+ }
281
+ }
282
+ if(activeProject.arch!==project.arch)watchArch(project,base);
283
+ activeProject=project;
284
+ files = next;
285
+ tokenSource = nextTokenSource;
286
+ codePaths=nextCode;
287
+ sources = nextSources;
288
+ groups = nextGroups;
289
+ revision++;
290
+ emit({ revision, changed });
291
+ } finally {
292
+ refreshing = false;
293
+ if (refreshAgain && !closing) {
294
+ refreshAgain = false;
295
+ await refresh();
296
+ }
297
+ }
298
+ }
299
+ const baseManifest = () => ({
300
+ directory: root ?? null,
301
+ label: root
302
+ ? path.basename(root) === "design" ? path.basename(path.dirname(root)) : path.basename(root)
303
+ : "Agent Design Gallery",
304
+ assets: [...files.values()].sort((a, b) => a.path.localeCompare(b.path)),
305
+ groups,
306
+ revision,
307
+ recent: state.recent,
308
+ theme: state.theme,
309
+ sidebar: state.sidebar ?? true,
310
+ inspector: false,
311
+ tokenSource,
312
+ });
313
+ const preferenceKey = (scope,base) => base ? JSON.stringify([root,scope??'all','base',base]) : !scope || scope === 'all' ? root : JSON.stringify([root, scope]);
314
+ function applyFixtureManifest(data,name) {
315
+ if (!fixtures || !name) return data;
316
+ if (Number.isFinite(fixtures.assetModifiedAt)) data.assets = data.assets.map(a => ({...a,modifiedAt:fixtures.assetModifiedAt}));
317
+ const preset = fixtures.states[name];
318
+ if (!preset) throw new Error(`Unknown fixture ${name}; choose a declared ADG fixture.`);
319
+ return { ...data, ...(preset.empty ? { directory: null, assets: [], groups: [] } : {}),
320
+ label: 'agent-remote-control', recent: fixtures.recent, view: null, theme: preset.themeChoice ?? preset.theme,
321
+ sidebar: preset.sidebar, inspector: !!preset.inspector, fixture: { name, ...preset } };
322
+ }
323
+ const contextFor=async url=>(await viewerVersion)+'|'+(url.searchParams.get('context')??'')+(url.searchParams.has('base')?'|base:'+url.searchParams.get('base'):'');
324
+ async function manifest(url) {
325
+ const data=baseManifest(),context=await contextFor(url), requested=url.searchParams.get('scope');
326
+ const fixtureScope=fixtures?.states[url.searchParams.get('fixture')]?.scope;
327
+ const desired = fixtureScope ?? requested ?? 'all';
328
+ if (desired === 'tokens' && data.tokenSource) {
329
+ // Keep the layer choices available without measuring or building any artboards.
330
+ const { layers } = resolveScope(data, sources, 'all');
331
+ const result = { ...data, scope: 'tokens', layers, assets: [] };
332
+ try {
333
+ const { light, dark } = parseTokens(await readFile(path.join(data.directory, tokenFile), 'utf8'));
334
+ result.tokens = [...light].map(([name, value]) => [name, value, dark.get(name) ?? null]);
335
+ } catch (error) {
336
+ result.tokenError = error.code ? `Cannot read ${data.tokenSource}.` : error.message;
337
+ }
338
+ return applyFixtureManifest(result, url.searchParams.get('fixture'));
339
+ }
340
+ const scoped=resolveScope(data,sources,desired === 'tokens' ? 'default' : desired);
341
+ if (url.searchParams.has('strict') && desired !== scoped.scope) throw Error('Design link target does not exist.');
342
+ Object.assign(data,scoped);
343
+ let base;
344
+ if(url.searchParams.has('base')&&data.assets.some(asset=>asset.path.endsWith('.mmd'))) {
345
+ base=await (await import('./toolkit/arch-git.mjs')).resolveBase(activeProject,url.searchParams.get('base'));
346
+ data.base={rev:base.rev,sha:base.sha};
347
+ const cached=new Map((await (await overlayStore(base)).metadata()).map(built=>[built.path,built]));
348
+ data.assets=data.assets.map(asset=>asset.path.endsWith('.mmd')?{...asset,hash:cached.get(asset.path)?.hash,version:cached.get(asset.path)?.hash??`${asset.stamp}-${base.sha}-${base.rev}`}:{...asset});
349
+ }
350
+ const key=preferenceKey(data.scope,url.searchParams.get('base'));
351
+ data.view=state.views[key] ?? null;
352
+ data.selection=state.selections[key] ?? null;
353
+ // Rehash previously built sources only when a viewer requests their scope.
354
+ // An unchanged result retains its measured metadata and cropped previews.
355
+ if (requested) {
356
+ const rebuild = data.assets.filter(asset=>dirtyBuilds.has(asset.path)&&!(base&&asset.path.endsWith('.mmd')));
357
+ let index=0;
358
+ await Promise.all(Array.from({length:Math.min(2,rebuild.length)},async()=>{
359
+ while(index<rebuild.length) {
360
+ const asset=rebuild[index++];
361
+ try {const built=await sourceBuild(asset.path);Object.assign(asset,{hash:built.hash,version:built.hash});}
362
+ catch(error) {if(error.name==='AbortError')throw error;dirtyBuilds.delete(asset.path);}
363
+ }
364
+ }));
365
+ }
366
+ data.sourceImports=Object.fromEntries([...knownBuilds].map(([name,built])=>[name,built.imports]));
367
+ const frameOnly = data.scope.startsWith('asset:') && url.searchParams.has('frame');
368
+ if(viewerCache && !frameOnly) {
369
+ const includeMetadata=url.searchParams.get('metadata')==='1';
370
+ const requestedTheme=url.searchParams.get('initial')==='1'&&['light','dark'].includes(state.theme)?state.theme:(url.searchParams.get('theme')==='light'?'light':'dark');
371
+ data.metadataTheme=requestedTheme;
372
+ data.assets=await Promise.all(data.assets.map(async asset=>{
373
+ if(!asset.hash)return {...asset};
374
+ const metadata={},metadataRefs={},previewIds={};
375
+ for(const theme of ['light','dark']) {
376
+ const reference=viewerCache.reference(asset.hash,theme,context);
377
+ if(reference){metadataRefs[theme]=true;previewIds[theme]=reference.previewIds;}
378
+ if(includeMetadata&&theme===requestedTheme&&reference){const saved=await viewerCache.get(asset.hash,theme,context);if(saved)metadata[theme]=saved.metadata;}
379
+ }
380
+ return {...asset,metadata,metadataRefs,previewIds};
381
+ }));
382
+ data.packing=(await viewerCache.get(digest('catalog'),'light',context))?.metadata.packing??[];
383
+ }
384
+ data.features={compactSources:1,persistedMetadata:1,incrementalHashes:1};
385
+ return applyFixtureManifest(data,url.searchParams.get('fixture'));
386
+ }
387
+ async function sourceBuild(name) {
388
+ let built;
389
+ try{built=await buildStore.get(name);}catch(error){if(error.name!=='AbortError')failedSources.add(name);throw error;}
390
+ knownBuilds.set(name,describe(built));dirtyBuilds.delete(name);failedSources.delete(name);frameCounts.set(name,built.frames.length);
391
+ if(files.has(name))Object.assign(files.get(name),{hash:built.hash,version:built.hash});
392
+ return built;
393
+ }
394
+ async function svg(name, theme, chain = [], onlyFrame = null, base = null) {
395
+ if (chain.includes(name))
396
+ throw new Error(`Circular SVG reference: ${name}`);
397
+ const asset = files.get(name);
398
+ if (!asset) throw new Error(`Unknown SVG: ${name}`);
399
+ const key = `${name}\0${theme}`,
400
+ cached = svgCache.get(key);
401
+ if (cached?.version === asset.version) return cached;
402
+ if (/\.(tsx|mmd)$/.test(name)) {
403
+ const built=base&&name.endsWith('.mmd')?await overlayBuild(name,base):await sourceBuild(name);
404
+ const frames = onlyFrame ? built.frames.filter(frame => frame.name === onlyFrame) : built.frames;
405
+ if (!frames.length && onlyFrame) throw Error(`Frame ${onlyFrame} does not exist in ${name}.`);
406
+ return {version:built.hash,imports:built.imports,dependencies:built.dependencies,
407
+ body:JSON.stringify({format:'tsx',hash:built.hash,css:built.css,imports:built.imports,component:!onlyFrame && name.endsWith('.tsx') && !name.startsWith('surfaces/'),frames})};
408
+ }
409
+ let content = await readFile(path.join(root, name), "utf8");
410
+ content = content.replace(
411
+ /<svg\b([^>]*)>/,
412
+ (_, attrs) =>
413
+ `<svg${attrs.replace(/\sdata-theme\s*=\s*(['"]).*?\1/g, "")} data-theme="${theme}">`,
414
+ );
415
+ const dependencies = [name];
416
+ const matches = [
417
+ ...content.matchAll(/\b(?:xlink:)?href\s*=\s*(["'])([^"']+)\1/g),
418
+ ];
419
+ for (const match of matches) {
420
+ const target = match[2];
421
+ if (/^(?:#|data:|https?:|\/)/.test(target)) continue;
422
+ const [relative, fragment] = target.split("#");
423
+ const dependency = path.posix.normalize(
424
+ path.posix.join(path.posix.dirname(name), decodeURIComponent(relative)),
425
+ );
426
+ if (dependency.startsWith("../"))
427
+ throw new Error(`SVG reference leaves design directory: ${target}`);
428
+ let data, type;
429
+ if (/\.svg$/i.test(dependency)) {
430
+ const nested = await svg(dependency, theme, [...chain, name]);
431
+ data = nested.body;
432
+ type = "image/svg+xml";
433
+ dependencies.push(...nested.dependencies);
434
+ } else {
435
+ const resolved = await realpath(path.join(root, dependency));
436
+ if (!resolved.startsWith(root + path.sep))
437
+ throw new Error("Asset reference leaves design directory.");
438
+ data = await readFile(resolved);
439
+ dependencies.push(dependency);
440
+ type = {
441
+ ".png": "image/png",
442
+ ".jpg": "image/jpeg",
443
+ ".jpeg": "image/jpeg",
444
+ ".webp": "image/webp",
445
+ }[path.extname(dependency).toLowerCase()];
446
+ if (!type) continue;
447
+ }
448
+ content = content.replace(
449
+ match[0],
450
+ `href="data:${type};base64,${Buffer.from(data).toString("base64")}${fragment ? "#" + fragment : ""}"`,
451
+ );
452
+ }
453
+ const entry = {
454
+ version: asset.version,
455
+ body: Buffer.from(content),
456
+ dependencies: [...new Set(dependencies)],
457
+ };
458
+ legacyDependencies.set(name,entry.dependencies);
459
+ svgCache.delete(key);svgCache.set(key,entry);
460
+ let bytes=[...svgCache.values()].reduce((n,item)=>n+item.body.length,0);
461
+ while(svgCache.size>128||bytes>32*1024*1024){const first=svgCache.keys().next().value;bytes-=svgCache.get(first).body.length;svgCache.delete(first);}
462
+ return entry;
463
+ }
464
+ async function body(request,limit=16384,raw=false) {
465
+ const chunks=[];let size=0;
466
+ for await(const chunk of request){size+=chunk.length;if(size>limit)throw Error('Request too large.');chunks.push(chunk);}
467
+ const text=Buffer.concat(chunks).toString('utf8');
468
+ return raw?text:JSON.parse(text||'{}');
469
+ }
470
+ const server = createServer(async (request, response) => {
471
+ try {
472
+ const host = request.headers.host;
473
+ const url = new URL(request.url, 'http://localhost');
474
+ const file = ['GET', 'HEAD'].includes(request.method) && viewerFile(url.pathname);
475
+ if (file) return await shell(request, response, file, request.headers['x-adg-viewer-base']);
476
+ if (!directLocal(request)) return json(response, 401, { error: 'Unauthorized' });
477
+ if(url.pathname==='/api/cache-stats'&&request.method==='GET')return json(response,200,{process:process.memoryUsage(),builds:buildStore?.stats(),viewer:viewerCache?.stats()});
478
+ if (url.pathname === '/api/health' && request.method === 'GET') return json(response, 200, { id: instanceId, capabilities: { keyAuth: 1 } });
479
+ if (request.method === "POST") {
480
+ if (
481
+ request.headers.origin &&
482
+ request.headers.origin !== `http://${host}` && request.headers.origin !== `https://${host}`
483
+ ) {
484
+ response.writeHead(403);
485
+ response.end("Cross-origin request refused.");
486
+ return;
487
+ }
488
+ const cacheRoute=url.pathname.match(/^\/(metadata|preview)\/([a-f0-9]{64})$/);
489
+ if(cacheRoute) {
490
+ const [,kind,hash]=cacheRoute,theme=url.searchParams.get('theme')==='dark'?'dark':'light',context=await contextFor(url);
491
+ if(![...knownBuilds.values()].some(built=>built.hash===hash)&&!overlayHashes.has(hash))return json(response,409,{error:'Source changed; reload its metadata.'});
492
+ if(kind==='metadata') {
493
+ const data=await body(request,32*1024*1024),metadata=data.metadata;
494
+ if(!metadata||!Array.isArray(metadata.parts)||!metadata.full||!Number.isFinite(metadata.full.width)||!Number.isFinite(metadata.full.height))throw Error('Invalid measured source metadata.');
495
+ await viewerCache.save(hash,theme,context,metadata);
496
+ } else {
497
+ const source=await body(request,32*1024*1024,true),crop=url.searchParams.get('crop')??'overview';
498
+ if(!/^\s*<svg\b/.test(source))throw Error('Expected an SVG preview.');
499
+ await viewerCache.savePreview(hash,theme,context,crop,source);
500
+ }
501
+ return json(response,200,{ok:true});
502
+ }
503
+ if(url.pathname==='/catalog') {
504
+ const data=await body(request,1024*1024),context=await contextFor(url);
505
+ if(!Array.isArray(data.packing)||data.packing.length>32)throw Error('Invalid packing cache.');
506
+ await viewerCache.save(digest('catalog'),'light',context,{packing:data.packing});
507
+ return json(response,200,{ok:true});
508
+ }
509
+ const data = await body(request);
510
+ if (url.pathname === "/preferences") {
511
+ if (typeof data.sidebar === "boolean") state.sidebar = data.sidebar;
512
+ const key = preferenceKey(data.scope,url.searchParams.get('base'));
513
+ if (["system", "light", "dark"].includes(data.theme))
514
+ state.theme = data.theme;
515
+ if (
516
+ root &&
517
+ data.view &&
518
+ ["x", "y", "scale"].every((k) => Number.isFinite(data.view[k])) &&
519
+ data.view.scale > 0
520
+ )
521
+ state.views[key] = data.view;
522
+ if (root && data.selection &&
523
+ (data.selection.path === null || files.has(data.selection.path))) {
524
+ state.selections[key] = {
525
+ path: data.selection.path,
526
+ form: typeof data.selection.form === 'string' ? data.selection.form : null,
527
+ group: typeof data.selection.group === 'string' ? data.selection.group : null,
528
+ element: data.selection.element ?? null,
529
+ };
530
+ }
531
+ await persist();
532
+ } else {
533
+ response.writeHead(404);
534
+ response.end();
535
+ return;
536
+ }
537
+ return json(response, 200, { ok: true });
538
+ }
539
+ if (!["GET", "HEAD"].includes(request.method)) {
540
+ response.writeHead(405);
541
+ response.end();
542
+ return;
543
+ }
544
+ if (url.pathname === "/events") {
545
+ response.writeHead(200, {
546
+ "Content-Type": "text/event-stream",
547
+ "Cache-Control": "no-store",
548
+ });
549
+ response.write(`data: ${JSON.stringify({ revision })}\n\n`);
550
+ clients.add(response);
551
+ response.on("close", () => clients.delete(response));
552
+ return;
553
+ }
554
+ const metadataRoute=url.pathname.match(/^\/metadata\/([a-f0-9]{64})$/);
555
+ if(metadataRoute){const saved=await viewerCache?.get(metadataRoute[1],url.searchParams.get('theme')==='dark'?'dark':'light',await contextFor(url));return json(response,saved?200:404,saved??{error:'Source metadata is not cached.'});}
556
+ const previewRoute=url.pathname.match(/^\/preview\/([a-f0-9]{64})$/);
557
+ if(previewRoute) {
558
+ const content=await viewerCache?.preview(previewRoute[1],url.searchParams.get('theme')==='dark'?'dark':'light',await contextFor(url),url.searchParams.get('crop')??'overview');
559
+ if(!content){response.writeHead(404);response.end('Preview is not cached.');return;}
560
+ response.writeHead(200,{'Content-Type':'image/svg+xml','Cache-Control':'private, max-age=31536000, immutable','X-Content-Type-Options':'nosniff'});
561
+ response.end(request.method==='HEAD'?undefined:content);return;
562
+ }
563
+ let content, type, etag;
564
+ if (url.pathname === "/manifest") {
565
+ content = JSON.stringify(await manifest(url));
566
+ type = "application/json";
567
+ } else if (url.pathname === "/relationships") {
568
+ const assets = await Promise.all([...files.keys()].filter(name => /\.(tsx|mmd)$/.test(name)).map(async name => ({path:name, imports:(await sourceBuild(name)).imports})));
569
+ content = JSON.stringify(sourceRelationships(assets));
570
+ type = "application/json";
571
+ } else if (url.pathname.startsWith("/asset/")) {
572
+ const name = decodeURIComponent(url.pathname.slice(7));
573
+ if (!files.has(name)) {
574
+ response.writeHead(404);
575
+ response.end("Unknown SVG.");
576
+ return;
577
+ }
578
+ const theme =
579
+ url.searchParams.get("theme") === "dark" ? "dark" : "light";
580
+ const base=name.endsWith('.mmd')&&url.searchParams.has('base')?await (await import('./toolkit/arch-git.mjs')).resolveBase(activeProject,url.searchParams.get('base')):null;
581
+ const onlyFrame = url.searchParams.get('frame');
582
+ const variant = onlyFrame ? `-${digest(onlyFrame)}` : '';
583
+ etag = `"${files.get(name).version}-${theme}${variant}"`;
584
+ if (!base && request.headers["if-none-match"] === etag) {
585
+ response.writeHead(304);
586
+ response.end();
587
+ return;
588
+ }
589
+ const rendered=await svg(name,theme,[],onlyFrame,base);
590
+ content=rendered.body;etag=`"${rendered.version}-${theme}${variant}"`;
591
+ type = /\.(tsx|mmd)$/.test(name) ? "application/json" : "image/svg+xml";
592
+ } else {
593
+ response.writeHead(404); response.end('Not found.'); return;
594
+ }
595
+ response.writeHead(200, {
596
+ "Content-Type": `${type}; charset=utf-8`,
597
+ "Cache-Control": "no-cache",
598
+ "X-Content-Type-Options": "nosniff",
599
+ ...(etag ? { ETag: etag } : {}),
600
+ });
601
+ response.end(request.method === "HEAD" ? undefined : content);
602
+ } catch (error) {
603
+ response.writeHead(error.name==='AbortError'?409:400, { "Content-Type": "application/json" });
604
+ response.end(JSON.stringify({ error: error.message }));
605
+ }
606
+ });
607
+ if (directory) {
608
+ try {
609
+ await openDirectory(directory);
610
+ } catch (error) {
611
+ watcher?.close();archWatcher?.close();
612
+ throw error;
613
+ }
614
+ }
615
+ try {
616
+ await new Promise((resolve, reject) => {
617
+ server.once("error", reject);
618
+ server.listen(port, "127.0.0.1", resolve);
619
+ });
620
+ } catch (error) {
621
+ watcher?.close();archWatcher?.close();
622
+ throw error;
623
+ }
624
+ const close = async () => {
625
+ if (closing) return;
626
+ closing = true;
627
+ clearTimeout(refreshTimer);
628
+ watcher?.close();archWatcher?.close();
629
+ for (const c of clients) c.end();
630
+ const disconnected = new Promise(resolve => server.close(resolve));
631
+ server.closeAllConnections();
632
+ await disconnected;
633
+ await writes;
634
+ await buildStore?.close();await closeOverlays();await viewerCache?.close();
635
+ };
636
+ return { id: instanceId, directory: root, url: `http://127.0.0.1:${server.address().port}/`, port: server.address().port, close,
637
+ cacheStats:()=>({builds:buildStore?.stats(),viewer:viewerCache?.stats()}),
638
+ stats: () => {
639
+ const entries = [...files.keys()].filter(name => /\.(tsx|mmd)$/.test(name));
640
+ return { sourceCount: entries.length, frameCount: entries.every(name => frameCounts.has(name)) ? entries.reduce((n, name) => n + frameCounts.get(name), 0) : null };
641
+ } };
642
+ }