nirs4all-ui 0.1.12 → 0.1.13

package/dist/viz/FeatureImportanceBar.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cx } from "./_cx.js";
+import { makeScale, round, ticks } from "./geometry.js";
+import { N4_VIZ_COLORS } from "./theme.js";
+function defaultFormat(value) {
+    if (!Number.isFinite(value))
+        return "—";
+    if (Math.abs(value) >= 1000)
+        return value.toFixed(0);
+    if (Math.abs(value) >= 1)
+        return value.toFixed(2);
+    return value.toFixed(3);
+}
+function truncate(label, max = 15) {
+    return label.length > max ? `${label.slice(0, max - 1)}…` : label;
+}
+/**
+ * Ranked horizontal-bar chart of the most important features / wavelength
+ * regions — the Studio Variable-Importance view. Sorts by value, keeps the top
+ * N, left-labels each bar and prints its value on the right. Pure inline SVG;
+ * hosts pass precomputed importances.
+ */
+export function FeatureImportanceBar({ items, topN = 12, barColor = N4_VIZ_COLORS.teal, valueFormat = defaultFormat, width = 360, height, title = "Feature importance", className, }) {
+    const keep = Math.max(0, Math.trunc(topN));
+    const sorted = [...items].sort((a, b) => b.value - a.value).slice(0, keep);
+    const resolvedHeight = height ?? Math.max(160, keep * 22 + 48);
+    const padLeft = 96;
+    const padRight = 46;
+    const padTop = 10;
+    const padBottom = 28;
+    const plotLeft = padLeft;
+    const plotRight = width - padRight;
+    const plotTop = padTop;
+    const plotBottom = resolvedHeight - padBottom;
+    const plotHeight = Math.max(0, plotBottom - plotTop);
+    const maxValue = Math.max(0, ...sorted.map((it) => (Number.isFinite(it.value) ? it.value : 0)));
+    const domain = { min: 0, max: maxValue || 1 };
+    const xScale = makeScale(domain, plotLeft, plotRight);
+    const axisTicks = ticks(domain, 4);
+    const n = sorted.length;
+    const band = n > 0 ? plotHeight / n : plotHeight;
+    const barHeight = Math.min(18, Math.max(4, band - 8));
+    return (_jsxs("svg", { className: cx("n4viz", "n4viz-importance", className), viewBox: `0 0 ${width} ${resolvedHeight}`, role: "img", "aria-label": title, preserveAspectRatio: "xMidYMid meet", children: [_jsx("title", { children: title }), axisTicks.map((t) => (_jsx("line", { className: "n4viz-grid", x1: round(xScale(t)), x2: round(xScale(t)), y1: plotTop, y2: plotBottom }, `grid-${t}`))), sorted.map((item, i) => {
+                const center = plotTop + band * i + band / 2;
+                const barEnd = xScale(item.value);
+                return (_jsxs("g", { children: [_jsx("text", { className: "n4viz-tick", x: plotLeft - 6, y: round(center + 3), textAnchor: "end", children: truncate(item.label) }), _jsx("rect", { className: "n4viz-bar", x: plotLeft, y: round(center - barHeight / 2), width: round(Math.max(0, barEnd - plotLeft)), height: round(barHeight), rx: 2, fill: item.color ?? barColor }), _jsx("text", { className: "n4viz-badge", x: round(barEnd + 4), y: round(center + 3), textAnchor: "start", children: valueFormat(item.value) })] }, `${item.label}-${i}`));
+            }), _jsx("line", { className: "n4viz-axis", x1: plotLeft, x2: plotRight, y1: plotBottom, y2: plotBottom }), axisTicks.map((t) => (_jsx("text", { className: "n4viz-tick", x: round(xScale(t)), y: plotBottom + 15, textAnchor: "middle", children: valueFormat(t) }, `tx-${t}`)))] }));
+}
+//# sourceMappingURL=FeatureImportanceBar.js.map

package/dist/viz/FeatureImportanceBar.js.map

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

package/dist/viz/FoldStabilityLines.d.ts

