@mstone6969/graph 0.1.0 → 0.2.0

package/dist/charts/lifescience/RamachandranSamples.js

@@ -0,0 +1,235 @@
+import { randomLcg, randomNormal, randomUniform } from "d3";
+// src/charts/lifescience/RamachandranSamples.ts
+var GENERAL_RESIDUES = [
+	"ALA",
+	"LEU",
+	"GLU",
+	"LYS",
+	"SER",
+	"ASP",
+	"THR",
+	"ARG",
+	"ASN",
+	"PHE"
+];
+/** Alpha helix, beta strand, polyproline II and left-handed helix, the populations any protein shows. */
+var GENERAL = [
+	[
+		-63,
+		-43,
+		6,
+		.5
+	],
+	[
+		-118,
+		132,
+		13,
+		.25
+	],
+	[
+		-68,
+		146,
+		9,
+		.18
+	],
+	[
+		58,
+		42,
+		7,
+		.07
+	]
+];
+var GLYCINE = [
+	[
+		82,
+		8,
+		9,
+		.35
+	],
+	[
+		-82,
+		-6,
+		9,
+		.2
+	],
+	[
+		-170,
+		175,
+		9,
+		.25
+	],
+	[
+		90,
+		-172,
+		9,
+		.2
+	]
+];
+var TRANS_PROLINE = [[
+	-63,
+	-33,
+	6,
+	.55
+], [
+	-66,
+	146,
+	7,
+	.45
+]];
+var CIS_PROLINE = [[
+	-75,
+	158,
+	6,
+	.6
+], [
+	-85,
+	0,
+	7,
+	.4
+]];
+var PRE_PROLINE = [
+	[
+		-65,
+		145,
+		9,
+		.55
+	],
+	[
+		-120,
+		140,
+		10,
+		.3
+	],
+	[
+		-62,
+		-38,
+		6,
+		.15
+	]
+];
+var ILE_VAL = [[
+	-115,
+	128,
+	11,
+	.6
+], [
+	-64,
+	-43,
+	5,
+	.4
+]];
+/** Each lands outside the map for its class, so outliers exist to draw on every panel. */
+var PLANTED = [
+	[
+		"ALA",
+		"SER",
+		2,
+		-120,
+		179
+	],
+	[
+		"GLY",
+		"SER",
+		-30,
+		-140,
+		180
+	],
+	[
+		"PRO",
+		"SER",
+		62,
+		30,
+		178
+	],
+	[
+		"PRO",
+		"SER",
+		60,
+		-120,
+		2
+	],
+	[
+		"LEU",
+		"PRO",
+		75,
+		-85,
+		180
+	],
+	[
+		"VAL",
+		"SER",
+		60,
+		100,
+		180
+	]
+];
+/** Synthetic backbone torsions drawn around textbook conformations. They are not measured from any structure. */
+var RamachandranSamples = class {
+	static protein(seed, count = 220) {
+		const source = randomLcg(seed * .6180339887 % 1);
+		const pick = randomUniform.source(source)(0, 1), normal = randomNormal.source(source)(0, 1);
+		const within = (clusters) => {
+			let draw = pick();
+			const cluster = clusters.find((item) => (draw -= item[3]) <= 0) ?? clusters[0];
+			return [cluster[0] + normal() * cluster[2], cluster[1] + normal() * cluster[2]];
+		};
+		const residue = (i) => {
+			const roll = pick();
+			if (roll < .09) return {
+				name: "GLY",
+				next: "SER",
+				spot: within(GLYCINE),
+				omega: 180
+			};
+			if (roll < .14) return {
+				name: "PRO",
+				next: "SER",
+				spot: within(TRANS_PROLINE),
+				omega: 179
+			};
+			if (roll < .17) return {
+				name: "PRO",
+				next: "SER",
+				spot: within(CIS_PROLINE),
+				omega: 3
+			};
+			if (roll < .23) return {
+				name: "ALA",
+				next: "PRO",
+				spot: within(PRE_PROLINE),
+				omega: 180
+			};
+			if (roll < .33) return {
+				name: roll < .28 ? "ILE" : "VAL",
+				next: "SER",
+				spot: within(ILE_VAL),
+				omega: 180
+			};
+			return {
+				name: GENERAL_RESIDUES[i % GENERAL_RESIDUES.length],
+				next: "SER",
+				spot: within(GENERAL),
+				omega: 180
+			};
+		};
+		return [...Array.from({ length: count }, (_, i) => {
+			const { name, next, spot, omega } = residue(i);
+			return {
+				label: `${name} ${i + 1}`,
+				residue: name,
+				nextResidue: next,
+				phi: +spot[0].toFixed(1),
+				psi: +spot[1].toFixed(1),
+				omega
+			};
+		}), ...PLANTED.map(([name, next, phi, psi, omega], i) => ({
+			label: `${name} ${count + i + 1}`,
+			residue: name,
+			nextResidue: next,
+			phi,
+			psi,
+			omega
+		}))];
+	}
+};
+export { RamachandranSamples };

