@diagc/cli 0.14.1 → 0.14.2

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.
@@ -4,7 +4,7 @@
4
4
  <meta charset="UTF-8" />
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
6
  <title>diagc studio</title>
7
- <script type="module" crossorigin src="/assets/index-BTb7M_Is.js"></script>
7
+ <script type="module" crossorigin src="/assets/index-25FdgG62.js"></script>
8
8
  <link rel="stylesheet" crossorigin href="/assets/index-Csx5rLJC.css">
9
9
  </head>
10
10
  <body>
@@ -79,7 +79,10 @@ function refusal(req, route) {
79
79
  if (host !== undefined) {
80
80
  const name = hostnameOf(host);
81
81
  if (name !== 'localhost' && !name.endsWith('.localhost') && isIP(name) === 0) {
82
- return { status: 403, message: `Refused: '${name}' is not a local address. Open the studio by localhost or by IP address.` };
82
+ return {
83
+ status: 403,
84
+ message: `Refused: '${name}' is not a local address. Open the studio by localhost or by IP address.`,
85
+ };
83
86
  }
84
87
  }
85
88
  const origin = req.headers.origin;
@@ -95,7 +98,10 @@ function refusal(req, route) {
95
98
  return { status: 403, message: 'Refused: the request comes from another origin.' };
96
99
  }
97
100
  }
