@bestagentkits/render 0.1.1-next.1 → 0.3.0

package/dist/render/chart-kinds-gauge-treemap.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Gauge and treemap. A gauge is a 180° band with an optional target tick; a
+ * treemap is a squarified layout of tinted, labelled cells.
+ */
+import type { ChartInput, EncodedChart, KindRender } from './chart-types.js';
+export declare function gaugeChart(input: ChartInput, encoded: EncodedChart): KindRender;
+export declare function treemapChart(input: ChartInput, encoded: EncodedChart): KindRender;
+//# sourceMappingURL=chart-kinds-gauge-treemap.d.ts.map

package/dist/render/chart-kinds-gauge-treemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-kinds-gauge-treemap.d.ts","sourceRoot":"","sources":["../../src/render/chart-kinds-gauge-treemap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAmB7E,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,CA6E/E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,CA8CjF"}

package/dist/render/chart-kinds-gauge-treemap.js

@@ -0,0 +1,101 @@
+/**
+ * Gauge and treemap. A gauge is a 180° band with an optional target tick; a
+ * treemap is a squarified layout of tinted, labelled cells.
+ */
+import { numberFormatter, round, seriesClass, WIDTH } from './chart-scales.js';
+import { clipText, rectPath } from './chart-svg-parts.js';
+import { squarify } from './chart-treemap-layout.js';
+import { escapeText } from './escape.js';
+const TREEMAP_HEIGHT = 360;
+function arcPoint(cx, cy, radius, angle) {
+    return `${round(cx + radius * Math.cos(angle))},${round(cy + radius * Math.sin(angle))}`;
+}
+/** An annular band from `from` to `to` (radians, clockwise in SVG space). */
+function band(cx, cy, outer, inner, from, to) {
+    return `M${arcPoint(cx, cy, outer, from)} A${outer},${outer} 0 0 1 ${arcPoint(cx, cy, outer, to)} L${arcPoint(cx, cy, inner, to)} A${inner},${inner} 0 0 0 ${arcPoint(cx, cy, inner, from)} Z`;
+}
+export function gaugeChart(input, encoded) {
+    const format = numberFormatter(encoded.value.format);
+    const min = encoded.value.min ?? 0;
+    const max = encoded.value.max ?? 100;
+    const value = input.series[0]?.values[0] ?? 0;
+    const ratio = max > min ? Math.min(1, Math.max(0, (value - min) / (max - min))) : 0;
+    const cx = WIDTH / 2;
+    const cy = 200;
+    const outer = 160;
+    const inner = 118;
+    const start = Math.PI;
+    const label = input.labels[0] ?? input.series[0]?.label ?? '';
+    const parts = [
+        `<path class="ak-chart-track" d="${band(cx, cy, outer, inner, start, 2 * Math.PI)}"/>`,
+    ];
+    if (ratio > 0) {
+        parts.push(`<path class="ak-chart-slice ak-chart-gauge ${seriesClass(0)}" tabindex="0" d="${band(cx, cy, outer, inner, start, start + Math.PI * ratio)}"><title>${escapeText(`${label}: ${format(value)} of ${format(max)}`)}</title></path>`);
+    }
+    const target = encoded.target;
+    let targetText = '';
+    if (target !== undefined && max > min) {
+        const angle = start + Math.PI * Math.min(1, Math.max(0, (target - min) / (max - min)));
+        parts.push(`<line class="ak-chart-target" x1="${round(cx + (inner - 8) * Math.cos(angle))}" y1="${round(cy + (inner - 8) * Math.sin(angle))}" x2="${round(cx + (outer + 8) * Math.cos(angle))}" y2="${round(cy + (outer + 8) * Math.sin(angle))}"/>`, `<text class="ak-chart-label" x="${round(cx + (outer + 16) * Math.cos(angle))}" y="${round(cy + (outer + 16) * Math.sin(angle))}" text-anchor="${Math.cos(angle) < -0.2 ? 'end' : Math.cos(angle) > 0.2 ? 'start' : 'middle'}">${escapeText(`Target ${format(target)}`)}</text>`);
+        targetText = `; target ${format(target)}`;
+    }
+    parts.push(`<text class="ak-chart-total" x="${cx}" y="${cy - 14}" text-anchor="middle">${escapeText(format(value))}</text>`, `<text class="ak-chart-label" x="${cx}" y="${cy + 6}" text-anchor="middle">${escapeText(label)}</text>`, `<text class="ak-chart-label" x="${cx - (outer + inner) / 2}" y="${cy + 22}" text-anchor="middle">${escapeText(format(min))}</text>`, `<text class="ak-chart-label" x="${cx + (outer + inner) / 2}" y="${cy + 22}" text-anchor="middle">${escapeText(format(max))}</text>`);
+    return {
+        body: parts.join(''),
+        viewBox: { width: WIDTH, height: 232 },
+        legend: [],
+        summary: `${label}: ${format(value)} on a scale of ${format(min)} to ${format(max)}${targetText}.`,
+        table: {
+            columns: [
+                { label: 'Measure', numeric: false },
+                { label: 'Value', numeric: true },
+                { label: 'Minimum', numeric: true },
+                { label: 'Maximum', numeric: true },
+                ...(target === undefined ? [] : [{ label: 'Target', numeric: true }]),
+            ],
+            rows: [
+                [
+                    label,
+                    format(value),
+                    format(min),
+                    format(max),
+                    ...(target === undefined ? [] : [format(target)]),
+                ],
+            ],
+        },
+    };
+}
+export function treemapChart(input, encoded) {
+    const format = numberFormatter(encoded.value.format);
+    const share = numberFormatter({ format: 'percent' });
+    const values = input.labels.map((_, index) => input.series[0]?.values[index] ?? 0);
+    const total = values.reduce((sum, value) => sum + Math.max(0, value), 0);
+    const rects = squarify(values, { x: 0, y: 0, width: WIDTH, height: TREEMAP_HEIGHT });
+    const parts = [];
+    rects.forEach((rect, index) => {
+        const value = values[index] ?? 0;
+        if (value <= 0 || rect.width <= 0 || rect.height <= 0)
+            return;
+        const label = input.labels[index] ?? '';
+        const percent = total > 0 ? share((value / total) * 100) : '';
+        parts.push(`<path class="ak-chart-cell ${seriesClass(index)}" tabindex="0" d="${rectPath(rect.x + 1.5, rect.y + 1.5, Math.max(0, rect.width - 3), Math.max(0, rect.height - 3))}"><title>${escapeText(`${label}: ${format(value)} (${percent})`)}</title></path>`);
+        if (rect.width >= 64 && rect.height >= 34) {
+            parts.push(`<text class="ak-chart-cell-label" x="${round(rect.x + 10)}" y="${round(rect.y + 22)}">${escapeText(clipText(label, Math.floor((rect.width - 16) / 7.5)))}</text>`);
+            if (rect.height >= 54) {
+                parts.push(`<text class="ak-chart-cell-value" x="${round(rect.x + 10)}" y="${round(rect.y + 40)}">${escapeText(clipText(`${format(value)} · ${percent}`, Math.floor((rect.width - 16) / 7)))}</text>`);
+            }
+        }
+    });
+    return {
+        body: parts.join(''),
+        viewBox: { width: WIDTH, height: TREEMAP_HEIGHT },
+        legend: [],
+        summary: `${input.series[0]?.label ?? 'Total'} ${format(total)}: ${input.labels
+            .map((label, index) => {
+            const value = values[index] ?? 0;
+            return `${label} ${format(value)}${total > 0 ? ` (${share((Math.max(0, value) / total) * 100)})` : ''}`;
+        })
+            .join(', ')}`,
+    };
+}
+//# sourceMappingURL=chart-kinds-gauge-treemap.js.map