package/dist/charts/lifescience/index.js

@@ -0,0 +1,25 @@
+import { LoessFit } from "./LoessFit.js";
+import { MaPlotSamples } from "./MaPlotSamples.js";
+import { MaMarks, MaNormalization, MaPlot, MaSource } from "./MaPlot.js";
+import { OncoAlteration, OncoGlyph, OncoLayer } from "./OncoGlyph.js";
+import { OncoPrintMatrix, OncoSort } from "./OncoPrintMatrix.js";
+import { OncoPrintSamples } from "./OncoPrintSamples.js";
+import { OncoBars, OncoPrint, OncoTracks, OncoUnaltered } from "./OncoPrint.js";
+import { PedigreeCaption, PedigreeCarrierMark, PedigreeSex } from "./pedigreeEnums.js";
+import { PedigreeLayout } from "./PedigreeLayout.js";
+import { PedigreeRows } from "./PedigreeRows.js";
+import { PedigreeSamples } from "./PedigreeSamples.js";
+import { PedigreeSymbol } from "./PedigreeSymbol.js";
+import { PedigreeChart } from "./PedigreeChart.js";
+import { RamachandranClass, RamachandranPanel, RamachandranRegionStyle, RamachandranVerdict } from "./ramachandranEnums.js";
+import { RamachandranRegions } from "./RamachandranRegions.js";
+import { RamachandranSamples } from "./RamachandranSamples.js";
+import { RamachandranPlot } from "./RamachandranPlot.js";
+// src/charts/lifescience/index.ts
+var lifescienceCatalog = [
+	MaPlot,
+	OncoPrint,
+	PedigreeChart,
+	RamachandranPlot
+];
+export { LoessFit, MaMarks, MaNormalization, MaPlot, MaPlotSamples, MaSource, OncoAlteration, OncoBars, OncoGlyph, OncoLayer, OncoPrint, OncoPrintMatrix, OncoPrintSamples, OncoSort, OncoTracks, OncoUnaltered, PedigreeCaption, PedigreeCarrierMark, PedigreeChart, PedigreeLayout, PedigreeRows, PedigreeSamples, PedigreeSex, PedigreeSymbol, RamachandranClass, RamachandranPanel, RamachandranPlot, RamachandranRegionStyle, RamachandranRegions, RamachandranSamples, RamachandranVerdict, lifescienceCatalog };

package/dist/charts/lifescience/pedigreeEnums.js

@@ -0,0 +1,21 @@
+// src/charts/lifescience/pedigreeEnums.ts
+var PedigreeSex = /* @__PURE__ */ function(PedigreeSex) {
+	PedigreeSex["Male"] = "male";
+	PedigreeSex["Female"] = "female";
+	PedigreeSex["Unknown"] = "unknown";
+	return PedigreeSex;
+}({});
+/** A heterozygote: the central dot of the NSGC standard, or the half-shaded symbol common in textbooks. */
+var PedigreeCarrierMark = /* @__PURE__ */ function(PedigreeCarrierMark) {
+	PedigreeCarrierMark["Dot"] = "dot";
+	PedigreeCarrierMark["HalfFill"] = "half-fill";
+	return PedigreeCarrierMark;
+}({});
+/** What is written under each symbol. */
+var PedigreeCaption = /* @__PURE__ */ function(PedigreeCaption) {
+	PedigreeCaption["Number"] = "number";
+	PedigreeCaption["NumberAndName"] = "number-and-name";
+	PedigreeCaption["None"] = "none";
+	return PedigreeCaption;
+}({});
+export { PedigreeCaption, PedigreeCarrierMark, PedigreeSex };

package/dist/charts/lifescience/ramachandranEnums.js