98
- if (route.bodyMode === 'json' && !String(req.headers['content-type'] ?? '').toLowerCase().startsWith('application/json')) {
101
+ if (route.bodyMode === 'json' &&
102
+ !String(req.headers['content-type'] ?? '')
103
+ .toLowerCase()
104
+ .startsWith('application/json')) {
99
105
  return { status: 415, message: 'This route takes application/json.' };
100
106
  }
101
107
  return null;
@@ -1,7 +1,7 @@
1
1
  import { access, mkdir, readFile, readdir, rename, unlink } from 'node:fs/promises';
2
2
  import { createHash } from 'node:crypto';
3
3
  import path from 'node:path';
4
- import { IMAGE_REF, composeIncludes, errMessage, isDrawings, isLayoutOverlay, validate } from '@diagc/core';
4
+ import { IMAGE_REF, composeIncludes, errMessage, isDrawings, isLayoutOverlay, validate, } from '@diagc/core';
5
5
  import { writeFileAtomic } from '../atomic-write.js';
6
6
  import { EjectError, ejectDiagram } from '../eject.js';
7
7
  import { resolveInclude } from '../includes.js';
@@ -67,8 +67,8 @@ export async function listDiagramModels(diagramsDir, artifactsDir) {
67
67
  if (editable && hasIncludes(model)) {
68
68
  try {
69
69
  const { model: composed, warnings } = await composeIncludes(model, path.resolve(file), lockedResolver(diagramsDir));
70
- // compileFile refuses an invalid composed result outright (CLAUDE.md:
71
- // "the renderer may assume the model is sound") — an id collision
70
+ // compileFile refuses an invalid composed result outright, because the
71
+ // renderer assumes a validated model — an id collision
72
72
  // between an umbrella-declared node and a namespaced include can pass
73
73
  // composeIncludes (which only grafts) while still being invalid, so
74
74
  // this must be checked here too, not just on compile.
@@ -355,7 +355,10 @@ export async function saveLibrary(diagramsDir, payload) {
355
355
  return { status: 400, body: { issues: [{ message: 'Entry needs string id, name, category' }] } };
356
356
  }
357
357
  if (!catIds.has(entry.category)) {
358
- return { status: 400, body: { issues: [{ message: `Entry '${entry.id}' references unknown category '${entry.category}'` }] } };
358
+ return {
359
+ status: 400,
360
+ body: { issues: [{ message: `Entry '${entry.id}' references unknown category '${entry.category}'` }] },
361
+ };
359
362
  }
360
363
  if (entryIds.has(entry.id))
361
364
  return { status: 400, body: { issues: [{ message: `Duplicate entry '${entry.id}'` }] } };
@@ -365,9 +368,16 @@ export async function saveLibrary(diagramsDir, payload) {
365
368
  return { status: 400, body: { issues: [{ message: `Entry '${entry.id}' missing template` }] } };
366
369
  }
367
370
  for (const [k, v] of Object.entries(t)) {
368
- const ok = TEMPLATE_STRING_KEYS.has(k) ? typeof v === 'string' : TEMPLATE_NUMBER_KEYS.has(k) ? typeof v === 'number' : false;
371
+ const ok = TEMPLATE_STRING_KEYS.has(k)
372
+ ? typeof v === 'string'
373
+ : TEMPLATE_NUMBER_KEYS.has(k)
374
+ ? typeof v === 'number'
375
+ : false;
369
376
  if (!ok)
370
- return { status: 400, body: { issues: [{ message: `Entry '${entry.id}' has invalid template field '${k}'` }] } };
377
+ return {
378
+ status: 400,
379
+ body: { issues: [{ message: `Entry '${entry.id}' has invalid template field '${k}'` }] },
380
+ };
371
381
  }
372
382
  }
373
383
  const target = path.join(diagramsDir, 'library.json');
@@ -393,7 +403,10 @@ export async function saveAsset(diagramsDir, contentType, bytes) {
393
403
  return { status: 400, body: { issues: [{ message: `Unsupported image type '${contentType}'` }] } };
394
404
  }
395
405
  if (bytes.length === 0 || bytes.length > MAX_ASSET_BYTES) {
396
- return { status: 400, body: { issues: [{ message: `Image must be 1 byte to ${MAX_ASSET_BYTES / 1024 / 1024} MB` }] } };
406
+ return {
407
+ status: 400,
408
+ body: { issues: [{ message: `Image must be 1 byte to ${MAX_ASSET_BYTES / 1024 / 1024} MB` }] },
409
+ };
397
410
  }
398
411
  const name = `${createHash('sha256').update(bytes).digest('hex').slice(0, 12)}.${ext}`;
399
412
  const target = path.join(diagramsDir, 'assets', name);
@@ -412,7 +425,12 @@ export async function readAsset(diagramsDir, name) {
412
425
  try {
413
426
  const bytes = await readFile(path.join(diagramsDir, 'assets', name));
414
427
  const ext = name.split('.').at(-1) ?? '';
415
- return { status: 200, body: null, bytes, contentType: ASSET_TYPE[ext === 'jpeg' ? 'jpg' : ext] ?? 'application/octet-stream' };
428
+ return {
429
+ status: 200,
430
+ body: null,
431
+ bytes,
432
+ contentType: ASSET_TYPE[ext === 'jpeg' ? 'jpg' : ext] ?? 'application/octet-stream',
433
+ };
416
434
  }
417
435
  catch {
418
436
  return { status: 404, body: { issues: [{ message: `No asset '${name}'` }] } };
@@ -2,31 +2,70 @@
2
2
  // IS the dispatch order (the rename entry must precede the generic save entry).
3
3
  export const ROUTES = [
4
4
  // --- assets: raw body in, raw bytes out ---
5
- { method: 'POST', pattern: /^\/api\/assets$/, bodyMode: 'raw', handler: (h, c) => h.saveAsset(c.diagramsDir, c.contentType ?? '', c.body) },
6
- { method: 'GET', pattern: /^\/api\/assets\/([^/]+)$/, handler: (h, c) => h.readAsset(c.diagramsDir, decodeURIComponent(c.match[1] ?? '')) },
5
+ {
6
+ method: 'POST',
7
+ pattern: /^\/api\/assets$/,
8
+ bodyMode: 'raw',
9
+ handler: (h, c) => h.saveAsset(c.diagramsDir, c.contentType ?? '', c.body),
10
+ },
11
+ {
12
+ method: 'GET',
13
+ pattern: /^\/api\/assets\/([^/]+)$/,
14
+ handler: (h, c) => h.readAsset(c.diagramsDir, decodeURIComponent(c.match[1] ?? '')),
15
+ },
7
16
  // --- library ---
8
17
  { method: 'GET', pattern: /^\/api\/library$/, handler: (h, c) => h.readLibrary(c.diagramsDir) },
9
- { method: 'PUT', pattern: /^\/api\/library$/, bodyMode: 'json', handler: (h, c) => h.saveLibrary(c.diagramsDir, c.body) },
18
+ {
19
+ method: 'PUT',
20
+ pattern: /^\/api\/library$/,
21
+ bodyMode: 'json',
22
+ handler: (h, c) => h.saveLibrary(c.diagramsDir, c.body),
23
+ },
10
24
  // --- diagrams & layouts ---
11
- { method: 'GET', pattern: /^\/api\/diagrams$/, handler: (h, c) => h.listDiagramModels(c.diagramsDir, c.artifactsDir) },
25
+ {
26
+ method: 'GET',
27
+ pattern: /^\/api\/diagrams$/,
28
+ handler: (h, c) => h.listDiagramModels(c.diagramsDir, c.artifactsDir),
29
+ },
12
30
  { method: 'GET', pattern: /^\/api\/layouts$/, handler: (h, c) => h.listLayouts(c.diagramsDir) },
13
31
  { method: 'GET', pattern: /^\/api\/drawings$/, handler: (h, c) => h.listDrawings(c.diagramsDir) },
14
32
  // Composed read must precede the generic read, whose `(.+)` would swallow
15
33
  // `<name>/composed` as a filename.
16
- { method: 'GET', pattern: /^\/api\/diagrams\/(.+)\/composed$/, handler: (h, c) => h.readComposedDiagram(c.diagramsDir, decodeURIComponent(c.match[1] ?? '')) },
17
- { method: 'GET', pattern: /^\/api\/diagrams\/(.+)$/, handler: (h, c) => h.readDiagram(c.diagramsDir, decodeURIComponent(c.match[1] ?? '')) },
34
+ {
35
+ method: 'GET',
36
+ pattern: /^\/api\/diagrams\/(.+)\/composed$/,
37
+ handler: (h, c) => h.readComposedDiagram(c.diagramsDir, decodeURIComponent(c.match[1] ?? '')),
38
+ },
39
+ {
40
+ method: 'GET',
41
+ pattern: /^\/api\/diagrams\/(.+)$/,
42
+ handler: (h, c) => h.readDiagram(c.diagramsDir, decodeURIComponent(c.match[1] ?? '')),
43
+ },
18
44
  // Rename must be checked before the generic save route, whose `(.+)`
19
45
  // would otherwise swallow `<from>/rename` as a filename.
20
- { method: 'POST', pattern: /^\/api\/diagrams\/(.+)\/rename$/, bodyMode: 'json', handler: async (h, c) => {
46
+ {
47
+ method: 'POST',
48
+ pattern: /^\/api\/diagrams\/(.+)\/rename$/,
49
+ bodyMode: 'json',
50
+ handler: async (h, c) => {
21
51
  const to = c.body?.to;
22
52
  if (typeof to !== 'string')
23
53
  return { status: 400, body: { issues: [{ message: "Missing 'to' name" }] } };
24
54
  return h.renameDiagram(c.diagramsDir, decodeURIComponent(c.match[1] ?? ''), to);
25
- } },
55
+ },
56
+ },
26
57
  // Eject must also precede the generic save route, whose `(.+)` would
27
58
  // swallow `<name>/eject` as a filename.
28
- { method: 'POST', pattern: /^\/api\/diagrams\/(.+)\/eject$/, handler: (h, c) => h.ejectDiagramSource(c.diagramsDir, c.artifactsDir, decodeURIComponent(c.match[1] ?? '')) },
29
- { method: 'POST', pattern: /^\/api\/(diagrams|layouts|drawings)\/(.+)$/, bodyMode: 'json', handler: (h, c) => {
59
+ {
60
+ method: 'POST',
61
+ pattern: /^\/api\/diagrams\/(.+)\/eject$/,
62
+ handler: (h, c) => h.ejectDiagramSource(c.diagramsDir, c.artifactsDir, decodeURIComponent(c.match[1] ?? '')),
63
+ },
64
+ {
65
+ method: 'POST',
66
+ pattern: /^\/api\/(diagrams|layouts|drawings)\/(.+)$/,
67
+ bodyMode: 'json',
68
+ handler: (h, c) => {
30
69
  // decodeURIComponent throws on malformed percent-encoding — kept
31
70
  // inside the boundary so a bad name yields 500, never a crash.
32
71
  const name = decodeURIComponent(c.match[2] ?? '');
@@ -35,7 +74,8 @@ export const ROUTES = [
35
74
  : c.match[1] === 'layouts'
36
75
  ? h.saveLayout(c.diagramsDir, name, c.body)
37
76
  : h.saveDrawings(c.diagramsDir, name, c.body);
38
- } },
77
+ },
78
+ },
39
79
  ];
40
80
  /** The route matching `method` + `url`, or undefined. First match wins. */
41
81
  export function matchRoute(method, url) {
package/dist/cli.d.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { type PublishOptions } from './publish/publish.js';
1
2
  interface Args {
2
3
  command: string;
3
4
  files: string[];
@@ -37,6 +38,11 @@ export declare class UnknownFlagError extends Error {
37
38
  export declare class BadFlagValueError extends Error {
38
39
  constructor(flag: string, why: string);
39
40
  }
41
+ /** Where `publish` compiles to and builds pages from. One object for both steps, so
42
+ * the pages are always made from the artifacts this run just wrote. `--out` moves the
43
+ * artifacts only: the pages and PNGs stay where `.gitignore`, the docs and the READMEs
44
+ * that embed them expect to find them. */
45
+ export declare function publishDirs(args: Pick<Args, 'out'>): Pick<PublishOptions, 'srcDir' | 'artifactsDir' | 'htmlDir' | 'staticDir' | 'assetsDir'>;
40
46
  /** `A..B` or `A` (against the working tree). */
41
47
  export declare function parseRange(range: string): {
42
48
  from: string;
package/dist/cli.js CHANGED
@@ -90,8 +90,14 @@ export function parseArgs(argv) {
90
90
  for (let i = 0; i < argv.length; i++) {
91
91
  const arg = argv[i];
92
92
  if (arg === '--out') {
93
- out = argv[++i] ?? out;
93
+ // No fallback to the default: a trailing --out would quietly write somewhere the
94
+ // user did not ask for, and a missing value would swallow the next flag as the dir.
95
+ const value = argv[i + 1];
96
+ if (value === undefined || value.startsWith('--'))
97
+ throw new BadFlagValueError('--out', 'needs a directory, e.g. --out build/artifacts');
98
+ out = value;
94
99
  outGiven = true;
100
+ i++;
95
101
  continue;
96
102
  }
97
103
  if (arg === '--no-images') {
@@ -134,8 +140,8 @@ export function parseArgs(argv) {
134
140
  continue;
135
141
  }
136
142
  if (arg === '--link') {
137
- // No fallback for a missing value, unlike --out: there is no default address, and
138
- // the URL check is also what stops the next flag being swallowed as one.
143
+ // No fallback for a missing value: there is no default address, and the URL
144
+ // check is also what stops the next flag being swallowed as one.
139
145
  const value = argv[++i] ?? '';
140
146
  try {
141
147
  galleryLink(value);
@@ -204,6 +210,20 @@ const SOURCES = '.diagrams/src/**/*.diagram.{ts,json}';
204
210
  function warnNoSources(dir = '.diagrams/src') {
205
211
  console.error(`No diagrams under ${dir} — run 'diagc init' to create one.`);
206
212
  }
213
+ /** Where `publish` compiles to and builds pages from. One object for both steps, so
214
+ * the pages are always made from the artifacts this run just wrote. `--out` moves the
215
+ * artifacts only: the pages and PNGs stay where `.gitignore`, the docs and the READMEs
216
+ * that embed them expect to find them. */
217
+ export function publishDirs(args) {
218
+ const srcDir = '.diagrams/src';
219
+ return {
220
+ srcDir,
221
+ artifactsDir: args.out,
222
+ htmlDir: '.diagrams/html',
223
+ staticDir: '.diagrams/static',
224
+ assetsDir: path.join(srcDir, 'assets'),
225
+ };
226
+ }
207
227
  async function main() {
208
228
  let args;
209
229
  try {
@@ -277,7 +297,9 @@ async function main() {
277
297
  if (args.updateIncludes)
278
298
  console.error('ignoring --update-includes: watch always runs locked');
279
299
  const dir = args.files[0] ?? '.diagrams/src';
280
- if (existsSync(dir) && statSync(dir).isDirectory() && (await fg('**/*.diagram.{ts,json}', { cwd: dir })).length === 0)
300
+ if (existsSync(dir) &&
301
+ statSync(dir).isDirectory() &&
302
+ (await fg('**/*.diagram.{ts,json}', { cwd: dir })).length === 0)
281
303
  warnNoSources(dir);
282
304
  const watchSnap = snapshotSession(resolveInclude, '.diagrams', 'locked');
283
305
  startWatch(dir, args.out, {
@@ -304,15 +326,18 @@ async function main() {
304
326
  : `viewer shell missing from this install (${home.viewerShell}) — reinstall diagc.`);
305
327
  process.exit(1);
306
328
  }
307
- const srcDir = '.diagrams/src';
308
- const artifactsDir = '.diagrams/.artifacts';
329
+ const dirs = publishDirs(args);
309
330
  // Compile first so artifacts reflect current sources (TS + include expansion).
310
- const sources = await fg('**/*.diagram.{ts,json}', { cwd: srcDir, absolute: true });
331
+ const sources = await fg('**/*.diagram.{ts,json}', { cwd: dirs.srcDir, absolute: true });
311
332
  if (sources.length === 0)
312
- warnNoSources(srcDir);
333
+ warnNoSources(dirs.srcDir);
313
334
  for (const f of sources) {
314
335
  try {
315
- await compileFile(f, artifactsDir, { rootDir: srcDir, coreEntry: home.coreEntry, resolver: snap.resolver });
336
+ await compileFile(f, dirs.artifactsDir, {
337
+ rootDir: dirs.srcDir,
338
+ coreEntry: home.coreEntry,
339
+ resolver: snap.resolver,
340
+ });
316
341
  }
317
342
  catch (e) {
318
343
  console.error(`✗ ${f}\n${errMessage(e)}`);
@@ -336,21 +361,17 @@ async function main() {
336
361
  }
337
362
  }
338
363
  const res = await publishDiagrams({
339
- srcDir,
340
- artifactsDir,
341
- htmlDir: '.diagrams/html',
342
- staticDir: '.diagrams/static',
364
+ ...dirs,
343
365
  shellPath: home.viewerShell,
344
366
  libraryDir: home.libraryDir,
345
- assetsDir: path.join(srcDir, 'assets'),
346
367
  images,
347
368
  names: args.files,
348
369
  ...(renderPng !== undefined ? { renderPng } : {}),
349
370
  ...(args.link !== undefined ? { link: args.link } : {}),
350
371
  });
351
- console.log(`✓ ${res.pages.length} page(s) -> .diagrams/html`);
372
+ console.log(`✓ ${res.pages.length} page(s) -> ${dirs.htmlDir}`);
352
373
  if (res.images.length > 0)
353
- console.log(`✓ ${res.images.length} image(s) -> .diagrams/static`);
374
+ console.log(`✓ ${res.images.length} image(s) -> ${dirs.staticDir}`);
354
375
  console.log(`✓ gallery -> ${res.gallery}`);
355
376
  process.exit(0);
356
377
  }
package/dist/diff.js CHANGED
@@ -7,7 +7,16 @@ import { loadModel } from './compile.js';
7
7
  import { inlineAssets } from './publish/publish.js';
8
8
  import { stampHtml } from './publish/html.js';
9
9
  import { THEME_HEAD_SCRIPT, THEME_SWITCH, themeCss } from './publish/pageTheme.js';
10
- const EMPTY = { version: 1, id: '', name: '', nodes: [], containment: [], relations: [], layers: [], planes: [] };
10
+ const EMPTY = {
11
+ version: 1,
12
+ id: '',
13
+ name: '',
14
+ nodes: [],
15
+ containment: [],
16
+ relations: [],
17
+ layers: [],
18
+ planes: [],
19
+ };
11
20
  async function readJson(file) {
12
21
  return existsSync(file) ? JSON.parse(await readFile(file, 'utf8')) : undefined;
13
22
  }
@@ -20,7 +29,10 @@ export async function loadDiagramSet(label, diagramsDir, coreEntry) {
20
29
  for (const rel of files.sort()) {
21
30
  const name = rel.replace(/\.diagram\.(ts|json)$/, '');
22
31
  try {
23
- const model = await loadModel(path.join(srcDir, rel), { rootDir: srcDir, ...(coreEntry !== undefined ? { coreEntry } : {}) });
32
+ const model = await loadModel(path.join(srcDir, rel), {
33
+ rootDir: srcDir,
34
+ ...(coreEntry !== undefined ? { coreEntry } : {}),
35
+ });
24
36
  const layout = (await readJson(path.join(srcDir, `${name}.layout.json`)));
25
37
  const drawings = await readJson(path.join(srcDir, `${name}.drawings.json`));
26
38
  versions.set(name, {
@@ -37,7 +49,12 @@ export async function loadDiagramSet(label, diagramsDir, coreEntry) {
37
49
  }
38
50
  /** Pair the two sets by name. `names` narrows the result to those diagrams. */
39
51
  export function compareDiagramSets(before, after, names = []) {
40
- const all = new Set([...before.versions.keys(), ...before.errors.keys(), ...after.versions.keys(), ...after.errors.keys()]);
52
+ const all = new Set([
53
+ ...before.versions.keys(),
54
+ ...before.errors.keys(),
55
+ ...after.versions.keys(),
56
+ ...after.errors.keys(),
57
+ ]);
41
58
  const wanted = names.length > 0 ? names.filter((n) => all.has(n)) : [...all].sort();
42
59
  return wanted.map((name) => {
43
60
  const b = before.versions.get(name);
@@ -64,7 +81,9 @@ export function describeDiff(d) {
64
81
  if (d.diff === undefined)
65
82
  return [];
66
83
  if (d.status === 'added')
67
- return [`+ new diagram: ${d.after.model.name} (${d.diff.nodes.added.length} nodes, ${d.diff.relations.added.length} relations)`];
84
+ return [
85
+ `+ new diagram: ${d.after.model.name} (${d.diff.nodes.added.length} nodes, ${d.diff.relations.added.length} relations)`,
86
+ ];
68
87
  if (d.status === 'removed')
69
88
  return [`- diagram removed: ${d.before.model.name}`];
70
89
  const before = d.before?.model;
@@ -174,7 +193,9 @@ function indexHtml(shown, files, from, to) {
174
193
  : `<div class="side"><h3><a href="${escapeHtml(rel)}.html">${escapeHtml(label)}</a></h3><iframe src="${escapeHtml(rel)}.html?export=1" title="${escapeHtml(label)}"></iframe></div>`;
175
194
  const sections = shown.map((d) => {
176
195
  const f = files.get(d.name) ?? {};
177
- const list = describeDiff(d).map((l) => `<li class="${l[0] === '+' ? 'add' : l[0] === '-' ? 'del' : 'chg'}">${escapeHtml(l)}</li>`).join('');
196
+ const list = describeDiff(d)
197
+ .map((l) => `<li class="${l[0] === '+' ? 'add' : l[0] === '-' ? 'del' : 'chg'}">${escapeHtml(l)}</li>`)
198
+ .join('');
178
199
  return `<section><h2>${escapeHtml(d.name)}</h2><ul>${list}</ul><div class="pair">${side(f.before, `Before · ${from}`)}${side(f.after, `After · ${to}`)}</div></section>`;
179
200
  });
180
201
  return `<!doctype html>
package/dist/git-ref.js CHANGED
@@ -48,7 +48,10 @@ export async function checkoutDiagrams(ref, cwd, diagramsDir = '.diagrams') {
48
48
  /** `git archive <commit> -- <path> | tar -x -C <into>`, without a shell. */
49
49
  function pipeArchive(commit, repoPath, cwd, into) {
50
50
  return new Promise((resolve, reject) => {
51
- const git = spawn('git', ['archive', '--format=tar', commit, '--', repoPath], { cwd, stdio: ['ignore', 'pipe', 'pipe'] });
51
+ const git = spawn('git', ['archive', '--format=tar', commit, '--', repoPath], {
52
+ cwd,
53
+ stdio: ['ignore', 'pipe', 'pipe'],
54
+ });
52
55
  const tar = spawn('tar', ['-x', '-C', into], { stdio: ['pipe', 'ignore', 'pipe'] });
53
56
  let err = '';
54
57
  git.stderr.on('data', (d) => (err += d.toString()));
package/dist/init.js CHANGED
@@ -49,8 +49,12 @@ export function withBlock(existing, block) {
49
49
  }
50
50
  export const withAgentsBlock = (existing) => withBlock(existing, AGENTS_BLOCK);
51
51
  const COL = 38;
52
- const done = (left, right) => `✓ ${left.padEnd(COL)}${right}`;
53
- const skipped = (left, right) => `· ${left.padEnd(COL)}${right}`;
52
+ /** A line of two columns: the right one starts COL in, and never less than two spaces after
53
+ * the left one. A path with a folder in its name is longer than the column, and padding
54
+ * alone would run it into the text beside it. */
55
+ const columns = (left, right) => `${left.padEnd(COL - 2)} ${right}`;
56
+ const done = (left, right) => `✓ ${columns(left, right)}`;
57
+ const skipped = (left, right) => `· ${columns(left, right)}`;
54
58
  /** A one-line failure on stderr with exit 1. A refusal leaves the tree untouched;
55
59
  * a compile failure comes after the writes, so the starter and `.gitignore` stay. */
56
60
  export class InitError extends Error {
@@ -146,7 +150,8 @@ async function agentsStep(cwd, io) {
146
150
  }
147
151
  /** `.claude/` is Claude Code's own folder, not neutral ground like `AGENTS.md`, so
148
152
  * the skill goes only where the repository already shows that tool in use. */
149
- const usesClaudeCode = (cwd) => (statSync(path.join(cwd, '.claude'), { throwIfNoEntry: false })?.isDirectory() ?? false) || existsSync(path.join(cwd, 'CLAUDE.md'));
153
+ const usesClaudeCode = (cwd) => (statSync(path.join(cwd, '.claude'), { throwIfNoEntry: false })?.isDirectory() ?? false) ||
154
+ existsSync(path.join(cwd, 'CLAUDE.md'));
150
155
  /** Everything step 4 has to read, read before the first write: an install that
151
156
  * lost its skill is a refusal, and a refusal leaves the tree untouched. A new file
152
157
  * is the shipped one, frontmatter and all; in a file that is already there only
@@ -205,7 +210,7 @@ function nextSteps(opts) {
205
210
  lines.push(['diagc init --agents', 'point coding agents at the guide (AGENTS.md, Claude Code skill)']);
206
211
  if (existsSync(path.join(opts.cwd, 'package.json')))
207
212
  lines.push([`npm i -D @diagc/core@${opts.version}`, 'editor types for .diagram.ts']);
208
- return `\nNext:\n${lines.map(([cmd, what]) => ` ${cmd.padEnd(COL)}${what}`).join('\n')}`;
213
+ return `\nNext:\n${lines.map(([cmd, what]) => ` ${columns(cmd, what)}`).join('\n')}`;
209
214
  }
210
215
  const stdio = {
211
216
  out: (text) => console.log(text),
package/dist/lint.js CHANGED
@@ -16,7 +16,9 @@ export async function lintFile(file, opts) {
16
16
  }
17
17
  catch (e) {
18
18
  // By name, not instanceof: a builder diagram throws from jiti's own copy of core.
19
- if (e instanceof Error && e.name === 'DiagramValidationError' && Array.isArray(e.issues)) {
19
+ if (e instanceof Error &&
20
+ e.name === 'DiagramValidationError' &&
21
+ Array.isArray(e.issues)) {
20
22
  return e.issues.map((i) => report(file, 'error', i));
21
23
  }
22
24
  if (e instanceof LoadError) {
@@ -1,6 +1,11 @@
1
1
  import path from 'node:path';
2
2
  const MIME = {
3
- svg: 'image/svg+xml', png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', webp: 'image/webp', gif: 'image/gif',
3
+ svg: 'image/svg+xml',
4
+ png: 'image/png',
5
+ jpg: 'image/jpeg',
6
+ jpeg: 'image/jpeg',
7
+ webp: 'image/webp',
8
+ gif: 'image/gif',
4
9
  };
5
10
  export function dataUri(bytes, ext) {
6
11
  const mime = MIME[ext.toLowerCase()] ?? 'application/octet-stream';
@@ -17,7 +17,11 @@ export async function discoverDiagrams(artifactsDir, srcDir) {
17
17
  }
18
18
  };
19
19
  for (const modelPath of files) {
20
- const name = path.relative(artifactsDir, modelPath).replace(/\.diagram\.json$/, '').split(path.sep).join('/');
20
+ const name = path
21
+ .relative(artifactsDir, modelPath)
22
+ .replace(/\.diagram\.json$/, '')
23
+ .split(path.sep)
24
+ .join('/');
21
25
  const layoutPath = path.join(srcDir, `${name}.layout.json`);
22
26
  const drawingsPath = path.join(srcDir, `${name}.drawings.json`);
23
27
  out.push({
@@ -3,9 +3,7 @@ function esc(s) {
3
3
  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/"/g, '&quot;');
4
4
  }
5
5
  function card(e) {
6
- const thumb = e.hasImage
7
- ? `<img src="../static/${esc(e.name)}.png" alt="${esc(e.title)}" loading="lazy" />`
8
- : '';
6
+ const thumb = e.hasImage ? `<img src="../static/${esc(e.name)}.png" alt="${esc(e.title)}" loading="lazy" />` : '';
9
7
  // The path is what `diagc publish <name>` and the page URL use, so it stays on the
10
8
  // card — unless the model has no name of its own and the two would just repeat.
11
9
  const path = e.title === e.name ? '' : `<span class="path">${esc(e.name)}</span>`;
@@ -29,8 +29,10 @@ export async function inlineAssets(model, dirs, cache, label) {
29
29
  if (kind === 'skip')
30
30
  continue;
31
31
  const base = kind === 'library' ? dirs.libraryDir : dirs.assetsDir;
32
- const rel = kind === 'library' ? ref.slice('/library/'.length)
33
- : kind === 'api-assets' ? ref.slice('/api/assets/'.length)
32
+ const rel = kind === 'library'
33
+ ? ref.slice('/library/'.length)
34
+ : kind === 'api-assets'
35
+ ? ref.slice('/api/assets/'.length)
34
36
  : ref;
35
37
  const filePath = safeAssetPath(base, rel);
36
38
  if (filePath === undefined) {
@@ -65,9 +67,7 @@ export async function publishDiagrams(opts) {
65
67
  try {
66
68
  const modelRaw = JSON.parse(await readFile(d.modelPath, 'utf8'));
67
69
  titles.set(d.name, modelRaw.name);
68
- const layout = d.layoutPath !== undefined
69
- ? JSON.parse(await readFile(d.layoutPath, 'utf8'))
70
- : undefined;
70
+ const layout = d.layoutPath !== undefined ? JSON.parse(await readFile(d.layoutPath, 'utf8')) : undefined;
71
71
  // A hand-edited sidecar can be valid JSON and still not be a drawings
72
72
  // overlay. Publishing it would stamp shapeless data into a page that has
73
73
  // no validator of its own, so it is warned about and dropped — the page
@@ -9,8 +9,11 @@ export function findChrome() {
9
9
  if (env !== undefined && existsSync(env))
10
10
  return env;
11
11
  const candidates = [
12
- '/usr/bin/google-chrome', '/usr/bin/google-chrome-stable', '/usr/bin/chromium',
13
- '/usr/bin/chromium-browser', '/snap/bin/chromium',
12
+ '/usr/bin/google-chrome',
13
+ '/usr/bin/google-chrome-stable',
14
+ '/usr/bin/chromium',
15
+ '/usr/bin/chromium-browser',
16
+ '/snap/bin/chromium',
14
17
  '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
15
18
  ];
16
19
  return candidates.find((p) => existsSync(p));
@@ -26,10 +29,16 @@ export async function renderPng(htmlPath, pngPath) {
26
29
  try {
27
30
  // Light, by name: `?export=1` already makes the viewer light whatever the browser
28
31
  // prefers, and this says so where the picture is taken.
29
- const page = await browser.newPage({ viewport: { width: 1600, height: 1000 }, deviceScaleFactor: 2, colorScheme: 'light' });
32
+ const page = await browser.newPage({
33
+ viewport: { width: 1600, height: 1000 },
34
+ deviceScaleFactor: 2,
35
+ colorScheme: 'light',
36
+ });
30
37
  // `?export=1` tells the viewer to unfold every group for a full overview.
31
38
  await page.goto(`${pathToFileURL(path.resolve(htmlPath)).href}?export=1`);
32
- await page.waitForFunction(() => window.__DG_READY__ === true, null, { timeout: 15_000 });
39
+ await page.waitForFunction(() => window.__DG_READY__ === true, null, {
40
+ timeout: 15_000,
41
+ });
33
42
  // __DG_BOUNDS__ is the TRUE node bounding box in flow coordinates, so the
34
43
  // frame gets the real content aspect; then re-fit into it (React Flow's
35
44
  // `fitView` prop only fits on init, not after this resize) so nothing clips.
@@ -38,7 +47,9 @@ export async function renderPng(htmlPath, pngPath) {
38
47
  const bounds = await page.evaluate(() => window.__DG_BOUNDS__ ?? { width: 1200, height: 800 });
39
48
  const reserve = await page.evaluate(() => window.__DG_RESERVE__ ?? null);
40
49
  const size = pageSize(bounds, {
41
- maxWidth: 2000, maxHeight: 1400, padding: FRAME_PADDING,
50
+ maxWidth: 2000,
51
+ maxHeight: 1400,
52
+ padding: FRAME_PADDING,
42
53
  // Only a top/bottom legend costs height, which is all `legendReserve`
43
54
  // ever reports today; a side legend would need pageSize to widen instead.
44
55
  reserve: reserve === null || reserve.side === 'left' || reserve.side === 'right' ? 0 : reserve.px,
package/dist/serve.js CHANGED
@@ -47,7 +47,10 @@ export function resolveStatic(root, urlPath) {
47
47
  }
48
48
  // Normalizing against '/' first collapses '..' segments before they are ever
49
49
  // joined to a real directory, so the resolve below cannot climb out.
50
- const rel = path.posix.normalize(decoded).replace(/^(\.\.(\/|$))+/, '').replace(/^\/+/, '');
50
+ const rel = path.posix
51
+ .normalize(decoded)
52
+ .replace(/^(\.\.(\/|$))+/, '')
53
+ .replace(/^\/+/, '');
51
54
  const full = path.resolve(root, rel);
52
55
  const rootResolved = path.resolve(root);
53
56
  if (full !== rootResolved && !full.startsWith(rootResolved + path.sep))
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@diagc/cli",
3
- "version": "0.14.1",
3
+ "version": "0.14.2",
4
4
  "description": "Author software-architecture diagrams as code, compile them to a validated model, edit them in a local studio, and publish pages and images.",
5
5
  "license": "AGPL-3.0-only",
6
6
  "author": "Bogdan Frankovskyi",
@@ -44,7 +44,7 @@
44
44
  "fast-glob": "^3.3.0",
45
45
  "jiti": "^2.0.0",
46
46
  "playwright-core": "^1.62.0",
47
- "@diagc/core": "0.14.1"
47
+ "@diagc/core": "0.14.2"
48
48
  },
49
49
  "publishConfig": {
50
50
  "access": "public"