niceeval 0.12.2-canary.31 → 0.13.0

package/dist/report/definition/primitives/chart-map.cjs

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveChartAxes = resolveChartAxes;
+exports.validateSeriesOverrides = validateSeriesOverrides;
+exports.mapChartSeries = mapChartSeries;
+exports.seriesDimensionValues = seriesDimensionValues;
+const metrics_ts_1 = require("../../model/metrics.cjs");
+const dataset_ts_1 = require("../../model/dataset.cjs");
+const shared_ts_1 = require("./shared.cjs");
+function bindingField(binding) {
+    return typeof binding === "string" ? binding : binding.field;
+}
+function categoryValues(dataset, fieldName) {
+    const values = new Set();
+    for (const row of dataset.rows) {
+        const raw = row.values[fieldName];
+        if (typeof raw === "string" || typeof raw === "number" || typeof raw === "boolean") {
+            values.add(String(raw));
+        }
+    }
+    return [...values];
+}
+function numericFromField(field, raw, categories) {
+    if (field.kind === "metric") {
+        if ((0, metrics_ts_1.isMetricValue)(raw)) {
+            return typeof raw.value === "number" ? raw.value : null;
+        }
+        return typeof raw === "number" && Number.isFinite(raw) ? raw : null;
+    }
+    if (field.valueType === "number" && typeof raw === "number")
+        return raw;
+    if (typeof raw === "string" || typeof raw === "number" || typeof raw === "boolean") {
+        const index = categories.indexOf(String(raw));
+        return index === -1 ? null : index;
+    }
+    return null;
+}
+function stringFromValue(raw) {
+    if (typeof raw === "string")
+        return raw;
+    if (typeof raw === "number")
+        return String(raw);
+    return "";
+}
+function resolveChartAxes(dataset, x, y) {
+    const xField = bindingField(x);
+    const yField = bindingField(y);
+    const xMeta = (0, dataset_ts_1.requireField)(dataset, xField);
+    const yMeta = (0, dataset_ts_1.requireField)(dataset, yField);
+    return { xField, yField, xMeta, yMeta };
+}
+function validateSeriesOverrides(overrides, seriesIds) {
+    if (overrides === undefined)
+        return;
+    for (const key of Object.keys(overrides)) {
+        if (!seriesIds.includes(key)) {
+            throw new Error(`Chart.series references unknown series id ${JSON.stringify(key)}: declared <Series> ids are ${seriesIds.map((id) => JSON.stringify(id)).join(", ")}.`);
+        }
+    }
+}
+function mapChartSeries(dataset, axes, specs, overrides) {
+    validateSeriesOverrides(overrides, specs.map((s) => s.id));
+    const out = [];
+    let missing = 0;
+    for (const spec of specs) {
+        const override = overrides?.[spec.id];
+        const xField = spec.x ?? axes.xField;
+        const yField = spec.y ?? axes.yField;
+        const xMeta = (0, dataset_ts_1.requireField)(dataset, xField);
+        const yMeta = (0, dataset_ts_1.requireField)(dataset, yField);
+        const xCategories = xMeta.kind === "dimension" ? categoryValues(dataset, xField) : [];
+        const yCategories = yMeta.kind === "dimension" ? categoryValues(dataset, yField) : [];
+        const byField = spec.by;
+        const pointsField = spec.points;
+        const points = [];
+        for (const row of dataset.rows) {
+            if (spec.value !== undefined && byField !== undefined) {
+                const byVal = stringFromValue(row.values[byField]);
+                if (byVal !== spec.value)
+                    continue;
+            }
+            const xRaw = row.values[xField];
+            const yRaw = row.values[yField];
+            const x = numericFromField(xMeta, xRaw, xCategories);
+            const y = numericFromField(yMeta, yRaw, yCategories);
+            if (x === null || y === null) {
+                missing += 1;
+                continue;
+            }
+            const seriesValue = byField !== undefined ? stringFromValue(row.values[byField]) : undefined;
+            const pointLabel = pointsField !== undefined ? stringFromValue(row.values[pointsField]) : row.key;
+            const refMetric = yMeta.kind === "metric" ? (0, dataset_ts_1.metricValueOf)(row, yField) : (0, dataset_ts_1.metricValueOf)(row, xField);
+            const refs = (refMetric?.refs ?? []).flatMap((ref) => {
+                const locator = (0, shared_ts_1.attemptLocatorOfEvidenceRef)(ref);
+                return locator === undefined ? [] : [locator];
+            });
+            points.push({
+                key: row.key,
+                seriesId: spec.id,
+                ...(seriesValue !== undefined ? { seriesValue } : {}),
+                pointLabel,
+                x,
+                y,
+                ...(xMeta.kind === "dimension" ? { xLabel: stringFromValue(xRaw) } : {}),
+                ...(yMeta.kind === "dimension" ? { yLabel: stringFromValue(yRaw) } : {}),
+                ...(xMeta.kind === "metric" && (0, metrics_ts_1.isMetricValue)(xRaw) ? { xCell: xRaw } : {}),
+                ...(yMeta.kind === "metric" && (0, metrics_ts_1.isMetricValue)(yRaw) ? { yCell: yRaw } : {}),
+                refs,
+            });
+        }
+        out.push({
+            id: spec.id,
+            mark: spec.mark,
+            points,
+            ...(spec.stack !== undefined ? { stack: spec.stack } : {}),
+            connect: spec.connect ?? false,
+            hidden: override?.hidden ?? spec.hidden ?? false,
+            ...(override?.label !== undefined ? { label: override.label } : spec.label !== undefined ? { label: spec.label } : {}),
+            ...(override?.line !== undefined ? { line: override.line } : spec.line !== undefined ? { line: spec.line } : {}),
+            ...(override?.point !== undefined ? { point: override.point } : spec.point !== undefined ? { point: spec.point } : {}),
+            ...(byField !== undefined ? { byField } : {}),
+        });
+    }
+    return { series: out, missing };
+}
+function seriesDimensionValues(mapped, byField) {
+    const values = new Set();
+    for (const series of mapped) {
+        if (series.byField !== byField || series.hidden)
+            continue;
+        for (const point of series.points) {
+            if (point.seriesValue !== undefined)
+                values.add(point.seriesValue);
+        }
+    }
+    return [...values].sort();
+}
+//# sourceMappingURL=chart-map.cjs.map

