nirs4all-ui 0.1.12 → 0.1.13

package/dist/chains/analysis.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Chain-effect analysis — descriptive aggregation over comparable chains.
+ *
+ * Pure, framework-free. Given {@link ChainPoint}s (goodness already computed by
+ * a lens, whether descriptive or authoritative), this derives the per-token
+ * effects, the position matrix (early / mid / late, 1st vs 2nd …), the
+ * predecessor × successor sequence matrix ("MSC after SNV?"), and per-token
+ * neighbour contexts. Every aggregate is a robust median/IQR over goodness and
+ * is gated by a minimum sample count so noise is not over-read.
+ */
+import type { ChainEffectAnalysis, ChainMetric, ChainPoint, ChainStepRole, NodeFlow, NodeNeighborhood, PositionMatrix, PositionMode, ScoredChain, ScoreLens, SequenceMatrix, Stat, TokenContexts } from "./types.js";
+/** Five-number summary + `n` of the finite values (empty → `n = 0`). */
+export declare function stat(values: readonly number[]): Stat;
+export interface BuildAnalysisMeta {
+    metric: ChainMetric;
+    lens: ScoreLens;
+    /** Reference goodness; defaults to the global median (authoritative override). */
+    baseline?: number | undefined;
+}
+/** Assemble a full {@link ChainEffectAnalysis} from pre-normalized points. */
+export declare function buildAnalysis(points: readonly ChainPoint[], meta: BuildAnalysisMeta): ChainEffectAnalysis;
+/**
+ * Descriptive analysis straight from raw scored chains — the non-authoritative
+ * fallback used until `dag-ml` emits the native artifact. Drops chains whose
+ * score is non-finite (boundary validation).
+ */
+export declare function fromScoredChains(chains: readonly ScoredChain[], options: {
+    metric: ChainMetric;
+    lens: ScoreLens;
+}): ChainEffectAnalysis;
+export interface PositionMatrixOptions {
+    /** Default `"phase"` (Early/Mid/Late) — handles variable-length chains. */
+    mode?: PositionMode;
+    /** Absolute-mode bucket cap; the last bucket is "kth+". Default `5`. */
+    maxAbsolute?: number;
+    /** Minimum chains per cell; below this the cell is `null`. Default `3`. */
+    minCount?: number;
+    /** Roles whose ordering defines the "transform stack". Default preprocess/feature/augmentation. */
+    roles?: readonly ChainStepRole[];
+    /** Restrict/order rows to these tokens; default all tokens of `roles`. */
+    tokens?: readonly string[];
+}
+/** Token × position goodness matrix — answers "is MSC better 1st or 2nd?". */
+export declare function positionMatrix(analysis: ChainEffectAnalysis, options?: PositionMatrixOptions): PositionMatrix;
+export interface SequenceMatrixOptions {
+    roles?: readonly ChainStepRole[];
+    minCount?: number;
+    /** Consecutive in the transform stack (vs anywhere-before). Default `false`. */
+    adjacentOnly?: boolean;
+    tokens?: readonly string[];
+    /** Cap the matrix to the top-N tokens by coverage. Default `8`. */
+    maxTokens?: number;
+}
+/** Predecessor × successor goodness matrix — answers "MSC after SNV?". */
+export declare function sequenceMatrix(analysis: ChainEffectAnalysis, options?: SequenceMatrixOptions): SequenceMatrix;
+export interface TokenContextsOptions {
+    roles?: readonly ChainStepRole[];
+    minCount?: number;
+    /** Cap each list to the top-K by median goodness. Default: unbounded. */
+    topK?: number;
+}
+/** Best/worst neighbours around a focus token (explorer detail panel). */
+export declare function tokenContexts(analysis: ChainEffectAnalysis, focusToken: string, options?: TokenContextsOptions): TokenContexts;
+export interface NodeNeighborsOptions {
+    /** Neighbour roles to include. Default: every role present. */
+    roles?: readonly ChainStepRole[] | undefined;
+    /** Minimum shared chains for a neighbour to appear. Default `1`. */
+    minCount?: number;
+    /** Keep the top-N neighbours by link weight; the rest fold into "others". Default `9`. */
+    maxNeighbors?: number;
+}
+/**
+ * Co-occurrence neighbourhood of a focus node: every token that shares a chain
+ * with it, weighted by the number of shared chains and scored by the goodness
+ * of those shared chains (the *combined* effect). Drives {@link ChainNodeOrbit}.
+ * Returns `null` when the focus token is unknown.
+ */
+export declare function nodeNeighbors(analysis: ChainEffectAnalysis, focusToken: string, options?: NodeNeighborsOptions): NodeNeighborhood | null;
+export interface NodeFlowOptions {
+    /** Step roles to include. Default: every role present. */
+    roles?: readonly ChainStepRole[] | undefined;
+    /** Minimum chains for a wedge to appear. Default `1`. */
+    minCount?: number;
+    /** Outward successor levels (1–3). Default `2`. */
+    depth?: number;
+    /** Keep the top-N children per node; the rest drop. Default `6`. */
+    maxPerLevel?: number;
+    /** Cap the inner predecessor ring. Default `6`. */
+    maxPredecessors?: number;
+}
+/**
+ * Directional flow around a focus node: the predecessors that lead into it (one
+ * inner ring) and the *real ordered continuations* that follow it, expanded as
+ * a bounded successor tree (each path `focus → a → b` is an actual chain
+ * sub-sequence that occurred, weighted by its chain count). Drives the
+ * multi-ring {@link ChainNodeOrbit} sunburst; returns `null` for an unknown
+ * focus.
+ */
+export declare function nodeFlow(analysis: ChainEffectAnalysis, focus: string | readonly string[], options?: NodeFlowOptions): NodeFlow | null;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/chains/analysis.d.ts.map

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

