@toclocoinc/lattice-grid 1.58.0 → 1.60.0

package/modules/chart-alluvial.d.ts

@@ -0,0 +1,18 @@
+/*!
+ * Lattice Grid 1.60.0, chart-alluvial module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+import type {
+  Grid,
+} from '../lattice-grid.js';
+
+/**
+ * The alluvial extension type (BACKLOG-0000886). Importing this module
+ * registers `alluvial`. Ribbons from `source` categories to `target`
+ * categories sized by `value` — categorical flow between two dimensions.
+ */
+export function drawAlluvial(ctx: object): object;
+/** The alluvial binding: aggregates source→target flows off the grid's rows. */
+export function bindAlluvial(grid: Grid, spec: object): object;
+export default drawAlluvial;

package/modules/chart-alluvial.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-alluvial module
+ * Lattice Grid 1.60.0, chart-alluvial module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-arc.d.ts

@@ -0,0 +1,18 @@
+/*!
+ * Lattice Grid 1.60.0, chart-arc module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+import type {
+  Grid,
+} from '../lattice-grid.js';
+
+/**
+ * The arc-diagram extension type (BACKLOG-0000886). Importing this module
+ * registers `arc`. Nodes on a baseline with `source`→`target` relationships as
+ * semicircular arcs, thickness by `value`.
+ */
+export function drawArc(ctx: object): object;
+/** The arc-diagram binding: collects nodes and edges off the grid's rows. */
+export function bindArc(grid: Grid, spec: object): object;
+export default drawArc;

package/modules/chart-arc.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-arc module
+ * Lattice Grid 1.60.0, chart-arc module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-bubblemap.d.ts

@@ -0,0 +1,18 @@
+/*!
+ * Lattice Grid 1.60.0, chart-bubblemap module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+import type {
+  Grid,
+} from '../lattice-grid.js';
+
+/**
+ * The symbol / bubble-map extension type (BACKLOG-0000886). Importing this
+ * module registers `bubblemap`. Points placed by `lon`/`lat`, each a bubble
+ * with a square-root radius from `size`; needs no outlines and fetches nothing.
+ */
+export function drawBubbleMap(ctx: object): object;
+/** The bubble-map binding: reads the coordinate and size columns off the rows. */
+export function bindBubbleMap(grid: Grid, spec: object): object;
+export default drawBubbleMap;

package/modules/chart-bubblemap.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-bubblemap module
+ * Lattice Grid 1.60.0, chart-bubblemap module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-bump.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Lattice Grid 1.60.0, chart-bump module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+/**
+ * The bump-chart extension type (BACKLOG-0000886). Importing this module
+ * registers `bump`. One line per `series` plotted by its rank of `y` within
+ * each `x` period — rank-over-time, where crossings are the story.
+ */
+export function drawBump(ctx: object): object;
+export default drawBump;

package/modules/chart-bump.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-bump module
+ * Lattice Grid 1.60.0, chart-bump module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-calendar.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Lattice Grid 1.60.0, chart-calendar module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+/**
+ * The calendar-heatmap extension chart type (BACKLOG-0000886). Importing this
+ * module registers `calendar`. Draws value-by-day as a GitHub-style grid: `x`
+ * is a date column, `y` the measure summed per day.
+ */
+export function drawCalendar(ctx: object): object;
+export default drawCalendar;

package/modules/chart-calendar.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-calendar module
+ * Lattice Grid 1.60.0, chart-calendar module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-decomposition.d.ts

@@ -0,0 +1,20 @@
+/*!
+ * Lattice Grid 1.60.0, chart-decomposition module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+import type {
+  Grid,
+} from '../lattice-grid.js';
+
+/**
+ * The seasonal-decomposition panel extension chart type (BACKLOG-0000886),
+ * companion to the `tsTrend`/`tsSeasonal`/`tsResidual` shadow columns.
+ * Importing this module registers `decomposition`. Draws a stacked panel per
+ * named component column (`observed`/`trend`/`seasonal`/`residual`) sharing one
+ * x axis.
+ */
+export function drawDecomposition(ctx: object): object;
+/** The decomposition binding: reads the named component columns in row order. */
+export function bindDecomposition(grid: Grid, spec: object): object;
+export default drawDecomposition;

