trace-viz 0.3.0

package/dist/schema.js

@@ -0,0 +1,131 @@
+export class GraphValidationError extends Error {
+    constructor(issues) {
+        super(`Invalid graph:\n  - ${issues.join('\n  - ')}`);
+        this.name = 'GraphValidationError';
+        this.issues = issues;
+    }
+}
+const NODE_KINDS = new Set([
+    'client',
+    'gateway',
+    'service',
+    'datastore',
+    'cache',
+    'queue',
+    'external',
+]);
+const EDGE_KINDS = new Set(['request', 'response', 'retry', 'challenge', 'async']);
+function isFiniteNumber(v) {
+    return typeof v === 'number' && Number.isFinite(v);
+}
+/**
+ * Validate and normalise a graph. Unknown fields are preserved; missing
+ * optional fields are filled with defaults so the renderer never has to
+ * branch on undefined.
+ *
+ * Throws {@link GraphValidationError} listing every problem at once, rather
+ * than failing on the first one - you usually want the whole list when a
+ * pipeline is producing the JSON.
+ */
+export function resolveGraph(input) {
+    const issues = [];
+    if (!input || typeof input !== 'object') {
+        throw new GraphValidationError(['graph must be an object']);
+    }
+    if (!Array.isArray(input.nodes))
+        issues.push('nodes must be an array');
+    if (!Array.isArray(input.edges))
+        issues.push('edges must be an array');
+    if (issues.length)
+        throw new GraphValidationError(issues);
+    const seen = new Set();
+    const nodes = [];
+    for (const [i, raw] of input.nodes.entries()) {
+        const n = raw;
+        if (!n || typeof n.id !== 'string' || n.id === '') {
+            issues.push(`nodes[${i}]: id must be a non-empty string`);
+            continue;
+        }
+        if (seen.has(n.id)) {
+            issues.push(`nodes[${i}]: duplicate id ${JSON.stringify(n.id)}`);
+            continue;
+        }
+        seen.add(n.id);
+        if (n.kind !== undefined && !NODE_KINDS.has(n.kind)) {
+            issues.push(`nodes[${i}] (${n.id}): unknown kind ${JSON.stringify(n.kind)}; expected one of ${[...NODE_KINDS].join(', ')}`);
+        }
+        nodes.push({ ...n, label: n.label ?? n.id, kind: n.kind ?? 'service' });
+    }
+    const edges = [];
+    const usedIds = new Set();
+    for (const [i, raw] of input.edges.entries()) {
+        const e = raw;
+        if (!e || typeof e !== 'object') {
+            issues.push(`edges[${i}]: must be an object`);
+            continue;
+        }
+        if (!seen.has(e.from))
+            issues.push(`edges[${i}]: unknown from-node ${JSON.stringify(e.from)}`);
+        if (!seen.has(e.to))
+            issues.push(`edges[${i}]: unknown to-node ${JSON.stringify(e.to)}`);
+        if (e.kind !== undefined && !EDGE_KINDS.has(e.kind)) {
+            issues.push(`edges[${i}]: unknown kind ${JSON.stringify(e.kind)}; expected one of ${[...EDGE_KINDS].join(', ')}`);
+        }
+        const m = e.metrics;
+        if (!m || typeof m !== 'object') {
+            issues.push(`edges[${i}] (${e.from}->${e.to}): metrics is required`);
+            continue;
+        }
+        if (!isFiniteNumber(m.rps) || m.rps < 0) {
+            issues.push(`edges[${i}] (${e.from}->${e.to}): metrics.rps must be a number >= 0`);
+        }
+        if (m.latencyMs !== undefined && (!isFiniteNumber(m.latencyMs) || m.latencyMs < 0)) {
+            issues.push(`edges[${i}] (${e.from}->${e.to}): metrics.latencyMs must be a number >= 0`);
+        }
+        if (m.errorRate !== undefined && (!isFiniteNumber(m.errorRate) || m.errorRate < 0 || m.errorRate > 1)) {
+            issues.push(`edges[${i}] (${e.from}->${e.to}): metrics.errorRate must be between 0 and 1`);
+        }
+        if (m.bytes !== undefined && (!isFiniteNumber(m.bytes) || m.bytes < 0)) {
+            issues.push(`edges[${i}] (${e.from}->${e.to}): metrics.bytes must be a number >= 0`);
+        }
+        let id = e.id ?? `${e.from}->${e.to}`;
+        if (usedIds.has(id)) {
+            let n = 2;
+            while (usedIds.has(`${id}#${n}`))
+                n++;
+            id = `${id}#${n}`;
+        }
+        usedIds.add(id);
+        edges.push({
+            ...e,
+            id,
+            kind: e.kind ?? 'request',
+            metrics: {
+                rps: m.rps,
+                latencyMs: m.latencyMs ?? 25,
+                errorRate: m.errorRate ?? 0,
+                bytes: m.bytes ?? 1024,
+            },
+        });
+    }
+    if (issues.length)
+        throw new GraphValidationError(issues);
+    return {
+        version: 1,
+        nodes,
+        edges,
+        meta: input.meta ?? {},
+    };
+}
+/** Non-throwing variant, for feeding user-supplied JSON into a UI. */
+export function safeResolveGraph(input) {
+    try {
+        return { ok: true, graph: resolveGraph(input) };
+    }
+    catch (err) {
+        if (err instanceof GraphValidationError)
+            return { ok: false, issues: err.issues };
+        return { ok: false, issues: [err.message] };
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/seed.d.ts

@@ -0,0 +1,33 @@
+import type { Graph } from './types.js';
+export interface SeedOptions {
+    /** Same seed, same graph. Always. */
+    seed?: number;
+    /** How many application services to generate between the gateway and the data tier. */
+    services?: number;
+    datastores?: number;
+    /** Roughly how many extra service-to-service calls beyond the spine. */
+    extraCalls?: number;
+    /** Baseline requests per second entering at the client. */
+    baseRps?: number;
+    /** Give a few edges a visible error rate. */
+    withErrors?: boolean;
+    title?: string;
+}
+/**
+ * Generate a plausible random topology. Deterministic for a given seed, so the
+ * README screenshots and the test fixtures never drift.
+ */
+export declare function generateSeedGraph(options?: SeedOptions): Graph;
+/**
+ * The worked example: an API whose auth is a per-request 401 challenge.
+ *
+ * Every client call costs two round trips, the second of which has to validate
+ * a password with a deliberately slow KDF, and the challenge nonce lives in a
+ * shared store that now sits on the hot path. The challenge and retry legs are
+ * tagged as such, so they render as dashed reverse lanes: visibly, half the
+ * traffic turns around before reaching the data tier.
+ */
+export declare function authChallengeScenario(clientRps?: number): Graph;
+/** The same system after the challenge is amortised into a bearer token. */
+export declare function tokenAuthScenario(clientRps?: number): Graph;
+//# sourceMappingURL=seed.d.ts.map

package/dist/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAY,KAAK,EAAkC,MAAM,YAAY,CAAC;AAElF,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,WAAgB,GAAG,KAAK,CAgGlE;AA6BD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,SAAO,GAAG,KAAK,CAiC7D;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,SAAS,SAAO,GAAG,KAAK,CA4BzD"}

package/dist/seed.js

@@ -0,0 +1,173 @@
+import { mulberry32 } from './particles.js';
+const SERVICE_NAMES = [
+    'orders', 'pricing', 'catalog', 'search', 'identity', 'payments', 'shipping',
+    'inventory', 'reviews', 'notify', 'fraud', 'ledger', 'geo', 'recs', 'billing',
+];
+const STORE_NAMES = ['orders-db', 'user-db', 'events', 'blob-store', 'ledger-db'];
+/**
+ * Generate a plausible random topology. Deterministic for a given seed, so the
+ * README screenshots and the test fixtures never drift.
+ */
+export function generateSeedGraph(options = {}) {
+    const { seed = 42, services = 6, datastores = 2, extraCalls = 4, baseRps = 4200, withErrors = true, title = 'Randomly generated topology', } = options;
+    const rand = mulberry32(seed);
+    const pick = (xs) => xs[Math.floor(rand() * xs.length)];
+    const between = (lo, hi) => lo + rand() * (hi - lo);
+    const nodes = [
+        { id: 'client', label: 'Clients', kind: 'client', layer: 0 },
+        { id: 'edge-lb', label: 'Edge LB', kind: 'gateway', layer: 1 },
+        { id: 'gateway', label: 'API gateway', kind: 'gateway', layer: 2 },
+    ];
+    const serviceIds = [];
+    const names = [...SERVICE_NAMES];
+    for (let i = 0; i < services; i++) {
+        void i;
+        const idx = Math.floor(rand() * names.length);
+        const name = names.splice(idx, 1)[0] ?? `svc-${i}`;
+        serviceIds.push(name);
+        nodes.push({ id: name, label: name, kind: 'service' });
+    }
+    const storeIds = [];
+    const stores = [...STORE_NAMES];
+    for (let i = 0; i < datastores; i++) {
+        const idx = Math.floor(rand() * stores.length);
+        const name = stores.splice(idx, 1)[0] ?? `store-${i}`;
+        storeIds.push(name);
+        nodes.push({ id: name, label: name, kind: 'datastore' });
+    }
+    nodes.push({ id: 'cache', label: 'redis', kind: 'cache' });
+    const edges = [
+        edge('client', 'edge-lb', baseRps, between(1, 3), 'request'),
+        edge('edge-lb', 'gateway', baseRps * 0.99, between(1, 4), 'request'),
+    ];
+    // Gateway fans out to services, splitting traffic unevenly (real traffic is
+    // never uniform, and a uniform picture teaches the wrong intuition).
+    const weights = serviceIds.map(() => between(0.4, 3));
+    const total = weights.reduce((a, b) => a + b, 0);
+    serviceIds.forEach((id, i) => {
+        const rps = (baseRps * 0.99 * weights[i]) / total;
+        edges.push(edge('gateway', id, rps, between(4, 60), 'request', errorFor(withErrors, rand)));
+    });
+    // Each service reads something. Stores are assigned round-robin rather than
+    // at random, so no datastore ends up orphaned with nothing pointing at it.
+    for (const [si, id] of serviceIds.entries()) {
+        const target = rand() < 0.4 ? 'cache' : (storeIds[si % storeIds.length] ?? 'cache');
+        const fanout = between(0.8, 2.6);
+        const inbound = edges.find((e) => e.to === id)?.metrics.rps ?? 100;
+        edges.push(edge(id, target, inbound * fanout, target === 'cache' ? between(0.4, 2) : between(6, 120), 'request', errorFor(withErrors, rand)));
+    }
+    // A few service-to-service calls, which is where the interesting coupling is.
+    for (let i = 0; i < extraCalls && serviceIds.length > 1; i++) {
+        const from = pick(serviceIds);
+        let to = pick(serviceIds);
+        if (to === from)
+            to = serviceIds[(serviceIds.indexOf(from) + 1) % serviceIds.length];
+        const inbound = edges.find((e) => e.to === from)?.metrics.rps ?? 80;
+        edges.push(edge(from, to, inbound * between(0.15, 0.9), between(5, 90), 'request', errorFor(withErrors, rand)));
+    }
+    // Drop anything nothing points at and that points at nothing. An orphan node
+    // is not a topology, it is a layout artefact.
+    const connected = new Set();
+    for (const e of edges) {
+        connected.add(e.from);
+        connected.add(e.to);
+    }
+    return {
+        version: 1,
+        nodes: nodes.filter((n) => connected.has(n.id)),
+        edges,
+        meta: { title, window: 'synthetic', generatedAt: new Date(0).toISOString(), seed },
+    };
+}
+function errorFor(enabled, rand) {
+    if (!enabled)
+        return 0;
+    return rand() < 0.25 ? rand() * 0.06 : rand() * 0.004;
+}
+function edge(from, to, rps, latencyMs, kind = 'request', errorRate = 0, bytes = 1400) {
+    return {
+        from,
+        to,
+        kind,
+        metrics: {
+            rps: Math.round(rps * 10) / 10,
+            latencyMs: Math.round(latencyMs * 10) / 10,
+            errorRate: Math.round(errorRate * 10000) / 10000,
+            bytes,
+        },
+    };
+}
+/**
+ * The worked example: an API whose auth is a per-request 401 challenge.
+ *
+ * Every client call costs two round trips, the second of which has to validate
+ * a password with a deliberately slow KDF, and the challenge nonce lives in a
+ * shared store that now sits on the hot path. The challenge and retry legs are
+ * tagged as such, so they render as dashed reverse lanes: visibly, half the
+ * traffic turns around before reaching the data tier.
+ */
+export function authChallengeScenario(clientRps = 5000) {
+    return {
+        version: 1,
+        nodes: [
+            { id: 'client', label: 'Clients', kind: 'client', layer: 0 },
+            { id: 'lb', label: 'Load balancer', kind: 'gateway', layer: 1 },
+            { id: 'api-1', label: 'api-1', kind: 'service', layer: 2 },
+            { id: 'api-2', label: 'api-2', kind: 'service', layer: 2 },
+            { id: 'nonce', label: 'nonce store', kind: 'cache', layer: 3 },
+            { id: 'users', label: 'user-db', kind: 'datastore', layer: 3 },
+            { id: 'orders', label: 'orders-db', kind: 'datastore', layer: 4 },
+        ],
+        edges: [
+            { from: 'client', to: 'lb', label: 'unauthenticated attempt', kind: 'request', metrics: { rps: clientRps, latencyMs: 2, bytes: 700 } },
+            { from: 'lb', to: 'api-1', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 3, bytes: 700 } },
+            { from: 'lb', to: 'api-2', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 3, bytes: 700 } },
+            { from: 'api-1', to: 'nonce', label: 'issue nonce', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 1.4, bytes: 120 } },
+            { from: 'api-2', to: 'nonce', label: 'issue nonce', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 1.4, bytes: 120 } },
+            { from: 'lb', to: 'client', label: '401 challenge', kind: 'challenge', metrics: { rps: clientRps, latencyMs: 4, bytes: 320 } },
+            { from: 'client', to: 'lb', id: 'retry', label: 'retry with credentials', kind: 'retry', metrics: { rps: clientRps, latencyMs: 2, bytes: 900 } },
+            { from: 'api-1', to: 'users', label: 'verify password (KDF)', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 82, errorRate: 0.012, bytes: 400 } },
+            { from: 'api-2', to: 'users', label: 'verify password (KDF)', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 82, errorRate: 0.012, bytes: 400 } },
+            { from: 'api-1', to: 'nonce', id: 'nonce-check-1', label: 'validate nonce (cross-node)', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 3.5, errorRate: 0.09, bytes: 120 } },
+            { from: 'api-2', to: 'nonce', id: 'nonce-check-2', label: 'validate nonce (cross-node)', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 3.5, errorRate: 0.09, bytes: 120 } },
+            { from: 'api-1', to: 'orders', label: 'actual work', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 11, bytes: 4200 } },
+            { from: 'api-2', to: 'orders', label: 'actual work', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 11, bytes: 4200 } },
+        ],
+        meta: {
+            title: 'Per-request 401 challenge',
+            window: 'modelled',
+            note: 'Every useful call costs two round trips and one password KDF.',
+        },
+    };
+}
+/** The same system after the challenge is amortised into a bearer token. */
+export function tokenAuthScenario(clientRps = 5000) {
+    const refresh = clientRps * 0.004; // one challenge per ~15 min session
+    return {
+        version: 1,
+        nodes: [
+            { id: 'client', label: 'Clients', kind: 'client', layer: 0 },
+            { id: 'lb', label: 'Load balancer', kind: 'gateway', layer: 1 },
+            { id: 'api-1', label: 'api-1', kind: 'service', layer: 2 },
+            { id: 'api-2', label: 'api-2', kind: 'service', layer: 2 },
+            { id: 'authz', label: 'token issuer', kind: 'service', layer: 3 },
+            { id: 'users', label: 'user-db', kind: 'datastore', layer: 4 },
+            { id: 'orders', label: 'orders-db', kind: 'datastore', layer: 4 },
+        ],
+        edges: [
+            { from: 'client', to: 'lb', label: 'request with bearer token', kind: 'request', metrics: { rps: clientRps, latencyMs: 2, bytes: 900 } },
+            { from: 'lb', to: 'api-1', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 3, bytes: 900 } },
+            { from: 'lb', to: 'api-2', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 3, bytes: 900 } },
+            { from: 'client', to: 'authz', label: 'token refresh (amortised)', kind: 'request', metrics: { rps: refresh, latencyMs: 95, bytes: 700 } },
+            { from: 'authz', to: 'users', label: 'verify password (KDF)', kind: 'request', metrics: { rps: refresh, latencyMs: 82, errorRate: 0.012, bytes: 400 } },
+            { from: 'api-1', to: 'orders', label: 'actual work', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 11, bytes: 4200 } },
+            { from: 'api-2', to: 'orders', label: 'actual work', kind: 'request', metrics: { rps: clientRps / 2, latencyMs: 11, bytes: 4200 } },
+        ],
+        meta: {
+            title: 'Token auth, verified in-process',
+            window: 'modelled',
+            note: 'Signature check is microseconds and touches no shared state.',
+        },
+    };
+}
+//# sourceMappingURL=seed.js.map