@@ -0,0 +1,29 @@
+import { type PlotPadding } from "./geometry.js";
+/** One model / chain's cross-validation scores, index-aligned to the fold axis. */
+export interface FoldSeries {
+    id: string;
+    label?: string;
+    scores: readonly number[];
+    color?: string;
+}
+export interface FoldStabilityLinesProps {
+    series: readonly FoldSeries[];
+    /** X-axis fold labels (default "F1".."Fn" from the longest series). */
+    foldLabels?: readonly string[];
+    /** Draw the emphasized cross-series mean line + min/max envelope (default true). */
+    showMean?: boolean;
+    width?: number;
+    height?: number;
+    padding?: PlotPadding;
+    yLabel?: string;
+    title?: string;
+    className?: string;
+}
+/**
+ * Per-fold cross-validation stability chart — the Studio Inspector fold-stability
+ * view. One faint line per model/chain across the fold axis, with an emphasized
+ * cross-series mean line and a shaded min/max envelope highlighting agreement.
+ * Pure inline SVG; hosts pass per-fold score arrays.
+ */
+export declare function FoldStabilityLines({ series, foldLabels, showMean, width, height, padding, yLabel, title, className, }: FoldStabilityLinesProps): import("react").JSX.Element;
+//# sourceMappingURL=FoldStabilityLines.d.ts.map

package/dist/viz/FoldStabilityLines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FoldStabilityLines.d.ts","sourceRoot":"","sources":["../../src/viz/FoldStabilityLines.tsx"],"names":[],"mappings":"AACA,OAAO,EASL,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AAGvB,mFAAmF;AACnF,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IAC9B,uEAAuE;IACvE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,UAAU,EACV,QAAe,EACf,KAAW,EACX,MAAY,EACZ,OAAO,EACP,MAAgB,EAChB,KAAwB,EACxB,SAAS,GACV,EAAE,uBAAuB,+BA0HzB"}

package/dist/viz/FoldStabilityLines.js

@@ -0,0 +1,57 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cx } from "./_cx.js";
+import { bandPath, buildFrame, linePath, makeScale, mean, niceExtent, round, ticks, } from "./geometry.js";
+import { categoricalColor, N4_VIZ_COLORS } from "./theme.js";
+function fmt(value) {
+    if (!Number.isFinite(value))
+        return "—";
+    if (Math.abs(value) >= 1000)
+        return value.toFixed(0);
+    if (Math.abs(value) >= 1)
+        return value.toFixed(2);
+    return value.toFixed(3);
+}
+/**
+ * Per-fold cross-validation stability chart — the Studio Inspector fold-stability
+ * view. One faint line per model/chain across the fold axis, with an emphasized
+ * cross-series mean line and a shaded min/max envelope highlighting agreement.
+ * Pure inline SVG; hosts pass per-fold score arrays.
+ */
+export function FoldStabilityLines({ series, foldLabels, showMean = true, width = 460, height = 260, padding, yLabel = "Score", title = "Fold stability", className, }) {
+    const frame = buildFrame(width, height, padding);
+    const { top, left } = frame.padding;
+    const bottom = top + frame.innerHeight;
+    const right = left + frame.innerWidth;
+    const foldCount = series.reduce((m, s) => Math.max(m, s.scores.length), 0);
+    const labels = foldLabels ?? Array.from({ length: foldCount }, (_, i) => `F${i + 1}`);
+    const foldSpan = Math.max(1, foldCount - 1);
+    const xAt = (i) => foldCount <= 1 ? left + frame.innerWidth / 2 : left + (i / foldSpan) * frame.innerWidth;
+    const allScores = series.flatMap((s) => s.scores.filter((v) => Number.isFinite(v)));
+    const yDomain = niceExtent(allScores.length > 0 ? allScores : [0, 1], 0.08);
+    const yScale = makeScale(yDomain, bottom, top);
+    const yTicks = ticks(yDomain, 5);
+    const foldStats = [];
+    for (let i = 0; i < foldCount; i += 1) {
+        const vals = series
+            .map((s) => s.scores[i])
+            .filter((v) => typeof v === "number" && Number.isFinite(v));
+        if (vals.length === 0)
+            continue;
+        foldStats.push({ i, mean: mean(vals), min: Math.min(...vals), max: Math.max(...vals) });
+    }
+    const showEnvelope = showMean && foldStats.length > 0;
+    const meanPoints = foldStats.map((f) => [xAt(f.i), yScale(f.mean)]);
+    const upperPoints = foldStats.map((f) => [xAt(f.i), yScale(f.max)]);
+    const lowerPoints = foldStats.map((f) => [xAt(f.i), yScale(f.min)]);
+    return (_jsxs("svg", { className: cx("n4viz", "n4viz-foldstability", className), viewBox: `0 0 ${width} ${height}`, role: "img", "aria-label": title, preserveAspectRatio: "xMidYMid meet", children: [_jsx("title", { children: title }), yTicks.map((t) => (_jsx("line", { className: "n4viz-grid", x1: left, x2: right, y1: round(yScale(t)), y2: round(yScale(t)) }, `gy-${t}`))), showEnvelope ? (_jsx("path", { className: "n4viz-band", d: bandPath(upperPoints, lowerPoints), fill: N4_VIZ_COLORS.teal, fillOpacity: 0.12, stroke: "none" })) : null, series.map((s, i) => {
+                const points = [];
+                s.scores.forEach((v, fi) => {
+                    if (Number.isFinite(v))
+                        points.push([xAt(fi), yScale(v)]);
+                });
+                if (points.length === 0)
+                    return _jsx("g", {}, s.id);
+                return (_jsx("path", { className: "n4viz-line", d: linePath(points), fill: "none", stroke: s.color ?? categoricalColor(i), strokeOpacity: 0.4, strokeWidth: 1.3 }, s.id));
+            }), showEnvelope ? (_jsx("path", { className: "n4viz-line n4viz-line-mean", d: linePath(meanPoints), fill: "none", stroke: N4_VIZ_COLORS.tealDark, strokeWidth: 2.4, strokeLinecap: "round", strokeLinejoin: "round" })) : null, _jsx("line", { className: "n4viz-axis", x1: left, x2: right, y1: bottom, y2: bottom }), _jsx("line", { className: "n4viz-axis", x1: left, x2: left, y1: top, y2: bottom }), labels.map((label, i) => (_jsx("text", { className: "n4viz-tick", x: round(xAt(i)), y: bottom + 15, textAnchor: "middle", children: label }, `lx-${label}-${i}`))), yTicks.map((t) => (_jsx("text", { className: "n4viz-tick", x: left - 6, y: round(yScale(t)) + 3, textAnchor: "end", children: fmt(t) }, `ty-${t}`))), _jsx("text", { className: "n4viz-axis-label", transform: `translate(11 ${top + frame.innerHeight / 2}) rotate(-90)`, textAnchor: "middle", children: yLabel })] }));
+}
+//# sourceMappingURL=FoldStabilityLines.js.map

