nirs4all-ui 0.1.12 → 0.1.13

package/dist/chains/colors.js

@@ -0,0 +1,58 @@
+/**
+ * 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 { clamp } from "../viz/geometry.js";
+import { N4_VIZ_COLORS, rampAt } from "../viz/theme.js";
+/**
+ * Chains-local diverging ramp: teal (better) → warm neutral → burnt amber
+ * (worse). Stays inside the nirs4all teal system (unlike the blue↔red SHAP
+ * ramp) and is a CVD-safe blue-green/orange pair; the neutral midpoint matches
+ * the warm surface, and every cell also prints its value (redundant encoding).
+ */
+const CHAIN_DIVERGING_STOPS = ["#0f766e", "#ece9e2", "#c2620e"];
+export const CHAIN_ROLE_COLORS = {
+    split: N4_VIZ_COLORS.indigo,
+    preprocess: N4_VIZ_COLORS.cyan,
+    feature: N4_VIZ_COLORS.violet,
+    augmentation: N4_VIZ_COLORS.green,
+    model: N4_VIZ_COLORS.teal,
+    target: N4_VIZ_COLORS.slate,
+    other: N4_VIZ_COLORS.slate,
+};
+/** Resolve a role color, honoring per-host overrides. */
+export function roleColor(role, overrides) {
+    return overrides?.[role] ?? CHAIN_ROLE_COLORS[role];
+}
+/**
+ * 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 function effectColor(value, baseline, halfRange) {
+    if (!Number.isFinite(value))
+        return "transparent";
+    const span = halfRange > 0 ? halfRange : 1;
+    const delta = value - baseline;
+    // t=0 → teal (better), t=0.5 → neutral, t=1 → amber (worse)
+    const t = clamp(0.5 - (0.5 * delta) / span, 0, 1);
+    return rampAt(CHAIN_DIVERGING_STOPS, t);
+}
+/** Ink for text drawn on top of an {@link effectColor} fill. */
+export function effectTextColor(value, baseline, halfRange) {
+    if (!Number.isFinite(value))
+        return "var(--n4-color-muted, #64748b)";
+    const span = halfRange > 0 ? halfRange : 1;
+    // strong fills (far from baseline) get light ink; near-baseline grays get dark ink
+    return Math.abs(value - baseline) > span * 0.45 ? "#f8fafc" : "#0f172a";
+}
+//# sourceMappingURL=colors.js.map

package/dist/chains/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/chains/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGxD;;;;;GAKG;AACH,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAEzE,MAAM,CAAC,MAAM,iBAAiB,GAA4C;IACxE,KAAK,EAAE,aAAa,CAAC,MAAM;IAC3B,UAAU,EAAE,aAAa,CAAC,IAAI;IAC9B,OAAO,EAAE,aAAa,CAAC,MAAM;IAC7B,YAAY,EAAE,aAAa,CAAC,KAAK;IACjC,KAAK,EAAE,aAAa,CAAC,IAAI;IACzB,MAAM,EAAE,aAAa,CAAC,KAAK;IAC3B,KAAK,EAAE,aAAa,CAAC,KAAK;CAC3B,CAAC;AAEF,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,IAAmB,EAAE,SAAkD;IAC/F,OAAO,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,QAAgB,EAAE,SAAiB;IAC5E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IAClD,MAAM,IAAI,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC/B,4DAA4D;IAC5D,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,QAAgB,EAAE,SAAiB;IAChF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,gCAAgC,CAAC;IACrE,MAAM,IAAI,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,mFAAmF;IACnF,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1E,CAAC"}

