@danielsimonjr/mathts-plot 0.4.1 → 0.4.3

package/README.md

@@ -1,142 +1,142 @@
-# @danielsimonjr/mathts-plot
-
-Headless SVG 2D/3D plotting for [MathTS](https://github.com/danielsimonjr/mathts).
-
-Pure functions returning self-contained SVG strings — no browser, no canvas, no runtime
-dependencies beyond the MathTS bedrock (`core`/`functions`/`expression`). Every function
-coerces its input and never throws on bad data: empty, `NaN`, or `Infinity` inputs render a
-"no data" placeholder SVG instead of crashing. See
-`docs/superpowers/specs/2026-07-07-plotting-design.md` for the design.
-
-## Install
-
-```sh
-npm install @danielsimonjr/mathts-plot
-```
-
-## Usage
-
-Every function below returns a self-contained SVG string (`<svg ...>...</svg>`) — render it
-directly in an `<img src="data:image/svg+xml,...">`, write it to a `.svg` file, or drop it
-into HTML.
-
-### `line` — one series, or overlaid with others
-
-```ts
-import { line } from '@danielsimonjr/mathts-plot';
-
-const svg = line([0, 1, 2, 3], [0, 1, 4, 9], { title: 'squares', xLabel: 'x', yLabel: 'y' });
-// svg === '<svg ...>...</svg>'
-```
-
-### `overlay` — combine several layers on shared, auto-scaled axes
-
-```ts
-import { overlay } from '@danielsimonjr/mathts-plot';
-
-const svg = overlay(
-  [
-    { type: 'line', x: [0, 1, 2], y: [0, 1, 2], label: 'model' },
-    { type: 'scatter', x: [0, 1, 2], y: [0.1, 1.2, 1.8], label: 'data' },
-  ],
-  { legend: true }
-);
-```
-
-### `surface` — 3D surface via orthographic projection + painter's algorithm
-
-```ts
-import { surface } from '@danielsimonjr/mathts-plot';
-
-const z = [
-  [0, 1, 2],
-  [1, 2, 3],
-  [2, 3, 4],
-]; // z[row][col]
-const svg = surface(z, { kind: 'filled', azim: 45, elev: 25 });
-```
-
-### `plot` — generic, polymorphic entry point (including expression strings)
-
-```ts
-import { plot } from '@danielsimonjr/mathts-plot';
-
-// numeric series → line
-plot([0, 1, 4, 9]);
-plot([0, 1, 2, 3], [0, 1, 4, 9]);
-
-// expression string, sampled via functions/expression → line
-plot('sin(x)', { from: 0, to: Math.PI, samples: 200 });
-
-// two free variables → contour (default) or 3D surface
-plot('x^2 + y^2', { from: -2, to: 2 });
-plot('x^2 + y^2', { from: -2, to: 2, kind: 'surface' });
-
-// array of Layer2D → overlay
-plot([
-  { type: 'line', x: [0, 1, 2], y: [0, 1, 2] },
-  { type: 'scatter', x: [0, 1, 2], y: [0.1, 1.2, 1.8] },
-]);
-```
-
-### TikZ / LaTeX output
-
-Every function also accepts `{ format: 'tikz' }` (default is `'svg'`), and there's a
-generic `toTikZ()` mirroring `plot()`. The geometry matches the SVG output exactly (a
-deterministic y-flip maps SVG's top-left origin to TikZ's bottom-left); only
-`\usepackage{tikz}` is required to compile the result.
-
-```ts
-import { toTikZ, line, surface } from '@danielsimonjr/mathts-plot';
-
-// generic entry point, expression source → line
-const tex = toTikZ('sin(x)', { from: 0, to: Math.PI });
-
-// per-type function via the format option
-const tex2 = line([0, 1, 2, 3], [0, 1, 4, 9], { format: 'tikz' });
-
-// standalone: false → a bare tikzpicture for \input, not a compilable document
-const z = [
-  [0, 1, 2],
-  [1, 2, 3],
-  [2, 3, 4],
-];
-const fragment = surface(z, { format: 'tikz', tikz: { standalone: false } });
-```
-
-`toTikZ`/`{ format: 'tikz' }` return a LaTeX string, not SVG. With `standalone`
-(default `true`) the string is a complete `\documentclass{...}` document you can
-compile as-is; `standalone: false` returns just the `tikzpicture` environment, meant
-to be pulled in via `\input{...}` from a larger document.
-
-## What it provides
-
-Per-type mark functions, each `(x, y, opts?) => string` unless noted:
-
-- **2D**: `line`, `scatter`, `bar`, `area`, `step`, `errorbar(x, y, yerr, opts?)`,
-  `quiver(x, y, u, v, opts?)`.
-- **`histogram(data, opts?)`** — bins via `functions.histogram`, then renders bar heights at
-  bin centers.
-- **`heatmap(z, opts?)`** — viridis-colored grid, `z` as `z[row][col]`.
-- **`contour(z, opts?)`** — marching squares over a `z[row][col]` grid.
-- **`overlay(layers, opts?)`** — several `Layer2D`s on shared, auto-scaled axes.
-- **3D**: `surface(z, opts?)` (wireframe or painter's-algorithm filled),
-  `scatter3d(x, y, z, opts?)`, `curve3d(x, y, z, opts?)` — all projected with an orthographic
-  camera (`azim`/`elev`).
-- **`plot(...)`** — generic polymorphic dispatch over numeric series, layer arrays, and
-  expression-source strings (evaluated via `@danielsimonjr/mathts-expression` /
-  `@danielsimonjr/mathts-functions`).
-- **`viridis(t)`** — the perceptually-uniform colormap used by `heatmap`/`contour`/`surface`,
-  exposed for reuse.
-
-Notes:
-
-- Pure ESM, `strict` TypeScript, no runtime dependencies beyond the MathTS bedrock
-  (`core`/`functions`/`expression`).
-- SVG-only in v1 — no PNG/canvas rendering.
-- `workbook` renders its charts through this package (its former private `svg.ts` plotter was
-  removed).
-
-## License
-
-MIT (c) Daniel Simon Jr.
+# @danielsimonjr/mathts-plot
+
+Headless SVG 2D/3D plotting for [MathTS](https://github.com/danielsimonjr/mathts).
+
+Pure functions returning self-contained SVG strings — no browser, no canvas, no runtime
+dependencies beyond the MathTS bedrock (`core`/`functions`/`expression`). Every function
+coerces its input and never throws on bad data: empty, `NaN`, or `Infinity` inputs render a
+"no data" placeholder SVG instead of crashing. See
+`docs/superpowers/specs/2026-07-07-plotting-design.md` for the design.
+
+## Install
+
+```sh
+npm install @danielsimonjr/mathts-plot
+```
+
+## Usage
+
+Every function below returns a self-contained SVG string (`<svg ...>...</svg>`) — render it
+directly in an `<img src="data:image/svg+xml,...">`, write it to a `.svg` file, or drop it
+into HTML.
+
+### `line` — one series, or overlaid with others
+
+```ts
+import { line } from '@danielsimonjr/mathts-plot';
+
+const svg = line([0, 1, 2, 3], [0, 1, 4, 9], { title: 'squares', xLabel: 'x', yLabel: 'y' });
+// svg === '<svg ...>...</svg>'
+```
+
+### `overlay` — combine several layers on shared, auto-scaled axes
+
+```ts
+import { overlay } from '@danielsimonjr/mathts-plot';
+
+const svg = overlay(
+  [
+    { type: 'line', x: [0, 1, 2], y: [0, 1, 2], label: 'model' },
+    { type: 'scatter', x: [0, 1, 2], y: [0.1, 1.2, 1.8], label: 'data' },
+  ],
+  { legend: true }
+);
+```
+
+### `surface` — 3D surface via orthographic projection + painter's algorithm
+
+```ts
+import { surface } from '@danielsimonjr/mathts-plot';
+
+const z = [
+  [0, 1, 2],
+  [1, 2, 3],
+  [2, 3, 4],
+]; // z[row][col]
+const svg = surface(z, { kind: 'filled', azim: 45, elev: 25 });
+```
+
+### `plot` — generic, polymorphic entry point (including expression strings)
+
+```ts
+import { plot } from '@danielsimonjr/mathts-plot';
+
+// numeric series → line
+plot([0, 1, 4, 9]);
+plot([0, 1, 2, 3], [0, 1, 4, 9]);
+
+// expression string, sampled via functions/expression → line
+plot('sin(x)', { from: 0, to: Math.PI, samples: 200 });
+
+// two free variables → contour (default) or 3D surface
+plot('x^2 + y^2', { from: -2, to: 2 });
+plot('x^2 + y^2', { from: -2, to: 2, kind: 'surface' });
+
+// array of Layer2D → overlay
+plot([
+  { type: 'line', x: [0, 1, 2], y: [0, 1, 2] },
+  { type: 'scatter', x: [0, 1, 2], y: [0.1, 1.2, 1.8] },
+]);
+```
+
+### TikZ / LaTeX output
+
+Every function also accepts `{ format: 'tikz' }` (default is `'svg'`), and there's a
+generic `toTikZ()` mirroring `plot()`. The geometry matches the SVG output exactly (a
+deterministic y-flip maps SVG's top-left origin to TikZ's bottom-left); only
+`\usepackage{tikz}` is required to compile the result.
+
+```ts
+import { toTikZ, line, surface } from '@danielsimonjr/mathts-plot';
+
+// generic entry point, expression source → line
+const tex = toTikZ('sin(x)', { from: 0, to: Math.PI });
+
+// per-type function via the format option
+const tex2 = line([0, 1, 2, 3], [0, 1, 4, 9], { format: 'tikz' });
+
+// standalone: false → a bare tikzpicture for \input, not a compilable document
+const z = [
+  [0, 1, 2],
+  [1, 2, 3],
+  [2, 3, 4],
+];
+const fragment = surface(z, { format: 'tikz', tikz: { standalone: false } });
+```
+
+`toTikZ`/`{ format: 'tikz' }` return a LaTeX string, not SVG. With `standalone`
+(default `true`) the string is a complete `\documentclass{...}` document you can
+compile as-is; `standalone: false` returns just the `tikzpicture` environment, meant
+to be pulled in via `\input{...}` from a larger document.
+
+## What it provides
+
+Per-type mark functions, each `(x, y, opts?) => string` unless noted:
+
+- **2D**: `line`, `scatter`, `bar`, `area`, `step`, `errorbar(x, y, yerr, opts?)`,
+  `quiver(x, y, u, v, opts?)`.
+- **`histogram(data, opts?)`** — bins via `functions.histogram`, then renders bar heights at
+  bin centers.
+- **`heatmap(z, opts?)`** — viridis-colored grid, `z` as `z[row][col]`.
+- **`contour(z, opts?)`** — marching squares over a `z[row][col]` grid.
+- **`overlay(layers, opts?)`** — several `Layer2D`s on shared, auto-scaled axes.
+- **3D**: `surface(z, opts?)` (wireframe or painter's-algorithm filled),
+  `scatter3d(x, y, z, opts?)`, `curve3d(x, y, z, opts?)` — all projected with an orthographic
+  camera (`azim`/`elev`).
+- **`plot(...)`** — generic polymorphic dispatch over numeric series, layer arrays, and
+  expression-source strings (evaluated via `@danielsimonjr/mathts-expression` /
+  `@danielsimonjr/mathts-functions`).
+- **`viridis(t)`** — the perceptually-uniform colormap used by `heatmap`/`contour`/`surface`,
+  exposed for reuse.
+
+Notes:
+
+- Pure ESM, `strict` TypeScript, no runtime dependencies beyond the MathTS bedrock
+  (`core`/`functions`/`expression`).
+- SVG-only in v1 — no PNG/canvas rendering.
+- `workbook` renders its charts through this package (its former private `svg.ts` plotter was
+  removed).
+
+## License
+
+MIT (c) Daniel Simon Jr.

package/dist/coerce.d.ts

@@ -0,0 +1,8 @@
+import type { Data } from './types.js';
+/** Flatten + coerce to finite numbers; non-finite entries are dropped. */
+export declare function coerce1d(raw: Data): number[];
+/** Like coerce1d but position-preserving: non-finite stays NaN (no dropping). */
+export declare function coerce1dPositional(raw: Data): number[];
+/** Coerce a 2-D grid; each cell → number (non-finite kept as NaN gaps). */
+export declare function coerce2d(raw: Data): number[][];
+//# sourceMappingURL=coerce.d.ts.map

package/dist/coerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.d.ts","sourceRoot":"","sources":["../src/coerce.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AA6BvC,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,EAAE,CAS5C;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,EAAE,CAItD;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,EAAE,EAAE,CAU9C"}

package/dist/contour.d.ts

@@ -0,0 +1,6 @@
+import type { PlotOptions } from './types.js';
+/** Contour plot via marching squares over grid z[row][col]. */
+export declare function contour(z: unknown, opts?: PlotOptions & {
+    levels?: number;
+}): string;
+//# sourceMappingURL=contour.d.ts.map

package/dist/contour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contour.d.ts","sourceRoot":"","sources":["../src/contour.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,+DAA+D;AAC/D,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,GAAE,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAoFxF"}

package/dist/emit.d.ts

@@ -0,0 +1,5 @@
+import type { Scene } from './scene.js';
+import type { PlotOptions } from './types.js';
+/** Serialize a Scene via the backend chosen by opts.format (default 'svg'). */
+export declare function emit(scene: Scene, opts?: Pick<PlotOptions, 'format' | 'tikz'>): string;
+//# sourceMappingURL=emit.d.ts.map

package/dist/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../src/emit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,+EAA+E;AAC/E,wBAAgB,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,CAAM,GAAG,MAAM,CAE1F"}

package/dist/frame.d.ts

@@ -0,0 +1,4 @@
+import type { Layer2D, PlotOptions } from './types.js';
+/** Shared 2-D rendering core: builds a Scene (axes+ticks+grid+labels+legend+marks). Never throws. */
+export declare function draw2D(layers: Layer2D[], opts?: PlotOptions): string;
+//# sourceMappingURL=frame.d.ts.map

package/dist/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../src/frame.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAiCvD,qGAAqG;AACrG,wBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,MAAM,CA2JxE"}

package/dist/heatmap.d.ts

@@ -0,0 +1,4 @@
+import type { PlotOptions } from './types.js';
+/** Heatmap of a 2-D grid z[row][col], colored by viridis over the data range. */
+export declare function heatmap(z: unknown, opts?: PlotOptions): string;
+//# sourceMappingURL=heatmap.d.ts.map

package/dist/heatmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heatmap.d.ts","sourceRoot":"","sources":["../src/heatmap.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,GAAE,WAAgB,GAAG,MAAM,CA+DlE"}

package/dist/histogram.d.ts

@@ -0,0 +1,6 @@
+import type { PlotOptions } from './types.js';
+/** Histogram: bins via functions.histogram, then renders bar heights at bin centers. */
+export declare function histogram(data: unknown, opts?: PlotOptions & {
+    bins?: number;
+}): string;
+//# sourceMappingURL=histogram.d.ts.map

package/dist/histogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"histogram.d.ts","sourceRoot":"","sources":["../src/histogram.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE,WAAW,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAY3F"}

package/dist/index.d.ts

@@ -1,106 +1,12 @@
-/** Anything the plotter accepts as a data series: numbers, typed arrays, or core values. */
-type Data = unknown;
-/** A 2-D coordinate axis. */
-interface AxisSpec {
-    label?: string;
-    scale?: 'linear' | 'log';
-}
-/** Options shared by all plot functions (each uses the subset it needs). */
-interface PlotOptions {
-    title?: string;
-    xLabel?: string;
-    yLabel?: string;
-    x?: AxisSpec;
-    y?: AxisSpec;
-    width?: number;
-    height?: number;
-    theme?: 'light' | 'dark';
-    palette?: readonly string[];
-    legend?: boolean;
-    from?: number;
-    to?: number;
-    samples?: number;
-    kind?: '2d' | '3d' | 'surface';
-    scope?: Record<string, unknown>;
-    format?: 'svg' | 'tikz';
-    tikz?: {
-        standalone?: boolean;
-        scale?: number;
-    };
-}
-/** One drawable 2-D layer for the shared draw2D core / overlay. */
-interface Layer2D {
-    type: 'line' | 'scatter' | 'bar' | 'area' | 'step' | 'errorbar' | 'quiver';
-    x?: Data;
-    y: Data;
-    yerr?: Data;
-    u?: Data;
-    v?: Data;
-    label?: string;
-    color?: string;
-}
-
-/**
- * Generic entry point. Data forms:
- *   plot(y, opts?)            → line, x = 0..n-1
- *   plot(x, y, opts?)         → line
- *   plot(layers[], opts?)     → overlay
- *   plot(source, opts?)       → expression sampling (line / contour / surface)
- */
-declare function plot(a: unknown, b?: unknown, c?: PlotOptions): string;
-/** Generic TikZ entry — same polymorphism as plot(), forced to the TikZ backend. */
-declare function toTikZ(a: unknown, b?: unknown, c?: PlotOptions): string;
-
-/** Public: line chart of one or many series. */
-declare function line(x: Layer2D['x'], y: Layer2D['y'], opts?: PlotOptions): string;
-/** Public: scatter plot of one or many series. */
-declare function scatter(x: Layer2D['x'], y: Layer2D['y'], opts?: PlotOptions): string;
-/** Public: bar chart of one or many series. */
-declare function bar(x: Layer2D['x'], y: Layer2D['y'], opts?: PlotOptions): string;
-/** Public: filled area under one or many series. */
-declare function area(x: Layer2D['x'], y: Layer2D['y'], opts?: PlotOptions): string;
-/** Public: step chart (horizontal-then-vertical) of one or many series. */
-declare function step(x: Layer2D['x'], y: Layer2D['y'], opts?: PlotOptions): string;
-/** Public: vertical error bars (whisker + point) for one or many series. */
-declare function errorbar(x: Layer2D['x'], y: Layer2D['y'], yerr: Layer2D['yerr'], opts?: PlotOptions): string;
-/** Public: 2-D vector field (arrows) of one or many series. */
-declare function quiver(x: Layer2D['x'], y: Layer2D['y'], u: Layer2D['u'], v: Layer2D['v'], opts?: PlotOptions): string;
-
-/** Histogram: bins via functions.histogram, then renders bar heights at bin centers. */
-declare function histogram(data: unknown, opts?: PlotOptions & {
-    bins?: number;
-}): string;
-
-/** Heatmap of a 2-D grid z[row][col], colored by viridis over the data range. */
-declare function heatmap(z: unknown, opts?: PlotOptions): string;
-
-/** Contour plot via marching squares over grid z[row][col]. */
-declare function contour(z: unknown, opts?: PlotOptions & {
-    levels?: number;
-}): string;
-
-/** Draw several 2-D layers (of any mix of types) on shared auto-scaled axes. */
-declare function overlay(layers: Layer2D[], opts?: PlotOptions): string;
-
-/** 3-D surface z[row][col], projected to 2-D SVG. Painter's algorithm for `filled`. */
-declare function surface(z: unknown, opts?: Omit<PlotOptions, 'kind'> & {
-    azim?: number;
-    elev?: number;
-    kind?: 'wireframe' | 'filled';
-}): string;
-
-interface P3Opts extends PlotOptions {
-    azim?: number;
-    elev?: number;
-}
-/** 3-D scatter of (x,y,z) point triples, projected to 2-D SVG. */
-declare function scatter3d(x: unknown, y: unknown, z: unknown, opts?: P3Opts): string;
-/** Parametric 3-D curve through (x,y,z) coordinate arrays. */
-declare function curve3d(x: unknown, y: unknown, z: unknown, opts?: P3Opts): string;
-
-/** viridis colormap: t in [0,1] → "#rrggbb". */
-declare function viridis(t: number): string;
-
-declare const VERSION: string;
-
-export { type AxisSpec, type Data, type Layer2D, type PlotOptions, VERSION, area, bar, contour, curve3d, errorbar, heatmap, histogram, line, overlay, plot, quiver, scatter, scatter3d, step, surface, toTikZ, viridis };
+export declare const VERSION: string;
+export type { Data, PlotOptions, AxisSpec, Layer2D } from './types.js';
+export { plot, toTikZ } from './plot.js';
+export { line, scatter, bar, area, step, errorbar, quiver } from './marks2d.js';
+export { histogram } from './histogram.js';
+export { heatmap } from './heatmap.js';
+export { contour } from './contour.js';
+export { overlay } from './overlay.js';
+export { surface } from './three/surface.js';
+export { scatter3d, curve3d } from './three/points3d.js';
+export { viridis } from './palette.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO,EAAE,MAAwB,CAAC;AAE/C,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -748,6 +748,12 @@ function project(p, cam) {
 
 // src/three/surface.ts
 var MARGIN3 = 40;
+var DEPTH_EPS = 1e-9;
+function compareDepth(a, b) {
+  const d = b.depth - a.depth;
+  if (Math.abs(d) > DEPTH_EPS) return d;
+  return a.index - b.index;
+}
 function surface(z, opts = {}) {
   const width = opts.width ?? 520;
   const height = opts.height ?? 320;
@@ -826,10 +832,15 @@ function surface(z, opts = {}) {
         const corners = [proj[r][c], proj[r][c + 1], proj[r + 1][c + 1], proj[r + 1][c]];
         const depth = (corners[0][2] + corners[1][2] + corners[2][2] + corners[3][2]) / 4;
         const meanZ = (grid[r][c] + grid[r][c + 1] + grid[r + 1][c + 1] + grid[r + 1][c]) / 4;
-        quads.push({ depth, pts: corners.map(toScreen), shade: (meanZ - zlo) / zspan });
+        quads.push({
+          depth,
+          index: quads.length,
+          pts: corners.map(toScreen),
+          shade: (meanZ - zlo) / zspan
+        });
       }
     }
-    quads.sort((a, b) => b.depth - a.depth);
+    quads.sort(compareDepth);
     for (const q of quads)
       prims.push({ k: "polygon", pts: q.pts, fill: viridis(q.shade), stroke: theme.grid });
   }
@@ -1117,7 +1128,7 @@ function curve3d(x, y, z, opts = {}) {
 }
 
 // src/index.ts
-var VERSION = "0.4.1";
+var VERSION = "0.4.3";
 export {
   VERSION,
   area,

package/dist/marks2d.d.ts

@@ -0,0 +1,16 @@
+import type { Layer2D, PlotOptions } from './types.js';
+/** Public: line chart of one or many series. */
+export declare function line(x: Layer2D['x'], y: Layer2D['y'], opts?: PlotOptions): string;
+/** Public: scatter plot of one or many series. */
+export declare function scatter(x: Layer2D['x'], y: Layer2D['y'], opts?: PlotOptions): string;
+/** Public: bar chart of one or many series. */
+export declare function bar(x: Layer2D['x'], y: Layer2D['y'], opts?: PlotOptions): string;
+/** Public: filled area under one or many series. */
+export declare function area(x: Layer2D['x'], y: Layer2D['y'], opts?: PlotOptions): string;
+/** Public: step chart (horizontal-then-vertical) of one or many series. */
+export declare function step(x: Layer2D['x'], y: Layer2D['y'], opts?: PlotOptions): string;
+/** Public: vertical error bars (whisker + point) for one or many series. */
+export declare function errorbar(x: Layer2D['x'], y: Layer2D['y'], yerr: Layer2D['yerr'], opts?: PlotOptions): string;
+/** Public: 2-D vector field (arrows) of one or many series. */
+export declare function quiver(x: Layer2D['x'], y: Layer2D['y'], u: Layer2D['u'], v: Layer2D['v'], opts?: PlotOptions): string;
+//# sourceMappingURL=marks2d.d.ts.map

package/dist/marks2d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marks2d.d.ts","sourceRoot":"","sources":["../src/marks2d.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvD,gDAAgD;AAChD,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAEjF;AAED,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAEpF;AAED,+CAA+C;AAC/C,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAEhF;AAED,oDAAoD;AACpD,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAEjF;AAED,2EAA2E;AAC3E,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAEjF;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CACtB,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EACf,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EACf,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EACrB,IAAI,CAAC,EAAE,WAAW,GACjB,MAAM,CAER;AAED,+DAA+D;AAC/D,wBAAgB,MAAM,CACpB,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EACf,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EACf,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EACf,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EACf,IAAI,CAAC,EAAE,WAAW,GACjB,MAAM,CAER"}

package/dist/overlay.d.ts

@@ -0,0 +1,4 @@
+import type { Layer2D, PlotOptions } from './types.js';
+/** Draw several 2-D layers (of any mix of types) on shared auto-scaled axes. */
+export declare function overlay(layers: Layer2D[], opts?: PlotOptions): string;
+//# sourceMappingURL=overlay.d.ts.map

package/dist/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../src/overlay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvD,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAErE"}

package/dist/palette.d.ts

@@ -0,0 +1,3 @@
+/** viridis colormap: t in [0,1] → "#rrggbb". */
+export declare function viridis(t: number): string;
+//# sourceMappingURL=palette.d.ts.map

package/dist/palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../src/palette.ts"],"names":[],"mappings":"AAeA,gDAAgD;AAChD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAWzC"}

package/dist/plot.d.ts

@@ -0,0 +1,12 @@
+import type { PlotOptions } from './types.js';
+/**
+ * Generic entry point. Data forms:
+ *   plot(y, opts?)            → line, x = 0..n-1
+ *   plot(x, y, opts?)         → line
+ *   plot(layers[], opts?)     → overlay
+ *   plot(source, opts?)       → expression sampling (line / contour / surface)
+ */
+export declare function plot(a: unknown, b?: unknown, c?: PlotOptions): string;
+/** Generic TikZ entry — same polymorphism as plot(), forced to the TikZ backend. */
+export declare function toTikZ(a: unknown, b?: unknown, c?: PlotOptions): string;
+//# sourceMappingURL=plot.d.ts.map

package/dist/plot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plot.d.ts","sourceRoot":"","sources":["../src/plot.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAW,WAAW,EAAE,MAAM,YAAY,CAAC;AAuEvD;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAMrE;AAED,oFAAoF;AACpF,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAavE"}

package/dist/render-core.d.ts

@@ -0,0 +1,21 @@
+import type { Theme } from './svg.js';
+import type { Layer2D } from './types.js';
+import type { Prim } from './scene.js';
+/**
+ * Shared rendering context, computed once per `draw2D` call and threaded
+ * through every layer's renderer. Lives here (not `frame.ts` or `marks2d.ts`)
+ * so both of those modules can depend on it without depending on each other.
+ */
+export interface Frame {
+    px: (x: number) => number;
+    py: (y: number) => number;
+    xdom: [number, number];
+    ydom: [number, number];
+    theme: Theme;
+    width: number;
+    height: number;
+    color: (i: number) => string;
+}
+/** Dispatch a layer to its renderer (extended in later tasks). */
+export declare function renderLayer(layer: Layer2D, f: Frame, i: number): Prim[];
+//# sourceMappingURL=render-core.d.ts.map

package/dist/render-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-core.d.ts","sourceRoot":"","sources":["../src/render-core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1B,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9B;AAuJD,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAmBvE"}

package/dist/render-file.d.ts

@@ -1,10 +1,10 @@
 /** Thrown when an external tool is missing or a conversion fails. Deliberate
  *  exception to plot's never-throw rule: I/O and missing tools must surface. */
-declare class PlotRenderError extends Error {
+export declare class PlotRenderError extends Error {
     readonly missingTool?: string | undefined;
     constructor(message: string, missingTool?: string | undefined);
 }
-interface RenderOptions {
+export interface RenderOptions {
     tool?: string;
     timeoutMs?: number;
     density?: number;
@@ -17,22 +17,22 @@ interface RunResult {
 }
 /** Spawn a command, feeding optional stdin, collecting stdout/stderr. Rejects
  *  with PlotRenderError(ENOENT) if the binary is not found. */
-declare function runTool(cmd: string, args: string[], opts?: {
+export declare function runTool(cmd: string, args: string[], opts?: {
     timeoutMs?: number;
     input?: string;
 }): Promise<RunResult>;
 /** True if `name` responds to a version probe (i.e. is on PATH). */
-declare function hasTool(name: string): Promise<boolean>;
+export declare function hasTool(name: string): Promise<boolean>;
 /** SVG string → file. Extension of `outPath` selects the target: `.svg` writes
  *  the SVG through; `.png`/`.pdf` convert via rsvg-convert (preferred) or resvg.
  *  Rejects with PlotRenderError naming the tool to install if none is present. */
-declare function renderToFile(svg: string, outPath: string, opts?: RenderOptions): Promise<void>;
+export declare function renderToFile(svg: string, outPath: string, opts?: RenderOptions): Promise<void>;
 /** Build the CLI args for a LaTeX engine. Shell-escape (\write18) is OFF
  *  for security (arbitrary command execution during compile). */
-declare function latexArgs(engine: string, workDir: string, texPath: string): string[];
+export declare function latexArgs(engine: string, workDir: string, texPath: string): string[];
 /** Standalone LaTeX/TikZ source → PDF via pdflatex (preferred) or tectonic.
  *  Compiles in an OS temp dir and copies the resulting PDF to `outPath`.
  *  Rejects with PlotRenderError naming the engine to install if none is found. */
-declare function latexToPdf(texSource: string, outPath: string, opts?: RenderOptions): Promise<void>;
-
-export { PlotRenderError, type RenderOptions, hasTool, latexArgs, latexToPdf, renderToFile, runTool };
+export declare function latexToPdf(texSource: string, outPath: string, opts?: RenderOptions): Promise<void>;
+export {};
+//# sourceMappingURL=render-file.d.ts.map

package/dist/render-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-file.d.ts","sourceRoot":"","sources":["../src/render-file.ts"],"names":[],"mappings":"AAWA;gFACgF;AAChF,qBAAa,eAAgB,SAAQ,KAAK;IAGtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM;IAF/B,YACE,OAAO,EAAE,MAAM,EACN,WAAW,CAAC,EAAE,MAAM,YAAA,EAI9B;CACF;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAID;+DAC+D;AAC/D,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,OAAO,CAAC,SAAS,CAAC,CAuBpB;AAED,oEAAoE;AACpE,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5D;AAED;;kFAEkF;AAClF,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CA2Df;AAED;iEACiE;AACjE,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM,EAAE,CAcV;AAED;;kFAEkF;AAClF,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/scale.d.ts

@@ -0,0 +1,9 @@
+/** [min, max] of a numeric array; a degenerate (flat) range is padded by ±1. */
+export declare function extent(xs: readonly number[]): [number, number];
+/** Linear map from data domain to pixel range. */
+export declare function linearScale(dom: [number, number], range: [number, number]): (v: number) => number;
+/** Log10 map; the domain is clamped to strictly-positive. */
+export declare function logScale(dom: [number, number], range: [number, number]): (v: number) => number;
+/** "Nice" round tick values covering [min,max] (Wilkinson-lite: 1/2/5 × 10^k step). */
+export declare function niceTicks(min: number, max: number, count?: number): number[];
+//# sourceMappingURL=scale.d.ts.map

package/dist/scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale.d.ts","sourceRoot":"","sources":["../src/scale.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wBAAgB,MAAM,CAAC,EAAE,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAU9D;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAKjG;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAM9F;AAED,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAWvE"}

package/dist/scene.d.ts

@@ -0,0 +1,52 @@
+/** Backend-agnostic drawing primitives. Marks build these; a backend serializes them. */
+export type Prim = {
+    k: 'line';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    stroke: string;
+    w: number;
+    opacity?: number;
+} | {
+    k: 'circle';
+    cx: number;
+    cy: number;
+    r: number;
+    fill: string;
+    opacity?: number;
+} | {
+    k: 'rect';
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    fill: string;
+} | {
+    k: 'polyline';
+    pts: Array<[number, number]>;
+    stroke: string;
+    w: number;
+} | {
+    k: 'polygon';
+    pts: Array<[number, number]>;
+    fill: string;
+    stroke: string;
+} | {
+    k: 'text';
+    x: number;
+    y: number;
+    s: string;
+    fill: string;
+    anchor: 'start' | 'middle' | 'end';
+    size: number;
+    rotate?: number;
+};
+/** A complete drawable: canvas size, background, and an ordered list of primitives. */
+export interface Scene {
+    width: number;
+    height: number;
+    bg: string;
+    prims: Prim[];
+}
+//# sourceMappingURL=scene.d.ts.map

package/dist/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,MAAM,IAAI,GACZ;IACE,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACD;IAAE,CAAC,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,CAAC,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,CAAC,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5E;IACE,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,uFAAuF;AACvF,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,IAAI,EAAE,CAAC;CACf"}

package/dist/svg.d.ts

@@ -0,0 +1,22 @@
+import type { Scene } from './scene.js';
+export interface Theme {
+    fg: string;
+    muted: string;
+    grid: string;
+    axis: string;
+    bg: string;
+    series: string[];
+}
+export declare const THEMES: Record<'light' | 'dark', Theme>;
+export declare function esc(s: string): string;
+export declare function fmt(n: number): string;
+export declare function svgDoc(width: number, height: number, body: string, bg: string): string;
+export declare function line(x1: number, y1: number, x2: number, y2: number, stroke: string, w?: number, opacity?: number): string;
+export declare function circle(cx: number, cy: number, r: number, fill: string, opacity?: number): string;
+export declare function rect(x: number, y: number, w: number, h: number, fill: string): string;
+export declare function polyline(pts: Array<[number, number]>, stroke: string, w?: number): string;
+export declare function polygon(pts: Array<[number, number]>, fill: string, stroke?: string): string;
+export declare function text(x: number, y: number, s: string, fill: string, anchor?: string, size?: number): string;
+/** Serialize a Scene to a self-contained SVG string (reuses the exported builders). */
+export declare function emitSVG(scene: Scene): string;
+//# sourceMappingURL=svg.d.ts.map

package/dist/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../src/svg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAQ,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAaD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,EAAE,KAAK,CAiBlD,CAAC;AAEF,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAErC;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAKrC;AAID,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAKtF;AAED,wBAAgB,IAAI,CAClB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,CAAC,SAAI,EACL,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAMR;AACD,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAMhG;AACD,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAErF;AACD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,MAAM,CAGpF;AACD,wBAAgB,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,SAAS,GAAG,MAAM,CAG3F;AACD,wBAAgB,IAAI,CAClB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,MAAM,EACZ,MAAM,SAAU,EAChB,IAAI,SAAK,GACR,MAAM,CAER;AAuBD,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAE5C"}

package/dist/three/points3d.d.ts

@@ -0,0 +1,11 @@
+import type { PlotOptions } from '../types.js';
+interface P3Opts extends PlotOptions {
+    azim?: number;
+    elev?: number;
+}
+/** 3-D scatter of (x,y,z) point triples, projected to 2-D SVG. */
+export declare function scatter3d(x: unknown, y: unknown, z: unknown, opts?: P3Opts): string;
+/** Parametric 3-D curve through (x,y,z) coordinate arrays. */
+export declare function curve3d(x: unknown, y: unknown, z: unknown, opts?: P3Opts): string;
+export {};
+//# sourceMappingURL=points3d.d.ts.map

package/dist/three/points3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"points3d.d.ts","sourceRoot":"","sources":["../../src/three/points3d.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,UAAU,MAAO,SAAQ,WAAW;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA8HD,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,GAAE,MAAW,GAAG,MAAM,CAEvF;AACD,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,GAAE,MAAW,GAAG,MAAM,CAErF"}

package/dist/three/project.d.ts

@@ -0,0 +1,11 @@
+export interface Camera {
+    azim: number;
+    elev: number;
+}
+/**
+ * Orthographic projection of a 3-D point to screen [x, y, depth].
+ * Convention (azim=0, elev=0): world +x → screen +x, world +z → screen +y,
+ * world +y → into the screen (depth). Depth increases away from the viewer.
+ */
+export declare function project(p: [number, number, number], cam: Camera): [number, number, number];
+//# sourceMappingURL=project.d.ts.map

package/dist/three/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/three/project.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAY1F"}

package/dist/three/surface.d.ts

@@ -0,0 +1,28 @@
+import type { PlotOptions } from '../types.js';
+/**
+ * Depth tolerance for the painter's sort. Every vertex is normalised into the cube
+ * [-1, 1]^3 before projection, so |depth| <= sqrt(3) whatever the input data scale.
+ * Float rounding in the projection and the 4-corner mean moves a depth by a few ulp
+ * (~1e-16 at this scale); a real geometric difference between two quads of any grid
+ * up to 10^6 cells per side is >= ~1e-6. 1e-9 sits many orders of magnitude from both.
+ */
+export declare const DEPTH_EPS = 1e-9;
+/**
+ * Painter's-order comparator: far (large depth) first. Depths within {@link DEPTH_EPS}
+ * are a tie, and a tie falls back to the face index (lower index first), so the order
+ * never depends on the last bit of a float (which differs between runtimes' Math.sin).
+ */
+export declare function compareDepth(a: {
+    depth: number;
+    index: number;
+}, b: {
+    depth: number;
+    index: number;
+}): number;
+/** 3-D surface z[row][col], projected to 2-D SVG. Painter's algorithm for `filled`. */
+export declare function surface(z: unknown, opts?: Omit<PlotOptions, 'kind'> & {
+    azim?: number;
+    elev?: number;
+    kind?: 'wireframe' | 'filled';
+}): string;
+//# sourceMappingURL=surface.d.ts.map

package/dist/three/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../src/three/surface.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,OAAO,CAAC;AAE9B;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACnC,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClC,MAAM,CAIR;AAED,uFAAuF;AACvF,wBAAgB,OAAO,CACrB,CAAC,EAAE,OAAO,EACV,IAAI,GAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;CAC1B,GACL,MAAM,CAiHR"}

package/dist/tikz.d.ts

@@ -0,0 +1,8 @@
+import type { Scene } from './scene.js';
+import type { PlotOptions } from './types.js';
+/** Escape the LaTeX specials that break a plain \node body. Single-pass so an
+ * escape's own backslash/braces are never re-processed. */
+export declare function texEsc(s: string): string;
+/** Serialize a Scene to TikZ. Coordinates match the SVG (y-flipped for TikZ's y-up), scaled. */
+export declare function emitTikZ(scene: Scene, opts?: PlotOptions): string;
+//# sourceMappingURL=tikz.d.ts.map

package/dist/tikz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tikz.d.ts","sourceRoot":"","sources":["../src/tikz.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAQ,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;2DAC2D;AAC3D,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAaxC;AA+DD,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,WAAgB,GAAG,MAAM,CAYrE"}

package/dist/types.d.ts

@@ -0,0 +1,42 @@
+/** Anything the plotter accepts as a data series: numbers, typed arrays, or core values. */
+export type Data = unknown;
+/** A 2-D coordinate axis. */
+export interface AxisSpec {
+    label?: string;
+    scale?: 'linear' | 'log';
+}
+/** Options shared by all plot functions (each uses the subset it needs). */
+export interface PlotOptions {
+    title?: string;
+    xLabel?: string;
+    yLabel?: string;
+    x?: AxisSpec;
+    y?: AxisSpec;
+    width?: number;
+    height?: number;
+    theme?: 'light' | 'dark';
+    palette?: readonly string[];
+    legend?: boolean;
+    from?: number;
+    to?: number;
+    samples?: number;
+    kind?: '2d' | '3d' | 'surface';
+    scope?: Record<string, unknown>;
+    format?: 'svg' | 'tikz';
+    tikz?: {
+        standalone?: boolean;
+        scale?: number;
+    };
+}
+/** One drawable 2-D layer for the shared draw2D core / overlay. */
+export interface Layer2D {
+    type: 'line' | 'scatter' | 'bar' | 'area' | 'step' | 'errorbar' | 'quiver';
+    x?: Data;
+    y: Data;
+    yerr?: Data;
+    u?: Data;
+    v?: Data;
+    label?: string;
+    color?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC;AAE3B,6BAA6B;AAC7B,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;CAC1B;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,QAAQ,CAAC;IACb,CAAC,CAAC,EAAE,QAAQ,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED,mEAAmE;AACnE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC3E,CAAC,CAAC,EAAE,IAAI,CAAC;IACT,CAAC,EAAE,IAAI,CAAC;IACR,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,CAAC,CAAC,EAAE,IAAI,CAAC;IACT,CAAC,CAAC,EAAE,IAAI,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@danielsimonjr/mathts-plot",
-  "version": "0.4.1",
-  "description": "Headless SVG 2D/3D plotting for MathTS — dependency-light, expression-aware, built on core/functions/expression",
+  "version": "0.4.3",
+  "description": "Headless SVG 2D/3D plotting for MathTS \u2014 dependency-light, expression-aware, built on core/functions/expression",
   "author": "Daniel Simon Jr.",
   "license": "MIT",
   "type": "module",
@@ -23,26 +23,26 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && tsc -p tsconfig.dts.json",
     "dev": "tsup --watch",
-    "test": "vitest run",
+    "test": "bun test --isolate --timeout 30000",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
+    "test:coverage": "bun test --isolate --timeout 30000 --coverage",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix",
+    "lint": "oxlint src",
+    "lint:fix": "oxlint src --fix",
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@danielsimonjr/mathts-core": "^0.14.1",
-    "@danielsimonjr/mathts-functions": "^0.63.0",
-    "@danielsimonjr/mathts-expression": "^0.7.1"
+    "@danielsimonjr/mathts-core": "^0.15.0",
+    "@danielsimonjr/mathts-functions": "^0.64.1",
+    "@danielsimonjr/mathts-expression": "^0.8.0"
   },
   "devDependencies": {
-    "@types/node": "^25.5.2",
+    "@types/node": "^26.4.0",
     "tsup": "^8.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^4.1.10"
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
   },
   "publishConfig": {
     "access": "public"