package/dist/chains/analysis.js

@@ -0,0 +1,440 @@
+/**
+ * Chain-effect analysis — descriptive aggregation over comparable chains.
+ *
+ * Pure, framework-free. Given {@link ChainPoint}s (goodness already computed by
+ * a lens, whether descriptive or authoritative), this derives the per-token
+ * effects, the position matrix (early / mid / late, 1st vs 2nd …), the
+ * predecessor × successor sequence matrix ("MSC after SNV?"), and per-token
+ * neighbour contexts. Every aggregate is a robust median/IQR over goodness and
+ * is gated by a minimum sample count so noise is not over-read.
+ */
+import { extentOf, fiveNumberSummary, quantileSorted } from "../viz/geometry.js";
+import { computeChainPoints } from "./normalize.js";
+import { CHAIN_ROLE_ORDER, CHAIN_TRANSFORM_ROLES } from "./types.js";
+const EMPTY_STAT = { n: 0, min: NaN, q1: NaN, median: NaN, q3: NaN, max: NaN, mean: NaN };
+/** Five-number summary + `n` of the finite values (empty → `n = 0`). */
+export function stat(values) {
+    const finite = values.filter((value) => Number.isFinite(value));
+    if (finite.length === 0)
+        return { ...EMPTY_STAT };
+    return { n: finite.length, ...fiveNumberSummary(finite) };
+}
+function medianOf(values) {
+    const finite = values.filter((value) => Number.isFinite(value)).slice().sort((a, b) => a - b);
+    return quantileSorted(finite, 0.5);
+}
+function uniqueRolesInOrder(points) {
+    const present = new Set();
+    for (const point of points)
+        for (const token of point.orderedTokens)
+            present.add(token.role);
+    return CHAIN_ROLE_ORDER.filter((role) => present.has(role));
+}
+function uniqueSorted(values) {
+    return [...new Set(values)].sort((a, b) => a.localeCompare(b));
+}
+/** Assemble a full {@link ChainEffectAnalysis} from pre-normalized points. */
+export function buildAnalysis(points, meta) {
+    const goodness = points.map((point) => point.goodness);
+    const baseline = Number.isFinite(meta.baseline) ? meta.baseline : medianOf(goodness);
+    const total = points.length;
+    const catalog = new Map();
+    for (const point of points) {
+        for (const token of point.orderedTokens) {
+            if (!catalog.has(token.token))
+                catalog.set(token.token, token);
+        }
+    }
+    const tokens = [];
+    for (const [token, ref] of catalog) {
+        const withValues = [];
+        const withoutValues = [];
+        for (const point of points) {
+            (point.tokens.includes(token) ? withValues : withoutValues).push(point.goodness);
+        }
+        const withStat = stat(withValues);
+        const withoutStat = stat(withoutValues);
+        const delta = withStat.n > 0 && withoutStat.n > 0 ? withStat.median - withoutStat.median : NaN;
+        tokens.push({
+            token,
+            label: ref.label,
+            role: ref.role,
+            n: withStat.n,
+            coverage: total > 0 ? withStat.n / total : 0,
+            with: withStat,
+            without: withoutStat,
+            delta,
+        });
+    }
+    tokens.sort((a, b) => {
+        const av = Number.isFinite(a.delta);
+        const bv = Number.isFinite(b.delta);
+        if (av !== bv)
+            return av ? -1 : 1;
+        if (av && bv && a.delta !== b.delta)
+            return b.delta - a.delta;
+        return b.coverage - a.coverage;
+    });
+    return {
+        lens: meta.lens,
+        metric: meta.metric,
+        total,
+        datasets: uniqueSorted(points.map((point) => point.dataset)),
+        sources: uniqueSorted(points.map((point) => point.source)),
+        roles: uniqueRolesInOrder(points),
+        baseline,
+        goodnessExtent: extentOf(goodness),
+        points: points.slice(),
+        tokens,
+    };
+}
+/**
+ * Descriptive analysis straight from raw scored chains — the non-authoritative
+ * fallback used until `dag-ml` emits the native artifact. Drops chains whose
+ * score is non-finite (boundary validation).
+ */
+export function fromScoredChains(chains, options) {
+    const valid = chains.filter((chain) => Number.isFinite(chain.score));
+    const points = computeChainPoints(valid, options.metric, options.lens);
+    return buildAnalysis(points, { metric: options.metric, lens: options.lens });
+}
+// --- position -------------------------------------------------------------
+const PHASE_BUCKETS = [
+    { key: "early", label: "Early" },
+    { key: "mid", label: "Mid" },
+    { key: "late", label: "Late" },
+];
+function ordinalLabel(index1) {
+    const suffixes = ["th", "st", "nd", "rd"];
+    const mod100 = index1 % 100;
+    const suffix = suffixes[(mod100 - 20) % 10] ?? suffixes[mod100] ?? suffixes[0];
+    return `${index1}${suffix}`;
+}
+function absoluteBuckets(max) {
+    const buckets = [];
+    for (let i = 1; i < max; i += 1)
+        buckets.push({ key: `p${i}`, label: ordinalLabel(i) });
+    buckets.push({ key: `p${max}+`, label: `${ordinalLabel(max)}+` });
+    return buckets;
+}
+function phaseIndex(idx, length) {
+    if (length <= 1)
+        return 0;
+    const rel = idx / (length - 1);
+    if (rel < 1 / 3)
+        return 0;
+    if (rel > 2 / 3)
+        return 2;
+    return 1;
+}
+/** Token × position goodness matrix — answers "is MSC better 1st or 2nd?". */
+export function positionMatrix(analysis, options = {}) {
+    const mode = options.mode ?? "phase";
+    const maxAbsolute = Math.max(2, Math.trunc(options.maxAbsolute ?? 5));
+    const minCount = Math.max(1, Math.trunc(options.minCount ?? 3));
+    const roles = options.roles ?? CHAIN_TRANSFORM_ROLES;
+    const roleSet = new Set(roles);
+    const buckets = mode === "absolute" ? absoluteBuckets(maxAbsolute) : [...PHASE_BUCKETS];
+    const byToken = new Map(analysis.tokens.map((token) => [token.token, token]));
+    const tokenOrder = options.tokens
+        ? options.tokens.filter((token) => byToken.has(token))
+        : analysis.tokens.filter((token) => roleSet.has(token.role)).map((token) => token.token);
+    const rows = tokenOrder.map((token) => {
+        const ref = byToken.get(token);
+        const perBucket = buckets.map(() => []);
+        for (const point of analysis.points) {
+            const stack = point.orderedTokens.filter((entry) => roleSet.has(entry.role));
+            const idx = stack.findIndex((entry) => entry.token === token);
+            if (idx < 0)
+                continue;
+            const bucket = mode === "absolute" ? Math.min(idx, maxAbsolute - 1) : phaseIndex(idx, stack.length);
+            perBucket[bucket].push(point.goodness);
+        }
+        const cells = perBucket.map((values) => {
+            const summary = stat(values);
+            return summary.n >= minCount ? summary : null;
+        });
+        return { token, label: ref.label, role: ref.role, cells };
+    });
+    return { mode, buckets, rows, baseline: analysis.baseline };
+}
+/** Predecessor × successor goodness matrix — answers "MSC after SNV?". */
+export function sequenceMatrix(analysis, options = {}) {
+    const roles = options.roles ?? CHAIN_TRANSFORM_ROLES;
+    const roleSet = new Set(roles);
+    const minCount = Math.max(1, Math.trunc(options.minCount ?? 3));
+    const adjacentOnly = options.adjacentOnly ?? false;
+    const maxTokens = Math.max(2, Math.trunc(options.maxTokens ?? 8));
+    const byToken = new Map(analysis.tokens.map((token) => [token.token, token]));
+    const selected = options.tokens
+        ? options.tokens.filter((token) => byToken.has(token))
+        : analysis.tokens
+            .filter((token) => roleSet.has(token.role))
+            .slice()
+            .sort((a, b) => b.coverage - a.coverage)
+            .slice(0, maxTokens)
+            .map((token) => token.token);
+    const refs = selected.map((token) => {
+        const effect = byToken.get(token);
+        return { token: effect.token, label: effect.label, role: effect.role };
+    });
+    const colIndex = new Map(refs.map((ref, index) => [ref.token, index]));
+    const size = refs.length;
+    const buckets = refs.map(() => refs.map(() => []));
+    for (const point of analysis.points) {
+        const fullIndex = new Map();
+        point.orderedTokens.forEach((entry, index) => {
+            if (colIndex.has(entry.token))
+                fullIndex.set(entry.token, index);
+        });
+        const stack = point.orderedTokens.filter((entry) => roleSet.has(entry.role));
+        const stackPos = new Map();
+        stack.forEach((entry, index) => {
+            if (colIndex.has(entry.token))
+                stackPos.set(entry.token, index);
+        });
+        for (let i = 0; i < size; i += 1) {
+            const a = refs[i].token;
+            const posA = fullIndex.get(a);
+            if (posA === undefined)
+                continue;
+            for (let j = 0; j < size; j += 1) {
+                if (i === j)
+                    continue;
+                const b = refs[j].token;
+                const posB = fullIndex.get(b);
+                if (posB === undefined)
+                    continue;
+                const before = adjacentOnly
+                    ? stackPos.get(b) === (stackPos.get(a) ?? -2) + 1
+                    : posA < posB;
+                if (before)
+                    buckets[i][j].push(point.goodness);
+            }
+        }
+    }
+    const cells = buckets.map((row, i) => row.map((values, j) => {
+        if (i === j)
+            return null;
+        const summary = stat(values);
+        return summary.n >= minCount ? summary : null;
+    }));
+    return { tokens: refs, cells, baseline: analysis.baseline, adjacentOnly };
+}
+/** Best/worst neighbours around a focus token (explorer detail panel). */
+export function tokenContexts(analysis, focusToken, options = {}) {
+    const roles = options.roles ?? CHAIN_TRANSFORM_ROLES;
+    const roleSet = new Set(roles);
+    const minCount = Math.max(1, Math.trunc(options.minCount ?? 3));
+    const byToken = new Map(analysis.tokens.map((token) => [token.token, token]));
+    const predValues = new Map();
+    const succValues = new Map();
+    for (const point of analysis.points) {
+        const focusIdx = point.orderedTokens.findIndex((entry) => entry.token === focusToken);
+        if (focusIdx < 0)
+            continue;
+        point.orderedTokens.forEach((entry, index) => {
+            if (entry.token === focusToken || !roleSet.has(entry.role))
+                return;
+            const target = index < focusIdx ? predValues : succValues;
+            const bucket = target.get(entry.token);
+            if (bucket)
+                bucket.push(point.goodness);
+            else
+                target.set(entry.token, [point.goodness]);
+        });
+    }
+    const build = (values) => {
+        const rows = [];
+        for (const [token, list] of values) {
+            const summary = stat(list);
+            if (summary.n < minCount)
+                continue;
+            const ref = byToken.get(token);
+            rows.push({
+                token,
+                label: ref?.label ?? token,
+                role: ref?.role ?? "other",
+                stat: summary,
+                delta: summary.median - analysis.baseline,
+            });
+        }
+        rows.sort((a, b) => b.stat.median - a.stat.median);
+        return typeof options.topK === "number" ? rows.slice(0, Math.max(0, options.topK)) : rows;
+    };
+    return { token: focusToken, predecessors: build(predValues), successors: build(succValues) };
+}
+/**
+ * Co-occurrence neighbourhood of a focus node: every token that shares a chain
+ * with it, weighted by the number of shared chains and scored by the goodness
+ * of those shared chains (the *combined* effect). Drives {@link ChainNodeOrbit}.
+ * Returns `null` when the focus token is unknown.
+ */
+export function nodeNeighbors(analysis, focusToken, options = {}) {
+    const focus = analysis.tokens.find((token) => token.token === focusToken);
+    if (!focus)
+        return null;
+    const roleSet = options.roles ? new Set(options.roles) : null;
+    const minCount = Math.max(1, Math.trunc(options.minCount ?? 1));
+    const maxNeighbors = Math.max(1, Math.trunc(options.maxNeighbors ?? 9));
+    const selfValues = [];
+    const perNeighbor = new Map();
+    for (const point of analysis.points) {
+        if (!point.tokens.includes(focusToken))
+            continue;
+        selfValues.push(point.goodness);
+        for (const ref of point.orderedTokens) {
+            if (ref.token === focusToken)
+                continue;
+            if (roleSet && !roleSet.has(ref.role))
+                continue;
+            const bucket = perNeighbor.get(ref.token);
+            if (bucket)
+                bucket.push(point.goodness);
+            else
+                perNeighbor.set(ref.token, [point.goodness]);
+        }
+    }
+    const byToken = new Map(analysis.tokens.map((token) => [token.token, token]));
+    const links = [];
+    for (const [token, values] of perNeighbor) {
+        if (values.length < minCount)
+            continue;
+        const ref = byToken.get(token);
+        const summary = stat(values);
+        links.push({
+            token,
+            label: ref?.label ?? token,
+            role: ref?.role ?? "other",
+            count: values.length,
+            stat: summary,
+            delta: summary.median - analysis.baseline,
+        });
+    }
+    links.sort((a, b) => b.count - a.count || b.stat.median - a.stat.median);
+    const kept = links.slice(0, maxNeighbors);
+    const folded = links.slice(maxNeighbors);
+    const otherWeight = folded.reduce((sum, link) => sum + link.count, 0);
+    return {
+        token: focus.token,
+        label: focus.label,
+        role: focus.role,
+        self: stat(selfValues),
+        neighbors: kept,
+        otherCount: folded.length,
+        otherWeight,
+        baseline: analysis.baseline,
+        goodnessExtent: analysis.goodnessExtent,
+    };
+}
+/**
+ * If `path` occurs as an ordered subsequence of `orderedTokens`, return the
+ * indices of its first and last matched tokens; otherwise `null`.
+ */
+function pathSpan(orderedTokens, path) {
+    let pi = 0;
+    let first = -1;
+    let last = -1;
+    for (let i = 0; i < orderedTokens.length && pi < path.length; i += 1) {
+        if (orderedTokens[i].token === path[pi]) {
+            if (pi === 0)
+                first = i;
+            last = i;
+            pi += 1;
+        }
+    }
+    return pi === path.length ? { first, last } : null;
+}
+/**
+ * Directional flow around a focus node: the predecessors that lead into it (one
+ * inner ring) and the *real ordered continuations* that follow it, expanded as
+ * a bounded successor tree (each path `focus → a → b` is an actual chain
+ * sub-sequence that occurred, weighted by its chain count). Drives the
+ * multi-ring {@link ChainNodeOrbit} sunburst; returns `null` for an unknown
+ * focus.
+ */
+export function nodeFlow(analysis, focus, options = {}) {
+    const path = typeof focus === "string" ? [focus] : focus.slice();
+    if (path.length === 0)
+        return null;
+    const headToken = path[path.length - 1];
+    const head = analysis.tokens.find((token) => token.token === headToken);
+    if (!head)
+        return null;
+    const roleSet = options.roles ? new Set(options.roles) : null;
+    const minCount = Math.max(1, Math.trunc(options.minCount ?? 1));
+    const depth = Math.min(3, Math.max(1, Math.trunc(options.depth ?? 2)));
+    const maxPerLevel = Math.max(1, Math.trunc(options.maxPerLevel ?? 6));
+    const maxPredecessors = Math.max(1, Math.trunc(options.maxPredecessors ?? 6));
+    const byToken = new Map(analysis.tokens.map((token) => [token.token, token]));
+    const selfValues = [];
+    const predValues = new Map();
+    const root = { token: "", values: [], children: new Map() };
+    for (const point of analysis.points) {
+        const span = pathSpan(point.orderedTokens, path);
+        if (!span)
+            continue;
+        selfValues.push(point.goodness);
+        for (let i = 0; i < span.first; i += 1) {
+            const entry = point.orderedTokens[i];
+            if (roleSet && !roleSet.has(entry.role))
+                continue;
+            const bucket = predValues.get(entry.token);
+            if (bucket)
+                bucket.push(point.goodness);
+            else
+                predValues.set(entry.token, [point.goodness]);
+        }
+        let node = root;
+        let level = 0;
+        for (let i = span.last + 1; i < point.orderedTokens.length && level < depth; i += 1) {
+            const entry = point.orderedTokens[i];
+            if (roleSet && !roleSet.has(entry.role))
+                continue;
+            let child = node.children.get(entry.token);
+            if (!child) {
+                child = { token: entry.token, values: [], children: new Map() };
+                node.children.set(entry.token, child);
+            }
+            child.values.push(point.goodness);
+            node = child;
+            level += 1;
+        }
+    }
+    const linkFrom = (token, values) => {
+        const ref = byToken.get(token);
+        const summary = stat(values);
+        return {
+            token,
+            label: ref?.label ?? token,
+            role: ref?.role ?? "other",
+            count: values.length,
+            stat: summary,
+            delta: summary.median - analysis.baseline,
+        };
+    };
+    const predecessors = [...predValues.entries()]
+        .map(([token, values]) => linkFrom(token, values))
+        .filter((link) => link.count >= minCount)
+        .sort((a, b) => b.count - a.count || b.stat.median - a.stat.median)
+        .slice(0, maxPredecessors);
+    const convert = (trie) => [...trie.children.values()]
+        .filter((child) => child.values.length >= minCount)
+        .sort((a, b) => b.values.length - a.values.length)
+        .slice(0, maxPerLevel)
+        .map((child) => {
+        const link = linkFrom(child.token, child.values);
+        return { ...link, children: convert(child) };
+    });
+    return {
+        token: head.token,
+        label: head.label,
+        role: head.role,
+        self: stat(selfValues),
+        predecessors,
+        successors: convert(root),
+        baseline: analysis.baseline,
+        goodnessExtent: analysis.goodnessExtent,
+    };
+}
+//# sourceMappingURL=analysis.js.map

