loom-spec 0.1.0

package/dist/server/fileOps.js

@@ -0,0 +1,56 @@
+import { readFile, writeFile, readdir, mkdir } from "node:fs/promises";
+import { resolve, basename } from "node:path";
+function diagramsDir(loomPath) {
+    return resolve(loomPath, "diagrams");
+}
+function diagramFilePath(loomPath, id) {
+    return resolve(diagramsDir(loomPath), `${id}.flow.json`);
+}
+export async function listDiagrams(loomPath) {
+    const dir = diagramsDir(loomPath);
+    try {
+        const entries = await readdir(dir);
+        const summaries = [];
+        for (const file of entries) {
+            if (!file.endsWith(".flow.json"))
+                continue;
+            const id = basename(file, ".flow.json");
+            try {
+                const raw = await readFile(resolve(dir, file), "utf8");
+                const diagram = JSON.parse(raw);
+                summaries.push({
+                    id,
+                    title: diagram.title,
+                    description: diagram.description,
+                    nodeCount: diagram.nodes?.length ?? 0,
+                    edgeCount: diagram.edges?.length ?? 0,
+                });
+            }
+            catch {
+                // skip unreadable files; the validate step elsewhere flags them
+            }
+        }
+        return summaries.sort((a, b) => a.id.localeCompare(b.id));
+    }
+    catch (e) {
+        if (e.code === "ENOENT")
+            return [];
+        throw e;
+    }
+}
+export async function readDiagram(loomPath, id) {
+    const raw = await readFile(diagramFilePath(loomPath, id), "utf8");
+    return JSON.parse(raw);
+}
+export async function writeDiagram(loomPath, id, data, onWritten) {
+    await mkdir(diagramsDir(loomPath), { recursive: true });
+    const serialized = JSON.stringify(data, null, 2) + "\n";
+    const path = diagramFilePath(loomPath, id);
+    await writeFile(path, serialized, "utf8");
+    onWritten?.(path);
+}
+export async function readNodeTypes(loomPath) {
+    const raw = await readFile(resolve(loomPath, "node-types.json"), "utf8");
+    return JSON.parse(raw);
+}
+//# sourceMappingURL=fileOps.js.map

package/dist/server/fileOps.js.map

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

package/dist/server/findLoomRoot.d.ts

@@ -0,0 +1,9 @@
+export interface LoomRoot {
+    rootPath: string;
+    loomPath: string;
+}
+/**
+ * Walks up from `startDir` looking for a `.loom/` directory.
+ * Throws if none is found.
+ */
+export declare function findLoomRoot(startDir: string): Promise<LoomRoot>;

package/dist/server/findLoomRoot.js

@@ -0,0 +1,28 @@
+import { stat } from "node:fs/promises";
+import { resolve, dirname } from "node:path";
+/**
+ * Walks up from `startDir` looking for a `.loom/` directory.
+ * Throws if none is found.
+ */
+export async function findLoomRoot(startDir) {
+    let dir = resolve(startDir);
+    while (true) {
+        const candidate = resolve(dir, ".loom");
+        try {
+            const s = await stat(candidate);
+            if (s.isDirectory()) {
+                return { rootPath: dir, loomPath: candidate };
+            }
+        }
+        catch {
+            // not here, keep walking
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            throw new Error(`No .loom/ directory found in ${startDir} or any parent. ` +
+                `Run \`loom-spec init\` first.`);
+        }
+        dir = parent;
+    }
+}
+//# sourceMappingURL=findLoomRoot.js.map

package/dist/server/findLoomRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findLoomRoot.js","sourceRoot":"","sources":["../../src/server/findLoomRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAO7C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpB,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;YAChD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,kBAAkB;gBACxD,+BAA+B,CAClC,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/server/watch.d.ts

@@ -0,0 +1,29 @@
+import { EventEmitter } from "node:events";
+export interface LoomChangeEvent {
+    type: "diagram-changed" | "node-types-changed";
+    id?: string;
+}
+/**
+ * Watches `.loom/` for changes from external editors (humans, AI agents).
+ * Self-writes (from our own PUT endpoint) are suppressed within a short
+ * grace window so the UI doesn't react to its own edits.
+ *
+ * The watcher does not throw on startup if the target dir is missing — it
+ * just logs a warning. chokidar errors are caught and logged so a transient
+ * filesystem hiccup doesn't crash the server.
+ */
+export declare class LoomWatcher extends EventEmitter {
+    private loomPath;
+    private watcher;
+    private recentSelfWrites;
+    private static SUPPRESS_MS;
+    constructor(loomPath: string);
+    private start;
+    /**
+     * Mark a path as having been just written by us. Subsequent chokidar
+     * events on this path within the grace window are suppressed.
+     */
+    markSelfWrite(path: string): void;
+    private isSelfWrite;
+    close(): Promise<void>;
+}

package/dist/server/watch.js

