@bestagentkits/render 0.2.0 → 0.3.0

package/dist/render/chart-svg-parts.js

@@ -0,0 +1,125 @@
+/**
+ * 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 { clampTo, formatNumber, round, scaleX, scaleY, tickValues, } from './chart-scales.js';
+import { escapeText } from './escape.js';
+/** Horizontal gridlines with value ticks; the zero line reads as the axis. */
+export function gridAndTicks(bounds, frame, format = formatNumber) {
+    const parts = [];
+    const steps = Math.round((bounds.max - bounds.min) / bounds.step);
+    for (let index = 0; index <= steps; index += 1) {
+        const value = round(bounds.min + bounds.step * index);
+        const y = scaleY(value, bounds, frame);
+        parts.push(`<line class="${value === 0 ? 'ak-chart-axis' : 'ak-chart-grid'}" x1="${frame.left}" y1="${y}" x2="${frame.width - frame.right}" y2="${y}"/>`);
+        parts.push(`<text class="ak-chart-label" x="${frame.left - 8}" y="${round(y + 4)}" text-anchor="end">${escapeText(format(value))}</text>`);
+    }
+    return parts.join('');
+}
+/**
+ * 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 function boundedGridAndTicks(bounds, frame, format) {
+    const ticks = tickValues(bounds);
+    const hasZero = ticks.includes(0);
+    return ticks
+        .map((value, index) => {
+        const y = scaleY(value, bounds, frame);
+        const axis = value === 0 || (!hasZero && index === 0);
+        return `<line class="${axis ? 'ak-chart-axis' : 'ak-chart-grid'}" x1="${frame.left}" y1="${y}" x2="${frame.width - frame.right}" y2="${y}"/><text class="ak-chart-label" x="${frame.left - 8}" y="${round(y + 4)}" text-anchor="end">${escapeText(format(value))}</text>`;
+    })
+        .join('');
+}
+/** Vertical gridlines and tick labels for a numeric x axis. */
+export function numericXTicks(bounds, frame, format, ticks = tickValues(bounds)) {
+    return ticks
+        .map((value) => {
+        const x = scaleX(value, bounds, frame);
+        return `<line class="ak-chart-grid" x1="${x}" y1="${frame.top}" x2="${x}" y2="${frame.height - frame.bottom}"/><text class="ak-chart-label" x="${x}" y="${frame.height - frame.bottom + 20}" text-anchor="middle">${escapeText(format(value))}</text>`;
+    })
+        .join('');
+}
+/**
+ * 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 function thinnedLabelIndexes(count) {
+    const step = Math.max(1, Math.ceil(count / 8));
+    const indexes = [];
+    for (let index = 0; index < count; index += step)
+        indexes.push(index);
+    const last = count - 1;
+    const previous = indexes.at(-1);
+    if (previous !== undefined && previous !== last) {
+        if (indexes.length > 1 && last - previous < step)
+            indexes.pop();
+        indexes.push(last);
+    }
+    return indexes;
+}
+export function categoryLabels(labels, position, frame) {
+    const parts = [];
+    for (const index of thinnedLabelIndexes(labels.length)) {
+        parts.push(`<text class="ak-chart-label" x="${position(index)}" y="${frame.height - frame.bottom + 20}" text-anchor="middle">${escapeText(labels[index] ?? '')}</text>`);
+    }
+    return parts.join('');
+}
+export function pointTitle(label, series, index) {
+    return `${label}: ${series.label} ${series.values[index] ?? 0}`;
+}
+/**
+ * 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 function valueLabel(x, y, value) {
+    return textValueLabel(x, y, formatNumber(value));
+}
+/**
+ * A hover value label with preformatted text. `halo` outlines it in the
+ * surface colour, for labels drawn over a filled mark.
+ */
+export function textValueLabel(x, y, text, halo = false) {
+    return `<text class="ak-chart-value${halo ? ' ak-chart-value--halo' : ''}" x="${round(x)}" y="${round(y)}" text-anchor="middle" aria-hidden="true">${escapeText(text)}</text>`;
+}
+/** Axis titles: the y title above the value ticks, the x title centred under the categories. */
+export function axisTitles(frame, x, y) {
+    const parts = [];
+    if (y !== undefined && y !== '') {
+        parts.push(`<text class="ak-chart-axis-title" x="${frame.left - 8}" y="${frame.top - 14}" text-anchor="end">${escapeText(y)}</text>`);
+    }
+    if (x !== undefined && x !== '') {
+        parts.push(`<text class="ak-chart-axis-title" x="${round(frame.left + (frame.width - frame.left - frame.right) / 2)}" y="${frame.height - 6}" text-anchor="middle">${escapeText(x)}</text>`);
+    }
+    return parts.join('');
+}
+/** A rectangle as a path, so golden tests can pin its geometry in one attribute. */
+export function rectPath(x, y, width, height) {
+    return `M${round(x)},${round(y)} h${round(width)} v${round(height)} h${round(-width)} Z`;
+}
+/** Bars wider than this read as slabs rather than marks. */
+export const MAX_BAR_WIDTH = 56;
+/** The index of a category label, or undefined when the axis has no such category. */
+export function categoryIndex(labels, x) {
+    const index = labels.indexOf(String(x));
+    return index < 0 ? undefined : index;
+}
+/** Overlay coordinates for a cartesian plot. */
+export function plotFor(frame, bounds, xAt) {
+    return {
+        top: frame.top,
+        bottom: frame.height - frame.bottom,
+        right: frame.width - frame.right,
+        xAt,
+        yAt: (y) => scaleY(clampTo(y, bounds), bounds, frame),
+    };
+}
+/** Shorten text to `max` characters with an ellipsis. */
+export function clipText(text, max) {
+    return text.length <= max ? text : `${text.slice(0, Math.max(1, max - 1))}…`;
+}
+//# sourceMappingURL=chart-svg-parts.js.map

