niceeval 0.12.2-canary.31 → 0.13.0

package/dist/report/model/conversions.d.mts

@@ -0,0 +1,40 @@
+import type { AnalysisIssue, AttemptEvidenceDomainView, AttemptObservabilityDomainView, EvidenceRef, FileChangesDomainView, MetricValue, Sample, SandboxHistoryDomainView, SourceNavigationDomainView, SourcesDomainView } from "../../analysis/index.mjs";
+import type { AttemptLocator } from "../../attempt-locator.mjs";
+import type { ReportLocale } from "./locale.mjs";
+/** A table-safe projection that still contains the original complete metric. */
+export interface MetricDetailRow {
+    readonly metric: MetricValue;
+    readonly value: string;
+    readonly state: MetricValue["state"];
+    readonly samples: number;
+    readonly total: number;
+    readonly basis: MetricValue["basis"];
+    readonly issues: readonly AnalysisIssue[];
+    readonly refs: readonly EvidenceRef[];
+}
+/** Converts a metric for display without splitting it into a new statistical value. */
+export declare function toMetricDetailRow(metric: MetricValue, locale?: ReportLocale): MetricDetailRow;
+/** Closed Analysis issues become plain rows without suppressing linked evidence. */
+export declare function toIssueRows(issues: readonly AnalysisIssue[]): readonly Readonly<{
+    readonly code: string;
+    readonly message: string;
+    readonly evidence: string;
+}>[];
+/** Evidence references become readable rows while keeping their canonical identity text. */
+export declare function toEvidenceRows(refs: readonly EvidenceRef[]): readonly Readonly<{
+    readonly reference: string;
+}>[];
+/** One string for constrained text surfaces; it includes all references. */
+export declare function toIssueText(issue: AnalysisIssue): string;
+/** Closes Assertions / Evidence through the one published Analysis DomainView. */
+export declare function toAttemptEvidence(sample: Sample, locator?: AttemptLocator): Promise<AttemptEvidenceDomainView>;
+/** Closes conversation, commands, usage, timing and diagnostics for selected Attempts. */
+export declare function toAttemptObservability(sample: Sample, locator?: AttemptLocator): Promise<AttemptObservabilityDomainView>;
+/** Closes the fixed Attempt file-change DomainView. */
+export declare function toFileChanges(sample: Sample, locator?: AttemptLocator): Promise<FileChangesDomainView>;
+/** Closes exact physical send-to-source and send-to-timing navigation. */
+export declare function toSourceNavigation(sample: Sample, locator?: AttemptLocator): Promise<SourceNavigationDomainView>;
+/** Closes the origin-Run Sources DomainView for selected Attempts. */
+export declare function toSources(sample: Sample, locator?: AttemptLocator): Promise<SourcesDomainView>;
+/** Closes sandbox-only command, timing and diagnostic history. */
+export declare function toSandboxHistory(sample: Sample, locator?: AttemptLocator): Promise<SandboxHistoryDomainView>;

package/dist/report/model/conversions.d.ts

@@ -0,0 +1,40 @@
+import type { AnalysisIssue, AttemptEvidenceDomainView, AttemptObservabilityDomainView, EvidenceRef, FileChangesDomainView, MetricValue, Sample, SandboxHistoryDomainView, SourceNavigationDomainView, SourcesDomainView } from "../../analysis/index.js";
+import type { AttemptLocator } from "../../attempt-locator.js";
+import type { ReportLocale } from "./locale.js";
+/** A table-safe projection that still contains the original complete metric. */
+export interface MetricDetailRow {
+    readonly metric: MetricValue;
+    readonly value: string;
+    readonly state: MetricValue["state"];
+    readonly samples: number;
+    readonly total: number;
+    readonly basis: MetricValue["basis"];
+    readonly issues: readonly AnalysisIssue[];
+    readonly refs: readonly EvidenceRef[];
+}
+/** Converts a metric for display without splitting it into a new statistical value. */
+export declare function toMetricDetailRow(metric: MetricValue, locale?: ReportLocale): MetricDetailRow;
+/** Closed Analysis issues become plain rows without suppressing linked evidence. */
+export declare function toIssueRows(issues: readonly AnalysisIssue[]): readonly Readonly<{
+    readonly code: string;
+    readonly message: string;
+    readonly evidence: string;
+}>[];
+/** Evidence references become readable rows while keeping their canonical identity text. */
+export declare function toEvidenceRows(refs: readonly EvidenceRef[]): readonly Readonly<{
+    readonly reference: string;
+}>[];
+/** One string for constrained text surfaces; it includes all references. */
+export declare function toIssueText(issue: AnalysisIssue): string;
+/** Closes Assertions / Evidence through the one published Analysis DomainView. */
+export declare function toAttemptEvidence(sample: Sample, locator?: AttemptLocator): Promise<AttemptEvidenceDomainView>;
+/** Closes conversation, commands, usage, timing and diagnostics for selected Attempts. */
+export declare function toAttemptObservability(sample: Sample, locator?: AttemptLocator): Promise<AttemptObservabilityDomainView>;
+/** Closes the fixed Attempt file-change DomainView. */
+export declare function toFileChanges(sample: Sample, locator?: AttemptLocator): Promise<FileChangesDomainView>;
+/** Closes exact physical send-to-source and send-to-timing navigation. */
+export declare function toSourceNavigation(sample: Sample, locator?: AttemptLocator): Promise<SourceNavigationDomainView>;
+/** Closes the origin-Run Sources DomainView for selected Attempts. */
+export declare function toSources(sample: Sample, locator?: AttemptLocator): Promise<SourcesDomainView>;
+/** Closes sandbox-only command, timing and diagnostic history. */
+export declare function toSandboxHistory(sample: Sample, locator?: AttemptLocator): Promise<SandboxHistoryDomainView>;