@@ -0,0 +1,83 @@
+import { FSWatcher, watch as chokidarWatch } from "chokidar";
+import { EventEmitter } from "node:events";
+import { basename, resolve } from "node:path";
+/**
+ * Watches `.loom/` for changes from external editors (humans, AI agents).
+ * Self-writes (from our own PUT endpoint) are suppressed within a short
+ * grace window so the UI doesn't react to its own edits.
+ *
+ * The watcher does not throw on startup if the target dir is missing — it
+ * just logs a warning. chokidar errors are caught and logged so a transient
+ * filesystem hiccup doesn't crash the server.
+ */
+export class LoomWatcher extends EventEmitter {
+    loomPath;
+    watcher = null;
+    recentSelfWrites = new Map();
+    static SUPPRESS_MS = 1500;
+    constructor(loomPath) {
+        super();
+        this.loomPath = loomPath;
+        this.start();
+    }
+    start() {
+        try {
+            this.watcher = chokidarWatch([
+                resolve(this.loomPath, "diagrams"),
+                resolve(this.loomPath, "node-types.json"),
+            ], {
+                ignoreInitial: true,
+                awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 },
+            });
+            this.watcher.on("all", (_eventName, path) => {
+                if (this.isSelfWrite(path))
+                    return;
+                if (path.endsWith("/node-types.json")) {
+                    this.emit("change", { type: "node-types-changed" });
+                }
+                else if (path.endsWith(".flow.json")) {
+                    const id = basename(path, ".flow.json");
+                    this.emit("change", { type: "diagram-changed", id });
+                }
+            });
+            this.watcher.on("error", (err) => {
+                console.warn(`[loom-spec watcher] error: ${err.message}. ` +
+                    "Live sync may be degraded; server continues serving.");
+            });
+        }
+        catch (err) {
+            console.warn(`[loom-spec watcher] failed to start: ${err.message}. ` +
+                "Live sync disabled; server continues serving.");
+            this.watcher = null;
+        }
+    }
+    /**
+     * Mark a path as having been just written by us. Subsequent chokidar
+     * events on this path within the grace window are suppressed.
+     */
+    markSelfWrite(path) {
+        this.recentSelfWrites.set(path, Date.now());
+    }
+    isSelfWrite(path) {
+        const t = this.recentSelfWrites.get(path);
+        if (t === undefined)
+            return false;
+        if (Date.now() - t > LoomWatcher.SUPPRESS_MS) {
+            this.recentSelfWrites.delete(path);
+            return false;
+        }
+        return true;
+    }
+    async close() {
+        if (this.watcher) {
+            try {
+                await this.watcher.close();
+            }
+            catch {
+                // ignore close errors on shutdown
+            }
+            this.watcher = null;
+        }
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/server/watch.js.map

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

package/dist/types/diagram.d.ts

@@ -0,0 +1,99 @@
+/**
+ * AUTOGENERATED — do not edit.
+ * Source: schema/diagram.schema.json
+ */
+/**
+ * A node-based architecture spec file.
+ */
+export interface LoomDiagram {
+    $schema?: string;
+    version: "1";
+    /**
+     * Diagram identifier. Should match the filename without extension.
+     */
+    id: string;
+    title: string;
+    description?: string;
+    nodes: Node[];
+    edges: Edge[];
+    groups?: Group[];
+}
+export interface Node {
+    /**
+     * Unique within this diagram.
+     */
+    id: string;
+    /**
+     * References a key in node-types.json.
+     */
+    type: string;
+    label: string;
+    /**
+     * Markdown allowed.
+     */
+    description?: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    /**
+     * planned = spec exists, code does not. implemented = both present. stale = code refs are broken, needs review. deprecated = kept for history, no longer active.
+     */
+    status: "planned" | "implemented" | "stale" | "deprecated";
+    code_refs?: CodeRef[];
+    /**
+     * Custom fields defined by the node's type in node-types.json.
+     */
+    properties?: {
+        [k: string]: unknown;
+    };
+    tags?: string[];
+    /**
+     * ID of another diagram file to navigate into when this node is opened.
+     */
+    drill_down?: string;
+}
+export interface CodeRef {
+    /**
+     * Repo-relative file path.
+     */
+    path: string;
+    /**
+     * Function, class, or component name. Preferred over lines because it survives refactors.
+     */
+    symbol?: string;
+    /**
+     * Line range(s) like '1-80' or '12,45-50'. Use only when no symbol applies.
+     */
+    lines?: string;
+}
+export interface Edge {
+    id: string;
+    /**
+     * Source node id, optionally with :port-name suffix.
+     */
+    from: string;
+    /**
+     * Target node id, optionally with :port-name suffix.
+     */
+    to: string;
+    kind: "request" | "event" | "data-read" | "data-write" | "signal" | "dependency" | "control";
+    label?: string;
+    description?: string;
+    direction?: "forward" | "bidirectional";
+}
+export interface Group {
+    id: string;
+    label: string;
+    /**
+     * Node ids contained in this group.
+     */
+    children?: string[];
+    /**
+     * Group ids nested inside this group.
+     */
+    subgroups?: string[];
+    color?: string;
+    collapsed?: boolean;
+    drill_down?: string;
+}

package/dist/types/diagram.js

@@ -0,0 +1,7 @@
+/* eslint-disable */
+/**
+ * AUTOGENERATED — do not edit.
+ * Source: schema/diagram.schema.json
+ */
+export {};
+//# sourceMappingURL=diagram.js.map

package/dist/types/diagram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram.js","sourceRoot":"","sources":["../../src/types/diagram.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;GAGG"}

package/dist/types/node-types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * AUTOGENERATED — do not edit.
+ * Source: schema/node-types.schema.json
+ */
+export type Field = {
+    [k: string]: unknown;
+} & {
+    name: string;
+    type: "string" | "number" | "boolean" | "enum" | "markdown" | "code-ref" | "array";
+    required?: boolean;
+    description?: string;
+    default?: unknown;
+    /**
+     * Required when type is 'enum'.
+     */
+    values?: unknown[];
+    /**
+     * Required when type is 'array'.
+     */
+    items?: "string" | "number";
+    min?: number;
+    max?: number;
+    pattern?: string;
+    max_length?: number;
+};
+/**
+ * Defines the node type vocabulary for a project.
+ */
+export interface LoomNodeTypes {
+    $schema?: string;
+    types: {
+        [k: string]: NodeType;
+    };
+}
+export interface NodeType {
+    label: string;
+    description?: string;
+    color: string;
+    /**
+     * Lucide icon name.
+     */
+    icon?: string;
+    fields?: Field[];
+    ports?: {
+        in?: Port[];
+        out?: Port[];
+    };
+}
+export interface Port {
+    name: string;
+    /**
+     * Free-form signal type tag, e.g. 'audio', 'midi', 'http', 'control'.
+     */
+    signal?: string;
+}

package/dist/types/node-types.js

@@ -0,0 +1,7 @@
+/* eslint-disable */
+/**
+ * AUTOGENERATED — do not edit.
+ * Source: schema/node-types.schema.json
+ */
+export {};
+//# sourceMappingURL=node-types.js.map

package/dist/types/node-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-types.js","sourceRoot":"","sources":["../../src/types/node-types.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;GAGG"}

package/dist/validate.d.ts

@@ -0,0 +1,11 @@
+import type { LoomDiagram } from "./types/diagram.js";
+import type { LoomNodeTypes } from "./types/node-types.js";
+export type ValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    errors: string[];
+};
+export declare function validateDiagram(data: unknown): Promise<ValidationResult>;
+export declare function validateNodeTypes(data: unknown): Promise<ValidationResult>;
+export type { LoomDiagram, LoomNodeTypes };

