@bestagentkits/render 0.2.0 → 0.3.0

package/dist/render/chart-kinds-histogram-waterfall.js

@@ -0,0 +1,172 @@
+/**
+ * Encoded charts that show a distribution or a running total: histogram and
+ * waterfall. Bins snap to clean steps; a waterfall closes with a computed total.
+ */
+import { axisBounds, bandCentre, CARTESIAN_TITLED, clampTo, niceStep, numberFormatter, plotWidth, round, scaleX, scaleY, seriesClass, tickFormatter, } from './chart-scales.js';
+import { axisTitles, boundedGridAndTicks, categoryIndex, categoryLabels, MAX_BAR_WIDTH, numericXTicks, plotFor, rectPath, textValueLabel, } from './chart-svg-parts.js';
+import { escapeText } from './escape.js';
+/**
+ * Bin edges on clean steps (1, 2, 2.5 or 5 × 10ⁿ). `bins` is a target count:
+ * the clean step whose bin count lands closest to it wins, the wider step on a
+ * tie. Deterministic for a given input.
+ */
+export function histogramEdges(samples, bins) {
+    const finite = samples.filter((value) => Number.isFinite(value));
+    if (finite.length === 0)
+        return [];
+    const low = Math.min(...finite);
+    const high = Math.max(...finite);
+    // One bin when every sample is equal, or when the values are too large for
+    // clean steps to separate (1e16 + 4): its width must still be representable.
+    const single = [low, high > low ? high : low + Math.max(1, Math.abs(low) * Number.EPSILON * 4)];
+    if (low === high)
+        return single;
+    const target = Math.max(1, bins);
+    const magnitude = 10 ** Math.floor(Math.log10((high - low) / target));
+    const layout = (step) => {
+        const start = Math.floor(low / step) * step;
+        return { step, start, count: Math.max(1, Math.ceil((high - start) / step - 1e-9)) };
+    };
+    let best = layout(10 * magnitude);
+    for (const factor of [5, 2.5, 2, 1]) {
+        const candidate = layout(factor * magnitude);
+        if (Math.abs(candidate.count - target) < Math.abs(best.count - target))
+            best = candidate;
+    }
+    const edges = [];
+    for (let index = 0; index <= best.count; index += 1) {
+        edges.push(Number((best.start + best.step * index).toPrecision(12)));
+    }
+    const increasing = edges.every((edge, index) => index === 0 || edge > (edges[index - 1] ?? edge));
+    return increasing ? edges : single;
+}
+/** Samples per bin; each bin is [a, b) and the last is closed. */
+export function histogramCounts(samples, edges) {
+    const bins = Math.max(0, edges.length - 1);
+    const counts = new Array(bins).fill(0);
+    if (bins === 0)
+        return counts;
+    const start = edges[0] ?? 0;
+    const span = (edges[bins] ?? start) - start;
+    for (const value of samples) {
+        if (!Number.isFinite(value))
+            continue;
+        const slot = Math.min(bins - 1, Math.max(0, Math.floor(((value - start) / span) * bins + 1e-9)));
+        counts[slot] = (counts[slot] ?? 0) + 1;
+    }
+    return counts;
+}
+export function histogramChart(input, encoded) {
+    const frame = CARTESIAN_TITLED;
+    const xFormat = numberFormatter(encoded.x.format);
+    const count = numberFormatter({ format: 'integer' });
+    const edges = histogramEdges(encoded.samples, encoded.bins);
+    const counts = histogramCounts(encoded.samples, edges);
+    const first = edges[0] ?? 0;
+    const last = edges[edges.length - 1] ?? 1;
+    const step = counts.length === 0 ? 1 : (last - first) / counts.length;
+    const xBounds = { min: first, max: last, step };
+    // Ticks on clean multiples inside the binned range, not on every edge.
+    const tickStep = niceStep(Math.max(last - first, step), 5);
+    const xTicks = [];
+    for (let tick = Math.ceil(first / tickStep) * tickStep; tick <= last + tickStep / 1000; tick += tickStep) {
+        xTicks.push(Number(tick.toPrecision(12)));
+    }
+    const yBounds = axisBounds(counts, encoded.y, true);
+    const zeroY = scaleY(clampTo(0, yBounds), yBounds, frame);
+    const ranges = counts.map((_, index) => `${xFormat(edges[index] ?? 0)}–${xFormat(edges[index + 1] ?? 0)}`);
+    const bars = counts.map((value, index) => {
+        const x1 = scaleX(edges[index] ?? 0, xBounds, frame);
+        const x2 = scaleX(edges[index + 1] ?? 0, xBounds, frame);
+        const y = scaleY(clampTo(value, yBounds), yBounds, frame);
+        const width = Math.max(1, x2 - x1 - 2);
+        return `<path class="ak-chart-bar ${seriesClass(0)}" tabindex="0" d="${rectPath(x1 + 1, y, width, zeroY - y)}"><title>${escapeText(`${ranges[index]}: ${count(value)}`)}</title></path>${textValueLabel(x1 + 1 + width / 2, y - 7, count(value))}`;
+    });
+    const busiest = counts.indexOf(Math.max(...counts, 0));
+    const label = encoded.x.label ?? input.series[0]?.label ?? 'Values';
+    return {
+        body: `${boundedGridAndTicks(yBounds, frame, count)}${numericXTicks(xBounds, frame, tickFormatter(encoded.x.format, { ...xBounds, step: tickStep }), xTicks)}${bars.join('')}${axisTitles(frame, encoded.x.label, encoded.y.label ?? 'Count')}`,
+        viewBox: frame,
+        legend: [],
+        summary: counts.length === 0
+            ? `${label}: no values.`
+            : `${label}: ${encoded.samples.length} values in ${counts.length} bins from ${xFormat(first)} to ${xFormat(last)}; the most common range is ${ranges[busiest]} (${count(counts[busiest] ?? 0)}).`,
+        table: {
+            columns: [
+                { label: label, numeric: false },
+                { label: 'Count', numeric: true },
+            ],
+            rows: counts.map((value, index) => [ranges[index] ?? '', count(value)]),
+        },
+        plot: plotFor(frame, yBounds, (x) => typeof x === 'number' ? scaleX(clampTo(x, xBounds), xBounds, frame) : undefined),
+    };
+}
+/** Running total of signed changes, closed by a computed total bar. */
+export function waterfallChart(input, encoded) {
+    const frame = CARTESIAN_TITLED;
+    const format = numberFormatter(encoded.y.format);
+    const signed = (value) => (value > 0 ? `+${format(value)}` : format(value));
+    const series = input.series[0] ?? { label: '', values: [] };
+    const steps = input.labels.map((label, index) => ({ label, value: series.values[index] ?? 0 }));
+    const running = [];
+    let total = 0;
+    for (const step of steps) {
+        total += step.value;
+        running.push(total);
+    }
+    const labels = [...input.labels, 'Total'];
+    const groups = labels.length;
+    const bounds = axisBounds([0, ...running], encoded.y, true);
+    const band = plotWidth(frame) / groups;
+    const width = round(Math.max(4, Math.min(MAX_BAR_WIDTH, band * 0.62)));
+    const parts = [];
+    let previous = 0;
+    const bar = (index, from, to, tone, text, title) => {
+        const x = round(bandCentre(index, groups, frame) - width / 2);
+        const y1 = scaleY(clampTo(from, bounds), bounds, frame);
+        const y2 = scaleY(clampTo(to, bounds), bounds, frame);
+        const top = Math.min(y1, y2);
+        parts.push(`<path class="ak-chart-bar ${tone}" tabindex="0" d="${rectPath(x, top, width, Math.max(1, Math.abs(y1 - y2)))}"><title>${escapeText(title)}</title></path>`, textValueLabel(x + width / 2, top - 7, text));
+        return { x, y: y2 };
+    };
+    steps.forEach((step, index) => {
+        const next = previous + step.value;
+        const end = bar(index, previous, next, step.value >= 0 ? 'ak-chart-up' : 'ak-chart-down', signed(step.value), `${step.label}: ${signed(step.value)}, running total ${format(next)}`);
+        const nextX = round(bandCentre(index + 1, groups, frame) - width / 2);
+        parts.push(`<line class="ak-chart-connector" x1="${round(end.x + width)}" y1="${end.y}" x2="${nextX}" y2="${end.y}"/>`);
+        previous = next;
+    });
+    bar(steps.length, 0, total, 'ak-chart-net', format(total), `Total: ${format(total)}`);
+    return {
+        body: `${boundedGridAndTicks(bounds, frame, tickFormatter(encoded.y.format, bounds))}${categoryLabels(labels, (index) => bandCentre(index, groups, frame), frame)}${parts.join('')}${axisTitles(frame, encoded.x.label, encoded.y.label)}`,
+        viewBox: frame,
+        legend: [
+            { label: 'Increase', swatch: 'ak-chart-up' },
+            { label: 'Decrease', swatch: 'ak-chart-down' },
+            { label: 'Total', swatch: 'ak-chart-net' },
+        ],
+        summary: `${series.label}: ${steps
+            .map((step) => `${step.label} ${signed(step.value)}`)
+            .join(', ')}; total ${format(total)}.`,
+        table: {
+            columns: [
+                { label: encoded.x.label ?? 'Step', numeric: false },
+                { label: 'Change', numeric: true },
+                { label: 'Running total', numeric: true },
+            ],
+            rows: [
+                ...steps.map((step, index) => [
+                    step.label,
+                    signed(step.value),
+                    format(running[index] ?? 0),
+                ]),
+                ['Total', '', format(total)],
+            ],
+        },
+        plot: plotFor(frame, bounds, (x) => {
+            const index = categoryIndex(labels, x);
+            return index === undefined ? undefined : bandCentre(index, groups, frame);
+        }),
+    };
+}
+//# sourceMappingURL=chart-kinds-histogram-waterfall.js.map

