@bestagentkits/render 0.2.0 → 0.3.0

package/dist/blocks/chart/chart-check.js

@@ -0,0 +1,196 @@
+/**
+ * Cross-field chart checks: what the prop schema cannot express.
+ *
+ * Inline charts need labels and series; bound charts must not repeat them and
+ * must name existing, numeric fields for each kind's encodings. Kind rules
+ * (gauge range, funnel order, treemap size, stacked shares) run on the same
+ * resolved input the renderer draws.
+ */
+import { fieldValue } from '../../data/dataset-types.js';
+import { reportUnknownField } from '../../data/resolve-block-data.js';
+import { pathKey } from '../../diagnostics.js';
+import { isPlainObject } from '../../json.js';
+import { listProp, stringProp } from '../../render/block-helpers.js';
+import { checkKindRules } from './chart-check-kind-rules.js';
+import { encodingProp, magnitudeEncoding, seriesField, } from './chart-encodings.js';
+import { CARTESIAN_KINDS, DATA_ONLY_KINDS, SINGLE_SERIES_KINDS, SORTABLE_KINDS, } from './chart-kinds.js';
+/** The encodings each kind needs when bound to data: [prop key, numeric]. */
+function requiredEncodings(kind, magnitudeKey) {
+    switch (kind) {
+        case 'scatter':
+            return [
+                ['x', true],
+                ['y', true],
+            ];
+        case 'heatmap':
+            return [
+                ['x', false],
+                ['y', false],
+                ['value', true],
+            ];
+        case 'histogram':
+            return [['x', true]];
+        case 'gauge':
+            return [[magnitudeKey, true]];
+        default:
+            return [
+                ['x', false],
+                [magnitudeKey, true],
+            ];
+    }
+}
+function checkBound(node, kind, report, bag) {
+    const data = node.data;
+    if (data === undefined)
+        return false;
+    let ok = true;
+    if (listProp(node, 'labels').length > 0) {
+        ok = false;
+        report({
+            path: pathKey(node.path, 'labels'),
+            message: 'labels come from x.field when the chart binds dataRef or data; remove labels',
+        });
+    }
+    if (Array.isArray(node.props.series)) {
+        ok = false;
+        report({
+            path: pathKey(node.path, 'series'),
+            message: 'with dataRef or data, series is { field } or absent; remove the inline series',
+        });
+    }
+    const magnitude = magnitudeEncoding(node);
+    for (const [key, isNumeric] of requiredEncodings(kind, magnitude.key)) {
+        const prop = encodingProp(node, key);
+        const path = pathKey(pathKey(node.path, key), 'field');
+        if (prop?.field === undefined) {
+            ok = false;
+            report({
+                path,
+                message: `a ${kind} chart bound to data needs ${key}.field`,
+                details: { allowed: [...data.fields] },
+            });
+            continue;
+        }
+        if (!data.fields.includes(prop.field)) {
+            ok = false;
+            reportUnknownField(prop.field, data, path, bag, node.id);
+            continue;
+        }
+        if (isNumeric) {
+            const bad = data.rows.findIndex((row) => {
+                const value = fieldValue(row, prop.field);
+                return value !== null && typeof value !== 'number';
+            });
+            if (bad >= 0) {
+                ok = false;
+                report({
+                    path,
+                    message: `field "${prop.field}" must hold numbers; row ${bad} has ${JSON.stringify(fieldValue(data.rows[bad] ?? {}, prop.field))}`,
+                });
+            }
+        }
+    }
+    const group = seriesField(node);
+    if (group !== undefined) {
+        const path = pathKey(pathKey(node.path, 'series'), 'field');
+        if (SINGLE_SERIES_KINDS.includes(kind)) {
+            report({ path, message: `a ${kind} chart draws one series; remove series.field` });
+        }
+        else if (!data.fields.includes(group)) {
+            ok = false;
+            reportUnknownField(group, data, path, bag, node.id);
+        }
+    }
+    // Fields named by encodings the kind does not require still have to exist.
+    for (const key of ['x', 'y', 'value']) {
+        const field = encodingProp(node, key)?.field;
+        if (field !== undefined && !data.fields.includes(field)) {
+            reportUnknownField(field, data, pathKey(pathKey(node.path, key), 'field'), bag, node.id);
+            ok = false;
+        }
+    }
+    return ok;
+}
+function checkInline(node, kind, report, bag) {
+    // A failed dataRef/data/transform is already reported; do not pile on.
+    const dataPath = pathKey(node.path, 'data');
+    const transformPath = pathKey(node.path, 'transform');
+    if (bag
+        .errors()
+        .some((item) => item.path.startsWith(dataPath) || item.path.startsWith(transformPath))) {
+        return false;
+    }
+    let ok = true;
+    for (const key of ['x', 'y', 'value']) {
+        if (encodingProp(node, key)?.field !== undefined) {
+            ok = false;
+            report({
+                path: pathKey(pathKey(node.path, key), 'field'),
+                message: `${key}.field needs dataRef or data to read from`,
+            });
+        }
+    }
+    if (isPlainObject(node.props.series)) {
+        ok = false;
+        report({
+            path: pathKey(pathKey(node.path, 'series'), 'field'),
+            message: 'series.field needs dataRef or data to read from',
+        });
+    }
+    if (DATA_ONLY_KINDS.includes(kind)) {
+        report({
+            path: pathKey(node.path, 'dataRef'),
+            message: `a ${kind} chart needs dataRef or data`,
+        });
+        return false;
+    }
+    if (kind !== 'histogram' && listProp(node, 'labels').length === 0) {
+        ok = false;
+        report({ path: pathKey(node.path, 'labels'), message: 'required value is missing' });
+    }
+    if (node.props.series === undefined) {
+        ok = false;
+        report({ path: pathKey(node.path, 'series'), message: 'required value is missing' });
+    }
+    return ok;
+}
+function warnUnused(node, kind, report) {
+    const warn = (key, message) => report({ path: pathKey(node.path, key), message, severity: 'warning' });
+    if (!CARTESIAN_KINDS.includes(kind)) {
+        if (listProp(node, 'markers').length > 0)
+            warn('markers', `a ${kind} chart has no x axis for markers`);
+        if (listProp(node, 'annotations').length > 0) {
+            warn('annotations', `a ${kind} chart has no x/y axes for annotations`);
+        }
+    }
+    if (node.props.bins !== undefined && kind !== 'histogram')
+        warn('bins', 'bins applies to histogram only');
+    if (node.props.target !== undefined && kind !== 'gauge')
+        warn('target', 'target applies to gauge only');
+    if (node.props.sort !== undefined && !SORTABLE_KINDS.includes(kind)) {
+        warn('sort', `sort applies to ${SORTABLE_KINDS.join(', ')}`);
+    }
+}
+function checkBounds(node, key, prop, report) {
+    if (prop?.min !== undefined && prop.max !== undefined && prop.min >= prop.max) {
+        report({
+            path: pathKey(pathKey(node.path, key), 'max'),
+            message: `${key}.max (${prop.max}) must be greater than ${key}.min (${prop.min})`,
+        });
+        return false;
+    }
+    return true;
+}
+export function checkChart(node, bag) {
+    const kind = stringProp(node, 'kind');
+    const before = bag.errorCount;
+    const report = (input) => bag.add({ code: 'SPEC_VALIDATION_ERROR', ...input, nodeId: node.id });
+    warnUnused(node, kind, report);
+    const shaped = node.data === undefined
+        ? checkInline(node, kind, report, bag)
+        : checkBound(node, kind, report, bag);
+    const bounded = ['x', 'y', 'value'].every((key) => checkBounds(node, key, encodingProp(node, key), report));
+    if (shaped && bounded && bag.errorCount === before)
+        checkKindRules(node, kind, report);
+}
+//# sourceMappingURL=chart-check.js.map