package/dist/viz/FoldStabilityLines.js.map

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

package/dist/viz/Histogram.d.ts

@@ -0,0 +1,33 @@
+import { type PlotPadding } from "./geometry.js";
+/** A precomputed categorical bar (e.g. one class of a classification target). */
+export interface HistogramBar {
+    label: string;
+    count: number;
+}
+export interface HistogramProps {
+    /** Raw numeric samples, binned internally (regression variant). */
+    values?: readonly number[];
+    /** Precomputed categorical counts (classification variant). */
+    bins?: readonly HistogramBar[];
+    variant?: "regression" | "classification";
+    /** Number of equal-width bins for the regression variant. */
+    binCount?: number;
+    barColor?: string;
+    /** Draw a dashed vertical mean reference (regression variant only). */
+    meanLine?: boolean;
+    width?: number;
+    height?: number;
+    padding?: PlotPadding;
+    xLabel?: string;
+    yLabel?: string;
+    title?: string;
+    className?: string;
+}
+/**
+ * Bar histogram of a target / score / prediction distribution. Regression bins
+ * raw `values` into equal-width buckets (optionally with a dashed mean line);
+ * classification renders precomputed categorical `bins`. Pure inline SVG — no
+ * chart library, no state.
+ */
+export declare function Histogram({ values, bins, variant, binCount, barColor, meanLine, width, height, padding, xLabel, yLabel, title, className, }: HistogramProps): import("react").JSX.Element;
+//# sourceMappingURL=Histogram.d.ts.map

package/dist/viz/Histogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Histogram.d.ts","sourceRoot":"","sources":["../../src/viz/Histogram.tsx"],"names":[],"mappings":"AACA,OAAO,EAQL,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AAGvB,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,IAAI,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,YAAY,GAAG,gBAAgB,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAaD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,IAAI,EACJ,OAAsB,EACtB,QAAa,EACb,QAA6B,EAC7B,QAAgB,EAChB,KAAW,EACX,MAAY,EACZ,OAAO,EACP,MAAM,EACN,MAAgB,EAChB,KAAsB,EACtB,SAAS,GACV,EAAE,cAAc,+BAqJhB"}