package/dist/chains/analysis.js.map

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

package/dist/chains/colors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Color mapping for the chain-effect explorer.
+ *
+ * Reuses the canonical nirs4all `viz` teal system as the single source of truth
+ * (same hues as {@link file://../viz/PipelineFlow.tsx PipelineFlow} and the DAG
+ * viewer), so the explorer sits inside the existing design language. Two color
+ * jobs only:
+ * - **role identity** → the categorical brand hues (small chips beside a text
+ *   label, so identity is never color-alone);
+ * - **effect polarity** → the brand diverging ramp pivoted on the analysis
+ *   baseline (better = cool/blue, worse = warm/red, gray at the baseline). The
+ *   diverging ramp is CVD-safe and every cell also prints its value.
+ */
+import type { ChainStepRole } from "./types.js";
+export declare const CHAIN_ROLE_COLORS: Readonly<Record<ChainStepRole, string>>;
+/** Resolve a role color, honoring per-host overrides. */
+export declare function roleColor(role: ChainStepRole, overrides?: Partial<Record<ChainStepRole, string>>): string;
+/**
+ * Diverging color for a goodness value relative to the baseline.
+ * `value > baseline` (better) → cool/blue; `value < baseline` (worse) → warm/red;
+ * `≈ baseline` → neutral gray. `halfRange` sets the saturation span.
+ */
+export declare function effectColor(value: number, baseline: number, halfRange: number): string;
+/** Ink for text drawn on top of an {@link effectColor} fill. */
+export declare function effectTextColor(value: number, baseline: number, halfRange: number): string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/chains/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/chains/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAUhD,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAQrE,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAEzG;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOtF;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK1F"}