package/dist/render/chart-svg-parts.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * The text side of an encoded chart: legend entries, the generated summary,
+ * and the fallback table. Values are formatted with the chart's encoding, so
+ * the summary, the table and the hover labels read the same.
+ */
+import type { NumberFormatter } from './chart-svg-parts.js';
+import type { ChartInput, ChartTable, LegendEntry } from './chart-types.js';
+/** One entry per series, only when there are two or more (colour then carries meaning). */
+export declare function seriesLegend(input: ChartInput): LegendEntry[];
+/** One entry per category, for kinds that colour each category (pie, donut). */
+export declare function categoryLegend(input: ChartInput): LegendEntry[];
+export declare function seriesSummary(input: ChartInput, format: NumberFormatter): string;
+/** The original series-by-category table, with formatted values. */
+export declare function seriesTable(input: ChartInput, format: NumberFormatter): ChartTable;
+/** The table markup; the first cell of each row is its header. */
+export declare function renderTable(caption: string, table: ChartTable): string;
+export declare function renderLegend(entries: readonly LegendEntry[]): string;
+//# sourceMappingURL=chart-text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-text.d.ts","sourceRoot":"","sources":["../../src/render/chart-text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG5E,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,EAAE,CAM7D;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,EAAE,CAE/D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAYhF;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,GAAG,UAAU,CAclF;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAkBtE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAQpE"}

package/dist/render/chart-text.js