package/dist/blocks/chart/chart-check.js.map

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

package/dist/blocks/chart/chart-encoding-schema.d.ts

@@ -0,0 +1,7 @@
+/** Prop schemas for chart encodings and overlays. Descriptions stay terse: `describe` carries them. */
+import type { PropSchema } from '../../registry/prop-schema.js';
+export declare const CHART_SORTS: readonly ["none", "ascending", "descending"];
+export declare const CHART_ENCODING_PROPS: Record<string, PropSchema>;
+/** `series`: inline `[{ label, values }]`, or `{ field }` to pivot bound rows. */
+export declare const SERIES_PROP: PropSchema;
+//# sourceMappingURL=chart-encoding-schema.d.ts.map

package/dist/blocks/chart/chart-encoding-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-encoding-schema.d.ts","sourceRoot":"","sources":["../../../src/blocks/chart/chart-encoding-schema.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAavG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,eAAO,MAAM,WAAW,8CAA+C,CAAC;AAgBxE,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAoB3D,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,WAAW,EAAE,UAMxB,CAAC"}

package/dist/blocks/chart/chart-encoding-schema.js

@@ -0,0 +1,39 @@
+/** Prop schemas for chart encodings and overlays. Descriptions stay terse: `describe` carries them. */
+import { FORMAT_FIELDS } from '../../data/format-value.js';
+import { enumStr, itemsOf, LABEL, list, num, obj, oneOf, str, } from '../../registry/define-helpers.js';
+export const CHART_SORTS = ['none', 'ascending', 'descending'];
+const FIELD = str({ maxLength: 64, description: 'Field of the bound rows.' });
+/** One encoding: the field it reads, how it is titled and formatted, and optional bounds. */
+const ENCODING_FIELDS = {
+    field: FIELD,
+    label: str({ maxLength: 80 }),
+    ...FORMAT_FIELDS,
+    min: num(),
+    max: num(),
+};
+/** A category name or a number on a numeric x axis. */
+const X_POSITION = oneOf([str({ maxLength: 80 }), num()], { required: true });
+export const CHART_ENCODING_PROPS = {
+    x: obj(ENCODING_FIELDS),
+    y: obj(ENCODING_FIELDS),
+    value: obj(ENCODING_FIELDS, {
+        description: 'Magnitude for heatmap, funnel, gauge, treemap, pie.',
+    }),
+    bins: num({ integer: true, min: 2, max: 30, description: 'Histogram only.' }),
+    markers: list(obj({ x: X_POSITION, label: str({ required: true, maxLength: 80 }) }), {
+        maxItems: 6,
+    }),
+    annotations: list(obj({
+        x: X_POSITION,
+        y: num({ required: true }),
+        text: str({ required: true, maxLength: 160 }),
+    }), { maxItems: 8 }),
+    sort: enumStr(CHART_SORTS, { description: 'bar, stacked-bar, funnel, treemap.' }),
+    target: num({ description: 'Gauge only.' }),
+};
+/** `series`: inline `[{ label, values }]`, or `{ field }` to pivot bound rows. */
+export const SERIES_PROP = oneOf([
+    itemsOf({ label: LABEL, values: list(num(), { required: true, minItems: 1, maxItems: 200 }) }, { minItems: 1 }),
+    obj({ field: str({ required: true, maxLength: 64 }) }),
+]);
+//# sourceMappingURL=chart-encoding-schema.js.map