package/dist/chains/contract.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Serialized contract for the chain-effect analysis — the seam to `dag-ml`.
+ *
+ * The *authoritative* analysis is a coordination concern that lives native in
+ * `dag-ml` (over its `ScoreSet` + `GraphPlan` node identities, with per-dataset
+ * normalization and fingerprints). It serializes to the snake_case artifact
+ * below — mirroring how `TuningResult` / `CalibratedRunResult` reach this
+ * package. {@link parseChainEffectAnalysis} validates and projects it into the
+ * camelCase {@link ChainEffectAnalysis} view-model the charts render, trusting
+ * the producer's authoritative `goodness`/`baseline` verbatim. Token effects
+ * and the position/sequence matrices are *derived* views, so the wire artifact
+ * stays lean (metric + lens + baseline + points).
+ *
+ * {@link toChainEffectArtifact} does the reverse for tests, demos, and hosts
+ * that want to persist the descriptive view-model in the same shape.
+ */
+import type { ChainEffectAnalysis } from "./types.js";
+export declare const CHAIN_EFFECT_SCHEMA_ID: "https://github.com/GBeurier/dag-ml/schemas/chain_effect_analysis.v1.schema.json";
+export declare const CHAIN_EFFECT_SCHEMA_VERSION: 1;
+/** Wire spelling of {@link ScoreLens}. */
+export type ChainEffectLensWire = "raw" | "rank_by_dataset" | "z_by_dataset";
+export interface ChainEffectStepArtifact {
+    token: string;
+    label?: string;
+    role: string;
+}
+export interface ChainEffectPointArtifact {
+    id: string;
+    score: number;
+    goodness: number;
+    dataset?: string | null;
+    source?: string | null;
+    ordered_tokens: readonly ChainEffectStepArtifact[];
+}
+export interface ChainEffectMetricArtifact {
+    key: string;
+    label: string;
+    lower_is_better: boolean;
+}
+export interface ChainEffectAnalysisArtifact {
+    schema_id: string;
+    schema_version: number;
+    metric: ChainEffectMetricArtifact;
+    lens: ChainEffectLensWire;
+    baseline?: number | null;
+    points: readonly ChainEffectPointArtifact[];
+}
+/** Structural guard for a serialized chain-effect artifact. */
+export declare function isChainEffectAnalysisArtifact(value: unknown): value is ChainEffectAnalysisArtifact;
+/** Validate + project a serialized artifact into the render-ready view-model. */
+export declare function parseChainEffectAnalysis(value: unknown): ChainEffectAnalysis;
+/** Serialize a view-model back to the wire artifact (tests / demos / hosts). */
+export declare function toChainEffectArtifact(analysis: ChainEffectAnalysis): ChainEffectAnalysisArtifact;
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/chains/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAuD,MAAM,YAAY,CAAC;AAG3G,eAAO,MAAM,sBAAsB,EACjC,iFAA0F,CAAC;AAC7F,eAAO,MAAM,2BAA2B,EAAG,CAAU,CAAC;AAEtD,0CAA0C;AAC1C,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAc7E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,yBAAyB,CAAC;IAClC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC7C;AA8BD,+DAA+D;AAC/D,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,2BAA2B,CAWlG;AAaD,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAwB5E;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,2BAA2B,CAwBhG"}

package/dist/chains/contract.js