package/dist/render/chart-kinds-histogram-waterfall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-kinds-histogram-waterfall.js","sourceRoot":"","sources":["../../src/render/chart-kinds-histogram-waterfall.ts"],"names":[],"mappings":"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"}

package/dist/render/chart-overlays.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Markers and annotations on charts drawn on x/y axes.
+ *
+ * A marker is a dashed vertical rule with its label. An annotation is a
+ * numbered callout at a point; the same numbers head the list under the chart
+ * and the summary, so the note never depends on seeing the plot.
+ */
+import type { NumberFormatter } from './chart-svg-parts.js';
+import type { ChartAnnotation, ChartMarker, KindRender } from './chart-types.js';
+type Plot = NonNullable<KindRender['plot']>;
+export declare function markerLayer(markers: readonly ChartMarker[], plot: Plot): string;
+export declare function annotationLayer(annotations: readonly ChartAnnotation[], plot: Plot): string;
+/** The visible numbered list of annotations under the chart. */
+export declare function annotationList(annotations: readonly ChartAnnotation[], xFormat: NumberFormatter, yFormat: NumberFormatter): string;
+/** Sentences that restate the overlays for the summary. */
+export declare function overlaySummary(markers: readonly ChartMarker[], annotations: readonly ChartAnnotation[], xFormat: NumberFormatter, yFormat: NumberFormatter): string;
+export {};
+//# sourceMappingURL=chart-overlays.d.ts.map