package/modules/chart-decomposition.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-decomposition module
+ * Lattice Grid 1.60.0, chart-decomposition module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-diverging.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Lattice Grid 1.60.0, chart-diverging module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+/**
+ * The diverging-bar extension type (BACKLOG-0000886). Importing this module
+ * registers `diverging`. Horizontal bars growing left/right from a central
+ * zero over a signed `y`, on a symmetric scale.
+ */
+export function drawDiverging(ctx: object): object;
+export default drawDiverging;

package/modules/chart-diverging.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-diverging module
+ * Lattice Grid 1.60.0, chart-diverging module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-dumbbell.d.ts

@@ -0,0 +1,18 @@
+/*!
+ * Lattice Grid 1.60.0, chart-dumbbell module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+import type {
+  Grid,
+} from '../lattice-grid.js';
+
+/**
+ * The dumbbell / connected-dot extension type (BACKLOG-0000886). Importing
+ * this module registers `dumbbell`. Two dots (`start`, `end`) joined by a bar
+ * per `x` category — the gap is the bar's length.
+ */
+export function drawDumbbell(ctx: object): object;
+/** The dumbbell binding: reads the category and its two numeric columns. */
+export function bindDumbbell(grid: Grid, spec: object): object;
+export default drawDumbbell;

package/modules/chart-dumbbell.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-dumbbell module
+ * Lattice Grid 1.60.0, chart-dumbbell module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-fan.d.ts

@@ -0,0 +1,18 @@
+/*!
+ * Lattice Grid 1.60.0, chart-fan module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+import type {
+  Grid,
+} from '../lattice-grid.js';
+
+/**
+ * The fan / forecast extension chart type (BACKLOG-0000886). Importing this
+ * module registers `fan`. Draws `y` (history) as a solid line, `forecast` as a
+ * dashed continuation, and the `lower`/`upper` interval as a widening band.
+ */
+export function drawFan(ctx: object): object;
+/** The fan binding: reads the history, forecast and interval columns in row order. */
+export function bindFan(grid: Grid, spec: object): object;
+export default drawFan;

package/modules/chart-fan.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-fan module
+ * Lattice Grid 1.60.0, chart-fan module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-hexbin.d.ts

@@ -0,0 +1,18 @@
+/*!
+ * Lattice Grid 1.60.0, chart-hexbin module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+import type {
+  Grid,
+} from '../lattice-grid.js';
+
+/**
+ * The hexbin / 2D-density extension chart type (BACKLOG-0000886). Importing
+ * this module registers `hexbin`. Bins `x`/`y` points into hexagons shaded by
+ * count, so a large scatter reads as a density field rather than overplotting.
+ */
+export function drawHexbin(ctx: object): object;
+/** The hexbin binding: reads the numeric `x` and `y` columns off the grid's rows. */
+export function bindHexbin(grid: Grid, spec: object): object;
+export default drawHexbin;

package/modules/chart-hexbin.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-hexbin module
+ * Lattice Grid 1.60.0, chart-hexbin module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-hexmap.d.ts

@@ -0,0 +1,18 @@
+/*!
+ * Lattice Grid 1.60.0, chart-hexmap module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+import type {
+  Grid,
+} from '../lattice-grid.js';
+
+/**
+ * The hexbin-map extension type (BACKLOG-0000886). Importing this module
+ * registers `hexmap`. `lon`/`lat` points binned into hexagons shaded by count,
+ * so a geographic density reads without overplotting or outlines.
+ */
+export function drawHexMap(ctx: object): object;
+/** The hexbin-map binding: reads the coordinate columns off the grid's rows. */
+export function bindHexMap(grid: Grid, spec: object): object;
+export default drawHexMap;

package/modules/chart-hexmap.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-hexmap module
+ * Lattice Grid 1.60.0, chart-hexmap module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-icicle.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Lattice Grid 1.60.0, chart-icicle module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+/**
+ * The icicle extension type (BACKLOG-0000886). Importing this module registers
+ * `icicle`. A hierarchy (the grid's group tree) as nested rectangles in rows,
+ * sized by `y`; drills like the built-in hierarchical types.
+ */
+export function drawIcicle(ctx: object): object;
+export default drawIcicle;

package/modules/chart-icicle.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-icicle module
+ * Lattice Grid 1.60.0, chart-icicle module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-parallel.d.ts