package/dist/report/model/conversions.js

@@ -0,0 +1,24 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./conversions.cjs");
+const __niceevalExport0 = __niceevalCanonical["toAttemptEvidence"];
+export { __niceevalExport0 as toAttemptEvidence };
+const __niceevalExport1 = __niceevalCanonical["toAttemptObservability"];
+export { __niceevalExport1 as toAttemptObservability };
+const __niceevalExport2 = __niceevalCanonical["toEvidenceRows"];
+export { __niceevalExport2 as toEvidenceRows };
+const __niceevalExport3 = __niceevalCanonical["toFileChanges"];
+export { __niceevalExport3 as toFileChanges };
+const __niceevalExport4 = __niceevalCanonical["toIssueRows"];
+export { __niceevalExport4 as toIssueRows };
+const __niceevalExport5 = __niceevalCanonical["toIssueText"];
+export { __niceevalExport5 as toIssueText };
+const __niceevalExport6 = __niceevalCanonical["toMetricDetailRow"];
+export { __niceevalExport6 as toMetricDetailRow };
+const __niceevalExport7 = __niceevalCanonical["toSandboxHistory"];
+export { __niceevalExport7 as toSandboxHistory };
+const __niceevalExport8 = __niceevalCanonical["toSourceNavigation"];
+export { __niceevalExport8 as toSourceNavigation };
+const __niceevalExport9 = __niceevalCanonical["toSources"];
+export { __niceevalExport9 as toSources };
+//# sourceMappingURL=conversions.js.map

package/dist/report/model/conversions.js.map

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

package/dist/report/model/dataset.cjs

