@voila.dev/chart 4.0.0

package/dist/core/types.d.ts

@@ -0,0 +1,305 @@
+/**
+ * The vocabulary of the chart pipeline. A definition lists marks; compiling it
+ * resolves scales from the marks' channels, lays out the guides, and asks each
+ * mark for its scene. The scene is plain data with stable keys: the SVG and
+ * Canvas renderers draw the same scene, and hit-testing, focus, tooltips and
+ * the data table all read it, never the DOM.
+ */
+/** A value a channel can carry onto a scale. */
+export type ChartValue = number | string | Date;
+/** A field of the datum, or a function of it. */
+export type ChartAccessor<TDatum, TValue> = (keyof TDatum & string) | ((datum: TDatum, index: number) => TValue);
+export interface ChartRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface ChartMargin {
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+    readonly left: number;
+}
+/** `[topLeft, topRight, bottomRight, bottomLeft]`, clockwise. */
+export type ChartCorners = readonly [number, number, number, number];
+/** How a line or area joins its points. */
+export type ChartCurve = "linear" | "monotone" | "step";
+export type ChartPositionScaleKind = "linear" | "log" | "time" | "band" | "point";
+/**
+ * One positional scale. Every kind answers the same questions, so a mark never
+ * branches on the kind: `map` places the start of a value's slot, `center` its
+ * middle (they differ only on a band scale), and `invert` reads a pixel back.
+ */
+export interface ChartPositionScale {
+    readonly kind: ChartPositionScaleKind;
+    /** `[min, max]` for continuous kinds, every category for discrete ones. */
+    readonly domain: ReadonlyArray<ChartValue>;
+    readonly range: readonly [number, number];
+    readonly map: (value: ChartValue) => number;
+    readonly center: (value: ChartValue) => number;
+    readonly invert: (pixel: number) => ChartValue;
+    /** Slot width on a band scale, `0` everywhere else. */
+    readonly bandwidth: number;
+    readonly ticks: (count?: number) => ReadonlyArray<ChartValue>;
+    readonly format: (value: ChartValue) => string;
+}
+export interface ChartColorScale {
+    readonly kind: "ordinal" | "sequential";
+    readonly domain: ReadonlyArray<ChartValue>;
+    readonly map: (value: ChartValue) => string;
+}
+export interface ChartScales {
+    readonly x?: ChartPositionScale;
+    readonly y?: ChartPositionScale;
+    readonly color?: ChartColorScale;
+}
+export interface ChartPaint {
+    readonly fill?: string;
+    readonly stroke?: string;
+    readonly strokeWidth?: number;
+    readonly strokeDasharray?: string;
+    readonly strokeLinecap?: "butt" | "round" | "square";
+    readonly strokeLinejoin?: "miter" | "round" | "bevel";
+    readonly opacity?: number;
+    readonly fillOpacity?: number;
+    readonly strokeOpacity?: number;
+}
+export interface ChartTextPaint extends ChartPaint {
+    readonly fontSize?: number;
+    readonly fontWeight?: number;
+    readonly textAnchor?: "start" | "middle" | "end";
+    readonly baseline?: "top" | "middle" | "bottom" | "alphabetic";
+}
+interface SceneNodeBase {
+    /** Stable across renders of the same data: what renderers reconcile on. */
+    readonly key: string;
+    /** The series the node draws, so a legend toggle can hide it. */
+    readonly series?: string;
+    /** A role for styling and tests: "mark", "axis", "grid", "label"… */
+    readonly role?: string;
+}
+export interface SceneGroup extends SceneNodeBase {
+    readonly kind: "group";
+    /** Shifts the children: a facet's cell drawn at its place in the grid. Clips are in the shifted space. */
+    readonly translate?: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly clip?: ChartRect;
+    readonly children: ReadonlyArray<SceneNode>;
+}
+export interface SceneRect extends SceneNodeBase {
+    readonly kind: "rect";
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly corners?: ChartCorners;
+    readonly paint: ChartPaint;
+}
+/** Any outline: a line, an area, a wedge, a country. `d` is SVG path data, which `Path2D` reads as well. */
+export interface ScenePath extends SceneNodeBase {
+    readonly kind: "path";
+    readonly d: string;
+    readonly paint: ChartPaint;
+}
+export interface SceneCircle extends SceneNodeBase {
+    readonly kind: "circle";
+    readonly cx: number;
+    readonly cy: number;
+    readonly r: number;
+    readonly paint: ChartPaint;
+}
+export interface SceneLine extends SceneNodeBase {
+    readonly kind: "line";
+    readonly x1: number;
+    readonly y1: number;
+    readonly x2: number;
+    readonly y2: number;
+    readonly paint: ChartPaint;
+}
+export interface SceneText extends SceneNodeBase {
+    readonly kind: "text";
+    readonly x: number;
+    readonly y: number;
+    readonly text: string;
+    /** Degrees, clockwise, around `(x, y)`. */
+    readonly rotate?: number;
+    readonly paint: ChartTextPaint;
+}
+export type SceneNode = SceneGroup | SceneRect | ScenePath | SceneCircle | SceneLine | SceneText;
+/** The area a pointer has to land in to hit a point, beyond plain proximity. */
+export type ChartHitShape = {
+    readonly kind: "rect";
+    readonly rect: ChartRect;
+} | {
+    readonly kind: "arc";
+    readonly cx: number;
+    readonly cy: number;
+    readonly innerRadius: number;
+    readonly outerRadius: number;
+    /** Degrees clockwise from twelve o'clock. */
+    readonly startAngle: number;
+    readonly endAngle: number;
+};
+/**
+ * One datum as the reader meets it: what the keyboard steps through, what the
+ * tooltip and the live region describe, what the data table lists.
+ */
+export interface ChartPoint<TDatum = unknown> {
+    readonly key: string;
+    readonly markId: string;
+    readonly index: number;
+    readonly datum: TDatum;
+    /** Anchor in chart pixels: where the focus ring and the tooltip go. */
+    readonly x: number;
+    readonly y: number;
+    readonly xValue?: ChartValue;
+    readonly yValue?: ChartValue;
+    readonly series?: string;
+    readonly seriesLabel?: string;
+    readonly color: string;
+    /** What the point reads as, without its series: "March 2026", "Paris". */
+    readonly title: string;
+    /** Its value, formatted: "1 240". */
+    readonly value: string;
+    readonly hit?: ChartHitShape;
+    /** The facet cell the point belongs to, on a faceted chart. */
+    readonly facet?: string;
+}
+export interface ChartLegendItem {
+    readonly key: string;
+    readonly label: string;
+    readonly color: string;
+    readonly shape: "square" | "line" | "dashed" | "dot";
+}
+/**
+ * How the keyboard walks the points. `x` groups every point that shares an x
+ * value into one stop (a column of a multi-series chart), `y` does the same
+ * along y for horizontal bars, `point` visits each point on its own.
+ */
+export type ChartFocusOrder = "x" | "y" | "point";
+export interface ChartScene {
+    readonly width: number;
+    readonly height: number;
+    readonly plot: ChartRect;
+    readonly nodes: ReadonlyArray<SceneNode>;
+    readonly points: ReadonlyArray<ChartPoint>;
+    readonly legend: ReadonlyArray<ChartLegendItem>;
+    readonly focusOrder: ChartFocusOrder;
+    readonly scales: ChartScales;
+    /** Column headings of the data table and tooltip: the axis labels. */
+    readonly xLabel: string;
+    readonly yLabel: string;
+    readonly theme: ChartTheme;
+    readonly locale: string;
+    /** A faceted chart's cells, each with its own plot, in reading order. */
+    readonly cells?: ReadonlyArray<{
+        readonly key: string;
+        readonly label: string;
+        readonly plot: ChartRect;
+    }>;
+    /** The sequential colour scale's ramp, for its legend: the colours and the ends' labels. */
+    readonly colorRamp?: {
+        readonly stops: ReadonlyArray<string>;
+        readonly low: string;
+        readonly high: string;
+    };
+}
+/** The values a mark puts on a scale, so the scale's domain can cover them. */
+export interface ChartChannel {
+    readonly values: ReadonlyArray<ChartValue>;
+    /** Bars need a band; the first mark that asks for one gets it. */
+    readonly discrete?: "band" | "point";
+    /** A bar or an area measures from zero, so zero must be on the scale. */
+    readonly includeZero?: boolean;
+    /** The field the values come from: the axis title when none is given. */
+    readonly label?: string;
+    /** Pixels the mark reaches past its value (a dot's radius), kept inside the plot. */
+    readonly inset?: number;
+    /** Band padding the mark draws best with: cells touch, bars breathe. */
+    readonly padding?: number;
+    /** Outer band padding, when it differs: room for a ridge rising past its row. */
+    readonly paddingOuter?: number;
+}
+/**
+ * A map projection, described without naming the library that implements it
+ * (`@voila.dev/chart/geo` does, with d3-geo). Declared once on the
+ * definition and fitted to the plot, so every map mark draws on the same one.
+ */
+export interface ChartProjection {
+    readonly fit: (plot: ChartRect) => ChartFittedProjection;
+}
+export interface ChartFittedProjection {
+    /** Longitude and latitude to chart pixels; `undefined` when clipped away. */
+    readonly project: (longitude: number, latitude: number) => {
+        x: number;
+        y: number;
+    } | undefined;
+    /** Path data for a GeoJSON object. */
+    readonly path: (geometry: unknown) => string;
+    readonly centroid: (geometry: unknown) => {
+        x: number;
+        y: number;
+    };
+    readonly bounds: (geometry: unknown) => ChartRect;
+}
+export type ChartTextMeasurer = (text: string, fontSize: number, fontWeight?: number) => number;
+export interface ChartTheme {
+    readonly palette: ReadonlyArray<string>;
+    readonly foreground: string;
+    readonly muted: string;
+    readonly grid: string;
+    readonly background: string;
+    readonly fontSize: number;
+}
+export interface ChartMarkContext {
+    readonly scales: ChartScales;
+    readonly plot: ChartRect;
+    readonly theme: ChartTheme;
+    readonly measureText: ChartTextMeasurer;
+    readonly locale: string;
+    /** A colour for a mark with no color channel: its place in the palette. */
+    readonly paletteColor: (index: number) => string;
+    /** The colour of one value of the color channel. */
+    readonly colorOf: (value: ChartValue) => string;
+    /** The display name of one value of the color channel. */
+    readonly seriesLabel: (value: ChartValue) => string;
+    readonly formatX: (value: ChartValue) => string;
+    readonly formatY: (value: ChartValue) => string;
+    readonly markIndex: number;
+    /** The definition's projection, fitted to the plot. Map marks need it. */
+    readonly projection?: ChartFittedProjection;
+}
+export interface ChartMarkScene {
+    readonly nodes: ReadonlyArray<SceneNode>;
+    readonly points?: ReadonlyArray<ChartPoint>;
+    readonly legend?: ReadonlyArray<ChartLegendItem>;
+}
+/**
+ * What every mark factory returns. A cartesian mark declares channels so the
+ * scales cover it; a `frame` mark (pie, treemap, map) owns the whole plot and
+ * ignores the x and y scales.
+ */
+export interface ChartMark {
+    readonly id?: string;
+    readonly coordinate: "cartesian" | "frame";
+    readonly channels: {
+        readonly x?: ChartChannel;
+        readonly y?: ChartChannel;
+        readonly color?: ChartChannel;
+    };
+    /** The keyboard order this mark reads best in. */
+    readonly focusOrder?: ChartFocusOrder;
+    /** `false` when the mark already names its colours itself (a labelled funnel). */
+    readonly colorLegend?: boolean;
+    /** What a frame mark's categories and values are called, for the table and the tooltip. */
+    readonly titles?: {
+        readonly category?: string;
+        readonly value?: string;
+    };
+    readonly render: (context: ChartMarkContext) => ChartMarkScene;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/force/force.d.ts

@@ -0,0 +1,30 @@
+import type { ChartMark } from "../core/types.js";
+export interface ForceNode {
+    readonly id: string;
+    readonly label?: string;
+    /** Colour group. */
+    readonly group?: string;
+}
+export interface ForceLink {
+    readonly source: string;
+    readonly target: string;
+}
+export interface ForceOptions {
+    readonly id?: string;
+    readonly radius?: number;
+    /** Settling steps. More is tidier and slower. */
+    readonly ticks?: number;
+    readonly labels?: boolean;
+    readonly tip?: boolean;
+}
+/**
+ * A network laid out by forces: linked nodes pull together, all nodes push
+ * apart. The simulation runs to rest before drawing, with a fixed seed, so
+ * the picture is the same every time; a reader moves through the nodes with
+ * the keyboard, each announced with how many links it has.
+ */
+export declare function forceGraph(data: {
+    readonly nodes: ReadonlyArray<ForceNode>;
+    readonly links: ReadonlyArray<ForceLink>;
+}, options?: ForceOptions): ChartMark;
+//# sourceMappingURL=force.d.ts.map

package/dist/force/force.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"force.d.ts","sourceRoot":"","sources":["../../src/force/force.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAyB,MAAM,iBAAiB,CAAC;AAExE,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACvB;AAgBD;;;;;GAKG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE;IACL,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACzC,EACD,OAAO,GAAE,YAAiB,GACxB,SAAS,CA0IX"}

package/dist/force/force.js

@@ -0,0 +1,143 @@
+import {
+  forceCenter,
+  forceCollide,
+  forceLink,
+  forceManyBody,
+  forceSimulation,
+  forceX,
+  forceY
+} from "d3-force";
+import { markId } from "../core/marks/shared.js";
+const DEFAULT_RADIUS = 5;
+const DEFAULT_TICKS = 300;
+function seeded(seed) {
+  let state = seed;
+  return () => {
+    state = (state * 1664525 + 1013904223) % 4294967296;
+    return state / 4294967296;
+  };
+}
+function forceGraph(data, options = {}) {
+  const groups = data.nodes.map((node) => node.group ?? "");
+  return {
+    id: options.id,
+    coordinate: "frame",
+    focusOrder: "point",
+    channels: groups.some((group) => group !== "") ? { color: { values: groups.filter((group) => group !== "") } } : {},
+    render(context) {
+      const id = markId(options.id, "force", context);
+      const { plot, theme } = context;
+      const radius = options.radius ?? DEFAULT_RADIUS;
+      const simulated = data.nodes.map((node) => ({
+        ...node
+      }));
+      const links = data.links.map((link) => ({
+        ...link
+      }));
+      const simulation = forceSimulation(simulated).randomSource(seeded(1)).force(
+        "link",
+        forceLink(links).id((node) => node.id).distance(radius * 10)
+      ).force("charge", forceManyBody().strength(-radius * 20)).force("collide", forceCollide(radius * 3)).force("center", forceCenter(0, 0)).force("x", forceX(0).strength(0.08)).force("y", forceY(0).strength(0.08)).stop();
+      simulation.tick(options.ticks ?? DEFAULT_TICKS);
+      const xs = simulated.map((node) => node.x ?? 0);
+      const ys = simulated.map((node) => node.y ?? 0);
+      const [minX, maxX, minY, maxY] = [
+        Math.min(...xs),
+        Math.max(...xs),
+        Math.min(...ys),
+        Math.max(...ys)
+      ];
+      const pad = radius * 2;
+      const scale = Math.min(
+        (plot.width - pad * 2) / Math.max(1, maxX - minX),
+        (plot.height - pad * 2) / Math.max(1, maxY - minY),
+        1.5
+      );
+      const place = (node) => ({
+        x: plot.x + plot.width / 2 + ((node.x ?? 0) - (minX + maxX) / 2) * scale,
+        y: plot.y + plot.height / 2 + ((node.y ?? 0) - (minY + maxY) / 2) * scale
+      });
+      const degree = /* @__PURE__ */ new Map();
+      const nodes = [];
+      for (const link of links) {
+        const source = link.source;
+        const target = link.target;
+        degree.set(source.id, (degree.get(source.id) ?? 0) + 1);
+        degree.set(target.id, (degree.get(target.id) ?? 0) + 1);
+        const from = place(source);
+        const to = place(target);
+        nodes.push({
+          kind: "line",
+          key: `${id}:link:${source.id}:${target.id}`,
+          role: "grid",
+          x1: from.x,
+          y1: from.y,
+          x2: to.x,
+          y2: to.y,
+          paint: { stroke: theme.grid, strokeWidth: 1.5 }
+        });
+      }
+      const points = [];
+      for (const [index, node] of simulated.entries()) {
+        const at = place(node);
+        const color = node.group ? context.colorOf(node.group) : context.paletteColor(0);
+        nodes.push({
+          kind: "circle",
+          key: `${id}:${node.id}`,
+          series: node.group,
+          role: "mark",
+          cx: at.x,
+          cy: at.y,
+          r: radius,
+          paint: { fill: color, stroke: theme.background, strokeWidth: 1.5 }
+        });
+        if (options.labels) {
+          nodes.push({
+            kind: "text",
+            key: `${id}:label:${node.id}`,
+            role: "label",
+            x: at.x + radius + 3,
+            y: at.y,
+            text: node.label ?? node.id,
+            paint: {
+              fill: theme.foreground,
+              fontSize: theme.fontSize - 1,
+              baseline: "middle"
+            }
+          });
+        }
+        if (options.tip !== false) {
+          points.push({
+            key: `${id}:${node.id}`,
+            markId: id,
+            index,
+            datum: node,
+            x: at.x,
+            y: at.y,
+            xValue: node.label ?? node.id,
+            yValue: degree.get(node.id) ?? 0,
+            series: node.group,
+            seriesLabel: node.group,
+            color,
+            title: node.label ?? node.id,
+            value: context.formatY(degree.get(node.id) ?? 0),
+            hit: {
+              kind: "rect",
+              rect: {
+                x: at.x - radius - 2,
+                y: at.y - radius - 2,
+                width: radius * 2 + 4,
+                height: radius * 2 + 4
+              }
+            }
+          });
+        }
+      }
+      return { nodes, points };
+    }
+  };
+}
+export {
+  forceGraph
+};
+//# sourceMappingURL=force.js.map

package/dist/force/force.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/force/force.ts"],
+  "sourcesContent": ["import {\n\tforceCenter,\n\tforceCollide,\n\tforceLink,\n\tforceManyBody,\n\tforceSimulation,\n\tforceX,\n\tforceY,\n\ttype SimulationLinkDatum,\n\ttype SimulationNodeDatum,\n} from \"d3-force\";\nimport { markId } from \"#/core/marks/shared.ts\";\nimport type { ChartMark, ChartPoint, SceneNode } from \"#/core/types.ts\";\n\nexport interface ForceNode {\n\treadonly id: string;\n\treadonly label?: string;\n\t/** Colour group. */\n\treadonly group?: string;\n}\n\nexport interface ForceLink {\n\treadonly source: string;\n\treadonly target: string;\n}\n\nexport interface ForceOptions {\n\treadonly id?: string;\n\treadonly radius?: number;\n\t/** Settling steps. More is tidier and slower. */\n\treadonly ticks?: number;\n\treadonly labels?: boolean;\n\treadonly tip?: boolean;\n}\n\ninterface SimulatedNode extends SimulationNodeDatum, ForceNode {}\n\nconst DEFAULT_RADIUS = 5;\nconst DEFAULT_TICKS = 300;\n\n/** A fixed-seed random stream: the same graph settles the same way on the server and in the browser. */\nfunction seeded(seed: number): () => number {\n\tlet state = seed;\n\treturn () => {\n\t\tstate = (state * 1664525 + 1013904223) % 4294967296;\n\t\treturn state / 4294967296;\n\t};\n}\n\n/**\n * A network laid out by forces: linked nodes pull together, all nodes push\n * apart. The simulation runs to rest before drawing, with a fixed seed, so\n * the picture is the same every time; a reader moves through the nodes with\n * the keyboard, each announced with how many links it has.\n */\nexport function forceGraph(\n\tdata: {\n\t\treadonly nodes: ReadonlyArray<ForceNode>;\n\t\treadonly links: ReadonlyArray<ForceLink>;\n\t},\n\toptions: ForceOptions = {},\n): ChartMark {\n\tconst groups = data.nodes.map((node) => node.group ?? \"\");\n\treturn {\n\t\tid: options.id,\n\t\tcoordinate: \"frame\",\n\t\tfocusOrder: \"point\",\n\t\tchannels: groups.some((group) => group !== \"\")\n\t\t\t? { color: { values: groups.filter((group) => group !== \"\") } }\n\t\t\t: {},\n\t\trender(context) {\n\t\t\tconst id = markId(options.id, \"force\", context);\n\t\t\tconst { plot, theme } = context;\n\t\t\tconst radius = options.radius ?? DEFAULT_RADIUS;\n\t\t\tconst simulated: SimulatedNode[] = data.nodes.map((node) => ({\n\t\t\t\t...node,\n\t\t\t}));\n\t\t\tconst links = data.links.map((link) => ({\n\t\t\t\t...link,\n\t\t\t})) as SimulationLinkDatum<SimulatedNode>[];\n\t\t\tconst simulation = forceSimulation(simulated)\n\t\t\t\t.randomSource(seeded(1))\n\t\t\t\t.force(\n\t\t\t\t\t\"link\",\n\t\t\t\t\tforceLink<SimulatedNode, SimulationLinkDatum<SimulatedNode>>(links)\n\t\t\t\t\t\t.id((node) => node.id)\n\t\t\t\t\t\t.distance(radius * 10),\n\t\t\t\t)\n\t\t\t\t.force(\"charge\", forceManyBody().strength(-radius * 20))\n\t\t\t\t.force(\"collide\", forceCollide(radius * 3))\n\t\t\t\t.force(\"center\", forceCenter(0, 0))\n\t\t\t\t// A gentle pull to the middle keeps separate groups on one picture.\n\t\t\t\t.force(\"x\", forceX(0).strength(0.08))\n\t\t\t\t.force(\"y\", forceY(0).strength(0.08))\n\t\t\t\t.stop();\n\t\t\tsimulation.tick(options.ticks ?? DEFAULT_TICKS);\n\t\t\tconst xs = simulated.map((node) => node.x ?? 0);\n\t\t\tconst ys = simulated.map((node) => node.y ?? 0);\n\t\t\tconst [minX, maxX, minY, maxY] = [\n\t\t\t\tMath.min(...xs),\n\t\t\t\tMath.max(...xs),\n\t\t\t\tMath.min(...ys),\n\t\t\t\tMath.max(...ys),\n\t\t\t];\n\t\t\tconst pad = radius * 2;\n\t\t\tconst scale = Math.min(\n\t\t\t\t(plot.width - pad * 2) / Math.max(1, maxX - minX),\n\t\t\t\t(plot.height - pad * 2) / Math.max(1, maxY - minY),\n\t\t\t\t1.5,\n\t\t\t);\n\t\t\tconst place = (node: SimulatedNode) => ({\n\t\t\t\tx:\n\t\t\t\t\tplot.x + plot.width / 2 + ((node.x ?? 0) - (minX + maxX) / 2) * scale,\n\t\t\t\ty:\n\t\t\t\t\tplot.y +\n\t\t\t\t\tplot.height / 2 +\n\t\t\t\t\t((node.y ?? 0) - (minY + maxY) / 2) * scale,\n\t\t\t});\n\t\t\tconst degree = new Map<string, number>();\n\t\t\tconst nodes: SceneNode[] = [];\n\t\t\tfor (const link of links) {\n\t\t\t\tconst source = link.source as SimulatedNode;\n\t\t\t\tconst target = link.target as SimulatedNode;\n\t\t\t\tdegree.set(source.id, (degree.get(source.id) ?? 0) + 1);\n\t\t\t\tdegree.set(target.id, (degree.get(target.id) ?? 0) + 1);\n\t\t\t\tconst from = place(source);\n\t\t\t\tconst to = place(target);\n\t\t\t\tnodes.push({\n\t\t\t\t\tkind: \"line\",\n\t\t\t\t\tkey: `${id}:link:${source.id}:${target.id}`,\n\t\t\t\t\trole: \"grid\",\n\t\t\t\t\tx1: from.x,\n\t\t\t\t\ty1: from.y,\n\t\t\t\t\tx2: to.x,\n\t\t\t\t\ty2: to.y,\n\t\t\t\t\tpaint: { stroke: theme.grid, strokeWidth: 1.5 },\n\t\t\t\t});\n\t\t\t}\n\t\t\tconst points: ChartPoint[] = [];\n\t\t\tfor (const [index, node] of simulated.entries()) {\n\t\t\t\tconst at = place(node);\n\t\t\t\tconst color = node.group\n\t\t\t\t\t? context.colorOf(node.group)\n\t\t\t\t\t: context.paletteColor(0);\n\t\t\t\tnodes.push({\n\t\t\t\t\tkind: \"circle\",\n\t\t\t\t\tkey: `${id}:${node.id}`,\n\t\t\t\t\tseries: node.group,\n\t\t\t\t\trole: \"mark\",\n\t\t\t\t\tcx: at.x,\n\t\t\t\t\tcy: at.y,\n\t\t\t\t\tr: radius,\n\t\t\t\t\tpaint: { fill: color, stroke: theme.background, strokeWidth: 1.5 },\n\t\t\t\t});\n\t\t\t\tif (options.labels) {\n\t\t\t\t\tnodes.push({\n\t\t\t\t\t\tkind: \"text\",\n\t\t\t\t\t\tkey: `${id}:label:${node.id}`,\n\t\t\t\t\t\trole: \"label\",\n\t\t\t\t\t\tx: at.x + radius + 3,\n\t\t\t\t\t\ty: at.y,\n\t\t\t\t\t\ttext: node.label ?? node.id,\n\t\t\t\t\t\tpaint: {\n\t\t\t\t\t\t\tfill: theme.foreground,\n\t\t\t\t\t\t\tfontSize: theme.fontSize - 1,\n\t\t\t\t\t\t\tbaseline: \"middle\",\n\t\t\t\t\t\t},\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (options.tip !== false) {\n\t\t\t\t\tpoints.push({\n\t\t\t\t\t\tkey: `${id}:${node.id}`,\n\t\t\t\t\t\tmarkId: id,\n\t\t\t\t\t\tindex,\n\t\t\t\t\t\tdatum: node,\n\t\t\t\t\t\tx: at.x,\n\t\t\t\t\t\ty: at.y,\n\t\t\t\t\t\txValue: node.label ?? node.id,\n\t\t\t\t\t\tyValue: degree.get(node.id) ?? 0,\n\t\t\t\t\t\tseries: node.group,\n\t\t\t\t\t\tseriesLabel: node.group,\n\t\t\t\t\t\tcolor,\n\t\t\t\t\t\ttitle: node.label ?? node.id,\n\t\t\t\t\t\tvalue: context.formatY(degree.get(node.id) ?? 0),\n\t\t\t\t\t\thit: {\n\t\t\t\t\t\t\tkind: \"rect\",\n\t\t\t\t\t\t\trect: {\n\t\t\t\t\t\t\t\tx: at.x - radius - 2,\n\t\t\t\t\t\t\t\ty: at.y - radius - 2,\n\t\t\t\t\t\t\t\twidth: radius * 2 + 4,\n\t\t\t\t\t\t\t\theight: radius * 2 + 4,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t},\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn { nodes, points };\n\t\t},\n\t};\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/force/index.d.ts

@@ -0,0 +1,2 @@
+export { type ForceLink, type ForceNode, type ForceOptions, forceGraph, } from "./force.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/force/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,UAAU,GACV,MAAM,kBAAkB,CAAC"}

package/dist/force/index.js

@@ -0,0 +1,7 @@
+import {
+  forceGraph
+} from "./force.js";
+export {
+  forceGraph
+};
+//# sourceMappingURL=index.js.map

package/dist/force/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/force/index.ts"],
+  "sourcesContent": ["export {\n\ttype ForceLink,\n\ttype ForceNode,\n\ttype ForceOptions,\n\tforceGraph,\n} from \"#/force/force.ts\";\n"],
+  "mappings": "AAAA;AAAA,EAIC;AAAA,OACM;",
+  "names": []
+}

