@fazelstudio/floe 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zulfazli (Fazelllyyy) <zulfazlilsm@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/src/cli/check.d.ts

@@ -0,0 +1,14 @@
+import type { Diagnostic } from "../diagnostics.js";
+export interface CheckOptions {
+    json?: boolean;
+    quiet?: boolean;
+}
+export interface CheckResult {
+    file: string;
+    diagnostics: Diagnostic[];
+    hasErrors: boolean;
+}
+export declare function formatDiagnostic(file: string, d: Diagnostic): string;
+export declare function checkFile(filePath: string, opts?: CheckOptions): CheckResult;
+export declare function runCheck(files: string[], opts?: CheckOptions): number;
+//# sourceMappingURL=check.d.ts.map

package/dist/src/cli/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/cli/check.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAGpE;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,WAAW,CAWhF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,MAAM,CA6DzE"}

package/dist/src/cli/check.js

@@ -0,0 +1,88 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { parseFloe } from "../index.js";
+export function formatDiagnostic(file, d) {
+    const { line, column } = d.range.start;
+    return `${file}:${line}:${column} ${d.code} ${d.severity} ${d.message}`;
+}
+export function checkFile(filePath, opts = {}) {
+    let source;
+    try {
+        source = fs.readFileSync(filePath, "utf-8");
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new Error(`Cannot read file '${filePath}': ${msg}`);
+    }
+    const { diagnostics } = parseFloe(source);
+    const hasErrors = diagnostics.some((d) => d.severity === "error");
+    return { file: filePath, diagnostics, hasErrors };
+}
+export function runCheck(files, opts = {}) {
+    if (files.length === 0) {
+        console.error("floe check: no input files");
+        console.error("Usage: floe check <file.floe> [--json]");
+        return 2;
+    }
+    let overallHasErrors = false;
+    let overallOutput = [];
+    for (const f of files) {
+        const resolved = path.resolve(f);
+        if (!fs.existsSync(resolved)) {
+            console.error(`floe check: file not found: ${f}`);
+            return 2;
+        }
+        try {
+            const result = checkFile(resolved, opts);
+            overallOutput.push(result);
+            if (result.hasErrors)
+                overallHasErrors = true;
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(msg);
+            return 2;
+        }
+    }
+    if (opts.json) {
+        const jsonOut = overallOutput.map((r) => ({
+            file: path.relative(process.cwd(), r.file),
+            diagnostics: r.diagnostics.map((d) => ({
+                code: d.code,
+                severity: d.severity,
+                message: d.message,
+                range: d.range,
+            })),
+            hasErrors: r.hasErrors,
+        }));
+        console.log(JSON.stringify(jsonOut, null, 2));
+    }
+    else {
+        for (const r of overallOutput) {
+            const rel = path.relative(process.cwd(), r.file);
+            if (r.diagnostics.length === 0) {
+                if (!opts.quiet)
+                    console.log(`✔ ${rel}: OK`);
+            }
+            else {
+                const errCount = r.diagnostics.filter((d) => d.severity === "error").length;
+                const warnCount = r.diagnostics.filter((d) => d.severity === "warning").length;
+                if (!opts.quiet) {
+                    if (errCount > 0)
+                        console.error(`✖ ${rel}: ${errCount} error(s)${warnCount ? `, ${warnCount} warning(s)` : ""}`);
+                    else
+                        console.log(`✔ ${rel}: ${warnCount} warning(s)`);
+                }
+                for (const d of r.diagnostics) {
+                    const line = formatDiagnostic(rel, d);
+                    if (d.severity === "error")
+                        console.error(line);
+                    else
+                        console.log(line);
+                }
+            }
+        }
+    }
+    return overallHasErrors ? 1 : 0;
+}
+//# sourceMappingURL=check.js.map

package/dist/src/cli/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/cli/check.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/format.d.ts

@@ -0,0 +1,9 @@
+export interface FormatOptions {
+    write?: boolean;
+    check?: boolean;
+    stdout?: boolean;
+    json?: boolean;
+}
+export declare function runFormat(files: string[], opts?: FormatOptions): number;
+export declare function checkIsFormatted(source: string): boolean;
+//# sourceMappingURL=format.d.ts.map