@@ -0,0 +1,255 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportDatasetError = void 0;
+exports.dimensionField = dimensionField;
+exports.metricField = metricField;
+exports.datasetFromClosedRows = datasetFromClosedRows;
+exports.isClosedDataset = isClosedDataset;
+exports.isDataset = isDataset;
+exports.fieldOf = fieldOf;
+exports.requireField = requireField;
+exports.metricValueOf = metricValueOf;
+const contracts_ts_1 = require("../../analysis/contracts.cjs");
+const metrics_ts_1 = require("./metrics.cjs");
+const closedDatasetBrands = new WeakSet();
+/** A bad Dataset request never becomes a fake zero, metric, or Evidence row. */
+class ReportDatasetError extends Error {
+    code = "report-dataset-invalid";
+    constructor(reason) {
+        super(reason);
+        this.name = "ReportDatasetError";
+    }
+}
+exports.ReportDatasetError = ReportDatasetError;
+/** Declares one presentation Dimension field; null coordinates remain valid. */
+function dimensionField(name, valueType = "scalar") {
+    assertFieldName(name);
+    if (!isDimensionValueType(valueType)) {
+        throw new ReportDatasetError("unsupported Dimension field value type " + JSON.stringify(valueType));
+    }
+    return Object.freeze({ name, kind: "dimension", valueType });
+}
+/**
+ * Declares a Metric field by its Report row property name.  Current Analysis
+ * Measures do not carry a display-column name, so accepting one explicitly
+ * avoids guessing from an opaque Measure id.
+ */
+function metricField(name, measure) {
+    assertFieldName(name);
+    return Object.freeze({
+        name,
+        kind: "metric",
+        valueType: "number",
+        ...(measure.unit === undefined ? {} : { unit: measure.unit }),
+        ...(measure.format === undefined ? {} : { format: measure.format }),
+        ...(measure.better === undefined ? {} : { better: measure.better }),
+    });
+}
+/**
+ * Projects Analysis-issued ClosedRows into a neutral Dataset while preserving
+ * row key, collection identity, frame-level issues, Evidence refs, and every
+ * full MetricValue cell.  It does not reduce, filter, or re-close rows.
+ */
+function datasetFromClosedRows(rows, fields) {
+    if (!(0, contracts_ts_1.isClosedRows)(rows)) {
+        throw new ReportDatasetError("datasetFromClosedRows requires Analysis-issued ClosedRows");
+    }
+    const closedFields = closeFields(fields);
+    const datasetRows = rows.map((row, rowIndex) => closeRow(row, rowIndex, closedFields));
+    const dataset = Object.freeze({
+        kind: "closed-dataset",
+        identity: rows.identity,
+        fields: closedFields,
+        rows: Object.freeze(datasetRows),
+        issues: rows.issues,
+        refs: rows.refs,
+    });
+    closedDatasetBrands.add(dataset);
+    return dataset;
+}
+/** True only for a Dataset created from Analysis-issued ClosedRows above. */
+function isClosedDataset(value) {
+    return isDataset(value) && closedDatasetBrands.has(value) &&
+        value.kind === "closed-dataset";
+}
+/** Validates a neutral Dataset shape without claiming that it came from Analysis. */
+function isDataset(value) {
+    if (!isPlainRecord(value) || !Array.isArray(value.fields) || !Array.isArray(value.rows))
+        return false;
+    try {
+        const fields = closeFields(value.fields);
+        for (let index = 0; index < value.rows.length; index += 1) {
+            const row = value.rows[index];
+            if (!isDatasetRow(row))
+                return false;
+            for (const field of fields) {
+                if (!Object.hasOwn(row.values, field.name))
+                    return false;
+                if (!fieldValueMatches(field, row.values[field.name]))
+                    return false;
+            }
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function fieldOf(dataset, name) {
+    return dataset.fields.find((field) => field.name === name);
+}
+function requireField(dataset, name) {
+    const field = fieldOf(dataset, name);
+    if (field !== undefined)
+        return field;
+    throw new ReportDatasetError("Dataset field " + JSON.stringify(name) + " is not declared; fields are " +
+        dataset.fields.map((entry) => JSON.stringify(entry.name)).join(", "));
+}
+/** Reads an existing MetricValue cell without changing any of its semantics. */
+function metricValueOf(row, fieldName) {
+    const value = row.values[fieldName];
+    return (0, metrics_ts_1.isMetricValue)(value) ? value : null;
+}
+function closeFields(fields) {
+    if (!Array.isArray(fields))
+        throw new ReportDatasetError("Dataset fields must be an array");
+    const names = new Set();
+    const closed = fields.map((field) => {
+        if (!isPlainRecord(field))
+            throw new ReportDatasetError("Dataset field must be an object");
+        const name = field.name;
+        if (typeof name !== "string")
+            throw new ReportDatasetError("Dataset field name must be a string");
+        assertFieldName(name);
+        if (names.has(name)) {
+            throw new ReportDatasetError("Dataset field " + JSON.stringify(name) + " is declared more than once");
+        }
+        names.add(name);
+        const kind = field.kind;
+        if (kind !== "dimension" && kind !== "metric") {
+            throw new ReportDatasetError("Dataset field " + JSON.stringify(name) + " has an unknown kind");
+        }
+        const valueType = field.valueType;
+        if (!isDimensionValueType(valueType)) {
+            throw new ReportDatasetError("Dataset field " + JSON.stringify(name) + " has an unknown value type");
+        }
+        if (kind === "metric" && valueType !== "number") {
+            throw new ReportDatasetError("Metric Dataset fields must use valueType \"number\"");
+        }
+        const unit = field.unit;
+        if (unit !== undefined && typeof unit !== "string") {
+            throw new ReportDatasetError("Dataset field unit must be a string");
+        }
+        const format = field.format;
+        if (format !== undefined && !isMeasureFormat(format)) {
+            throw new ReportDatasetError("Dataset field format must be a closed MeasureFormat");
+        }
+        const better = field.better;
+        if (better !== undefined && !isBetter(better)) {
+            throw new ReportDatasetError("Dataset field better must be higher, lower, or neutral");
+        }
+        const bounds = field.bounds;
+        if (bounds !== undefined && !validBounds(bounds)) {
+            throw new ReportDatasetError("Dataset field bounds must be finite and ordered");
+        }
+        return Object.freeze({
+            name,
+            kind,
+            valueType,
+            ...(unit === undefined ? {} : { unit }),
+            ...(format === undefined ? {} : { format }),
+            ...(better === undefined ? {} : { better }),
+            ...(bounds === undefined
+                ? {}
+                : { bounds: Object.freeze({ ...bounds }) }),
+        });
+    });
+    return Object.freeze(closed);
+}
+function closeRow(value, rowIndex, fields) {
+    if (!isPlainRecord(value) || typeof value.key !== "string") {
+        throw new ReportDatasetError("Closed row " + String(rowIndex) + " must have a stable string key");
+    }
+    const values = Object.create(null);
+    for (const field of fields) {
+        if (!Object.hasOwn(value, field.name)) {
+            throw new ReportDatasetError("Closed row " + JSON.stringify(value.key) + " is missing field " + JSON.stringify(field.name));
+        }
+        const fieldValue = value[field.name];
+        if (!fieldValueMatches(field, fieldValue)) {
+            throw new ReportDatasetError("Closed row " + JSON.stringify(value.key) + " has an invalid " + field.kind +
+                " field " + JSON.stringify(field.name));
+        }
+        values[field.name] = fieldValue;
+    }
+    return Object.freeze({ key: value.key, values: Object.freeze(values) });
+}
+function isDatasetRow(value) {
+    return isPlainRecord(value) && typeof value.key === "string" && isPlainRecord(value.values);
+}
+function fieldValueMatches(field, value) {
+    if (field.kind === "metric")
+        return (0, metrics_ts_1.isMetricValue)(value);
+    if (value === null)
+        return true;
+    switch (field.valueType) {
+        case "string":
+            return typeof value === "string";
+        case "number":
+            return typeof value === "number" && Number.isFinite(value);
+        case "boolean":
+            return typeof value === "boolean";
+        case "scalar":
+            return typeof value === "string" || typeof value === "boolean" ||
+                (typeof value === "number" && Number.isFinite(value));
+    }
+}
+function assertFieldName(name) {
+    if (typeof name !== "string" || name.length === 0) {
+        throw new ReportDatasetError("Dataset field names must be non-empty strings");
+    }
+    if (name === "key") {
+        throw new ReportDatasetError('Dataset reserves "key" for stable row identity');
+    }
+}
+function isDimensionValueType(value) {
+    return value === "string" || value === "number" || value === "boolean" || value === "scalar";
+}
+function isBetter(value) {
+    return value === "higher" || value === "lower" || value === "neutral";
+}
+function validBounds(value) {
+    if (!isPlainRecord(value))
+        return false;
+    if ((value.min !== undefined && (typeof value.min !== "number" || !Number.isFinite(value.min))) ||
+        (value.max !== undefined && (typeof value.max !== "number" || !Number.isFinite(value.max)))) {
+        return false;
+    }
+    return value.min === undefined || value.max === undefined || value.min <= value.max;
+}
+function isMeasureFormat(value) {
+    return typeof value === "string" ||
+        (isPlainRecord(value) && typeof value.kind === "string" &&
+            (value.options === undefined || isJsonValue(value.options)));
+}
+function isJsonValue(value, ancestors = new Set()) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (typeof value !== "object" || value === null || ancestors.has(value))
+        return false;
+    ancestors.add(value);
+    const valid = Array.isArray(value)
+        ? value.every((entry) => isJsonValue(entry, ancestors))
+        : isPlainRecord(value) && Object.values(value).every((entry) => isJsonValue(entry, ancestors));
+    ancestors.delete(value);
+    return valid;
+}
+function isPlainRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=dataset.cjs.map

package/dist/report/model/dataset.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset.js","sourceRoot":"","sources":["dataset.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ClosedRows, JsonValue, MeasureFormat, MetricValue, } from \"../../analysis/index.ts\";\nimport { isClosedRows } from \"../../analysis/contracts.ts\";\nimport { isMetricValue } from \"./metrics.ts\";\nimport type { ClosedDataset, Dataset, DatasetDimensionValueType, DatasetField, DatasetRow, DatasetValue, } from \"./types.ts\";\nconst closedDatasetBrands = new WeakSet<object>();\n/** A bad Dataset request never becomes a fake zero, metric, or Evidence row. */\nexport class ReportDatasetError extends Error {\n    readonly code = \"report-dataset-invalid\";\n    constructor(reason: string) {\n        super(reason);\n        this.name = \"ReportDatasetError\";\n    }\n}\n/** Declares one presentation Dimension field; null coordinates remain valid. */\nexport function dimensionField(name: string, valueType: DatasetDimensionValueType = \"scalar\"): DatasetField {\n    assertFieldName(name);\n    if (!isDimensionValueType(valueType)) {\n        throw new ReportDatasetError(\"unsupported Dimension field value type \" + JSON.stringify(valueType));\n    }\n    return Object.freeze({ name, kind: \"dimension\" as const, valueType });\n}\n/**\n * Declares a Metric field by its Report row property name.  Current Analysis\n * Measures do not carry a display-column name, so accepting one explicitly\n * avoids guessing from an opaque Measure id.\n */\nexport function metricField(name: string, measure: Readonly<{\n    readonly unit?: string;\n    readonly format?: MeasureFormat;\n    readonly better?: \"higher\" | \"lower\" | \"neutral\";\n}>): DatasetField {\n    assertFieldName(name);\n    return Object.freeze({\n        name,\n        kind: \"metric\" as const,\n        valueType: \"number\" as const,\n        ...(measure.unit === undefined ? {} : { unit: measure.unit }),\n        ...(measure.format === undefined ? {} : { format: measure.format }),\n        ...(measure.better === undefined ? {} : { better: measure.better }),\n    });\n}\n/**\n * Projects Analysis-issued ClosedRows into a neutral Dataset while preserving\n * row key, collection identity, frame-level issues, Evidence refs, and every\n * full MetricValue cell.  It does not reduce, filter, or re-close rows.\n */\nexport function datasetFromClosedRows<Row extends object>(rows: ClosedRows<Row>, fields: readonly DatasetField[]): ClosedDataset {\n    if (!isClosedRows(rows)) {\n        throw new ReportDatasetError(\"datasetFromClosedRows requires Analysis-issued ClosedRows\");\n    }\n    const closedFields = closeFields(fields);\n    const datasetRows = rows.map((row, rowIndex) => closeRow(row, rowIndex, closedFields));\n    const dataset: ClosedDataset = Object.freeze({\n        kind: \"closed-dataset\" as const,\n        identity: rows.identity,\n        fields: closedFields,\n        rows: Object.freeze(datasetRows),\n        issues: rows.issues,\n        refs: rows.refs,\n    });\n    closedDatasetBrands.add(dataset);\n    return dataset;\n}\n/** True only for a Dataset created from Analysis-issued ClosedRows above. */\nexport function isClosedDataset(value: unknown): value is ClosedDataset {\n    return isDataset(value) && closedDatasetBrands.has(value as object) &&\n        (value as {\n            readonly kind?: unknown;\n        }).kind === \"closed-dataset\";\n}\n/** Validates a neutral Dataset shape without claiming that it came from Analysis. */\nexport function isDataset(value: unknown): value is Dataset {\n    if (!isPlainRecord(value) || !Array.isArray(value.fields) || !Array.isArray(value.rows))\n        return false;\n    try {\n        const fields = closeFields(value.fields);\n        for (let index = 0; index < value.rows.length; index += 1) {\n            const row = value.rows[index];\n            if (!isDatasetRow(row))\n                return false;\n            for (const field of fields) {\n                if (!Object.hasOwn(row.values, field.name))\n                    return false;\n                if (!fieldValueMatches(field, row.values[field.name]))\n                    return false;\n            }\n        }\n        return true;\n    }\n    catch {\n        return false;\n    }\n}\nexport function fieldOf(dataset: Dataset, name: string): DatasetField | undefined {\n    return dataset.fields.find((field) => field.name === name);\n}\nexport function requireField(dataset: Dataset, name: string): DatasetField {\n    const field = fieldOf(dataset, name);\n    if (field !== undefined)\n        return field;\n    throw new ReportDatasetError(\"Dataset field \" + JSON.stringify(name) + \" is not declared; fields are \" +\n        dataset.fields.map((entry) => JSON.stringify(entry.name)).join(\", \"));\n}\n/** Reads an existing MetricValue cell without changing any of its semantics. */\nexport function metricValueOf(row: DatasetRow, fieldName: string): MetricValue | null {\n    const value = row.values[fieldName];\n    return isMetricValue(value) ? value : null;\n}\nfunction closeFields(fields: readonly unknown[]): readonly DatasetField[] {\n    if (!Array.isArray(fields))\n        throw new ReportDatasetError(\"Dataset fields must be an array\");\n    const names = new Set<string>();\n    const closed = fields.map((field) => {\n        if (!isPlainRecord(field))\n            throw new ReportDatasetError(\"Dataset field must be an object\");\n        const name = field.name;\n        if (typeof name !== \"string\")\n            throw new ReportDatasetError(\"Dataset field name must be a string\");\n        assertFieldName(name);\n        if (names.has(name)) {\n            throw new ReportDatasetError(\"Dataset field \" + JSON.stringify(name) + \" is declared more than once\");\n        }\n        names.add(name);\n        const kind = field.kind;\n        if (kind !== \"dimension\" && kind !== \"metric\") {\n            throw new ReportDatasetError(\"Dataset field \" + JSON.stringify(name) + \" has an unknown kind\");\n        }\n        const valueType = field.valueType;\n        if (!isDimensionValueType(valueType)) {\n            throw new ReportDatasetError(\"Dataset field \" + JSON.stringify(name) + \" has an unknown value type\");\n        }\n        if (kind === \"metric\" && valueType !== \"number\") {\n            throw new ReportDatasetError(\"Metric Dataset fields must use valueType \\\"number\\\"\");\n        }\n        const unit = field.unit;\n        if (unit !== undefined && typeof unit !== \"string\") {\n            throw new ReportDatasetError(\"Dataset field unit must be a string\");\n        }\n        const format = field.format;\n        if (format !== undefined && !isMeasureFormat(format)) {\n            throw new ReportDatasetError(\"Dataset field format must be a closed MeasureFormat\");\n        }\n        const better = field.better;\n        if (better !== undefined && !isBetter(better)) {\n            throw new ReportDatasetError(\"Dataset field better must be higher, lower, or neutral\");\n        }\n        const bounds = field.bounds;\n        if (bounds !== undefined && !validBounds(bounds)) {\n            throw new ReportDatasetError(\"Dataset field bounds must be finite and ordered\");\n        }\n        return Object.freeze({\n            name,\n            kind,\n            valueType,\n            ...(unit === undefined ? {} : { unit }),\n            ...(format === undefined ? {} : { format }),\n            ...(better === undefined ? {} : { better }),\n            ...(bounds === undefined\n                ? {}\n                : { bounds: Object.freeze({ ...bounds }) }),\n        }) satisfies DatasetField;\n    });\n    return Object.freeze(closed);\n}\nfunction closeRow(value: object, rowIndex: number, fields: readonly DatasetField[]): DatasetRow {\n    if (!isPlainRecord(value) || typeof value.key !== \"string\") {\n        throw new ReportDatasetError(\"Closed row \" + String(rowIndex) + \" must have a stable string key\");\n    }\n    const values: Record<string, DatasetValue> = Object.create(null);\n    for (const field of fields) {\n        if (!Object.hasOwn(value, field.name)) {\n            throw new ReportDatasetError(\"Closed row \" + JSON.stringify(value.key) + \" is missing field \" + JSON.stringify(field.name));\n        }\n        const fieldValue = value[field.name];\n        if (!fieldValueMatches(field, fieldValue)) {\n            throw new ReportDatasetError(\"Closed row \" + JSON.stringify(value.key) + \" has an invalid \" + field.kind +\n                \" field \" + JSON.stringify(field.name));\n        }\n        values[field.name] = fieldValue;\n    }\n    return Object.freeze({ key: value.key, values: Object.freeze(values) });\n}\nfunction isDatasetRow(value: unknown): value is DatasetRow {\n    return isPlainRecord(value) && typeof value.key === \"string\" && isPlainRecord(value.values);\n}\nfunction fieldValueMatches(field: DatasetField, value: unknown): value is DatasetValue {\n    if (field.kind === \"metric\")\n        return isMetricValue(value);\n    if (value === null)\n        return true;\n    switch (field.valueType) {\n        case \"string\":\n            return typeof value === \"string\";\n        case \"number\":\n            return typeof value === \"number\" && Number.isFinite(value);\n        case \"boolean\":\n            return typeof value === \"boolean\";\n        case \"scalar\":\n            return typeof value === \"string\" || typeof value === \"boolean\" ||\n                (typeof value === \"number\" && Number.isFinite(value));\n    }\n}\nfunction assertFieldName(name: string): void {\n    if (typeof name !== \"string\" || name.length === 0) {\n        throw new ReportDatasetError(\"Dataset field names must be non-empty strings\");\n    }\n    if (name === \"key\") {\n        throw new ReportDatasetError('Dataset reserves \"key\" for stable row identity');\n    }\n}\nfunction isDimensionValueType(value: unknown): value is DatasetDimensionValueType {\n    return value === \"string\" || value === \"number\" || value === \"boolean\" || value === \"scalar\";\n}\nfunction isBetter(value: unknown): value is \"higher\" | \"lower\" | \"neutral\" {\n    return value === \"higher\" || value === \"lower\" || value === \"neutral\";\n}\nfunction validBounds(value: unknown): value is {\n    readonly min?: number;\n    readonly max?: number;\n} {\n    if (!isPlainRecord(value))\n        return false;\n    if ((value.min !== undefined && (typeof value.min !== \"number\" || !Number.isFinite(value.min))) ||\n        (value.max !== undefined && (typeof value.max !== \"number\" || !Number.isFinite(value.max)))) {\n        return false;\n    }\n    return value.min === undefined || value.max === undefined || value.min <= value.max;\n}\nfunction isMeasureFormat(value: unknown): value is MeasureFormat {\n    return typeof value === \"string\" ||\n        (isPlainRecord(value) && typeof value.kind === \"string\" &&\n            (value.options === undefined || isJsonValue(value.options)));\n}\nfunction isJsonValue(value: unknown, ancestors = new Set<object>()): value is JsonValue {\n    if (value === null || typeof value === \"string\" || typeof value === \"boolean\")\n        return true;\n    if (typeof value === \"number\")\n        return Number.isFinite(value);\n    if (typeof value !== \"object\" || value === null || ancestors.has(value))\n        return false;\n    ancestors.add(value);\n    const valid = Array.isArray(value)\n        ? value.every((entry) => isJsonValue(entry, ancestors))\n        : isPlainRecord(value) && Object.values(value).every((entry) => isJsonValue(entry, ancestors));\n    ancestors.delete(value);\n    return valid;\n}\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n    if (typeof value !== \"object\" || value === null || Array.isArray(value))\n        return false;\n    const prototype = Object.getPrototypeOf(value);\n    return prototype === Object.prototype || prototype === null;\n}\n"]}