package/dist/blocks/chart/chart-encoding-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-encoding-schema.js","sourceRoot":"","sources":["../../../src/blocks/chart/chart-encoding-schema.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,OAAO,EACP,OAAO,EACP,KAAK,EACL,IAAI,EACJ,GAAG,EACH,GAAG,EACH,KAAK,EACL,GAAG,GACJ,MAAM,kCAAkC,CAAC;AAG1C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AAExE,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC,CAAC;AAE9E,6FAA6F;AAC7F,MAAM,eAAe,GAA+B;IAClD,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC7B,GAAG,aAAa;IAChB,GAAG,EAAE,GAAG,EAAE;IACV,GAAG,EAAE,GAAG,EAAE;CACX,CAAC;AAEF,uDAAuD;AACvD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAA+B;IAC9D,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC;IACvB,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC;IACvB,KAAK,EAAE,GAAG,CAAC,eAAe,EAAE;QAC1B,WAAW,EAAE,qDAAqD;KACnE,CAAC;IACF,IAAI,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;IAC7E,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;QACnF,QAAQ,EAAE,CAAC;KACZ,CAAC;IACF,WAAW,EAAE,IAAI,CACf,GAAG,CAAC;QACF,CAAC,EAAE,UAAU;QACb,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC1B,IAAI,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;KAC9C,CAAC,EACF,EAAE,QAAQ,EAAE,CAAC,EAAE,CAChB;IACD,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC;IACjF,MAAM,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;CAC5C,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GAAe,KAAK,CAAC;IAC3C,OAAO,CACL,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,EACrF,EAAE,QAAQ,EAAE,CAAC,EAAE,CAChB;IACD,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;CACvD,CAAC,CAAC"}