package/dist/src/cli/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/cli/format.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAyG3E;AAGD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/src/cli/format.js

@@ -0,0 +1,114 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { format, isFormatted } from "../language/formatting.js";
+import { parseFloe } from "../index.js";
+export function runFormat(files, opts = {}) {
+    if (files.length === 0) {
+        console.error("floe format: no input files");
+        console.error("Usage: floe format <file.floe> [--write] [--check]");
+        return 2;
+    }
+    // Mutually exclusive: --write and --check should not both be set? Allow but prioritize check?
+    if (opts.write && opts.check) {
+        console.error("floe format: --write and --check are mutually exclusive");
+        return 2;
+    }
+    let hasUnformatted = false;
+    let hasErrors = false;
+    for (const f of files) {
+        const resolved = path.resolve(f);
+        if (!fs.existsSync(resolved)) {
+            console.error(`floe format: file not found: ${f}`);
+            return 2;
+        }
+        let source;
+        try {
+            source = fs.readFileSync(resolved, "utf-8");
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(`Cannot read file '${f}': ${msg}`);
+            return 2;
+        }
+        // Validate that format never throws on malformed input (security: no crash)
+        let formatted;
+        try {
+            formatted = format(source);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(`floe format: internal error formatting '${f}': ${msg}`);
+            return 1;
+        }
+        const needsFormat = source !== formatted;
+        if (opts.check) {
+            if (needsFormat) {
+                hasUnformatted = true;
+                const rel = path.relative(process.cwd(), resolved);
+                if (opts.json) {
+                    // json output for check mode
+                }
+                else {
+                    console.error(`✖ ${rel}: not formatted`);
+                }
+            }
+            else {
+                if (!opts.json) {
+                    const rel = path.relative(process.cwd(), resolved);
+                    // quiet on success? Only print if not json?
+                    // For CI, we want quiet success. So no output unless not formatted.
+                }
+            }
+            continue;
+        }
+        if (opts.write) {
+            if (needsFormat) {
+                try {
+                    fs.writeFileSync(resolved, formatted, "utf-8");
+                    const rel = path.relative(process.cwd(), resolved);
+                    if (!opts.json)
+                        console.log(`formatted ${rel}`);
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    console.error(`Cannot write file '${f}': ${msg}`);
+                    return 2;
+                }
+            }
+            else {
+                // Already formatted, no write
+                if (!opts.json) {
+                    // no output? Could be verbose
+                }
+            }
+            continue;
+        }
+        // Default: stdout (scriptable). If multiple files, separate with header?
+        if (files.length === 1) {
+            // Single file -> raw formatted to stdout
+            process.stdout.write(formatted);
+        }
+        else {
+            const rel = path.relative(process.cwd(), resolved);
+            // For multiple files to stdout, add filename header for scriptability? But spec says scriptable, so we should output each?
+            // We'll output with header comment per file for clarity, but that would break piping.
+            // Instead, if multiple files and stdout mode, we print each file's formatted content separated by newline and header to stderr
+            console.error(`== ${rel} ==`);
+            process.stdout.write(formatted);
+            if (!formatted.endsWith("\n"))
+                process.stdout.write("\n");
+        }
+    }
+    if (opts.check) {
+        return hasUnformatted ? 1 : 0;
+    }
+    // For write/stdout, exit 0 unless there were read errors (already returned)
+    // Should we exit 1 if original file had parse errors? Formatting should still succeed but maybe warn.
+    // We keep exit 0 for formatting success, to allow CI to use --check for validation.
+    return 0;
+}
+// For testing: check if file is formatted
+export function checkIsFormatted(source) {
+    return isFormatted(source);
+}
+//# sourceMappingURL=format.js.map