@@ -0,0 +1,19 @@
+/*!
+ * Lattice Grid 1.60.0, chart-parallel module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+import type {
+  Grid,
+} from '../lattice-grid.js';
+
+/**
+ * The parallel-coordinates extension type (BACKLOG-0000886). Importing this
+ * module registers `parallel`. One polyline per row across the numeric
+ * `columns`, each a vertical axis with its own scale; `spec.colourBy` colours
+ * by a category.
+ */
+export function drawParallel(ctx: object): object;
+/** The parallel-coordinates binding: reads the dimension columns off the rows. */
+export function bindParallel(grid: Grid, spec: object): object;
+export default drawParallel;

package/modules/chart-parallel.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-parallel module
+ * Lattice Grid 1.60.0, chart-parallel module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-ridgeline.d.ts

@@ -0,0 +1,14 @@
+/*!
+ * Lattice Grid 1.60.0, chart-ridgeline module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+/**
+ * The ridgeline (joy plot) extension chart type (BACKLOG-0000886). Importing
+ * this module registers `ridgeline` with the base charts module; the base
+ * bundle does not include it unless a caller imports it. Draws one
+ * kernel-density ridge per category (`x`), stacked and overlapping, over the
+ * distribution of a measure (`y`); `spec.overlap` sets the vertical overlap.
+ */
+export function drawRidgeline(ctx: object): object;
+export default drawRidgeline;

package/modules/chart-ridgeline.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-ridgeline module
+ * Lattice Grid 1.60.0, chart-ridgeline module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-roc.d.ts

@@ -0,0 +1,20 @@
+/*!
+ * Lattice Grid 1.60.0, chart-roc module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+import type {
+  Grid,
+} from '../lattice-grid.js';
+
+/**
+ * The ROC / PR / calibration extension chart type (BACKLOG-0000886). Importing
+ * this module registers `roc`. `spec.curve` chooses `'roc'` (default, with the
+ * chance diagonal and AUC), `'pr'`, or `'calibration'`; `label` is the outcome
+ * column (positive when truthy or equal to `spec.positive`), `score` the model
+ * score.
+ */
+export function drawRoc(ctx: object): object;
+/** The ROC binding: reads the outcome and score off the grid's rows. */
+export function bindRoc(grid: Grid, spec: object): object;
+export default drawRoc;

package/modules/chart-roc.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-roc module
+ * Lattice Grid 1.60.0, chart-roc module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-slope.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Lattice Grid 1.60.0, chart-slope module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+/**
+ * The slope-chart extension type (BACKLOG-0000886). Importing this module
+ * registers `slope`. One line per `series` connecting its `y` across the `x`
+ * periods — before/after comparison read from the slopes.
+ */
+export function drawSlope(ctx: object): object;
+export default drawSlope;

package/modules/chart-slope.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-slope module
+ * Lattice Grid 1.60.0, chart-slope module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-splom.d.ts

@@ -0,0 +1,19 @@
+/*!
+ * Lattice Grid 1.60.0, chart-splom module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+import type {
+  Grid,
+} from '../lattice-grid.js';
+
+/**
+ * The scatter-plot-matrix (SPLOM) extension chart type (BACKLOG-0000886).
+ * Importing this module registers `splom`. Crosses every pair of the numeric
+ * `columns` (2–6) as a matrix of scatters, naming each variable on the
+ * diagonal.
+ */
+export function drawSplom(ctx: object): object;
+/** The SPLOM binding: reads the numeric `columns` off the grid's visible rows. */
+export function bindSplom(grid: Grid, spec: object): object;
+export default drawSplom;

package/modules/chart-splom.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-splom module
+ * Lattice Grid 1.60.0, chart-splom module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/chart-waffle.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Lattice Grid 1.60.0, chart-waffle module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+/**
+ * The waffle / dot-matrix extension type (BACKLOG-0000886). Importing this
+ * module registers `waffle`. Proportion as counted squares (default 100), one
+ * colour per `x` category sized by `y`.
+ */
+export function drawWaffle(ctx: object): object;
+export default drawWaffle;

package/modules/chart-waffle.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.58.0, chart-waffle module
+ * Lattice Grid 1.60.0, chart-waffle module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/charts.d.ts