package/dist/viz/Histogram.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cx } from "./_cx.js";
+import { buildFrame, extentOf, histogram, makeScale, mean, round, ticks, } from "./geometry.js";
+import { N4_VIZ_COLORS } from "./theme.js";
+function fmt(value) {
+    if (!Number.isFinite(value))
+        return "—";
+    if (Math.abs(value) >= 1000)
+        return value.toFixed(0);
+    if (Math.abs(value) >= 1)
+        return value.toFixed(1);
+    return value.toFixed(2);
+}
+function fmtCount(value) {
+    return Number.isInteger(value) ? String(value) : value.toFixed(1);
+}
+/**
+ * Bar histogram of a target / score / prediction distribution. Regression bins
+ * raw `values` into equal-width buckets (optionally with a dashed mean line);
+ * classification renders precomputed categorical `bins`. Pure inline SVG — no
+ * chart library, no state.
+ */
+export function Histogram({ values, bins, variant = "regression", binCount = 12, barColor = N4_VIZ_COLORS.teal, meanLine = false, width = 360, height = 220, padding, xLabel, yLabel = "Count", title = "Distribution", className, }) {
+    const frame = buildFrame(width, height, padding);
+    const { top, left } = frame.padding;
+    const bottom = top + frame.innerHeight;
+    const right = left + frame.innerWidth;
+    const isClassification = variant === "classification";
+    const numericBins = isClassification ? [] : histogram(values ?? [], binCount);
+    const categorical = bins ?? [];
+    const counts = isClassification ? categorical.map((b) => b.count) : numericBins.map((b) => b.count);
+    const maxCount = Math.max(1, ...counts.filter((c) => Number.isFinite(c)));
+    const yDomain = { min: 0, max: maxCount };
+    const yScale = makeScale(yDomain, bottom, top);
+    const yTicks = ticks(yDomain, 4);
+    const firstBin = numericBins[0];
+    const lastBin = numericBins[numericBins.length - 1];
+    const xDomain = firstBin && lastBin ? { min: firstBin.x0, max: lastBin.x1 } : extentOf(values ?? []);
+    const xScale = makeScale(xDomain, left, right);
+    const xTicks = ticks(xDomain, 5);
+    const slotW = categorical.length > 0 ? frame.innerWidth / categorical.length : frame.innerWidth;
+    const barW = slotW * 0.62;
+    const rotateLabels = categorical.length > 6;
+    const meanValue = mean(values ?? []);
+    const showMean = meanLine && !isClassification && numericBins.length > 0 && Number.isFinite(meanValue);
+    return (_jsxs("svg", { className: cx("n4viz", "n4viz-histogram", className), viewBox: `0 0 ${width} ${height}`, role: "img", "aria-label": title, preserveAspectRatio: "xMidYMid meet", children: [_jsx("title", { children: title }), yTicks.map((t) => (_jsx("line", { className: "n4viz-grid", x1: left, x2: right, y1: round(yScale(t)), y2: round(yScale(t)) }, `gy-${t}`))), isClassification
+                ? categorical.map((bar, i) => {
+                    const center = left + (i + 0.5) * slotW;
+                    const y = yScale(bar.count);
+                    return (_jsx("rect", { className: "n4viz-bar", x: round(center - barW / 2), y: round(y), width: round(barW), height: round(Math.max(0, bottom - y)), fill: barColor }, `${bar.label}-${i}`));
+                })
+                : numericBins.map((bin, i) => {
+                    const x0 = xScale(bin.x0);
+                    const x1 = xScale(bin.x1);
+                    const y = yScale(bin.count);
+                    return (_jsx("rect", { className: "n4viz-bar", x: round(x0 + 0.5), y: round(y), width: round(Math.max(0, x1 - x0 - 1)), height: round(Math.max(0, bottom - y)), fill: barColor }, `bin-${i}`));
+                }), showMean ? (_jsx("line", { className: "n4viz-reference n4viz-mean", x1: round(xScale(meanValue)), x2: round(xScale(meanValue)), y1: top, y2: bottom, stroke: N4_VIZ_COLORS.amber, strokeDasharray: "5 4", strokeWidth: 1.4 })) : null, _jsx("line", { className: "n4viz-axis", x1: left, x2: right, y1: bottom, y2: bottom }), _jsx("line", { className: "n4viz-axis", x1: left, x2: left, y1: top, y2: bottom }), isClassification
+                ? categorical.map((bar, i) => {
+                    const center = left + (i + 0.5) * slotW;
+                    return rotateLabels ? (_jsx("text", { className: "n4viz-tick", transform: `translate(${round(center)} ${bottom + 12}) rotate(-30)`, textAnchor: "end", children: bar.label }, `lx-${bar.label}-${i}`)) : (_jsx("text", { className: "n4viz-tick", x: round(center), y: bottom + 15, textAnchor: "middle", children: bar.label }, `lx-${bar.label}-${i}`));
+                })
+                : xTicks.map((t) => (_jsx("text", { className: "n4viz-tick", x: round(xScale(t)), y: bottom + 15, textAnchor: "middle", children: fmt(t) }, `tx-${t}`))), yTicks.map((t) => (_jsx("text", { className: "n4viz-tick", x: left - 6, y: round(yScale(t)) + 3, textAnchor: "end", children: fmtCount(t) }, `ty-${t}`))), xLabel ? (_jsx("text", { className: "n4viz-axis-label", x: left + frame.innerWidth / 2, y: height - 2, textAnchor: "middle", children: xLabel })) : null, _jsx("text", { className: "n4viz-axis-label", transform: `translate(11 ${top + frame.innerHeight / 2}) rotate(-90)`, textAnchor: "middle", children: yLabel })] }));
+}
+//# sourceMappingURL=Histogram.js.map