package/dist/report/definition/primitives/chart-map.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-map.js","sourceRoot":"","sources":["chart-map.ts"],"names":[],"mappings":";;AA6GA,4CAMC;AACD,0DAQC;AACD,wCAmEC;AACD,sDAWC;AAvMD,uDAAuD;AACvD,uDAAqE;AACrE,2CAA0D;AAmE1D,SAAS,YAAY,CAAC,OAAyB;IAC3C,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;AACjE,CAAC;AACD,SAAS,cAAc,CAAC,OAAgB,EAAE,SAAiB;IACvD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,SAAS,EAAE,CAAC;YACjF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AACvB,CAAC;AACD,SAAS,gBAAgB,CAAC,KAAmB,EAAE,GAAY,EAAE,UAA6B;IACtF,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,IAAA,0BAAa,EAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5D,CAAC;QACD,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACxE,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ;QACvD,OAAO,GAAG,CAAC;IACf,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,SAAS,EAAE,CAAC;QACjF,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AACD,SAAS,eAAe,CAAC,GAAY;IACjC,IAAI,OAAO,GAAG,KAAK,QAAQ;QACvB,OAAO,GAAG,CAAC;IACf,IAAI,OAAO,GAAG,KAAK,QAAQ;QACvB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC;AACd,CAAC;AACD,SAAgB,gBAAgB,CAAC,OAAgB,EAAE,CAAmB,EAAE,CAAmB;IACvF,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAA,yBAAY,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAA,yBAAY,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AACD,SAAgB,uBAAuB,CAAC,SAAoE,EAAE,SAA4B;IACtI,IAAI,SAAS,KAAK,SAAS;QACvB,OAAO;IACX,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,6CAA6C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,+BAA+B,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5K,CAAC;IACL,CAAC;AACL,CAAC;AACD,SAAgB,cAAc,CAAC,OAAgB,EAAE,IAAe,EAAE,KAA6B,EAAE,SAAyD;IAItJ,uBAAuB,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC;QACrC,MAAM,KAAK,GAAG,IAAA,yBAAY,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAA,yBAAY,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;QAChC,MAAM,MAAM,GAAkB,EAAE,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACpD,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;gBACnD,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK;oBACpB,SAAS;YACjB,CAAC;YACD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,MAAM,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;YACrD,MAAM,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;YACrD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC3B,OAAO,IAAI,CAAC,CAAC;gBACb,SAAS;YACb,CAAC;YACD,MAAM,WAAW,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7F,MAAM,UAAU,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;YAClG,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,0BAAa,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAA,0BAAa,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACpG,MAAM,IAAI,GAAqB,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACnE,MAAM,OAAO,GAAG,IAAA,uCAA2B,EAAC,GAAG,CAAC,CAAC;gBACjD,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAClD,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,IAAI,CAAC;gBACR,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,QAAQ,EAAE,IAAI,CAAC,EAAE;gBACjB,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,UAAU;gBACV,CAAC;gBACD,CAAC;gBACD,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAA,0BAAa,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1E,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAA,0BAAa,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1E,IAAI;aACP,CAAC,CAAC;QACP,CAAC;QACD,GAAG,CAAC,IAAI,CAAC;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM;YACN,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;YAC9B,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;YAChD,GAAG,CAAC,QAAQ,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtH,GAAG,CAAC,QAAQ,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChH,GAAG,CAAC,QAAQ,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtH,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC;AACD,SAAgB,qBAAqB,CAAC,MAA+B,EAAE,OAAe;IAClF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,IAAI,MAAM,CAAC,MAAM;YAC3C,SAAS;QACb,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;gBAC/B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC","sourcesContent":["// Chart 映射:Dataset + Series 声明 → 可绘制点集(docs/feature/reports/library.md)。\nimport type { LocalizedText } from \"../../model/locale.ts\";\nimport type { AttemptLocator } from \"../../../attempt-locator.ts\";\nimport type { Dataset, DatasetField } from \"../../model/types.ts\";\nimport type { MetricValue } from \"../../../analysis/index.ts\";\nimport { isMetricValue } from \"../../model/metrics.ts\";\nimport { metricValueOf, requireField } from \"../../model/dataset.ts\";\nimport { attemptLocatorOfEvidenceRef } from \"./shared.ts\";\nexport interface SeriesProps {\n    id: string;\n    mark: \"line\" | \"bar\" | \"area\" | \"scatter\";\n    x?: string;\n    y?: string;\n    points?: string;\n    by?: string;\n    value?: string;\n    xAxis?: string;\n    yAxis?: string;\n    stack?: string;\n    connect?: boolean;\n    connectNulls?: boolean;\n    hidden?: boolean;\n    label?: LocalizedText;\n    color?: string;\n    line?: \"solid\" | \"dashed\" | \"dotted\";\n    point?: \"circle\" | \"square\" | \"diamond\";\n}\nexport type ChartMark = SeriesProps[\"mark\"];\nexport interface ChartFieldBinding {\n    id?: string;\n    field: string;\n    sort?: string;\n    limit?: number;\n}\nexport type ChartAxisBinding = string | ChartFieldBinding;\nexport interface ChartSeriesOverride {\n    hidden?: boolean;\n    label?: LocalizedText;\n    line?: \"solid\" | \"dashed\" | \"dotted\";\n    point?: \"circle\" | \"square\" | \"diamond\";\n}\nexport interface MappedPoint {\n    key: string;\n    seriesId: string;\n    seriesValue?: string;\n    pointLabel: string;\n    x: number;\n    y: number;\n    /** 分类轴的原始显示值；数值轴省略。 */\n    xLabel?: string;\n    yLabel?: string;\n    xCell?: MetricValue;\n    yCell?: MetricValue;\n    /** 证据 locator(closed refs 里 kind=attempt 的 identity.locator;其余 ref 不产生假链接)。 */\n    refs: readonly AttemptLocator[];\n}\nexport interface MappedSeries {\n    id: string;\n    mark: ChartMark;\n    points: MappedPoint[];\n    stack?: string;\n    connect: boolean;\n    hidden: boolean;\n    label?: LocalizedText;\n    line?: \"solid\" | \"dashed\" | \"dotted\";\n    point?: \"circle\" | \"square\" | \"diamond\";\n    byField?: string;\n}\nexport interface ChartAxes {\n    xField: string;\n    yField: string;\n    xMeta: DatasetField;\n    yMeta: DatasetField;\n}\nfunction bindingField(binding: ChartAxisBinding): string {\n    return typeof binding === \"string\" ? binding : binding.field;\n}\nfunction categoryValues(dataset: Dataset, fieldName: string): string[] {\n    const values = new Set<string>();\n    for (const row of dataset.rows) {\n        const raw = row.values[fieldName];\n        if (typeof raw === \"string\" || typeof raw === \"number\" || typeof raw === \"boolean\") {\n            values.add(String(raw));\n        }\n    }\n    return [...values];\n}\nfunction numericFromField(field: DatasetField, raw: unknown, categories: readonly string[]): number | null {\n    if (field.kind === \"metric\") {\n        if (isMetricValue(raw)) {\n            return typeof raw.value === \"number\" ? raw.value : null;\n        }\n        return typeof raw === \"number\" && Number.isFinite(raw) ? raw : null;\n    }\n    if (field.valueType === \"number\" && typeof raw === \"number\")\n        return raw;\n    if (typeof raw === \"string\" || typeof raw === \"number\" || typeof raw === \"boolean\") {\n        const index = categories.indexOf(String(raw));\n        return index === -1 ? null : index;\n    }\n    return null;\n}\nfunction stringFromValue(raw: unknown): string {\n    if (typeof raw === \"string\")\n        return raw;\n    if (typeof raw === \"number\")\n        return String(raw);\n    return \"\";\n}\nexport function resolveChartAxes(dataset: Dataset, x: ChartAxisBinding, y: ChartAxisBinding): ChartAxes {\n    const xField = bindingField(x);\n    const yField = bindingField(y);\n    const xMeta = requireField(dataset, xField);\n    const yMeta = requireField(dataset, yField);\n    return { xField, yField, xMeta, yMeta };\n}\nexport function validateSeriesOverrides(overrides: Readonly<Record<string, ChartSeriesOverride>> | undefined, seriesIds: readonly string[]): void {\n    if (overrides === undefined)\n        return;\n    for (const key of Object.keys(overrides)) {\n        if (!seriesIds.includes(key)) {\n            throw new Error(`Chart.series references unknown series id ${JSON.stringify(key)}: declared <Series> ids are ${seriesIds.map((id) => JSON.stringify(id)).join(\", \")}.`);\n        }\n    }\n}\nexport function mapChartSeries(dataset: Dataset, axes: ChartAxes, specs: readonly SeriesProps[], overrides?: Readonly<Record<string, ChartSeriesOverride>>): {\n    series: MappedSeries[];\n    missing: number;\n} {\n    validateSeriesOverrides(overrides, specs.map((s) => s.id));\n    const out: MappedSeries[] = [];\n    let missing = 0;\n    for (const spec of specs) {\n        const override = overrides?.[spec.id];\n        const xField = spec.x ?? axes.xField;\n        const yField = spec.y ?? axes.yField;\n        const xMeta = requireField(dataset, xField);\n        const yMeta = requireField(dataset, yField);\n        const xCategories = xMeta.kind === \"dimension\" ? categoryValues(dataset, xField) : [];\n        const yCategories = yMeta.kind === \"dimension\" ? categoryValues(dataset, yField) : [];\n        const byField = spec.by;\n        const pointsField = spec.points;\n        const points: MappedPoint[] = [];\n        for (const row of dataset.rows) {\n            if (spec.value !== undefined && byField !== undefined) {\n                const byVal = stringFromValue(row.values[byField]);\n                if (byVal !== spec.value)\n                    continue;\n            }\n            const xRaw = row.values[xField];\n            const yRaw = row.values[yField];\n            const x = numericFromField(xMeta, xRaw, xCategories);\n            const y = numericFromField(yMeta, yRaw, yCategories);\n            if (x === null || y === null) {\n                missing += 1;\n                continue;\n            }\n            const seriesValue = byField !== undefined ? stringFromValue(row.values[byField]) : undefined;\n            const pointLabel = pointsField !== undefined ? stringFromValue(row.values[pointsField]) : row.key;\n            const refMetric = yMeta.kind === \"metric\" ? metricValueOf(row, yField) : metricValueOf(row, xField);\n            const refs: AttemptLocator[] = (refMetric?.refs ?? []).flatMap((ref) => {\n                const locator = attemptLocatorOfEvidenceRef(ref);\n                return locator === undefined ? [] : [locator];\n            });\n            points.push({\n                key: row.key,\n                seriesId: spec.id,\n                ...(seriesValue !== undefined ? { seriesValue } : {}),\n                pointLabel,\n                x,\n                y,\n                ...(xMeta.kind === \"dimension\" ? { xLabel: stringFromValue(xRaw) } : {}),\n                ...(yMeta.kind === \"dimension\" ? { yLabel: stringFromValue(yRaw) } : {}),\n                ...(xMeta.kind === \"metric\" && isMetricValue(xRaw) ? { xCell: xRaw } : {}),\n                ...(yMeta.kind === \"metric\" && isMetricValue(yRaw) ? { yCell: yRaw } : {}),\n                refs,\n            });\n        }\n        out.push({\n            id: spec.id,\n            mark: spec.mark,\n            points,\n            ...(spec.stack !== undefined ? { stack: spec.stack } : {}),\n            connect: spec.connect ?? false,\n            hidden: override?.hidden ?? spec.hidden ?? false,\n            ...(override?.label !== undefined ? { label: override.label } : spec.label !== undefined ? { label: spec.label } : {}),\n            ...(override?.line !== undefined ? { line: override.line } : spec.line !== undefined ? { line: spec.line } : {}),\n            ...(override?.point !== undefined ? { point: override.point } : spec.point !== undefined ? { point: spec.point } : {}),\n            ...(byField !== undefined ? { byField } : {}),\n        });\n    }\n    return { series: out, missing };\n}\nexport function seriesDimensionValues(mapped: readonly MappedSeries[], byField: string): string[] {\n    const values = new Set<string>();\n    for (const series of mapped) {\n        if (series.byField !== byField || series.hidden)\n            continue;\n        for (const point of series.points) {\n            if (point.seriesValue !== undefined)\n                values.add(point.seriesValue);\n        }\n    }\n    return [...values].sort();\n}\n"]}