@@ -0,0 +1,69 @@
+/**
+ * The text side of an encoded chart: legend entries, the generated summary,
+ * and the fallback table. Values are formatted with the chart's encoding, so
+ * the summary, the table and the hover labels read the same.
+ */
+import { seriesClass } from './chart-scales.js';
+import { escapeText } from './escape.js';
+/** One entry per series, only when there are two or more (colour then carries meaning). */
+export function seriesLegend(input) {
+    if (input.series.length < 2)
+        return [];
+    return input.series.map((series, index) => ({
+        label: series.label,
+        swatch: seriesClass(index),
+    }));
+}
+/** One entry per category, for kinds that colour each category (pie, donut). */
+export function categoryLegend(input) {
+    return input.labels.map((label, index) => ({ label, swatch: seriesClass(index) }));
+}
+export function seriesSummary(input, format) {
+    return input.series
+        .map((series) => `${series.label}: ${input.labels
+        .map((label, index) => {
+        const value = series.values[index];
+        return value === undefined ? label : `${label} ${format(value)}`;
+    })
+        .join(', ')}`)
+        .join('. ');
+}
+/** The original series-by-category table, with formatted values. */
+export function seriesTable(input, format) {
+    return {
+        columns: [
+            { label: 'Series', numeric: false },
+            ...input.labels.map((label) => ({ label, numeric: true })),
+        ],
+        rows: input.series.map((series) => [
+            series.label,
+            ...input.labels.map((_, index) => {
+                const value = series.values[index];
+                return value === undefined ? '' : format(value);
+            }),
+        ]),
+    };
+}
+/** The table markup; the first cell of each row is its header. */
+export function renderTable(caption, table) {
+    const numeric = (index) => (table.columns[index]?.numeric ? ' class="ak-num"' : '');
+    const head = table.columns
+        .map((column, index) => `<th scope="col"${numeric(index)}>${escapeText(column.label)}</th>`)
+        .join('');
+    const body = table.rows
+        .map((row) => `<tr>${row
+        .map((cell, index) => index === 0
+        ? `<th scope="row">${escapeText(cell)}</th>`
+        : `<td${numeric(index)}>${escapeText(cell)}</td>`)
+        .join('')}</tr>`)
+        .join('');
+    return `<table class="ak-chart-table"><caption>${escapeText(caption)}</caption><thead><tr>${head}</tr></thead><tbody>${body}</tbody></table>`;
+}
+export function renderLegend(entries) {
+    if (entries.length === 0)
+        return '';
+    return `<ul class="ak-chart-legend" aria-hidden="true">${entries
+        .map((entry) => `<li><span class="ak-chart-swatch ${entry.swatch}"></span>${escapeText(entry.label)}</li>`)
+        .join('')}</ul>`;
+}
+//# sourceMappingURL=chart-text.js.map

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

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

package/dist/render/chart-treemap-layout.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Squarified treemap layout (Bruls, Huizing and van Wijk).
+ *
+ * Cells are placed in input order: rows grow along the shorter side of the
+ * remaining rectangle while that keeps the worst aspect ratio from getting
+ * worse. Plain arithmetic in a fixed order, so the same values always give the
+ * same rectangles; callers round before emitting.
+ */
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Rectangles for positive values, one per value, in input order. Non-positive values get an empty rect. */
+export declare function squarify(values: readonly number[], bounds: Rect): Rect[];
+//# sourceMappingURL=chart-treemap-layout.d.ts.map

package/dist/render/chart-treemap-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-treemap-layout.d.ts","sourceRoot":"","sources":["../../src/render/chart-treemap-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAaD,4GAA4G;AAC5G,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,CAkDxE"}

package/dist/render/chart-treemap-layout.js

@@ -0,0 +1,74 @@
+/**
+ * Squarified treemap layout (Bruls, Huizing and van Wijk).
+ *
+ * Cells are placed in input order: rows grow along the shorter side of the
+ * remaining rectangle while that keeps the worst aspect ratio from getting
+ * worse. Plain arithmetic in a fixed order, so the same values always give the
+ * same rectangles; callers round before emitting.
+ */
+/** The worst aspect ratio of a row of areas laid along a side of length `side`. */
+function worst(row, side) {
+    const sum = row.reduce((total, area) => total + area, 0);
+    if (sum === 0 || side === 0)
+        return Number.POSITIVE_INFINITY;
+    const largest = Math.max(...row);
+    const smallest = Math.min(...row);
+    const sideSquared = side * side;
+    const sumSquared = sum * sum;
+    return Math.max((sideSquared * largest) / sumSquared, sumSquared / (sideSquared * smallest));
+}
+/** Rectangles for positive values, one per value, in input order. Non-positive values get an empty rect. */
+export function squarify(values, bounds) {
+    const out = values.map(() => ({ x: bounds.x, y: bounds.y, width: 0, height: 0 }));
+    const indexes = values.map((_, index) => index).filter((index) => (values[index] ?? 0) > 0);
+    const total = indexes.reduce((sum, index) => sum + (values[index] ?? 0), 0);
+    if (total <= 0)
+        return out;
+    const scale = (bounds.width * bounds.height) / total;
+    const free = { ...bounds };
+    let row = [];
+    const placeRow = (members) => {
+        const areas = members.map((index) => (values[index] ?? 0) * scale);
+        const sum = areas.reduce((acc, area) => acc + area, 0);
+        if (free.width >= free.height) {
+            // A column on the left of the free space.
+            const width = free.height === 0 ? 0 : sum / free.height;
+            let y = free.y;
+            members.forEach((index, position) => {
+                const height = width === 0 ? 0 : (areas[position] ?? 0) / width;
+                out[index] = { x: free.x, y, width, height };
+                y += height;
+            });
+            free.x += width;
+            free.width -= width;
+        }
+        else {
+            // A row along the top of the free space.
+            const height = free.width === 0 ? 0 : sum / free.width;
+            let x = free.x;
+            members.forEach((index, position) => {
+                const width = height === 0 ? 0 : (areas[position] ?? 0) / height;
+                out[index] = { x, y: free.y, width, height };
+                x += width;
+            });
+            free.y += height;
+            free.height -= height;
+        }
+    };
+    for (const index of indexes) {
+        const side = Math.min(free.width, free.height);
+        const area = (values[index] ?? 0) * scale;
+        const current = row.map((member) => (values[member] ?? 0) * scale);
+        if (row.length === 0 || worst([...current, area], side) <= worst(current, side)) {
+            row.push(index);
+        }
+        else {
+            placeRow(row);
+            row = [index];
+        }
+    }
+    if (row.length > 0)
+        placeRow(row);
+    return out;
+}
+//# sourceMappingURL=chart-treemap-layout.js.map