@@ -0,0 +1,34 @@
+// src/charts/lifescience/ramachandranEnums.ts
+/** MolProbity's six Top8000 reference classes. */
+var RamachandranClass = /* @__PURE__ */ function(RamachandranClass) {
+	RamachandranClass["General"] = "general";
+	RamachandranClass["Glycine"] = "glycine";
+	RamachandranClass["TransProline"] = "trans-proline";
+	RamachandranClass["CisProline"] = "cis-proline";
+	RamachandranClass["PreProline"] = "pre-proline";
+	RamachandranClass["IleVal"] = "ile-val";
+	return RamachandranClass;
+}({});
+/** Which reference map a plot shows: every residue on the general map, or one class on its own. */
+var RamachandranPanel = /* @__PURE__ */ function(RamachandranPanel) {
+	RamachandranPanel["All"] = "all";
+	RamachandranPanel["General"] = "general";
+	RamachandranPanel["Glycine"] = "glycine";
+	RamachandranPanel["TransProline"] = "trans-proline";
+	RamachandranPanel["CisProline"] = "cis-proline";
+	RamachandranPanel["PreProline"] = "pre-proline";
+	RamachandranPanel["IleVal"] = "ile-val";
+	return RamachandranPanel;
+}({});
+var RamachandranRegionStyle = /* @__PURE__ */ function(RamachandranRegionStyle) {
+	RamachandranRegionStyle["Filled"] = "filled";
+	RamachandranRegionStyle["Contour"] = "contour";
+	return RamachandranRegionStyle;
+}({});
+var RamachandranVerdict = /* @__PURE__ */ function(RamachandranVerdict) {
+	RamachandranVerdict["Favoured"] = "favoured";
+	RamachandranVerdict["Allowed"] = "allowed";
+	RamachandranVerdict["Outlier"] = "outlier";
+	return RamachandranVerdict;
+}({});
+export { RamachandranClass, RamachandranPanel, RamachandranRegionStyle, RamachandranVerdict };

package/dist/charts/linesareas/DualAxisChart.js