package/dist/report/model/dataset.d.cts

@@ -0,0 +1,33 @@
+import type { ClosedRows, MeasureFormat, MetricValue } from "../../analysis/index.cjs";
+import type { ClosedDataset, Dataset, DatasetDimensionValueType, DatasetField, DatasetRow } from "./types.cjs";
+/** A bad Dataset request never becomes a fake zero, metric, or Evidence row. */
+export declare class ReportDatasetError extends Error {
+    readonly code = "report-dataset-invalid";
+    constructor(reason: string);
+}
+/** Declares one presentation Dimension field; null coordinates remain valid. */
+export declare function dimensionField(name: string, valueType?: DatasetDimensionValueType): DatasetField;
+/**
+ * Declares a Metric field by its Report row property name.  Current Analysis
+ * Measures do not carry a display-column name, so accepting one explicitly
+ * avoids guessing from an opaque Measure id.
+ */
+export declare function metricField(name: string, measure: Readonly<{
+    readonly unit?: string;
+    readonly format?: MeasureFormat;
+    readonly better?: "higher" | "lower" | "neutral";
+}>): DatasetField;
+/**
+ * Projects Analysis-issued ClosedRows into a neutral Dataset while preserving
+ * row key, collection identity, frame-level issues, Evidence refs, and every
+ * full MetricValue cell.  It does not reduce, filter, or re-close rows.
+ */
+export declare function datasetFromClosedRows<Row extends object>(rows: ClosedRows<Row>, fields: readonly DatasetField[]): ClosedDataset;
+/** True only for a Dataset created from Analysis-issued ClosedRows above. */
+export declare function isClosedDataset(value: unknown): value is ClosedDataset;
+/** Validates a neutral Dataset shape without claiming that it came from Analysis. */
+export declare function isDataset(value: unknown): value is Dataset;
+export declare function fieldOf(dataset: Dataset, name: string): DatasetField | undefined;
+export declare function requireField(dataset: Dataset, name: string): DatasetField;
+/** Reads an existing MetricValue cell without changing any of its semantics. */
+export declare function metricValueOf(row: DatasetRow, fieldName: string): MetricValue | null;