package/dist/validate.js

@@ -0,0 +1,47 @@
+import Ajv from "ajv/dist/2020.js";
+import addFormats from "ajv-formats";
+import { readFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const here = dirname(fileURLToPath(import.meta.url));
+const schemaDir = resolve(here, "../schema");
+const ajv = new Ajv({ allErrors: true, strict: false });
+addFormats(ajv);
+let diagramValidator = null;
+let nodeTypesValidator = null;
+async function loadDiagramValidator() {
+    if (diagramValidator)
+        return diagramValidator;
+    const schema = JSON.parse(await readFile(resolve(schemaDir, "diagram.schema.json"), "utf8"));
+    diagramValidator = ajv.compile(schema);
+    return diagramValidator;
+}
+async function loadNodeTypesValidator() {
+    if (nodeTypesValidator)
+        return nodeTypesValidator;
+    const schema = JSON.parse(await readFile(resolve(schemaDir, "node-types.schema.json"), "utf8"));
+    nodeTypesValidator = ajv.compile(schema);
+    return nodeTypesValidator;
+}
+function formatErrors(errors) {
+    return errors.map((e) => {
+        const err = e;
+        const path = err.instancePath || "(root)";
+        return `${path}: ${err.message ?? "invalid"}`;
+    });
+}
+export async function validateDiagram(data) {
+    const validator = await loadDiagramValidator();
+    const ok = validator(data);
+    if (ok)
+        return { ok: true };
+    return { ok: false, errors: formatErrors(validator.errors ?? []) };
+}
+export async function validateNodeTypes(data) {
+    const validator = await loadNodeTypesValidator();
+    const ok = validator(data);
+    if (ok)
+        return { ok: true };
+    return { ok: false, errors: formatErrors(validator.errors ?? []) };
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,kBAAkB,CAAC;AACnC,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAE7C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AACxD,UAAU,CAAC,GAAG,CAAC,CAAC;AAEhB,IAAI,gBAAgB,GAA0C,IAAI,CAAC;AACnE,IAAI,kBAAkB,GAA0C,IAAI,CAAC;AAErE,KAAK,UAAU,oBAAoB;IACjC,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,qBAAqB,CAAC,EAAE,MAAM,CAAC,CAClE,CAAC;IACF,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,KAAK,UAAU,sBAAsB;IACnC,IAAI,kBAAkB;QAAE,OAAO,kBAAkB,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,wBAAwB,CAAC,EAAE,MAAM,CAAC,CACrE,CAAC;IACF,kBAAkB,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAMD,SAAS,YAAY,CAAC,MAAiB;IACrC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACtB,MAAM,GAAG,GAAG,CAAkE,CAAC;QAC/E,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,IAAI,QAAQ,CAAC;QAC1C,OAAO,GAAG,IAAI,KAAK,GAAG,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAa;IACjD,MAAM,SAAS,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAC/C,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAa;IACnD,MAAM,SAAS,GAAG,MAAM,sBAAsB,EAAE,CAAC;IACjD,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;AACrE,CAAC"}

package/dist/view/assets/index-Cst6HUW5.css

@@ -0,0 +1 @@
+.react-flow{direction:ltr;--xy-edge-stroke-default: #b1b1b7;--xy-edge-stroke-width-default: 1;--xy-edge-stroke-selected-default: #555;--xy-connectionline-stroke-default: #b1b1b7;--xy-connectionline-stroke-width-default: 1;--xy-attribution-background-color-default: rgba(255, 255, 255, .5);--xy-minimap-background-color-default: #fff;--xy-minimap-mask-background-color-default: rgba(240, 240, 240, .6);--xy-minimap-mask-stroke-color-default: transparent;--xy-minimap-mask-stroke-width-default: 1;--xy-minimap-node-background-color-default: #e2e2e2;--xy-minimap-node-stroke-color-default: transparent;--xy-minimap-node-stroke-width-default: 2;--xy-background-color-default: transparent;--xy-background-pattern-dots-color-default: #91919a;--xy-background-pattern-lines-color-default: #eee;--xy-background-pattern-cross-color-default: #e2e2e2;background-color:var(--xy-background-color, var(--xy-background-color-default));--xy-node-color-default: inherit;--xy-node-border-default: 1px solid #1a192b;--xy-node-background-color-default: #fff;--xy-node-group-background-color-default: rgba(240, 240, 240, .25);--xy-node-boxshadow-hover-default: 0 1px 4px 1px rgba(0, 0, 0, .08);--xy-node-boxshadow-selected-default: 0 0 0 .5px #1a192b;--xy-node-border-radius-default: 3px;--xy-handle-background-color-default: #1a192b;--xy-handle-border-color-default: #fff;--xy-selection-background-color-default: rgba(0, 89, 220, .08);--xy-selection-border-default: 1px dotted rgba(0, 89, 220, .8);--xy-controls-button-background-color-default: #fefefe;--xy-controls-button-background-color-hover-default: #f4f4f4;--xy-controls-button-color-default: inherit;--xy-controls-button-color-hover-default: inherit;--xy-controls-button-border-color-default: #eee;--xy-controls-box-shadow-default: 0 0 2px 1px rgba(0, 0, 0, .08);--xy-edge-label-background-color-default: #ffffff;--xy-edge-label-color-default: inherit;--xy-resize-background-color-default: #3367d9}.react-flow.dark{--xy-edge-stroke-default: #3e3e3e;--xy-edge-stroke-width-default: 1;--xy-edge-stroke-selected-default: #727272;--xy-connectionline-stroke-default: #b1b1b7;--xy-connectionline-stroke-width-default: 1;--xy-attribution-background-color-default: rgba(150, 150, 150, .25);--xy-minimap-background-color-default: #141414;--xy-minimap-mask-background-color-default: rgba(60, 60, 60, .6);--xy-minimap-mask-stroke-color-default: transparent;--xy-minimap-mask-stroke-width-default: 1;--xy-minimap-node-background-color-default: #2b2b2b;--xy-minimap-node-stroke-color-default: transparent;--xy-minimap-node-stroke-width-default: 2;--xy-background-color-default: #141414;--xy-background-pattern-dots-color-default: #777;--xy-background-pattern-lines-color-default: #777;--xy-background-pattern-cross-color-default: #777;--xy-node-color-default: #f8f8f8;--xy-node-border-default: 1px solid #3c3c3c;--xy-node-background-color-default: #1e1e1e;--xy-node-group-background-color-default: rgba(240, 240, 240, .25);--xy-node-boxshadow-hover-default: 0 1px 4px 1px rgba(255, 255, 255, .08);--xy-node-boxshadow-selected-default: 0 0 0 .5px #999;--xy-handle-background-color-default: #bebebe;--xy-handle-border-color-default: #1e1e1e;--xy-selection-background-color-default: rgba(200, 200, 220, .08);--xy-selection-border-default: 1px dotted rgba(200, 200, 220, .8);--xy-controls-button-background-color-default: #2b2b2b;--xy-controls-button-background-color-hover-default: #3e3e3e;--xy-controls-button-color-default: #f8f8f8;--xy-controls-button-color-hover-default: #fff;--xy-controls-button-border-color-default: #5b5b5b;--xy-controls-box-shadow-default: 0 0 2px 1px rgba(0, 0, 0, .08);--xy-edge-label-background-color-default: #141414;--xy-edge-label-color-default: #f8f8f8}.react-flow__background{background-color:var(--xy-background-color-props, var(--xy-background-color, var(--xy-background-color-default)));pointer-events:none;z-index:-1}.react-flow__container{position:absolute;width:100%;height:100%;top:0;left:0}.react-flow__pane{z-index:1}.react-flow__pane.draggable{cursor:grab}.react-flow__pane.dragging{cursor:grabbing}.react-flow__pane.selection{cursor:pointer}.react-flow__viewport{transform-origin:0 0;z-index:2;pointer-events:none}.react-flow__renderer{z-index:4}.react-flow__selection{z-index:6}.react-flow__nodesselection-rect:focus,.react-flow__nodesselection-rect:focus-visible{outline:none}.react-flow__edge-path{stroke:var(--xy-edge-stroke, var(--xy-edge-stroke-default));stroke-width:var(--xy-edge-stroke-width, var(--xy-edge-stroke-width-default));fill:none}.react-flow__connection-path{stroke:var(--xy-connectionline-stroke, var(--xy-connectionline-stroke-default));stroke-width:var(--xy-connectionline-stroke-width, var(--xy-connectionline-stroke-width-default));fill:none}.react-flow .react-flow__edges{position:absolute}.react-flow .react-flow__edges svg{overflow:visible;position:absolute;pointer-events:none}.react-flow__edge{pointer-events:visibleStroke}.react-flow__edge.selectable{cursor:pointer}.react-flow__edge.animated path{stroke-dasharray:5;animation:dashdraw .5s linear infinite}.react-flow__edge.animated path.react-flow__edge-interaction{stroke-dasharray:none;animation:none}.react-flow__edge.inactive{pointer-events:none}.react-flow__edge.selected,.react-flow__edge:focus,.react-flow__edge:focus-visible{outline:none}.react-flow__edge.selected .react-flow__edge-path,.react-flow__edge.selectable:focus .react-flow__edge-path,.react-flow__edge.selectable:focus-visible .react-flow__edge-path{stroke:var(--xy-edge-stroke-selected, var(--xy-edge-stroke-selected-default))}.react-flow__edge-textwrapper{pointer-events:all}.react-flow__edge .react-flow__edge-text{pointer-events:none;-webkit-user-select:none;-moz-user-select:none;user-select:none}.react-flow__arrowhead polyline{stroke:var(--xy-edge-stroke, var(--xy-edge-stroke-default))}.react-flow__arrowhead polyline.arrowclosed{fill:var(--xy-edge-stroke, var(--xy-edge-stroke-default))}.react-flow__connection{pointer-events:none}.react-flow__connection .animated{stroke-dasharray:5;animation:dashdraw .5s linear infinite}svg.react-flow__connectionline{z-index:1001;overflow:visible;position:absolute}.react-flow__nodes{pointer-events:none;transform-origin:0 0}.react-flow__node{position:absolute;-webkit-user-select:none;-moz-user-select:none;user-select:none;pointer-events:all;transform-origin:0 0;box-sizing:border-box;cursor:default}.react-flow__node.selectable{cursor:pointer}.react-flow__node.draggable{cursor:grab;pointer-events:all}.react-flow__node.draggable.dragging{cursor:grabbing}.react-flow__nodesselection{z-index:3;transform-origin:left top;pointer-events:none}.react-flow__nodesselection-rect{position:absolute;pointer-events:all;cursor:grab}.react-flow__handle{position:absolute;pointer-events:none;min-width:5px;min-height:5px;width:6px;height:6px;background-color:var(--xy-handle-background-color, var(--xy-handle-background-color-default));border:1px solid var(--xy-handle-border-color, var(--xy-handle-border-color-default));border-radius:100%}.react-flow__handle.connectingfrom{pointer-events:all}.react-flow__handle.connectionindicator{pointer-events:all;cursor:crosshair}.react-flow__handle-bottom{top:auto;left:50%;bottom:0;transform:translate(-50%,50%)}.react-flow__handle-top{top:0;left:50%;transform:translate(-50%,-50%)}.react-flow__handle-left{top:50%;left:0;transform:translate(-50%,-50%)}.react-flow__handle-right{top:50%;right:0;transform:translate(50%,-50%)}.react-flow__edgeupdater{cursor:move;pointer-events:all}.react-flow__pane.selection .react-flow__panel{pointer-events:none}.react-flow__panel{position:absolute;z-index:5;margin:15px}.react-flow__panel.top{top:0}.react-flow__panel.bottom{bottom:0}.react-flow__panel.top.center,.react-flow__panel.bottom.center{left:50%;transform:translate(-15px) translate(-50%)}.react-flow__panel.left{left:0}.react-flow__panel.right{right:0}.react-flow__panel.left.center,.react-flow__panel.right.center{top:50%;transform:translateY(-15px) translateY(-50%)}.react-flow__attribution{font-size:10px;background:var(--xy-attribution-background-color, var(--xy-attribution-background-color-default));padding:2px 3px;margin:0}.react-flow__attribution a{text-decoration:none;color:#999}@keyframes dashdraw{0%{stroke-dashoffset:10}}.react-flow__edgelabel-renderer{position:absolute;width:100%;height:100%;pointer-events:none;-webkit-user-select:none;-moz-user-select:none;user-select:none;left:0;top:0}.react-flow__viewport-portal{position:absolute;width:100%;height:100%;left:0;top:0;-webkit-user-select:none;-moz-user-select:none;user-select:none}.react-flow__minimap{background:var( --xy-minimap-background-color-props, var(--xy-minimap-background-color, var(--xy-minimap-background-color-default)) )}.react-flow__minimap-svg{display:block}.react-flow__minimap-mask{fill:var( --xy-minimap-mask-background-color-props, var(--xy-minimap-mask-background-color, var(--xy-minimap-mask-background-color-default)) );stroke:var( --xy-minimap-mask-stroke-color-props, var(--xy-minimap-mask-stroke-color, var(--xy-minimap-mask-stroke-color-default)) );stroke-width:var( --xy-minimap-mask-stroke-width-props, var(--xy-minimap-mask-stroke-width, var(--xy-minimap-mask-stroke-width-default)) )}.react-flow__minimap-node{fill:var( --xy-minimap-node-background-color-props, var(--xy-minimap-node-background-color, var(--xy-minimap-node-background-color-default)) );stroke:var( --xy-minimap-node-stroke-color-props, var(--xy-minimap-node-stroke-color, var(--xy-minimap-node-stroke-color-default)) );stroke-width:var( --xy-minimap-node-stroke-width-props, var(--xy-minimap-node-stroke-width, var(--xy-minimap-node-stroke-width-default)) )}.react-flow__background-pattern.dots{fill:var( --xy-background-pattern-color-props, var(--xy-background-pattern-color, var(--xy-background-pattern-dots-color-default)) )}.react-flow__background-pattern.lines{stroke:var( --xy-background-pattern-color-props, var(--xy-background-pattern-color, var(--xy-background-pattern-lines-color-default)) )}.react-flow__background-pattern.cross{stroke:var( --xy-background-pattern-color-props, var(--xy-background-pattern-color, var(--xy-background-pattern-cross-color-default)) )}.react-flow__controls{display:flex;flex-direction:column;box-shadow:var(--xy-controls-box-shadow, var(--xy-controls-box-shadow-default))}.react-flow__controls.horizontal{flex-direction:row}.react-flow__controls-button{display:flex;justify-content:center;align-items:center;height:26px;width:26px;padding:4px;border:none;background:var(--xy-controls-button-background-color, var(--xy-controls-button-background-color-default));border-bottom:1px solid var( --xy-controls-button-border-color-props, var(--xy-controls-button-border-color, var(--xy-controls-button-border-color-default)) );color:var( --xy-controls-button-color-props, var(--xy-controls-button-color, var(--xy-controls-button-color-default)) );cursor:pointer;-webkit-user-select:none;-moz-user-select:none;user-select:none}.react-flow__controls-button svg{width:100%;max-width:12px;max-height:12px;fill:currentColor}.react-flow__edge.updating .react-flow__edge-path{stroke:#777}.react-flow__edge-text{font-size:10px}.react-flow__node.selectable:focus,.react-flow__node.selectable:focus-visible{outline:none}.react-flow__node-input,.react-flow__node-default,.react-flow__node-output,.react-flow__node-group{padding:10px;border-radius:var(--xy-node-border-radius, var(--xy-node-border-radius-default));width:150px;font-size:12px;color:var(--xy-node-color, var(--xy-node-color-default));text-align:center;border:var(--xy-node-border, var(--xy-node-border-default));background-color:var(--xy-node-background-color, var(--xy-node-background-color-default))}.react-flow__node-input.selectable:hover,.react-flow__node-default.selectable:hover,.react-flow__node-output.selectable:hover,.react-flow__node-group.selectable:hover{box-shadow:var(--xy-node-boxshadow-hover, var(--xy-node-boxshadow-hover-default))}.react-flow__node-input.selectable.selected,.react-flow__node-input.selectable:focus,.react-flow__node-input.selectable:focus-visible,.react-flow__node-default.selectable.selected,.react-flow__node-default.selectable:focus,.react-flow__node-default.selectable:focus-visible,.react-flow__node-output.selectable.selected,.react-flow__node-output.selectable:focus,.react-flow__node-output.selectable:focus-visible,.react-flow__node-group.selectable.selected,.react-flow__node-group.selectable:focus,.react-flow__node-group.selectable:focus-visible{box-shadow:var(--xy-node-boxshadow-selected, var(--xy-node-boxshadow-selected-default))}.react-flow__node-group{background-color:var(--xy-node-group-background-color, var(--xy-node-group-background-color-default))}.react-flow__nodesselection-rect,.react-flow__selection{background:var(--xy-selection-background-color, var(--xy-selection-background-color-default));border:var(--xy-selection-border, var(--xy-selection-border-default))}.react-flow__nodesselection-rect:focus,.react-flow__nodesselection-rect:focus-visible,.react-flow__selection:focus,.react-flow__selection:focus-visible{outline:none}.react-flow__controls-button:hover{background:var( --xy-controls-button-background-color-hover-props, var(--xy-controls-button-background-color-hover, var(--xy-controls-button-background-color-hover-default)) );color:var( --xy-controls-button-color-hover-props, var(--xy-controls-button-color-hover, var(--xy-controls-button-color-hover-default)) )}.react-flow__controls-button:disabled{pointer-events:none}.react-flow__controls-button:disabled svg{fill-opacity:.4}.react-flow__controls-button:last-child{border-bottom:none}.react-flow__controls.horizontal .react-flow__controls-button{border-bottom:none;border-right:1px solid var( --xy-controls-button-border-color-props, var(--xy-controls-button-border-color, var(--xy-controls-button-border-color-default)) )}.react-flow__controls.horizontal .react-flow__controls-button:last-child{border-right:none}.react-flow__resize-control{position:absolute}.react-flow__resize-control.left,.react-flow__resize-control.right{cursor:ew-resize}.react-flow__resize-control.top,.react-flow__resize-control.bottom{cursor:ns-resize}.react-flow__resize-control.top.left,.react-flow__resize-control.bottom.right{cursor:nwse-resize}.react-flow__resize-control.bottom.left,.react-flow__resize-control.top.right{cursor:nesw-resize}.react-flow__resize-control.handle{width:5px;height:5px;border:1px solid #fff;border-radius:1px;background-color:var(--xy-resize-background-color, var(--xy-resize-background-color-default));translate:-50% -50%}.react-flow__resize-control.handle.left{left:0;top:50%}.react-flow__resize-control.handle.right{left:100%;top:50%}.react-flow__resize-control.handle.top{left:50%;top:0}.react-flow__resize-control.handle.bottom{left:50%;top:100%}.react-flow__resize-control.handle.top.left,.react-flow__resize-control.handle.bottom.left{left:0}.react-flow__resize-control.handle.top.right,.react-flow__resize-control.handle.bottom.right{left:100%}.react-flow__resize-control.line{border-color:var(--xy-resize-background-color, var(--xy-resize-background-color-default));border-width:0;border-style:solid}.react-flow__resize-control.line.left,.react-flow__resize-control.line.right{width:1px;transform:translate(-50%);top:0;height:100%}.react-flow__resize-control.line.left{left:0;border-left-width:1px}.react-flow__resize-control.line.right{left:100%;border-right-width:1px}.react-flow__resize-control.line.top,.react-flow__resize-control.line.bottom{height:1px;transform:translateY(-50%);left:0;width:100%}.react-flow__resize-control.line.top{top:0;border-top-width:1px}.react-flow__resize-control.line.bottom{border-bottom-width:1px;top:100%}.react-flow__edge-textbg{fill:var(--xy-edge-label-background-color, var(--xy-edge-label-background-color-default))}.react-flow__edge-text{fill:var(--xy-edge-label-color, var(--xy-edge-label-color-default))}:root[data-theme=light]{--bg: #fafafa;--bg-elevated: #ffffff;--bg-canvas: #f4f4f5;--bg-hover: #f4f4f5;--text: #18181b;--text-muted: #71717a;--text-subtle: #a1a1aa;--border: #e4e4e7;--border-strong: #d4d4d8;--accent: #6366f1;--accent-fg: #ffffff;--shadow: 0 1px 2px rgba(0,0,0,.04), 0 4px 12px rgba(0,0,0,.04);--grid-dot: #d4d4d8}:root[data-theme=dark]{--bg: #0a0a0a;--bg-elevated: #18181b;--bg-canvas: #09090b;--bg-hover: #27272a;--text: #fafafa;--text-muted: #a1a1aa;--text-subtle: #71717a;--border: #27272a;--border-strong: #3f3f46;--accent: #818cf8;--accent-fg: #0a0a0a;--shadow: 0 1px 2px rgba(0,0,0,.4), 0 4px 12px rgba(0,0,0,.3);--grid-dot: #3f3f46}:root{--status-planned: #f59e0b;--status-implemented: #10b981;--status-stale: #ef4444;--status-deprecated: #71717a;--edge-request: #6366f1;--edge-event: #f59e0b;--edge-data-read: #06b6d4;--edge-data-write: #a855f7;--edge-signal: #ec4899;--edge-dependency: #71717a;--edge-control: #10b981}*{box-sizing:border-box}html,body,#root{margin:0;height:100%;width:100%;background:var(--bg);color:var(--text);font-family:-apple-system,BlinkMacSystemFont,Inter,Segoe UI,sans-serif;font-size:14px;line-height:1.5;-webkit-font-smoothing:antialiased;transition:background-color .15s,color .15s}button{font-family:inherit;font-size:inherit;cursor:pointer;border:1px solid var(--border);background:var(--bg-elevated);color:var(--text);padding:6px 10px;border-radius:6px;display:inline-flex;align-items:center;gap:6px;transition:background-color .1s,border-color .1s}button:hover{background:var(--bg-hover);border-color:var(--border-strong)}code,pre{font-family:ui-monospace,SF Mono,Menlo,monospace;font-size:12px}.app{display:grid;grid-template-rows:auto 1fr;grid-template-columns:1fr 320px;grid-template-areas:"topbar topbar" "canvas inspector";height:100vh}.topbar{grid-area:topbar;height:48px;border-bottom:1px solid var(--border);background:var(--bg-elevated);display:flex;align-items:center;padding:0 16px;gap:12px}.topbar .title{font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;flex-shrink:0}.breadcrumb-back{background:transparent;border:1px solid transparent;color:var(--text-muted);padding:4px 8px 4px 4px;font-size:13px}.breadcrumb-back:hover{background:var(--bg-canvas);border-color:var(--border);color:var(--text)}.topbar .subtitle{color:var(--text-muted);font-size:13px;flex:1;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;min-width:0}.canvas-wrap{grid-area:canvas;position:relative;background:var(--bg-canvas);overflow:hidden}.inspector{grid-area:inspector;border-left:1px solid var(--border);background:var(--bg-elevated);overflow-y:auto;padding:16px}.inspector .empty{color:var(--text-muted);font-style:italic;padding:20px 0;text-align:center}.inspector h2{margin:0 0 4px;font-size:16px}.inspector .type-tag{display:inline-block;font-size:11px;font-weight:600;text-transform:uppercase;letter-spacing:.05em;padding:2px 8px;border-radius:4px;margin-bottom:12px}.inspector .field{margin:12px 0}.inspector .field-label{font-size:11px;font-weight:600;text-transform:uppercase;letter-spacing:.05em;color:var(--text-muted);margin-bottom:4px}.inspector .field-value{color:var(--text)}.inspector .field-value.muted{color:var(--text-muted);font-style:italic}.inspector .code-ref{font-family:ui-monospace,monospace;font-size:12px;padding:4px 8px;background:var(--bg-canvas);border:1px solid var(--border);border-radius:4px;margin-top:4px;word-break:break-all}.inspector .tag{display:inline-flex;align-items:center;gap:4px;font-size:11px;padding:2px 4px 2px 6px;background:var(--bg-canvas);border:1px solid var(--border);border-radius:3px;margin-right:4px;margin-bottom:4px;color:var(--text)}.inspector .tag-x{display:inline-flex;align-items:center;justify-content:center;background:transparent;border:none;padding:0;color:var(--text-muted);cursor:pointer}.inspector .tag-x:hover{color:var(--status-stale)}.code-ref-row{display:grid;grid-template-columns:1fr 80px 60px 22px;gap:4px;margin-bottom:4px;align-items:center}.code-ref-row .input.small,.code-ref-row .input{padding:4px 6px;font-family:ui-monospace,SF Mono,Menlo,monospace;font-size:11px}.row-delete{width:22px;height:22px;padding:0;background:transparent;border:1px solid var(--border);border-radius:4px;color:var(--text-muted);display:inline-flex;align-items:center;justify-content:center}.row-delete:hover{color:var(--status-stale);border-color:var(--status-stale)}.add-row{background:transparent;border:1px dashed var(--border);color:var(--text-muted);width:100%;margin-top:4px;padding:6px;font-size:12px;display:flex;align-items:center;justify-content:center;gap:6px}.add-row:hover{color:var(--accent);border-color:var(--accent)}.tag-chips{margin-bottom:6px;min-height:1px}.input{width:100%;background:var(--bg-canvas);color:var(--text);border:1px solid var(--border);border-radius:5px;padding:6px 8px;font-family:inherit;font-size:13px;outline:none;transition:border-color .1s,box-shadow .1s}.input:focus{border-color:var(--accent);box-shadow:0 0 0 2px color-mix(in oklab,var(--accent) 25%,transparent)}.input.textarea{resize:vertical;min-height:56px;font-family:inherit;line-height:1.4}.status-line{height:2px;margin-top:6px;border-radius:2px}.save-indicator{display:inline-flex;align-items:center;gap:4px;font-size:12px;padding:3px 8px;border-radius:4px;font-weight:500}.save-indicator.dirty{color:var(--text-muted);background:var(--bg-canvas)}.save-indicator.saving{color:var(--accent);background:color-mix(in oklab,var(--accent) 15%,transparent)}.save-indicator.saved{color:var(--status-implemented);background:color-mix(in oklab,var(--status-implemented) 15%,transparent)}.save-indicator.error{color:var(--status-stale);background:color-mix(in oklab,var(--status-stale) 15%,transparent)}.conn-dot{display:inline-flex;align-items:center;justify-content:center;width:24px;height:24px;border-radius:4px}.conn-dot.connected{color:var(--status-implemented)}.conn-dot.connecting{color:var(--text-muted)}.conn-dot.disconnected{color:var(--status-stale)}.validation-chip{display:inline-flex;align-items:center;gap:4px;font-size:12px;font-weight:500;padding:3px 8px;border-radius:4px;color:var(--status-stale);background:color-mix(in oklab,var(--status-stale) 15%,transparent)}.field-error{color:var(--status-stale);font-size:11px;margin-top:4px;line-height:1.3}.spin{animation:spin 1s linear infinite}@keyframes spin{to{transform:rotate(360deg)}}.add-node-menu{position:fixed;z-index:100;background:var(--bg-elevated);border:1px solid var(--border);border-radius:8px;box-shadow:var(--shadow);padding:6px;min-width:220px}.add-node-menu-title{font-size:11px;font-weight:600;text-transform:uppercase;letter-spacing:.05em;color:var(--text-muted);padding:6px 8px 4px}.add-node-item{display:flex;align-items:center;gap:10px;width:100%;padding:8px;border:none;background:transparent;text-align:left;border-radius:5px;cursor:pointer;color:var(--text)}.add-node-item:hover{background:var(--bg-hover)}.add-node-color{width:10px;height:10px;border-radius:50%;background:var(--node-color);flex-shrink:0}.add-node-text{display:flex;flex-direction:column;gap:2px}.add-node-label{font-size:13px;font-weight:500}.add-node-key{font-size:11px;color:var(--text-muted)}.diagram-switcher{position:relative;flex-shrink:0}.switcher-trigger{background:transparent;border:1px solid transparent;padding:4px 6px 4px 8px;display:inline-flex;align-items:center;gap:6px;font-weight:600;color:var(--text);border-radius:6px;max-width:320px}.switcher-trigger:hover{background:var(--bg-canvas);border-color:var(--border)}.switcher-trigger .switcher-title{white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:280px}.switcher-trigger .flip{transform:rotate(180deg)}.switcher-menu{position:absolute;top:100%;left:0;margin-top:6px;z-index:100;background:var(--bg-elevated);border:1px solid var(--border);border-radius:8px;box-shadow:var(--shadow);padding:6px;min-width:280px;max-width:380px;max-height:70vh;overflow-y:auto}.switcher-empty{padding:12px;color:var(--text-muted);font-style:italic;font-size:13px}.switcher-item{display:flex;align-items:center;gap:10px;width:100%;padding:8px;border:none;background:transparent;text-align:left;border-radius:5px;cursor:pointer;color:var(--text);font-weight:400}.switcher-item:hover{background:var(--bg-hover)}.switcher-item.active{background:color-mix(in oklab,var(--accent) 14%,transparent)}.switcher-item.active .switcher-item-title{color:var(--accent)}.switcher-item-icon{color:var(--text-muted);flex-shrink:0}.switcher-item-text{display:flex;flex-direction:column;gap:2px;min-width:0;flex:1}.switcher-item-title{font-size:13px;font-weight:500;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.switcher-item-meta{font-size:11px;color:var(--text-muted);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.switcher-item-meta code{font-size:11px}.switcher-divider{height:1px;background:var(--border);margin:6px 0}.switcher-item.new{color:var(--accent);font-weight:500}.node-card{background:var(--bg-elevated);border:2px solid var(--node-color, var(--border));border-radius:8px;min-width:180px;padding:10px 12px;box-shadow:var(--shadow);position:relative}.node-card.status-planned{border-style:dashed;opacity:.85}.node-card.status-stale{border-color:var(--status-stale)}.node-card.status-deprecated{opacity:.5}.node-card .node-header{display:flex;align-items:center;gap:6px;margin-bottom:4px}.node-card .node-icon{width:14px;height:14px;color:var(--node-color);flex-shrink:0}.node-card .node-type{font-size:10px;font-weight:600;text-transform:uppercase;letter-spacing:.05em;color:var(--text-muted)}.node-card .node-label{font-weight:600;font-size:14px;color:var(--text);line-height:1.3}.node-card .status-dot{position:absolute;top:8px;right:8px;width:8px;height:8px;border-radius:50%;background:var(--status-color, var(--text-subtle))}.node-card .refs-badge{position:absolute;bottom:6px;left:8px;display:inline-flex;align-items:center;gap:3px;font-size:10px;font-weight:500;color:var(--text-muted);background:var(--bg-canvas);border:1px solid var(--border);border-radius:3px;padding:1px 5px 1px 4px;font-family:ui-monospace,monospace;line-height:1.2;pointer-events:auto;white-space:pre}.node-card .refs-badge:hover{color:var(--text);border-color:var(--border-strong)}.drill-down-btn{position:absolute;bottom:6px;right:6px;width:20px;height:20px;padding:0;display:inline-flex;align-items:center;justify-content:center;background:var(--bg-canvas);color:var(--text-muted);border:1px solid var(--border);border-radius:4px;cursor:pointer;transition:background-color .1s,color .1s,border-color .1s}.drill-down-btn:hover{background:var(--node-color, var(--accent));color:var(--accent-fg);border-color:var(--node-color, var(--accent))}.drill-down-btn.inline{position:static;width:16px;height:16px;margin-left:6px;vertical-align:middle}.drill-down-btn.inline:hover{background:var(--group-color, var(--accent));border-color:var(--group-color, var(--accent))}.group-frame{position:relative;border:1.5px dashed color-mix(in oklab,var(--group-color) 70%,var(--text-subtle));border-radius:12px;background:color-mix(in oklab,var(--group-color) 15%,transparent);pointer-events:none}.group-label{position:absolute;top:-10px;left:12px;padding:1px 8px;background:var(--bg-elevated);border:1px solid color-mix(in oklab,var(--group-color) 60%,var(--border));border-radius:4px;font-size:11px;font-weight:600;color:var(--text);text-transform:uppercase;letter-spacing:.04em;pointer-events:auto;white-space:nowrap}.react-flow__handle{background:var(--node-color, var(--accent));border:2px solid var(--bg-elevated);width:10px;height:10px}.node-card.has-ports{padding-top:14px;padding-bottom:14px;min-width:220px}.port-row{position:absolute;display:flex;align-items:center;gap:6px;transform:translateY(-50%);pointer-events:none}.port-row .react-flow__handle{pointer-events:all;position:static!important;transform:none!important}.port-in{left:-5px}.port-out{right:-5px;flex-direction:row}.port-label{font-size:10px;color:var(--text-muted);font-family:ui-monospace,monospace;background:var(--bg-elevated);padding:1px 4px;border-radius:2px;white-space:nowrap}.port-in .port-label{margin-left:4px}.port-out .port-label{margin-right:4px}.react-flow{background:var(--bg-canvas)}.react-flow__background{background-color:var(--bg-canvas)}.react-flow__controls{background:var(--bg-elevated);border:1px solid var(--border);border-radius:6px;overflow:hidden}.react-flow__controls-button{background:var(--bg-elevated);border-bottom:1px solid var(--border);color:var(--text)}.react-flow__controls-button:hover{background:var(--bg-hover)}.react-flow__controls-button svg{fill:currentColor}.react-flow__edge-text{fill:var(--text-muted);font-size:11px}.react-flow__edge-textbg{fill:var(--bg-elevated)}