package/dist/blocks/chart/chart-encodings.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Reading a chart's encoding props: the authored `x`/`y`/`value` objects, the
+ * `{ field }` series form, and which encoding carries the plotted magnitude.
+ */
+import type { FormatSpec } from '../../data/format-value.js';
+import type { IrNode } from '../../ir.js';
+import type { AxisSpec } from '../../render/chart-types.js';
+/** An encoding prop as authored (after schema validation). */
+export interface EncodingProp {
+    field?: string;
+    label?: string;
+    format?: string;
+    unit?: string;
+    currency?: string;
+    decimals?: number;
+    min?: number;
+    max?: number;
+}
+export declare function encodingProp(node: IrNode, key: string): EncodingProp | undefined;
+/** The series field when `series` is the `{ field }` form. */
+export declare function seriesField(node: IrNode): string | undefined;
+/** The encoding that carries the plotted magnitude, with its prop key. */
+export declare function magnitudeEncoding(node: IrNode): {
+    key: string;
+    prop?: EncodingProp;
+};
+export declare function formatSpec(prop: EncodingProp | undefined): FormatSpec;
+export declare function axisSpec(prop: EncodingProp | undefined, fallbackLabel?: string): AxisSpec;
+//# sourceMappingURL=chart-encodings.d.ts.map

package/dist/blocks/chart/chart-encodings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-encodings.d.ts","sourceRoot":"","sources":["../../../src/blocks/chart/chart-encodings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAGhF;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5D;AAKD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,YAAY,CAAA;CAAE,CAepF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,UAAU,CAQrE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,CAQzF"}

package/dist/blocks/chart/chart-encodings.js

@@ -0,0 +1,59 @@
+/**
+ * Reading a chart's encoding props: the authored `x`/`y`/`value` objects, the
+ * `{ field }` series form, and which encoding carries the plotted magnitude.
+ */
+import { isPlainObject } from '../../json.js';
+import { stringProp } from '../../render/block-helpers.js';
+export function encodingProp(node, key) {
+    const value = node.props[key];
+    return isPlainObject(value) ? value : undefined;
+}
+/** The series field when `series` is the `{ field }` form. */
+export function seriesField(node) {
+    const value = node.props.series;
+    return isPlainObject(value) && typeof value.field === 'string' ? value.field : undefined;
+}
+/** Kinds whose magnitude comes from `value` (falling back to `y`) rather than the y axis. */
+const VALUE_KINDS = ['pie', 'donut', 'progress', 'funnel', 'gauge', 'treemap'];
+/** The encoding that carries the plotted magnitude, with its prop key. */
+export function magnitudeEncoding(node) {
+    const kind = stringProp(node, 'kind');
+    const y = encodingProp(node, 'y');
+    const value = encodingProp(node, 'value');
+    if (kind === 'heatmap')
+        return { key: 'value', ...(value === undefined ? {} : { prop: value }) };
+    if (VALUE_KINDS.includes(kind)) {
+        if (value !== undefined || y === undefined) {
+            return { key: 'value', ...(value === undefined ? {} : { prop: value }) };
+        }
+        return { key: 'y', prop: y };
+    }
+    if (y === undefined && value !== undefined && kind === 'waterfall') {
+        return { key: 'value', prop: value };
+    }
+    return { key: 'y', ...(y === undefined ? {} : { prop: y }) };
+}
+export function formatSpec(prop) {
+    const spec = {};
+    if (prop === undefined)
+        return spec;
+    if (prop.format !== undefined)
+        spec.format = prop.format;
+    if (prop.unit !== undefined)
+        spec.unit = prop.unit;
+    if (prop.currency !== undefined)
+        spec.currency = prop.currency;
+    if (prop.decimals !== undefined)
+        spec.decimals = prop.decimals;
+    return spec;
+}
+export function axisSpec(prop, fallbackLabel) {
+    const label = prop?.label ?? fallbackLabel;
+    return {
+        format: formatSpec(prop),
+        ...(label === undefined ? {} : { label }),
+        ...(prop?.min === undefined ? {} : { min: prop.min }),
+        ...(prop?.max === undefined ? {} : { max: prop.max }),
+    };
+}
+//# sourceMappingURL=chart-encodings.js.map

package/dist/blocks/chart/chart-encodings.js.map

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