package/dist/geo/geo.d.ts

@@ -0,0 +1,59 @@
+import { type GeoPermissibleObjects, type GeoProjection } from "d3-geo";
+import type { ChartAccessor, ChartMark, ChartProjection, ChartValue } from "../core/types.js";
+export type ProjectionName = "equal-earth" | "natural-earth" | "mercator" | "equirectangular" | "orthographic" | "albers-usa"
+/** Conformal conic on France's own standard parallels (Lambert 93's). */
+ | "france";
+/**
+ * GeoJSON as RFC 7946 writes it winds rings counter-clockwise; d3-geo reads
+ * that as "the whole sphere except this region". A shape covering more than
+ * half the globe is that mistake, so its rings are turned round.
+ */
+export declare function rewind<T>(object: T): T;
+export interface ProjectionOptions {
+    /** The GeoJSON the map should frame: usually the shapes it draws. */
+    readonly domain: GeoPermissibleObjects;
+    /** Pixels kept clear around the framed shape. */
+    readonly inset?: number;
+}
+/**
+ * How longitude and latitude become pixels, fitted so `domain` fills the
+ * plot. A name picks one of the usual projections; any d3-geo projection
+ * factory works too.
+ */
+export declare function projection(kind: ProjectionName | (() => GeoProjection), options: ProjectionOptions): ChartProjection;
+interface Feature {
+    readonly type: "Feature";
+    readonly properties?: Record<string, unknown> | null;
+    readonly geometry: unknown;
+}
+export interface GeoShapeOptions<TFeature> {
+    readonly id?: string;
+    /** A region's name: tooltip, table, live region. */
+    readonly name: ChartAccessor<TFeature, unknown>;
+    /** A value per region: a choropleth on a sequential (numbers) or ordinal (categories) color scale. */
+    readonly color?: ChartAccessor<TFeature, ChartValue>;
+    readonly fill?: string;
+    readonly stroke?: string;
+    /** What the colour values are, for the table heading. */
+    readonly label?: string;
+    readonly tip?: boolean;
+}
+/** Regions, countries, départements: one shape per GeoJSON feature. */
+export declare function geoShape<TFeature extends Feature>(features: ReadonlyArray<TFeature>, options: GeoShapeOptions<TFeature>): ChartMark;
+export interface GeoDotOptions<TDatum> {
+    readonly id?: string;
+    readonly longitude: ChartAccessor<TDatum, ChartValue>;
+    readonly latitude: ChartAccessor<TDatum, ChartValue>;
+    readonly name: ChartAccessor<TDatum, unknown>;
+    /** A radius in pixels, or a field whose values set each dot's area. */
+    readonly r?: number | ChartAccessor<TDatum, ChartValue>;
+    readonly maxRadius?: number;
+    readonly fill?: string;
+    readonly label?: string;
+    readonly value?: ChartAccessor<TDatum, ChartValue>;
+    readonly tip?: boolean;
+}
+/** Places on the map: a dot at each longitude and latitude, sized by a value if asked. */
+export declare function geoDot<TDatum>(data: ReadonlyArray<TDatum>, options: GeoDotOptions<TDatum>): ChartMark;
+export {};
+//# sourceMappingURL=geo.d.ts.map

package/dist/geo/geo.d.ts.map

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