trace-viz 0.3.0

package/dist/project.js

@@ -0,0 +1,288 @@
+import { endpointDims, } from './model.js';
+/** Channels that describe one edge, so binding a dimension to one must split edges by it. */
+const EDGE_CHANNELS = new Set(['hue', 'glyph', 'dash', 'lane', 'coupling', 'density', 'speed', 'radius']);
+export function nodeIdFor(dims, nodeKey) {
+    return nodeKey.map((k) => dims[k] ?? '∅').join(' / ');
+}
+/** Does this endpoint fall inside the focus? */
+function inFocus(dims, focus) {
+    if (!focus)
+        return false;
+    return Object.entries(focus.match).every(([k, v]) => dims[k] === v);
+}
+/**
+ * Roll a flow table up into a drawable scene.
+ *
+ * Two things happen that are easy to miss and matter a lot:
+ *
+ * 1. Binding a *dimension* to any per-edge channel adds it to `splitBy`, so the
+ *    edges are grouped by it rather than averaged over it. Colouring by region
+ *    therefore turns one edge into two lanes, one per region - which is the
+ *    honest picture. Averaging a dimension you are also encoding would draw a
+ *    colour that describes nothing.
+ * 2. Measures aggregate differently by kind: throughput sums, everything else
+ *    is a throughput-weighted mean. A 10k rps hop at 2ms and a 1 rps hop at 900ms
+ *    do not average to 451ms.
+ */
+export function project(table, spec) {
+    const nodeKey = spec.nodeKey.length ? spec.nodeKey : ['service'];
+    const splitBy = new Set();
+    for (const [channel, binding] of Object.entries(spec.channels ?? {})) {
+        if (!EDGE_CHANNELS.has(channel))
+            continue;
+        // Only dimensions split; measures are aggregated numbers.
+        if (!isMeasure(binding.field))
+            splitBy.add(binding.field);
+    }
+    for (const k of nodeKey)
+        splitBy.delete(k);
+    const split = [...splitBy];
+    let matched = 0;
+    let filtered = 0;
+    const nodes = new Map();
+    const edges = new Map();
+    for (const record of table.records) {
+        if (!passes(record, spec.where)) {
+            filtered++;
+            continue;
+        }
+        matched++;
+        const fromDims = endpointDims(record, 'from');
+        const toDims = endpointDims(record, 'to');
+        // Focus expands the key locally, so one service can show its APIs while
+        // every other service stays a single box.
+        const fromKey = inFocus(fromDims, spec.focus) ? [...nodeKey, ...spec.focus.expandBy] : nodeKey;
+        const toKey = inFocus(toDims, spec.focus) ? [...nodeKey, ...spec.focus.expandBy] : nodeKey;
+        const fromId = nodeIdFor(fromDims, fromKey);
+        const toId = nodeIdFor(toDims, toKey);
+        const rps = Math.max(record.metrics.rps, 0);
+        touchNode(nodes, fromId, fromDims, fromKey, record, { outbound: rps });
+        touchNode(nodes, toId, toDims, toKey, record, { inbound: rps });
+        if (spec.dropSelfEdges && fromId === toId)
+            continue;
+        const laneDims = {};
+        for (const d of split) {
+            const v = record.dims?.[d] ?? record.from[d] ?? record.to[d];
+            if (v !== undefined)
+                laneDims[d] = v;
+        }
+        const edgeId = [fromId, '→', toId, ...split.map((d) => laneDims[d] ?? '∅')].join('|');
+        let edge = edges.get(edgeId);
+        if (!edge) {
+            edges.set(edgeId, (edge = {
+                id: edgeId,
+                from: fromId,
+                to: toId,
+                dims: laneDims,
+                spans: {},
+                rps: 0,
+                latencyWeighted: 0,
+                errorWeighted: 0,
+                bytesWeighted: 0,
+                records: 0,
+            }));
+        }
+        edge.rps += rps;
+        edge.latencyWeighted += (record.metrics.latencyMs ?? 25) * rps;
+        edge.errorWeighted += (record.metrics.errorRate ?? 0) * rps;
+        edge.bytesWeighted += (record.metrics.bytes ?? 1024) * rps;
+        edge.records++;
+        collectSpans(edge.spans, { ...record.dims, ...record.from }, split, nodeKey);
+        collectSpans(edge.spans, { ...record.dims, ...record.to }, split, nodeKey);
+    }
+    const sceneNodes = [...nodes.values()].map((n) => ({
+        id: n.id,
+        label: n.label,
+        ...(n.sublabel ? { sublabel: n.sublabel } : {}),
+        kind: n.kind,
+        key: n.key,
+        spans: sortSpans(n.spans),
+        inboundRps: n.inbound,
+        outboundRps: n.outbound,
+        attrs: {},
+        records: n.records,
+    }));
+    attachFacts(sceneNodes, table.nodes ?? []);
+    // Error rate is measured on flows, but "how badly is this thing failing" is
+    // a question about a node: the rps-weighted error rate of what it serves.
+    // Exposed as a node attribute so halo (or anything else) can bind to it.
+    const errWeighted = new Map();
+    for (const e of edges.values()) {
+        const acc = errWeighted.get(e.to) ?? { err: 0, rps: 0 };
+        acc.err += e.errorWeighted;
+        acc.rps += e.rps;
+        errWeighted.set(e.to, acc);
+    }
+    for (const n of sceneNodes) {
+        const acc = errWeighted.get(n.id);
+        n.attrs.errorRate = acc && acc.rps > 0 ? round(acc.err / acc.rps, 5) : 0;
+    }
+    // Infer a role for anything the data did not label, so the palette still
+    // distinguishes a client from a datastore after an arbitrary projection.
+    for (const n of sceneNodes) {
+        if (n.kind !== 'service')
+            continue;
+        if (n.inboundRps === 0 && n.outboundRps > 0)
+            n.kind = 'client';
+        else if (n.outboundRps === 0 && n.inboundRps > 0)
+            n.kind = 'datastore';
+    }
+    const outboundOf = new Map();
+    for (const e of edges.values())
+        outboundOf.set(e.from, (outboundOf.get(e.from) ?? 0) + e.rps);
+    const sceneEdges = [...edges.values()].map((e) => ({
+        id: e.id,
+        from: e.from,
+        to: e.to,
+        kind: edgeKindOf(e.dims),
+        dims: e.dims,
+        spans: sortSpans(e.spans),
+        metrics: {
+            rps: round(e.rps, 2),
+            latencyMs: e.rps > 0 ? round(e.latencyWeighted / e.rps, 2) : 0,
+            errorRate: e.rps > 0 ? round(e.errorWeighted / e.rps, 5) : 0,
+            bytes: e.rps > 0 ? Math.round(e.bytesWeighted / e.rps) : 0,
+            share: (outboundOf.get(e.from) ?? 0) > 0 ? round(e.rps / outboundOf.get(e.from), 4) : 0,
+        },
+        records: e.records,
+        ...(labelFor(e.dims, split) ? { label: labelFor(e.dims, split) } : {}),
+    }));
+    return {
+        scene: {
+            nodes: sceneNodes,
+            edges: sceneEdges,
+            meta: { ...table.meta, ...(spec.title ? { title: spec.title } : {}) },
+            nodeKey,
+        },
+        splitBy: split,
+        matched,
+        filtered,
+    };
+}
+/**
+ * Attach per-thing facts to whichever nodes they belong to.
+ *
+ * A fact keyed `{ service: 'orders' }` attaches to the single `orders` node at
+ * service resolution, and to every `orders / <api>` node when the projection is
+ * finer. Counts sum, everything else is an instance-weighted mean - averaging
+ * CPU across twelve pods and one pod without weighting is how dashboards lie.
+ */
+function attachFacts(nodes, facts) {
+    var _a;
+    if (!facts.length)
+        return;
+    const weights = new Map();
+    const valueOf = (node, k) => node.key[k] ?? (node.spans[k]?.length === 1 ? node.spans[k][0] : undefined);
+    for (const fact of facts) {
+        const identity = Object.entries(fact.key);
+        if (!identity.length)
+            continue;
+        for (const node of nodes) {
+            // The key must match exactly - that is what makes this fact about this
+            // thing. The fact's own dimensions only *narrow*: if the node knows a
+            // conflicting value, the fact belongs to a different deployment; if the
+            // node has never heard of the dimension, the fact is new information.
+            if (!identity.every(([k, v]) => valueOf(node, k) === v))
+                continue;
+            const conflicts = Object.entries(fact.dims ?? {}).some(([k, v]) => {
+                const own = valueOf(node, k);
+                return own !== undefined && own !== v;
+            });
+            if (conflicts)
+                continue;
+            const w = fact.attrs?.instances ?? 1;
+            for (const [k, v] of Object.entries(fact.attrs ?? {})) {
+                if (COUNT_ATTRS.has(k))
+                    node.attrs[k] = (node.attrs[k] ?? 0) + v;
+                else
+                    node.attrs[k] = (node.attrs[k] ?? 0) + v * w;
+            }
+            weights.set(node.id, (weights.get(node.id) ?? 0) + w);
+            if (fact.component)
+                node.component = fact.component;
+            for (const [k, v] of Object.entries(fact.dims ?? {})) {
+                ((_a = node.spans)[k] ?? (_a[k] = [])).includes(v) || node.spans[k].push(v);
+            }
+        }
+    }
+    for (const node of nodes) {
+        const w = weights.get(node.id);
+        if (!w)
+            continue;
+        for (const k of Object.keys(node.attrs)) {
+            if (!COUNT_ATTRS.has(k))
+                node.attrs[k] = round(node.attrs[k] / w, 3);
+        }
+    }
+}
+/** Attributes that sum rather than average when several things roll into one node. */
+const COUNT_ATTRS = new Set(['instances', 'replicas', 'pods', 'shards', 'connections']);
+const MEASURES = new Set(['rps', 'latencyMs', 'errorRate', 'bytes', 'share']);
+export function isMeasure(field) {
+    return MEASURES.has(field);
+}
+function passes(record, where) {
+    if (!where)
+        return true;
+    for (const [field, allowed] of Object.entries(where)) {
+        if (!allowed.length)
+            continue;
+        const value = record.dims?.[field] ?? record.from[field] ?? record.to[field];
+        if (value === undefined || !allowed.includes(value))
+            return false;
+    }
+    return true;
+}
+function touchNode(nodes, id, dims, nodeKey, record, delta) {
+    let n = nodes.get(id);
+    if (!n) {
+        const parts = nodeKey.map((k) => dims[k] ?? '∅');
+        nodes.set(id, (n = {
+            id,
+            // Label with the most specific part of the key; the coarser parts go on
+            // the second line, where they read as context rather than noise.
+            label: parts[parts.length - 1] ?? id,
+            ...(parts.length > 1 ? { sublabel: parts.slice(0, -1).join(' · ') } : {}),
+            kind: dims.kind ?? 'service',
+            key: Object.fromEntries(nodeKey.map((k, i) => [k, parts[i]])),
+            spans: {},
+            inbound: 0,
+            outbound: 0,
+            records: 0,
+        }));
+    }
+    n.inbound += delta.inbound ?? 0;
+    n.outbound += delta.outbound ?? 0;
+    n.records++;
+    collectSpans(n.spans, dims, [], nodeKey);
+    void record;
+}
+function collectSpans(into, dims, exclude, nodeKey) {
+    for (const [k, v] of Object.entries(dims)) {
+        if (exclude.includes(k) || nodeKey.includes(k))
+            continue;
+        (into[k] ?? (into[k] = new Set())).add(v);
+    }
+}
+function sortSpans(spans) {
+    const out = {};
+    for (const [k, v] of Object.entries(spans))
+        out[k] = [...v].sort();
+    return out;
+}
+function labelFor(dims, split) {
+    const parts = split.map((d) => dims[d]).filter(Boolean);
+    return parts.length ? parts.join(' · ') : undefined;
+}
+/** Map known failure/traffic dimensions onto the renderer's edge kinds. */
+function edgeKindOf(dims) {
+    const k = dims.kind ?? dims.edgeKind;
+    if (k === 'retry' || k === 'challenge' || k === 'response' || k === 'async' || k === 'request')
+        return k;
+    return 'request';
+}
+function round(v, digits) {
+    const f = 10 ** digits;
+    return Math.round(v * f) / f;
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/react/index.d.ts

@@ -0,0 +1,22 @@
+import type { CSSProperties, ReactElement } from 'react';
+import { TraceLight, type HoverTarget, type TraceLightOptions } from '../renderer.js';
+import type { GraphSource } from '../adapters/index.js';
+import type { Graph } from '../types.js';
+export interface TraceLightViewProps extends TraceLightOptions {
+    /** A graph you already have. Ignored when `source` is given. */
+    graph?: Graph;
+    /** A source to load from, and subscribe to if it supports pushing. */
+    source?: GraphSource;
+    className?: string;
+    style?: CSSProperties;
+    onError?: (err: Error) => void;
+}
+/**
+ * Thin React wrapper over {@link TraceLight}. The renderer owns the canvas and
+ * the animation loop; React only owns the container, so re-renders never
+ * restart the particle streams.
+ */
+export declare function TraceLightView({ graph, source, className, style, onError, ...options }: TraceLightViewProps): ReactElement;
+export type { HoverTarget, TraceLightOptions };
+export { TraceLight };
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,gEAAgE;IAChE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,sEAAsE;IACtE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,MAAM,EACN,SAAS,EACT,KAAK,EACL,OAAO,EACP,GAAG,OAAO,EACX,EAAE,mBAAmB,GAAG,YAAY,CAoEpC;AAED,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { TraceLight } from '../renderer.js';
+/**
+ * Thin React wrapper over {@link TraceLight}. The renderer owns the canvas and
+ * the animation loop; React only owns the container, so re-renders never
+ * restart the particle streams.
+ */
+export function TraceLightView({ graph, source, className, style, onError, ...options }) {
+    const ref = useRef(null);
+    const instance = useRef(null);
+    const [current, setCurrent] = useState(graph);
+    // Create once.
+    useEffect(() => {
+        if (!ref.current)
+            return;
+        const tl = new TraceLight(ref.current, options);
+        instance.current = tl;
+        return () => {
+            tl.destroy();
+            instance.current = null;
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    // Push option changes through without recreating.
+    useEffect(() => {
+        instance.current?.setOptions(options);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        options.theme,
+        options.speed,
+        options.animate,
+        options.showEdgeLabels,
+        options.showLegend,
+    ]);
+    useEffect(() => {
+        if (graph)
+            setCurrent(graph);
+    }, [graph]);
+    useEffect(() => {
+        if (!source)
+            return;
+        let cancelled = false;
+        source
+            .load()
+            .then((g) => !cancelled && setCurrent(g))
+            .catch((err) => onError?.(err));
+        const unsubscribe = source.subscribe?.((g) => !cancelled && setCurrent(g), (err) => onError?.(err));
+        return () => {
+            cancelled = true;
+            unsubscribe?.();
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [source]);
+    useEffect(() => {
+        if (!current || !instance.current)
+            return;
+        try {
+            instance.current.setGraph(current);
+        }
+        catch (err) {
+            onError?.(err);
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [current]);
+    return (_jsx("div", { ref: ref, className: className, style: { width: '100%', height: '100%', minHeight: 320, ...style } }));
+}
+export { TraceLight };
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

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

package/dist/renderer.d.ts

@@ -0,0 +1,252 @@
+import { couplingFor, type LegendGroup } from './channels.js';
+import { type NodeHealth } from './failure.js';
+import { type LayoutOptions } from './layout.js';
+import { type FlowTable, type TableSchema } from './model.js';
+import { type ViewSpec } from './project.js';
+import { type Scene, type SceneEdge, type SceneNode } from './scene.js';
+import { type EncodingOptions } from './scales.js';
+import { type Theme } from './theme.js';
+import type { Graph } from './types.js';
+export interface HoverTarget {
+    kind: 'node' | 'edge';
+    node?: SceneNode;
+    edge?: SceneEdge;
+}
+export interface TraceLightOptions {
+    theme?: 'auto' | 'light' | 'dark' | Theme;
+    encoding?: Partial<EncodingOptions>;
+    layout?: Partial<LayoutOptions>;
+    showEdgeLabels?: boolean;
+    showLegend?: boolean;
+    speed?: number;
+    animate?: boolean;
+    seed?: number;
+    /** In world mode, let the camera drift slowly round the mesh when nobody is touching it. */
+    orbit?: boolean;
+    /** Milliseconds for a re-projection morph. 0 snaps. */
+    morphMs?: number;
+    /**
+     * Space to keep clear at each edge, in pixels - for a page that floats its
+     * own legend, readout or inspector over the canvas. The layout fits inside
+     * the remaining box, so nothing lands under a panel.
+     */
+    insets?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    onHover?: (target: HoverTarget | null) => void;
+    onSelect?: (target: HoverTarget | null) => void;
+    /** Fires after every re-projection, with what the picture now encodes. */
+    onView?: (info: ViewInfo) => void;
+}
+export interface ViewInfo {
+    scene: Scene;
+    spec: ViewSpec;
+    legend: LegendGroup[];
+    splitBy: string[];
+    issues: string[];
+    stats: Stats;
+}
+export interface Stats {
+    totalRps: number;
+    wastedRps: number;
+    wastedFraction: number;
+    nodes: number;
+    edges: number;
+    records: number;
+    filtered: number;
+    deadRps: number;
+    degradedRps: number;
+    deadNodes: number;
+    degradedNodes: number;
+}
+export declare class TraceLight {
+    private container;
+    private canvas;
+    private ctx;
+    private tooltip;
+    private opts;
+    private insets;
+    private theme;
+    private themeSetting;
+    private encoding;
+    private layoutOpts;
+    private table;
+    private spec;
+    private scene;
+    private styles;
+    private failure;
+    private splitBy;
+    private matched;
+    private filtered;
+    private targets;
+    private origins;
+    private positions;
+    private morphFrom;
+    private morphing;
+    private views;
+    private rand;
+    private killedAt;
+    private world;
+    private camera;
+    private yaw;
+    private yawVelocity;
+    private dragging;
+    /** A persistent selection, distinct from the transient hover. */
+    private selected;
+    /** Isolate one value of one dimension: everything else dims. */
+    private highlight;
+    /** Shockwaves from recent kills, drawn as expanding rings. */
+    private shocks;
+    private sprites;
+    private width;
+    private height;
+    private dpr;
+    private raf;
+    private lastFrame;
+    private running;
+    private hovered;
+    private pointer;
+    private resizeObserver?;
+    private motionQuery?;
+    private themeQuery?;
+    constructor(container: HTMLElement, options?: TraceLightOptions);
+    /** Draw a hand-written flat graph. The v0.1 path; still supported unchanged. */
+    setGraph(graph: Graph): void;
+    /** Draw a dimensional flow table under a view spec. */
+    setTable(table: FlowTable, spec?: ViewSpec): void;
+    /**
+     * Change the knobs. With a table loaded this re-projects (and morphs); with a
+     * flat graph it just restyles. Safe to call every frame.
+     */
+    setSpec(spec: ViewSpec): void;
+    getSpec(): ViewSpec;
+    getScene(): Scene;
+    getLegend(): LegendGroup[];
+    /** What dimensions and measures the loaded table offers. */
+    schema(): TableSchema | null;
+    /** Kill nodes and watch the front travel. Pass [] to bring everything back. */
+    kill(ids: string[]): void;
+    /** Current health of a node under the active kills: ok, degraded or dead. */
+    health(id: string): NodeHealth;
+    /** Mark one node as selected. It keeps its ring until you pass null. */
+    select(id: string | null): void;
+    getSelected(): string | null;
+    /**
+     * Isolate one value of a dimension - "show me only eu-west" - by dimming
+     * every edge that does not carry it. Pass null to clear. Unlike a filter,
+     * nothing is re-projected: the rest of the picture stays where it is, faded,
+     * so you can see the isolated traffic *in context*.
+     */
+    setHighlight(highlight: {
+        field: string;
+        value: string;
+    } | null): void;
+    /** Nudge the world camera. Yaw is in radians; the renderer eases toward it. */
+    setYaw(yaw: number): void;
+    getYaw(): number;
+    setOptions(options: Partial<TraceLightOptions>): void;
+    stats(): Stats;
+    start(): void;
+    stop(): void;
+    toDataURL(type?: string): string;
+    destroy(): void;
+    private reproject;
+    private applyScene;
+    private layout;
+    private buildViews;
+    private isWorld;
+    /** Which plane a node sits on: an explicit binding, else its kind. */
+    private tierOf;
+    /**
+     * How big a body is drawn. Mass, not area: a fleet of 64 should read as
+     * bigger than a single box without swallowing the plane, so it grows with the
+     * logarithm of the instance count.
+     */
+    private bodySize;
+    /**
+     * Shrink every body when the projection puts more things on screen than the
+     * canvas can hold at full size. Expanding a service into forty APIs should
+     * give you smaller machines, not a pile of overlapping ones.
+     */
+    private crowdScale;
+    /** How rows are ordered inside a flat column, from the spec. */
+    private rowKey;
+    /** The drawable box once insets and the legend strip are taken out. */
+    private box;
+    /** Re-project after a camera change, keeping everything else in place. */
+    private recamera;
+    /** Flatten the world onto the screen for this frame's camera. */
+    private projectWorld;
+    private pathFor;
+    private onMotionChange;
+    private onThemeChange;
+    private resize;
+    private frame;
+    /** Seconds after the kill at which the front reaches this edge. */
+    private frontArrival;
+    private draw;
+    /** Is this edge pushed into the background by the current hover, selection or isolation? */
+    private isDimmed;
+    private drawEdge;
+    /**
+     * A rigid (fail-closed) coupling is drawn as a mechanical conduit: two
+     * parallel rails with cross-ties. It looks like something that transmits
+     * force, because that is exactly what it does - death travels along it.
+     */
+    private strokeRigid;
+    /**
+     * A breakaway (fail-open) coupling has a deliberate parting line: a gap with
+     * two facing chevrons. When the far side dies it opens, and an amber shield
+     * arc marks where the front stopped. A fail-open dependency is a firebreak
+     * and the picture should say so.
+     */
+    private drawBreakaway;
+    /** Where a rigid coupling gives way, it fractures rather than fading. */
+    private drawFracture;
+    private drawParticles;
+    /** A cached radial sprite per colour: bright core, soft halo. */
+    private sprite;
+    private drawEdgeLabel;
+    private drawNode;
+    /**
+     * A neighbourhood per group. When boxes are arranged by a dimension (a team,
+     * a tier), the boxes sharing a value get a soft region behind them with the
+     * value written at the top, so "these live together" is drawn, not inferred
+     * from alignment.
+     */
+    private drawGroups;
+    /**
+     * The planes themselves. Drawing the ground a tier sits on is what turns a
+     * scatter of boxes into somewhere - and it makes "the data tier" a place you
+     * can point at rather than a convention you have to remember.
+     */
+    private drawTiers;
+    private tierLabel;
+    private drawWorldNode;
+    private componentHint;
+    /**
+     * The error halo: a red glow that scales with how bad things are. Low
+     * intensity is a thin warm rim you notice on a second look; high intensity
+     * is a wide bloom that breathes slowly, so a burning box is the thing you
+     * see from across the room without anything flashing at you.
+     */
+    private drawDangerGlow;
+    /** A steady ring around the selected thing, with a slow breathing halo. */
+    private drawSelectionRing;
+    /** The moment of a kill: one expanding ring, gone in a second and a half. */
+    private drawShock;
+    private drawLegend;
+    private placeLabels;
+    private hitTest;
+    private onPointerDown;
+    private onPointerUp;
+    private onPointerMove;
+    private onPointerLeave;
+    private onClick;
+    private updateTooltip;
+}
+export { couplingFor };
+//# sourceMappingURL=renderer.d.ts.map