package/dist/report/definition/primitives/chart-map.d.cts

@@ -0,0 +1,77 @@
+import type { LocalizedText } from "../../model/locale.cjs";
+import type { AttemptLocator } from "../../../attempt-locator.cjs";
+import type { Dataset, DatasetField } from "../../model/types.cjs";
+import type { MetricValue } from "../../../analysis/index.cjs";
+export interface SeriesProps {
+    id: string;
+    mark: "line" | "bar" | "area" | "scatter";
+    x?: string;
+    y?: string;
+    points?: string;
+    by?: string;
+    value?: string;
+    xAxis?: string;
+    yAxis?: string;
+    stack?: string;
+    connect?: boolean;
+    connectNulls?: boolean;
+    hidden?: boolean;
+    label?: LocalizedText;
+    color?: string;
+    line?: "solid" | "dashed" | "dotted";
+    point?: "circle" | "square" | "diamond";
+}
+export type ChartMark = SeriesProps["mark"];
+export interface ChartFieldBinding {
+    id?: string;
+    field: string;
+    sort?: string;
+    limit?: number;
+}
+export type ChartAxisBinding = string | ChartFieldBinding;
+export interface ChartSeriesOverride {
+    hidden?: boolean;
+    label?: LocalizedText;
+    line?: "solid" | "dashed" | "dotted";
+    point?: "circle" | "square" | "diamond";
+}
+export interface MappedPoint {
+    key: string;
+    seriesId: string;
+    seriesValue?: string;
+    pointLabel: string;
+    x: number;
+    y: number;
+    /** 分类轴的原始显示值；数值轴省略。 */
+    xLabel?: string;
+    yLabel?: string;
+    xCell?: MetricValue;
+    yCell?: MetricValue;
+    /** 证据 locator(closed refs 里 kind=attempt 的 identity.locator;其余 ref 不产生假链接)。 */
+    refs: readonly AttemptLocator[];
+}
+export interface MappedSeries {
+    id: string;
+    mark: ChartMark;
+    points: MappedPoint[];
+    stack?: string;
+    connect: boolean;
+    hidden: boolean;
+    label?: LocalizedText;
+    line?: "solid" | "dashed" | "dotted";
+    point?: "circle" | "square" | "diamond";
+    byField?: string;
+}
+export interface ChartAxes {
+    xField: string;
+    yField: string;
+    xMeta: DatasetField;
+    yMeta: DatasetField;
+}
+export declare function resolveChartAxes(dataset: Dataset, x: ChartAxisBinding, y: ChartAxisBinding): ChartAxes;
+export declare function validateSeriesOverrides(overrides: Readonly<Record<string, ChartSeriesOverride>> | undefined, seriesIds: readonly string[]): void;
+export declare function mapChartSeries(dataset: Dataset, axes: ChartAxes, specs: readonly SeriesProps[], overrides?: Readonly<Record<string, ChartSeriesOverride>>): {
+    series: MappedSeries[];
+    missing: number;
+};
+export declare function seriesDimensionValues(mapped: readonly MappedSeries[], byField: string): string[];