@@ -0,0 +1,125 @@
+/**
+ * Serialized contract for the chain-effect analysis — the seam to `dag-ml`.
+ *
+ * The *authoritative* analysis is a coordination concern that lives native in
+ * `dag-ml` (over its `ScoreSet` + `GraphPlan` node identities, with per-dataset
+ * normalization and fingerprints). It serializes to the snake_case artifact
+ * below — mirroring how `TuningResult` / `CalibratedRunResult` reach this
+ * package. {@link parseChainEffectAnalysis} validates and projects it into the
+ * camelCase {@link ChainEffectAnalysis} view-model the charts render, trusting
+ * the producer's authoritative `goodness`/`baseline` verbatim. Token effects
+ * and the position/sequence matrices are *derived* views, so the wire artifact
+ * stays lean (metric + lens + baseline + points).
+ *
+ * {@link toChainEffectArtifact} does the reverse for tests, demos, and hosts
+ * that want to persist the descriptive view-model in the same shape.
+ */
+import { buildAnalysis } from "./analysis.js";
+import { coerceChainRole } from "./types.js";
+export const CHAIN_EFFECT_SCHEMA_ID = "https://github.com/GBeurier/dag-ml/schemas/chain_effect_analysis.v1.schema.json";
+export const CHAIN_EFFECT_SCHEMA_VERSION = 1;
+const LENS_FROM_WIRE = {
+    raw: "raw",
+    rank_by_dataset: "rankByDataset",
+    z_by_dataset: "zByDataset",
+};
+const LENS_TO_WIRE = {
+    raw: "raw",
+    rankByDataset: "rank_by_dataset",
+    zByDataset: "z_by_dataset",
+};
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isMetric(value) {
+    return (isRecord(value) &&
+        typeof value.key === "string" &&
+        typeof value.label === "string" &&
+        typeof value.lower_is_better === "boolean");
+}
+function isStepArtifact(value) {
+    return isRecord(value) && typeof value.token === "string" && typeof value.role === "string";
+}
+function isPointArtifact(value) {
+    return (isRecord(value) &&
+        typeof value.id === "string" &&
+        typeof value.score === "number" &&
+        typeof value.goodness === "number" &&
+        Array.isArray(value.ordered_tokens) &&
+        value.ordered_tokens.every(isStepArtifact));
+}
+/** Structural guard for a serialized chain-effect artifact. */
+export function isChainEffectAnalysisArtifact(value) {
+    return (isRecord(value) &&
+        value.schema_id === CHAIN_EFFECT_SCHEMA_ID &&
+        typeof value.schema_version === "number" &&
+        isMetric(value.metric) &&
+        typeof value.lens === "string" &&
+        value.lens in LENS_FROM_WIRE &&
+        Array.isArray(value.points) &&
+        value.points.every(isPointArtifact));
+}
+function dedupeArtifactTokens(steps) {
+    const seen = new Set();
+    const out = [];
+    for (const step of steps) {
+        if (seen.has(step.token))
+            continue;
+        seen.add(step.token);
+        out.push({ token: step.token, label: step.label ?? step.token, role: coerceChainRole(step.role) });
+    }
+    return out;
+}
+/** Validate + project a serialized artifact into the render-ready view-model. */
+export function parseChainEffectAnalysis(value) {
+    if (!isChainEffectAnalysisArtifact(value)) {
+        throw new Error("Invalid chain-effect analysis artifact");
+    }
+    const metric = {
+        key: value.metric.key,
+        label: value.metric.label,
+        lowerIsBetter: value.metric.lower_is_better,
+    };
+    const lens = LENS_FROM_WIRE[value.lens];
+    const points = value.points.map((point) => {
+        const ordered = dedupeArtifactTokens(point.ordered_tokens);
+        return {
+            id: point.id,
+            score: point.score,
+            goodness: point.goodness,
+            dataset: point.dataset ?? "∗",
+            source: point.source ?? "∗",
+            tokens: ordered.map((token) => token.token),
+            orderedTokens: ordered,
+        };
+    });
+    const baseline = typeof value.baseline === "number" && Number.isFinite(value.baseline) ? value.baseline : undefined;
+    return buildAnalysis(points, { metric, lens, baseline });
+}
+/** Serialize a view-model back to the wire artifact (tests / demos / hosts). */
+export function toChainEffectArtifact(analysis) {
+    return {
+        schema_id: CHAIN_EFFECT_SCHEMA_ID,
+        schema_version: CHAIN_EFFECT_SCHEMA_VERSION,
+        metric: {
+            key: analysis.metric.key,
+            label: analysis.metric.label,
+            lower_is_better: analysis.metric.lowerIsBetter,
+        },
+        lens: LENS_TO_WIRE[analysis.lens],
+        baseline: analysis.baseline,
+        points: analysis.points.map((point) => ({
+            id: point.id,
+            score: point.score,
+            goodness: point.goodness,
+            dataset: point.dataset === "∗" ? null : point.dataset,
+            source: point.source === "∗" ? null : point.source,
+            ordered_tokens: point.orderedTokens.map((token) => ({
+                token: token.token,
+                label: token.label,
+                role: token.role,
+            })),
+        })),
+    };
+}
+//# sourceMappingURL=contract.js.map

package/dist/chains/contract.js.map

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