package/dist/viz/Histogram.js.map

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

package/dist/viz/PcaScatter.d.ts

@@ -0,0 +1,36 @@
+import { type PlotPadding } from "./geometry.js";
+/** One projected sample in a 2D embedding (PCA / UMAP / t-SNE). */
+export interface PcaPoint {
+    x: number;
+    y: number;
+    group?: string;
+    value?: number;
+    color?: string;
+}
+export interface PcaScatterProps {
+    points: readonly PcaPoint[];
+    /** How to color points: by categorical group, continuous value, or partition. */
+    colorMode?: "group" | "value" | "partition";
+    /** Explicit group → color overrides (group mode). */
+    groupColors?: Record<string, string>;
+    /** Explained variance fractions → axis labels `PC1 (xx%)` / `PC2 (yy%)`. */
+    explained?: readonly [number, number];
+    xLabel?: string;
+    yLabel?: string;
+    pointRadius?: number;
+    pointOpacity?: number;
+    width?: number;
+    height?: number;
+    padding?: PlotPadding;
+    /** Small swatch legend (top-right); defaults on for categorical modes. */
+    legend?: boolean;
+    title?: string;
+    className?: string;
+}
+/**
+ * 2D projection scatter (PCA / UMAP) colored by categorical group, continuous
+ * value, or train/validation/test partition — the Studio Playground and Web PCA
+ * panel. Pure inline SVG; hosts pass already-projected points.
+ */
+export declare function PcaScatter({ points, colorMode, groupColors, explained, xLabel, yLabel, pointRadius, pointOpacity, width, height, padding, legend, title, className, }: PcaScatterProps): import("react").JSX.Element;
+//# sourceMappingURL=PcaScatter.d.ts.map

package/dist/viz/PcaScatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PcaScatter.d.ts","sourceRoot":"","sources":["../../src/viz/PcaScatter.tsx"],"names":[],"mappings":"AACA,OAAO,EAQL,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AASvB,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;IAC5C,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,4EAA4E;IAC5E,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,SAAmB,EACnB,WAAW,EACX,SAAS,EACT,MAAM,EACN,MAAM,EACN,WAAiB,EACjB,YAAkB,EAClB,KAAW,EACX,MAAY,EACZ,OAAO,EACP,MAAa,EACb,KAAoB,EACpB,SAAS,GACV,EAAE,eAAe,+BAkIjB"}