package/dist/report/definition/primitives/chart-map.d.mts

@@ -0,0 +1,77 @@
+import type { LocalizedText } from "../../model/locale.mjs";
+import type { AttemptLocator } from "../../../attempt-locator.mjs";
+import type { Dataset, DatasetField } from "../../model/types.mjs";
+import type { MetricValue } from "../../../analysis/index.mjs";
+export interface SeriesProps {
+    id: string;
+    mark: "line" | "bar" | "area" | "scatter";
+    x?: string;
+    y?: string;
+    points?: string;
+    by?: string;
+    value?: string;
+    xAxis?: string;
+    yAxis?: string;
+    stack?: string;
+    connect?: boolean;
+    connectNulls?: boolean;
+    hidden?: boolean;
+    label?: LocalizedText;
+    color?: string;
+    line?: "solid" | "dashed" | "dotted";
+    point?: "circle" | "square" | "diamond";
+}
+export type ChartMark = SeriesProps["mark"];
+export interface ChartFieldBinding {
+    id?: string;
+    field: string;
+    sort?: string;
+    limit?: number;
+}
+export type ChartAxisBinding = string | ChartFieldBinding;
+export interface ChartSeriesOverride {
+    hidden?: boolean;
+    label?: LocalizedText;
+    line?: "solid" | "dashed" | "dotted";
+    point?: "circle" | "square" | "diamond";
+}
+export interface MappedPoint {
+    key: string;
+    seriesId: string;
+    seriesValue?: string;
+    pointLabel: string;
+    x: number;
+    y: number;
+    /** 分类轴的原始显示值；数值轴省略。 */
+    xLabel?: string;
+    yLabel?: string;
+    xCell?: MetricValue;
+    yCell?: MetricValue;
+    /** 证据 locator(closed refs 里 kind=attempt 的 identity.locator;其余 ref 不产生假链接)。 */
+    refs: readonly AttemptLocator[];
+}
+export interface MappedSeries {
+    id: string;
+    mark: ChartMark;
+    points: MappedPoint[];
+    stack?: string;
+    connect: boolean;
+    hidden: boolean;
+    label?: LocalizedText;
+    line?: "solid" | "dashed" | "dotted";
+    point?: "circle" | "square" | "diamond";
+    byField?: string;
+}
+export interface ChartAxes {
+    xField: string;
+    yField: string;
+    xMeta: DatasetField;
+    yMeta: DatasetField;
+}
+export declare function resolveChartAxes(dataset: Dataset, x: ChartAxisBinding, y: ChartAxisBinding): ChartAxes;
+export declare function validateSeriesOverrides(overrides: Readonly<Record<string, ChartSeriesOverride>> | undefined, seriesIds: readonly string[]): void;
+export declare function mapChartSeries(dataset: Dataset, axes: ChartAxes, specs: readonly SeriesProps[], overrides?: Readonly<Record<string, ChartSeriesOverride>>): {
+    series: MappedSeries[];
+    missing: number;
+};
+export declare function seriesDimensionValues(mapped: readonly MappedSeries[], byField: string): string[];