package/dist/chains/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * nirs4all-ui `chains` domain — the chain-effect explorer.
+ *
+ * Turns a corpus of *hundreds* of executed linear pipelines ("chains", e.g.
+ * `SNV → SavGol → PLS`), each with a comparable score, into the influence of
+ * each node: a global ranking (which steps help / hurt), a position profile
+ * (early / mid / late, 1st vs 2nd), an order matrix ("MSC after SNV?"), and a
+ * with/without distribution shift — across datasets and sources (multisource,
+ * multimodal). Per-dataset rank / z normalization makes heterogeneous datasets
+ * comparable.
+ *
+ * Same package boundary as the rest of nirs4all-ui: presentational + local UI
+ * state only — NO app state, network/IO, storage, or runtime execution. The
+ * *authoritative* analysis (per-dataset normalization with lineage) is a
+ * coordination concern that lives native in `dag-ml`; this domain renders its
+ * serialized artifact via {@link parseChainEffectAnalysis} and also ships a
+ * descriptive {@link fromScoredChains} adapter (the `viz/geometry` tier) so
+ * hosts can render from a raw scored-chain list today. A default stylesheet
+ * ships at `nirs4all-ui/assets/chains.css`.
+ *
+ * Consumed as `nirs4all-ui/chains`.
+ */
+export * from "./types.js";
+export { CHAIN_ROLE_COLORS, roleColor, effectColor, effectTextColor } from "./colors.js";
+export { orientedValue, percentileRanks, zScores, computeChainPoints, dedupeOrderedTokens } from "./normalize.js";
+export { stat, buildAnalysis, fromScoredChains, positionMatrix, sequenceMatrix, tokenContexts, nodeNeighbors, nodeFlow, type BuildAnalysisMeta, type PositionMatrixOptions, type SequenceMatrixOptions, type TokenContextsOptions, type NodeNeighborsOptions, type NodeFlowOptions, } from "./analysis.js";
+export { CHAIN_EFFECT_SCHEMA_ID, CHAIN_EFFECT_SCHEMA_VERSION, isChainEffectAnalysisArtifact, parseChainEffectAnalysis, toChainEffectArtifact, type ChainEffectAnalysisArtifact, type ChainEffectPointArtifact, type ChainEffectStepArtifact, type ChainEffectMetricArtifact, type ChainEffectLensWire, } from "./contract.js";
+export { NodeEffectForest, type NodeEffectForestProps, type ForestSort } from "./NodeEffectForest.js";
+export { PositionEffectHeatmap, type PositionEffectHeatmapProps } from "./PositionEffectHeatmap.js";
+export { SequenceEffectHeatmap, type SequenceEffectHeatmapProps } from "./SequenceEffectHeatmap.js";
+export { ChainScoreBeeswarm, type ChainScoreBeeswarmProps } from "./ChainScoreBeeswarm.js";
+export { ChainExplorer, type ChainExplorerProps } from "./ChainExplorer.js";
+export { ChainNodeOrbit, type ChainNodeOrbitProps } from "./ChainNodeOrbit.js";
+export { ChainNodeHub, type ChainNodeHubProps } from "./ChainNodeHub.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chains/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGzF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAClH,OAAO,EACL,IAAI,EACJ,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,EACb,QAAQ,EACR,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACtG,OAAO,EAAE,qBAAqB,EAAE,KAAK,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACpG,OAAO,EAAE,qBAAqB,EAAE,KAAK,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAG3F,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/chains/index.js