package/dist/report/model/dataset.d.mts

@@ -0,0 +1,33 @@
+import type { ClosedRows, MeasureFormat, MetricValue } from "../../analysis/index.mjs";
+import type { ClosedDataset, Dataset, DatasetDimensionValueType, DatasetField, DatasetRow } from "./types.mjs";
+/** A bad Dataset request never becomes a fake zero, metric, or Evidence row. */
+export declare class ReportDatasetError extends Error {
+    readonly code = "report-dataset-invalid";
+    constructor(reason: string);
+}
+/** Declares one presentation Dimension field; null coordinates remain valid. */
+export declare function dimensionField(name: string, valueType?: DatasetDimensionValueType): DatasetField;
+/**
+ * Declares a Metric field by its Report row property name.  Current Analysis
+ * Measures do not carry a display-column name, so accepting one explicitly
+ * avoids guessing from an opaque Measure id.
+ */
+export declare function metricField(name: string, measure: Readonly<{
+    readonly unit?: string;
+    readonly format?: MeasureFormat;
+    readonly better?: "higher" | "lower" | "neutral";
+}>): DatasetField;
+/**
+ * Projects Analysis-issued ClosedRows into a neutral Dataset while preserving
+ * row key, collection identity, frame-level issues, Evidence refs, and every
+ * full MetricValue cell.  It does not reduce, filter, or re-close rows.
+ */
+export declare function datasetFromClosedRows<Row extends object>(rows: ClosedRows<Row>, fields: readonly DatasetField[]): ClosedDataset;
+/** True only for a Dataset created from Analysis-issued ClosedRows above. */
+export declare function isClosedDataset(value: unknown): value is ClosedDataset;
+/** Validates a neutral Dataset shape without claiming that it came from Analysis. */
+export declare function isDataset(value: unknown): value is Dataset;
+export declare function fieldOf(dataset: Dataset, name: string): DatasetField | undefined;
+export declare function requireField(dataset: Dataset, name: string): DatasetField;
+/** Reads an existing MetricValue cell without changing any of its semantics. */
+export declare function metricValueOf(row: DatasetRow, fieldName: string): MetricValue | null;