@@ -0,0 +1,122 @@
+/*!
+ * Lattice Grid 1.60.0, charts module type declarations
+ * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+ * https://latticegrid.dev
+ */
+import type {
+  CellRange,
+  Chart,
+  ChartSpec,
+  ChartType,
+  Grid,
+  RegressionCoefficient,
+  RegressionModel,
+  RegressionSpec,
+} from '../lattice-grid.js';
+
+/** Every type name `createChart` accepts. */
+export const TYPES: readonly ChartType[];
+/** The built-in colour schemes, by name. */
+export const SCHEMES: Readonly<Record<string, readonly string[]>>;
+export const PALETTE: readonly string[];
+export function createChart(spec: ChartSpec): Chart;
+/**
+ * Chart a selected cell range. Derives the chart from the range's shape — a
+ * leading text column becomes the categories, the numeric columns become the
+ * measures — and returns the live chart, or null when the range has nothing
+ * to measure. Respects hidden and unreadable columns. The type is a sensible
+ * default the caller can change with `chart.update({ type })`.
+ */
+export function chartRange(
+  grid: Grid,
+  opts: {
+    container: Element | string;
+    range?: CellRange;
+    type?: ChartType;
+  } & Partial<ChartSpec>,
+): Chart | null;
+/** Would {@link chartRange} draw something for the grid's current selection? */
+export function canChartRange(grid: Grid, opts?: { range?: CellRange }): boolean;
+/**
+ * Decide what a chart of a range should be, without drawing it: the type, the
+ * category column, the measure columns, and a `spec` ready for `createChart`
+ * — or a `reason` naming why the range cannot be charted.
+ */
+export function deriveRangeSpec(
+  grid: Grid,
+  opts?: { range?: CellRange; type?: ChartType },
+): {
+  spec: ChartSpec | null;
+  type: ChartType | null;
+  x: string | null;
+  measures: string[];
+  columns: string[];
+  reason: string | null;
+};
+/**
+ * Turn a fitted regression model into diagnostic chart specs ready for
+ * `createChart` (BACKLOG-0000812). Pass a precomputed `model`, or a `spec` to
+ * fit one over the grid, and the `fitted` and `residual` fit-shadow column ids
+ * the residual and QQ plots draw over.
+ *
+ * The presets that map onto grid columns come back as drawable specs: `fit`
+ * (the fit line with its confidence band), `residualsFitted`, `qq`, and
+ * `multicollinearity` (a correlogram over the predictors, with the model's
+ * `vif` alongside). The three that need a per-row or per-coefficient quantity
+ * the grid has no column for — `scaleLocation`, `residualsLeverage`,
+ * `coefficientForest` — come back with a null `spec` and a stable `reason`,
+ * rather than silently dropped.
+ */
+export function regressionPlots(
+  grid: Grid,
+  opts?: {
+    model?: RegressionModel;
+    spec?: RegressionSpec;
+    fitted?: string;
+    residual?: string;
+    rows?: object[] | ((grid: Grid) => object[]);
+    confidence?: number;
+  },
+): {
+  model: RegressionModel | null;
+  plots: Record<
+    'fit' | 'residualsFitted' | 'qq' | 'multicollinearity'
+      | 'scaleLocation' | 'residualsLeverage' | 'coefficientForest',
+    {
+      spec: ChartSpec | null;
+      reason: string | null;
+      vif?: number[] | null;
+      coefficients?: RegressionCoefficient[] | null;
+    }
+  >;
+};
+export function registerScheme(name: string, colours: readonly string[]): void;
+export function resolveScheme(spec?: object): object;
+export function schemeNames(): string[];
+export function setDefaultScheme(name: string): void;
+/**
+ * The definition an extension chart type registers (BACKLOG-0000886). `draw`
+ * receives the base drawing context — `plot`, `bound`, `groups`, `scheme`,
+ * `typography`, `fontSize`, `labels`, `grid`, `spec`, `doc` — plus
+ * `ctx.helpers`, the base's own toolkit of primitives (element factory, scales,
+ * axes, mark pool, distribution kernels), and appends its marks to the layer
+ * groups. `bind` optionally supplies the bound data (default: the by-series
+ * binder); `freeform` lays the chart out without axis gutters; `labelled`
+ * declares that `labels` applies.
+ */
+interface ChartTypeDefinition {
+  draw: (ctx: object) => object;
+  bind?: (grid: Grid, spec: ChartSpec) => object;
+  freeform?: boolean;
+  labelled?: boolean;
+}
+/**
+ * Register an extension chart type so `createChart({ type })` can draw it
+ * (BACKLOG-0000886). Extension types ship as their own opt-in modules, so the
+ * base charts bundle does not grow for a type a caller never imports — you pay
+ * only for the charts you use.
+ */
+export function registerChartType(name: string, def: ChartTypeDefinition): void;
+/** Every registered extension chart-type name, in registration order. */
+export function registeredChartTypes(): string[];
+export { Chart };