package/dist/viz/PcaScatter.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cx } from "./_cx.js";
+import { buildFrame, extentOf, makeScale, niceExtent, round, ticks, } from "./geometry.js";
+import { N4_PARTITION_COLORS, N4_VIZ_COLORS, categoricalColor, sequentialColor, } from "./theme.js";
+function fmt(value) {
+    if (!Number.isFinite(value))
+        return "—";
+    if (Math.abs(value) >= 1000)
+        return value.toFixed(0);
+    if (Math.abs(value) >= 1)
+        return value.toFixed(2);
+    return value.toFixed(3);
+}
+/**
+ * 2D projection scatter (PCA / UMAP) colored by categorical group, continuous
+ * value, or train/validation/test partition — the Studio Playground and Web PCA
+ * panel. Pure inline SVG; hosts pass already-projected points.
+ */
+export function PcaScatter({ points, colorMode = "group", groupColors, explained, xLabel, yLabel, pointRadius = 3.5, pointOpacity = 0.8, width = 360, height = 320, padding, legend = true, title = "Projection", className, }) {
+    const frame = buildFrame(width, height, padding);
+    const { top, left } = frame.padding;
+    const bottom = top + frame.innerHeight;
+    const right = left + frame.innerWidth;
+    const xDomain = niceExtent(points.map((p) => p.x), 0.06);
+    const yDomain = niceExtent(points.map((p) => p.y), 0.06);
+    const xScale = makeScale(xDomain, left, right);
+    const yScale = makeScale(yDomain, bottom, top);
+    const xTicks = ticks(xDomain, 5);
+    const yTicks = ticks(yDomain, 5);
+    const valueList = points
+        .map((p) => p.value)
+        .filter((v) => typeof v === "number" && Number.isFinite(v));
+    const valueDomain = extentOf(valueList.length ? valueList : [0, 1]);
+    const groupOrder = [];
+    for (const p of points) {
+        if (p.group != null && !groupOrder.includes(p.group))
+            groupOrder.push(p.group);
+    }
+    const groupColorMap = new Map();
+    groupOrder.forEach((g, i) => {
+        groupColorMap.set(g, groupColors?.[g] ?? categoricalColor(i));
+    });
+    const colorForGroup = (g) => {
+        if (colorMode === "partition") {
+            return g in N4_PARTITION_COLORS ? N4_PARTITION_COLORS[g] : N4_VIZ_COLORS.slate;
+        }
+        return groupColorMap.get(g) ?? N4_VIZ_COLORS.teal;
+    };
+    const resolveColor = (p) => {
+        if (p.color)
+            return p.color;
+        if (colorMode === "value") {
+            if (typeof p.value !== "number" || !Number.isFinite(p.value))
+                return N4_VIZ_COLORS.slate;
+            const span = valueDomain.max - valueDomain.min || 1;
+            return sequentialColor((p.value - valueDomain.min) / span);
+        }
+        if (p.group != null)
+            return colorForGroup(p.group);
+        return N4_VIZ_COLORS.teal;
+    };
+    const showLegend = legend && colorMode !== "value" && groupOrder.length > 0;
+    const resolvedXLabel = xLabel ?? (explained ? `PC1 (${Math.round(explained[0] * 100)}%)` : "PC1");
+    const resolvedYLabel = yLabel ?? (explained ? `PC2 (${Math.round(explained[1] * 100)}%)` : "PC2");
+    return (_jsxs("svg", { className: cx("n4viz", "n4viz-pca", className), viewBox: `0 0 ${width} ${height}`, role: "img", "aria-label": title, preserveAspectRatio: "xMidYMid meet", children: [_jsx("title", { children: title }), xTicks.map((t) => (_jsx("line", { className: "n4viz-grid", x1: round(xScale(t)), x2: round(xScale(t)), y1: top, y2: bottom }, `gx-${t}`))), yTicks.map((t) => (_jsx("line", { className: "n4viz-grid", x1: left, x2: right, y1: round(yScale(t)), y2: round(yScale(t)) }, `gy-${t}`))), points.map((p, i) => (_jsx("circle", { className: "n4viz-dot", cx: round(xScale(p.x)), cy: round(yScale(p.y)), r: pointRadius, fill: resolveColor(p), fillOpacity: pointOpacity }, i))), _jsx("line", { className: "n4viz-axis", x1: left, x2: right, y1: bottom, y2: bottom }), _jsx("line", { className: "n4viz-axis", x1: left, x2: left, y1: top, y2: bottom }), xTicks.map((t) => (_jsx("text", { className: "n4viz-tick", x: round(xScale(t)), y: bottom + 15, textAnchor: "middle", children: fmt(t) }, `tx-${t}`))), yTicks.map((t) => (_jsx("text", { className: "n4viz-tick", x: left - 6, y: round(yScale(t)) + 3, textAnchor: "end", children: fmt(t) }, `ty-${t}`))), _jsx("text", { className: "n4viz-axis-label", x: left + frame.innerWidth / 2, y: height - 2, textAnchor: "middle", children: resolvedXLabel }), _jsx("text", { className: "n4viz-axis-label", transform: `translate(11 ${top + frame.innerHeight / 2}) rotate(-90)`, textAnchor: "middle", children: resolvedYLabel }), showLegend
+                ? groupOrder.map((g, i) => {
+                    const ly = top + 6 + i * 14;
+                    return (_jsxs("g", { className: "n4viz-legend-item", children: [_jsx("rect", { className: "n4viz-swatch", x: round(right - 10), y: round(ly), width: 8, height: 8, rx: 2, fill: colorForGroup(g) }), _jsx("text", { className: "n4viz-legend-label", x: round(right - 14), y: round(ly + 8), textAnchor: "end", children: g })] }, `lg-${g}`));
+                })
+                : null] }));
+}
+//# sourceMappingURL=PcaScatter.js.map