package/dist/render/chart-overlays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-overlays.d.ts","sourceRoot":"","sources":["../../src/render/chart-overlays.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGjF,KAAK,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAE5C,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAW/E;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAW3F;AAMD,gEAAgE;AAChE,wBAAgB,cAAc,CAC5B,WAAW,EAAE,SAAS,eAAe,EAAE,EACvC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,eAAe,GACvB,MAAM,CAUR;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,WAAW,EAAE,SAAS,eAAe,EAAE,EACvC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,eAAe,GACvB,MAAM,CAuBR"}

package/dist/render/chart-overlays.js

@@ -0,0 +1,58 @@
+/**
+ * Markers and annotations on charts drawn on x/y axes.
+ *
+ * A marker is a dashed vertical rule with its label. An annotation is a
+ * numbered callout at a point; the same numbers head the list under the chart
+ * and the summary, so the note never depends on seeing the plot.
+ */
+import { round } from './chart-scales.js';
+import { escapeText } from './escape.js';
+export function markerLayer(markers, plot) {
+    return markers
+        .map((marker) => {
+        const x = plot.xAt(marker.x);
+        if (x === undefined)
+            return '';
+        const flip = x > plot.right - 140;
+        return `<g class="ak-chart-marker"><line class="ak-chart-marker-rule" x1="${x}" y1="${plot.top}" x2="${x}" y2="${plot.bottom}"/><text class="ak-chart-marker-label" x="${round(flip ? x - 6 : x + 6)}" y="${plot.top + 10}" text-anchor="${flip ? 'end' : 'start'}">${escapeText(marker.label)}</text></g>`;
+    })
+        .join('');
+}
+export function annotationLayer(annotations, plot) {
+    return annotations
+        .map((note, index) => {
+        const x = plot.xAt(note.x);
+        if (x === undefined)
+            return '';
+        const y = plot.yAt(note.y);
+        return `<g class="ak-chart-note"><circle class="ak-chart-note-dot" cx="${x}" cy="${y}" r="10"/><text class="ak-chart-note-number" x="${x}" y="${round(y + 4)}" text-anchor="middle">${index + 1}</text></g>`;
+    })
+        .join('');
+}
+function where(x, y, xFormat, yFormat) {
+    return `${typeof x === 'number' ? xFormat(x) : x}, ${yFormat(y)}`;
+}
+/** The visible numbered list of annotations under the chart. */
+export function annotationList(annotations, xFormat, yFormat) {
+    if (annotations.length === 0)
+        return '';
+    return `<ol class="ak-chart-notes">${annotations
+        .map((note) => `<li>${escapeText(note.text)} <span class="ak-chart-note-at">(${escapeText(where(note.x, note.y, xFormat, yFormat))})</span></li>`)
+        .join('')}</ol>`;
+}
+/** Sentences that restate the overlays for the summary. */
+export function overlaySummary(markers, annotations, xFormat, yFormat) {
+    const parts = [];
+    if (markers.length > 0) {
+        parts.push(`Markers: ${markers
+            .map((marker) => `${marker.label} at ${typeof marker.x === 'number' ? xFormat(marker.x) : marker.x}`)
+            .join('; ')}.`);
+    }
+    if (annotations.length > 0) {
+        parts.push(`Notes: ${annotations
+            .map((note, index) => `${index + 1}. ${note.text} (${where(note.x, note.y, xFormat, yFormat)})`)
+            .join('; ')}.`);
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=chart-overlays.js.map

package/dist/render/chart-overlays.js.map

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

package/dist/render/chart-scales.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Chart scales and geometry primitives.
+ *
+ * Every coordinate passes through `round()` (two decimals) before it reaches
+ * the markup, so floating-point noise never breaks byte-determinism. Axis
+ * bounds end on clean ticks (1, 2, 2.5 or 5 × 10ⁿ).
+ */
+import { type FormatSpec } from '../data/format-value.js';
+import type { ChartSeries } from './chart-types.js';
+export interface Bounds {
+    min: number;
+    max: number;
+}
+export interface TickBounds extends Bounds {
+    step: number;
+}
+export interface Frame {
+    width: number;
+    height: number;
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/**
+ * Shared viewBox width. Text inside the SVG scales with the rendered width, so
+ * this is sized for a full-width card: labels render near their nominal size
+ * there, and the canvas scrolls rather than shrinks on narrow screens.
+ */
+export declare const WIDTH = 800;
+/** Number of distinct series colours the stylesheet defines. */
+export declare const PALETTE_SIZE = 6;
+export declare const CARTESIAN: Frame;
+export declare const RADIAL: Frame;
+export declare const SPARK: Frame;
+/** Encoded cartesian charts reserve room for axis titles and formatted ticks. */
+export declare const CARTESIAN_TITLED: Frame;
+export declare function round(value: number): number;
+/** Group digits with a thin comma, deterministically and without locale data. */
+export declare function formatNumber(value: number): string;
+/**
+ * A number formatter for an axis or magnitude encoding. `text` (the schema
+ * default) reads as a plain grouped number with the unit, if any.
+ */
+export declare function numberFormatter(spec: FormatSpec): (value: number) => string;
+/** Drop floating-point noise (0.1 + 0.2) without rounding real precision away. */
+export declare function denoise(value: number): number;
+export declare function seriesClass(index: number): string;
+/** Round a span up to 1, 2, 2.5 or 5 times a power of ten, so ticks read cleanly. */
+export declare function niceStep(span: number, count: number): number;
+/** Axis bounds that include zero and end on a clean tick. */
+export declare function niceBounds(series: ChartSeries[]): TickBounds;
+/** Clean-tick bounds around a raw range. */
+export declare function niceRange(rawMin: number, rawMax: number): TickBounds;
+/**
+ * Bounds for an encoded value axis: the data range (with zero when `zero`),
+ * overridden by the author's `min`/`max`, with a clean step between them.
+ */
+export declare function axisBounds(values: readonly number[], axis: {
+    min?: number;
+    max?: number;
+}, zero: boolean): TickBounds;
+export declare function plotWidth(frame: Frame): number;
+export declare function plotHeight(frame: Frame): number;
+export declare function scaleY(value: number, bounds: Bounds, frame: Frame): number;
+/** A value clamped into the bounds, so an out-of-range mark stays inside the plot. */
+export declare function clampTo(value: number, bounds: Bounds): number;
+export declare function scaleX(value: number, bounds: Bounds, frame: Frame): number;
+/** Point charts span the plot edge to edge. */
+export declare function pointX(index: number, count: number, frame: Frame): number;
+/** Bar groups sit in equal bands, labelled at the band centre. */
+export declare function bandCentre(index: number, count: number, frame: Frame): number;
+/** Fragment-safe id fragment derived from a block id. */
+export declare function safeId(id: string): string;
+/** Ticks from `min` to `max` in `step` increments, rounded. */
+export declare function tickValues(bounds: TickBounds): number[];
+/**
+ * The formatter for axis ticks: like `numberFormatter`, but whole-number
+ * currency ticks drop their cents ($15,000 rather than $15,000.00) unless the
+ * author fixed `decimals`.
+ */
+export declare function tickFormatter(spec: FormatSpec, bounds: TickBounds): (value: number) => string;
+//# sourceMappingURL=chart-scales.d.ts.map

package/dist/render/chart-scales.d.ts.map

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

package/dist/render/chart-scales.js

@@ -0,0 +1,166 @@
+/**
+ * Chart scales and geometry primitives.
+ *
+ * Every coordinate passes through `round()` (two decimals) before it reaches
+ * the markup, so floating-point noise never breaks byte-determinism. Axis
+ * bounds end on clean ticks (1, 2, 2.5 or 5 × 10ⁿ).
+ */
+import { formatValue } from '../data/format-value.js';
+/**
+ * Shared viewBox width. Text inside the SVG scales with the rendered width, so
+ * this is sized for a full-width card: labels render near their nominal size
+ * there, and the canvas scrolls rather than shrinks on narrow screens.
+ */
+export const WIDTH = 800;
+/** Number of distinct series colours the stylesheet defines. */
+export const PALETTE_SIZE = 6;
+export const CARTESIAN = {
+    width: WIDTH,
+    height: 300,
+    top: 20,
+    right: 36,
+    bottom: 36,
+    left: 56,
+};
+export const RADIAL = { width: WIDTH, height: 240, top: 0, right: 0, bottom: 0, left: 0 };
+export const SPARK = { width: WIDTH, height: 72, top: 10, right: 10, bottom: 10, left: 10 };
+/** Encoded cartesian charts reserve room for axis titles and formatted ticks. */
+export const CARTESIAN_TITLED = {
+    width: WIDTH,
+    height: 300,
+    top: 30,
+    right: 36,
+    bottom: 50,
+    left: 68,
+};
+export function round(value) {
+    return Math.round(value * 100) / 100;
+}
+/** Group digits with a thin comma, deterministically and without locale data. */
+export function formatNumber(value) {
+    const rounded = round(value);
+    const [whole = '0', fraction] = String(Math.abs(rounded)).split('.');
+    const grouped = whole.replace(/\B(?=(\d{3})+(?!\d))/gu, ',');
+    return `${rounded < 0 ? '-' : ''}${grouped}${fraction === undefined ? '' : `.${fraction}`}`;
+}
+/**
+ * A number formatter for an axis or magnitude encoding. `text` (the schema
+ * default) reads as a plain grouped number with the unit, if any.
+ */
+export function numberFormatter(spec) {
+    const format = spec.format === undefined || spec.format === 'text' ? 'number' : spec.format;
+    // Only floating-point noise is removed here; the format owns the decimals,
+    // so a fine-grained value is not rounded away before it is formatted.
+    return (value) => formatValue(denoise(value), { ...spec, format });
+}
+/** Drop floating-point noise (0.1 + 0.2) without rounding real precision away. */
+export function denoise(value) {
+    return Number(value.toPrecision(12));
+}
+export function seriesClass(index) {
+    return `ak-chart-s${index % PALETTE_SIZE}`;
+}
+/** Round a span up to 1, 2, 2.5 or 5 times a power of ten, so ticks read cleanly. */
+export function niceStep(span, count) {
+    const raw = span / Math.max(count, 1);
+    const magnitude = 10 ** Math.floor(Math.log10(raw));
+    const normalized = raw / magnitude;
+    const factor = [1, 2, 2.5, 5].find((candidate) => normalized <= candidate) ?? 10;
+    return factor * magnitude;
+}
+/** Axis bounds that include zero and end on a clean tick. */
+export function niceBounds(series) {
+    const values = series.flatMap((entry) => entry.values).filter((value) => Number.isFinite(value));
+    return niceRange(Math.min(0, ...values), Math.max(0, ...values));
+}
+/** Clean-tick bounds around a raw range. */
+export function niceRange(rawMin, rawMax) {
+    if (rawMax === rawMin)
+        return { min: rawMin, max: rawMin + 1, step: 0.25 };
+    const step = niceStep(rawMax - rawMin, 4);
+    return {
+        min: Math.floor(rawMin / step) * step,
+        max: Math.ceil(rawMax / step) * step,
+        step,
+    };
+}
+/**
+ * Bounds for an encoded value axis: the data range (with zero when `zero`),
+ * overridden by the author's `min`/`max`, with a clean step between them.
+ */
+export function axisBounds(values, axis, zero) {
+    const finite = values.filter((value) => Number.isFinite(value));
+    const low = finite.length === 0 ? 0 : Math.min(...finite, ...(zero ? [0] : []));
+    const high = finite.length === 0 ? 1 : Math.max(...finite, ...(zero ? [0] : []));
+    const nice = niceRange(low, high);
+    const min = axis.min ?? nice.min;
+    const max = axis.max ?? nice.max;
+    if (max <= min)
+        return nice;
+    if (axis.min === undefined && axis.max === undefined)
+        return nice;
+    return { min, max, step: niceStep(max - min, 4) };
+}
+export function plotWidth(frame) {
+    return frame.width - frame.left - frame.right;
+}
+export function plotHeight(frame) {
+    return frame.height - frame.top - frame.bottom;
+}
+export function scaleY(value, bounds, frame) {
+    const ratio = (value - bounds.min) / (bounds.max - bounds.min);
+    return round(frame.top + plotHeight(frame) * (1 - ratio));
+}
+/** A value clamped into the bounds, so an out-of-range mark stays inside the plot. */
+export function clampTo(value, bounds) {
+    return Math.min(bounds.max, Math.max(bounds.min, value));
+}
+export function scaleX(value, bounds, frame) {
+    const ratio = (value - bounds.min) / (bounds.max - bounds.min);
+    return round(frame.left + plotWidth(frame) * ratio);
+}
+/** Point charts span the plot edge to edge. */
+export function pointX(index, count, frame) {
+    if (count <= 1)
+        return round(frame.left + plotWidth(frame) / 2);
+    return round(frame.left + (plotWidth(frame) * index) / (count - 1));
+}
+/** Bar groups sit in equal bands, labelled at the band centre. */
+export function bandCentre(index, count, frame) {
+    const band = plotWidth(frame) / Math.max(count, 1);
+    return round(frame.left + band * index + band / 2);
+}
+/** Fragment-safe id fragment derived from a block id. */
+export function safeId(id) {
+    return id.replace(/[^A-Za-z0-9_-]/gu, '-');
+}
+/** Ticks from `min` to `max` in `step` increments, rounded. */
+export function tickValues(bounds) {
+    const steps = Math.round((bounds.max - bounds.min) / bounds.step);
+    const values = [];
+    for (let index = 0; index <= steps; index += 1) {
+        const value = denoise(bounds.min + bounds.step * index);
+        if (value <= bounds.max + bounds.step / 1000)
+            values.push(value);
+    }
+    return values;
+}
+/**
+ * The formatter for axis ticks: like `numberFormatter`, but whole-number
+ * currency ticks drop their cents ($15,000 rather than $15,000.00) unless the
+ * author fixed `decimals`.
+ */
+export function tickFormatter(spec, bounds) {
+    const whole = Number.isInteger(bounds.step) && Number.isInteger(bounds.min);
+    if (spec.format === 'currency' && spec.decimals === undefined && whole) {
+        return numberFormatter({ ...spec, decimals: 0 });
+    }
+    // A step finer than the format's default two decimals would print every
+    // tick the same ("0 | 0 | 0"), so the ticks get the decimals the step needs.
+    if (spec.decimals === undefined && bounds.step > 0 && bounds.step < 0.01) {
+        const needed = Math.min(4, Math.ceil(-Math.log10(bounds.step) - 1e-9));
+        return numberFormatter({ ...spec, decimals: needed });
+    }
+    return numberFormatter(spec);
+}
+//# sourceMappingURL=chart-scales.js.map

package/dist/render/chart-scales.js.map

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

package/dist/render/chart-svg-parts.d.ts

@@ -0,0 +1,50 @@
+/**
+ * SVG fragments every chart kind shares: gridlines and ticks, category
+ * labels, hover value labels and axis titles. Colour never appears here;
+ * shapes carry classes and the stylesheet maps them onto tokens.
+ */
+import { type Frame, type TickBounds } from './chart-scales.js';
+import type { ChartSeries, KindRender } from './chart-types.js';
+export type NumberFormatter = (value: number) => string;
+/** Horizontal gridlines with value ticks; the zero line reads as the axis. */
+export declare function gridAndTicks(bounds: TickBounds, frame: Frame, format?: NumberFormatter): string;
+/**
+ * Gridlines for an encoded axis whose author bounds need not land on a step:
+ * ticks stop at the last step inside the bounds, and the plot floor is drawn
+ * as the axis when zero is outside the range.
+ */
+export declare function boundedGridAndTicks(bounds: TickBounds, frame: Frame, format: NumberFormatter): string;
+/** Vertical gridlines and tick labels for a numeric x axis. */
+export declare function numericXTicks(bounds: TickBounds, frame: Frame, format: NumberFormatter, ticks?: readonly number[]): string;
+/**
+ * At most about eight evenly spaced label positions. The first and the last
+ * category are always labelled, so a series never reads as ending early; when
+ * the last would crowd the previous kept label, that one gives way.
+ */
+export declare function thinnedLabelIndexes(count: number): number[];
+export declare function categoryLabels(labels: string[], position: (index: number) => number, frame: Frame): string;
+export declare function pointTitle(label: string, series: ChartSeries, index: number): string;
+/**
+ * A value label drawn directly after its mark. The stylesheet reveals it while
+ * the mark is hovered or focused (`mark:hover + .ak-chart-value`), so the exact
+ * number is one pointer move away without a tooltip script.
+ */
+export declare function valueLabel(x: number, y: number, value: number): string;
+/**
+ * A hover value label with preformatted text. `halo` outlines it in the
+ * surface colour, for labels drawn over a filled mark.
+ */
+export declare function textValueLabel(x: number, y: number, text: string, halo?: boolean): string;
+/** Axis titles: the y title above the value ticks, the x title centred under the categories. */
+export declare function axisTitles(frame: Frame, x: string | undefined, y: string | undefined): string;
+/** A rectangle as a path, so golden tests can pin its geometry in one attribute. */
+export declare function rectPath(x: number, y: number, width: number, height: number): string;
+/** Bars wider than this read as slabs rather than marks. */
+export declare const MAX_BAR_WIDTH = 56;
+/** The index of a category label, or undefined when the axis has no such category. */
+export declare function categoryIndex(labels: readonly string[], x: string | number): number | undefined;
+/** Overlay coordinates for a cartesian plot. */
+export declare function plotFor(frame: Frame, bounds: TickBounds, xAt: (x: string | number) => number | undefined): NonNullable<KindRender['plot']>;
+/** Shorten text to `max` characters with an ellipsis. */
+export declare function clipText(text: string, max: number): string;
+//# sourceMappingURL=chart-svg-parts.d.ts.map

package/dist/render/chart-svg-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-svg-parts.d.ts","sourceRoot":"","sources":["../../src/render/chart-svg-parts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,KAAK,EAKV,KAAK,UAAU,EAEhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGhE,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAExD,8EAA8E;AAC9E,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,KAAK,EACZ,MAAM,GAAE,eAA8B,GACrC,MAAM,CAkBR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,eAAe,GACtB,MAAM,CAcR;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,eAAe,EACvB,KAAK,GAAE,SAAS,MAAM,EAAuB,GAC5C,MAAM,CAWR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAW3D;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EACnC,KAAK,EAAE,KAAK,GACX,MAAM,CAUR;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,MAAM,CAIvF;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAe7F;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED,4DAA4D;AAC5D,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAG/F;AAED,gDAAgD;AAChD,wBAAgB,OAAO,CACrB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,GAAG,SAAS,GAC9C,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAQjC;AAED,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D"}