package/dist/report/model/dataset.d.ts

@@ -0,0 +1,33 @@
+import type { ClosedRows, MeasureFormat, MetricValue } from "../../analysis/index.js";
+import type { ClosedDataset, Dataset, DatasetDimensionValueType, DatasetField, DatasetRow } from "./types.js";
+/** A bad Dataset request never becomes a fake zero, metric, or Evidence row. */
+export declare class ReportDatasetError extends Error {
+    readonly code = "report-dataset-invalid";
+    constructor(reason: string);
+}
+/** Declares one presentation Dimension field; null coordinates remain valid. */
+export declare function dimensionField(name: string, valueType?: DatasetDimensionValueType): DatasetField;
+/**
+ * Declares a Metric field by its Report row property name.  Current Analysis
+ * Measures do not carry a display-column name, so accepting one explicitly
+ * avoids guessing from an opaque Measure id.
+ */
+export declare function metricField(name: string, measure: Readonly<{
+    readonly unit?: string;
+    readonly format?: MeasureFormat;
+    readonly better?: "higher" | "lower" | "neutral";
+}>): DatasetField;
+/**
+ * Projects Analysis-issued ClosedRows into a neutral Dataset while preserving
+ * row key, collection identity, frame-level issues, Evidence refs, and every
+ * full MetricValue cell.  It does not reduce, filter, or re-close rows.
+ */
+export declare function datasetFromClosedRows<Row extends object>(rows: ClosedRows<Row>, fields: readonly DatasetField[]): ClosedDataset;
+/** True only for a Dataset created from Analysis-issued ClosedRows above. */
+export declare function isClosedDataset(value: unknown): value is ClosedDataset;
+/** Validates a neutral Dataset shape without claiming that it came from Analysis. */
+export declare function isDataset(value: unknown): value is Dataset;
+export declare function fieldOf(dataset: Dataset, name: string): DatasetField | undefined;
+export declare function requireField(dataset: Dataset, name: string): DatasetField;
+/** Reads an existing MetricValue cell without changing any of its semantics. */
+export declare function metricValueOf(row: DatasetRow, fieldName: string): MetricValue | null;