package/dist/blocks/chart/chart-kinds.d.ts

@@ -0,0 +1,18 @@
+/** Chart kinds, SVG-first and deterministic. */
+export declare const CHART_KINDS: readonly ["bar", "line", "area", "pie", "donut", "sparkline", "progress", "scatter", "histogram", "stacked-bar", "stacked-bar-100", "heatmap", "waterfall", "funnel", "gauge", "treemap"];
+export type ChartKind = (typeof CHART_KINDS)[number];
+/** The kinds that shipped first. Without encodings or extras they keep their original markup. */
+export declare const V1_CHART_KINDS: readonly string[];
+/** Kinds drawn on x/y axes: they take markers, annotations and `y.min`/`y.max`. */
+export declare const CARTESIAN_KINDS: readonly string[];
+/** Kinds whose x axis is numeric rather than categorical. */
+export declare const NUMERIC_X_KINDS: readonly string[];
+/** Kinds that draw one series of magnitudes per category. */
+export declare const SINGLE_SERIES_KINDS: readonly string[];
+/** Kinds whose category order `sort` may change. */
+export declare const SORTABLE_KINDS: readonly string[];
+/** Kinds that cannot be written with inline labels/series. */
+export declare const DATA_ONLY_KINDS: readonly string[];
+/** Treemap cell limit: beyond it the cells stop being legible. */
+export declare const MAX_TREEMAP_CELLS = 40;
+//# sourceMappingURL=chart-kinds.d.ts.map

package/dist/blocks/chart/chart-kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-kinds.d.ts","sourceRoot":"","sources":["../../../src/blocks/chart/chart-kinds.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,eAAO,MAAM,WAAW,2LAiBd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,iGAAiG;AACjG,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAQ3C,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAS5C,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAA6B,CAAC;AAE3E,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAShD,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAAgD,CAAC;AAE7F,8DAA8D;AAC9D,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAA2B,CAAC;AAEzE,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,KAAK,CAAC"}

package/dist/blocks/chart/chart-kinds.js

@@ -0,0 +1,60 @@
+/** Chart kinds, SVG-first and deterministic. */
+export const CHART_KINDS = [
+    'bar',
+    'line',
+    'area',
+    'pie',
+    'donut',
+    'sparkline',
+    'progress',
+    'scatter',
+    'histogram',
+    'stacked-bar',
+    'stacked-bar-100',
+    'heatmap',
+    'waterfall',
+    'funnel',
+    'gauge',
+    'treemap',
+];
+/** The kinds that shipped first. Without encodings or extras they keep their original markup. */
+export const V1_CHART_KINDS = [
+    'bar',
+    'line',
+    'area',
+    'pie',
+    'donut',
+    'sparkline',
+    'progress',
+];
+/** Kinds drawn on x/y axes: they take markers, annotations and `y.min`/`y.max`. */
+export const CARTESIAN_KINDS = [
+    'bar',
+    'line',
+    'area',
+    'scatter',
+    'histogram',
+    'stacked-bar',
+    'stacked-bar-100',
+    'waterfall',
+];
+/** Kinds whose x axis is numeric rather than categorical. */
+export const NUMERIC_X_KINDS = ['scatter', 'histogram'];
+/** Kinds that draw one series of magnitudes per category. */
+export const SINGLE_SERIES_KINDS = [
+    'pie',
+    'donut',
+    'progress',
+    'waterfall',
+    'funnel',
+    'gauge',
+    'treemap',
+    'histogram',
+];
+/** Kinds whose category order `sort` may change. */
+export const SORTABLE_KINDS = ['bar', 'stacked-bar', 'funnel', 'treemap'];
+/** Kinds that cannot be written with inline labels/series. */
+export const DATA_ONLY_KINDS = ['scatter', 'heatmap'];
+/** Treemap cell limit: beyond it the cells stop being legible. */
+export const MAX_TREEMAP_CELLS = 40;
+//# sourceMappingURL=chart-kinds.js.map