package/dist/src/cli/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/cli/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AASxC,MAAM,UAAU,SAAS,CAAC,KAAe,EAAE,OAAsB,EAAE;IACjE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACpE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,8FAA8F;IAC9F,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACzE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,EAAE,CAAC,CAAC;YACnD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,4EAA4E;QAC5E,IAAI,SAAiB,CAAC;QACtB,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;YACvE,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,KAAK,SAAS,CAAC;QAEzC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,WAAW,EAAE,CAAC;gBAChB,cAAc,GAAG,IAAI,CAAC;gBACtB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;gBACnD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACd,6BAA6B;gBAC/B,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,iBAAiB,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACf,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;oBACnD,4CAA4C;oBAC5C,oEAAoE;gBACtE,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,CAAC;oBACH,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;oBAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;oBACnD,IAAI,CAAC,IAAI,CAAC,IAAI;wBAAE,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;gBAClD,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;oBACvD,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;oBAClD,OAAO,CAAC,CAAC;gBACX,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,8BAA8B;gBAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACf,8BAA8B;gBAChC,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,yEAAyE;QACzE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,yCAAyC;YACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;YACnD,2HAA2H;YAC3H,sFAAsF;YACtF,+HAA+H;YAC/H,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;YAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,4EAA4E;IAC5E,sGAAsG;IACtG,oFAAoF;IACpF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/src/cli/main.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Floe CLI
+ * Commands:
+ *   floe check <file.floe> [--json] [--quiet]
+ *   floe format <file.floe> [--write] [--check]
+ *   floe render <file.floe> [-o output.svg]
+ *   floe lsp [--stdio]   (starts LSP server)
+ *
+ * Keep CLI behavior scriptable for CI with appropriate exit codes:
+ *   0 success
+ *   1 validation / check failure
+ *   2 usage / file not found error
+ *
+ * Treat .floe files as untrusted: never eval, ensure SVG cannot execute code.
+ * This CLI never uses eval and delegates to safe core.
+ */
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/src/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/cli/main.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG"}