package/dist/viz/PcaScatter.js.map

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

package/dist/viz/PipelineFlow.d.ts

@@ -0,0 +1,28 @@
+/** One step in a nirs4all pipeline / DAG spine. */
+export interface PipelineNode {
+    id: string;
+    label: string;
+    type: "data" | "split" | "preprocess" | "model" | "merge" | "branch";
+    detail?: string;
+    metric?: number;
+    status?: "idle" | "running" | "done" | "failed";
+    variants?: number;
+}
+export interface PipelineFlowProps {
+    /** Steps rendered top → down as a single-column spine. */
+    nodes: readonly PipelineNode[];
+    width?: number;
+    /** Defaults to `nodes.length * 84 + 24`. */
+    height?: number;
+    title?: string;
+    className?: string;
+    /** Override the per-type accent color. */
+    nodeColor?: (type: PipelineNode["type"]) => string;
+}
+/**
+ * Read-only vertical pipeline / DAG view — a simplified spine of the Studio
+ * pipeline editor, Web CanvasFlow, and Inspector BranchTopology. Each step is a
+ * card connected top→down; pure inline SVG, no interaction or layout engine.
+ */
+export declare function PipelineFlow({ nodes, width, height, title, className, nodeColor, }: PipelineFlowProps): import("react").JSX.Element;
+//# sourceMappingURL=PipelineFlow.d.ts.map

package/dist/viz/PipelineFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineFlow.d.ts","sourceRoot":"","sources":["../../src/viz/PipelineFlow.tsx"],"names":[],"mappings":"AAIA,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC;CACpD;AA6BD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,KAAW,EACX,MAAM,EACN,KAAkB,EAClB,SAAS,EACT,SAA4B,GAC7B,EAAE,iBAAiB,+BAgHnB"}

package/dist/viz/PipelineFlow.js

@@ -0,0 +1,57 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cx } from "./_cx.js";
+import { round } from "./geometry.js";
+import { N4_VIZ_COLORS } from "./theme.js";
+const NODE_COLORS = {
+    data: N4_VIZ_COLORS.slate,
+    split: N4_VIZ_COLORS.indigo,
+    preprocess: N4_VIZ_COLORS.cyan,
+    model: N4_VIZ_COLORS.teal,
+    merge: N4_VIZ_COLORS.green,
+    branch: N4_VIZ_COLORS.amber,
+};
+const STATUS_COLORS = {
+    idle: N4_VIZ_COLORS.slate,
+    running: N4_VIZ_COLORS.amber,
+    done: N4_VIZ_COLORS.green,
+    failed: N4_VIZ_COLORS.rose,
+};
+function defaultNodeColor(type) {
+    return NODE_COLORS[type];
+}
+function fmtMetric(value) {
+    if (!Number.isFinite(value))
+        return "—";
+    if (Math.abs(value) >= 1000)
+        return value.toFixed(0);
+    if (Math.abs(value) >= 1)
+        return value.toFixed(2);
+    return value.toFixed(3);
+}
+/**
+ * Read-only vertical pipeline / DAG view — a simplified spine of the Studio
+ * pipeline editor, Web CanvasFlow, and Inspector BranchTopology. Each step is a
+ * card connected top→down; pure inline SVG, no interaction or layout engine.
+ */
+export function PipelineFlow({ nodes, width = 300, height, title = "Pipeline", className, nodeColor = defaultNodeColor, }) {
+    const rowH = 84;
+    const cardH = 60;
+    const marginTop = 12;
+    const cardX = 18;
+    const cardW = Math.max(0, width - 36);
+    const spineX = width / 2;
+    const resolvedHeight = height ?? nodes.length * rowH + 24;
+    return (_jsxs("svg", { className: cx("n4viz", "n4viz-pipeline", className), viewBox: `0 0 ${width} ${resolvedHeight}`, role: "img", "aria-label": title, preserveAspectRatio: "xMidYMid meet", children: [_jsx("title", { children: title }), nodes.map((node, i) => {
+                if (i === 0)
+                    return null;
+                const prevBottom = marginTop + (i - 1) * rowH + cardH;
+                const currentTop = marginTop + i * rowH;
+                return (_jsx("line", { className: "n4viz-edge", x1: round(spineX), x2: round(spineX), y1: round(prevBottom), y2: round(currentTop) }, `edge-${node.id}`));
+            }), nodes.map((node, i) => {
+                const color = nodeColor(node.type);
+                const cardY = marginTop + i * rowH;
+                const cardRight = cardX + cardW;
+                return (_jsxs("g", { className: "n4viz-node", "data-node-type": node.type, children: [_jsx("rect", { className: "n4viz-node-card", x: round(cardX), y: round(cardY), width: round(cardW), height: cardH, rx: 10, fill: `color-mix(in srgb, ${color} 12%, transparent)`, stroke: color, strokeOpacity: 0.7 }), _jsx("rect", { className: "n4viz-node-accent", x: round(cardX), y: round(cardY + 10), width: 4, height: cardH - 20, rx: 2, fill: color }), _jsx("text", { className: "n4viz-node-label", x: round(cardX + 16), y: round(cardY + 24), children: node.label }), node.detail ? (_jsx("text", { className: "n4viz-node-detail", x: round(cardX + 16), y: round(cardY + 42), children: node.detail })) : null, node.status ? (_jsx("circle", { className: "n4viz-node-status", "data-status": node.status, cx: round(cardRight - 14), cy: round(cardY + 14), r: 5, fill: STATUS_COLORS[node.status] })) : null, node.metric != null ? (_jsxs("g", { className: "n4viz-node-metric", children: [_jsx("rect", { x: round(cardRight - 58), y: round(cardY + 30), width: 46, height: 18, rx: 5, fill: `color-mix(in srgb, ${color} 18%, transparent)` }), _jsx("text", { className: "n4viz-node-metric-value", x: round(cardRight - 35), y: round(cardY + 43), textAnchor: "middle", children: fmtMetric(node.metric) })] })) : null, node.variants != null && node.variants > 1 ? (_jsxs("text", { className: "n4viz-badge", x: round(cardRight - 12), y: round(cardY + cardH - 10), textAnchor: "end", children: ["\u00D7", node.variants] })) : null] }, node.id));
+            })] }));
+}
+//# sourceMappingURL=PipelineFlow.js.map