@@ -0,0 +1,41 @@
+/**
+ * nirs4all-ui `chains` domain — the chain-effect explorer.
+ *
+ * Turns a corpus of *hundreds* of executed linear pipelines ("chains", e.g.
+ * `SNV → SavGol → PLS`), each with a comparable score, into the influence of
+ * each node: a global ranking (which steps help / hurt), a position profile
+ * (early / mid / late, 1st vs 2nd), an order matrix ("MSC after SNV?"), and a
+ * with/without distribution shift — across datasets and sources (multisource,
+ * multimodal). Per-dataset rank / z normalization makes heterogeneous datasets
+ * comparable.
+ *
+ * Same package boundary as the rest of nirs4all-ui: presentational + local UI
+ * state only — NO app state, network/IO, storage, or runtime execution. The
+ * *authoritative* analysis (per-dataset normalization with lineage) is a
+ * coordination concern that lives native in `dag-ml`; this domain renders its
+ * serialized artifact via {@link parseChainEffectAnalysis} and also ships a
+ * descriptive {@link fromScoredChains} adapter (the `viz/geometry` tier) so
+ * hosts can render from a raw scored-chain list today. A default stylesheet
+ * ships at `nirs4all-ui/assets/chains.css`.
+ *
+ * Consumed as `nirs4all-ui/chains`.
+ */
+// --- view-model contract + role vocabulary ---
+export * from "./types.js";
+// --- palette (reuses the viz teal system) ---
+export { CHAIN_ROLE_COLORS, roleColor, effectColor, effectTextColor } from "./colors.js";
+// --- pure engine (reusable by hosts / tests) ---
+export { orientedValue, percentileRanks, zScores, computeChainPoints, dedupeOrderedTokens } from "./normalize.js";
+export { stat, buildAnalysis, fromScoredChains, positionMatrix, sequenceMatrix, tokenContexts, nodeNeighbors, nodeFlow, } from "./analysis.js";
+// --- serialized dag-ml artifact seam ---
+export { CHAIN_EFFECT_SCHEMA_ID, CHAIN_EFFECT_SCHEMA_VERSION, isChainEffectAnalysisArtifact, parseChainEffectAnalysis, toChainEffectArtifact, } from "./contract.js";
+// --- presentational charts ---
+export { NodeEffectForest } from "./NodeEffectForest.js";
+export { PositionEffectHeatmap } from "./PositionEffectHeatmap.js";
+export { SequenceEffectHeatmap } from "./SequenceEffectHeatmap.js";
+export { ChainScoreBeeswarm } from "./ChainScoreBeeswarm.js";
+// --- the interactive explorers ---
+export { ChainExplorer } from "./ChainExplorer.js";
+export { ChainNodeOrbit } from "./ChainNodeOrbit.js";
+export { ChainNodeHub } from "./ChainNodeHub.js";
+//# sourceMappingURL=index.js.map

package/dist/chains/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chains/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,gDAAgD;AAChD,cAAc,YAAY,CAAC;AAE3B,+CAA+C;AAC/C,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEzF,kDAAkD;AAClD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAClH,OAAO,EACL,IAAI,EACJ,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,EACb,QAAQ,GAOT,MAAM,eAAe,CAAC;AAEvB,0CAA0C;AAC1C,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,EACxB,qBAAqB,GAMtB,MAAM,eAAe,CAAC;AAEvB,gCAAgC;AAChC,OAAO,EAAE,gBAAgB,EAA+C,MAAM,uBAAuB,CAAC;AACtG,OAAO,EAAE,qBAAqB,EAAmC,MAAM,4BAA4B,CAAC;AACpG,OAAO,EAAE,qBAAqB,EAAmC,MAAM,4BAA4B,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAgC,MAAM,yBAAyB,CAAC;AAE3F,oCAAoC;AACpC,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAA4B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC"}