package/dist/report/model/dataset.js

@@ -0,0 +1,22 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./dataset.cjs");
+const __niceevalExport0 = __niceevalCanonical["ReportDatasetError"];
+export { __niceevalExport0 as ReportDatasetError };
+const __niceevalExport1 = __niceevalCanonical["datasetFromClosedRows"];
+export { __niceevalExport1 as datasetFromClosedRows };
+const __niceevalExport2 = __niceevalCanonical["dimensionField"];
+export { __niceevalExport2 as dimensionField };
+const __niceevalExport3 = __niceevalCanonical["fieldOf"];
+export { __niceevalExport3 as fieldOf };
+const __niceevalExport4 = __niceevalCanonical["isClosedDataset"];
+export { __niceevalExport4 as isClosedDataset };
+const __niceevalExport5 = __niceevalCanonical["isDataset"];
+export { __niceevalExport5 as isDataset };
+const __niceevalExport6 = __niceevalCanonical["metricField"];
+export { __niceevalExport6 as metricField };
+const __niceevalExport7 = __niceevalCanonical["metricValueOf"];
+export { __niceevalExport7 as metricValueOf };
+const __niceevalExport8 = __niceevalCanonical["requireField"];
+export { __niceevalExport8 as requireField };
+//# sourceMappingURL=dataset.js.map

package/dist/report/model/dataset.js.map

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