package/dist/seed.js.map

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

package/dist/theme.d.ts

@@ -0,0 +1,35 @@
+import type { EdgeKind, NodeKind } from './types.js';
+export interface Theme {
+    name: string;
+    background: string;
+    surface: string;
+    border: string;
+    text: string;
+    textMuted: string;
+    grid: string;
+    /** Colour of a healthy particle, per edge kind. */
+    flow: Record<EdgeKind, string>;
+    /** Node fill, per node kind. */
+    node: Record<NodeKind, string>;
+    nodeText: string;
+    edge: string;
+    edgeMuted: string;
+    error: string;
+    highlight: string;
+    tooltipBg: string;
+    tooltipText: string;
+}
+/**
+ * Two palettes, same semantics. Hues are kept distinguishable under the common
+ * forms of colour-vision deficiency: the request/retry split leans on
+ * blue-vs-amber rather than red-vs-green, and errors carry a shape cue (a
+ * hollow ring) in addition to colour.
+ */
+export declare const darkTheme: Theme;
+export declare const lightTheme: Theme;
+export declare const themes: {
+    readonly dark: Theme;
+    readonly light: Theme;
+};
+export declare function resolveTheme(t: 'auto' | 'light' | 'dark' | Theme | undefined): Theme;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,KA+BvB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KA+BxB,CAAC;AAEF,eAAO,MAAM,MAAM;;;CAAkD,CAAC;AAEtE,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAQpF"}

