@itsthecsguy/linework 0.0.0-stage → 0.1.0

package/assets/drawio/styles/high-contrast.css

@@ -0,0 +1,128 @@
+:root {
+	--ge-panel-color: #ffffff;
+	--border-color: #000000;
+	--text-color: #000000;
+	--toolbar-color: #ffffff;
+	--primary-color: #ffffff;
+	--dark-text-color: #ffffff;
+	--ge-dark-panel-color: #121212;
+	--dark-toolbar-color: #121212;
+}
+
+.geSidebar *:not(svg *, .mxDisabled, [disabled]),
+.geToolbar *:not(svg *, .mxDisabled, [disabled]) {
+	opacity: 1 !important;
+}
+
+*:not(svg *, .mxDisabled, [disabled], .spinner *, .geBackground, .geDragPreview, .geButton) {
+	border-color: light-dark(#000000, #FFFFFF) !important;
+}
+
+button, .geBtn, *::-webkit-scrollbar-thumb {
+	border-color: light-dark(#000000, #FFFFFF) !important;
+	color: light-dark(#000000, #FFFFFF) !important;
+}
+
+button, .geBtn {
+	border-style: solid !important;
+	border-width: 1px !important;
+}
+
+.geSimple .geDiagramContainer {
+	border-top-style: none !important;
+	border-bottom-style: none !important;
+}
+
+button:not(:hover), .geBtn:not(:hover) {
+	background-color: transparent !important;
+}
+
+.gePrimaryBtn {
+	border-width: 3px !important;
+}
+
+.geActivePage, .geActiveFormatTitle {
+	text-decoration: underline;
+}
+
+.geActivePage {
+	background-color: light-dark(#ffffff, #000000) !important;
+	color: inherit !important;
+	filter: invert(1);
+}
+
+.geBigButton>img:not(.geDarkMode *) {
+	filter: invert(1);
+}
+
+.geEditor,
+.geTitle,
+.geFormatTitle  {
+	font-size: 15px;
+}
+
+.geTab,
+.geFormatContainer,
+.geSearchSidebar input,
+.geSpinnerStatus {
+	font-size: 14px !important;
+	line-height: 14px !important;
+}
+
+.geEditor div.mxTooltip {
+	font-size: 12px;
+}
+
+.geHint {
+	font-size: 11pt;
+}
+
+/* Dialogs: restore solid backgrounds and visible borders */
+.geDialog {
+	background-color: light-dark(#ffffff, var(--ge-dark-panel-color)) !important;
+	border: 1px solid light-dark(#000000, #FFFFFF) !important;
+	box-shadow: none !important;
+}
+
+html body.geDarkMode .geDialog,
+html body.geDarkMode div.mxWindow,
+html body div.mxWindow.geDarkMode {
+	background-color: var(--ge-dark-panel-color) !important;
+	border-color: #FFFFFF !important;
+	box-shadow: none !important;
+}
+
+.geDialog,
+html div.mxWindow {
+	box-shadow: none !important;
+}
+
+/* Dialog overlay: solid opaque background */
+.geBackground {
+	background-color: light-dark(#ffffff, #000000) !important;
+	opacity: 0.9 !important;
+	backdrop-filter: none !important;
+}
+
+/* Dialog close button: full opacity for visibility */
+.geDialog > .geButton {
+	opacity: 1 !important;
+}
+
+/* Dialog title and footer: solid visible borders */
+.geDialogTitle {
+	border-bottom: 1px solid light-dark(#000000, #FFFFFF) !important;
+}
+
+.geDialogFooter {
+	border-top: 1px solid light-dark(#000000, #FFFFFF) !important;
+}
+
+/* Input fields: solid visible borders */
+.geDialog input[type="text"],
+.geDialog input[type="number"],
+.geDialog textarea,
+.geDialog select {
+	border: 1px solid light-dark(#000000, #FFFFFF) !important;
+	background-color: light-dark(#ffffff, #000000) !important;
+}

package/assets/fonts/ibm-plex-mono-LICENSE.txt

@@ -0,0 +1,93 @@
+Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-ThinItalic.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-ExtraLight.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-ExtraLightItalic.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-Light.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-LightItalic.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-Regular.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-Italic.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-Medium.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-MediumItalic.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-SemiBold.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-SemiBoldItalic.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-Bold.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-BoldItalic.ttf: Copyright 2017 IBM Corp. All rights reserved.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/fonts/ibm-plex-sans-LICENSE.txt

@@ -0,0 +1,93 @@
+Copyright 2019 IBM Corp. All rights reserved. IBMPlexSans-Italic[wdth,wght].ttf: Copyright 2019 IBM Corp. All rights reserved.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/fonts/kalam-LICENSE.txt

@@ -0,0 +1,93 @@
+Copyright (c) 2014 Indian Type Foundry (info@indiantypefoundry.com) Kalam-Regular.ttf: Copyright (c) 2014 Indian Type Foundry (info@indiantypefoundry.com) Kalam-Bold.ttf: Copyright (c) 2014 Indian Type Foundry (info@indiantypefoundry.com)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/api.js

@@ -0,0 +1,181 @@
+// Programmatic API behind the CLI (and later the MCP server).
+import fs from 'node:fs';
+import path from 'node:path';
+import { parseSpecText } from './spec/parse.js';
+import { layout } from './layout/layout.js';
+import { patchEdges, serialize, stampEdgeRoutes, toMxfile } from './drawio/write.js';
+import { absBox, fingerprint, readDrawio, specBase } from './drawio/read.js';
+import { manualEdits, toDiagram, toYaml } from './drawio/show.js';
+import { merge } from './drawio/merge.js';
+import { sequenceScene } from './layout/sequence.js';
+import { resolveIcon, PROVIDERS } from './drawio/icons.js';
+import { DrawioBrowser } from './render/browser.js';
+import { brokenEdges, check } from './lint/check.js';
+import { fixLabels } from './lint/fixlabels.js';
+async function withBrowser(given, fn) {
+    const b = given ?? (await DrawioBrowser.launch());
+    try {
+        return await fn(b);
+    }
+    finally {
+        if (!given)
+            await b.close();
+    }
+}
+export async function build(specText, opts) {
+    const { diagram, warnings } = parseSpecText(specText);
+    const kind = outputKind(opts.out);
+    let old;
+    if (fs.existsSync(opts.out)) {
+        try {
+            old = readDrawio(fs.readFileSync(opts.out, 'utf8'));
+        }
+        catch {
+            if (!opts.force)
+                throw new Error(`${opts.out} exists and isn't a draw.io file linework can read. Use --force to overwrite it.`);
+        }
+    }
+    const edits = old ? manualEdits(old) : [];
+    // Once a person has touched the layout, every later build merges into it.
+    const mode = old && !opts.relayout && (old.meta.aiviz_layout === 'manual' || edits.length > 0) ? 'merge' : 'fresh';
+    return withBrowser(opts.browser, async (b) => {
+        const measure = (r) => b.measure(r);
+        for (const n of diagram.nodes) {
+            if (!n.icon)
+                continue;
+            const r = resolveIcon(n.icon);
+            if ('error' in r || !(await b.hasStencil(r.stencil))) {
+                warnings.push({ path: `nodes.${n.id}.icon`, message: `no icon named "${n.icon}"; run "linework icons ${n.icon.split('.')[0]} ${n.icon.split('.')[1] ?? ''}" to search. Drawing it without one.` });
+                delete n.icon;
+            }
+        }
+        if (diagram.type === 'sequence') {
+            let keepX;
+            let keep;
+            if (mode === 'merge') {
+                const shown = toDiagram(old);
+                keepX = new Map();
+                keep = new Map();
+                for (const [cellId, specId] of shown.idMap) {
+                    const c = old.byId.get(cellId);
+                    const box = absBox(old, cellId);
+                    if (box)
+                        keepX.set(specId, { x: box.x, w: box.w });
+                    const prev = shown.diagram.nodes.find((n) => n.id === specId);
+                    const now = diagram.nodes.find((n) => n.id === specId);
+                    if (!prev || !now || shown.diagram.theme !== diagram.theme)
+                        continue;
+                    const { id: _i, value: _v, aiviz_auto: _a, ...attrs } = c.attrs;
+                    const sameLook = (prev.color ?? '') === (now.color ?? '') && !!prev.highlight === !!now.highlight;
+                    const { aiviz_color: _c, aiviz_highlight: _h, ...rest } = attrs;
+                    keep.set(specId, {
+                        attrs: rest,
+                        style: prev.kind === now.kind && sameLook ? c.styleRaw : undefined,
+                        label: prev.label === now.label && prev.tech === now.tech && sameLook ? (c.attrs.label ?? c.label) : undefined,
+                    });
+                }
+            }
+            const scene = await sequenceScene(diagram, measure, { keepX, keep, extraMeta: mode === 'merge' ? { aiviz_layout: 'manual' } : {} });
+            const xml = stampEdgeRoutes(serialize(scene));
+            return finish(b, xml, { mode, warnings, direction: 'TB', edits, old });
+        }
+        const l = await layout(diagram, measure);
+        let xml;
+        let stats;
+        if (mode === 'merge') {
+            const m = merge(diagram, old, l, { specIsCurrent: specBase(specText) === fingerprint(old) });
+            stats = m.stats;
+            xml = serialize(m.scene);
+            if (m.reroute.length)
+                xml = await rerouteInto(b, xml, m.reroute);
+            // Kept routes can already be broken, e.g. stale waypoints after someone moved a node.
+            const broken = brokenEdges(check(await b.inspect(xml)));
+            if (broken.length) {
+                xml = await rerouteInto(b, xml, broken);
+                stats.rerouted += broken.filter((id) => !m.reroute.includes(id)).length;
+            }
+        }
+        else
+            xml = toMxfile(diagram, l);
+        xml = (await fixLabels(b, xml)).xml;
+        xml = stampEdgeRoutes(xml);
+        return finish(b, xml, { mode, warnings, direction: mode === 'merge' ? (old.meta.aiviz_direction ?? l.direction) : l.direction, edits, old, stats });
+    });
+    async function finish(b, xml, r) {
+        fs.mkdirSync(path.dirname(path.resolve(opts.out)), { recursive: true });
+        fs.writeFileSync(opts.out, kind === 'svg' ? await b.renderSvg(xml) : xml);
+        if (opts.png)
+            await b.renderPng(xml, opts.png);
+        return {
+            out: opts.out,
+            warnings: r.warnings,
+            check: check(await b.inspect(xml)),
+            direction: r.direction,
+            mode: r.mode,
+            merge: r.stats,
+            discardedLayout: !!(opts.relayout && r.old && (r.old.meta.aiviz_layout === 'manual' || r.edits.length > 0)),
+        };
+    }
+}
+async function rerouteInto(b, xml, edgeIds) {
+    return patchEdges(xml, await b.reroute(xml, edgeIds), edgeIds);
+}
+/** Reroute only the edges check flags as broken. Nothing else changes. */
+export async function tidy(file, browser) {
+    const text = fs.readFileSync(file, 'utf8');
+    const m = readDrawio(text);
+    return withBrowser(browser, async (b) => {
+        const broken = brokenEdges(check(await b.inspect(m.xml)));
+        if (!broken.length)
+            return { fixed: 0, check: check(await b.inspect(m.xml)) };
+        const xml = stampEdgeRoutes(await rerouteInto(b, m.xml, broken));
+        fs.writeFileSync(file, file.endsWith('.svg') ? await b.renderSvg(xml) : xml);
+        return { fixed: broken.length, check: check(await b.inspect(xml)) };
+    });
+}
+export function show(file, opts = {}) {
+    const m = readDrawio(fs.readFileSync(file, 'utf8'));
+    const { diagram, notes, idMap } = toDiagram(m);
+    let yaml = toYaml(diagram, `linework-base: ${fingerprint(m)}  (keep this line; it tells build this spec includes the latest hand edits)`);
+    if (opts.geometry) {
+        // Positions as comments: invisible to build, but they make `git diff` show moves.
+        const lines = ['# geometry (x,y width x height)'];
+        for (const [cellId, specId] of idMap) {
+            const b = absBox(m, cellId);
+            if (b)
+                lines.push(`#   ${specId}: ${Math.round(b.x)},${Math.round(b.y)} ${Math.round(b.w)}x${Math.round(b.h)}`);
+        }
+        yaml += lines.join('\n') + '\n';
+    }
+    return { yaml, notes, edits: manualEdits(m) };
+}
+export async function render(file, out, browser) {
+    const m = readDrawio(fs.readFileSync(file, 'utf8'));
+    await withBrowser(browser, async (b) => {
+        if (out.endsWith('.png'))
+            await b.renderPng(m.xml, out);
+        else if (out.endsWith('.svg'))
+            fs.writeFileSync(out, await b.renderSvg(m.xml));
+        else
+            throw new Error('render output must end in .png or .svg');
+    });
+}
+export async function checkFile(file, browser) {
+    const m = readDrawio(fs.readFileSync(file, 'utf8'));
+    return withBrowser(browser, async (b) => check(await b.inspect(m.xml)));
+}
+function outputKind(out) {
+    if (out.endsWith('.svg'))
+        return 'svg';
+    if (out.endsWith('.drawio') || out.endsWith('.xml'))
+        return 'xml';
+    throw new Error(`output must end in .drawio.svg (recommended), .svg or .drawio, got ${out}`);
+}
+/** Icon names for a provider, optionally filtered. */
+export async function listIcons(provider, filter, browser) {
+    return withBrowser(browser, async (b) => {
+        const p = PROVIDERS[provider];
+        const names = (await b.stencilNames(p.set)).map((n) => n.slice(p.prefix.length));
+        return names.filter((n) => !filter || n.includes(filter.toLowerCase())).sort();
+    });
+}