@danielsimonjr/mathts-plot 0.4.4 → 0.4.6

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/index.js

@@ -281,9 +281,13 @@ function renderLine(layer, f, i) {
 }
 function renderScatter(layer, f, i) {
   const color = layer.color ?? f.color(i);
-  return xy(layer).map(
-    ([x, y]) => ({ k: "circle", cx: f.px(x), cy: f.py(y), r: 3, fill: color })
-  );
+  return xy(layer).map(([x, y]) => ({
+    k: "circle",
+    cx: f.px(x),
+    cy: f.py(y),
+    r: 3,
+    fill: color
+  }));
 }
 function renderBar(layer, f, i) {
   const color = layer.color ?? f.color(i);
@@ -1208,7 +1212,7 @@ function curve3d(x, y, z, opts = {}) {
 }
 
 // src/index.ts
-var VERSION = "0.4.4";
+var VERSION = "0.4.6";
 export {
   VERSION,
   area,

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

@@ -1 +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"}
+{"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;AA2JD,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAmBvE"}

package/package.json

@@ -1,71 +1,72 @@
-{
-  "name": "@danielsimonjr/mathts-plot",
-  "version": "0.4.4",
-  "description": "Headless SVG 2D/3D plotting for MathTS — dependency-light, expression-aware, built on core/functions/expression",
-  "author": "Daniel Simon Jr.",
-  "license": "MIT",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./render": {
-      "import": "./dist/render-file.js",
-      "types": "./dist/render-file.d.ts"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsup && tsc -p tsconfig.dts.json",
-    "dev": "tsup --watch",
-    "test": "bun test --isolate --timeout 30000",
-    "test:watch": "vitest",
-    "test:coverage": "bun test --isolate --timeout 30000 --coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "oxlint src",
-    "lint:fix": "oxlint src --fix",
-    "clean": "rm -rf dist"
-  },
-  "dependencies": {
-    "@danielsimonjr/mathts-core": "^0.15.0",
-    "@danielsimonjr/mathts-functions": "^0.64.1",
-    "@danielsimonjr/mathts-expression": "^0.8.0"
-  },
-  "devDependencies": {
-    "@types/node": "^26.4.0",
-    "@xmldom/xmldom": "^0.9.12",
-    "tsup": "^8.0.0",
-    "typescript": "^7.0.2",
-    "vitest": "^5.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/danielsimonjr/MathTS.git",
-    "directory": "plot"
-  },
-  "keywords": [
-    "math",
-    "typescript",
-    "plot",
-    "plotting",
-    "chart",
-    "svg",
-    "2d",
-    "3d",
-    "surface",
-    "contour",
-    "heatmap",
-    "visualization",
-    "headless"
-  ]
-}
+{
+  "name": "@danielsimonjr/mathts-plot",
+  "version": "0.4.6",
+  "description": "Headless SVG 2D/3D plotting for MathTS — dependency-light, expression-aware, built on core/functions/expression",
+  "author": "Daniel Simon Jr.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./render": {
+      "import": "./dist/render-file.js",
+      "types": "./dist/render-file.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.dts.json",
+    "build:prod": "tsup --minify --treeshake && tsc -p tsconfig.dts.json",
+    "dev": "tsup --watch --onSuccess \"tsc -p tsconfig.dts.json\"",
+    "test": "bun test --isolate --timeout 30000",
+    "test:watch": "vitest",
+    "test:coverage": "bun test --isolate --timeout 30000 --coverage",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
+    "lint": "oxlint src",
+    "lint:fix": "oxlint src --fix",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@danielsimonjr/mathts-core": "^0.15.5",
+    "@danielsimonjr/mathts-functions": "^0.65.0",
+    "@danielsimonjr/mathts-expression": "^0.8.2"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.0",
+    "@xmldom/xmldom": "^0.9.12",
+    "tsup": "^8.0.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/danielsimonjr/MathTS.git",
+    "directory": "plot"
+  },
+  "keywords": [
+    "math",
+    "typescript",
+    "plot",
+    "plotting",
+    "chart",
+    "svg",
+    "2d",
+    "3d",
+    "surface",
+    "contour",
+    "heatmap",
+    "visualization",
+    "headless"
+  ]
+}