package/dist/src/cli/main.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+/**
+ * Floe CLI
+ * Commands:
+ *   floe check <file.floe> [--json] [--quiet]
+ *   floe format <file.floe> [--write] [--check]
+ *   floe render <file.floe> [-o output.svg]
+ *   floe lsp [--stdio]   (starts LSP server)
+ *
+ * Keep CLI behavior scriptable for CI with appropriate exit codes:
+ *   0 success
+ *   1 validation / check failure
+ *   2 usage / file not found error
+ *
+ * Treat .floe files as untrusted: never eval, ensure SVG cannot execute code.
+ * This CLI never uses eval and delegates to safe core.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { runCheck } from "./check.js";
+import { runFormat } from "./format.js";
+import { runRender } from "./render.js";
+const VERSION = "1.0.0";
+function printHelp() {
+    console.log(`Floe ${VERSION} — diagram DSL
+
+Usage:
+  floe <command> [options] <file...>
+
+Commands:
+  check   Validate a .floe file and print diagnostics
+  format  Format file using canonical formatter
+  render  Produce SVG output
+  lsp     Start Language Server (stdio)
+  help    Show this help
+
+Options:
+  -h, --help     Show help
+  -v, --version  Show version
+
+Check:
+  floe check diagram.floe [--json] [--quiet]
+    --json   Output diagnostics as JSON
+    --quiet  Suppress OK messages
+
+Format:
+  floe format diagram.floe [--write] [--check]
+    --write  Overwrite file in place
+    --check  Exit 1 if file not formatted (for CI)
+    (default: print formatted content to stdout)
+
+Render:
+  floe render diagram.floe [-o output.svg]
+    -o, --output <file>  Write SVG to file (default: stdout)
+
+LSP:
+  floe lsp [--stdio]
+    Starts LSP server over stdio (for editor integration)
+
+Exit codes:
+  0  success
+  1  validation error / not formatted / render had errors
+  2  usage or file error
+
+Examples:
+  floe check diagram.floe
+  floe format diagram.floe --write
+  floe render diagram.floe -o diagram.svg
+  floe lsp
+
+Docs: SPEC.md
+`);
+}
+function printVersion() {
+    console.log(VERSION);
+}
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    if (args.length === 0)
+        return { files: [], opts: {} };
+    // Handle global flags
+    if (args[0] === "--help" || args[0] === "-h" || args[0] === "help") {
+        return { command: "help", files: [], opts: {} };
+    }
+    if (args[0] === "--version" || args[0] === "-v" || args[0] === "version") {
+        return { command: "version", files: [], opts: {} };
+    }
+    const command = args[0];
+    const rest = args.slice(1);
+    const files = [];
+    const opts = {};
+    let i = 0;
+    while (i < rest.length) {
+        const a = rest[i];
+        if (a === "--json") {
+            opts.json = true;
+            i++;
+        }
+        else if (a === "--quiet" || a === "-q") {
+            opts.quiet = true;
+            i++;
+        }
+        else if (a === "--write" || a === "-w") {
+            opts.write = true;
+            i++;
+        }
+        else if (a === "--check" || a === "-c") {
+            opts.check = true;
+            i++;
+        }
+        else if (a === "--stdio") {
+            opts.stdio = true;
+            i++;
+        }
+        else if (a === "-o" || a === "--output") {
+            const next = rest[i + 1];
+            if (!next) {
+                console.error(`floe ${command}: missing value for ${a}`);
+                process.exit(2);
+            }
+            opts.output = next;
+            i += 2;
+        }
+        else if (a === "--help" || a === "-h") {
+            opts.help = true;
+            i++;
+        }
+        else if (a === "--version" || a === "-v") {
+            opts.version = true;
+            i++;
+        }
+        else if (a.startsWith("-")) {
+            console.error(`floe ${command}: unknown option ${a}`);
+            console.error(`Run 'floe ${command} --help' for usage.`);
+            process.exit(2);
+        }
+        else {
+            files.push(a);
+            i++;
+        }
+    }
+    return { command, files, opts };
+}
+async function main() {
+    const { command, files, opts } = parseArgs(process.argv);
+    if (!command) {
+        printHelp();
+        process.exit(2);
+    }
+    if (command === "help") {
+        printHelp();
+        process.exit(0);
+    }
+    if (command === "version") {
+        printVersion();
+        process.exit(0);
+    }
+    // Allow help per command
+    if (opts.help) {
+        printHelp();
+        process.exit(0);
+    }
+    if (opts.version) {
+        printVersion();
+        process.exit(0);
+    }
+    let exitCode = 0;
+    switch (command) {
+        case "check": {
+            exitCode = runCheck(files, { json: !!opts.json, quiet: !!opts.quiet });
+            break;
+        }
+        case "format": {
+            exitCode = runFormat(files, { write: !!opts.write, check: !!opts.check, json: !!opts.json });
+            break;
+        }
+        case "render": {
+            exitCode = runRender(files, { output: opts.output, json: !!opts.json });
+            break;
+        }
+        case "lsp":
+        case "lsp-server": {
+            // Start LSP server
+            // Dynamic import to avoid loading LSP code unless needed (keeps core Node/browser separation)
+            const { startLspServer } = await import("../lsp/server.js");
+            await startLspServer({ stdio: true });
+            // startLspServer runs indefinitely until shutdown
+            return;
+        }
+        default: {
+            console.error(`floe: unknown command '${command}'`);
+            console.error("Run 'floe --help' for usage.");
+            process.exit(2);
+        }
+    }
+    process.exit(exitCode);
+}
+// Ensure unhandled errors are reported with exit 1 (no crash with empty exit)
+main().catch((e) => {
+    const msg = e instanceof Error ? e.message : String(e);
+    console.error(`floe: internal error: ${msg}`);
+    // Do not print stack for user-facing errors unless debug? Keep simple
+    if (process.env.FLOE_DEBUG)
+        console.error(e instanceof Error ? e.stack : "");
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/src/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/cli/main.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/render.d.ts

@@ -0,0 +1,7 @@
+export interface RenderOptions {
+    output?: string;
+    stdout?: boolean;
+    json?: boolean;
+}
+export declare function runRender(files: string[], opts?: RenderOptions): number;
+//# sourceMappingURL=render.d.ts.map

package/dist/src/cli/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/cli/render.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAmF3E"}

package/dist/src/cli/render.js

@@ -0,0 +1,90 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { parseFloe } from "../index.js";
+import { renderFloe } from "../pipeline.js";
+export function runRender(files, opts = {}) {
+    if (files.length === 0) {
+        console.error("floe render: no input files");
+        console.error("Usage: floe render <file.floe> [-o <output.svg>]");
+        return 2;
+    }
+    if (files.length > 1 && opts.output) {
+        console.error("floe render: -o/--output can only be used with a single input file");
+        return 2;
+    }
+    let hadErrors = false;
+    for (const f of files) {
+        const resolved = path.resolve(f);
+        if (!fs.existsSync(resolved)) {
+            console.error(`floe render: file not found: ${f}`);
+            return 2;
+        }
+        let source;
+        try {
+            source = fs.readFileSync(resolved, "utf-8");
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(`Cannot read file '${f}': ${msg}`);
+            return 2;
+        }
+        // Parse to check diagnostics but still render best-effort (per spec: never crash)
+        let svg;
+        let hasParseErrors = false;
+        try {
+            const parseResult = parseFloe(source);
+            hasParseErrors = parseResult.diagnostics.some((d) => d.severity === "error");
+            if (hasParseErrors)
+                hadErrors = true;
+            // Render via pipeline (deterministic, never throws on malformed input)
+            const result = renderFloe(source);
+            svg = result.svg;
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(`floe render: failed to render '${f}': ${msg}`);
+            return 1;
+        }
+        // Security: ensure svg is properly escaped (render already does) and not containing executable vectors
+        // We do not inject any untrusted content as raw; svg is derived via escaped paths.
+        if (opts.output) {
+            const outPath = path.resolve(opts.output);
+            try {
+                // Ensure directory exists
+                const dir = path.dirname(outPath);
+                if (!fs.existsSync(dir))
+                    fs.mkdirSync(dir, { recursive: true });
+                fs.writeFileSync(outPath, svg, "utf-8");
+                const rel = path.relative(process.cwd(), outPath);
+                if (!opts.json)
+                    console.log(`rendered ${path.relative(process.cwd(), resolved)} -> ${rel}`);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                console.error(`Cannot write output '${opts.output}': ${msg}`);
+                return 2;
+            }
+        }
+        else {
+            // stdout (scriptable)
+            // If json mode? Not needed but we support emitting svg via stdout only.
+            // Print svg to stdout; warnings to stderr
+            if (hasParseErrors && !opts.json) {
+                const rel = path.relative(process.cwd(), resolved);
+                console.error(`warning: ${rel} has parse errors, rendered best-effort SVG`);
+            }
+            process.stdout.write(svg);
+            if (!svg.endsWith("\n"))
+                process.stdout.write("\n");
+        }
+    }
+    // For CI: exit 1 if any file had parse errors? Or 0 still? Spec says appropriate exit codes and scriptable.
+    // We will exit 1 if any input had errors, to allow CI to fail on invalid diagrams, but still produce SVG.
+    // This is useful: `floe render` can be used in CI to validate rendering.
+    // If caller wants to ignore errors, they can check SVG existence anyway.
+    // We make decision: if any file had errors, exit 1, else 0. But produce SVG regardless.
+    // For scriptable use, they can do `floe render good.floe || echo failed`
+    // Document this behavior.
+    return hadErrors ? 1 : 0;
+}
+//# sourceMappingURL=render.js.map

package/dist/src/cli/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/cli/render.ts"],"names":[],"mappings":"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"}

package/dist/src/diagnostics.d.ts

@@ -0,0 +1,32 @@
+import type { Range } from "./range.js";
+/**
+ * Diagnostic severity
+ */
+export type Severity = "error" | "warning" | "info";
+/**
+ * Stable diagnostic codes
+ *
+ * E001 - invalid direction
+ * E002 - invalid identifier
+ * E003 - duplicate node declaration
+ * E004 - duplicate direction declaration
+ * E005 - malformed statement / unexpected token
+ * E006 - missing / incomplete statement
+ * E007 - invalid character
+ * E008 - invalid node type
+ * E009 - missing edge target
+ * E010 - empty label
+ * E011 - duplicate group declaration
+ * E012 - unclosed group / missing brace
+ * E013 - invalid metadata declaration
+ * E014 - invalid annotation or link (unknown target, empty text)
+ */
+export type DiagnosticCode = "E001" | "E002" | "E003" | "E004" | "E005" | "E006" | "E007" | "E008" | "E009" | "E010" | "E011" | "E012" | "E013" | "E014";
+export interface Diagnostic {
+    severity: Severity;
+    code: DiagnosticCode;
+    message: string;
+    range: Range;
+}
+export declare function diag(severity: Severity, code: DiagnosticCode, message: string, range: Range): Diagnostic;
+//# sourceMappingURL=diagnostics.d.ts.map