package/dist/viz/PipelineFlow.js.map

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

package/dist/viz/PredictionScatter.d.ts

@@ -0,0 +1,41 @@
+import type { ReactNode } from "react";
+import { type PlotPadding } from "./geometry.js";
+import { type PartitionKey } from "./theme.js";
+/** A single predicted-vs-observed observation. */
+export interface PredictionPoint {
+    actual: number;
+    predicted: number;
+    partition?: PartitionKey;
+    color?: string;
+    label?: string;
+}
+export interface PredictionScatterProps {
+    points: readonly PredictionPoint[];
+    width?: number;
+    height?: number;
+    padding?: PlotPadding;
+    /** Draw the dashed y = x identity line (default true). */
+    identityLine?: boolean;
+    /** Draw the ordinary-least-squares regression fit (default false). */
+    regressionLine?: boolean;
+    /** Optional R² / RMSE readout rendered as a corner badge. */
+    metrics?: {
+        r2?: number;
+        rmse?: number;
+    } | null;
+    pointRadius?: number;
+    pointOpacity?: number;
+    xLabel?: string;
+    yLabel?: string;
+    title?: string;
+    className?: string;
+    children?: ReactNode;
+}
+/**
+ * Predicted-vs-observed (parity) scatter with a dashed identity line and an
+ * optional regression fit — the core regression-diagnostic chart from Studio's
+ * Inspector and the Web results view. Pure inline SVG; hosts pass points and
+ * (optionally) precomputed metrics.
+ */
+export declare function PredictionScatter({ points, width, height, padding, identityLine, regressionLine, metrics, pointRadius, pointOpacity, xLabel, yLabel, title, className, children, }: PredictionScatterProps): import("react").JSX.Element;
+//# sourceMappingURL=PredictionScatter.d.ts.map

package/dist/viz/PredictionScatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PredictionScatter.d.ts","sourceRoot":"","sources":["../../src/viz/PredictionScatter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAQL,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnF,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6DAA6D;IAC7D,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAeD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,KAAW,EACX,MAAY,EACZ,OAAO,EACP,YAAmB,EACnB,cAAsB,EACtB,OAAO,EACP,WAAe,EACf,YAAkB,EAClB,MAAmB,EACnB,MAAoB,EACpB,KAA+B,EAC/B,SAAS,EACT,QAAQ,GACT,EAAE,sBAAsB,+BAuGxB"}