package/dist/render/chart-kinds-gauge-treemap.js.map

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

package/dist/render/chart-kinds-histogram-waterfall.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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 type { ChartInput, EncodedChart, KindRender } from './chart-types.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 declare function histogramEdges(samples: readonly number[], bins: number): number[];
+/** Samples per bin; each bin is [a, b) and the last is closed. */
+export declare function histogramCounts(samples: readonly number[], edges: readonly number[]): number[];
+export declare function histogramChart(input: ChartInput, encoded: EncodedChart): KindRender;
+/** Running total of signed changes, closed by a computed total bar. */
+export declare function waterfallChart(input: ChartInput, encoded: EncodedChart): KindRender;
+//# sourceMappingURL=chart-kinds-histogram-waterfall.d.ts.map

package/dist/render/chart-kinds-histogram-waterfall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-kinds-histogram-waterfall.d.ts","sourceRoot":"","sources":["../../src/render/chart-kinds-histogram-waterfall.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4BH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG7E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BjF;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAe9F;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,CA2DnF;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,CA2FnF"}

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":"AAAA;;;GAGG;AAEH,OAAO,EACL,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,eAAe,EACf,SAAS,EACT,KAAK,EACL,MAAM,EACN,MAAM,EACN,WAAW,EAEX,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,OAAO,EACP,QAAQ,EACR,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAA0B,EAAE,IAAY;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IACjC,2EAA2E;IAC3E,6EAA6E;IAC7E,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;IAChG,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;IACtF,CAAC,CAAC;IACF,IAAI,IAAI,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;IAClC,KAAK,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YAAE,IAAI,GAAG,SAAS,CAAC;IAC3F,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAClG,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AACrC,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,OAA0B,EAAE,KAAwB;IAClF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,KAAK,CAAS,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/C,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CACnB,IAAI,GAAG,CAAC,EACR,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAChE,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,OAAqB;IACrE,MAAM,KAAK,GAAG,gBAAgB,CAAC;IAC/B,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACtE,MAAM,OAAO,GAAe,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC5D,uEAAuE;IACvE,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KACE,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG,QAAQ,EACjD,IAAI,IAAI,IAAI,GAAG,QAAQ,GAAG,IAAI,EAC9B,IAAI,IAAI,QAAQ,EAChB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CACvB,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAChF,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACvC,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACrD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QACvC,OAAO,6BAA6B,WAAW,CAAC,CAAC,CAAC,qBAAqB,QAAQ,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,YAAY,UAAU,CAChI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,EAAE,CACpC,kBAAkB,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IAC/E,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,QAAQ,CAAC;IACpE,OAAO;QACL,IAAI,EAAE,GAAG,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CACtK,EAAE,CACH,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,EAAE;QACpE,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,EAAE;QACV,OAAO,EACL,MAAM,CAAC,MAAM,KAAK,CAAC;YACjB,CAAC,CAAC,GAAG,KAAK,cAAc;YACxB,CAAC,CAAC,GAAG,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,cAAc,MAAM,CAAC,MAAM,cAAc,OAAO,CAAC,KAAK,CAAC,OAAO,OAAO,CACtG,IAAI,CACL,8BAA8B,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI;QACxF,KAAK,EAAE;YACL,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;gBAChC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;aAClC;YACD,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;SACxE;QACD,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAClC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAChF;KACF,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,OAAqB;IACrE,MAAM,KAAK,GAAG,gBAAgB,CAAC;IAC/B,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAChG,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,GAAG,GAAG,CACV,KAAa,EACb,IAAY,EACZ,EAAU,EACV,IAAY,EACZ,IAAY,EACZ,KAAa,EACb,EAAE;QACF,MAAM,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9D,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACxD,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CACR,6BAA6B,IAAI,qBAAqB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,YAAY,UAAU,CACjI,KAAK,CACN,iBAAiB,EAClB,cAAc,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,CAC7C,CAAC;QACF,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACtB,CAAC,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;QACnC,MAAM,GAAG,GAAG,GAAG,CACb,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,EACjD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAClB,GAAG,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,MAAM,CAAC,IAAI,CAAC,EAAE,CACtE,CAAC;QACF,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;QACtE,KAAK,CAAC,IAAI,CACR,wCAAwC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,KAAK,SAAS,GAAG,CAAC,CAAC,KAAK,CAC5G,CAAC;QACF,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,UAAU,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtF,OAAO;QACL,IAAI,EAAE,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,cAAc,CACnG,MAAM,EACN,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAC3C,KAAK,CACN,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;QAC1E,OAAO,EAAE,KAAK;QACd,MAAM,EAAE;YACN,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE;YAC5C,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE;YAC9C,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE;SAC3C;QACD,OAAO,EAAE,GAAG,MAAM,CAAC,KAAK,KAAK,KAAK;aAC/B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;aACpD,IAAI,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,KAAK,CAAC,GAAG;QACxC,KAAK,EAAE;YACL,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;gBACpD,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;gBAClC,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE;aAC1C;YACD,IAAI,EAAE;gBACJ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBAC5B,IAAI,CAAC,KAAK;oBACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;oBAClB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;iBAC5B,CAAC;gBACF,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;aAC7B;SACF;QACD,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;YACjC,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACvC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC5E,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}

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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"}