@@ -10,7 +10,7 @@ import { axisRight, extent, range, scaleLinear } from "d3";
 var RIGHT = 46;
 /**
 * Two measures with different units over the same x. A last resort: the visual relation depends on arbitrary axis ranges,
-* so prefer `IndexedLine` or `SmallMultipleLines`. If you must use it, prefer `Gridlock`, which at least shares gridlines.
+* so prefer `IndexedLine` or `GridPlot`. If you must use it, prefer `Gridlock`, which at least shares gridlines.
 */
 var DualAxisChart = class extends TrendChart {
 	static meta = {

package/dist/charts/linesareas/LineEnums.js

@@ -194,20 +194,6 @@ var RidgeFill = /* @__PURE__ */ function(RidgeFill) {
 	RidgeFill["Line"] = "lines-only";
 	return RidgeFill;
 }({});
-/** Which points of a connected scatter get a dot. */
-var ConnectedDots = /* @__PURE__ */ function(ConnectedDots) {
-	ConnectedDots["Ends"] = "end-dots";
-	ConnectedDots["All"] = "all-dots";
-	ConnectedDots["None"] = "no-dots";
-	return ConnectedDots;
-}({});
-/** Which dates are written along a connected scatter. */
-var ConnectedDates = /* @__PURE__ */ function(ConnectedDates) {
-	ConnectedDates["Ends"] = "end-dates";
-	ConnectedDates["Periodic"] = "periodic-dates";
-	ConnectedDates["None"] = "no-dates";
-	return ConnectedDates;
-}({});
 /** Point every series is rebased to 100 at. */
 var IndexBase = /* @__PURE__ */ function(IndexBase) {
 	IndexBase["First"] = "base-first";
@@ -264,4 +250,4 @@ var ForecastMethod = /* @__PURE__ */ function(ForecastMethod) {
 	ForecastMethod["Mean"] = "mean";
 	return ForecastMethod;
 }({});
-export { AreaBaseline, AreaStackOrder, BumpDirection, BumpStops, BumpWidth, ConnectedDates, ConnectedDots, CumulativeReset, CumulativeUnit, DifferenceView, DualAlignment, DualForm, FacetScale, FanCenter, ForecastMethod, HorizonMode, HorizonScale, IndexBase, LineAggregate, LineBaseline, LineLabels, LineMarkers, LineTrend, RangeCenter, RangeForm, RidgeFill, RidgeScale, RidgeSort, SeasonAlign, SeasonPeriod, SlopeLabels, SlopeSpan, SlopeValue, SparklineBand, SparklineForm, StepLineForm, StepPlacement, ThresholdSide, ThresholdSource };
+export { AreaBaseline, AreaStackOrder, BumpDirection, BumpStops, BumpWidth, CumulativeReset, CumulativeUnit, DifferenceView, DualAlignment, DualForm, FacetScale, FanCenter, ForecastMethod, HorizonMode, HorizonScale, IndexBase, LineAggregate, LineBaseline, LineLabels, LineMarkers, LineTrend, RangeCenter, RangeForm, RidgeFill, RidgeScale, RidgeSort, SeasonAlign, SeasonPeriod, SlopeLabels, SlopeSpan, SlopeValue, SparklineBand, SparklineForm, StepLineForm, StepPlacement, ThresholdSide, ThresholdSource };

package/dist/charts/linesareas/MultiLineChart.js

@@ -7,7 +7,7 @@ import { TrendMath } from "./TrendMath.js";
 import { mean, symbol } from "d3";
 // src/charts/linesareas/MultiLineChart.ts
 var SYMBOLS = Object.values(SymbolKind);
-/** Compare the shape of several series on one axis. Works up to about eight lines; past that use `SmallMultipleLines`. */
+/** Compare the shape of several series on one axis. Works up to about eight lines; past that use `GridPlot`. */
 var MultiLineChart = class extends TrendChart {
 	static meta = {
 		id: "multi-line",

package/dist/charts/linesareas/TrendChart.js

@@ -9,6 +9,10 @@ import { area, extent, line, ticks, utcFormat } from "d3";
 // src/charts/linesareas/TrendChart.ts
 var LABEL_ROOM = 96;
 var TICK_WIDTH = 58;
+/** Below one decade a log axis has too few powers and multiples, so it ticks linearly. */
+var DECADE = 10;
+/** Height of a decade under which 1, 2 and 5 no longer clear each other; 2 sits 0.3 of a decade above 1. */
+var ROOMY_DECADE = 46;
 /** Lines over a shared x: parsing, scales, gaps, direct labels, markers and hover, for the whole module. */
 var TrendChart = class TrendChart extends CartesianChart {
 	static clips = 0;
@@ -118,19 +122,25 @@ var TrendChart = class TrendChart extends CartesianChart {
 		}
 		const scale = Scales.continuous(this.options.scale).domain([lo, hi]).range([height, 0]);
 		if (!log) return scale.nice();
-		return hi / lo < 10 ? Object.assign(scale, { ticks: () => ticks(lo, hi, this.yTicks()) }) : scale;
+		const natural = scale.ticks.bind(scale);
+		return Object.assign(scale, { ticks: (count = this.yTicks()) => {
+			const [low, high] = scale.domain();
+			return high / low < DECADE ? ticks(low, high, count) : natural(count);
+		} });
 	}
-	/** On a wide log axis only 1, 2 and 5 keep a label; the rest would collide. */
+	/** On a log axis of a decade or more only 1, 2 and 5 keep a label, or just the powers of ten where those would collide. */
 	tickFormat(scale) {
 		const [lo, hi] = scale.domain?.() ?? [];
 		if (lo instanceof Date) return (value) => this.streaming && +hi - +lo < 12e4 ? utcFormat("%H:%M:%S")(value) : TrendChart.dateTick(value, +hi - +lo);
 		const format = super.tickFormat(scale);
-		if (!format || !this.logarithmic || !(hi / lo > 20)) return format;
-		return (value) => [
+		if (!format || !("base" in scale) || !(hi / lo >= DECADE)) return format;
+		const [top, bottom] = scale.range?.() ?? [];
+		const kept = Math.abs(bottom - top) / Math.log10(hi / lo) < ROOMY_DECADE ? [1] : [
 			1,
 			2,
 			5
-		].includes(Math.round(+value / 10 ** Math.floor(Math.log10(+value) + 1e-9))) ? format(value) : "";
+		];
+		return (value) => kept.includes(Math.round(+value / 10 ** Math.floor(Math.log10(+value) + 1e-9))) ? format(value) : "";
 	}
 	static dateTick(value, span) {
 		const day = 864e5;

package/dist/charts/linesareas/index.js

@@ -1,4 +1,4 @@
-import { AreaBaseline, AreaStackOrder, BumpDirection, BumpStops, BumpWidth, ConnectedDates, ConnectedDots, CumulativeReset, CumulativeUnit, DifferenceView, DualAlignment, DualForm, FacetScale, FanCenter, ForecastMethod, HorizonMode, HorizonScale, IndexBase, LineAggregate, LineBaseline, LineLabels, LineMarkers, LineTrend, RangeCenter, RangeForm, RidgeFill, RidgeScale, RidgeSort, SeasonAlign, SeasonPeriod, SlopeLabels, SlopeSpan, SlopeValue, SparklineBand, SparklineForm, StepLineForm, StepPlacement, ThresholdSide, ThresholdSource } from "./LineEnums.js";
+import { AreaBaseline, AreaStackOrder, BumpDirection, BumpStops, BumpWidth, CumulativeReset, CumulativeUnit, DifferenceView, DualAlignment, DualForm, FacetScale, FanCenter, ForecastMethod, HorizonMode, HorizonScale, IndexBase, LineAggregate, LineBaseline, LineLabels, LineMarkers, LineTrend, RangeCenter, RangeForm, RidgeFill, RidgeScale, RidgeSort, SeasonAlign, SeasonPeriod, SlopeLabels, SlopeSpan, SlopeValue, SparklineBand, SparklineForm, StepLineForm, StepPlacement, ThresholdSide, ThresholdSource } from "./LineEnums.js";
 import { TrendHover } from "./TrendHover.js";
 import { TrendLabels } from "./TrendLabels.js";
 import { TrendTable, TrendXKind } from "./TrendTable.js";
@@ -19,9 +19,7 @@ import { SparklineChart } from "./SparklineChart.js";
 import { DifferenceChart } from "./DifferenceChart.js";
 import { HorizonChart } from "./HorizonChart.js";
 import { RangeAreaChart } from "./RangeAreaChart.js";
-import { SmallMultipleLines } from "./SmallMultipleLines.js";
 import { RidgeLines } from "./RidgeLines.js";
-import { ConnectedScatterTime } from "./ConnectedScatterTime.js";
 import { DualAxisChart } from "./DualAxisChart.js";
 import { FanChart } from "./FanChart.js";
 import { ThresholdAreaChart } from "./ThresholdAreaChart.js";
@@ -43,13 +41,11 @@ var linesareasCatalog = [
 	DifferenceChart,
 	HorizonChart,
 	RangeAreaChart,
-	SmallMultipleLines,
 	RidgeLines,
-	ConnectedScatterTime,
 	DualAxisChart,
 	FanChart,
 	ThresholdAreaChart,
 	SeasonalLines,
 	ForecastLine
 ];
-export { AreaBaseline, AreaChart, AreaStackOrder, BumpChart, BumpDirection, BumpStops, BumpWidth, ConnectedDates, ConnectedDots, ConnectedScatterTime, CumulativeLine, CumulativeReset, CumulativeUnit, DifferenceChart, DifferenceView, DualAlignment, DualAxisChart, DualForm, FacetScale, FanCenter, FanChart, ForecastLine, ForecastMethod, HorizonChart, HorizonMode, HorizonScale, IndexBase, IndexedLine, LayerOffset, LayeredChart, LineAggregate, LineBaseline, LineChart, LineLabels, LineMarkers, LineTrend, MultiLineChart, RangeAreaChart, RangeCenter, RangeForm, RidgeFill, RidgeLines, RidgeScale, RidgeSort, SeasonAlign, SeasonPeriod, SeasonalLines, SlopeChart, SlopeLabels, SlopeSpan, SlopeValue, SmallMultipleLines, SparklineBand, SparklineChart, SparklineForm, StackedAreaChart, StepChart, StepLineForm, StepPlacement, Streamgraph, ThresholdAreaChart, ThresholdSide, ThresholdSource, TrendChart, TrendHover, TrendLabels, TrendMath, TrendTable, TrendXKind, linesareasCatalog };
+export { AreaBaseline, AreaChart, AreaStackOrder, BumpChart, BumpDirection, BumpStops, BumpWidth, CumulativeLine, CumulativeReset, CumulativeUnit, DifferenceChart, DifferenceView, DualAlignment, DualAxisChart, DualForm, FacetScale, FanCenter, FanChart, ForecastLine, ForecastMethod, HorizonChart, HorizonMode, HorizonScale, IndexBase, IndexedLine, LayerOffset, LayeredChart, LineAggregate, LineBaseline, LineChart, LineLabels, LineMarkers, LineTrend, MultiLineChart, RangeAreaChart, RangeCenter, RangeForm, RidgeFill, RidgeLines, RidgeScale, RidgeSort, SeasonAlign, SeasonPeriod, SeasonalLines, SlopeChart, SlopeLabels, SlopeSpan, SlopeValue, SparklineBand, SparklineChart, SparklineForm, StackedAreaChart, StepChart, StepLineForm, StepPlacement, Streamgraph, ThresholdAreaChart, ThresholdSide, ThresholdSource, TrendChart, TrendHover, TrendLabels, TrendMath, TrendTable, TrendXKind, linesareasCatalog };

package/dist/charts/massive/MassiveChart.js

@@ -1,5 +1,5 @@
 import { CartesianChart } from "../../core/CartesianChart.js";
-import { ExportFormat } from "../../core/ChartExporter.js";
+import { ChartExporter, ExportFormat } from "../../core/ChartExporter.js";
 import { ScaleKind } from "../../core/enums.js";
 import { Scales } from "../../core/Scales.js";
 import { CanvasSurface } from "./CanvasSurface.js";
@@ -122,7 +122,8 @@ var MassiveChart = class extends CartesianChart {
 		return [
 			ExportFormat.SVG,
 			ExportFormat.PNG,
-			...rows ? [ExportFormat.CSV] : []
+			ExportFormat.PDF,
+			...ChartExporter.tabular(rows ?? 0)
 		];
 	}
 	/** A patch naming `data` may hold the same array, written to in place. */

package/dist/charts/mathematical/FourierSeriesChart.js

@@ -23,6 +23,7 @@ var FourierView = /* @__PURE__ */ function(FourierView) {
 var SAMPLES = 256;
 var TAU = Math.PI * 2;
 var MOMENT = .13;
+var ISO_DATE = /^\d{4}-\d{2}(-\d{2})?/;
 var WAVES = {
 	["square"]: (t) => t < .5 ? 1 : -1,
 	["sawtooth"]: (t) => 2 * t - 1,
@@ -77,11 +78,16 @@ var FourierSeriesChart = class FourierSeriesChart extends MathPlane {
 			left: 42
 		};
 	}
+	/** A row's place along the period, NaN when it has none. */
+	static position(cell) {
+		if (cell === null || cell === void 0 || cell === "") return NaN;
+		return typeof cell === "string" && ISO_DATE.test(cell) ? Date.parse(cell) : +cell;
+	}
 	signal() {
 		const { wave, data, x, y } = this.options;
 		const ts = Array.from({ length: SAMPLES }, (_, i) => i / SAMPLES);
 		if (wave !== "data") return ts.map(WAVES[wave]);
-		const points = data.map((row) => [+row[x], row[y] === null ? NaN : +row[y]]).filter((p) => Number.isFinite(p[0]) && Number.isFinite(p[1]));
+		const points = data.map((row) => [FourierSeriesChart.position(row[x]), row[y] === null ? NaN : +row[y]]).filter((p) => Number.isFinite(p[0]) && Number.isFinite(p[1]));
 		if (!points.length) return ts.map(() => 0);
 		const a = Math.min(...points.map((p) => p[0])), b = Math.max(...points.map((p) => p[0]));
 		const fn = MathNumerics.interpolate(points);

package/dist/charts/mathematical/index.js

@@ -12,14 +12,12 @@ import { LissajousChart, LissajousLayout, LissajousRatio, LissajousView } from "
 import { FractalRegion, FractalSet, FractalShading, MandelbrotChart } from "./MandelbrotChart.js";
 import { NumberLineArrangement, NumberLineChart, NumberLineMark } from "./NumberLineChart.js";
 import { ParametricForm, ParametricPlot, ParametricTrace } from "./ParametricPlot.js";
-import { ParametricSurface3D, SurfaceForm, SurfaceRender } from "./ParametricSurface3D.js";
 import { FieldForm, FieldPlot } from "./FieldPlot.js";
 import { PhaseBackdrop, PhasePortrait, PhaseSystem } from "./PhasePortrait.js";
 import { PolarConvention, PolarCurveForm, PolarCurvePlot } from "./PolarCurvePlot.js";
 import { RiemannMethod, RiemannSumChart } from "./RiemannSumChart.js";
 import { SetRelationChart, SetRelationOrder, SetRelationView } from "./SetRelationChart.js";
 import { SlopeEquation, SlopeFieldChart, SlopeGlyph } from "./SlopeFieldChart.js";
-import { AttractorRender, AttractorSystem, StrangeAttractor3D } from "./StrangeAttractor3D.js";
 import { StreamSeeding, StreamlineChart } from "./StreamlineChart.js";
 import { TaylorFunction, TaylorSeriesChart, TaylorView } from "./TaylorSeriesChart.js";
 import { VectorFieldChart, VectorGlyph, VectorLattice, VectorLength } from "./VectorFieldChart.js";
@@ -44,8 +42,6 @@ var mathematicalCatalog = [
 	FibonacciSpiralChart,
 	SetRelationChart,
 	CobwebPlot,
-	TaylorSeriesChart,
-	StrangeAttractor3D,
-	ParametricSurface3D
+	TaylorSeriesChart
 ];
-export { ArgandDiagram, ArgandView, AttractorRender, AttractorSystem, BifurcationDiagram, BifurcationView, BifurcationWindow, CobwebPlot, CobwebRegime, ComplexDomainColoring, DomainChannel, DomainForm, FibonacciCurve, FibonacciLayout, FibonacciSpiralChart, FieldForm, FieldPlot, FourierSeriesChart, FourierView, FourierWave, FractalRegion, FractalSet, FractalShading, FunctionCompanion, FunctionFill, FunctionPlot, ImplicitForm, ImplicitPlot, ImplicitView, IterationMapKind, LissajousChart, LissajousLayout, LissajousRatio, LissajousView, MandelbrotChart, MathPlane, NumberLineArrangement, NumberLineChart, NumberLineMark, ParametricForm, ParametricPlot, ParametricSurface3D, ParametricTrace, PhaseBackdrop, PhasePortrait, PhaseSystem, PhyllotaxisAngle, PlaneFrame, PlaneTicks, PolarConvention, PolarCurveForm, PolarCurvePlot, RiemannMethod, RiemannSumChart, SetRelationChart, SetRelationOrder, SetRelationView, SlopeEquation, SlopeFieldChart, SlopeGlyph, StrangeAttractor3D, StreamSeeding, StreamlineChart, SurfaceForm, SurfaceRender, TaylorFunction, TaylorSeriesChart, TaylorView, VectorFieldChart, VectorGlyph, VectorLattice, VectorLength, mathematicalCatalog };
+export { ArgandDiagram, ArgandView, BifurcationDiagram, BifurcationView, BifurcationWindow, CobwebPlot, CobwebRegime, ComplexDomainColoring, DomainChannel, DomainForm, FibonacciCurve, FibonacciLayout, FibonacciSpiralChart, FieldForm, FieldPlot, FourierSeriesChart, FourierView, FourierWave, FractalRegion, FractalSet, FractalShading, FunctionCompanion, FunctionFill, FunctionPlot, ImplicitForm, ImplicitPlot, ImplicitView, IterationMapKind, LissajousChart, LissajousLayout, LissajousRatio, LissajousView, MandelbrotChart, MathPlane, NumberLineArrangement, NumberLineChart, NumberLineMark, ParametricForm, ParametricPlot, ParametricTrace, PhaseBackdrop, PhasePortrait, PhaseSystem, PhyllotaxisAngle, PlaneFrame, PlaneTicks, PolarConvention, PolarCurveForm, PolarCurvePlot, RiemannMethod, RiemannSumChart, SetRelationChart, SetRelationOrder, SetRelationView, SlopeEquation, SlopeFieldChart, SlopeGlyph, StreamSeeding, StreamlineChart, TaylorFunction, TaylorSeriesChart, TaylorView, VectorFieldChart, VectorGlyph, VectorLattice, VectorLength, mathematicalCatalog };

package/dist/charts/matrix/GridPlot.js

@@ -68,7 +68,8 @@ var GridPlot = class extends MatrixSurface {
 			scale: "shared-scale",
 			columns: 3,
 			reference: false,
-			context: false
+			context: false,
+			trend: false
 		};
 	}
 	get blank() {
@@ -116,7 +117,7 @@ var GridPlot = class extends MatrixSurface {
 		return line().x((p) => fx(p.x)).y((p) => fy(p.y)).curve(panel === "step-panels" ? curveStepAfter : curveMonotoneX)(points) ?? "";
 	}
 	compose(ctx) {
-		const { panel, scale, reference, context, columns: wanted } = this.options;
+		const { panel, scale, reference, context, trend, columns: wanted } = this.options;
 		const { facets, times } = this.facets();
 		const columns = Math.max(1, Math.min(wanted, facets.length)), rows = Math.ceil(facets.length / columns);
 		const every = facets.flatMap((facet) => facet.points);
@@ -162,6 +163,30 @@ var GridPlot = class extends MatrixSurface {
 			level: d.fy(mean(d.points, (p) => p.y) ?? 0)
 		})) : [];
 		ctx.marks("means", "line", means, (d) => d.name).attr("x1", left).attr("x2", (d) => left(d) + panelW).attr("y1", (d) => top(d) + d.level).attr("y2", (d) => top(d) + d.level).attr("stroke", ctx.theme.inkMuted).attr("stroke-dasharray", "3 3");
+		const fits = trend ? panels.flatMap((d) => {
+			const meanX = mean(d.points, (p) => p.x) ?? 0, meanY = mean(d.points, (p) => p.y) ?? 0;
+			const spread = d.points.reduce((sum, p) => sum + (p.x - meanX) ** 2, 0);
+			if (d.points.length < 2 || !spread) return [];
+			const slope = d.points.reduce((sum, p) => sum + (p.x - meanX) * (p.y - meanY), 0) / spread;
+			const at = (x) => d.fy(meanY + slope * (x - meanX));
+			const [from, to] = extent(d.points, (p) => p.x);
+			const [x1, x2, y1, y2] = [
+				fx(from),
+				fx(to),
+				at(from),
+				at(to)
+			];
+			const edge = (y) => Math.max(0, Math.min(panelH, y));
+			const inset = (y, other) => edge(y) === y ? 0 : (edge(y) - y) / (other - y);
+			return [{
+				...d,
+				x1: x1 + (x2 - x1) * inset(y1, y2),
+				x2: x2 - (x2 - x1) * inset(y2, y1),
+				y1: edge(y1),
+				y2: edge(y2)
+			}];
+		}) : [];
+		ctx.marks("trends", "line", fits, (d) => d.name).attr("x1", (d) => left(d) + d.x1).attr("x2", (d) => left(d) + d.x2).attr("y1", (d) => top(d) + d.y1).attr("y2", (d) => top(d) + d.y2).attr("stroke", ctx.theme.ink).attr("stroke-width", 1.5);
 		const ticksY = panels.filter((d) => free || d.column === 0).flatMap((d) => d.fy.ticks(3).map((tick) => ({
 			key: `${d.name}/${tick}`,
 			d,

package/dist/charts/matrix/TilegramChart.js

@@ -1,6 +1,6 @@
 import { ChartFamily, DataShape, Dimension } from "../../core/enums.js";
 import { Scales } from "../../core/Scales.js";
-import { SampleData } from "../../data/SampleData.js";
+import { WorldSample } from "../../data/WorldSample.js";
 import { MatrixGlyphs } from "./MatrixGlyphs.js";
 import { MatrixGlyph } from "./matrixEnums.js";
 import { MatrixSurface } from "./MatrixSurface.js";
@@ -43,7 +43,7 @@ var TilegramChart = class extends MatrixSurface {
 			"hex map",
 			"cartogram"
 		],
-		sample: (seed) => SampleData.world(seed).features.map((feature) => {
+		sample: (seed) => WorldSample.countries(seed).features.map((feature) => {
 			const [lon, lat] = geoCentroid(feature);
 			const name = String(feature.properties?.name);
 			return {

package/dist/charts/mlcharts/AttentionGrid.js

@@ -0,0 +1,79 @@
+import { WideLabel } from "./WideLabel.js";
+// src/charts/mlcharts/AttentionGrid.ts
+var GAP = 14;
+var TITLE = 16;
+var FLAT = 16;
+/** Height one line of 11px text needs. */
+var BAND = 13;
+var MAX_HEADER = 72;
+/** Places one or more token grids in the plot, with labels only on the outer edges, since heads share tokens. */
+var AttentionGrid = class {
+	static plan({ plot, rows, columns, panels, square, titled, right, top, bottom, minGutter }) {
+		const title = titled ? TITLE : 0, below = top > 0;
+		const gutter = Math.min(plot.width * .26, Math.max(minGutter, Math.max(...rows.map((row) => WideLabel.width(row))) + 8));
+		const longest = Math.max(...columns.map((column) => WideLabel.width(column)));
+		const solve = (header) => {
+			let best = {
+				across: 1,
+				cw: 0,
+				ch: 0,
+				score: -1
+			};
+			for (let across = 1; across <= panels; across++) {
+				const lines = Math.ceil(panels / across);
+				const width = (plot.width - gutter - right - (across - 1) * GAP) / across;
+				const height = (plot.height - header - top - bottom - lines * title - (lines - 1) * GAP) / lines;
+				let cw = Math.max(1, width / columns.length), ch = Math.max(1, height / rows.length);
+				if (square) cw = ch = Math.min(cw, ch);
+				if (Math.min(cw, ch) > best.score) best = {
+					across,
+					cw,
+					ch,
+					score: Math.min(cw, ch)
+				};
+			}
+			return best;
+		};
+		let header = FLAT, fit = solve(header);
+		const flatHeader = longest + 4 <= fit.cw;
+		if (!flatHeader) {
+			header = Math.min(MAX_HEADER, longest + 6, plot.height * .3);
+			fit = solve(header);
+		}
+		const { across, cw, ch } = fit;
+		const width = cw * columns.length, height = ch * rows.length, reserved = below ? top : header;
+		const frames = Array.from({ length: panels }, (_, panel) => {
+			const x = gutter + panel % across * (width + GAP);
+			const y = title + reserved + Math.floor(panel / across) * (height + GAP + title);
+			return {
+				x,
+				y,
+				width,
+				height,
+				cw,
+				ch,
+				radius: 0,
+				header,
+				flatHeader,
+				stagger: false,
+				hex: false,
+				columnLabels: below ? "bottom" : "top",
+				rowLabels: true,
+				cx: (c) => x + cw * (c + .5),
+				cy: (r) => y + ch * (r + .5)
+			};
+		});
+		return {
+			frames,
+			across,
+			gutter,
+			header,
+			flatHeader,
+			below,
+			bottom: Math.max(...frames.map((frame) => frame.y + frame.height)) + (below ? header : 0),
+			rowStep: Math.ceil(BAND / ch),
+			columnStep: flatHeader ? 1 : Math.ceil(BAND / cw)
+		};
+	}
+};
+export { AttentionGrid };