package/dist/theme.js

@@ -0,0 +1,83 @@
+/**
+ * Two palettes, same semantics. Hues are kept distinguishable under the common
+ * forms of colour-vision deficiency: the request/retry split leans on
+ * blue-vs-amber rather than red-vs-green, and errors carry a shape cue (a
+ * hollow ring) in addition to colour.
+ */
+export const darkTheme = {
+    name: 'dark',
+    background: '#0e1117',
+    surface: '#161b23',
+    border: '#2a323d',
+    text: '#e6edf3',
+    textMuted: '#8b98a8',
+    grid: '#1b222c',
+    flow: {
+        request: '#5aa9ff',
+        response: '#4ad6b8',
+        retry: '#ffb54d',
+        challenge: '#c58bff',
+        async: '#7f8fa6',
+    },
+    node: {
+        client: '#2d3b52',
+        gateway: '#3a3350',
+        service: '#233145',
+        datastore: '#1f3d3a',
+        cache: '#40352a',
+        queue: '#33304a',
+        external: '#2b2f36',
+    },
+    nodeText: '#e6edf3',
+    edge: '#55637a',
+    edgeMuted: '#2c3541',
+    error: '#ff6b6b',
+    highlight: '#ffffff',
+    tooltipBg: '#1c232d',
+    tooltipText: '#e6edf3',
+};
+export const lightTheme = {
+    name: 'light',
+    background: '#fbfbfd',
+    surface: '#ffffff',
+    border: '#dfe3ea',
+    text: '#1a1f27',
+    textMuted: '#616c7d',
+    grid: '#eef1f5',
+    flow: {
+        request: '#1f6feb',
+        response: '#0d9488',
+        retry: '#d97706',
+        challenge: '#8b5cf6',
+        async: '#64748b',
+    },
+    node: {
+        client: '#e7edf9',
+        gateway: '#eee9fb',
+        service: '#eaf1fb',
+        datastore: '#e4f4f0',
+        cache: '#fcf1e2',
+        queue: '#eeecfa',
+        external: '#eef0f3',
+    },
+    nodeText: '#1a1f27',
+    edge: '#9aa8ba',
+    edgeMuted: '#d5dce6',
+    error: '#dc2626',
+    highlight: '#0b1220',
+    tooltipBg: '#1c232d',
+    tooltipText: '#f5f7fa',
+};
+export const themes = { dark: darkTheme, light: lightTheme };
+export function resolveTheme(t) {
+    if (t && typeof t === 'object')
+        return t;
+    if (t === 'light')
+        return lightTheme;
+    if (t === 'dark')
+        return darkTheme;
+    const prefersDark = typeof globalThis.matchMedia === 'function' &&
+        globalThis.matchMedia('(prefers-color-scheme: dark)').matches;
+    return prefersDark ? darkTheme : lightTheme;
+}
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAuBA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAU;IAC9B,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE;QACJ,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,SAAS;QAChB,SAAS,EAAE,SAAS;QACpB,KAAK,EAAE,SAAS;KACjB;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,SAAS;QACpB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,SAAS;KACpB;IACD,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAU;IAC/B,IAAI,EAAE,OAAO;IACb,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE;QACJ,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,SAAS;QAChB,SAAS,EAAE,SAAS;QACpB,KAAK,EAAE,SAAS;KACjB;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,SAAS;QACpB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,SAAS;KACpB;IACD,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAW,CAAC;AAEtE,MAAM,UAAU,YAAY,CAAC,CAAgD;IAC3E,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,UAAU,CAAC;IACrC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACnC,MAAM,WAAW,GACf,OAAO,UAAU,CAAC,UAAU,KAAK,UAAU;QAC3C,UAAU,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,OAAO,CAAC;IAChE,OAAO,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9C,CAAC"}