@objectstack/cli 9.0.0 → 9.0.1

package/dist/utils/validate-widget-bindings.js

@@ -0,0 +1,304 @@
+// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.
+/**
+ * Build-time dashboard widget binding diagnostics (issues #1719, #1721).
+ *
+ * Runs at `objectstack validate`/`compile`/`build` AFTER the stack has been
+ * schema-parsed, so every widget's `dataset` reference can be linked to its
+ * `defineDataset` and each entry in `dimensions`/`values` resolved to a
+ * declared dimension/measure. This is the semantic/cross-reference phase —
+ * the rules here cannot run during plain Zod parsing of the raw widget
+ * literal (the dataset may even live in another package of the stack).
+ *
+ * Reference-integrity rules (#1721) — severity `error`, the page is broken:
+ *
+ * - `widget-dataset-unknown` — `dataset` does not resolve to a declared
+ *   `Dataset`.
+ * - `widget-dimension-unknown` — a `dimensions[]` entry is not a dimension
+ *   name on the bound dataset.
+ * - `widget-measure-unknown` — a `values[]` entry is not a measure name on
+ *   the bound dataset.
+ * - `chart-field-unknown` — a `chartConfig` binding names a field the query
+ *   result will not contain: `xAxis.field` must be one of the widget's
+ *   dimensions (or a dataset dimension), and each `yAxis[].field` /
+ *   `series[].name` must be one of the widget's selected measures
+ *   (`values`). Post-cutover (ADR-0021) the result rows are keyed by
+ *   measure NAME (e.g. `sum_amount`), not the base column (`amount`) — a
+ *   stale base-column reference renders the axis but an empty series.
+ *
+ * Advisory rules — severity `warning`, build stays green:
+ *
+ * - `chart-config-missing` — a chart-type widget (bar/line/pie/…) has no
+ *   `chartConfig`, so the renderer cannot tell which measure to plot.
+ * - `table-count-only` (#1719) — a `table`/`pivot` widget whose selected
+ *   measures are ALL `aggregate: 'count'` and which declares no
+ *   `dimensions` asks the analytics service for a single summary row. That
+ *   is the shape a `metric` widget wants — for a table it almost always
+ *   means the author wanted a per-record listing, which is not an
+ *   analytics dataset at all (model it as an object-bound ListView,
+ *   ADR-0017). Evaluated on the WIDGET's binding, not the dataset.
+ *
+ * Warnings can be deliberately suppressed per widget via
+ * `suppressWarnings: ['<rule-id>']`; errors cannot — they describe a
+ * binding the analytics service cannot satisfy.
+ */
+export const WIDGET_DATASET_UNKNOWN = 'widget-dataset-unknown';
+export const WIDGET_DIMENSION_UNKNOWN = 'widget-dimension-unknown';
+export const WIDGET_MEASURE_UNKNOWN = 'widget-measure-unknown';
+export const CHART_FIELD_UNKNOWN = 'chart-field-unknown';
+export const CHART_CONFIG_MISSING = 'chart-config-missing';
+export const TABLE_COUNT_ONLY = 'table-count-only';
+/** Coerce a collection (array or name-keyed map) to an array. */
+function asArray(v) {
+    if (Array.isArray(v))
+        return v;
+    if (v && typeof v === 'object') {
+        return Object.entries(v).map(([name, def]) => ({ name, ...def }));
+    }
+    return [];
+}
+function asStrings(v) {
+    return Array.isArray(v) ? v.filter((s) => typeof s === 'string') : [];
+}
+/**
+ * Chart families whose renderer needs a `chartConfig` measure mapping.
+ * Single-value types (metric/kpi/gauge/…) plot their lone value and tabular
+ * types (table/pivot) render every column, so they are exempt.
+ */
+const CHART_TYPES = new Set([
+    'bar', 'horizontal-bar', 'column',
+    'line', 'area',
+    'pie', 'donut', 'funnel',
+    'scatter', 'treemap', 'sankey', 'radar',
+]);
+function levenshtein(a, b) {
+    const m = a.length, n = b.length;
+    let prev = Array.from({ length: n + 1 }, (_, j) => j);
+    for (let i = 1; i <= m; i++) {
+        const cur = [i];
+        for (let j = 1; j <= n; j++) {
+            cur[j] = Math.min(prev[j] + 1, cur[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+        }
+        prev = cur;
+    }
+    return prev[n];
+}
+/**
+ * Nearest declared name for a typo'd/stale reference, or undefined when
+ * nothing is close. Containment is checked first because the cutover's
+ * canonical drift is base column → prefixed measure name (`amount` →
+ * `sum_amount`), which is far in edit distance but obvious to a human.
+ */
+function didYouMean(input, candidates) {
+    let best;
+    let bestScore = Infinity;
+    for (const c of candidates) {
+        let score;
+        if (input.length >= 3 && (c.includes(input) || input.includes(c))) {
+            score = Math.abs(c.length - input.length);
+        }
+        else {
+            const d = levenshtein(input, c);
+            if (d > Math.max(2, Math.floor(input.length / 3)))
+                continue;
+            score = 100 + d;
+        }
+        if (score < bestScore) {
+            bestScore = score;
+            best = c;
+        }
+    }
+    return best;
+}
+function suggest(input, candidates) {
+    const s = didYouMean(input, candidates);
+    return s ? ` Did you mean "${s}"?` : '';
+}
+function list(names) {
+    const arr = [...names];
+    return arr.length > 0 ? arr.join(', ') : '(none)';
+}
+/**
+ * Validate every dashboard widget's dataset binding. Returns the list of
+ * findings (empty = clean). Caller decides how to surface them: `error`
+ * findings describe bindings the analytics service cannot satisfy and
+ * should fail validate/build; `warning` findings are advisory and must
+ * never fail the build on their own.
+ */
+export function validateWidgetBindings(stack) {
+    const findings = [];
+    const datasets = new Map();
+    for (const ds of asArray(stack.datasets)) {
+        if (typeof ds.name === 'string')
+            datasets.set(ds.name, ds);
+    }
+    const dashboards = asArray(stack.dashboards);
+    for (let i = 0; i < dashboards.length; i++) {
+        const dash = dashboards[i];
+        const dashName = typeof dash.name === 'string' ? dash.name : `(dashboard ${i})`;
+        const widgets = Array.isArray(dash.widgets) ? dash.widgets : [];
+        for (let j = 0; j < widgets.length; j++) {
+            const w = widgets[j];
+            const widgetId = typeof w.id === 'string' ? w.id : `(widget ${j})`;
+            const where = `dashboard "${dashName}" › widget "${widgetId}"`;
+            const path = `dashboards[${i}].widgets[${j}]`;
+            const suppressed = (rule) => Array.isArray(w.suppressWarnings) && w.suppressWarnings.includes(rule);
+            const push = (f) => {
+                if (f.severity === 'warning' && suppressed(f.rule))
+                    return;
+                findings.push({ ...f, where, path });
+            };
+            // ── (a) dataset reference resolves ──
+            const dsName = typeof w.dataset === 'string' ? w.dataset : undefined;
+            const dataset = dsName ? datasets.get(dsName) : undefined;
+            if (dsName && !dataset) {
+                push({
+                    severity: 'error',
+                    rule: WIDGET_DATASET_UNKNOWN,
+                    message: `dataset "${dsName}" does not resolve to a declared dataset.`,
+                    hint: `Declared datasets: ${list(datasets.keys())}.${suggest(dsName, datasets.keys())} ` +
+                        `Define the dataset with defineDataset() or fix the reference (ADR-0021).`,
+                });
+            }
+            // Without a resolved dataset there is nothing to check names against.
+            if (!dataset)
+                continue;
+            const dimensionNames = new Set();
+            for (const d of asArray(dataset.dimensions)) {
+                if (typeof d.name === 'string')
+                    dimensionNames.add(d.name);
+            }
+            const measures = new Map();
+            for (const m of asArray(dataset.measures)) {
+                if (typeof m.name === 'string')
+                    measures.set(m.name, m);
+            }
+            // ── (b) every dimensions[] entry is a dataset dimension ──
+            const dims = asStrings(w.dimensions);
+            for (let k = 0; k < dims.length; k++) {
+                if (dimensionNames.has(dims[k]))
+                    continue;
+                push({
+                    severity: 'error',
+                    rule: WIDGET_DIMENSION_UNKNOWN,
+                    message: `dimensions[${k}] "${dims[k]}" is not a dimension of dataset ` +
+                        `"${dsName}" (declared dimensions: ${list(dimensionNames)}).`,
+                    hint: `Widgets select dataset dimensions BY NAME.${suggest(dims[k], dimensionNames)} ` +
+                        `Add the dimension to the dataset or fix the reference.`,
+                });
+            }
+            // ── (c) every values[] entry is a dataset measure ──
+            const values = asStrings(w.values);
+            for (let k = 0; k < values.length; k++) {
+                if (measures.has(values[k]))
+                    continue;
+                push({
+                    severity: 'error',
+                    rule: WIDGET_MEASURE_UNKNOWN,
+                    message: `values[${k}] "${values[k]}" is not a measure of dataset ` +
+                        `"${dsName}" (declared measures: ${list(measures.keys())}).`,
+                    hint: `Widgets select dataset measures BY NAME, not by base column.` +
+                        `${suggest(values[k], measures.keys())} ` +
+                        `Add the measure to the dataset or fix the reference.`,
+                });
+            }
+            // ── (d) chartConfig bindings resolve against the widget's selection ──
+            const chartConfig = (w.chartConfig && typeof w.chartConfig === 'object')
+                ? w.chartConfig
+                : undefined;
+            const isChartType = typeof w.type === 'string' && CHART_TYPES.has(w.type);
+            if (chartConfig) {
+                // The query result carries the widget's selected dimensions and
+                // measures; resolve every chartConfig field against that shape.
+                const selectedValues = new Set(values.filter((v) => measures.has(v)));
+                const xAxis = (chartConfig.xAxis && typeof chartConfig.xAxis === 'object')
+                    ? chartConfig.xAxis
+                    : undefined;
+                // A field naming an entry of the widget's own (already-validated)
+                // selection is not re-reported here — rules (b)/(c) own that error.
+                if (xAxis && typeof xAxis.field === 'string'
+                    && !dimensionNames.has(xAxis.field) && !dims.includes(xAxis.field)) {
+                    push({
+                        severity: 'error',
+                        rule: CHART_FIELD_UNKNOWN,
+                        message: `chartConfig.xAxis.field "${xAxis.field}" does not resolve to a ` +
+                            `dimension of dataset "${dsName}" (declared dimensions: ${list(dimensionNames)}).`,
+                        hint: `Point xAxis.field at a dataset dimension name.${suggest(xAxis.field, dimensionNames)}`,
+                    });
+                }
+                const measureField = (label, field) => {
+                    if (values.includes(field))
+                        return; // resolvable, or already errored via rule (c)
+                    const declaredButUnselected = measures.has(field);
+                    push({
+                        severity: 'error',
+                        rule: CHART_FIELD_UNKNOWN,
+                        message: declaredButUnselected
+                            ? `chartConfig.${label} "${field}" is a measure of dataset "${dsName}" ` +
+                                `but is not selected in the widget's values (${list(values)}), so the ` +
+                                `query result will not contain it.`
+                            : `chartConfig.${label} "${field}" does not resolve to a measure of ` +
+                                `dataset "${dsName}" (declared measures: ${list(measures.keys())}).`,
+                        hint: declaredButUnselected
+                            ? `Add "${field}" to the widget's values, or bind the chart to a selected measure.`
+                            : `Post-cutover data is keyed by the dataset's measure NAME, not the ` +
+                                `base column.${suggest(field, selectedValues.size > 0 ? selectedValues : measures.keys())}`,
+                    });
+                };
+                const yAxes = Array.isArray(chartConfig.yAxis) ? chartConfig.yAxis : [];
+                for (let k = 0; k < yAxes.length; k++) {
+                    const field = yAxes[k]?.field;
+                    if (typeof field === 'string')
+                        measureField(`yAxis[${k}].field`, field);
+                }
+                const series = Array.isArray(chartConfig.series) ? chartConfig.series : [];
+                for (let k = 0; k < series.length; k++) {
+                    const name = series[k]?.name;
+                    if (typeof name === 'string')
+                        measureField(`series[${k}].name`, name);
+                }
+            }
+            else if (isChartType) {
+                push({
+                    severity: 'warning',
+                    rule: CHART_CONFIG_MISSING,
+                    message: `chart-type widget ('${w.type}') has no chartConfig — the renderer ` +
+                        `cannot determine which measure to plot, so the series renders empty.`,
+                    hint: `Add chartConfig with xAxis.field set to a dimension (${list(dims)}) and ` +
+                        `yAxis[].field set to a measure name (${list(values)}). If the default ` +
+                        `rendering is intentional, suppress with: suppressWarnings: ['${CHART_CONFIG_MISSING}']`,
+                });
+            }
+            // ── (e) table/pivot bound to a count-only, dimensionless selection ──
+            if (w.type !== 'table' && w.type !== 'pivot')
+                continue;
+            // Grouped by at least one dimension → genuinely aggregated rows.
+            if (dims.length > 0)
+                continue;
+            if (values.length === 0)
+                continue;
+            const resolved = values.map((v) => measures.get(v));
+            // An unresolvable measure name already errored above — don't guess here.
+            if (resolved.some((m) => !m))
+                continue;
+            // Derived measures combine other measures; treat them as non-count even
+            // when their (ignored) `aggregate` says otherwise.
+            const countOnly = resolved.every((m) => m.aggregate === 'count' && !m.derived);
+            if (!countOnly)
+                continue;
+            push({
+                severity: 'warning',
+                rule: TABLE_COUNT_ONLY,
+                message: `a '${w.type}' widget bound to dataset "${dsName}" selects only count ` +
+                    `measure(s) (${values.join(', ')}) and no dimensions, so it renders a ` +
+                    `single summary row — not a per-record list.`,
+                hint: `A flat record listing is not an analytics dataset. Model it as an ` +
+                    `object-bound ListView (ADR-0017) surfaced through app navigation, and ` +
+                    `use a 'metric' widget here if you only need the count. If a single-row ` +
+                    `table is intentional, add an explicit dimension or suppress with: ` +
+                    `suppressWarnings: ['${TABLE_COUNT_ONLY}']`,
+            });
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=validate-widget-bindings.js.map

package/dist/utils/validate-widget-bindings.js.map

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

package/dist/utils/validate-widget-bindings.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate-widget-bindings.test.d.ts.map

package/dist/utils/validate-widget-bindings.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-widget-bindings.test.d.ts","sourceRoot":"","sources":["../../src/utils/validate-widget-bindings.test.ts"],"names":[],"mappings":""}

package/dist/utils/validate-widget-bindings.test.js

@@ -0,0 +1,285 @@
+import { describe, it, expect } from 'vitest';
+import { validateWidgetBindings, TABLE_COUNT_ONLY, WIDGET_DATASET_UNKNOWN, WIDGET_DIMENSION_UNKNOWN, WIDGET_MEASURE_UNKNOWN, CHART_FIELD_UNKNOWN, CHART_CONFIG_MISSING, } from './validate-widget-bindings.js';
+/** The downstream repro from issue #1719 — dataset with a count AND a sum
+ *  measure plus a dimension; the widget selects only the count, no dims. */
+function reproStack(widgetOverrides = {}) {
+    return {
+        datasets: [{
+                name: 'expense_report_metrics',
+                label: 'Expense report metrics',
+                object: 'expense_report',
+                measures: [
+                    { name: 'report_count', label: 'report_count', aggregate: 'count' },
+                    { name: 'total_amount', label: 'total_amount', aggregate: 'sum', field: 'total_amount' },
+                ],
+                dimensions: [{ name: 'cost_center', field: 'cost_center' }],
+            }],
+        dashboards: [{
+                name: 'expenses_overview_dashboard',
+                label: 'Expenses Overview',
+                widgets: [{
+                        id: 'pending_reports_table',
+                        type: 'table',
+                        dataset: 'expense_report_metrics',
+                        values: ['report_count'],
+                        filter: { status: 'submitted' },
+                        layout: { x: 0, y: 0, w: 6, h: 4 },
+                        ...widgetOverrides,
+                    }],
+            }],
+    };
+}
+/** The minimal repro from issue #1721 — dataset measure is `sum_amount`, but
+ *  the chart's yAxis still names the old base column `amount`. */
+function chartStack(widgetOverrides = {}) {
+    return {
+        datasets: [{
+                name: 'expense_line_metrics',
+                label: 'Expense line metrics',
+                object: 'expense_line',
+                dimensions: [{ name: 'category', field: 'category' }],
+                measures: [
+                    { name: 'sum_amount', label: 'sum_amount', aggregate: 'sum', field: 'amount', certified: true },
+                    { name: 'ticket_count', label: 'ticket_count', aggregate: 'count' },
+                ],
+            }],
+        dashboards: [{
+                name: 'spend_dashboard',
+                label: 'Spend',
+                widgets: [{
+                        id: 'spend_by_category',
+                        type: 'bar',
+                        dataset: 'expense_line_metrics',
+                        dimensions: ['category'],
+                        values: ['sum_amount'],
+                        chartConfig: {
+                            type: 'bar',
+                            xAxis: { field: 'category' },
+                            yAxis: [{ field: 'sum_amount' }],
+                        },
+                        layout: { x: 0, y: 0, w: 6, h: 4 },
+                        ...widgetOverrides,
+                    }],
+            }],
+    };
+}
+describe('validateWidgetBindings (reference integrity, issue #1721)', () => {
+    it('a fully resolved chart widget is clean', () => {
+        expect(validateWidgetBindings(chartStack())).toHaveLength(0);
+    });
+    it('(a) errors on a dataset reference that does not resolve', () => {
+        const findings = validateWidgetBindings(chartStack({ dataset: 'expense_line_metric' }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].severity).toBe('error');
+        expect(findings[0].rule).toBe(WIDGET_DATASET_UNKNOWN);
+        expect(findings[0].message).toContain('expense_line_metric');
+        expect(findings[0].hint).toContain('Did you mean "expense_line_metrics"?');
+    });
+    it('(b) errors on a dimension name the dataset does not declare', () => {
+        const findings = validateWidgetBindings(chartStack({ dimensions: ['categry'] }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].severity).toBe('error');
+        expect(findings[0].rule).toBe(WIDGET_DIMENSION_UNKNOWN);
+        expect(findings[0].message).toContain('"categry"');
+        expect(findings[0].message).toContain('declared dimensions: category');
+        expect(findings[0].hint).toContain('Did you mean "category"?');
+    });
+    it('(c) errors on a measure name the dataset does not declare', () => {
+        const findings = validateWidgetBindings(chartStack({
+            type: 'metric',
+            values: ['amount'],
+            chartConfig: undefined,
+        }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].severity).toBe('error');
+        expect(findings[0].rule).toBe(WIDGET_MEASURE_UNKNOWN);
+        expect(findings[0].message).toContain('declared measures: sum_amount, ticket_count');
+        expect(findings[0].hint).toContain('Did you mean "sum_amount"?');
+    });
+    it('(d) errors on the issue repro: yAxis.field naming the stale base column', () => {
+        const findings = validateWidgetBindings(chartStack({
+            chartConfig: {
+                type: 'bar',
+                xAxis: { field: 'category' },
+                yAxis: [{ field: 'amount' }],
+            },
+        }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].severity).toBe('error');
+        expect(findings[0].rule).toBe(CHART_FIELD_UNKNOWN);
+        expect(findings[0].where).toContain('spend_by_category');
+        expect(findings[0].message).toContain('chartConfig.yAxis[0].field "amount"');
+        expect(findings[0].message).toContain('declared measures: sum_amount, ticket_count');
+        expect(findings[0].hint).toContain('Did you mean "sum_amount"?');
+    });
+    it('(d) errors on xAxis.field that is not a dataset dimension', () => {
+        const findings = validateWidgetBindings(chartStack({
+            chartConfig: {
+                type: 'bar',
+                xAxis: { field: 'categories' },
+                yAxis: [{ field: 'sum_amount' }],
+            },
+        }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].rule).toBe(CHART_FIELD_UNKNOWN);
+        expect(findings[0].message).toContain('chartConfig.xAxis.field "categories"');
+        expect(findings[0].hint).toContain('Did you mean "category"?');
+    });
+    it('(d) errors on series[].name that resolves to no selected measure', () => {
+        const findings = validateWidgetBindings(chartStack({
+            chartConfig: {
+                type: 'bar',
+                series: [{ name: 'value' }],
+            },
+        }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].rule).toBe(CHART_FIELD_UNKNOWN);
+        expect(findings[0].message).toContain('chartConfig.series[0].name "value"');
+    });
+    it('(d) a declared-but-unselected measure gets the targeted message', () => {
+        const findings = validateWidgetBindings(chartStack({
+            chartConfig: {
+                type: 'bar',
+                xAxis: { field: 'category' },
+                yAxis: [{ field: 'ticket_count' }],
+            },
+        }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].rule).toBe(CHART_FIELD_UNKNOWN);
+        expect(findings[0].message).toContain('not selected in the widget\'s values');
+        expect(findings[0].hint).toContain('Add "ticket_count" to the widget\'s values');
+    });
+    it('(d) warns when a chart-type widget has no chartConfig at all', () => {
+        const findings = validateWidgetBindings(chartStack({ chartConfig: undefined }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].severity).toBe('warning');
+        expect(findings[0].rule).toBe(CHART_CONFIG_MISSING);
+        expect(findings[0].message).toContain("'bar'");
+        expect(findings[0].hint).toContain(`suppressWarnings: ['${CHART_CONFIG_MISSING}']`);
+    });
+    it('(d) missing chartConfig is suppressible per widget', () => {
+        expect(validateWidgetBindings(chartStack({
+            chartConfig: undefined,
+            suppressWarnings: [CHART_CONFIG_MISSING],
+        }))).toHaveLength(0);
+    });
+    it('(d) non-chart types do not warn on missing chartConfig', () => {
+        for (const type of ['metric', 'kpi', 'gauge', 'table']) {
+            expect(validateWidgetBindings(chartStack({ type, chartConfig: undefined }))).toHaveLength(0);
+        }
+    });
+    it('errors are NOT suppressible via suppressWarnings', () => {
+        const findings = validateWidgetBindings(chartStack({
+            dataset: 'no_such_dataset',
+            suppressWarnings: [WIDGET_DATASET_UNKNOWN],
+        }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].severity).toBe('error');
+    });
+    it('does not double-report a chartConfig field that names an already-errored selection entry', () => {
+        const findings = validateWidgetBindings(chartStack({
+            values: ['amount'],
+            chartConfig: {
+                type: 'bar',
+                xAxis: { field: 'category' },
+                yAxis: [{ field: 'amount' }],
+            },
+        }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].rule).toBe(WIDGET_MEASURE_UNKNOWN);
+    });
+    it('a dangling dataset reports once and skips the name checks', () => {
+        const findings = validateWidgetBindings(chartStack({
+            dataset: 'nope',
+            dimensions: ['whatever'],
+            values: ['also_whatever'],
+        }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].rule).toBe(WIDGET_DATASET_UNKNOWN);
+    });
+});
+describe('validateWidgetBindings (table-count-only, issue #1719)', () => {
+    it('warns on the issue repro: count-only table widget without dimensions', () => {
+        const warnings = validateWidgetBindings(reproStack());
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].severity).toBe('warning');
+        expect(warnings[0].rule).toBe(TABLE_COUNT_ONLY);
+        expect(warnings[0].where).toContain('expenses_overview_dashboard');
+        expect(warnings[0].where).toContain('pending_reports_table');
+        expect(warnings[0].path).toBe('dashboards[0].widgets[0]');
+        expect(warnings[0].message).toContain('report_count');
+        expect(warnings[0].message).toContain('single summary row');
+        expect(warnings[0].hint).toContain('ListView (ADR-0017)');
+        expect(warnings[0].hint).toContain(`suppressWarnings: ['${TABLE_COUNT_ONLY}']`);
+    });
+    it('warns for pivot widgets too', () => {
+        const warnings = validateWidgetBindings(reproStack({ type: 'pivot' }));
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].message).toContain("'pivot' widget");
+    });
+    it('is keyed on the WIDGET binding — selecting the sum measure is clean', () => {
+        expect(validateWidgetBindings(reproStack({ values: ['total_amount'] }))).toHaveLength(0);
+    });
+    it('mixed count + non-count selection is clean', () => {
+        expect(validateWidgetBindings(reproStack({ values: ['report_count', 'total_amount'] }))).toHaveLength(0);
+    });
+    it('declaring a dimension on the widget is clean', () => {
+        expect(validateWidgetBindings(reproStack({ dimensions: ['cost_center'] }))).toHaveLength(0);
+    });
+    it('metric widgets are exactly what a count-only binding wants — clean', () => {
+        expect(validateWidgetBindings(reproStack({ type: 'metric' }))).toHaveLength(0);
+    });
+    it('suppressWarnings opts a deliberate single-row table out', () => {
+        expect(validateWidgetBindings(reproStack({ suppressWarnings: [TABLE_COUNT_ONLY] }))).toHaveLength(0);
+    });
+    it('unrelated suppressWarnings entries do not suppress', () => {
+        expect(validateWidgetBindings(reproStack({ suppressWarnings: ['some-other-rule'] }))).toHaveLength(1);
+    });
+    it('a dangling dataset reference is the cross-reference error, not this rule', () => {
+        const findings = validateWidgetBindings(reproStack({ dataset: 'no_such_dataset' }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].severity).toBe('error');
+        expect(findings[0].rule).toBe(WIDGET_DATASET_UNKNOWN);
+    });
+    it('an unresolvable measure name is the cross-reference error, not this rule', () => {
+        const findings = validateWidgetBindings(reproStack({ values: ['no_such_measure'] }));
+        expect(findings).toHaveLength(1);
+        expect(findings[0].severity).toBe('error');
+        expect(findings[0].rule).toBe(WIDGET_MEASURE_UNKNOWN);
+    });
+    it('treats derived measures as non-count even when aggregate says count', () => {
+        const stack = reproStack({ values: ['count_ratio'] });
+        stack.datasets[0].measures.push({
+            name: 'count_ratio',
+            aggregate: 'count',
+            derived: { op: 'ratio', of: ['report_count', 'report_count'] },
+        });
+        expect(validateWidgetBindings(stack)).toHaveLength(0);
+    });
+    it('count_distinct is a deliberate analytic — clean', () => {
+        const stack = reproStack({ values: ['unique_requesters'] });
+        stack.datasets[0].measures.push({
+            name: 'unique_requesters',
+            aggregate: 'count_distinct',
+            field: 'requester',
+        });
+        expect(validateWidgetBindings(stack)).toHaveLength(0);
+    });
+    it('handles map-keyed datasets/dashboards collections', () => {
+        const arrayForm = reproStack();
+        const { name: _dsName, ...dsRest } = arrayForm.datasets[0];
+        const { name: _dashName, ...dashRest } = arrayForm.dashboards[0];
+        const stack = {
+            datasets: { expense_report_metrics: dsRest },
+            dashboards: { expenses_overview_dashboard: dashRest },
+        };
+        const warnings = validateWidgetBindings(stack);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].where).toContain('expenses_overview_dashboard');
+    });
+    it('is silent on stacks without dashboards or datasets', () => {
+        expect(validateWidgetBindings({})).toHaveLength(0);
+        expect(validateWidgetBindings({ dashboards: [], datasets: [] })).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=validate-widget-bindings.test.js.map

package/dist/utils/validate-widget-bindings.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-widget-bindings.test.js","sourceRoot":"","sources":["../../src/utils/validate-widget-bindings.test.ts"],"names":[],"mappings":"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"}