package/dist/render/chart-treemap-layout.js.map

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

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

@@ -0,0 +1,107 @@
+/**
+ * Chart input types shared by the block layer and the SVG renderers.
+ *
+ * `ChartInput` without `encoded` is the original labels/series chart and keeps
+ * its original markup. `encoded` carries everything the later kinds and the
+ * dataset binding add: axis formats and bounds, points, cells, the fallback
+ * table and the overlays. The block layer resolves all of it from the spec and
+ * the materialized rows, so a renderer never reads the spec or the data itself.
+ */
+import type { FormatSpec } from '../data/format-value.js';
+export interface ChartSeries {
+    label: string;
+    values: number[];
+}
+/** One axis or magnitude encoding, after the field has been resolved. */
+export interface AxisSpec {
+    label?: string;
+    format: FormatSpec;
+    min?: number;
+    max?: number;
+}
+export interface ChartPoint {
+    x: number;
+    y: number;
+    /** Index into `ChartInput.series`. */
+    series: number;
+}
+export interface HeatCell {
+    /** Index into `ChartInput.labels` (columns). */
+    column: number;
+    /** Index into `EncodedChart.rowLabels`. */
+    row: number;
+    value: number;
+}
+export interface ChartMarker {
+    x: string | number;
+    label: string;
+}
+export interface ChartAnnotation {
+    x: string | number;
+    y: number;
+    text: string;
+}
+/** A fallback table: header labels, whether each column is numeric, and the formatted cells. */
+export interface ChartTable {
+    columns: {
+        label: string;
+        numeric: boolean;
+    }[];
+    rows: string[][];
+}
+export interface EncodedChart {
+    x: AxisSpec;
+    y: AxisSpec;
+    value: AxisSpec;
+    /** The fallback table built from the materialized rows; absent for inline charts. */
+    table?: ChartTable;
+    /** Scatter points. */
+    points: ChartPoint[];
+    /** Heatmap cells and their row categories. */
+    cells: HeatCell[];
+    rowLabels: string[];
+    /** Histogram samples. */
+    samples: number[];
+    /** Target histogram bin count. */
+    bins: number;
+    markers: ChartMarker[];
+    annotations: ChartAnnotation[];
+    /** Gauge target. */
+    target?: number;
+}
+export interface ChartInput {
+    kind: string;
+    id: string;
+    labels: string[];
+    series: ChartSeries[];
+    title?: string;
+    description?: string;
+    encoded?: EncodedChart;
+}
+/** One legend row: its text and the class that colours its swatch. */
+export interface LegendEntry {
+    label: string;
+    swatch: string;
+}
+/** What one encoded kind draws, before the shared figure wraps it. */
+export interface KindRender {
+    body: string;
+    viewBox: {
+        width: number;
+        height: number;
+    };
+    legend: LegendEntry[];
+    /** Generated summary sentence(s); the author's description replaces it. */
+    summary: string;
+    /** A kind-specific table (bins, running totals); otherwise the rows or the series table. */
+    table?: ChartTable;
+    /** Plot coordinates for overlays; set only on kinds drawn on x/y axes. */
+    plot?: {
+        top: number;
+        bottom: number;
+        right: number;
+        xAt(x: string | number): number | undefined;
+        yAt(y: number): number;
+    };
+}
+//# sourceMappingURL=chart-types.d.ts.map

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

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