package/dist/blocks/chart/chart-kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-kinds.js","sourceRoot":"","sources":["../../../src/blocks/chart/chart-kinds.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,OAAO;IACP,WAAW;IACX,UAAU;IACV,SAAS;IACT,WAAW;IACX,aAAa;IACb,iBAAiB;IACjB,SAAS;IACT,WAAW;IACX,QAAQ;IACR,OAAO;IACP,SAAS;CACD,CAAC;AAIX,iGAAiG;AACjG,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,OAAO;IACP,WAAW;IACX,UAAU;CACX,CAAC;AAEF,mFAAmF;AACnF,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,KAAK;IACL,MAAM;IACN,MAAM;IACN,SAAS;IACT,WAAW;IACX,aAAa;IACb,iBAAiB;IACjB,WAAW;CACZ,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAsB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAE3E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IACpD,KAAK;IACL,OAAO;IACP,UAAU;IACV,WAAW;IACX,QAAQ;IACR,OAAO;IACP,SAAS;IACT,WAAW;CACZ,CAAC;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,cAAc,GAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAE7F,8DAA8D;AAC9D,MAAM,CAAC,MAAM,eAAe,GAAsB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAEzE,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC"}

package/dist/blocks/chart/chart-model-rows.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Bound rows to chart data: x values in first-seen order, one series per
+ * distinct `series.field` value (or one named after the magnitude), and the
+ * fallback table of the rows themselves, formatted like the axes.
+ */
+import type { IrNode } from '../../ir.js';
+import type { ChartPoint, ChartSeries, ChartTable, HeatCell } from '../../render/chart-types.js';
+/** The fallback table: the bound rows, one column per encoded field. */
+export declare function rowsTable(node: IrNode, magnitudeKey: string): ChartTable | undefined;
+/** Labels, series and kind-specific marks derived from rows or inline props. */
+export interface Derived {
+    labels: string[];
+    series: ChartSeries[];
+    points: ChartPoint[];
+    cells: HeatCell[];
+    rowLabels: string[];
+    samples: number[];
+    /** Raw x value (as text) to its display label, for overlay matching. */
+    rawToLabel: Map<string, string>;
+}
+/** Derive a bound chart's labels and series (or points, cells, samples) from its rows. */
+export declare function deriveFromRows(node: IrNode, magnitudeKey: string): Derived;
+//# sourceMappingURL=chart-model-rows.d.ts.map

package/dist/blocks/chart/chart-model-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-model-rows.d.ts","sourceRoot":"","sources":["../../../src/blocks/chart/chart-model-rows.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AA4BjG,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAyBpF;AAED,gFAAgF;AAChF,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wEAAwE;IACxE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAwF1E"}

package/dist/blocks/chart/chart-model-rows.js