package/dist/chains/normalize.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Score normalization — turn raw scored chains into a comparable "goodness".
+ *
+ * Pure, framework-free. This is the *descriptive* normalizer: the same
+ * view-model tier as `viz/geometry`. The authoritative, lineage-tracked
+ * normalization is a `dag-ml` coordination concern; when its artifact is
+ * available the goodness is read from it verbatim ({@link file://./contract.ts})
+ * and this module is bypassed.
+ */
+import type { ChainMetric, ChainPoint, ChainStep, ChainTokenRef, ScoredChain, ScoreLens } from "./types.js";
+/** Orient a score so higher is always better. */
+export declare function orientedValue(score: number, lowerIsBetter: boolean): number;
+/**
+ * Percentile rank of each value within the list, in `[0, 1]` (1 = largest).
+ * Ties share their averaged rank. A single value maps to `0.5`.
+ */
+export declare function percentileRanks(values: readonly number[]): number[];
+/** Sample z-score of each value (mean 0, unit sd); a zero-spread list → all 0. */
+export declare function zScores(values: readonly number[]): number[];
+/** First-occurrence-ordered, deduped token references for a step list. */
+export declare function dedupeOrderedTokens(steps: readonly ChainStep[]): ChainTokenRef[];
+/**
+ * Project scored chains to comparable {@link ChainPoint}s under a lens.
+ * Chains with a non-finite score should be filtered out by the caller.
+ */
+export declare function computeChainPoints(chains: readonly ScoredChain[], metric: ChainMetric, lens: ScoreLens): ChainPoint[];
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/chains/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5G,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,MAAM,CAE3E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAenE;AAED,kFAAkF;AAClF,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAM3D;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,aAAa,EAAE,CAShF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,SAAS,GACd,UAAU,EAAE,CAmCd"}

package/dist/chains/normalize.js

@@ -0,0 +1,104 @@
+/**
+ * Score normalization — turn raw scored chains into a comparable "goodness".
+ *
+ * Pure, framework-free. This is the *descriptive* normalizer: the same
+ * view-model tier as `viz/geometry`. The authoritative, lineage-tracked
+ * normalization is a `dag-ml` coordination concern; when its artifact is
+ * available the goodness is read from it verbatim ({@link file://./contract.ts})
+ * and this module is bypassed.
+ */
+import { mean, stdDev } from "../viz/geometry.js";
+import { coerceChainRole } from "./types.js";
+/** Orient a score so higher is always better. */
+export function orientedValue(score, lowerIsBetter) {
+    return lowerIsBetter ? -score : score;
+}
+/**
+ * Percentile rank of each value within the list, in `[0, 1]` (1 = largest).
+ * Ties share their averaged rank. A single value maps to `0.5`.
+ */
+export function percentileRanks(values) {
+    const n = values.length;
+    if (n === 0)
+        return [];
+    if (n === 1)
+        return [0.5];
+    const order = values.map((value, index) => ({ value, index })).sort((a, b) => a.value - b.value);
+    const ranks = new Array(n);
+    let i = 0;
+    while (i < n) {
+        let j = i;
+        while (j + 1 < n && order[j + 1].value === order[i].value)
+            j += 1;
+        const averaged = (i + j) / 2 / (n - 1);
+        for (let k = i; k <= j; k += 1)
+            ranks[order[k].index] = averaged;
+        i = j + 1;
+    }
+    return ranks;
+}
+/** Sample z-score of each value (mean 0, unit sd); a zero-spread list → all 0. */
+export function zScores(values) {
+    if (values.length === 0)
+        return [];
+    const mu = mean(values);
+    const sd = stdDev(values);
+    if (!Number.isFinite(sd) || sd === 0)
+        return values.map(() => 0);
+    return values.map((value) => (value - mu) / sd);
+}
+/** First-occurrence-ordered, deduped token references for a step list. */
+export function dedupeOrderedTokens(steps) {
+    const seen = new Set();
+    const out = [];
+    for (const step of steps) {
+        if (seen.has(step.token))
+            continue;
+        seen.add(step.token);
+        out.push({ token: step.token, label: step.label ?? step.token, role: coerceChainRole(step.role) });
+    }
+    return out;
+}
+/**
+ * Project scored chains to comparable {@link ChainPoint}s under a lens.
+ * Chains with a non-finite score should be filtered out by the caller.
+ */
+export function computeChainPoints(chains, metric, lens) {
+    const oriented = chains.map((chain) => orientedValue(chain.score, metric.lowerIsBetter));
+    const goodness = new Array(chains.length);
+    if (lens === "raw") {
+        for (let i = 0; i < chains.length; i += 1)
+            goodness[i] = oriented[i];
+    }
+    else {
+        const groups = new Map();
+        chains.forEach((chain, index) => {
+            const key = chain.dataset ?? "∗";
+            const bucket = groups.get(key);
+            if (bucket)
+                bucket.push(index);
+            else
+                groups.set(key, [index]);
+        });
+        for (const indices of groups.values()) {
+            const values = indices.map((index) => oriented[index]);
+            const transformed = lens === "rankByDataset" ? percentileRanks(values) : zScores(values);
+            indices.forEach((index, k) => {
+                goodness[index] = transformed[k];
+            });
+        }
+    }
+    return chains.map((chain, index) => {
+        const ordered = dedupeOrderedTokens(chain.steps);
+        return {
+            id: chain.id,
+            score: chain.score,
+            goodness: goodness[index],
+            dataset: chain.dataset ?? "∗",
+            source: chain.source ?? "∗",
+            tokens: ordered.map((token) => token.token),
+            orderedTokens: ordered,
+        };
+    });
+}
+//# sourceMappingURL=normalize.js.map

package/dist/chains/normalize.js.map

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

package/dist/chains/radial.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared radial geometry for the chain sunburst / hub navigators.
+ *
+ * Pure, framework-free SVG path + angle helpers, so {@link ChainNodeOrbit} and
+ * {@link ChainNodeHub} render from one tested source.
+ */
+import type { FlowNode } from "./types.js";
+export declare const TAU: number;
+/** 12 o'clock — where every ring starts, sweeping clockwise. */
+export declare const START: number;
+/** Cartesian point on a circle of radius `r` at `angle` (radians). */
+export declare function polar(cx0: number, cy0: number, r: number, angle: number): [number, number];
+/** Donut segment between two radii and two angles (clockwise). */
+export declare function annularSector(cx0: number, cy0: number, rInner: number, rOuter: number, a0: number, a1: number): string;
+/** Full pie slice from the centre to `rOuter`. */
+export declare function pieSector(cx0: number, cy0: number, rOuter: number, a0: number, a1: number): string;
+/** Deepest level with nodes in a flow tree. */
+export declare function treeDepth(nodes: readonly FlowNode[]): number;
+/** Tangential label rotation (degrees) at a mid-angle, flipped to stay upright. */
+export declare function labelRotation(mid: number): number;
+//# sourceMappingURL=radial.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"radial.d.ts","sourceRoot":"","sources":["../../src/chains/radial.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,GAAG,QAAc,CAAC;AAC/B,gEAAgE;AAChE,eAAO,MAAM,KAAK,QAAe,CAAC;AAElC,sEAAsE;AACtE,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE1F;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAatH;AAED,kDAAkD;AAClD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAKlG;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAI5D;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/chains/radial.js

@@ -0,0 +1,52 @@
+/**
+ * Shared radial geometry for the chain sunburst / hub navigators.
+ *
+ * Pure, framework-free SVG path + angle helpers, so {@link ChainNodeOrbit} and
+ * {@link ChainNodeHub} render from one tested source.
+ */
+import { round } from "../viz/geometry.js";
+export const TAU = Math.PI * 2;
+/** 12 o'clock — where every ring starts, sweeping clockwise. */
+export const START = -Math.PI / 2;
+/** Cartesian point on a circle of radius `r` at `angle` (radians). */
+export function polar(cx0, cy0, r, angle) {
+    return [cx0 + r * Math.cos(angle), cy0 + r * Math.sin(angle)];
+}
+/** Donut segment between two radii and two angles (clockwise). */
+export function annularSector(cx0, cy0, rInner, rOuter, a0, a1) {
+    const large = a1 - a0 > Math.PI ? 1 : 0;
+    const [x0o, y0o] = polar(cx0, cy0, rOuter, a0);
+    const [x1o, y1o] = polar(cx0, cy0, rOuter, a1);
+    const [x1i, y1i] = polar(cx0, cy0, rInner, a1);
+    const [x0i, y0i] = polar(cx0, cy0, rInner, a0);
+    return [
+        `M${round(x0o)} ${round(y0o)}`,
+        `A${round(rOuter)} ${round(rOuter)} 0 ${large} 1 ${round(x1o)} ${round(y1o)}`,
+        `L${round(x1i)} ${round(y1i)}`,
+        `A${round(rInner)} ${round(rInner)} 0 ${large} 0 ${round(x0i)} ${round(y0i)}`,
+        "Z",
+    ].join(" ");
+}
+/** Full pie slice from the centre to `rOuter`. */
+export function pieSector(cx0, cy0, rOuter, a0, a1) {
+    const large = a1 - a0 > Math.PI ? 1 : 0;
+    const [x0, y0] = polar(cx0, cy0, rOuter, a0);
+    const [x1, y1] = polar(cx0, cy0, rOuter, a1);
+    return `M${round(cx0)} ${round(cy0)} L${round(x0)} ${round(y0)} A${round(rOuter)} ${round(rOuter)} 0 ${large} 1 ${round(x1)} ${round(y1)} Z`;
+}
+/** Deepest level with nodes in a flow tree. */
+export function treeDepth(nodes) {
+    let depth = 0;
+    for (const node of nodes)
+        depth = Math.max(depth, 1 + treeDepth(node.children));
+    return depth;
+}
+/** Tangential label rotation (degrees) at a mid-angle, flipped to stay upright. */
+export function labelRotation(mid) {
+    let deg = (mid * 180) / Math.PI + 90;
+    deg = ((deg % 360) + 360) % 360;
+    if (deg > 90 && deg < 270)
+        deg -= 180;
+    return round(deg);
+}
+//# sourceMappingURL=radial.js.map

package/dist/chains/radial.js.map

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