package/dist/render/chart-types.js

@@ -0,0 +1,11 @@
+/**
+ * Chart input types shared by the block layer and the SVG renderers.
+ *
+ * `ChartInput` without `encoded` is the original labels/series chart and keeps
+ * its original markup. `encoded` carries everything the later kinds and the
+ * dataset binding add: axis formats and bounds, points, cells, the fallback
+ * table and the overlays. The block layer resolves all of it from the spec and
+ * the materialized rows, so a renderer never reads the spec or the data itself.
+ */
+export {};
+//# sourceMappingURL=chart-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-types.js","sourceRoot":"","sources":["../../src/render/chart-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/render/charts.d.ts

@@ -13,20 +13,37 @@
  * `ak-chart-s5`) and the stylesheet maps each class onto the theme accent and
  * hue rotations of it, so a chart always follows the active preset and colour
  * scheme and no two series share a colour.
+ *
+ * This module owns the original kinds and the original figure. A chart with
+ * `encoded` set (a later kind, a dataset binding or an overlay) is rendered by
+ * `chart-figure-encoded.ts`, which reuses the bar and line drawing below.
  */
+import { type Frame, type TickBounds } from './chart-scales.js';
+import { type NumberFormatter } from './chart-svg-parts.js';
+import type { ChartInput, ChartSeries } from './chart-types.js';
 import { escapeAttribute } from './escape.js';
-export interface ChartSeries {
-    label: string;
-    values: number[];
-}
-export interface ChartInput {
-    kind: string;
-    id: string;
-    labels: string[];
-    series: ChartSeries[];
-    title?: string;
-    description?: string;
+export type { ChartInput, ChartSeries } from './chart-types.js';
+/**
+ * How a bar or line chart scales and labels its values. The original kinds use
+ * `defaultCartesian`; encoded charts pass their own frame, bounds and format.
+ */
+export interface CartesianOptions {
+    frame: Frame;
+    bounds: TickBounds;
+    /** Gridlines and value ticks, already drawn for this frame and bounds. */
+    grid: string;
+    format: NumberFormatter;
+    title: (label: string, series: ChartSeries, index: number) => string;
 }
+/** Fragment-safe id prefix for gradients, derived from the block id. */
+export declare function gradientId(input: ChartInput, seriesIndex: number): string;
+export declare function barChart(input: ChartInput, options?: CartesianOptions): string;
+export declare function lineChart(input: ChartInput, area: boolean, options?: CartesianOptions): string;
+/** A sparkline is a trend glyph, so it scales to its own data range, not to zero. */
+export declare function sparkline(input: ChartInput): string;
+export declare function radialChart(input: ChartInput, donut: boolean): string;
+export declare function progressFrame(rows: number): Frame;
+export declare function progressChart(input: ChartInput, format?: NumberFormatter): string;
 /** Render one chart block as a figure containing SVG, a summary, and a table. */
 export declare function renderChart(input: ChartInput): string;
 /** Escape helper re-exported for chart consumers that build their own chart markup. */

package/dist/render/charts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"charts.d.ts","sourceRoot":"","sources":["../../src/render/charts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,eAAe,EAAgC,MAAM,aAAa,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAybD,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAuBrD;AAED,uFAAuF;AACvF,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"charts.d.ts","sourceRoot":"","sources":["../../src/render/charts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAIL,KAAK,KAAK,EAWV,KAAK,UAAU,EAEhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAGL,KAAK,eAAe,EAGrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAgC,MAAM,aAAa,CAAC;AAE5E,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOhE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACtE;AAaD,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,mBAA0B,GAAG,MAAM,CA8CrF;AAWD,wBAAgB,SAAS,CACvB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,EACb,OAAO,mBAA0B,GAChC,MAAM,CA+CR;AAED,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAyBnD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAmDrE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CASjD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,GAAE,eAA8B,GAAG,MAAM,CA6B/F;AA+DD,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAwBrD;AAED,uFAAuF;AACvF,OAAO,EAAE,eAAe,EAAE,CAAC"}