@@ -0,0 +1,153 @@
+/**
+ * Bound rows to chart data: x values in first-seen order, one series per
+ * distinct `series.field` value (or one named after the magnitude), and the
+ * fallback table of the rows themselves, formatted like the axes.
+ */
+import { fieldValue } from '../../data/dataset-types.js';
+import { formatValue } from '../../data/format-value.js';
+import { stringProp } from '../../render/block-helpers.js';
+import { encodingProp, formatSpec, seriesField } from './chart-encodings.js';
+import { NUMERIC_X_KINDS, SINGLE_SERIES_KINDS } from './chart-kinds.js';
+/** First-seen distinct values of a field, keyed by their JSON form, with display labels. */
+class Categories {
+    spec;
+    labels = [];
+    raw = [];
+    index = new Map();
+    constructor(spec) {
+        this.spec = spec;
+    }
+    add(value) {
+        const key = JSON.stringify(value);
+        const known = this.index.get(key);
+        if (known !== undefined)
+            return known;
+        const position = this.labels.length;
+        this.index.set(key, position);
+        this.labels.push(value === null ? '—' : formatValue(value, this.spec));
+        this.raw.push(value === null ? '' : String(value));
+        return position;
+    }
+}
+function numeric(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+/** The fallback table: the bound rows, one column per encoded field. */
+export function rowsTable(node, magnitudeKey) {
+    const data = node.data;
+    if (data === undefined)
+        return undefined;
+    const columns = [];
+    const add = (prop, field, isNumber) => {
+        if (field === undefined || columns.some((column) => column.field === field))
+            return;
+        columns.push({ field, label: prop?.label ?? field, spec: formatSpec(prop), numeric: isNumber });
+    };
+    const kind = stringProp(node, 'kind');
+    const x = encodingProp(node, 'x');
+    add(x, x?.field, NUMERIC_X_KINDS.includes(kind));
+    add(undefined, seriesField(node), false);
+    if (kind === 'heatmap' || kind === 'scatter') {
+        const y = encodingProp(node, 'y');
+        add(y, y?.field, kind === 'scatter');
+    }
+    const magnitude = encodingProp(node, magnitudeKey);
+    add(magnitude, magnitude?.field, true);
+    if (columns.length === 0)
+        return undefined;
+    return {
+        columns: columns.map((column) => ({ label: column.label, numeric: column.numeric })),
+        rows: data.rows.map((row) => columns.map((column) => formatValue(fieldValue(row, column.field), column.spec))),
+    };
+}
+/** Derive a bound chart's labels and series (or points, cells, samples) from its rows. */
+export function deriveFromRows(node, magnitudeKey) {
+    const kind = stringProp(node, 'kind');
+    const rows = node.data?.rows ?? [];
+    const x = encodingProp(node, 'x');
+    const y = encodingProp(node, 'y');
+    const magnitude = encodingProp(node, magnitudeKey);
+    const groupField = SINGLE_SERIES_KINDS.includes(kind) ? undefined : seriesField(node);
+    const columns = new Categories(formatSpec(x));
+    const groups = new Categories({});
+    const derived = {
+        labels: columns.labels,
+        series: [],
+        points: [],
+        cells: [],
+        rowLabels: [],
+        samples: [],
+        rawToLabel: new Map(),
+    };
+    const read = (row, field) => field === undefined ? null : fieldValue(row, field);
+    const fallbackName = magnitude?.label ?? magnitude?.field ?? y?.label ?? 'Value';
+    if (kind === 'histogram') {
+        for (const row of rows) {
+            const value = numeric(read(row, x?.field));
+            if (value !== undefined)
+                derived.samples.push(value);
+        }
+        derived.series = [{ label: x?.label ?? x?.field ?? 'Values', values: [] }];
+        return derived;
+    }
+    if (kind === 'scatter') {
+        for (const row of rows) {
+            const px = numeric(read(row, x?.field));
+            const py = numeric(read(row, y?.field));
+            if (px === undefined || py === undefined)
+                continue;
+            const series = groupField === undefined ? 0 : groups.add(read(row, groupField));
+            derived.points.push({ x: px, y: py, series });
+        }
+        derived.series = (groupField === undefined ? [y?.label ?? 'Points'] : groups.labels).map((label) => ({ label, values: [] }));
+        return derived;
+    }
+    if (kind === 'heatmap') {
+        const rowCategories = new Categories(formatSpec(y));
+        const sums = new Map();
+        for (const row of rows) {
+            const value = numeric(read(row, magnitude?.field));
+            const column = columns.add(read(row, x?.field));
+            const line = rowCategories.add(read(row, y?.field));
+            if (value === undefined)
+                continue;
+            const key = `${line}:${column}`;
+            const cell = sums.get(key);
+            if (cell === undefined)
+                sums.set(key, { column, row: line, value });
+            else
+                cell.value += value;
+        }
+        derived.cells = [...sums.values()];
+        derived.rowLabels = rowCategories.labels;
+        derived.series = [{ label: fallbackName, values: [] }];
+        return derived;
+    }
+    if (kind === 'gauge') {
+        const first = rows[0];
+        const value = first === undefined ? undefined : numeric(read(first, magnitude?.field));
+        const name = magnitude?.label ?? magnitude?.field ?? 'Value';
+        derived.labels.push(name);
+        derived.series = [{ label: name, values: value === undefined ? [] : [value] }];
+        return derived;
+    }
+    const matrix = [];
+    for (const row of rows) {
+        const column = columns.add(read(row, x?.field));
+        const series = groupField === undefined ? 0 : groups.add(read(row, groupField));
+        const value = numeric(read(row, magnitude?.field)) ?? 0;
+        const line = matrix[series] ?? [];
+        matrix[series] = line;
+        line[column] = (line[column] ?? 0) + value;
+    }
+    const names = groupField === undefined ? [fallbackName] : groups.labels;
+    derived.series = names.map((label, index) => ({
+        label,
+        values: columns.labels.map((_, column) => matrix[index]?.[column] ?? 0),
+    }));
+    columns.raw.forEach((raw, index) => {
+        derived.rawToLabel.set(raw, columns.labels[index] ?? raw);
+    });
+    return derived;
+}
+//# sourceMappingURL=chart-model-rows.js.map