package/dist/report/definition/primitives/chart-map.d.ts

@@ -0,0 +1,77 @@
+import type { LocalizedText } from "../../model/locale.js";
+import type { AttemptLocator } from "../../../attempt-locator.js";
+import type { Dataset, DatasetField } from "../../model/types.js";
+import type { MetricValue } from "../../../analysis/index.js";
+export interface SeriesProps {
+    id: string;
+    mark: "line" | "bar" | "area" | "scatter";
+    x?: string;
+    y?: string;
+    points?: string;
+    by?: string;
+    value?: string;
+    xAxis?: string;
+    yAxis?: string;
+    stack?: string;
+    connect?: boolean;
+    connectNulls?: boolean;
+    hidden?: boolean;
+    label?: LocalizedText;
+    color?: string;
+    line?: "solid" | "dashed" | "dotted";
+    point?: "circle" | "square" | "diamond";
+}
+export type ChartMark = SeriesProps["mark"];
+export interface ChartFieldBinding {
+    id?: string;
+    field: string;
+    sort?: string;
+    limit?: number;
+}
+export type ChartAxisBinding = string | ChartFieldBinding;
+export interface ChartSeriesOverride {
+    hidden?: boolean;
+    label?: LocalizedText;
+    line?: "solid" | "dashed" | "dotted";
+    point?: "circle" | "square" | "diamond";
+}
+export interface MappedPoint {
+    key: string;
+    seriesId: string;
+    seriesValue?: string;
+    pointLabel: string;
+    x: number;
+    y: number;
+    /** 分类轴的原始显示值；数值轴省略。 */
+    xLabel?: string;
+    yLabel?: string;
+    xCell?: MetricValue;
+    yCell?: MetricValue;
+    /** 证据 locator(closed refs 里 kind=attempt 的 identity.locator;其余 ref 不产生假链接)。 */
+    refs: readonly AttemptLocator[];
+}
+export interface MappedSeries {
+    id: string;
+    mark: ChartMark;
+    points: MappedPoint[];
+    stack?: string;
+    connect: boolean;
+    hidden: boolean;
+    label?: LocalizedText;
+    line?: "solid" | "dashed" | "dotted";
+    point?: "circle" | "square" | "diamond";
+    byField?: string;
+}
+export interface ChartAxes {
+    xField: string;
+    yField: string;
+    xMeta: DatasetField;
+    yMeta: DatasetField;
+}
+export declare function resolveChartAxes(dataset: Dataset, x: ChartAxisBinding, y: ChartAxisBinding): ChartAxes;
+export declare function validateSeriesOverrides(overrides: Readonly<Record<string, ChartSeriesOverride>> | undefined, seriesIds: readonly string[]): void;
+export declare function mapChartSeries(dataset: Dataset, axes: ChartAxes, specs: readonly SeriesProps[], overrides?: Readonly<Record<string, ChartSeriesOverride>>): {
+    series: MappedSeries[];
+    missing: number;
+};
+export declare function seriesDimensionValues(mapped: readonly MappedSeries[], byField: string): string[];

package/dist/report/definition/primitives/chart-map.js

@@ -0,0 +1,12 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./chart-map.cjs");
+const __niceevalExport0 = __niceevalCanonical["mapChartSeries"];
+export { __niceevalExport0 as mapChartSeries };
+const __niceevalExport1 = __niceevalCanonical["resolveChartAxes"];
+export { __niceevalExport1 as resolveChartAxes };
+const __niceevalExport2 = __niceevalCanonical["seriesDimensionValues"];
+export { __niceevalExport2 as seriesDimensionValues };
+const __niceevalExport3 = __niceevalCanonical["validateSeriesOverrides"];
+export { __niceevalExport3 as validateSeriesOverrides };
+//# sourceMappingURL=chart-map.js.map

package/dist/report/definition/primitives/chart-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-map.js","sources":[],"names":[],"mappings":""}